@koda-sl/baker-cli 0.395.0-dev.f8ecbaa42 → 0.395.0

package/dist/{client-EQOSDYJL.js → client-4P6U75EX.js}

@@ -4,9 +4,9 @@ import {
   apiGetWithHeaders,
   apiPost,
   validateConvexId
-} from "./chunk-OKE2QJSJ.js";
-import "./chunk-QIQ57EIA.js";
-import "./chunk-AOVFDDVW.js";
+} from "./chunk-Q7RQ3H6Y.js";
+import "./chunk-ZWMATKNS.js";
+import "./chunk-BRIJ4OWT.js";
 export {
   ApiError,
   apiGet,
@@ -14,4 +14,4 @@ export {
   apiPost,
   validateConvexId
 };
-//# sourceMappingURL=client-EQOSDYJL.js.map
+//# sourceMappingURL=client-4P6U75EX.js.map

package/dist/engine/index.d.ts

@@ -28,8 +28,10 @@ type ExecResponse = {
 /** A resumable run as reported by `GET /api/canvas/runs/active`. */
 type ActiveRunInfo = {
     runId: string;
-    status: "running" | "completed" | "failed";
+    status: "running" | "completed" | "failed" | "awaiting_approval";
     interrupted?: boolean;
+    /** The backend's verdict: an unfinished run another sandbox may take over. */
+    adoptable?: boolean;
     updatedAt?: number;
     canvasSha?: string;
     canvasSnapshotUrl?: string;
@@ -37,7 +39,7 @@ type ActiveRunInfo = {
 /** The newest snapshot-bearing run for a creative — `GET /api/canvas/runs/latest`. */
 type SnapshotRunInfo = {
     runId: string;
-    status: "running" | "completed" | "failed";
+    status: "running" | "completed" | "failed" | "awaiting_approval";
     interrupted?: boolean;
     canvasSha?: string;
     canvasSnapshotUrl: string;
@@ -64,9 +66,10 @@ declare class BackendClient$1 {
     });
     exec(req: ExecRequest, signal?: AbortSignal): Promise<ExecResponse>;
     private pollJob;
-    presignAssetUpload(sha256: string, mime: string, signal?: AbortSignal, purpose?: "output" | "source" | "blueprint"): Promise<{
+    presignAssetUpload(sha256: string, mime: string, signal?: AbortSignal, purpose?: "output" | "source" | "blueprint", conditional?: boolean): Promise<{
         putUrl: string;
         publicUrl: string;
+        conditional?: boolean;
     }>;
     /** Remote cache lookup. A miss (404) — or an old backend without the route — returns null. */
     getCacheEntry<T>(cacheKey: string, signal?: AbortSignal): Promise<T | null>;
@@ -130,81 +133,6 @@ type NodeFailureDetail = {
     retryable?: boolean;
 };
 
-declare const CanvasSchema: z.ZodObject<{
-    schema: z.ZodLiteral<"baker-canvas/1">;
-    cache_salt: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<z.ZodObject<{
-        name: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-        todo: z.ZodOptional<z.ZodUnknown>;
-        video: z.ZodOptional<z.ZodObject<{
-            duration_s: z.ZodNumber;
-            timeline: z.ZodOptional<z.ZodObject<{
-                spine_node: z.ZodString;
-                expected_total_s: z.ZodNumber;
-                audio_mix_node: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>;
-            vo_segments: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                slot: z.ZodString;
-                start_s: z.ZodNumber;
-                end_s: z.ZodNumber;
-                scene: z.ZodOptional<z.ZodNumber>;
-                speaker: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            talking_scenes: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
-                scene: z.ZodNumber;
-                voice_convert_node: z.ZodString;
-                scene_s: z.ZodOptional<z.ZodNumber>;
-                est_speech_s: z.ZodOptional<z.ZodNumber>;
-                speech_words: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>, z.ZodObject<{
-                scene: z.ZodNumber;
-                lipsync_node: z.ZodString;
-            }, z.core.$strip>]>>>;
-            lip_sync_caution: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                scene: z.ZodNumber;
-                speaker: z.ZodString;
-                tts_over_native: z.ZodArray<z.ZodString>;
-            }, z.core.$strip>>>;
-            motion_board: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-            elements: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                ref: z.ZodString;
-                label: z.ZodString;
-                type: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            clip_spans: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                node: z.ZodString;
-                span_s: z.ZodNumber;
-            }, z.core.$strip>>>;
-            graph_stats: z.ZodOptional<z.ZodObject<{
-                nodes_total: z.ZodNumber;
-                nodes_billable: z.ZodNumber;
-                node_types: z.ZodRecord<z.ZodString, z.ZodNumber>;
-                scene_routes: z.ZodArray<z.ZodObject<{
-                    scene: z.ZodNumber;
-                    route: z.ZodString;
-                    window_s: z.ZodNumber;
-                }, z.core.$strip>>;
-            }, z.core.$strict>>;
-        }, z.core.$strict>>;
-    }, z.core.$strict>>;
-    nodes: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        type: z.ZodString;
-        version: z.ZodOptional<z.ZodString>;
-        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        when: z.ZodOptional<z.ZodUnknown>;
-        regenerate: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-    }, z.core.$strict>>;
-    output: z.ZodOptional<z.ZodObject<{
-        node: z.ZodString;
-        output: z.ZodString;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-type Canvas = z.infer<typeof CanvasSchema>;
-
 declare const AssetRef: z.ZodDiscriminatedUnion<[z.ZodObject<{
     url: z.ZodOptional<z.ZodString>;
     path: z.ZodOptional<z.ZodString>;
@@ -297,27 +225,6 @@ declare class LocalAssetStore$1 implements AssetStore {
     ingestRemote(args: IngestRemoteArgs): Promise<AssetRef>;
 }
 
-type CacheEntry = {
-    cacheKey: string;
-    nodeType: string;
-    nodeVersion: string;
-    outputs: Record<string, unknown>;
-    refs: string[];
-    createdAt: number;
-};
-interface CacheStore {
-    rootDir: string;
-    get(cacheKey: string): Promise<CacheEntry | null>;
-    put(entry: CacheEntry): Promise<void>;
-}
-declare class LocalCacheStore$1 implements CacheStore {
-    rootDir: string;
-    constructor(rootDir: string);
-    private filePath;
-    get(cacheKey: string): Promise<CacheEntry | null>;
-    put(entry: CacheEntry): Promise<void>;
-}
-
 type LogFn = (line: string) => void;
 type ExecCtx = {
     canvasRunId: string;
@@ -339,9 +246,9 @@ type ExecCtx = {
     log: LogFn;
     signal?: AbortSignal;
     /**
-     * Record what the backend charged the company for this execution (its `credits_charged`,
-     * the same figure the credits ledger debits). The run reports this in place of the
-     * registry's flat estimate, so a run's credits are what was actually billed.
+     * Report credits the backend actually charged for this node. Kept off the
+     * node's outputs because those are cached, and a cache hit costs nothing.
+     * Called once per backend call; the executor sums them.
      */
     reportCharge?: (credits: number) => void;
 };
@@ -350,9 +257,18 @@ type CostEstimate = {
     credits: number;
     seconds_estimate: number;
 };
-type CostFn<P> = (args: {
+/**
+ * A function of a node's params, declared as a METHOD so it is checked
+ * bivariantly: that is what lets a concrete `NodeDefinition<I, P, O>` stand in
+ * for the type-erased `AnyNodeDefinition` a registry holds, with no cast at every
+ * registration. The registry only ever calls it with params its own schema parsed.
+ */
+type ParamsFn<P, R> = {
+    fn(params: P): R;
+}["fn"];
+type CostFn<P> = ParamsFn<{
     params: P;
-}) => CostEstimate;
+}, CostEstimate>;
 type ExecuteArgs<I, P> = {
     inputs: I;
     params: P;
@@ -369,9 +285,19 @@ type ValidateExtraIssue = {
     path: string;
     message: string;
 };
+/**
+ * What a raw input will hold at run time, as far as the graph says before the
+ * run: an asset kind, `list` (a whole list output rather than one element of it),
+ * `value` (not an asset at all), or `unknown` (only running it would tell).
+ */
+type StaticInputKind = AssetRef["kind"] | "list" | "value" | "unknown";
 type ValidateExtraFn = (args: {
     rawParams: unknown;
     rawInputs: unknown;
+    /** The canvas node id, when validating a whole canvas. */
+    nodeId?: string;
+    /** Reads a raw input value's kind off the node it references. */
+    inputKindOf?: (value: unknown) => StaticInputKind;
 }) => Promise<ValidateExtraIssue[]> | ValidateExtraIssue[];
 /**
  * Node-supplied cache-key extras hook. Returns extra fields the executor
@@ -390,7 +316,27 @@ type CacheKeyExtrasFn = (args: {
  * without running the node. Remote nodes also use it at runtime so the
  * delegate ingestor knows how to wrap returned bytes.
  */
-type OutputKindsSpec<P> = Record<string, AssetRef["kind"]> | ((params: P) => Record<string, AssetRef["kind"]>);
+type OutputKindsSpec<P> = Record<string, AssetRef["kind"]> | ParamsFn<P, Record<string, AssetRef["kind"]>>;
+/**
+ * What a node's output will measure, known before anything runs: its length and
+ * raster. Each field is present only when the params (and the timing of what is
+ * wired in) settle it; an absent field means "only running it would tell".
+ */
+type StaticTiming = {
+    duration_s?: number;
+    width?: number;
+    height?: number;
+};
+/**
+ * Node-supplied static timing hook: the output's length and size from its parsed
+ * params plus the static timing of each wired input (keyed by input slot, absent
+ * when upstream cannot say). Pure; `canvas validate` calls it to prove the
+ * timeline without running anything.
+ */
+type StaticTimingFn<P> = ParamsFn<{
+    params: P;
+    inputs: Readonly<Record<string, StaticTiming | undefined>>;
+}, StaticTiming>;
 type NodeDefinition<I = unknown, P = unknown, O = unknown> = {
     id: string;
     version: string;
@@ -412,17 +358,130 @@ type NodeDefinition<I = unknown, P = unknown, O = unknown> = {
     validateExtra?: ValidateExtraFn;
     cacheKeyExtras?: CacheKeyExtrasFn;
     outputKinds?: OutputKindsSpec<P>;
-    execute: (args: ExecuteArgs<I, P>) => Promise<O>;
+    staticTiming?: StaticTimingFn<P>;
+    execute: ParamsFn<ExecuteArgs<I, P>, Promise<O>>;
 };
+/**
+ * Any node definition, its input/param/output types erased: what a registry
+ * holds and the executor runs. Every `defineNode(...)` result is assignable to it.
+ */
+type AnyNodeDefinition = NodeDefinition<unknown, unknown, unknown>;
+
+type NodeCredits = {
+    node_id: string;
+    node_type: string;
+    credits: number;
+};
+
+declare const CanvasSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"baker-canvas/1">;
+    cache_salt: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        todo: z.ZodOptional<z.ZodUnknown>;
+        video: z.ZodOptional<z.ZodObject<{
+            duration_s: z.ZodNumber;
+            timeline: z.ZodOptional<z.ZodObject<{
+                spine_node: z.ZodString;
+                expected_total_s: z.ZodNumber;
+                audio_mix_node: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            vo_segments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                slot: z.ZodString;
+                start_s: z.ZodNumber;
+                end_s: z.ZodNumber;
+                scene: z.ZodOptional<z.ZodNumber>;
+                speaker: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            talking_scenes: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+                scene: z.ZodNumber;
+                voice_convert_node: z.ZodString;
+                scene_s: z.ZodOptional<z.ZodNumber>;
+                est_speech_s: z.ZodOptional<z.ZodNumber>;
+                speech_words: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>, z.ZodObject<{
+                scene: z.ZodNumber;
+                lipsync_node: z.ZodString;
+            }, z.core.$strip>]>>>;
+            lip_sync_caution: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                scene: z.ZodNumber;
+                speaker: z.ZodString;
+                tts_over_native: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>>;
+            motion_board: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+            elements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                ref: z.ZodString;
+                label: z.ZodString;
+                type: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            clip_spans: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                node: z.ZodString;
+                span_s: z.ZodNumber;
+            }, z.core.$strip>>>;
+            graph_stats: z.ZodOptional<z.ZodObject<{
+                nodes_total: z.ZodNumber;
+                nodes_billable: z.ZodNumber;
+                node_types: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                scene_routes: z.ZodArray<z.ZodObject<{
+                    scene: z.ZodNumber;
+                    route: z.ZodString;
+                    window_s: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        regenerate: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        tags: z.ZodOptional<z.ZodObject<{
+            scene: z.ZodOptional<z.ZodNumber>;
+            role: z.ZodOptional<z.ZodString>;
+            region: z.ZodOptional<z.ZodNumber>;
+            on_camera: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    output: z.ZodOptional<z.ZodObject<{
+        node: z.ZodString;
+        output: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type Canvas = z.infer<typeof CanvasSchema>;
+
+type CacheEntry = {
+    cacheKey: string;
+    nodeType: string;
+    nodeVersion: string;
+    outputs: Record<string, unknown>;
+    refs: string[];
+    createdAt: number;
+};
+interface CacheStore {
+    rootDir: string;
+    get(cacheKey: string): Promise<CacheEntry | null>;
+    put(entry: CacheEntry): Promise<void>;
+}
+declare class LocalCacheStore$1 implements CacheStore {
+    rootDir: string;
+    constructor(rootDir: string);
+    private filePath;
+    get(cacheKey: string): Promise<CacheEntry | null>;
+    put(entry: CacheEntry): Promise<void>;
+}
 
 declare class NodeRegistry {
     private readonly byId;
-    register(def: NodeDefinition): void;
-    registerAll(defs: readonly NodeDefinition[]): void;
-    get(id: string): NodeDefinition | undefined;
+    register(def: AnyNodeDefinition): void;
+    registerAll(defs: readonly AnyNodeDefinition[]): void;
+    get(id: string): AnyNodeDefinition | undefined;
     has(id: string): boolean;
     ids(): string[];
-    all(): NodeDefinition[];
+    all(): AnyNodeDefinition[];
 }
 
 type RunResult = {
@@ -550,11 +609,7 @@ declare class Engine$1 {
         ok: false;
         issues: ValidationIssue[];
     }) & {
-        perNodeCredits?: Array<{
-            node_id: string;
-            node_type: string;
-            credits: number;
-        }>;
+        perNodeCredits?: NodeCredits[];
     }>;
     run(input: unknown, opts?: RunOptions): Promise<RunResult>;
     private runLayers;
@@ -569,6 +624,10 @@ declare class Engine$1 {
     private pruneToOutput;
     private writeFinal;
     private executeOne;
+    /** A cache hit replayed as this node's result: its outputs written, and free. */
+    private replayCached;
+    /** Best-effort: a failed upload keeps the outputs local-only, never fails the node. */
+    private persistOutputs;
     /**
      * Print the warnings a node left on its outputs' metadata — a `voice_select` that
      * could not honor the requested gender, say. Left in the metadata alone they were
@@ -597,11 +656,7 @@ type ValidationResult = {
 };
 type ValidationDeep = ValidationResult & {
     /** Per-node credit estimate, in canvas order. Useful for `validate` cost previews. */
-    perNodeCredits?: Array<{
-        node_id: string;
-        node_type: string;
-        credits: number;
-    }>;
+    perNodeCredits?: NodeCredits[];
 };
 /**
  * Async second pass that lets each node run its own `validateExtra` hook.

package/dist/engine/index.js

@@ -8,9 +8,9 @@ import {
   defaultRegistry,
   generateCatalog,
   validateCanvasDeep
-} from "../chunk-Q3LMLQAI.js";
-import "../chunk-QIQ57EIA.js";
-import "../chunk-AOVFDDVW.js";
+} from "../chunk-LHJ5IXBN.js";
+import "../chunk-ZWMATKNS.js";
+import "../chunk-BRIJ4OWT.js";
 export {
   BackendClient,
   Engine,

package/dist/{env-ANKM47IJ.js → env-LJHSZSNA.js}

@@ -13,7 +13,7 @@ import {
   requireChatId,
   requireConnection,
   resolveChatId
-} from "./chunk-AOVFDDVW.js";
+} from "./chunk-BRIJ4OWT.js";
 export {
   captureBudgetMs,
   captureProxyCredentials,
@@ -30,4 +30,4 @@ export {
   requireConnection,
   resolveChatId
 };
-//# sourceMappingURL=env-ANKM47IJ.js.map
+//# sourceMappingURL=env-LJHSZSNA.js.map

package/dist/{output-NR4EJQDV.js → output-HVBFJX4I.js}

@@ -4,10 +4,10 @@ import {
   writeAdsJson,
   writeAdsOutput,
   writeJsonEnvelope
-} from "./chunk-T2UNK5BW.js";
-import "./chunk-OKE2QJSJ.js";
-import "./chunk-QIQ57EIA.js";
-import "./chunk-AOVFDDVW.js";
+} from "./chunk-QP7637HG.js";
+import "./chunk-Q7RQ3H6Y.js";
+import "./chunk-ZWMATKNS.js";
+import "./chunk-BRIJ4OWT.js";
 export {
   resolveCustomerId,
   toCsvRow,
@@ -15,4 +15,4 @@ export {
   writeAdsOutput,
   writeJsonEnvelope
 };
-//# sourceMappingURL=output-NR4EJQDV.js.map
+//# sourceMappingURL=output-HVBFJX4I.js.map

package/dist/{shared-SLCDVV45.js → shared-7ZEF4DIX.js}

@@ -9,11 +9,11 @@ import {
   resolveEffectiveStatus,
   statusFilterHints,
   todayIso
-} from "./chunk-NEZ3NAJV.js";
-import "./chunk-T2UNK5BW.js";
-import "./chunk-OKE2QJSJ.js";
-import "./chunk-QIQ57EIA.js";
-import "./chunk-AOVFDDVW.js";
+} from "./chunk-EEHNRAFA.js";
+import "./chunk-QP7637HG.js";
+import "./chunk-Q7RQ3H6Y.js";
+import "./chunk-ZWMATKNS.js";
+import "./chunk-BRIJ4OWT.js";
 export {
   NAME_CONTAINS_ARG,
   csvOrJson,
@@ -26,4 +26,4 @@ export {
   statusFilterHints,
   todayIso
 };
-//# sourceMappingURL=shared-SLCDVV45.js.map
+//# sourceMappingURL=shared-7ZEF4DIX.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koda-sl/baker-cli",
-  "version": "0.395.0-dev.f8ecbaa42",
+  "version": "0.395.0",
   "description": "AI-agent-first CLI for interacting with Baker, including the Baker creative canvas.",
   "type": "module",
   "bin": {
@@ -38,6 +38,7 @@
     "quantize": "^1.0.2",
     "sharp": "^0.34.5",
     "undici": "7.29.0",
+    "yaml": "^2.6.1",
     "zod": "^4.3.6"
   },
   "devDependencies": {