@mulmoclaude/mulmoscript-plugin 0.1.0 → 0.2.0

package/dist/contract-DxKVCRQk.cjs

@@ -0,0 +1,13 @@
+//#region src/core/contract.ts
+/** Plugin pubsub event name the host publishes generation events on
+*  (full channel: `plugin:<scope>:generation`). */
+var GENERATION_EVENT = "generation";
+//#endregion
+Object.defineProperty(exports, "GENERATION_EVENT", {
+	enumerable: true,
+	get: function() {
+		return GENERATION_EVENT;
+	}
+});
+
+//# sourceMappingURL=contract-DxKVCRQk.cjs.map

package/dist/contract-DxKVCRQk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-DxKVCRQk.cjs","names":[],"sources":["../src/core/contract.ts"],"sourcesContent":["// Host-agnostic dispatch envelope for the presentMulmoScript View. The Vue\n// View is decoupled from any one host's REST surface: it calls\n// `useRuntime().dispatch({ kind, … })`, the host routes that to its\n// mulmoScript dispatch handler, and every response is an `{ ok: … }`\n// envelope so failures travel as data (no HTTP-status coupling, no\n// \"dispatch failed (500)\" prefixes in user-facing errors).\n//\n// Long-running generation (movie / PDF) is a single long-held dispatch that\n// resolves when the pipeline finishes; per-beat progress arrives on the\n// plugin pubsub channel (`GENERATION_EVENT`) instead of an SSE stream, which\n// also covers generations started elsewhere (background autoGenerateMovie,\n// another tab, the agent).\n\n/** One in-flight or per-beat generation notice, published on the plugin\n *  pubsub `generation` channel and returned by the `pendingGenerations`\n *  snapshot. Value strings mirror @mulmobridge/protocol's GENERATION_KINDS\n *  so MulmoClaude's host bridge maps 1:1 without a lookup table. */\nexport interface MulmoScriptGenerationEvent {\n  kind: \"beatImage\" | \"beatAudio\" | \"characterImage\" | \"movie\" | \"pdf\";\n  /** Wire `stories/…` path of the script the generation belongs to. */\n  filePath: string;\n  /** beatIndex (as string) for beat*, character key for characterImage, \"\" for movie/pdf. */\n  key: string;\n  /** false = started, true = finished (reload the asset off disk). */\n  done: boolean;\n  /** Only set on done=true when the work failed. */\n  error?: string;\n}\n\n/** Plugin pubsub event name the host publishes generation events on\n *  (full channel: `plugin:<scope>:generation`). */\nexport const GENERATION_EVENT = \"generation\";\n\ninterface BeatRef {\n  filePath: string;\n  beatIndex: number;\n}\n\ninterface CharacterRef {\n  filePath: string;\n  key: string;\n}\n\n/** Session tag for hosts that surface per-session generation indicators\n *  (MulmoClaude's sidebar). Optional everywhere; hosts without sessions\n *  ignore it. */\ninterface SessionTag {\n  chatSessionId?: string;\n}\n\nexport type MulmoScriptDispatchArgs =\n  | ({ kind: \"save\" } & { filePath?: string; script?: unknown; filename?: string })\n  | { kind: \"updateBeat\"; filePath: string; beatIndex: number; beat: unknown }\n  | { kind: \"updateScript\"; filePath: string; script: unknown }\n  | ({ kind: \"beatImage\" } & BeatRef)\n  | ({ kind: \"beatAudio\" } & BeatRef)\n  | ({ kind: \"beatMovie\" } & BeatRef)\n  | ({ kind: \"renderBeat\" } & BeatRef & SessionTag & { force?: boolean })\n  | ({ kind: \"generateBeatAudio\" } & BeatRef & SessionTag & { force?: boolean })\n  | ({ kind: \"uploadBeatImage\" } & BeatRef & { imageData: string })\n  | ({ kind: \"characterImage\" } & CharacterRef)\n  | ({ kind: \"renderCharacter\" } & CharacterRef & SessionTag & { force?: boolean })\n  | ({ kind: \"uploadCharacterImage\" } & CharacterRef & { imageData: string })\n  | ({ kind: \"movieStatus\" } & { filePath: string })\n  | ({ kind: \"pdfStatus\" } & { filePath: string })\n  | ({ kind: \"generateMovie\" } & { filePath: string } & SessionTag)\n  | ({ kind: \"generatePdf\" } & { filePath: string } & SessionTag)\n  | { kind: \"pendingGenerations\"; filePath: string };\n\nexport type MulmoScriptDispatchKind = MulmoScriptDispatchArgs[\"kind\"];\n\n/** Failure half of every dispatch response. `code` mirrors the phase-1\n *  outcome codes so a host can log/telemetry on it; the View only reads\n *  `error`. */\nexport interface DispatchFailure {\n  ok: false;\n  code?: \"bad_request\" | \"not_found\" | \"server_error\";\n  error: string;\n}\n\nexport type DispatchEnvelope<T> = ({ ok: true } & T) | DispatchFailure;\n\n/** Maps a dispatch `kind` to its success payload so the View's transport\n *  can call `dispatch` without casts at every site. */\nexport interface MulmoScriptDispatchResult {\n  save: { script: Record<string, unknown>; filePath: string; message: string };\n  updateBeat: Record<string, never>;\n  updateScript: Record<string, never>;\n  beatImage: { image: string | null };\n  beatAudio: { audio: string | null };\n  beatMovie: { moviePath: string | null };\n  renderBeat: { image: string };\n  generateBeatAudio: { audio: string };\n  uploadBeatImage: { image: string };\n  characterImage: { image: string | null };\n  renderCharacter: { image: string };\n  uploadCharacterImage: { image: string };\n  movieStatus: { moviePath: string | null };\n  pdfStatus: { pdfPath: string | null };\n  generateMovie: { moviePath: string };\n  generatePdf: { pdfPath: string };\n  pendingGenerations: { pending: MulmoScriptGenerationEvent[] };\n}\n"],"mappings":";;;AA+BA,IAAa,mBAAmB"}

