@skyphusion-labs/vivijure-core 0.9.0

package/dist/scatter-orchestrator.d.ts

@@ -0,0 +1,70 @@
+import type { Env, ExecutionContext } from "./platform/orchestrator-context.js";
+import type { ScatterJob } from "./scatter-orchestrator-types.js";
+import { type FilmJob } from "./film-orchestrator.js";
+import { isScatterParentJobId } from "./scatter.js";
+import type { RunpodJobView } from "./runpod-submit.js";
+export type { ScatterJob } from "./scatter-orchestrator-types.js";
+export { isScatterParentJobId as isScatterJobId };
+export interface StartScatterArgs {
+    project: string;
+    bundle_key: string;
+    quality_tier: "draft" | "standard" | "final";
+    shot_ids: string[];
+    shard_count: number;
+    cast_loras: Record<string, unknown>;
+    render_overrides?: Record<string, unknown>;
+    motion_backend?: string;
+    audio_key?: string;
+    film_titles?: {
+        title?: {
+            text: string;
+            subtitle?: string;
+        };
+        credits?: {
+            lines: string[];
+        };
+    };
+    project_id?: number | null;
+}
+export declare function startScatterRender(env: Env, args: StartScatterArgs): Promise<ScatterJob>;
+/** Persist a scatter submit so it can NEVER orphan a render (#289).
+ *
+ *  The runnable R2 doc is written FIRST: the poll/advance path runs entirely off it
+ *  (loadScatterJob), so once it lands the render is runnable and a later transient cannot strand
+ *  it. The D1 render rows are a UI-list projection, written AFTER, best-effort: the parent (so the
+ *  shards can FK it), then the shard rows as one all-or-nothing env.DB.batch, each wrapped in
+ *  withD1Retry. A persistent D1 failure is logged as a structured d1.error and SWALLOWED -- the
+ *  submit still succeeds (render is runnable) and the missing rows self-heal on the first poll
+ *  (ensureScatterRenderRow). This is the cure for the orphan-row 422: a mid-submit blip can no
+ *  longer leave a row with no job, nor fail the whole submit. The submit spans two stores (D1 rows
+ *  + R2 docs), so a single DB.batch cannot make it truly atomic; runnability-first ordering plus
+ *  self-heal makes the residual gap benign. */
+export declare function finalizeScatterSubmit(env: Env, scatterJob: ScatterJob, shardRows: {
+    jobId: string;
+    status: string;
+}[]): Promise<void>;
+/** A shard's per-tick advance outcome. `ok` carries the loaded film job (use its phase); otherwise
+ *  `doc_missing` = the film-job doc is gone from R2 (genuinely dead), `errored` = the advance threw
+ *  (a transient blip or any mid-advance error -- UNDETERMINED this tick, NOT dead). */
+export type ShardAdvanceOutcome = {
+    ok: true;
+    job: FilmJob;
+} | {
+    ok: false;
+    reason: "doc_missing" | "errored";
+};
+/** Map a shard's advance outcome to its gather status. The key distinction (watchdog defense-in-
+ *  depth): an `errored` shard is UNDETERMINED -> IN_PROGRESS (recoverable; the gather keeps waiting
+ *  and retries), NOT a SHARD_DEAD status -- so a transient-D1-blocked shard is never declared
+ *  "owning shard dead". Only a genuinely-failed phase or a vanished doc maps to FAILED. */
+export declare function shardStatusForOutcome(outcome: ShardAdvanceOutcome): string;
+/** Self-heal the D1 render row from the runnable R2 doc (#289). Cheap read first -- a no-op once
+ *  the row exists (the normal path). Only when the row is MISSING (a submit whose best-effort D1
+ *  write lost the flaky window) does it insert the row at the doc's current status and, when
+ *  terminal, fill status/output via updateRenderFromView. Never aborts the advance: a transient is
+ *  left for the next poll; a non-transient is logged. */
+export declare function ensureScatterRenderRow(env: Env, job: ScatterJob, ctx?: ExecutionContext): Promise<void>;
+export declare function advanceScatterJob(env: Env, scatterId: string, ctx?: ExecutionContext): Promise<RunpodJobView | null>;
+export declare function scatterJobToPollView(job: ScatterJob): RunpodJobView;
+export declare function cancelScatterJob(env: Env, scatterId: string): Promise<RunpodJobView | null>;
+//# sourceMappingURL=scatter-orchestrator.d.ts.map

package/dist/scatter-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter-orchestrator.d.ts","sourceRoot":"","sources":["../src/scatter-orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAeL,KAAK,OAAO,EAEb,MAAM,wBAAwB,CAAC;AAUhC,OAAO,EAEL,oBAAoB,EAIrB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,oBAAoB,CAAC;AAgBtE,YAAY,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,oBAAoB,IAAI,cAAc,EAAE,CAAC;AAwBlD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,EAAE,CAAA;SAAE,CAAA;KAAE,CAAC;IAC7F,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAiBD,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkG9F;AAED;;;;;;;;;;;+CAW+C;AAC/C,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAyCf;AAyQD;;uFAEuF;AACvF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC;AAErD;;;2FAG2F;AAC3F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAG1E;AAED;;;;yDAIyD;AACzD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,UAAU,EACf,GAAG,CAAC,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,gBAAgB,GACrB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAsE/B;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,CA6BnE;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAYjG"}