@miadi/episodic-memory-schema 0.12.0 → 0.14.0

package/README.md

@@ -182,6 +182,22 @@ modifies source material.
 - **Reviews held by an episode.** `parseReviewRef`, `readEpisodeReviews`, `reviewNodeId` and
   `EpisodeReviewEntry` type a Miadi review inside `episode.yaml` (`reviews:`), with its
   `review:<uuid>` node id. Pure: no fs, no fetch.
+- **Screenwalks.** `ScreenwalkRecord` types a screenwalk, a recording of a person working live
+  with agent sessions, as an episode holds it in `captures/screenwalk-<id>/screenwalk.json`: its
+  id is the stamp the person names when recording starts (`miadi-screenwalk:<yymmddHHMM>`), and
+  it gathers the sessions on screen with their ledgers, the video, the review, transcriptions,
+  witness closings and outputs (dialogue, chapters, shorts). `toScreenwalkRecord` also reads the
+  screenwalk `capture.json` files written by hand before the record existed, `isScreenwalkRecord`
+  guards the written form, and `@miadi/episodic-memory-schema/schema/screenwalk` is its JSON
+  Schema. A record lists its `stills` (frames kept as images, with the minute) and its `seeds`
+  (the images the walk starts from). Pure: no fs, no fetch.
+- **Media records.** `EpisodeMediaRecord` is the record kept beside a picture in an episode,
+  `<media path>.yaml`: its role (cover, map, still, illustration, photo, screenshot), alt text,
+  caption, origin (generated, photo, screenshot, frame, drawn, imported, with the tool, notebook
+  or screenwalk), who made it, who chose it, its digest and the original it was stored from.
+  `toEpisodeMediaRecord` reads one tolerantly in file order; `episodeMediaCredit` gives the line
+  a surface shows at the bottom of the picture. `EpisodeManifestEntry.cover` carries the cover
+  `episode.yaml` names.
 
 ## Versioning
 

package/dist/chronicle-manifest.d.ts

