@mulmoclaude/mulmoscript-plugin 0.1.0 → 0.2.1

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"}