package/dist/contract-vY0niHkh.js

@@ -0,0 +1,8 @@
+//#region src/core/contract.ts
+/** Plugin pubsub event name the host publishes generation events on
+*  (full channel: `plugin:<scope>:generation`). */
+var GENERATION_EVENT = "generation";
+//#endregion
+export { GENERATION_EVENT as t };
+
+//# sourceMappingURL=contract-vY0niHkh.js.map

package/dist/contract-vY0niHkh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-vY0niHkh.js","names":[],"sources":["../src/core/contract.ts"],"sourcesContent":["// Host-agnostic dispatch envelope for the presentMulmoScript View. The Vue\n// View is decoupled from any one host's REST surface: it calls\n// `useRuntime().dispatch({ kind, … })`, the host routes that to its\n// mulmoScript dispatch handler, and every response is an `{ ok: … }`\n// envelope so failures travel as data (no HTTP-status coupling, no\n// \"dispatch failed (500)\" prefixes in user-facing errors).\n//\n// Long-running generation (movie / PDF) is a single long-held dispatch that\n// resolves when the pipeline finishes; per-beat progress arrives on the\n// plugin pubsub channel (`GENERATION_EVENT`) instead of an SSE stream, which\n// also covers generations started elsewhere (background autoGenerateMovie,\n// another tab, the agent).\n\n/** One in-flight or per-beat generation notice, published on the plugin\n *  pubsub `generation` channel and returned by the `pendingGenerations`\n *  snapshot. Value strings mirror @mulmobridge/protocol's GENERATION_KINDS\n *  so MulmoClaude's host bridge maps 1:1 without a lookup table. */\nexport interface MulmoScriptGenerationEvent {\n  kind: \"beatImage\" | \"beatAudio\" | \"characterImage\" | \"movie\" | \"pdf\";\n  /** Wire `stories/…` path of the script the generation belongs to. */\n  filePath: string;\n  /** beatIndex (as string) for beat*, character key for characterImage, \"\" for movie/pdf. */\n  key: string;\n  /** false = started, true = finished (reload the asset off disk). */\n  done: boolean;\n  /** Only set on done=true when the work failed. */\n  error?: string;\n}\n\n/** Plugin pubsub event name the host publishes generation events on\n *  (full channel: `plugin:<scope>:generation`). */\nexport const GENERATION_EVENT = \"generation\";\n\ninterface BeatRef {\n  filePath: string;\n  beatIndex: number;\n}\n\ninterface CharacterRef {\n  filePath: string;\n  key: string;\n}\n\n/** Session tag for hosts that surface per-session generation indicators\n *  (MulmoClaude's sidebar). Optional everywhere; hosts without sessions\n *  ignore it. */\ninterface SessionTag {\n  chatSessionId?: string;\n}\n\nexport type MulmoScriptDispatchArgs =\n  | ({ kind: \"save\" } & { filePath?: string; script?: unknown; filename?: string })\n  | { kind: \"updateBeat\"; filePath: string; beatIndex: number; beat: unknown }\n  | { kind: \"updateScript\"; filePath: string; script: unknown }\n  | ({ kind: \"beatImage\" } & BeatRef)\n  | ({ kind: \"beatAudio\" } & BeatRef)\n  | ({ kind: \"beatMovie\" } & BeatRef)\n  | ({ kind: \"renderBeat\" } & BeatRef & SessionTag & { force?: boolean })\n  | ({ kind: \"generateBeatAudio\" } & BeatRef & SessionTag & { force?: boolean })\n  | ({ kind: \"uploadBeatImage\" } & BeatRef & { imageData: string })\n  | ({ kind: \"characterImage\" } & CharacterRef)\n  | ({ kind: \"renderCharacter\" } & CharacterRef & SessionTag & { force?: boolean })\n  | ({ kind: \"uploadCharacterImage\" } & CharacterRef & { imageData: string })\n  | ({ kind: \"movieStatus\" } & { filePath: string })\n  | ({ kind: \"pdfStatus\" } & { filePath: string })\n  | ({ kind: \"generateMovie\" } & { filePath: string } & SessionTag)\n  | ({ kind: \"generatePdf\" } & { filePath: string } & SessionTag)\n  | { kind: \"pendingGenerations\"; filePath: string };\n\nexport type MulmoScriptDispatchKind = MulmoScriptDispatchArgs[\"kind\"];\n\n/** Failure half of every dispatch response. `code` mirrors the phase-1\n *  outcome codes so a host can log/telemetry on it; the View only reads\n *  `error`. */\nexport interface DispatchFailure {\n  ok: false;\n  code?: \"bad_request\" | \"not_found\" | \"server_error\";\n  error: string;\n}\n\nexport type DispatchEnvelope<T> = ({ ok: true } & T) | DispatchFailure;\n\n/** Maps a dispatch `kind` to its success payload so the View's transport\n *  can call `dispatch` without casts at every site. */\nexport interface MulmoScriptDispatchResult {\n  save: { script: Record<string, unknown>; filePath: string; message: string };\n  updateBeat: Record<string, never>;\n  updateScript: Record<string, never>;\n  beatImage: { image: string | null };\n  beatAudio: { audio: string | null };\n  beatMovie: { moviePath: string | null };\n  renderBeat: { image: string };\n  generateBeatAudio: { audio: string };\n  uploadBeatImage: { image: string };\n  characterImage: { image: string | null };\n  renderCharacter: { image: string };\n  uploadCharacterImage: { image: string };\n  movieStatus: { moviePath: string | null };\n  pdfStatus: { pdfPath: string | null };\n  generateMovie: { moviePath: string };\n  generatePdf: { pdfPath: string };\n  pendingGenerations: { pending: MulmoScriptGenerationEvent[] };\n}\n"],"mappings":";;;AA+BA,IAAa,mBAAmB"}

