Get Session
GET /api/creative/edit/dev-edit/sessions/{session_id}
Load a specific session — powers the session switcher.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Responses
Section titled “ Responses ”Successful Response
Session payload the frontend switcher consumes.
object
object
Legacy-compatible comment shape. M7 findings populate the same fields
(so the TipTap extension + comments UI keep working) but new findings
also carry rule_id + source_handler via comment_type / the
comment text prefix.
object
Legacy LLM-era letter shape — kept for pre-M7 session rendering.
New M7 sessions hold an :class:EditorialReport instead (six sections +
findings + markdown). This type survives for backward-compatible
GET /{session_id}/letter responses on legacy sessions.
object
Full deterministic editorial report (M7).
object
Editorial report session id
Project id
Unix epoch seconds
Section 1
object
Authored-library rendered intro
Manuscript-level health scores, 0-100 each.
object
Plot + beat coverage health
Arc + screen-time balance health
Pacing + tension health
Voice + register consistency health
Lore ML finding density health
Weighted composite
One finding produced by a sub-scanner during a scene scan (M5).
object
Source-prefixed rule identifier
Error | warning | info
Sub-report id that produced this finding
Human-readable diagnosis
Scope the finding is about
object
Section 2
object
Authored-library rendered intro
One row in the structure-analysis beat coverage table.
object
Plotline display name
0-1
One row in the outcome-distribution table.
object
Scene outcome enum
Count across manuscript
Count / total, 0-1
Per-chapter (or per-manuscript) plot-progression aggregate.
object
Plot-point hits per scene in reading order
Runs of scenes [start_idx, end_idx] without plot advancement
One finding produced by a sub-scanner during a scene scan (M5).
object
Source-prefixed rule identifier
Error | warning | info
Sub-report id that produced this finding
Human-readable diagnosis
Scope the finding is about
object
Section 3
object
Authored-library rendered intro
Per-character sub-section inside character-analysis.
object
Display name
Screen time row
object
Lore entity id
Display name
Scenes where character is a participant
Total prose mentions (name + aliases)
Mention count / total character mentions, 0-1
Per-character manuscript arc-progression row.
object
Lore entity id
Display name
Per-chapter majority arc_stage in reading order
Chapter index runs [start, end] with no arc advancement
One finding produced by a sub-scanner during a scene scan (M5).
object
Source-prefixed rule identifier
Error | warning | info
Sub-report id that produced this finding
Human-readable diagnosis
Scope the finding is about
object
Section 4
object
Authored-library rendered intro
Chapter-level avg tension intensity in reading order
Per-chapter pacing aggregate.
object
Variance across scene lengths
Mean scene word count
Max - min scene word count
Variance in avg sentence length across scenes
Per-scene avg tension intensity in reading order
Runs of scenes [start_idx, end_idx] with below-threshold variance
One finding produced by a sub-scanner during a scene scan (M5).
object
Source-prefixed rule identifier
Error | warning | info
Sub-report id that produced this finding
Human-readable diagnosis
Scope the finding is about
object
Section 5
object
Authored-library rendered umbrella intro
Authored-library intro for the Themes subsection
BERTopic-style clusters with per-chapter weights + consistency
One detected theme cluster with per-chapter weight distribution.
object
Deterministic id: theme_N
C-TF-IDF top term — human-readable label
Top-N c-TF-IDF terms
One paragraph-level mention of a detected theme or motif.
object
Outline chapter id
Scene id
Paragraph index within scene prose
Character offset start in scene prose
Character offset end in scene prose
Topic probability / recurrence score 0..1
Chapter_id -> 0..1 probability mass
object
Normalized share across manuscript
Chapter id where theme first appears
Chapter id where theme last appears
Shannon-entropy-normalized evenness 0..1
Authored-library intro for the Motifs subsection
Recurring surface forms with gap-run analysis
One recurring motif with gap-run analysis.
object
Deterministic id: motif_N
Canonical lowercased token or n-gram
One paragraph-level mention of a detected theme or motif.
object
Outline chapter id
Scene id
Paragraph index within scene prose
Character offset start in scene prose
Character offset end in scene prose
Topic probability / recurrence score 0..1
(chapter_from, chapter_to) pairs with consecutive absent chapters
Appearances / chapters_spanned
Authored-library intro for the Voice Drift subsection
Per-chapter voice-drift signal.
object
Chapter node id
Reading-order index
Formal | casual | archaic | mixed
Manuscript median register
Chapter - manuscript formal density
Chapter - manuscript casual density
Standardised drift magnitude
Editorial.theme_consistency_gap / editorial.motif_dropped / editorial.theme_imbalance / editorial.theme_detection_failed
One finding produced by a sub-scanner during a scene scan (M5).
object
Source-prefixed rule identifier
Error | warning | info
Sub-report id that produced this finding
Human-readable diagnosis
Scope the finding is about
object
One finding produced by a sub-scanner during a scene scan (M5).
object
Source-prefixed rule identifier
Error | warning | info
Sub-report id that produced this finding
Human-readable diagnosis
Scope the finding is about
object
Pipeline coverage notes (short chapters, empty manuscript, etc.)
Section 6
object
Authored-library rendered intro
Top-priority finding entry.
object
Priority rank (1 = highest)
The finding
object
Source-prefixed rule identifier
Error | warning | info
Sub-report id that produced this finding
Human-readable diagnosis
Scope the finding is about
object
Why this is top-priority (severity + source)
Flat findings list for TipTap decorations
Flat finding representation for TipTap decorations + SQLite persistence.
object
Stable finding id (session-scoped)
Editorial report session id
Source-prefixed rule id
Originating handler (proseguard | editorial | lore_ml | …)
Error | warning | info
Authored-library rendered message
Paragraph index in scene prose
Stringified metadata for SQLite storage
object
SHA-256 of scene prose at scan time for stale detection
Pending | resolved | dismissed
Fully rendered Markdown report
object
Validation Error