@kienmatu/inkos-core 0.1.0

package/dist/play/play-image.js

@@ -0,0 +1,142 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { generateImageFromPrompt, resolveCoverGenerationRequest, } from "../pipeline/short-fiction-runner.js";
+/** Per-type task framing only; visual style must come from the world / visual contract. */
+const SHOT_BY_TYPE = {
+    actor: "为这个角色生成配图",
+    location: "为这个地点生成配图",
+    item: "为这件物品生成配图",
+    evidence: "为这件证物生成配图",
+    clue: "为这条线索生成配图",
+    claim: "为这个主张生成配图",
+    proof_chain: "为这条证据链生成配图",
+    organization: "为这个组织生成配图",
+};
+function clamp(text, max) {
+    const trimmed = text.trim();
+    return trimmed.length > max ? `${trimmed.slice(0, max)}…` : trimmed;
+}
+function renderImageWorldContext(input) {
+    if (!input)
+        return "";
+    if (typeof input === "string") {
+        const premise = input.trim();
+        return premise ? `世界设定（决定时代、场景与整体美术风格，必须贴合）：${clamp(premise, 600)}` : "";
+    }
+    const premise = input.premise?.trim();
+    const worldContract = input.worldContract?.trim();
+    const visualContract = input.visualContract?.trim();
+    return [
+        premise ? `世界设定（决定时代、场景与整体美术风格，必须贴合）：${clamp(premise, 600)}` : "",
+        worldContract ? `世界契约（只遵守用户定义的规则，不要自行发明 RPG/数值/等级系统）：${clamp(worldContract, 700)}` : "",
+        visualContract ? `视觉契约（图片必须按这条表达语义）：${clamp(visualContract, 700)}` : "",
+    ].filter(Boolean).join("\n");
+}
+/**
+ * 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 function buildPlayEntityImagePrompt(entity, worldPremise) {
+    const worldContext = renderImageWorldContext(worldPremise);
+    const subject = SHOT_BY_TYPE[entity.type] ?? "为这个对象生成配图";
+    const summary = entity.summary?.trim();
+    return [
+        worldContext,
+        subject,
+        `对象：${entity.label}`,
+        summary ? `细节：${clamp(summary, 400)}` : "",
+    ].filter(Boolean).join("\n");
+}
+/** Build a wide illustration prompt for the current moment from its scene prose. */
+export function buildPlaySceneImagePrompt(sceneText, worldPremise) {
+    const worldContext = renderImageWorldContext(worldPremise);
+    return [
+        worldContext,
+        "为下面这一刻生成配图，捕捉当下的动作、氛围与情绪：",
+        clamp(sceneText, 900),
+    ].filter(Boolean).join("\n");
+}
+function manifestPath(runDir) {
+    return join(runDir, "images", "manifest.json");
+}
+export async function readPlayImageManifest(runDir) {
+    try {
+        const raw = await readFile(manifestPath(runDir), "utf-8");
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+export async function writePlayImageManifest(runDir, manifest) {
+    await mkdir(join(runDir, "images"), { recursive: true });
+    await writeFile(manifestPath(runDir), JSON.stringify(manifest, null, 2), "utf-8");
+}
+/** Immutably set one manifest entry and persist it. Returns the new manifest. */
+export async function setPlayImageEntry(runDir, key, entry) {
+    const current = await readPlayImageManifest(runDir);
+    const next = { ...current, [key]: entry };
+    await writePlayImageManifest(runDir, next);
+    return next;
+}
+export const DEFAULT_PLAY_IMAGE_SETTINGS = {
+    actors: false,
+    moments: false,
+    inventory: false,
+};
+function settingsPath(runDir) {
+    return join(runDir, "images", "settings.json");
+}
+export async function readPlayImageSettings(runDir) {
+    try {
+        const raw = JSON.parse(await readFile(settingsPath(runDir), "utf-8"));
+        return {
+            actors: Boolean(raw?.actors),
+            moments: Boolean(raw?.moments),
+            inventory: Boolean(raw?.inventory),
+        };
+    }
+    catch {
+        return DEFAULT_PLAY_IMAGE_SETTINGS;
+    }
+}
+export async function writePlayImageSettings(runDir, settings) {
+    await mkdir(join(runDir, "images"), { recursive: true });
+    await writeFile(settingsPath(runDir), JSON.stringify(settings, null, 2), "utf-8");
+}
+/** Filesystem-safe leaf name derived from an entity id / scene key. */
+export function playImageFileName(key, extension) {
+    const safe = key.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 80) || "image";
+    return `${safe}.${extension}`;
+}
+/**
+ * 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 async function generatePlayImage(input) {
+    // Resolution failure (no cover API configured) is a real misconfiguration —
+    // let it surface so the endpoint can return a clear "configure first".
+    const request = await resolveCoverGenerationRequest({ root: input.root });
+    try {
+        const { buffer, extension } = await generateImageFromPrompt(request, input.prompt, input.size ?? "1024x1024");
+        const file = playImageFileName(input.key, extension);
+        await mkdir(join(input.runDir, "images"), { recursive: true });
+        await writeFile(join(input.runDir, "images", file), buffer);
+        const entry = { status: "ready", file };
+        await setPlayImageEntry(input.runDir, input.key, entry);
+        return entry;
+    }
+    catch (error) {
+        const entry = {
+            status: "failed",
+            error: error instanceof Error ? error.message : String(error),
+        };
+        await setPlayImageEntry(input.runDir, input.key, entry);
+        return entry;
+    }
+}
+//# sourceMappingURL=play-image.js.map

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

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

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

@@ -0,0 +1,31 @@
+import { type PlayEdgeInput, type PlayEntity, type PlayEntityInput, type PlayEvent, type PlayEventInput, type PlayMutationInput, type PlayStateSlot, type PlayStateSlotInput } from "../models/play.js";
+import type { PlayGraphSnapshot } from "./play-file-db.js";
+export interface PlayReducerDB {
+    readonly snapshot?: () => PlayGraphSnapshot;
+    readonly replaceWithSnapshot?: (snapshot: PlayGraphSnapshot) => void;
+    readonly transaction?: <T>(fn: () => T) => T;
+    readonly getEntity: (id: string) => PlayEntity | null;
+    readonly upsertEntity: (entity: PlayEntityInput) => void;
+    readonly upsertEdge: (edge: PlayEdgeInput) => void;
+    readonly expireEdge: (edgeId: string, validUntilEventId: string) => void;
+    readonly upsertStateSlot: (slot: PlayStateSlotInput) => void;
+    readonly getStateSlotsForEntity: (entityId: string) => PlayStateSlot[];
+    readonly recordEvent: (event: PlayEventInput) => void;
+}
+export interface ApplyPlayMutationInput {
+    readonly db: PlayReducerDB;
+    readonly mutation: PlayMutationInput;
+    readonly rawInput: string;
+    readonly createdAt?: string;
+}
+export interface ApplyPlayMutationResult {
+    readonly event: PlayEvent;
+    readonly blocked: boolean;
+}
+export declare function applyPlayMutation(input: ApplyPlayMutationInput): ApplyPlayMutationResult;
+export interface SeedPlayGraphInput {
+    readonly db: PlayReducerDB;
+    readonly mutation: PlayMutationInput;
+}
+export declare function seedPlayGraph(input: SeedPlayGraphInput): void;
+//# sourceMappingURL=play-reducer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"play-reducer.d.ts","sourceRoot":"","sources":["../../src/play/play-reducer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,cAAc,EAEnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,iBAAiB,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IACvE,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAgBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,uBAAuB,CAyBxF;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAQ7D"}

package/dist/play/play-reducer.js

@@ -0,0 +1,261 @@
+import { PlayEventSchema, PlayMutationSchema, } from "../models/play.js";
+const EVIDENCE_ORDER = [
+    "unknown",
+    "hinted",
+    "seen",
+    "collected",
+    "verified",
+    "weaponized",
+    "exposed",
+    "exhausted",
+];
+const PLAYER_ENTITY_ID = "actor_player";
+const LEGACY_PLAYER_ENTITY_IDS = new Set(["player"]);
+export function applyPlayMutation(input) {
+    const mutation = resolveEdgeEndpointLabels(input.db, canonicalizePlayerEntityIds(PlayMutationSchema.parse(input.mutation)));
+    const event = PlayEventSchema.parse({
+        id: mutation.eventId,
+        turn: mutation.turn,
+        actionKind: mutation.actionKind,
+        rawInput: input.rawInput,
+        outcomeSummary: mutation.summary || mutation.blockedReason,
+        timeAdvance: mutation.timeAdvance,
+        createdAt: input.createdAt ?? new Date().toISOString(),
+    });
+    validateMutation(input.db, mutation);
+    const apply = () => {
+        input.db.recordEvent(event);
+        if (!mutation.blocked) {
+            applyGraphChanges(input.db, mutation);
+        }
+        return { event, blocked: mutation.blocked };
+    };
+    return input.db.transaction ? input.db.transaction(apply) : apply();
+}
+export function seedPlayGraph(input) {
+    const mutation = resolveEdgeEndpointLabels(input.db, canonicalizePlayerEntityIds(PlayMutationSchema.parse(input.mutation)));
+    validateMutation(input.db, mutation);
+    const apply = () => {
+        if (!mutation.blocked)
+            applyGraphChanges(input.db, mutation);
+    };
+    if (input.db.transaction)
+        input.db.transaction(apply);
+    else
+        apply();
+}
+function canonicalizePlayerEntityIds(mutation) {
+    const canonicalize = (entityId) => LEGACY_PLAYER_ENTITY_IDS.has(entityId.trim()) ? PLAYER_ENTITY_ID : entityId;
+    return {
+        ...mutation,
+        entities: {
+            ...mutation.entities,
+            upsert: mutation.entities.upsert.map((entity) => ({
+                ...entity,
+                id: canonicalize(entity.id),
+            })),
+        },
+        edges: {
+            ...mutation.edges,
+            upsert: mutation.edges.upsert.map((edge) => ({
+                ...edge,
+                fromId: canonicalize(edge.fromId),
+                toId: canonicalize(edge.toId),
+            })),
+        },
+        stateSlots: {
+            ...mutation.stateSlots,
+            upsert: mutation.stateSlots.upsert.map((slot) => ({
+                ...slot,
+                ownerEntityId: slot.ownerEntityId ? canonicalize(slot.ownerEntityId) : slot.ownerEntityId,
+            })),
+        },
+    };
+}
+function resolveEdgeEndpointLabels(db, mutation) {
+    if (mutation.edges.upsert.length === 0) {
+        return mutation;
+    }
+    const labelToId = buildEntityAliasMap(db, mutation.entities.upsert);
+    if (labelToId.size === 0) {
+        return mutation;
+    }
+    const resolve = (value) => labelToId.get(value.trim()) ?? value;
+    return {
+        ...mutation,
+        edges: {
+            ...mutation.edges,
+            upsert: mutation.edges.upsert.map((edge) => ({
+                ...edge,
+                fromId: resolve(edge.fromId),
+                toId: resolve(edge.toId),
+            })),
+        },
+    };
+}
+function buildEntityAliasMap(db, turnEntities) {
+    const aliases = new Map();
+    const ambiguous = new Set();
+    const add = (alias, id) => {
+        const a = alias?.trim();
+        const entityId = id?.trim();
+        if (!a || !entityId)
+            return;
+        const existing = aliases.get(a);
+        if (existing && existing !== entityId) {
+            ambiguous.add(a);
+            aliases.delete(a);
+            return;
+        }
+        if (!ambiguous.has(a))
+            aliases.set(a, entityId);
+    };
+    for (const entity of readExistingEntities(db)) {
+        add(entity.id, entity.id);
+        add(entity.label, entity.id);
+    }
+    for (const entity of turnEntities) {
+        add(entity.id, entity.id);
+        add(entity.label, entity.id);
+    }
+    return aliases;
+}
+function readExistingEntities(db) {
+    try {
+        return db.snapshot?.().entities ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+function validateMutation(db, mutation) {
+    const upsertedEntityIds = new Set(mutation.entities.upsert.map((entity) => entity.id));
+    const entityExists = (entityId) => upsertedEntityIds.has(entityId) || db.getEntity(entityId) !== null;
+    // NB: relationship edges are validated fail-open at apply time (a dangling
+    // edge is skipped, not thrown) so one bad ref can't wipe the whole turn.
+    for (const slot of mutation.stateSlots.upsert) {
+        if (slot.ownerEntityId && !entityExists(slot.ownerEntityId)) {
+            throw new Error(`Play mutation references missing entity in state slot ${slot.id}: ${slot.ownerEntityId}`);
+        }
+    }
+    for (const transition of mutation.evidence.transitions) {
+        const entity = upsertedEntityIds.has(transition.entityId)
+            ? mutation.entities.upsert.find((candidate) => candidate.id === transition.entityId)
+            : db.getEntity(transition.entityId);
+        if (!entity) {
+            throw new Error(`Play mutation references missing entity in evidence transition: ${transition.entityId}`);
+        }
+        if (entity.type !== "evidence" && entity.type !== "clue") {
+            throw new Error(`Play evidence transition requires evidence or clue entity: ${transition.entityId}`);
+        }
+        const current = currentEvidenceStatus(db, transition.entityId);
+        if (transition.from && transition.from !== current) {
+            throw new Error(`Play evidence transition expected ${transition.from} but current status is ${current}`);
+        }
+        if (evidenceRank(transition.to) < evidenceRank(current)) {
+            throw new Error(`Play evidence transition cannot regress from ${current} to ${transition.to}`);
+        }
+    }
+}
+function applyGraphChanges(db, mutation) {
+    for (const entity of mutation.entities.upsert) {
+        db.upsertEntity(entity);
+    }
+    for (const edge of mutation.edges.expire) {
+        db.expireEdge(edge.edgeId, edge.validUntilEventId);
+    }
+    // Relationship edges are fail-open: a single edge that points at an entity
+    // we never saw is skipped, not allowed to crash the whole turn (which used
+    // to wipe an entire turn's mutations and leave the relationship panel empty).
+    const upsertedEntityIds = new Set(mutation.entities.upsert.map((e) => e.id));
+    const endpointExists = (id) => upsertedEntityIds.has(id) || db.getEntity(id) !== null;
+    const findEntity = (id) => mutation.entities.upsert.find((entity) => entity.id === id) ?? db.getEntity(id);
+    for (const edge of mutation.edges.upsert) {
+        if (endpointExists(edge.fromId) && endpointExists(edge.toId)) {
+            db.upsertEdge(normalizeHoldingEdge(edge, findEntity(edge.toId)));
+        }
+    }
+    for (const slot of mutation.stateSlots.upsert) {
+        db.upsertStateSlot(normalizeStateSlot(slot));
+    }
+    for (const transition of mutation.evidence.transitions) {
+        db.upsertStateSlot({
+            id: evidenceStatusSlotId(transition.entityId),
+            ownerEntityId: transition.entityId,
+            kind: "evidence",
+            label: "证据状态",
+            value: {
+                previous: currentEvidenceStatus(db, transition.entityId),
+                status: transition.to,
+                reason: transition.reason,
+            },
+            updatedEventId: mutation.eventId,
+        });
+    }
+}
+function normalizeHoldingEdge(edge, target) {
+    if (!isRecord(edge.value) || edge.value.role !== "holding")
+        return edge;
+    if (isPhysicalHoldingTarget(target, edge.value))
+        return edge;
+    return {
+        ...edge,
+        value: {
+            ...edge.value,
+            role: "observed",
+        },
+    };
+}
+function isPhysicalHoldingTarget(target, value) {
+    if (!target)
+        return false;
+    if (target.type === "item")
+        return true;
+    if (value.physical === true || value.portable === true) {
+        return target.type === "evidence" || target.type === "clue" || target.type === "claim" || target.type === "proof_chain";
+    }
+    return false;
+}
+function normalizeStateSlot(slot) {
+    if (!isRecord(slot.value))
+        return slot;
+    const current = slot.value.current;
+    const min = slot.value.min;
+    const max = slot.value.max;
+    if (typeof current !== "number")
+        return slot;
+    let next = current;
+    if (typeof min === "number")
+        next = Math.max(min, next);
+    if (typeof max === "number")
+        next = Math.min(max, next);
+    if (next === current)
+        return slot;
+    return {
+        ...slot,
+        value: {
+            ...slot.value,
+            current: next,
+        },
+    };
+}
+function currentEvidenceStatus(db, entityId) {
+    const slot = db.getStateSlotsForEntity(entityId)
+        .find((candidate) => candidate.id === evidenceStatusSlotId(entityId) || candidate.kind === "evidence");
+    if (!slot || !isRecord(slot.value))
+        return "unknown";
+    const status = slot.value.status;
+    return typeof status === "string" && EVIDENCE_ORDER.includes(status)
+        ? status
+        : "unknown";
+}
+function evidenceStatusSlotId(entityId) {
+    return `evidence:${entityId}:status`;
+}
+function evidenceRank(status) {
+    return EVIDENCE_ORDER.indexOf(status);
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=play-reducer.js.map

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

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

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

@@ -0,0 +1,116 @@
+import type { AgentContext } from "../agents/base.js";
+import { type PlayActionIntent, type PlayActionIntentInput, type PlayMutation, type PlayMutationInput } from "../models/play.js";
+import { type PlaySceneRender } from "./play-agents.js";
+import { type PlayReducerDB } from "./play-reducer.js";
+import { PlayStore } from "./play-store.js";
+export interface PlayActionInterpreterLike {
+    readonly interpret: (input: {
+        readonly input: string;
+        readonly sceneBrief: string;
+        readonly language?: "zh" | "en";
+    }) => Promise<PlayActionIntentInput>;
+}
+export interface PlayWorldMutatorLike {
+    readonly proposeMutation: (input: {
+        readonly turn: number;
+        readonly input: string;
+        readonly action: PlayActionIntentInput;
+        readonly context: string;
+        readonly language?: "zh" | "en";
+    }) => Promise<PlayMutationInput>;
+}
+export interface PlaySceneRendererLike {
+    readonly render: (input: {
+        readonly input: string;
+        readonly action: PlayActionIntentInput;
+        readonly context?: string;
+        readonly mutationSummary: string;
+        readonly stateBrief: string;
+        readonly replayContext?: string;
+        readonly mode?: "open" | "guided";
+        readonly language?: "zh" | "en";
+        readonly worldPremise?: string;
+    }) => Promise<PlaySceneRender>;
+}
+export interface PlaySceneReconcilerLike {
+    readonly reconcile: (input: {
+        readonly turn: number;
+        readonly input: string;
+        readonly action: PlayActionIntentInput;
+        readonly mutation: PlayMutationInput;
+        readonly sceneText: string;
+        readonly context: string;
+        readonly stateBrief: string;
+        readonly language?: "zh" | "en";
+        readonly worldPremise?: string;
+    }) => Promise<PlayMutationInput>;
+}
+export interface PlayRunnerOptions {
+    readonly projectRoot: string;
+    readonly worldId: string;
+    readonly runId: string;
+    readonly ctx?: AgentContext;
+    readonly store?: PlayStore;
+    readonly db?: PlayReducerDB;
+    readonly agents?: {
+        readonly actionInterpreter?: PlayActionInterpreterLike;
+        readonly worldMutator?: PlayWorldMutatorLike;
+        readonly sceneRenderer?: PlaySceneRendererLike;
+        readonly sceneReconciler?: PlaySceneReconcilerLike;
+    };
+}
+export interface PlayStepResult extends PlaySceneRender {
+    readonly action: PlayActionIntent;
+    readonly mutation: PlayMutation;
+}
+export interface PlayReplayResult extends PlayStepResult {
+    readonly previousVariantId?: string;
+    readonly variantId?: string;
+    readonly replayedInput: string;
+}
+export interface PlayVariantRestoreResult {
+    readonly turn: number;
+    readonly variantId: string;
+    readonly sceneText: string;
+}
+export interface PlayOpeningSeedResult {
+    readonly mutation: PlayMutation;
+}
+export declare class PlayOpeningSeedError extends Error {
+    constructor(message: string);
+}
+export declare class PlayRunner {
+    private readonly options;
+    private readonly store;
+    private readonly db;
+    private readonly ownsDb;
+    private dbClosed;
+    private readonly actionInterpreter;
+    private readonly worldMutator;
+    private readonly sceneRenderer;
+    private readonly sceneReconciler;
+    constructor(options: PlayRunnerOptions);
+    /**
+     * 关闭 runner 自己创建的数据库连接（外部传入的 db 由调用方负责关闭）。
+     * SQLite 文件句柄不关闭时 Windows 上无法删除 play.db；node:sqlite 的
+     * close 不允许二次调用，所以这里做幂等保护。
+     */
+    close(): void;
+    seedOpening(input: {
+        readonly sceneText: string;
+        readonly suggestedActions?: readonly string[];
+    }): Promise<PlayOpeningSeedResult | null>;
+    step(input: string, options?: {
+        readonly replayContext?: string;
+    }): Promise<PlayStepResult>;
+    private executeStep;
+    private writeRunStatus;
+    regenerateLastTurn(input?: string): Promise<PlayReplayResult>;
+    restoreVariant(input: {
+        readonly turn: number;
+        readonly variantId: string;
+    }): Promise<PlayVariantRestoreResult>;
+    private buildContextBrief;
+    private readOptionalProjection;
+}
+//# sourceMappingURL=play-runner.d.ts.map

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

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