@kienmatu/inkos-core 0.1.0

package/dist/play/play-db-factory.js

@@ -0,0 +1,18 @@
+import { PlayDB } from "./play-db.js";
+import { PlayFileDB } from "./play-file-db.js";
+export function createPlayDB(runDir) {
+    try {
+        return new PlayDB(runDir);
+    }
+    catch (error) {
+        if (isMissingNodeSqliteError(error)) {
+            return new PlayFileDB(runDir);
+        }
+        throw error;
+    }
+}
+function isMissingNodeSqliteError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.includes("node:sqlite") || message.includes("No such built-in module");
+}
+//# sourceMappingURL=play-db-factory.js.map

package/dist/play/play-db-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"play-db-factory.js","sourceRoot":"","sources":["../../src/play/play-db-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,UAAU,EAA0B,MAAM,mBAAmB,CAAC;AASvE,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AACxF,CAAC"}

package/dist/play/play-db.d.ts

@@ -0,0 +1,22 @@
+import { type PlayEdge, type PlayEdgeInput, type PlayEntity, type PlayEntityInput, type PlayEvent, type PlayEventInput, type PlayStateSlot, type PlayStateSlotInput } from "../models/play.js";
+import type { PlayGraphSnapshot } from "./play-file-db.js";
+export declare class PlayDB {
+    private readonly db;
+    constructor(runDir: string);
+    private migrate;
+    upsertEntity(entity: PlayEntityInput): void;
+    getEntity(id: string): PlayEntity | null;
+    upsertEdge(edge: PlayEdgeInput): void;
+    expireEdge(edgeId: string, validUntilEventId: string): void;
+    getCurrentEdgesForEntity(entityId: string): PlayEdge[];
+    getEvidenceForClaim(claimId: string): PlayEntity[];
+    upsertStateSlot(slot: PlayStateSlotInput): void;
+    getStateSlotsForEntity(entityId: string): PlayStateSlot[];
+    recordEvent(event: PlayEventInput): void;
+    getEvent(id: string): PlayEvent | null;
+    snapshot(): PlayGraphSnapshot;
+    replaceWithSnapshot(snapshot: PlayGraphSnapshot): void;
+    transaction<T>(fn: () => T): T;
+    close(): void;
+}
+//# sourceMappingURL=play-db.d.ts.map

package/dist/play/play-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"play-db.d.ts","sourceRoot":"","sources":["../../src/play/play-db.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA8C3D,qBAAa,MAAM;IAEjB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAM;gBAEb,MAAM,EAAE,MAAM;IAQ1B,OAAO,CAAC,OAAO;IAmDf,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAgB3C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAOxC,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAsBrC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAM3D,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAUtD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAclD,eAAe,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAe/C,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAUzD,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAexC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAOtC,QAAQ,IAAI,iBAAiB;IAqB7B,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAatD,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAY9B,KAAK,IAAI,IAAI;CAGd"}

package/dist/play/play-db.js

