@koda-sl/baker-cli 0.122.0-dev.fff192e73 → 0.122.1-dev.57a9836c5

package/dist/engine/index.d.ts

@@ -47,6 +47,13 @@ declare class BackendClient$1 {
         putUrl: string;
         publicUrl: string;
     }>;
+    /** Remote cache lookup. A miss (404) — or an old backend without the route — returns null. */
+    getCacheEntry<T>(cacheKey: string, signal?: AbortSignal): Promise<T | null>;
+    putCacheEntry(entry: {
+        cacheKey: string;
+    }, signal?: AbortSignal): Promise<void>;
+    /** Durable run-history record — POST /api/canvas/runs (idempotent server-side on runId). */
+    recordRun(payload: unknown, signal?: AbortSignal): Promise<void>;
     getArtifact(kind: string, name: string, version?: string, signal?: AbortSignal): Promise<ArtifactResponse>;
 }
 
@@ -339,6 +346,39 @@ type RunResult = {
         duration_ms: number;
     };
     outputs_dir: string;
+    node_runs: NodeRunRecord[];
+};
+type NodeRunRecord = {
+    node_id: string;
+    node_type: string;
+    cached: boolean;
+    duration_ms: number;
+    credits: number;
+};
+/**
+ * Live run telemetry: the plan (post-prune node list + dependency edges) fires
+ * once before any node executes, then start/settled/failed per node. Consumers
+ * stream these into run-history progress snapshots; a throwing consumer is
+ * swallowed — telemetry must never fail a paid run.
+ */
+type RunProgressEvent = {
+    kind: "plan";
+    nodes: Array<{
+        node_id: string;
+        node_type: string;
+        deps: string[];
+        params: unknown;
+    }>;
+} | {
+    kind: "node_start";
+    node_id: string;
+} | {
+    kind: "node_settled";
+    run: NodeRunRecord;
+    outputs: Record<string, unknown>;
+} | {
+    kind: "node_failed";
+    node_id: string;
 };
 type RunOptions = {
     signal?: AbortSignal;
@@ -346,6 +386,7 @@ type RunOptions = {
     cache_policy?: "read_write" | "bypass" | "read_only";
     /** Max nodes of one layer in flight at once; invalid or missing → 5. */
     concurrency?: number;
+    onProgress?: (event: RunProgressEvent) => void;
 };
 type EngineOptions = {
     registry: NodeRegistry;
@@ -354,6 +395,13 @@ type EngineOptions = {
     cache: CacheStore;
     outputsDir: string;
     log?: LogFn;
+    /**
+     * Stamp durable canvas-assets URLs onto fresh node outputs before they are
+     * cached — the precondition for remote cache portability and run-history
+     * records. Best-effort: a failed upload logs a warning and keeps the entry
+     * local-only, never fails the node.
+     */
+    persistAssets?: boolean;
 };
 declare class Engine$1 {
     private readonly registry;
@@ -362,6 +410,7 @@ declare class Engine$1 {
     private readonly cache;
     private readonly outputsDir;
     private readonly log;
+    private readonly persistAssets;
     constructor(opts: EngineOptions);
     validate(canvas: unknown): {
         ok: true;
@@ -390,6 +439,8 @@ declare class Engine$1 {
     }>;
     run(input: unknown, opts?: RunOptions): Promise<RunResult>;
     private runLayers;
+    /** Progress consumers are observers only — an exception there must never fail the run. */
+    private emitProgress;
     /**
      * Dead-node elimination: when the canvas declares an `output`, execute only the
      * nodes that output transitively depends on. Orphaned nodes (left by an edit or
@@ -467,6 +518,13 @@ declare function createEngineFromEnv(opts?: {
     cacheDir?: string;
     outputsDir?: string;
     log?: (line: string) => void;
+    /**
+     * Layer the company-scoped remote cache over the local one (and stamp
+     * durable asset URLs onto fresh outputs) so a fresh sandbox re-runs an
+     * already-computed canvas at zero credits. Defaults to on; disable with
+     * `remoteCache: false` or env BAKER_CANVAS_REMOTE_CACHE=off.
+     */
+    remoteCache?: boolean;
 }): Engine$1;
 
 export { BackendClient, Engine, LocalAssetStore, LocalCacheStore, ValidationError, createEngineFromEnv, defaultRegistry, generateCatalog, validateCanvasDeep };

package/dist/engine/index.js

@@ -8,7 +8,7 @@ import {
   defaultRegistry,
   generateCatalog,
   validateCanvasDeep
-} from "../chunk-MWFJ5NOP.js";
+} from "../chunk-T6HBTZOO.js";
 import "../chunk-5WRI5ZAA.js";
 export {
   BackendClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koda-sl/baker-cli",
-  "version": "0.122.0-dev.fff192e73",
+  "version": "0.122.1-dev.57a9836c5",
   "description": "AI-agent-first CLI for interacting with Baker, including the Baker creative canvas.",
   "type": "module",
   "bin": {