@kienmatu/inkos-core 0.1.0

package/dist/interaction/session.d.ts.map

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

package/dist/interaction/session.js

@@ -0,0 +1,194 @@
+import { z } from "zod";
+import { AutomationModeSchema } from "./modes.js";
+import { ExecutionStateSchema, InteractionEventSchema } from "./events.js";
+import { assertSafeBookId, isSafeBookId } from "../utils/book-id.js";
+export const SessionKindSchema = z.enum(["chat", "book-create", "book", "short", "play", "script", "storyboard", "interactive-film", "edit", "interactive-film-authoring"]);
+export const PlayModeSchema = z.enum(["open", "guided"]);
+export const PendingDecisionSchema = z.object({
+    kind: z.string().min(1),
+    bookId: z.string().min(1),
+    chapterNumber: z.number().int().min(1).optional(),
+    summary: z.string().min(1),
+});
+// TUI confirmations persist the already-validated action envelope returned by
+// propose_action. The action and payload are revalidated against the current
+// action schemas when the user confirms, so older sessions remain loadable as
+// the production action catalog evolves.
+export const PendingProposedActionSchema = z.object({
+    action: z.string().min(1),
+    targetSessionKind: SessionKindSchema,
+    instruction: z.string().min(1),
+    title: z.string().min(1).optional(),
+    summary: z.string().min(1).optional(),
+    playMode: PlayModeSchema.optional(),
+    requestedSkills: z.array(z.string().min(1)).optional(),
+    actionPayload: z.record(z.unknown()).optional(),
+});
+export const PipelineStageSchema = z.object({
+    label: z.string(),
+    status: z.enum(["pending", "active", "completed"]),
+});
+export const ToolExecutionSchema = z.object({
+    id: z.string(),
+    tool: z.string(),
+    agent: z.string().optional(),
+    label: z.string(),
+    status: z.enum(["running", "processing", "completed", "error"]),
+    args: z.record(z.unknown()).optional(),
+    result: z.string().optional(),
+    details: z.unknown().optional(),
+    error: z.string().optional(),
+    stages: z.array(PipelineStageSchema).optional(),
+    startedAt: z.number(),
+    completedAt: z.number().optional(),
+});
+export const InteractionMessageSchema = z.object({
+    role: z.enum(["user", "assistant", "system"]),
+    // Assistant turns may be tool-only. In that case the user-facing content is
+    // rendered from toolExecutions, not from free text.
+    content: z.string(),
+    thinking: z.string().optional(),
+    toolExecutions: z.array(ToolExecutionSchema).optional(),
+    timestamp: z.number().int().nonnegative(),
+});
+export const BookCreationDraftSchema = z.object({
+    concept: z.string().min(1),
+    title: z.string().min(1).optional(),
+    genre: z.string().min(1).optional(),
+    platform: z.string().min(1).optional(),
+    language: z.enum(["zh", "en"]).optional(),
+    targetChapters: z.number().int().min(1).optional(),
+    chapterWordCount: z.number().int().min(1).optional(),
+    blurb: z.string().min(1).optional(),
+    worldPremise: z.string().min(1).optional(),
+    settingNotes: z.string().min(1).optional(),
+    protagonist: z.string().min(1).optional(),
+    supportingCast: z.string().min(1).optional(),
+    conflictCore: z.string().min(1).optional(),
+    volumeOutline: z.string().min(1).optional(),
+    constraints: z.string().min(1).optional(),
+    authorIntent: z.string().min(1).optional(),
+    currentFocus: z.string().min(1).optional(),
+    nextQuestion: z.string().min(1).optional(),
+    missingFields: z.array(z.string().min(1)).default([]),
+    readyToCreate: z.boolean().default(false),
+});
+export const DraftRoundSchema = z.object({
+    roundId: z.number().int().min(1),
+    userMessage: z.string(),
+    assistantRaw: z.string(),
+    fieldsUpdated: z.array(z.string()).default([]),
+    summary: z.string().default(""),
+    timestamp: z.number().int().nonnegative(),
+});
+export const InteractionSessionSchema = z.object({
+    sessionId: z.string().min(1),
+    projectRoot: z.string().min(1),
+    sessionKind: SessionKindSchema.optional(),
+    playMode: PlayModeSchema.optional(),
+    modelOverride: z.string().min(1).optional(),
+    activeBookId: z.string().min(1).optional(),
+    activeChapterNumber: z.number().int().min(1).optional(),
+    creationDraft: BookCreationDraftSchema.optional(),
+    draftRounds: z.array(DraftRoundSchema).default([]),
+    automationMode: AutomationModeSchema.default("semi"),
+    messages: z.array(InteractionMessageSchema).default([]),
+    events: z.array(InteractionEventSchema).default([]),
+    pendingDecision: PendingDecisionSchema.optional(),
+    pendingProposedAction: PendingProposedActionSchema.optional(),
+    currentExecution: ExecutionStateSchema.optional(),
+});
+// -- Per-book session --
+export const BookSessionSchema = z.object({
+    sessionId: z.string().min(1),
+    bookId: z.string().refine(isSafeBookId, "Invalid bookId").nullable(),
+    sessionKind: SessionKindSchema.optional(),
+    playMode: PlayModeSchema.optional(),
+    title: z.string().nullable().default(null),
+    messages: z.array(InteractionMessageSchema).default([]),
+    creationDraft: BookCreationDraftSchema.optional(),
+    draftRounds: z.array(DraftRoundSchema).default([]),
+    events: z.array(InteractionEventSchema).default([]),
+    currentExecution: ExecutionStateSchema.optional(),
+    createdAt: z.number().int().nonnegative(),
+    updatedAt: z.number().int().nonnegative(),
+});
+// -- Global session (simplified) --
+export const GlobalSessionSchema = z.object({
+    activeBookId: z.string().refine(isSafeBookId, "Invalid activeBookId").optional(),
+    automationMode: AutomationModeSchema.default("semi"),
+});
+export function createBookSession(bookId, sessionId, sessionKind, options) {
+    const now = Date.now();
+    const safeBookId = bookId === null ? null : assertSafeBookId(bookId);
+    return {
+        sessionId: sessionId ?? `${now}-${Math.random().toString(36).slice(2, 8)}`,
+        bookId: safeBookId,
+        sessionKind,
+        ...(options?.playMode ? { playMode: options.playMode } : {}),
+        title: null,
+        messages: [],
+        draftRounds: [],
+        events: [],
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function appendBookSessionMessage(session, message) {
+    return {
+        ...session,
+        messages: [...session.messages, message].sort((a, b) => a.timestamp - b.timestamp),
+        updatedAt: Date.now(),
+    };
+}
+export function bindActiveBook(session, bookId, chapterNumber) {
+    return {
+        ...session,
+        activeBookId: bookId,
+        ...(chapterNumber !== undefined ? { activeChapterNumber: chapterNumber } : {}),
+    };
+}
+export function clearPendingDecision(session) {
+    if (!session.pendingDecision) {
+        return session;
+    }
+    return {
+        ...session,
+        pendingDecision: undefined,
+    };
+}
+export function updateCreationDraft(session, draft) {
+    return {
+        ...session,
+        creationDraft: draft,
+    };
+}
+export function clearCreationDraft(session) {
+    if (!session.creationDraft) {
+        return session;
+    }
+    return {
+        ...session,
+        creationDraft: undefined,
+        draftRounds: [],
+    };
+}
+export function updateAutomationMode(session, automationMode) {
+    return {
+        ...session,
+        automationMode,
+    };
+}
+export function appendInteractionMessage(session, message) {
+    return {
+        ...session,
+        messages: [...session.messages, message].sort((left, right) => left.timestamp - right.timestamp),
+    };
+}
+export function appendInteractionEvent(session, event) {
+    return {
+        ...session,
+        events: [...session.events, event],
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/interaction/session.js.map

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

package/dist/interaction/truth-authority.d.ts

@@ -0,0 +1,4 @@
+export type TruthAuthority = "direction" | "foundation" | "rules" | "runtime-truth" | "memory";
+export declare function normalizeTruthFileName(fileName: string): string;
+export declare function classifyTruthAuthority(fileName: string): TruthAuthority;
+//# sourceMappingURL=truth-authority.d.ts.map

package/dist/interaction/truth-authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truth-authority.d.ts","sourceRoot":"","sources":["../../src/interaction/truth-authority.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,YAAY,GACZ,OAAO,GACP,eAAe,GACf,QAAQ,CAAC;AAab,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAiBvE"}

package/dist/interaction/truth-authority.js

@@ -0,0 +1,37 @@
+const NORMALIZED_TRUTH_FILES = new Set([
+    "author_intent.md",
+    "current_focus.md",
+    "story_bible.md",
+    "volume_outline.md",
+    "book_rules.md",
+    "current_state.md",
+    "pending_hooks.md",
+    "chapter_summaries.md",
+]);
+export function normalizeTruthFileName(fileName) {
+    const trimmed = fileName.trim().toLowerCase();
+    const normalized = trimmed.endsWith(".md") ? trimmed : `${trimmed}.md`;
+    if (!NORMALIZED_TRUTH_FILES.has(normalized)) {
+        return normalized;
+    }
+    return normalized;
+}
+export function classifyTruthAuthority(fileName) {
+    switch (normalizeTruthFileName(fileName)) {
+        case "author_intent.md":
+        case "current_focus.md":
+            return "direction";
+        case "story_bible.md":
+        case "volume_outline.md":
+            return "foundation";
+        case "book_rules.md":
+            return "rules";
+        case "current_state.md":
+        case "pending_hooks.md":
+            return "runtime-truth";
+        case "chapter_summaries.md":
+        default:
+            return "memory";
+    }
+}
+//# sourceMappingURL=truth-authority.js.map

package/dist/interaction/truth-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truth-authority.js","sourceRoot":"","sources":["../../src/interaction/truth-authority.ts"],"names":[],"mappings":"AAOA,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,kBAAkB;IAClB,kBAAkB;IAClB,gBAAgB;IAChB,mBAAmB;IACnB,eAAe;IACf,kBAAkB;IAClB,kBAAkB;IAClB,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC;IACvE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,QAAQ,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB;YACrB,OAAO,WAAW,CAAC;QACrB,KAAK,gBAAgB,CAAC;QACtB,KAAK,mBAAmB;YACtB,OAAO,YAAY,CAAC;QACtB,KAAK,eAAe;YAClB,OAAO,OAAO,CAAC;QACjB,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB;YACrB,OAAO,eAAe,CAAC;QACzB,KAAK,sBAAsB,CAAC;QAC5B;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/interactive-film/authoring-store.d.ts

@@ -0,0 +1,35 @@
+import { type StoryGraph } from "./graph-schema.js";
+import { type StoryGraphDelta } from "./delta.js";
+export interface AuthoringState {
+    readonly phase: "world" | "scale" | "structure" | "workshop";
+    readonly rev: number;
+    readonly phaseRevs?: Record<string, number>;
+}
+export declare function authoringStatePath(projectRoot: string, projectId: string): string;
+export declare function loadAuthoringState(projectRoot: string, projectId: string): Promise<AuthoringState>;
+/**
+ * Applies a delta to the project's story graph and advances the authoring rev.
+ *
+ * The returned graph shares element references with the input; callers must
+ * treat it as immutable — do not mutate nodes/arrays in place.
+ *
+ * Concurrent calls for the same project are serialized via a per-project async
+ * mutex, preventing lost-update races (two callers both reading rev=N and both
+ * writing rev=N+1).
+ */
+export declare function applyGraphDelta(params: {
+    projectRoot: string;
+    projectId: string;
+    delta: StoryGraphDelta;
+    phase?: AuthoringState["phase"];
+}): Promise<{
+    graph: StoryGraph;
+    rev: number;
+}>;
+export declare function revertToSnapshot(params: {
+    projectRoot: string;
+    projectId: string;
+    rev: number;
+}): Promise<StoryGraph>;
+export declare function recordPhaseVisit(projectRoot: string, projectId: string, phase: string): Promise<void>;
+//# sourceMappingURL=authoring-store.d.ts.map

package/dist/interactive-film/authoring-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-store.d.ts","sourceRoot":"","sources":["../../src/interactive-film/authoring-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAqBxE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAQD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAkBzB;AAuBD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAuB9C;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,UAAU,CAAC,CAMtB;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/interactive-film/authoring-store.js

@@ -0,0 +1,114 @@
+import { readFile, writeFile, mkdir, readdir, rm } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { StoryGraphSchema } from "./graph-schema.js";
+import { applyStoryGraphDelta } from "./delta.js";
+import { loadStoryGraph, saveStoryGraph, storyGraphPath } from "./graph-store.js";
+const SNAPSHOT_KEEP = 20;
+// Per-project async mutex: concurrent applyGraphDelta calls to the same project
+// run strictly one-at-a-time so no rev or update is silently lost.
+const projectLocks = new Map();
+async function withProjectLock(key, fn) {
+    const prev = projectLocks.get(key) ?? Promise.resolve();
+    let release;
+    const gate = new Promise((r) => { release = r; });
+    projectLocks.set(key, prev.then(() => gate));
+    await prev.catch(() => { }); // wait for predecessor; ignore its error for ordering
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+    }
+}
+const DEFAULT_STATE = { phase: "world", rev: 0 };
+function projectDir(projectRoot, projectId) {
+    return dirname(storyGraphPath(projectRoot, projectId));
+}
+export function authoringStatePath(projectRoot, projectId) {
+    return join(projectDir(projectRoot, projectId), "authoring-state.json");
+}
+export async function loadAuthoringState(projectRoot, projectId) {
+    try {
+        const raw = await readFile(authoringStatePath(projectRoot, projectId), "utf-8");
+        const parsed = JSON.parse(raw);
+        const validPhases = new Set(["world", "scale", "structure", "workshop"]);
+        const phase = typeof parsed.phase === "string" && validPhases.has(parsed.phase)
+            ? parsed.phase
+            : DEFAULT_STATE.phase;
+        return {
+            phase,
+            rev: typeof parsed.rev === "number" ? parsed.rev : DEFAULT_STATE.rev,
+            ...(parsed.phaseRevs !== undefined && { phaseRevs: parsed.phaseRevs }),
+        };
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return DEFAULT_STATE;
+        throw error;
+    }
+}
+function emptyGraph(projectId) {
+    return StoryGraphSchema.parse({
+        schemaVersion: 1, projectId, title: "", variables: [], nodes: [], endings: [], characters: [],
+    });
+}
+function snapshotDir(projectRoot, projectId) {
+    return join(projectDir(projectRoot, projectId), "snapshots");
+}
+async function writeSnapshot(projectRoot, projectId, rev, graph) {
+    const dir = snapshotDir(projectRoot, projectId);
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, `${rev}.json`), JSON.stringify(graph, null, 2), "utf-8");
+    const files = (await readdir(dir)).filter((f) => f.endsWith(".json"));
+    const revs = files.map((f) => Number(f.replace(".json", ""))).filter((n) => !Number.isNaN(n)).sort((a, b) => a - b);
+    for (const old of revs.slice(0, Math.max(0, revs.length - SNAPSHOT_KEEP))) {
+        await rm(join(dir, `${old}.json`), { force: true });
+    }
+}
+/**
+ * Applies a delta to the project's story graph and advances the authoring rev.
+ *
+ * The returned graph shares element references with the input; callers must
+ * treat it as immutable — do not mutate nodes/arrays in place.
+ *
+ * Concurrent calls for the same project are serialized via a per-project async
+ * mutex, preventing lost-update races (two callers both reading rev=N and both
+ * writing rev=N+1).
+ */
+export async function applyGraphDelta(params) {
+    const lockKey = `${params.projectRoot}::${params.projectId}`;
+    return withProjectLock(lockKey, async () => {
+        const current = (await loadStoryGraph(params.projectRoot, params.projectId)) ?? emptyGraph(params.projectId);
+        const state = await loadAuthoringState(params.projectRoot, params.projectId);
+        // Snapshot the pre-apply graph under the current rev so revert(rev) restores it.
+        // Note: no snapshot is written for the latest rev — the live graph file IS the latest rev.
+        await writeSnapshot(params.projectRoot, params.projectId, state.rev, current);
+        const graph = applyStoryGraphDelta({ graph: current, delta: params.delta });
+        await saveStoryGraph(params.projectRoot, params.projectId, graph);
+        const nextRev = state.rev + 1;
+        const nextState = { phase: params.phase ?? state.phase, rev: nextRev, phaseRevs: state.phaseRevs };
+        await mkdir(projectDir(params.projectRoot, params.projectId), { recursive: true });
+        await writeFile(authoringStatePath(params.projectRoot, params.projectId), JSON.stringify(nextState, null, 2), "utf-8");
+        return { graph, rev: nextRev };
+    });
+}
+export async function revertToSnapshot(params) {
+    const file = join(snapshotDir(params.projectRoot, params.projectId), `${params.rev}.json`);
+    const raw = await readFile(file, "utf-8");
+    const graph = StoryGraphSchema.parse(JSON.parse(raw));
+    await saveStoryGraph(params.projectRoot, params.projectId, graph);
+    return graph;
+}
+export async function recordPhaseVisit(projectRoot, projectId, phase) {
+    const lockKey = `${projectRoot}::${projectId}`;
+    return withProjectLock(lockKey, async () => {
+        const state = await loadAuthoringState(projectRoot, projectId);
+        const next = {
+            ...state,
+            phaseRevs: { ...(state.phaseRevs ?? {}), [phase]: state.rev },
+        };
+        await mkdir(projectDir(projectRoot, projectId), { recursive: true });
+        await writeFile(authoringStatePath(projectRoot, projectId), JSON.stringify(next, null, 2), "utf-8");
+    });
+}
+//# sourceMappingURL=authoring-store.js.map

package/dist/interactive-film/authoring-store.js.map

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

package/dist/interactive-film/authoring-tools.d.ts

@@ -0,0 +1,9 @@
+import type { StoryGraphDelta } from "./delta.js";
+import type { WorldAnchor, Variable, Ending, StoryNode, Character } from "./graph-schema.js";
+export declare function buildWorldAnchorDelta(patch: Partial<WorldAnchor>): StoryGraphDelta;
+export declare function buildAddVariableDelta(v: Variable): StoryGraphDelta;
+export declare function buildDefineEndingDelta(e: Ending): StoryGraphDelta;
+export declare function buildRemoveNodeDelta(nodeId: string): StoryGraphDelta;
+export declare function buildConnectChoiceDelta(node: StoryNode): StoryGraphDelta;
+export declare function buildUpsertCharactersDelta(chars: Character[]): StoryGraphDelta;
+//# sourceMappingURL=authoring-tools.d.ts.map

package/dist/interactive-film/authoring-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-tools.d.ts","sourceRoot":"","sources":["../../src/interactive-film/authoring-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE7F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,eAAe,CAElF;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,QAAQ,GAAG,eAAe,CAElE;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAEpE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,CAExE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,eAAe,CAE9E"}

package/dist/interactive-film/authoring-tools.js

@@ -0,0 +1,19 @@
+export function buildWorldAnchorDelta(patch) {
+    return { worldAnchor: patch, notes: [] };
+}
+export function buildAddVariableDelta(v) {
+    return { variables: { upsert: [v], remove: [] }, notes: [] };
+}
+export function buildDefineEndingDelta(e) {
+    return { endings: { upsert: [e], remove: [] }, notes: [] };
+}
+export function buildRemoveNodeDelta(nodeId) {
+    return { nodes: { upsert: [], remove: [nodeId] }, notes: [] };
+}
+export function buildConnectChoiceDelta(node) {
+    return { nodes: { upsert: [node], remove: [] }, notes: [] };
+}
+export function buildUpsertCharactersDelta(chars) {
+    return { characters: { upsert: chars, remove: [] }, notes: [] };
+}
+//# sourceMappingURL=authoring-tools.js.map

package/dist/interactive-film/authoring-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-tools.js","sourceRoot":"","sources":["../../src/interactive-film/authoring-tools.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,qBAAqB,CAAC,KAA2B;IAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAAW;IAC/C,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,CAAS;IAC9C,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAe;IACrD,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAkB;IAC3D,OAAO,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAClE,CAAC"}