@@ -41,6 +41,8 @@ export interface EpisodeManifestEntry {
     relations: EpisodeRelation[];
     /** True when a structured `episode.yaml` was observed (vs. name-only). */
     structured: boolean;
+    /** The episode's cover image, vessel-relative (`episode.yaml` `cover:`). jgwill/Miadi#743. */
+    cover?: string;
     /**
      * Published book/story form(s) for this episode, attached by `linkStoryForms`
      * from a `StoryLibraryManifest`. Absent when the episode has no published story.

package/dist/chronicle-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chronicle-manifest.d.ts","sourceRoot":"","sources":["../src/chronicle-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAErE,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,8BAA8B,CAAA;AACnE,eAAO,MAAM,gBAAgB,oBAAoB,CAAA;AAEjD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qFAAqF;IACrF,SAAS,EAAE,eAAe,EAAE,CAAA;IAC5B,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,oBAAoB,EAAE,CAAA;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,GACpD,oBAAoB,EAAE,CAMxB;AAED,wEAAwE;AACxE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,WAAW,CAAC,EAAE,kBAAkB,CAAA;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,oBAAoB,EAAE,CAAA;IAChC,WAAW,EAAE,uBAAuB,EAAE,CAAA;CACvC;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAOD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,2BAA2B,EAAE,EAC9C,OAAO,GAAE,+BAAoC,GAC5C,iBAAiB,CAwDnB"}
+{"version":3,"file":"chronicle-manifest.d.ts","sourceRoot":"","sources":["../src/chronicle-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAErE,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,8BAA8B,CAAA;AACnE,eAAO,MAAM,gBAAgB,oBAAoB,CAAA;AAEjD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qFAAqF;IACrF,SAAS,EAAE,eAAe,EAAE,CAAA;IAC5B,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAA;IACnB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,oBAAoB,EAAE,CAAA;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,GACpD,oBAAoB,EAAE,CAMxB;AAED,wEAAwE;AACxE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,WAAW,CAAC,EAAE,kBAAkB,CAAA;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,oBAAoB,EAAE,CAAA;IAChC,WAAW,EAAE,uBAAuB,EAAE,CAAA;CACvC;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAOD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,2BAA2B,EAAE,EAC9C,OAAO,GAAE,+BAAoC,GAC5C,iBAAiB,CA0DnB"}

package/dist/chronicle-manifest.js

@@ -68,6 +68,9 @@ export function observeChronicleManifest(inputs, options = {}) {
             relations: obs?.relations ?? [],
             structured: obs !== undefined,
         };
+        const cover = obs ? readStringField(obs.unmappedFields, "cover") : undefined;
+        if (cover)
+            entry.cover = cover;
         if (obs) {
             for (const d of obs.diagnostics) {
                 diagnostics.push({ ...d, path: d.path ?? input.name });

package/dist/chronicle-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"chronicle-manifest.js","sourceRoot":"","sources":["../src/chronicle-manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chronicle-manifest.js","sourceRoot":"","sources":["../src/chronicle-manifest.ts"],"names":[],"mappings":"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"}

package/dist/episode-media.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The record beside a picture (later a sound or a film) kept in an episode: what it is,
+ * where it came from, who made it and who chose it.
+ *
+ * File: `<media path>.yaml` beside the media file, e.g. `images/still.webp.yaml`. One record
+ * per file, so two seats adding at once never edit the same file (D2 of the episode images
+ * proposal, jgwill/Miadi#743). Guillaume, 2026-10-07: images say where they came from and who
+ * chose them; a generated image says so in a discreet credit at its bottom.
+ *
+ * The `role` separates what a picture is for. A cover is the episode's face. A map explains
+ * the episode as a whole, such as Deep Diver's infographic of the screenwalk lifecycle. A still
+ * is a frame of a screenwalk.
+ *
+ * Shape (YAML, keys in this order):
+ *
+ *   media: screenwalk-lifecycle-261007.png
+ *   role: map
+ *   alt: Infographic of the screenwalk lifecycle, from Capture and Witnessing to Final Archival
+ *   caption: The Screenwalk Lifecycle
+ *   origin:
+ *     kind: generated
+ *     tool: Gemini Notebook infographic
+ *     notebook: 0ae51b4c-8ed2-4ee2-a641-2c7e88b7e2ea
+ *     source: captures/notebook-0ae51b4c-…/Screenwalk-Lifecycle-Process-Diagram-20261007T000621.png
+ *   made_by: T6 Deep Diver seat
+ *   chosen_by: Guillaume
+ *   added_by: Guillaume
+ *   added_at: 2026-10-07T07:10:00Z
+ *   sha256: …
+ *   original: { name: …, type: image/png, bytes: 3962783, sha256: …, width: …, height: … }
+ *   public_uses: [https://…]
+ *   boundary: Illustrative, not evidence that …
+ *
+ * Pure: no fs, no YAML. Reading and writing the file is the host's.
+ */
+/** What a picture is for in its episode. */
+export declare const EPISODE_MEDIA_ROLES: readonly ["cover", "map", "still", "illustration", "photo", "screenshot", "other"];
+export type EpisodeMediaRole = (typeof EPISODE_MEDIA_ROLES)[number];
+/** How it came to exist. */
+export declare const EPISODE_MEDIA_ORIGIN_KINDS: readonly ["generated", "photo", "screenshot", "frame", "drawn", "imported"];
+export type EpisodeMediaOriginKind = (typeof EPISODE_MEDIA_ORIGIN_KINDS)[number];
+export interface EpisodeMediaOrigin {
+    kind: EpisodeMediaOriginKind;
+    /** The model or tool, e.g. `xai/grok-imagine-image-2.0`, `Gemini Notebook infographic`. */
+    tool?: string;
+    /** The prompt file beside it, or the prompt text. */
+    prompt?: string;
+    /** An image the generation was guided by. */
+    reference?: string;
+    /** A Deep Diver / Gemini Notebook id. */
+    notebook?: string;
+    /** For a frame: `miadi-screenwalk:<id>` and where in the video. */
+    screenwalk?: string;
+    at?: string;
+    /** The device that took a photo or a screenshot. */
+    device?: string;
+    /** The file this one was made from, when the episode keeps it too. */
+    source?: string;
+}
+/** The file as it was received, when it was stored in another form. */
+export interface EpisodeMediaOriginal {
+    name?: string;
+    type?: string;
+    bytes?: number;
+    sha256?: string;
+    width?: number;
+    height?: number;
+}
+export interface EpisodeMediaRecord {
+    /** The media file's name, as a check that the record sits beside the right file. */
+    media: string;
+    role?: EpisodeMediaRole;
+    alt?: string;
+    caption?: string;
+    origin?: EpisodeMediaOrigin;
+    /** The person or agent who made it. */
+    made_by?: string;
+    /** The person who chose it for the episode. */
+    chosen_by?: string;
+    added_by?: string;
+    added_at?: string;
+    /** Digest of the stored file. */
+    sha256?: string;
+    original?: EpisodeMediaOriginal;
+    /** Where it was published outside the chronicle. */
+    public_uses?: string[];
+    /** What it does not prove. */
+    boundary?: string;
+}
+/** The record's keys in the order the file writes them. */
+export declare const EPISODE_MEDIA_RECORD_KEYS: readonly ["media", "role", "alt", "caption", "origin", "made_by", "chosen_by", "added_by", "added_at", "sha256", "original", "public_uses", "boundary"];
+/** The record's path for a media file: `images/still.webp` → `images/still.webp.yaml`. */
+export declare function episodeMediaRecordPath(mediaPath: string): string;
+/** The media path a record path belongs to, or null when the path is not a record's. */
+export declare function episodeMediaPathOfRecord(recordPath: string): string | null;
+export declare function isEpisodeMediaRole(value: unknown): value is EpisodeMediaRole;
+/**
+ * Tolerant reader: keeps what it recognises, in file order, and drops the rest. `media` falls
+ * back to `options.media` (the file the record sits beside). Null when neither names a file.
+ */
+export declare function toEpisodeMediaRecord(raw: unknown, options?: {
+    media?: string;
+}): EpisodeMediaRecord | null;
+/**
+ * The credit a surface shows at the bottom of a picture, or null when the record names no one
+ * and no tool. "Generated with Gemini Notebook infographic · made by T6 Deep Diver seat · chosen
+ * by Guillaume".
+ */
+export declare function episodeMediaCredit(record: EpisodeMediaRecord | null | undefined): string | null;
+//# sourceMappingURL=episode-media.d.ts.map

package/dist/episode-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-media.d.ts","sourceRoot":"","sources":["../src/episode-media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,oFAAqF,CAAA;AACrH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,4BAA4B;AAC5B,eAAO,MAAM,0BAA0B,6EAA8E,CAAA;AACrH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAA;IAC5B,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,oBAAoB,CAAA;IAC/B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,2DAA2D;AAC3D,eAAO,MAAM,yBAAyB,yJAc5B,CAAA;AAMV,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAiBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,kBAAkB,GAAG,IAAI,CA4C9G;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAc/F"}

package/dist/episode-media.js

@@ -0,0 +1,169 @@
+/**
+ * The record beside a picture (later a sound or a film) kept in an episode: what it is,
+ * where it came from, who made it and who chose it.
+ *
+ * File: `<media path>.yaml` beside the media file, e.g. `images/still.webp.yaml`. One record
+ * per file, so two seats adding at once never edit the same file (D2 of the episode images
+ * proposal, jgwill/Miadi#743). Guillaume, 2026-10-07: images say where they came from and who
+ * chose them; a generated image says so in a discreet credit at its bottom.
+ *
+ * The `role` separates what a picture is for. A cover is the episode's face. A map explains
+ * the episode as a whole, such as Deep Diver's infographic of the screenwalk lifecycle. A still
+ * is a frame of a screenwalk.
+ *
+ * Shape (YAML, keys in this order):
+ *
+ *   media: screenwalk-lifecycle-261007.png
+ *   role: map
+ *   alt: Infographic of the screenwalk lifecycle, from Capture and Witnessing to Final Archival
+ *   caption: The Screenwalk Lifecycle
+ *   origin:
+ *     kind: generated
+ *     tool: Gemini Notebook infographic
+ *     notebook: 0ae51b4c-8ed2-4ee2-a641-2c7e88b7e2ea
+ *     source: captures/notebook-0ae51b4c-…/Screenwalk-Lifecycle-Process-Diagram-20261007T000621.png
+ *   made_by: T6 Deep Diver seat
+ *   chosen_by: Guillaume
+ *   added_by: Guillaume
+ *   added_at: 2026-10-07T07:10:00Z
+ *   sha256: …
+ *   original: { name: …, type: image/png, bytes: 3962783, sha256: …, width: …, height: … }
+ *   public_uses: [https://…]
+ *   boundary: Illustrative, not evidence that …
+ *
+ * Pure: no fs, no YAML. Reading and writing the file is the host's.
+ */
+/** What a picture is for in its episode. */
+export const EPISODE_MEDIA_ROLES = ["cover", "map", "still", "illustration", "photo", "screenshot", "other"];
+/** How it came to exist. */
+export const EPISODE_MEDIA_ORIGIN_KINDS = ["generated", "photo", "screenshot", "frame", "drawn", "imported"];
+/** The record's keys in the order the file writes them. */
+export const EPISODE_MEDIA_RECORD_KEYS = [
+    "media",
+    "role",
+    "alt",
+    "caption",
+    "origin",
+    "made_by",
+    "chosen_by",
+    "added_by",
+    "added_at",
+    "sha256",
+    "original",
+    "public_uses",
+    "boundary",
+];
+const ORIGIN_KEYS = ["kind", "tool", "prompt", "reference", "notebook", "screenwalk", "at", "device", "source"];
+const ORIGINAL_TEXT_KEYS = ["name", "type", "sha256"];
+const ORIGINAL_NUMBER_KEYS = ["bytes", "width", "height"];
+/** The record's path for a media file: `images/still.webp` → `images/still.webp.yaml`. */
+export function episodeMediaRecordPath(mediaPath) {
+    return `${mediaPath}.yaml`;
+}
+/** The media path a record path belongs to, or null when the path is not a record's. */
+export function episodeMediaPathOfRecord(recordPath) {
+    return /\.(?:png|jpe?g|webp|gif|avif|m4a|mp3|wav|mp4|webm|mov)\.yaml$/i.test(recordPath) ? recordPath.slice(0, -5) : null;
+}
+export function isEpisodeMediaRole(value) {
+    return typeof value === "string" && EPISODE_MEDIA_ROLES.includes(value);
+}
+function text(value, max = 2000) {
+    if (typeof value === "number" && Number.isFinite(value))
+        value = String(value);
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed.slice(0, max) : undefined;
+}
+function obj(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
+}
+function count(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+}
+/**
+ * Tolerant reader: keeps what it recognises, in file order, and drops the rest. `media` falls
+ * back to `options.media` (the file the record sits beside). Null when neither names a file.
+ */
+export function toEpisodeMediaRecord(raw, options = {}) {
+    const r = obj(raw) ?? {};
+    const media = text(r.media, 300) ?? text(options.media, 300);
+    if (!media)
+        return null;
+    const record = { media };
+    if (isEpisodeMediaRole(r.role))
+        record.role = r.role;
+    for (const key of ["alt", "caption", "made_by", "chosen_by", "added_by", "added_at", "boundary"]) {
+        const value = text(r[key], key === "alt" || key === "boundary" ? 1000 : 300);
+        if (value)
+            record[key] = value;
+    }
+    const sha = text(r.sha256, 64);
+    if (sha && /^[0-9a-f]{64}$/i.test(sha))
+        record.sha256 = sha.toLowerCase();
+    const o = obj(r.origin);
+    const kind = o && EPISODE_MEDIA_ORIGIN_KINDS.includes(o.kind) ? o.kind : undefined;
+    if (o && kind) {
+        const origin = {};
+        for (const key of ORIGIN_KEYS) {
+            const value = key === "kind" ? kind : text(o[key], 600);
+            if (value)
+                origin[key] = value;
+        }
+        record.origin = origin;
+    }
+    const g = obj(r.original);
+    if (g) {
+        const original = {};
+        for (const key of ORIGINAL_TEXT_KEYS) {
+            const value = text(g[key], 300);
+            if (value)
+                original[key] = value;
+        }
+        for (const key of ORIGINAL_NUMBER_KEYS) {
+            const value = count(g[key]);
+            if (value !== undefined)
+                original[key] = value;
+        }
+        if (Object.keys(original).length)
+            record.original = original;
+    }
+    const uses = (Array.isArray(r.public_uses) ? r.public_uses : []).map((u) => text(u, 600)).filter((u) => u !== undefined);
+    if (uses.length)
+        record.public_uses = uses;
+    const ordered = {};
+    for (const key of EPISODE_MEDIA_RECORD_KEYS)
+        if (record[key] !== undefined)
+            ordered[key] = record[key];
+    return ordered;
+}
+/**
+ * The credit a surface shows at the bottom of a picture, or null when the record names no one
+ * and no tool. "Generated with Gemini Notebook infographic · made by T6 Deep Diver seat · chosen
+ * by Guillaume".
+ */
+export function episodeMediaCredit(record) {
+    if (!record)
+        return null;
+    const parts = [];
+    const origin = record.origin;
+    if (origin?.kind === "generated")
+        parts.push(origin.tool ? `Generated with ${origin.tool}` : "Generated");
+    else if (origin?.kind === "frame")
+        parts.push(origin.at ? `Frame at ${origin.at}` : "Frame");
+    else if (origin?.kind === "photo")
+        parts.push(origin.device ? `Photo, ${origin.device}` : "Photo");
+    else if (origin?.kind === "screenshot")
+        parts.push("Screenshot");
+    else if (origin?.kind === "drawn")
+        parts.push(origin.tool ? `Drawn with ${origin.tool}` : "Drawn");
+    if (record.made_by)
+        parts.push(`made by ${record.made_by}`);
+    if (record.chosen_by && record.chosen_by !== record.made_by)
+        parts.push(`chosen by ${record.chosen_by}`);
+    if (!parts.length)
+        return null;
+    const line = parts.join(" · ");
+    return line.charAt(0).toUpperCase() + line.slice(1);
+}
+//# sourceMappingURL=episode-media.js.map

package/dist/episode-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-media.js","sourceRoot":"","sources":["../src/episode-media.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -38,4 +38,16 @@ export type { ReviewRef, EpisodeReviewEntry, ObservedEpisodeReview } from "./epi
  */
 export { FOUNDATION_REFERENCE_PREFIX, FOUNDATION_NODE_PREFIX, FOUNDATION_NODE_KIND, FOUNDATION_ENTRY_KEYS, EPISODE_FOUNDATIONS_DIR, DEFAULT_FOUNDATION_RELATION, isFoundationSlug, foundationNodeId, foundationSlugOf, episodeFoundationPath, toEpisodeFoundationEntry, readEpisodeFoundations, } from "./episode-foundation.js";
 export type { FoundationSource, EpisodeFoundationEntry, ObservedEpisodeFoundation } from "./episode-foundation.js";
+/**
+ * The screenwalk record: a recording of a person working live with agent sessions, held in an
+ * episode as `captures/screenwalk-<id>/screenwalk.json` (Episode 550, jgwill/Miadi#707).
+ */
+export { SCREENWALK_REFERENCE_PREFIX, SCREENWALK_FOLDER_PREFIX, SCREENWALK_FILE, SCREENWALK_STATES, SCREENWALK_OUTPUT_KINDS, SCREENWALK_RECORD_KEYS, LEGACY_SCREENWALK_KEYS, isScreenwalkState, isScreenwalkId, screenwalkReference, screenwalkFolder, screenwalkPath, parseScreenwalkRef, parseScreenwalkStamp, deriveScreenwalkState, toScreenwalkRecord, isScreenwalkRecord, } from "./screenwalk.js";
+export type { ScreenwalkState, ScreenwalkRef, ScreenwalkStamp, ScreenwalkRecording, ScreenwalkVideo, ScreenwalkReview, ScreenwalkSession, ScreenwalkClosing, ScreenwalkTranscription, ScreenwalkOutputKind, ScreenwalkOutput, ScreenwalkStill, ScreenwalkRecord, } from "./screenwalk.js";
+/**
+ * The record beside a picture kept in an episode, `<media path>.yaml`: its role (cover, map,
+ * still…), alt, caption, origin, who made and who chose it (jgwill/Miadi#743).
+ */
+export { EPISODE_MEDIA_ROLES, EPISODE_MEDIA_ORIGIN_KINDS, EPISODE_MEDIA_RECORD_KEYS, episodeMediaRecordPath, episodeMediaPathOfRecord, isEpisodeMediaRole, toEpisodeMediaRecord, episodeMediaCredit, } from "./episode-media.js";
+export type { EpisodeMediaRole, EpisodeMediaOriginKind, EpisodeMediaOrigin, EpisodeMediaOriginal, EpisodeMediaRecord, } from "./episode-media.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE/F;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE/F;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AAElH;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -34,4 +34,14 @@ export { REVIEW_SERVICE_BASE_URL, REVIEW_REFERENCE_PREFIX, REVIEW_NODE_PREFIX, R
  * `episode.yaml`, and the wheel node kind it projects to (jgwill/Miadi#713).
  */
 export { FOUNDATION_REFERENCE_PREFIX, FOUNDATION_NODE_PREFIX, FOUNDATION_NODE_KIND, FOUNDATION_ENTRY_KEYS, EPISODE_FOUNDATIONS_DIR, DEFAULT_FOUNDATION_RELATION, isFoundationSlug, foundationNodeId, foundationSlugOf, episodeFoundationPath, toEpisodeFoundationEntry, readEpisodeFoundations, } from "./episode-foundation.js";
+/**
+ * The screenwalk record: a recording of a person working live with agent sessions, held in an
+ * episode as `captures/screenwalk-<id>/screenwalk.json` (Episode 550, jgwill/Miadi#707).
+ */
+export { SCREENWALK_REFERENCE_PREFIX, SCREENWALK_FOLDER_PREFIX, SCREENWALK_FILE, SCREENWALK_STATES, SCREENWALK_OUTPUT_KINDS, SCREENWALK_RECORD_KEYS, LEGACY_SCREENWALK_KEYS, isScreenwalkState, isScreenwalkId, screenwalkReference, screenwalkFolder, screenwalkPath, parseScreenwalkRef, parseScreenwalkStamp, deriveScreenwalkState, toScreenwalkRecord, isScreenwalkRecord, } from "./screenwalk.js";
+/**
+ * The record beside a picture kept in an episode, `<media path>.yaml`: its role (cover, map,
+ * still…), alt, caption, origin, who made and who chose it (jgwill/Miadi#743).
+ */
+export { EPISODE_MEDIA_ROLES, EPISODE_MEDIA_ORIGIN_KINDS, EPISODE_MEDIA_RECORD_KEYS, episodeMediaRecordPath, episodeMediaPathOfRecord, isEpisodeMediaRole, toEpisodeMediaRecord, episodeMediaCredit, } from "./episode-media.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAG7B;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AAOvB;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAG5B;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAG7B;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AAOvB;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAG5B;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA;AAGhC;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA;AAiBxB;;;GAGG;AACH,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAA"}

package/dist/screenwalk.d.ts

@@ -0,0 +1,194 @@
+/**
+ * The chronicle SCREENWALK record — a recording of a person working live with agent
+ * sessions, with their voices, held by an episode.
+ *
+ * Episode 550 ("The Screenwalk as a Media Type") drew the type before any code held it, in
+ * `diagrams/screenwalk.erdf.json`: an Episode holds Screenwalks; a Screenwalk witnesses
+ * sessions, ends with witness closings, is read as one Review and is teased by Shorts. Its
+ * states are the episode's two machines, `screenwalk.smdf.json` (NotStarted to
+ * InConversation) and the media cycle that continues after Reviewed.
+ *
+ * File: `captures/screenwalk-<id>/screenwalk.json` in the episode vessel, beside the seat
+ * ledgers. `capture.json` stays the descriptor of a phone audio take (`@miadi/episode-capture`),
+ * whose reader skips every other shape. The screenwalk `capture.json` files written by hand
+ * before this record existed are read by `toScreenwalkRecord` and converted.
+ *
+ * The id is the stamp the person writes when they press record, `yymmddHHMM`
+ * (`miadi-screenwalk:2610061207`). The first records used `yymmdd-NNN`. The stamp is the
+ * minute the person named. `recording.started` is where the uploaded video's clock begins,
+ * which can differ from it (a retake).
+ *
+ * Shape (`screenwalk.json`):
+ *
+ *   { "screenwalk": "2610061207", "reference": "miadi-screenwalk:2610061207",
+ *     "state": "Reviewed", "episode": "2026-10-01-episode-550-…", "stamp": "2026-10-06T12:07",
+ *     "recording": { "started": "…", "length": "about 24:30", "evidence": "…", "retake": "…" },
+ *     "video": { "url": "https://youtu.be/…", "title": "…" },
+ *     "review": { "id": "6a2b5b59-…", "version": 1 },
+ *     "related": [], "sessions": [{ "session_id": "…", "name": "…", "ledger": "seat-….md" }],
+ *     "closings": [], "transcriptions": [{ "file": "…", "source": "…", "coverage": "…" }],
+ *     "outputs": [], "stills": [{ "file": "images/screenwalk-2610061207/frame.webp", "at": "12:31" }],
+ *     "seeds": ["images/screenwalk-lifecycle-261007.png"], "finding": "…" }
+ *
+ * Pure — no fs, no fetch. Reading and writing the file is the consumer's. Ref: jgwill/Miadi#707.
+ */
+/** The portable reference form: `miadi-screenwalk:<id>`. `miadi-screenwalk://<id>` is read too. */
+export declare const SCREENWALK_REFERENCE_PREFIX = "miadi-screenwalk:";
+/** The folder a screenwalk lives in, under the vessel's `captures/`: `screenwalk-<id>`. */
+export declare const SCREENWALK_FOLDER_PREFIX = "screenwalk-";
+/** The record's file inside its folder. */
+export declare const SCREENWALK_FILE = "screenwalk.json";
+/**
+ * Every state a screenwalk can be in: Episode 550's `screenwalk.smdf.json`, then the media
+ * cycle that continues it after Reviewed (`screenwalk-media-cycle.smdf.json`).
+ */
+export declare const SCREENWALK_STATES: readonly ["NotStarted", "Recording", "Witnessing", "ClosingDrafted", "Played", "Revising", "Recorded", "Published", "Reviewed", "Chronicled", "InConversation", "Enriched", "Notebooked", "MediaGenerated", "Watched", "HeldInCircle", "ScriptedNext"];
+export type ScreenwalkState = (typeof SCREENWALK_STATES)[number];
+export declare function isScreenwalkState(value: unknown): value is ScreenwalkState;
+export declare function isScreenwalkId(value: unknown): value is string;
+export declare function screenwalkReference(id: string): string;
+export declare function screenwalkFolder(id: string): string;
+/** The record's path inside an episode vessel, relative to the vessel. */
+export declare function screenwalkPath(id: string): string;
+export interface ScreenwalkRef {
+    id: string;
+    /** `miadi-screenwalk:<id>`. */
+    reference: string;
+    /** `screenwalk-<id>`, the folder under `captures/`. */
+    folder: string;
+}
+/**
+ * Read a screenwalk reference: `miadi-screenwalk:<id>`, `miadi-screenwalk://<id>`, a folder
+ * name `screenwalk-<id>`, or a bare id. Null for anything else.
+ */
+export declare function parseScreenwalkRef(input: unknown): ScreenwalkRef | null;
+export interface ScreenwalkStamp {
+    /** `YYYY-MM-DD`. */
+    date: string;
+    /** `HH:MM`, present when the id carries an hour. An id with an hour and no minute gives `HH:00`. */
+    time?: string;
+    precision: "day" | "hour" | "minute";
+}
+/**
+ * The date and time an id names, read from its leading digits (`yymmdd`, `yymmddHH`,
+ * `yymmddHHMM`). Local time, as the person wrote it. Null when the digits are not a date.
+ */
+export declare function parseScreenwalkStamp(id: string): ScreenwalkStamp | null;
+export interface ScreenwalkRecording {
+    /** Where the uploaded video's clock begins, ISO or as the evidence states it. */
+    started?: string;
+    /** The video's length as measured, e.g. `about 24:30`. */
+    length?: string;
+    /** How `started` was established. */
+    evidence?: string;
+    /** Why the video differs from the recording the stamp named, when it does. */
+    retake?: string;
+}
+export interface ScreenwalkVideo {
+    url: string;
+    title?: string;
+    published_at?: string;
+}
+export interface ScreenwalkReview {
+    /** The review UUID. */
+    id: string;
+    /** The version this record last checked. */
+    version?: number;
+}
+/** A session on screen (the ERD's WitnessedSession). */
+export interface ScreenwalkSession {
+    session_id?: string;
+    /** The session's name, often its tmux name. */
+    name?: string;
+    /** What the session was doing in the recording. */
+    note?: string;
+    /** The seat ledger file in this folder: what the seat did, in wall-clock time. */
+    ledger?: string;
+}
+/** A witness closing played in the recording (the ERD's WitnessClosing). */
+export interface ScreenwalkClosing {
+    version: number;
+    file?: string;
+    /** The person's words after hearing this version. */
+    correction?: string;
+}
+export interface ScreenwalkTranscription {
+    file: string;
+    source?: string;
+    coverage?: string;
+    complete?: boolean;
+}
+export declare const SCREENWALK_OUTPUT_KINDS: readonly ["dialogue", "chapters", "short", "audio", "other"];
+export type ScreenwalkOutputKind = (typeof SCREENWALK_OUTPUT_KINDS)[number];
+/** Something made from the screenwalk: a dialogue, chapters, a short (the ERD's Short), audio. */
+export interface ScreenwalkOutput {
+    kind: ScreenwalkOutputKind;
+    /** Where it lives: a file in this folder, a URL, or a `miadi-*` reference. */
+    ref?: string;
+    /** For a short: where it starts and ends in the video, `mm:ss` or `h:mm:ss`. */
+    starts_at?: string;
+    ends_at?: string;
+    note?: string;
+}
+/**
+ * A frame of the recording kept as an image in the episode, by convention under
+ * `images/screenwalk-<id>/` (Guillaume's D3, 2026-10-07; jgwill/Miadi#743).
+ */
+export interface ScreenwalkStill {
+    /** Vessel-relative path of the image. */
+    file: string;
+    /** Where in the video it was taken, `mm:ss` or `h:mm:ss`. */
+    at?: string;
+    note?: string;
+}
+export interface ScreenwalkRecord {
+    /** The id: the stamp, `yymmddHHMM`, or an early `yymmdd-NNN`. */
+    screenwalk: string;
+    /** `miadi-screenwalk:<id>`. */
+    reference: string;
+    state?: ScreenwalkState;
+    /** The episode directory that holds it. */
+    episode?: string;
+    /** The minute the person named, `YYYY-MM-DDTHH:MM` local, read from the id when absent. */
+    stamp?: string;
+    recording?: ScreenwalkRecording;
+    video?: ScreenwalkVideo;
+    review?: ScreenwalkReview;
+    /** References to what the screenwalk is about: reviews, episodes, issues. */
+    related?: string[];
+    sessions: ScreenwalkSession[];
+    closings: ScreenwalkClosing[];
+    transcriptions: ScreenwalkTranscription[];
+    outputs: ScreenwalkOutput[];
+    /** Frames of this walk kept as images in the episode. */
+    stills?: ScreenwalkStill[];
+    /** Vessel-relative paths of the images this walk starts from: a still of an earlier walk, a map, a photo. */
+    seeds?: string[];
+    /** What a listener found that the review would not say, e.g. that the person's voice is missing. */
+    finding?: string;
+    /** An `@miadi/episode-capture` stem, when the phone also filed an audio take. */
+    audio_take?: string;
+}
+/** The record's keys in the order `screenwalk.json` writes them. */
+export declare const SCREENWALK_RECORD_KEYS: readonly ["screenwalk", "reference", "state", "episode", "stamp", "recording", "video", "review", "related", "sessions", "closings", "transcriptions", "outputs", "stills", "seeds", "finding", "audio_take"];
+/**
+ * Keys of the hand-written screenwalk `capture.json` files that `toScreenwalkRecord` maps.
+ * A converter that meets any other key should stop rather than drop it.
+ */
+export declare const LEGACY_SCREENWALK_KEYS: readonly ["stem", "video", "title", "review", "reference", "started", "session", "sessions", "seat_ledgers", "related", "recording", "stamp_estimate", "transcriptions", "finding", "note"];
+/** The furthest state the record's own fields prove: a review, then a video. Undefined otherwise. */
+export declare function deriveScreenwalkState(record: Pick<ScreenwalkRecord, "review" | "video">): ScreenwalkState | undefined;
+/**
+ * Tolerant reader for a `screenwalk.json`, or for a screenwalk `capture.json` written by hand
+ * before this record existed (`stem`, `video` as a string, `review` as `miadi-review:<uuid>`,
+ * `session`/`sessions` strings, `seat_ledgers`, `stamp_estimate`). The id comes from
+ * `screenwalk`, then `stem`, then `options.id` (the folder name), then `reference`. Null when
+ * none names a screenwalk.
+ */
+export declare function toScreenwalkRecord(raw: unknown, options?: {
+    id?: string;
+    episode?: string;
+}): ScreenwalkRecord | null;
+/** Strict guard for a record as `screenwalk.json` writes it. */
+export declare function isScreenwalkRecord(value: unknown): value is ScreenwalkRecord;
+//# sourceMappingURL=screenwalk.d.ts.map

package/dist/screenwalk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenwalk.d.ts","sourceRoot":"","sources":["../src/screenwalk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,mGAAmG;AACnG,eAAO,MAAM,2BAA2B,sBAAsB,CAAA;AAE9D,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB,gBAAgB,CAAA;AAErD,2CAA2C;AAC3C,eAAO,MAAM,eAAe,oBAAoB,CAAA;AAEhD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,wPAkBpB,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAKD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAOvE;AAED,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,oGAAoG;IACpG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;CACrC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAWvE;AAED,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,eAAO,MAAM,uBAAuB,8DAA+D,CAAA;AACnG,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3E,kGAAkG;AAClG,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAA;IAC1B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAA;IAClB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,mBAAmB,CAAA;IAC/B,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B,cAAc,EAAE,uBAAuB,EAAE,CAAA;IACzC,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,yDAAyD;IACzD,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAC1B,6GAA6G;IAC7G,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,+MAkBzB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,sBAAsB,6LAgBzB,CAAA;AAuJV,qGAAqG;AACrG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,eAAe,GAAG,SAAS,CAIrH;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,gBAAgB,GAAG,IAAI,CAyDzH;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAe5E"}

package/dist/screenwalk.js

@@ -0,0 +1,438 @@
+/**
+ * The chronicle SCREENWALK record — a recording of a person working live with agent
+ * sessions, with their voices, held by an episode.
+ *
+ * Episode 550 ("The Screenwalk as a Media Type") drew the type before any code held it, in
+ * `diagrams/screenwalk.erdf.json`: an Episode holds Screenwalks; a Screenwalk witnesses
+ * sessions, ends with witness closings, is read as one Review and is teased by Shorts. Its
+ * states are the episode's two machines, `screenwalk.smdf.json` (NotStarted to
+ * InConversation) and the media cycle that continues after Reviewed.
+ *
+ * File: `captures/screenwalk-<id>/screenwalk.json` in the episode vessel, beside the seat
+ * ledgers. `capture.json` stays the descriptor of a phone audio take (`@miadi/episode-capture`),
+ * whose reader skips every other shape. The screenwalk `capture.json` files written by hand
+ * before this record existed are read by `toScreenwalkRecord` and converted.
+ *
+ * The id is the stamp the person writes when they press record, `yymmddHHMM`
+ * (`miadi-screenwalk:2610061207`). The first records used `yymmdd-NNN`. The stamp is the
+ * minute the person named. `recording.started` is where the uploaded video's clock begins,
+ * which can differ from it (a retake).
+ *
+ * Shape (`screenwalk.json`):
+ *
+ *   { "screenwalk": "2610061207", "reference": "miadi-screenwalk:2610061207",
+ *     "state": "Reviewed", "episode": "2026-10-01-episode-550-…", "stamp": "2026-10-06T12:07",
+ *     "recording": { "started": "…", "length": "about 24:30", "evidence": "…", "retake": "…" },
+ *     "video": { "url": "https://youtu.be/…", "title": "…" },
+ *     "review": { "id": "6a2b5b59-…", "version": 1 },
+ *     "related": [], "sessions": [{ "session_id": "…", "name": "…", "ledger": "seat-….md" }],
+ *     "closings": [], "transcriptions": [{ "file": "…", "source": "…", "coverage": "…" }],
+ *     "outputs": [], "stills": [{ "file": "images/screenwalk-2610061207/frame.webp", "at": "12:31" }],
+ *     "seeds": ["images/screenwalk-lifecycle-261007.png"], "finding": "…" }
+ *
+ * Pure — no fs, no fetch. Reading and writing the file is the consumer's. Ref: jgwill/Miadi#707.
+ */
+import { isReviewId, parseReviewRef } from "./episode-review.js";
+/** The portable reference form: `miadi-screenwalk:<id>`. `miadi-screenwalk://<id>` is read too. */
+export const SCREENWALK_REFERENCE_PREFIX = "miadi-screenwalk:";
+/** The folder a screenwalk lives in, under the vessel's `captures/`: `screenwalk-<id>`. */
+export const SCREENWALK_FOLDER_PREFIX = "screenwalk-";
+/** The record's file inside its folder. */
+export const SCREENWALK_FILE = "screenwalk.json";
+/**
+ * Every state a screenwalk can be in: Episode 550's `screenwalk.smdf.json`, then the media
+ * cycle that continues it after Reviewed (`screenwalk-media-cycle.smdf.json`).
+ */
+export const SCREENWALK_STATES = [
+    "NotStarted",
+    "Recording",
+    "Witnessing",
+    "ClosingDrafted",
+    "Played",
+    "Revising",
+    "Recorded",
+    "Published",
+    "Reviewed",
+    "Chronicled",
+    "InConversation",
+    "Enriched",
+    "Notebooked",
+    "MediaGenerated",
+    "Watched",
+    "HeldInCircle",
+    "ScriptedNext",
+];
+export function isScreenwalkState(value) {
+    return typeof value === "string" && SCREENWALK_STATES.includes(value);
+}
+/** A date and time stamp of six to ten digits, then optional `-word` parts: `2610061207`, `261005-001`. */
+const SCREENWALK_ID = /^[0-9]{6,10}(?:-[0-9a-z]+)*$/;
+export function isScreenwalkId(value) {
+    return typeof value === "string" && SCREENWALK_ID.test(value);
+}
+export function screenwalkReference(id) {
+    return `${SCREENWALK_REFERENCE_PREFIX}${id}`;
+}
+export function screenwalkFolder(id) {
+    return `${SCREENWALK_FOLDER_PREFIX}${id}`;
+}
+/** The record's path inside an episode vessel, relative to the vessel. */
+export function screenwalkPath(id) {
+    return `captures/${screenwalkFolder(id)}/${SCREENWALK_FILE}`;
+}
+/**
+ * Read a screenwalk reference: `miadi-screenwalk:<id>`, `miadi-screenwalk://<id>`, a folder
+ * name `screenwalk-<id>`, or a bare id. Null for anything else.
+ */
+export function parseScreenwalkRef(input) {
+    if (typeof input !== "string")
+        return null;
+    let raw = input.trim().toLowerCase();
+    if (raw.startsWith(SCREENWALK_REFERENCE_PREFIX))
+        raw = raw.slice(SCREENWALK_REFERENCE_PREFIX.length).replace(/^\/\//, "");
+    else if (raw.startsWith(SCREENWALK_FOLDER_PREFIX))
+        raw = raw.slice(SCREENWALK_FOLDER_PREFIX.length);
+    if (!isScreenwalkId(raw))
+        return null;
+    return { id: raw, reference: screenwalkReference(raw), folder: screenwalkFolder(raw) };
+}
+/**
+ * The date and time an id names, read from its leading digits (`yymmdd`, `yymmddHH`,
+ * `yymmddHHMM`). Local time, as the person wrote it. Null when the digits are not a date.
+ */
+export function parseScreenwalkStamp(id) {
+    const digits = /^([0-9]{6,10})/.exec(id)?.[1];
+    if (!digits || (digits.length !== 6 && digits.length !== 8 && digits.length !== 10))
+        return null;
+    const [yy, mm, dd, hh, mi] = [0, 2, 4, 6, 8].map((i) => digits.slice(i, i + 2));
+    const month = Number(mm);
+    const day = Number(dd);
+    if (month < 1 || month > 12 || day < 1 || day > 31)
+        return null;
+    const date = `20${yy}-${mm}-${dd}`;
+    if (!hh)
+        return { date, precision: "day" };
+    if (Number(hh) > 23 || (mi && Number(mi) > 59))
+        return null;
+    return { date, time: `${hh}:${mi || "00"}`, precision: mi ? "minute" : "hour" };
+}
+export const SCREENWALK_OUTPUT_KINDS = ["dialogue", "chapters", "short", "audio", "other"];
+/** The record's keys in the order `screenwalk.json` writes them. */
+export const SCREENWALK_RECORD_KEYS = [
+    "screenwalk",
+    "reference",
+    "state",
+    "episode",
+    "stamp",
+    "recording",
+    "video",
+    "review",
+    "related",
+    "sessions",
+    "closings",
+    "transcriptions",
+    "outputs",
+    "stills",
+    "seeds",
+    "finding",
+    "audio_take",
+];
+/**
+ * Keys of the hand-written screenwalk `capture.json` files that `toScreenwalkRecord` maps.
+ * A converter that meets any other key should stop rather than drop it.
+ */
+export const LEGACY_SCREENWALK_KEYS = [
+    "stem",
+    "video",
+    "title",
+    "review",
+    "reference",
+    "started",
+    "session",
+    "sessions",
+    "seat_ledgers",
+    "related",
+    "recording",
+    "stamp_estimate",
+    "transcriptions",
+    "finding",
+    "note",
+];
+function text(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function obj(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
+}
+function list(value) {
+    return Array.isArray(value) ? value : [];
+}
+const SESSION_ID = /^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\b\s*(?:\((.*)\))?\s*$/is;
+/** A session written as an object, or as the early string `"<uuid> (note)"`. */
+function toSession(raw) {
+    if (typeof raw === "string") {
+        const match = SESSION_ID.exec(raw.trim());
+        if (match)
+            return { session_id: match[1].toLowerCase(), ...(text(match[2]) ? { note: text(match[2]) } : {}) };
+        return text(raw) ? { note: text(raw) } : null;
+    }
+    const r = obj(raw);
+    if (!r)
+        return null;
+    const session = {};
+    const id = text(r.session_id) ?? text(r.session);
+    if (id)
+        session.session_id = id;
+    const name = text(r.name) ?? text(r.seat);
+    if (name)
+        session.name = name;
+    const note = text(r.note);
+    if (note)
+        session.note = note;
+    const ledger = text(r.ledger) ?? text(r.file);
+    if (ledger)
+        session.ledger = ledger;
+    return Object.keys(session).length ? session : null;
+}
+/** Attach each early `seat_ledgers` entry to its session: by session id, then by a note opening with the seat's name. */
+function attachLedgers(sessions, ledgers) {
+    for (const raw of ledgers) {
+        const ledger = toSession(raw);
+        if (!ledger?.ledger)
+            continue;
+        const seat = ledger.name;
+        const match = sessions.find((s) => (ledger.session_id && s.session_id === ledger.session_id) ||
+            (seat && !s.name && s.note !== undefined && new RegExp(`^${seat.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?:[;,)]|$)`).test(s.note)));
+        if (match) {
+            if (seat && !match.name) {
+                match.name = seat;
+                if (match.note) {
+                    const rest = match.note.slice(seat.length).replace(/^[;,]\s*/, "").trim();
+                    if (rest)
+                        match.note = rest;
+                    else
+                        delete match.note;
+                }
+            }
+            match.ledger = ledger.ledger;
+            if (ledger.session_id && !match.session_id)
+                match.session_id = ledger.session_id;
+        }
+        else {
+            sessions.push(ledger);
+        }
+    }
+    return sessions;
+}
+function toTranscription(raw) {
+    const r = obj(raw);
+    const file = text(r?.file);
+    if (!r || !file)
+        return null;
+    const out = { file };
+    const source = text(r.source);
+    if (source)
+        out.source = source;
+    const coverage = text(r.coverage);
+    if (coverage)
+        out.coverage = coverage;
+    if (typeof r.complete === "boolean")
+        out.complete = r.complete;
+    return out;
+}
+function toClosing(raw) {
+    const r = obj(raw);
+    if (!r || typeof r.version !== "number" || !Number.isSafeInteger(r.version) || r.version < 1)
+        return null;
+    const out = { version: r.version };
+    const file = text(r.file);
+    if (file)
+        out.file = file;
+    const correction = text(r.correction);
+    if (correction)
+        out.correction = correction;
+    return out;
+}
+function toOutput(raw) {
+    const r = obj(raw);
+    if (!r)
+        return null;
+    const kind = SCREENWALK_OUTPUT_KINDS.includes(r.kind) ? r.kind : undefined;
+    if (!kind)
+        return null;
+    const out = { kind };
+    for (const key of ["ref", "starts_at", "ends_at", "note"]) {
+        const value = text(r[key]);
+        if (value)
+            out[key] = value;
+    }
+    return out;
+}
+function toStill(raw) {
+    const r = obj(raw);
+    const file = r ? text(r.file) : text(raw);
+    if (!file)
+        return null;
+    const out = { file };
+    const at = r && text(r.at);
+    if (at)
+        out.at = at;
+    const note = r && text(r.note);
+    if (note)
+        out.note = note;
+    return out;
+}
+function toReview(raw) {
+    const r = obj(raw);
+    const ref = parseReviewRef(r ? (text(r.id) ?? text(r.url)) : raw);
+    if (!ref)
+        return undefined;
+    const version = r && typeof r.version === "number" && Number.isSafeInteger(r.version) && r.version > 0 ? r.version : ref.version;
+    return { id: ref.id, ...(version !== undefined ? { version } : {}) };
+}
+function toVideo(raw, title) {
+    const r = obj(raw);
+    const url = r ? text(r.url) : text(raw);
+    if (!url)
+        return undefined;
+    const video = { url };
+    const t = (r && text(r.title)) ?? text(title);
+    if (t)
+        video.title = t;
+    const published = r && text(r.published_at);
+    if (published)
+        video.published_at = published;
+    return video;
+}
+function toRecording(raw, estimate) {
+    const r = obj(raw);
+    const e = obj(estimate);
+    const recording = {};
+    const fromEstimate = e ? parseScreenwalkStamp(text(e.stamp) ?? "") : null;
+    const started = (r && (text(r.started) ?? text(r.started_estimate))) ?? (fromEstimate?.time ? `${fromEstimate.date}T${fromEstimate.time}` : undefined);
+    if (started)
+        recording.started = started;
+    const length = r && text(r.length);
+    if (length)
+        recording.length = length;
+    const evidence = (r && text(r.evidence)) ?? (e && text(e.evidence));
+    if (evidence)
+        recording.evidence = evidence;
+    const retake = r && text(r.retake);
+    if (retake)
+        recording.retake = retake;
+    return Object.keys(recording).length ? recording : undefined;
+}
+/** The furthest state the record's own fields prove: a review, then a video. Undefined otherwise. */
+export function deriveScreenwalkState(record) {
+    if (record.review)
+        return "Reviewed";
+    if (record.video)
+        return "Published";
+    return undefined;
+}
+/**
+ * Tolerant reader for a `screenwalk.json`, or for a screenwalk `capture.json` written by hand
+ * before this record existed (`stem`, `video` as a string, `review` as `miadi-review:<uuid>`,
+ * `session`/`sessions` strings, `seat_ledgers`, `stamp_estimate`). The id comes from
+ * `screenwalk`, then `stem`, then `options.id` (the folder name), then `reference`. Null when
+ * none names a screenwalk.
+ */
+export function toScreenwalkRecord(raw, options = {}) {
+    const r = obj(raw);
+    if (!r)
+        return null;
+    const ref = parseScreenwalkRef(r.screenwalk) ?? parseScreenwalkRef(r.stem) ?? parseScreenwalkRef(options.id) ?? parseScreenwalkRef(r.reference);
+    if (!ref)
+        return null;
+    const record = {
+        screenwalk: ref.id,
+        reference: ref.reference,
+        sessions: [],
+        closings: [],
+        transcriptions: [],
+        outputs: [],
+    };
+    const episode = text(r.episode) ?? options.episode;
+    const stamp = text(r.stamp) ?? text(r.started);
+    const named = parseScreenwalkStamp(ref.id);
+    const recording = toRecording(r.recording, r.stamp_estimate);
+    const video = toVideo(r.video, r.title);
+    const review = toReview(r.review);
+    const related = list(r.related).map(text).filter((v) => v !== undefined);
+    const sessions = attachLedgers([...list(r.sessions), ...(r.session !== undefined ? [r.session] : [])].map(toSession).filter((s) => s !== null), list(r.seat_ledgers));
+    const finding = text(r.finding);
+    const audioTake = text(r.audio_take);
+    const state = isScreenwalkState(r.state) ? r.state : deriveScreenwalkState({ review, video });
+    if (state)
+        record.state = state;
+    if (episode)
+        record.episode = episode;
+    if (stamp)
+        record.stamp = stamp;
+    else if (named?.time)
+        record.stamp = `${named.date}T${named.time}`;
+    if (recording)
+        record.recording = recording;
+    if (video)
+        record.video = video;
+    if (review)
+        record.review = review;
+    if (related.length)
+        record.related = related;
+    record.sessions = sessions.map((s) => {
+        const ordered = {};
+        for (const key of ["session_id", "name", "note", "ledger"])
+            if (s[key] !== undefined)
+                ordered[key] = s[key];
+        return ordered;
+    });
+    record.closings = list(r.closings).map(toClosing).filter((c) => c !== null);
+    record.transcriptions = list(r.transcriptions).map(toTranscription).filter((t) => t !== null);
+    record.outputs = list(r.outputs).map(toOutput).filter((o) => o !== null);
+    const stills = list(r.stills).map(toStill).filter((x) => x !== null);
+    if (stills.length)
+        record.stills = stills;
+    const seeds = list(r.seeds).map(text).filter((v) => v !== undefined);
+    if (seeds.length)
+        record.seeds = seeds;
+    if (finding)
+        record.finding = finding;
+    if (audioTake)
+        record.audio_take = audioTake;
+    // Rebuild in the order the file writes, so a written record diffs cleanly.
+    const ordered = {};
+    for (const key of SCREENWALK_RECORD_KEYS)
+        if (record[key] !== undefined)
+            ordered[key] = record[key];
+    return ordered;
+}
+/** Strict guard for a record as `screenwalk.json` writes it. */
+export function isScreenwalkRecord(value) {
+    const r = obj(value);
+    if (!r || !isScreenwalkId(r.screenwalk) || r.reference !== screenwalkReference(r.screenwalk))
+        return false;
+    if (r.state !== undefined && !isScreenwalkState(r.state))
+        return false;
+    for (const key of ["sessions", "closings", "transcriptions", "outputs"])
+        if (!Array.isArray(r[key]))
+            return false;
+    const video = r.video === undefined ? null : obj(r.video);
+    if (r.video !== undefined && !text(video?.url))
+        return false;
+    const review = r.review === undefined ? null : obj(r.review);
+    if (r.review !== undefined && !isReviewId(review?.id))
+        return false;
+    if (!r.outputs.every((o) => toOutput(o) !== null))
+        return false;
+    if (!r.transcriptions.every((t) => toTranscription(t) !== null))
+        return false;
+    if (!r.closings.every((c) => toClosing(c) !== null))
+        return false;
+    if (r.stills !== undefined && !(Array.isArray(r.stills) && r.stills.every((x) => obj(x) && toStill(x) !== null)))
+        return false;
+    if (r.seeds !== undefined && !(Array.isArray(r.seeds) && r.seeds.every((x) => text(x) !== undefined)))
+        return false;
+    return true;
+}
+//# sourceMappingURL=screenwalk.js.map

package/dist/screenwalk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenwalk.js","sourceRoot":"","sources":["../src/screenwalk.ts"],"names":[],"mappings":"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"}

package/dist/story-library-manifest.d.ts

@@ -10,7 +10,7 @@
  * and validates what it is handed so the app and forgewright never fork the
  * read-side.
  *
- * OWNERSHIP (jgwill/Miadi#592, packages/CLAUDE.md): this module is the *declaration*
+ * OWNERSHIP (jgwill/Miadi#592, packages/AGENTS.md): this module is the *declaration*
  * of the chronicle→book edge. `@miadi/inquiry-weave` owns its *enumeration* and never
  * authors a story; `packages/passages` owns the *derivation* of a book from a vessel,
  * as a read-only projection of the chronicle; `app/chronicle` renders and serves.

package/dist/story-library-manifest.js

@@ -10,7 +10,7 @@
  * and validates what it is handed so the app and forgewright never fork the
  * read-side.
  *
- * OWNERSHIP (jgwill/Miadi#592, packages/CLAUDE.md): this module is the *declaration*
+ * OWNERSHIP (jgwill/Miadi#592, packages/AGENTS.md): this module is the *declaration*
  * of the chronicle→book edge. `@miadi/inquiry-weave` owns its *enumeration* and never
  * authors a story; `packages/passages` owns the *derivation* of a book from a vessel,
  * as a read-only projection of the chronicle; `app/chronicle` renders and serves.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/episodic-memory-schema",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "TypeScript types and JSON Schema for episodic memory — the durable session-to-session memory layer in the Miadi orchestration kit. Narrative layer is NCP-aligned; provenance layer is W3C PROV-DM and OAIS-informed.",
   "keywords": [
     "miadi",
@@ -31,6 +31,7 @@
       "default": "./dist/index.js"
     },
     "./schema": "./schema/episodic-memory.schema.json",
+    "./schema/screenwalk": "./schema/screenwalk.schema.json",
     "./package.json": "./package.json"
   },
   "files": [

package/schema/screenwalk.schema.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/jgwill/Miadi/packages/episodic-memory-schema/schema/screenwalk.schema.json",
+  "title": "Screenwalk record",
+  "description": "captures/screenwalk-<id>/screenwalk.json in a chronicle episode vessel: a recording of a person working live with agent sessions, with their voices. Types: src/screenwalk.ts.",
+  "type": "object",
+  "required": ["screenwalk", "reference", "sessions", "closings", "transcriptions", "outputs"],
+  "properties": {
+    "screenwalk": { "type": "string", "pattern": "^[0-9]{6,10}(?:-[0-9a-z]+)*$", "description": "The stamp yymmddHHMM, or an early yymmdd-NNN." },
+    "reference": { "type": "string", "pattern": "^miadi-screenwalk:[0-9]{6,10}(?:-[0-9a-z]+)*$" },
+    "state": {
+      "enum": ["NotStarted", "Recording", "Witnessing", "ClosingDrafted", "Played", "Revising", "Recorded", "Published", "Reviewed", "Chronicled", "InConversation", "Enriched", "Notebooked", "MediaGenerated", "Watched", "HeldInCircle", "ScriptedNext"]
+    },
+    "episode": { "type": "string", "description": "The episode directory that holds it." },
+    "stamp": { "type": "string", "description": "The minute the person named, YYYY-MM-DDTHH:MM local." },
+    "recording": {
+      "type": "object",
+      "properties": {
+        "started": { "type": "string" },
+        "length": { "type": "string" },
+        "evidence": { "type": "string" },
+        "retake": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "video": {
+      "type": "object",
+      "required": ["url"],
+      "properties": {
+        "url": { "type": "string", "minLength": 1 },
+        "title": { "type": "string" },
+        "published_at": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "review": {
+      "type": "object",
+      "required": ["id"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$" },
+        "version": { "type": "integer", "minimum": 1 }
+      },
+      "additionalProperties": false
+    },
+    "related": { "type": "array", "items": { "type": "string" } },
+    "sessions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "session_id": { "type": "string" },
+          "name": { "type": "string" },
+          "note": { "type": "string" },
+          "ledger": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "closings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["version"],
+        "properties": {
+          "version": { "type": "integer", "minimum": 1 },
+          "file": { "type": "string" },
+          "correction": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "transcriptions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["file"],
+        "properties": {
+          "file": { "type": "string", "minLength": 1 },
+          "source": { "type": "string" },
+          "coverage": { "type": "string" },
+          "complete": { "type": "boolean" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "outputs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["kind"],
+        "properties": {
+          "kind": { "enum": ["dialogue", "chapters", "short", "audio", "other"] },
+          "ref": { "type": "string" },
+          "starts_at": { "type": "string" },
+          "ends_at": { "type": "string" },
+          "note": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "stills": {
+      "type": "array",
+      "description": "Frames of this walk kept as images in the episode, by convention under images/screenwalk-<id>/.",
+      "items": {
+        "type": "object",
+        "required": ["file"],
+        "properties": {
+          "file": { "type": "string", "minLength": 1 },
+          "at": { "type": "string", "description": "mm:ss or h:mm:ss in the video." },
+          "note": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "seeds": {
+      "type": "array",
+      "description": "Vessel-relative paths of the images this walk starts from.",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "finding": { "type": "string" },
+    "audio_take": { "type": "string" }
+  },
+  "additionalProperties": false
+}