package/dist/server/dispatch.d.ts

@@ -0,0 +1,10 @@
+import type { MulmoScriptServerOps } from "./ops";
+export type MulmoScriptDispatchHandler = (args: Record<string, unknown>) => Promise<unknown>;
+/**
+ * Build the kind router over an ops instance. The save / reopen / update
+ * kinds run the phase-1 core executes against the backend's artifacts
+ * FileOps, guarded by the instance's realpath containment
+ * (`guardStoryWirePath`) — the core's own guard is lexical.
+ */
+export declare function createMulmoScriptDispatchHandler(ops: MulmoScriptServerOps): MulmoScriptDispatchHandler;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/server/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/server/dispatch.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAqElD,MAAM,MAAM,0BAA0B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE7F;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,oBAAoB,GAAG,0BAA0B,CAuFtG"}

package/dist/server/index.d.ts

@@ -0,0 +1,7 @@
+export type { GenerateOpArgs, MovieGenerationResult, MovieProgressEvent, MulmoScriptServerBackend, MulmoScriptServerLog, OpFailure, OpResult, PdfGenerationResult, } from "./types";
+export { buildContext, buildBeatIdIndex, createMulmoScriptServerOps, PDF_MODE, PDF_SIZE, type MulmoScriptServerOps, type RunStoryOpDeps, type RunStoryOpOptions, type StoryContext, } from "./ops";
+export { createMulmoScriptDispatchHandler, type MulmoScriptDispatchHandler } from "./dispatch";
+export { withMulmoErrorCapture, enableGraphAIErrorCapture, composeMulmoErrorMessage, describeMulmoCause } from "./mulmoErrorCapture";
+export { GENERATION_EVENT, type MulmoScriptGenerationEvent } from "../core/contract";
+export { executeMulmoScriptSave, executeUpdateBeat, executeUpdateScript, type MulmoScriptFailure } from "../core/plugin";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAMA,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,QAAQ,EACR,QAAQ,EACR,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,gCAAgC,EAAE,KAAK,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACrI,OAAO,EAAE,gBAAgB,EAAE,KAAK,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/server/mulmoErrorCapture.d.ts