@@ -0,0 +1,248 @@
+import { mkdirSync } from "node:fs";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { PlayEdgeSchema, PlayEntitySchema, PlayEventSchema, PlayStateSlotSchema, } from "../models/play.js";
+const require = createRequire(import.meta.url);
+const ENTITY_SELECT_COLUMNS = `
+  entities.id,
+  entities.type,
+  entities.label,
+  entities.summary,
+  entities.status,
+  entities.created_event AS createdEventId,
+  entities.updated_event AS updatedEventId
+`;
+const EDGE_SELECT_COLUMNS = `
+  id,
+  from_id AS fromId,
+  type,
+  to_id AS toId,
+  value_json AS valueJson,
+  valid_from_event AS validFromEventId,
+  valid_until_event AS validUntilEventId,
+  source_event_id AS sourceEventId,
+  visibility_json AS visibilityJson,
+  strength,
+  confidence
+`;
+const STATE_SLOT_SELECT_COLUMNS = `
+  id,
+  owner_entity_id AS ownerEntityId,
+  kind,
+  label,
+  value_json AS valueJson,
+  updated_event AS updatedEventId
+`;
+const EVENT_SELECT_COLUMNS = `
+  id,
+  turn,
+  action_kind AS actionKind,
+  raw_input AS rawInput,
+  outcome_summary AS outcomeSummary,
+  created_at AS createdAt
+`;
+export class PlayDB {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    db;
+    constructor(runDir) {
+        mkdirSync(runDir, { recursive: true });
+        const { DatabaseSync } = require("node:sqlite");
+        this.db = new DatabaseSync(join(runDir, "play.db"));
+        this.db.exec("PRAGMA journal_mode = WAL");
+        this.migrate();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS entities (
+        id TEXT PRIMARY KEY,
+        type TEXT NOT NULL,
+        label TEXT NOT NULL,
+        summary TEXT NOT NULL DEFAULT '',
+        status TEXT NOT NULL DEFAULT '',
+        created_event TEXT,
+        updated_event TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS edges (
+        id TEXT PRIMARY KEY,
+        from_id TEXT NOT NULL,
+        type TEXT NOT NULL,
+        to_id TEXT NOT NULL,
+        value_json TEXT NOT NULL DEFAULT '{}',
+        valid_from_event TEXT NOT NULL,
+        valid_until_event TEXT,
+        source_event_id TEXT NOT NULL,
+        visibility_json TEXT NOT NULL DEFAULT '{}',
+        strength REAL,
+        confidence REAL
+      );
+
+      CREATE TABLE IF NOT EXISTS state_slots (
+        id TEXT PRIMARY KEY,
+        owner_entity_id TEXT,
+        kind TEXT NOT NULL,
+        label TEXT NOT NULL,
+        value_json TEXT NOT NULL,
+        updated_event TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS events (
+        id TEXT PRIMARY KEY,
+        turn INTEGER NOT NULL,
+        action_kind TEXT NOT NULL,
+        raw_input TEXT NOT NULL,
+        outcome_summary TEXT NOT NULL DEFAULT '',
+        created_at TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_play_edges_from ON edges(from_id, valid_until_event);
+      CREATE INDEX IF NOT EXISTS idx_play_edges_to ON edges(to_id, type, valid_until_event);
+      CREATE INDEX IF NOT EXISTS idx_play_state_owner ON state_slots(owner_entity_id);
+      CREATE INDEX IF NOT EXISTS idx_play_events_turn ON events(turn);
+    `);
+    }
+    upsertEntity(entity) {
+        const parsed = PlayEntitySchema.parse(entity);
+        this.db.prepare(`INSERT OR REPLACE INTO entities (id, type, label, summary, status, created_event, updated_event)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`).run(parsed.id, parsed.type, parsed.label, parsed.summary, parsed.status, parsed.createdEventId ?? null, parsed.updatedEventId ?? null);
+    }
+    getEntity(id) {
+        const row = this.db.prepare(`SELECT ${ENTITY_SELECT_COLUMNS} FROM entities WHERE id = ?`).get(id);
+        return row ? rowToEntity(row) : null;
+    }
+    upsertEdge(edge) {
+        const parsed = PlayEdgeSchema.parse(edge);
+        this.db.prepare(`INSERT OR REPLACE INTO edges (
+         id, from_id, type, to_id, value_json, valid_from_event, valid_until_event,
+         source_event_id, visibility_json, strength, confidence
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(parsed.id, parsed.fromId, parsed.type, parsed.toId, JSON.stringify(parsed.value), parsed.validFromEventId, parsed.validUntilEventId, parsed.sourceEventId, JSON.stringify(parsed.visibility), parsed.strength ?? null, parsed.confidence ?? null);
+    }
+    expireEdge(edgeId, validUntilEventId) {
+        this.db.prepare("UPDATE edges SET valid_until_event = ? WHERE id = ?").run(validUntilEventId, edgeId);
+    }
+    getCurrentEdgesForEntity(entityId) {
+        const rows = this.db.prepare(`SELECT ${EDGE_SELECT_COLUMNS}
+       FROM edges
+       WHERE (from_id = ? OR to_id = ?) AND valid_until_event IS NULL
+       ORDER BY type, id`).all(entityId, entityId);
+        return rows.map(rowToEdge);
+    }
+    getEvidenceForClaim(claimId) {
+        const rows = this.db.prepare(`SELECT ${ENTITY_SELECT_COLUMNS}
+       FROM entities
+       INNER JOIN edges ON entities.id = edges.from_id
+       WHERE edges.to_id = ?
+         AND edges.type = 'supports'
+         AND edges.valid_until_event IS NULL
+         AND entities.type IN ('evidence', 'clue')
+       ORDER BY COALESCE(edges.strength, 0) DESC, entities.id ASC`).all(claimId);
+        return rows.map(rowToEntity);
+    }
+    upsertStateSlot(slot) {
+        const parsed = PlayStateSlotSchema.parse(slot);
+        this.db.prepare(`INSERT OR REPLACE INTO state_slots (id, owner_entity_id, kind, label, value_json, updated_event)
+       VALUES (?, ?, ?, ?, ?, ?)`).run(parsed.id, parsed.ownerEntityId ?? null, parsed.kind, parsed.label, JSON.stringify(parsed.value), parsed.updatedEventId);
+    }
+    getStateSlotsForEntity(entityId) {
+        const rows = this.db.prepare(`SELECT ${STATE_SLOT_SELECT_COLUMNS}
+       FROM state_slots
+       WHERE owner_entity_id = ?
+       ORDER BY kind, label, id`).all(entityId);
+        return rows.map(rowToStateSlot);
+    }
+    recordEvent(event) {
+        const parsed = PlayEventSchema.parse(event);
+        this.db.prepare(`INSERT OR REPLACE INTO events (id, turn, action_kind, raw_input, outcome_summary, created_at)
+       VALUES (?, ?, ?, ?, ?, ?)`).run(parsed.id, parsed.turn, parsed.actionKind, parsed.rawInput, parsed.outcomeSummary, parsed.createdAt);
+    }
+    getEvent(id) {
+        const row = this.db.prepare(`SELECT ${EVENT_SELECT_COLUMNS} FROM events WHERE id = ?`).get(id);
+        return row ? PlayEventSchema.parse(row) : null;
+    }
+    snapshot() {
+        const entities = this.db.prepare(`SELECT ${ENTITY_SELECT_COLUMNS} FROM entities ORDER BY id`).all();
+        const edges = this.db.prepare(`SELECT ${EDGE_SELECT_COLUMNS} FROM edges ORDER BY id`).all();
+        const stateSlots = this.db.prepare(`SELECT ${STATE_SLOT_SELECT_COLUMNS} FROM state_slots ORDER BY id`).all();
+        const events = this.db.prepare(`SELECT ${EVENT_SELECT_COLUMNS} FROM events ORDER BY turn, id`).all();
+        return {
+            entities: entities.map(rowToEntity),
+            edges: edges.map(rowToEdge),
+            stateSlots: stateSlots.map(rowToStateSlot),
+            events: events.map((row) => PlayEventSchema.parse(row)),
+        };
+    }
+    replaceWithSnapshot(snapshot) {
+        this.transaction(() => {
+            this.db.prepare("DELETE FROM state_slots").run();
+            this.db.prepare("DELETE FROM edges").run();
+            this.db.prepare("DELETE FROM entities").run();
+            this.db.prepare("DELETE FROM events").run();
+            for (const event of snapshot.events)
+                this.recordEvent(event);
+            for (const entity of snapshot.entities)
+                this.upsertEntity(entity);
+            for (const edge of snapshot.edges)
+                this.upsertEdge(edge);
+            for (const slot of snapshot.stateSlots)
+                this.upsertStateSlot(slot);
+        });
+    }
+    transaction(fn) {
+        this.db.exec("BEGIN IMMEDIATE");
+        try {
+            const result = fn();
+            this.db.exec("COMMIT");
+            return result;
+        }
+        catch (error) {
+            this.db.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    close() {
+        this.db.close();
+    }
+}
+function rowToEntity(row) {
+    return PlayEntitySchema.parse({
+        id: row.id,
+        type: row.type,
+        label: row.label,
+        summary: row.summary,
+        status: row.status,
+        ...(row.createdEventId ? { createdEventId: row.createdEventId } : {}),
+        ...(row.updatedEventId ? { updatedEventId: row.updatedEventId } : {}),
+    });
+}
+function rowToEdge(row) {
+    return PlayEdgeSchema.parse({
+        id: row.id,
+        fromId: row.fromId,
+        type: row.type,
+        toId: row.toId,
+        value: parseJsonObject(row.valueJson),
+        validFromEventId: row.validFromEventId,
+        validUntilEventId: row.validUntilEventId,
+        sourceEventId: row.sourceEventId,
+        visibility: parseJsonObject(row.visibilityJson),
+        ...(row.strength === null ? {} : { strength: row.strength }),
+        ...(row.confidence === null ? {} : { confidence: row.confidence }),
+    });
+}
+function rowToStateSlot(row) {
+    return PlayStateSlotSchema.parse({
+        id: row.id,
+        ownerEntityId: row.ownerEntityId,
+        kind: row.kind,
+        label: row.label,
+        value: JSON.parse(row.valueJson),
+        updatedEventId: row.updatedEventId,
+    });
+}
+function parseJsonObject(value) {
+    const parsed = JSON.parse(value);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+        ? parsed
+        : {};
+}
+//# sourceMappingURL=play-db.js.map

package/dist/play/play-db.js.map

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

package/dist/play/play-file-db.d.ts

@@ -0,0 +1,32 @@
+import { type PlayEdge, type PlayEdgeInput, type PlayEntity, type PlayEntityInput, type PlayEvent, type PlayEventInput, type PlayStateSlot, type PlayStateSlotInput } from "../models/play.js";
+import type { PlayReducerDB } from "./play-reducer.js";
+export interface PlayGraphSnapshot {
+    readonly entities: PlayEntity[];
+    readonly edges: PlayEdge[];
+    readonly stateSlots: PlayStateSlot[];
+    readonly events: PlayEvent[];
+}
+export declare class PlayFileDB implements PlayReducerDB {
+    private readonly filePath;
+    private data;
+    private transactionBackup;
+    constructor(runDir: string);
+    upsertEntity(entity: PlayEntityInput): void;
+    getEntity(id: string): PlayEntity | null;
+    upsertEdge(edge: PlayEdgeInput): void;
+    expireEdge(edgeId: string, validUntilEventId: string): void;
+    getCurrentEdgesForEntity(entityId: string): PlayEdge[];
+    getEvidenceForClaim(claimId: string): PlayEntity[];
+    upsertStateSlot(slot: PlayStateSlotInput): void;
+    getStateSlotsForEntity(entityId: string): PlayStateSlot[];
+    recordEvent(event: PlayEventInput): void;
+    getEvent(id: string): PlayEvent | null;
+    snapshot(): PlayGraphSnapshot;
+    replaceWithSnapshot(snapshot: PlayGraphSnapshot): void;
+    transaction<T>(fn: () => T): T;
+    close(): void;
+    private load;
+    private persistIfNeeded;
+    private persist;
+}
+//# sourceMappingURL=play-file-db.d.ts.map

package/dist/play/play-file-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"play-file-db.d.ts","sourceRoot":"","sources":["../../src/play/play-file-db.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AASvD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;CAC9B;AAED,qBAAa,UAAW,YAAW,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,iBAAiB,CAA+B;gBAE5C,MAAM,EAAE,MAAM;IAM1B,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAM3C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIxC,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAMrC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAQ3D,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAMtD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAQlD,eAAe,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAM/C,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAMzD,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAMxC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAItC,QAAQ,IAAI,iBAAiB;IAS7B,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAiBtD,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAmB9B,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,OAAO;CAGhB"}

package/dist/play/play-file-db.js

@@ -0,0 +1,156 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { PlayEdgeSchema, PlayEntitySchema, PlayEventSchema, PlayStateSlotSchema, } from "../models/play.js";
+export class PlayFileDB {
+    filePath;
+    data;
+    transactionBackup = null;
+    constructor(runDir) {
+        mkdirSync(runDir, { recursive: true });
+        this.filePath = join(runDir, "play-graph.json");
+        this.data = this.load();
+    }
+    upsertEntity(entity) {
+        const parsed = PlayEntitySchema.parse(entity);
+        this.data.entities[parsed.id] = parsed;
+        this.persistIfNeeded();
+    }
+    getEntity(id) {
+        return this.data.entities[id] ?? null;
+    }
+    upsertEdge(edge) {
+        const parsed = PlayEdgeSchema.parse(edge);
+        this.data.edges[parsed.id] = parsed;
+        this.persistIfNeeded();
+    }
+    expireEdge(edgeId, validUntilEventId) {
+        const edge = this.data.edges[edgeId];
+        if (edge) {
+            this.data.edges[edgeId] = { ...edge, validUntilEventId };
+            this.persistIfNeeded();
+        }
+    }
+    getCurrentEdgesForEntity(entityId) {
+        return Object.values(this.data.edges)
+            .filter((edge) => edge.validUntilEventId === null && (edge.fromId === entityId || edge.toId === entityId))
+            .sort((a, b) => `${a.type}:${a.id}`.localeCompare(`${b.type}:${b.id}`));
+    }
+    getEvidenceForClaim(claimId) {
+        return Object.values(this.data.edges)
+            .filter((edge) => edge.validUntilEventId === null && edge.type === "supports" && edge.toId === claimId)
+            .map((edge) => this.data.entities[edge.fromId])
+            .filter((entity) => !!entity && (entity.type === "evidence" || entity.type === "clue"))
+            .sort((a, b) => a.id.localeCompare(b.id));
+    }
+    upsertStateSlot(slot) {
+        const parsed = PlayStateSlotSchema.parse(slot);
+        this.data.stateSlots[parsed.id] = parsed;
+        this.persistIfNeeded();
+    }
+    getStateSlotsForEntity(entityId) {
+        return Object.values(this.data.stateSlots)
+            .filter((slot) => slot.ownerEntityId === entityId)
+            .sort((a, b) => `${a.kind}:${a.label}:${a.id}`.localeCompare(`${b.kind}:${b.label}:${b.id}`));
+    }
+    recordEvent(event) {
+        const parsed = PlayEventSchema.parse(event);
+        this.data.events[parsed.id] = parsed;
+        this.persistIfNeeded();
+    }
+    getEvent(id) {
+        return this.data.events[id] ?? null;
+    }
+    snapshot() {
+        return {
+            entities: Object.values(this.data.entities).sort((a, b) => a.id.localeCompare(b.id)),
+            edges: Object.values(this.data.edges).sort((a, b) => a.id.localeCompare(b.id)),
+            stateSlots: Object.values(this.data.stateSlots).sort((a, b) => a.id.localeCompare(b.id)),
+            events: Object.values(this.data.events).sort((a, b) => a.turn - b.turn || a.id.localeCompare(b.id)),
+        };
+    }
+    replaceWithSnapshot(snapshot) {
+        const replace = () => {
+            this.data = {
+                entities: Object.fromEntries(snapshot.entities.map((entity) => [entity.id, PlayEntitySchema.parse(entity)])),
+                edges: Object.fromEntries(snapshot.edges.map((edge) => [edge.id, PlayEdgeSchema.parse(edge)])),
+                stateSlots: Object.fromEntries(snapshot.stateSlots.map((slot) => [slot.id, PlayStateSlotSchema.parse(slot)])),
+                events: Object.fromEntries(snapshot.events.map((event) => [event.id, PlayEventSchema.parse(event)])),
+            };
+        };
+        if (this.transactionBackup) {
+            replace();
+            return;
+        }
+        replace();
+        this.persist();
+    }
+    transaction(fn) {
+        if (this.transactionBackup) {
+            return fn();
+        }
+        this.transactionBackup = cloneData(this.data);
+        try {
+            const result = fn();
+            this.transactionBackup = null;
+            this.persist();
+            return result;
+        }
+        catch (error) {
+            const backup = this.transactionBackup;
+            if (backup)
+                this.data = backup;
+            this.transactionBackup = null;
+            this.persist();
+            throw error;
+        }
+    }
+    close() {
+        this.persist();
+    }
+    load() {
+        if (!existsSync(this.filePath))
+            return emptyData();
+        try {
+            const parsed = JSON.parse(readFileSync(this.filePath, "utf-8"));
+            return {
+                entities: parseRecord(parsed.entities, PlayEntitySchema),
+                edges: parseRecord(parsed.edges, PlayEdgeSchema),
+                stateSlots: parseRecord(parsed.stateSlots, PlayStateSlotSchema),
+                events: parseRecord(parsed.events, PlayEventSchema),
+            };
+        }
+        catch {
+            return emptyData();
+        }
+    }
+    persistIfNeeded() {
+        if (!this.transactionBackup)
+            this.persist();
+    }
+    persist() {
+        writeFileSync(this.filePath, `${JSON.stringify(this.data, null, 2)}\n`, "utf-8");
+    }
+}
+function emptyData() {
+    return {
+        entities: {},
+        edges: {},
+        stateSlots: {},
+        events: {},
+    };
+}
+function cloneData(data) {
+    return JSON.parse(JSON.stringify(data));
+}
+function parseRecord(value, schema) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return {};
+    const result = {};
+    for (const [key, item] of Object.entries(value)) {
+        const parsed = schema.safeParse(item);
+        if (parsed.success)
+            result[key] = parsed.data;
+    }
+    return result;
+}
+//# sourceMappingURL=play-file-db.js.map

package/dist/play/play-file-db.js.map

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

package/dist/play/play-image.d.ts

@@ -0,0 +1,58 @@
+export interface PlayImageWorldContext {
+    readonly premise?: string;
+    readonly worldContract?: string;
+    readonly visualContract?: string;
+}
+type PlayImageWorldInput = string | PlayImageWorldContext | undefined;
+/**
+ * Build a style-consistent image prompt for a world entity. The world premise
+ * anchors era / setting / art style so every illustration in one run looks like
+ * it belongs to the same world.
+ */
+export declare function buildPlayEntityImagePrompt(entity: {
+    readonly type: string;
+    readonly label: string;
+    readonly summary?: string;
+}, worldPremise?: PlayImageWorldInput): string;
+/** Build a wide illustration prompt for the current moment from its scene prose. */
+export declare function buildPlaySceneImagePrompt(sceneText: string, worldPremise?: PlayImageWorldInput): string;
+export type PlayImageStatus = "ready" | "failed";
+export interface PlayImageEntry {
+    readonly status: PlayImageStatus;
+    readonly file?: string;
+    readonly error?: string;
+}
+export type PlayImageManifest = Record<string, PlayImageEntry>;
+export declare function readPlayImageManifest(runDir: string): Promise<PlayImageManifest>;
+export declare function writePlayImageManifest(runDir: string, manifest: PlayImageManifest): Promise<void>;
+/** Immutably set one manifest entry and persist it. Returns the new manifest. */
+export declare function setPlayImageEntry(runDir: string, key: string, entry: PlayImageEntry): Promise<PlayImageManifest>;
+/**
+ * Per-run auto-illustration toggles. Default all-off: nothing is generated
+ * until the user opts in (and the cover API is configured).
+ */
+export interface PlayImageSettings {
+    readonly actors: boolean;
+    readonly moments: boolean;
+    readonly inventory: boolean;
+}
+export declare const DEFAULT_PLAY_IMAGE_SETTINGS: PlayImageSettings;
+export declare function readPlayImageSettings(runDir: string): Promise<PlayImageSettings>;
+export declare function writePlayImageSettings(runDir: string, settings: PlayImageSettings): Promise<void>;
+/** Filesystem-safe leaf name derived from an entity id / scene key. */
+export declare function playImageFileName(key: string, extension: "png" | "jpg"): string;
+/**
+ * Generate one image for a Play key (entity id or scene key), write it under
+ * run/images/, and record the result in the manifest. Never throws on a
+ * generation failure — it records {status:"failed"} so the caller/UI can
+ * surface it and retry. Throws only if cover generation is not configured.
+ */
+export declare function generatePlayImage(input: {
+    readonly root: string;
+    readonly runDir: string;
+    readonly key: string;
+    readonly prompt: string;
+    readonly size?: string;
+}): Promise<PlayImageEntry>;
+export {};
+//# sourceMappingURL=play-image.d.ts.map

package/dist/play/play-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"play-image.d.ts","sourceRoot":"","sources":["../../src/play/play-image.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,KAAK,mBAAmB,GAAG,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;AAkBtE;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACpF,YAAY,CAAC,EAAE,mBAAmB,GACjC,MAAM,CAUR;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAOvG;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAM/D,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAQtF;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvG;AAED,iFAAiF;AACjF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,2BAA2B,EAAE,iBAIzC,CAAC;AAMF,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAWtF;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvG;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAG/E;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwB1B"}