@@ -0,0 +1,29 @@
+import type { MulmoScriptServerLog } from "./types";
+/** Route captured GraphAI errors into the host logger. Set once by
+ *  `createMulmoScriptServerOps`; the GraphAILogger sink is global, so the
+ *  last-configured host logger wins (one ops instance per process). */
+export declare function setMulmoErrorCaptureLogger(log: MulmoScriptServerLog | null): void;
+/**
+ * Re-enable GraphAI's error level (everything else stays silenced) and
+ * route it into the host logger + the per-operation capture store.
+ * Call after every `setGraphAILogger(false)` — that helper disables all
+ * levels including error. Idempotent.
+ */
+export declare function enableGraphAIErrorCapture(): void;
+/** Render mulmocast's structured error `cause` as "field=value" pairs. */
+export declare function describeMulmoCause(err: unknown): string | null;
+/**
+ * Compose the enriched message for a failed mulmocast operation:
+ * mulmocast's own message, then its structured cause, then the
+ * captured underlying provider error(s). Deduped — GraphAI retries
+ * log the same error more than once.
+ */
+export declare function composeMulmoErrorMessage(err: unknown, captured: readonly string[]): string;
+/**
+ * Run a mulmocast operation, capturing GraphAI error logs emitted while
+ * it executes. On failure, rethrows with the captured provider error(s)
+ * appended to the message (original error kept as `cause`). Uses
+ * AsyncLocalStorage so concurrent operations don't cross-attribute.
+ */
+export declare function withMulmoErrorCapture<T>(operation: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=mulmoErrorCapture.d.ts.map

package/dist/server/mulmoErrorCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mulmoErrorCapture.d.ts","sourceRoot":"","sources":["../../src/server/mulmoErrorCapture.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAMpD;;uEAEuE;AACvE,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAEjF;AAYD;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAUhD;AAOD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI1F;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQtF"}

package/dist/server/ops.d.ts

@@ -0,0 +1,101 @@
+import type { MulmoBeat, MulmoStudioContext } from "@mulmocast/types";
+import type { MulmoScriptGenerationEvent } from "../core/contract";
+import type { GenerateOpArgs, MovieGenerationResult, MovieProgressEvent, MulmoScriptServerBackend, OpFailure, OpResult, PdfGenerationResult } from "./types";
+type GenerationKind = MulmoScriptGenerationEvent["kind"];
+export declare const PDF_MODE: "slide";
+export declare const PDF_SIZE: "a4";
+export declare function buildContext(absoluteFilePath: string, force?: boolean): Promise<MulmoStudioContext | null | undefined>;
+export type StoryContext = NonNullable<Awaited<ReturnType<typeof buildContext>>>;
+export interface RunStoryOpDeps {
+    resolveStory?: (filePath: string) => {
+        ok: true;
+        absolutePath: string;
+    } | OpFailure;
+    buildContext?: (absoluteFilePath: string, force?: boolean) => Promise<StoryContext | undefined>;
+}
+export interface RunStoryOpOptions<T> {
+    force?: boolean;
+    /**
+     * Op-specific tag included in the failure log so dashboards can
+     * distinguish which op is failing (e.g. `"generate-beat-audio"`).
+     * Falls back to a generic `"op failed"` entry when omitted.
+     */
+    operation?: string;
+    /**
+     * Soft-fail override for `buildContext` returning undefined. Some
+     * ops (e.g. `beatAudio`) historically returned a 200 `{ audio: null }`
+     * in that case so the frontend can silently retry. If provided, this
+     * callback returns the fallback result instead of the default
+     * server_error "Failed to initialize mulmo context".
+     */
+    onContextMissing?: () => OpResult<T>;
+}
+export declare function buildBeatIdIndex(beats: MulmoBeat[]): Map<string, number>;
+/**
+ * Build the per-host mulmoScript server ops instance. One instance per
+ * process — it owns the in-flight movie/PDF dedup sets and the
+ * generation-state tracker, and binds the injected host backend.
+ */
+export declare function createMulmoScriptServerOps(backend: MulmoScriptServerBackend): {
+    backend: MulmoScriptServerBackend;
+    toStoryRef: (absolutePath: string) => string;
+    resolveStory: (filePath: string) => {
+        ok: true;
+        absolutePath: string;
+    } | OpFailure;
+    guardStoryWirePath: (filePath: unknown) => OpFailure | null;
+    ffmpegGuard: () => OpFailure | null;
+    runStoryOp: <T>(filePath: string, options: RunStoryOpOptions<T>, handler: (ctx: {
+        absoluteFilePath: string;
+        context: StoryContext;
+    }) => Promise<OpResult<T>>, deps?: RunStoryOpDeps) => Promise<OpResult<T>>;
+    publishGeneration: (chatSessionId: string | undefined, kind: GenerationKind, filePath: string, key: string, finished: boolean, error?: string) => void;
+    pendingGenerations: (filePath: string) => MulmoScriptGenerationEvent[];
+    beatImageOp: (filePath: string, beatIndex: number) => Promise<OpResult<{
+        image: string | null;
+    }>>;
+    beatAudioOp: (filePath: string, beatIndex: number) => Promise<OpResult<{
+        audio: string | null;
+    }>>;
+    beatMovieOp: (filePath: string, beatIndex: number) => Promise<OpResult<{
+        moviePath: string | null;
+    }>>;
+    characterImageOp: (filePath: string, key: string) => Promise<OpResult<{
+        image: string | null;
+    }>>;
+    movieStatusOp: (filePath: string) => Promise<OpResult<{
+        moviePath: string | null;
+    }>>;
+    pdfStatusOp: (filePath: string) => Promise<OpResult<{
+        pdfPath: string | null;
+    }>>;
+    renderBeatOp: (args: Required<Pick<GenerateOpArgs, "filePath" | "beatIndex">> & GenerateOpArgs) => Promise<OpResult<{
+        image: string;
+    }>>;
+    generateBeatAudioOp: (args: Required<Pick<GenerateOpArgs, "filePath" | "beatIndex">> & GenerateOpArgs) => Promise<OpResult<{
+        audio: string;
+    }>>;
+    renderCharacterOp: (args: Required<Pick<GenerateOpArgs, "filePath" | "key">> & GenerateOpArgs) => Promise<OpResult<{
+        image: string;
+    }>>;
+    uploadBeatImageOp: (filePath: string, beatIndex: number, imageData: string) => Promise<OpResult<{
+        image: string;
+    }>>;
+    uploadCharacterImageOp: (filePath: string, key: string, imageData: string) => Promise<OpResult<{
+        image: string;
+    }>>;
+    inFlightMovies: Set<string>;
+    inFlightPdfs: Set<string>;
+    runMovieGeneration: (absoluteFilePath: string, onProgressEvent: (event: MovieProgressEvent) => void) => Promise<MovieGenerationResult>;
+    runPdfGeneration: (context: StoryContext, onImageBeatDone: (beatIndex: number) => void) => Promise<PdfGenerationResult>;
+    generateMovieOp: (filePath: string, chatSessionId: string | undefined) => Promise<OpResult<{
+        moviePath: string;
+    }>>;
+    generatePdfOp: (filePath: string, chatSessionId: string | undefined) => Promise<OpResult<{
+        pdfPath: string;
+    }>>;
+    triggerAutoBackgroundMovie: (absoluteFilePath: string, wireFilePath: string, chatSessionId: string | undefined) => void;
+};
+export type MulmoScriptServerOps = ReturnType<typeof createMulmoScriptServerOps>;
+export {};
+//# sourceMappingURL=ops.d.ts.map

package/dist/server/ops.d.ts.map

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

package/dist/server/support.d.ts

@@ -0,0 +1,9 @@
+export declare function errorText(err: unknown): string;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function stripDataUri(dataUri: string): string;
+/** Realpath-based containment: resolve `relPath` against the ROOT's
+ *  realpath and require the target's realpath to stay inside it. Returns
+ *  null on ENOENT or traversal (symlink escapes included). */
+export declare function resolveWithinRoot(rootReal: string, relPath: string): string | null;
+export declare function fileToDataUri(filePath: string, mimeType: string): Promise<string>;
+//# sourceMappingURL=support.d.ts.map

package/dist/server/support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../src/server/support.ts"],"names":[],"mappings":"AAUA,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQ9C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;8DAE8D;AAC9D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAalF;AAID,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGvF"}

package/dist/server/types.d.ts

@@ -0,0 +1,74 @@
+import type { FileOps } from "gui-chat-protocol";
+import type { MulmoScriptGenerationEvent } from "../core/contract";
+export interface OpFailure {
+    ok: false;
+    /** REST adapter mapping: bad_request→400, not_found→404,
+     *  unavailable→503, server_error→500. */
+    code: "bad_request" | "not_found" | "server_error" | "unavailable";
+    error: string;
+}
+export type OpResult<T> = ({
+    ok: true;
+} & T) | OpFailure;
+export interface GenerateOpArgs {
+    filePath: string;
+    beatIndex?: number;
+    key?: string;
+    force?: boolean;
+    chatSessionId?: string;
+}
+export type MovieGenerationResult = {
+    ok: true;
+    outputPath: string;
+} | {
+    ok: false;
+    error: string;
+};
+export type PdfGenerationResult = {
+    ok: true;
+    outputPath: string;
+} | {
+    ok: false;
+    error: string;
+};
+export interface MovieProgressEvent {
+    kind: "image" | "audio";
+    beatIndex: number;
+}
+/** Host logger; every entry is already namespaced to mulmoScript by the
+ *  package, so hosts just bind their own prefix/transport. */
+export interface MulmoScriptServerLog {
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+}
+/**
+ * Host capabilities the server ops run against. Only genuinely
+ * host-specific transport lives here — the mulmocast orchestration, path
+ * containment, and generation-state tracking are all in-package.
+ */
+export interface MulmoScriptServerBackend {
+    /** Absolute path of the stories directory (`<workspace>/artifacts/stories`).
+     *  May not exist yet — the ops lazily create + realpath it. */
+    storiesDir: string;
+    /** Shared artifacts FileOps (rooted at `<workspace>/artifacts`) for the
+     *  save / reopen / update dispatch kinds (phase-1 core executes). */
+    artifacts: FileOps;
+    /** Atomic file write (tmp alongside destination + rename; parent dirs
+     *  created). Hosts inject their hardened implementation. */
+    writeFileAtomic: (absolutePath: string, data: string | Uint8Array) => Promise<void>;
+    /** ffmpeg availability probe. `false` blocks render/movie/PDF ops with a
+     *  clear message; `true`/`undefined` proceeds (a boot probe may not have
+     *  completed yet — never block on the startup window). */
+    isFfmpegAvailable?: () => boolean | undefined;
+    /**
+     * Generation fan-out (session channels, UI pubsub). Called on EDGE
+     * transitions only — first start / last finish of concurrent same-key
+     * runs — plus the finish-only per-beat pulses from the movie/PDF
+     * pipelines. `chatSessionId` is undefined for callers outside a chat
+     * session. The package keeps the in-flight snapshot itself.
+     */
+    onGenerationEvent?: (chatSessionId: string | undefined, event: MulmoScriptGenerationEvent) => void;
+    log?: MulmoScriptServerLog;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,KAAK,CAAC;IACV;6CACyC;IACzC,IAAI,EAAE,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,aAAa,CAAC;IACnE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACpG,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;8DAC8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;mEAC+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB;yEACqE;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB;gEAC4D;IAC5D,eAAe,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF;;8DAE0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IAC9C;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;IACnG,GAAG,CAAC,EAAE,oBAAoB,CAAC;CAC5B"}