@cueframe/kernel 0.1.2 → 0.1.3

package/dist/director.js

@@ -10,7 +10,7 @@ import {
   dataChunk,
   generationArtifactFromToolResult,
   projectDirectorHistory
-} from "./chunk-LJ5W4ZBU.js";
+} from "./chunk-TMB5AY6Q.js";
 import "./chunk-FTVZF4GO.js";
 import {
   ChatErrorView,
@@ -22,7 +22,7 @@ import {
   ProjectRef,
   chatErrorViewFromEnvelope,
   chatErrorViewFromUnknown
-} from "./chunk-ZPLJ24OV.js";
+} from "./chunk-TO4BFNLJ.js";
 import {
   ClientRequestId,
   GenerateMediaCommand,
@@ -44,7 +44,7 @@ import {
 import "./chunk-BADZHXLR.js";
 import "./chunk-U3JPILZS.js";
 import "./chunk-XELS2BGA.js";
-import "./chunk-LLUW26BS.js";
+import "./chunk-AW57IWNW.js";
 import "./chunk-2ESYSVXG.js";
 export {
   ChatErrorView,

package/dist/errors.js

@@ -5,7 +5,7 @@ import {
   encodeError,
   scrubSensitive,
   toWireEnvelope
-} from "./chunk-LLUW26BS.js";
+} from "./chunk-AW57IWNW.js";
 import "./chunk-2ESYSVXG.js";
 export {
   CueframeError,

package/dist/mcp/adapter.js

@@ -1,6 +1,6 @@
 import {
   waitForJob
-} from "../chunk-QETYXKQQ.js";
+} from "../chunk-SDCEJAO2.js";
 import {
   apiErrorFrom,
   bodySchemaFor,
@@ -11,10 +11,10 @@ import {
   opById,
   safeParse,
   sniffImageMediaType
-} from "../chunk-W3SIWT7J.js";
+} from "../chunk-DL7WYISQ.js";
 import {
   CURATED_TOOLS
-} from "../chunk-AO744WIK.js";
+} from "../chunk-DJW3UGBH.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../mcp/src/adapter.ts
@@ -25,9 +25,9 @@ import { tool } from "ai";
 var INTERNAL_LOOP_TOOLS = [
   {
     name: "render_frame",
-    operationId: "previewFrame",
+    operationId: "previewFrameJob",
     pathArgs: { projectId: "id" },
-    description: "Render still(s) of the WHOLE composition at the given timestamps, returning presigned image(s) \u2014 the in-loop full-composition preview. `body.timestamps` is an array of clip-relative SECONDS: pass EVERY beat you want to inspect in ONE call \u2014 a call is flat-cost and one budget unit however many timestamps it carries, and all render in a single pass (a contact sheet), so never spend calls one frame at a time. Stills are content-addressed: re-rendering an unchanged composition is free, and the judge grades the EXACT frames you looked at. (One component instead of the whole composition? use preview_component.)",
+    description: "Queue durable stills of the WHOLE composition, then wait for the job and return the images. `body.timestamps` is an array of clip-relative SECONDS: pass EVERY beat you want to inspect in ONE call \u2014 a call is flat-cost and one budget unit however many timestamps it carries. Stills are content-addressed and retries reattach to the same execution. (One component instead of the whole composition? use preview_component.)",
     annotations: { readOnlyHint: true }
   },
   {
@@ -41,7 +41,7 @@ var INTERNAL_LOOP_TOOLS = [
     name: "preview_component",
     operationId: "previewComponent",
     pathArgs: { projectId: "id" },
-    description: "Queue a MOTION-clip render of ONE org-installed component \u2014 ASYNC; the in-loop wrapper blocks until terminal and returns the clip. It is the SAME content-addressed bake the production render composites, so what you preview is literally the object that ships, and previewing an unchanged component is free. Failures carry typed codes (component_does_not_compile / component_runtime_error) with the sanitized author-fixable message \u2014 read it, fix the tsxSource via create_component, and re-preview. Idempotent per (componentId, params, dims).",
+    description: "Queue a preview of ONE org-installed component \u2014 ASYNC; the in-loop wrapper blocks until terminal. Live mode returns an image still; baked mode returns the same content-addressed VP9-alpha motion artifact the production render composites. Failures carry typed codes (component_does_not_compile / component_runtime_error) with the sanitized author-fixable message \u2014 read it, fix the tsxSource via create_component, and re-preview. Idempotent per (componentId, params, dims, executionMode).",
     annotations: { idempotentHint: true }
   },
   {
@@ -82,7 +82,7 @@ var INTERNAL_LOOP_TOOLS = [
     name: "wait_job",
     operationId: "getJob",
     title: "Wait for Job",
-    description: "Wait for a long-running job and return the resolved result \u2014 a BOUNDED long-poll. Polls the job status (render / compose / consult / clip-suggestions / verify / preview / brand-kit extract) and blocks up to the caller's window; if the job is still running when the window closes it returns a `Still running` continuation \u2014 call wait_job again with the SAME arguments to keep waiting (the job keeps executing server-side; nothing is lost between calls). Call this right after create_render / compose / consult / suggest_briefs / score_composition / preview_component \u2014 the enqueue call returns only a receipt, and the RESULT (download URL, scores, critique) arrives here.",
+    description: "Wait for a long-running job and return the resolved result \u2014 a BOUNDED long-poll. Polls the job status (media / render / compose / consult / clip-suggestions / verify / preview / brand-kit extract) and blocks up to the caller's window; if the job is still running when the window closes it returns a `Still running` continuation \u2014 call wait_job again with the SAME arguments to keep waiting (the job keeps executing server-side; nothing is lost between calls). Call this right after import_media / generate_media / create_render / compose / consult / suggest_briefs / score_composition / preview_component \u2014 the enqueue call returns only a receipt, and the RESULT arrives here.",
     annotations: { readOnlyHint: true }
   }
 ];
@@ -137,6 +137,7 @@ async function pollJobToTerminal(ex, jobId, jobPoll) {
       const s = String(job?.status ?? "");
       if (s === "succeeded") return { outcome: "succeeded", job };
       if (s === "failed") return { outcome: "failed", job };
+      if (s === "cancelled") return { outcome: "cancelled", job };
     }
     if (Date.now() + pollMs >= deadline) return { outcome: "timeout" };
     await sleep(pollMs);
@@ -252,9 +253,23 @@ function buildRenderFrameTool(spec, ex, budget, opts) {
       const infra = infraToolErrorFromResponse(res);
       if (infra) throw infra;
       if (!isOk(res.status)) return JSON.stringify({ error: fmtErr(apiErrorFrom(res)) });
-      const json = safeParse(res.text);
+      const receipt = safeParse(res.text);
+      if (!receipt?.jobId) return JSON.stringify({ error: "preview-frame enqueue returned no jobId" });
+      const done = await pollJobToTerminal(ex, receipt.jobId, opts?.jobPoll);
+      if (done.outcome === "failed" || done.outcome === "cancelled") {
+        return JSON.stringify({
+          error: done.outcome === "cancelled" ? "preview-frame job cancelled" : done.pollError ?? done.job?.error ?? "preview-frame job failed"
+        });
+      }
+      if (done.outcome === "timeout") {
+        return JSON.stringify({
+          note: `preview-frame still rendering after ${Math.round((opts?.jobPoll?.timeoutMs ?? JOB_TIMEOUT_MS) / 1e3)}s; call preview_frame again to reattach`,
+          jobId: receipt.jobId
+        });
+      }
+      const json = done.job?.result;
       return inlineStillsOrNote(
-        (json?.stills ?? []).map((s) => s.url),
+        (json?.artifacts ?? []).map((artifact) => artifact.url),
         fetchImage,
         "no stills returned for the requested timestamps"
       );
@@ -293,10 +308,12 @@ function buildPreviewComponentTool(spec, ex, opts) {
       if (!isOk(res.status)) return JSON.stringify({ error: fmtErr(apiErrorFrom(res)) });
       const json = safeParse(res.text);
       let url = json?.url;
+      let artifactKind = json?.artifactKind;
+      let contentType = json?.contentType;
       if (!url && json?.jobId) {
         const done = await pollJobToTerminal(ex, json.jobId, opts?.jobPoll);
-        if (done.outcome === "failed") {
-          const err = done.pollError ?? (done.job?.error ? `${done.job.error.code ?? "preview_failed"}: ${done.job.error.message ?? ""}` : "preview job failed");
+        if (done.outcome === "failed" || done.outcome === "cancelled") {
+          const err = done.outcome === "cancelled" ? "preview job cancelled" : done.pollError ?? (done.job?.error ? `${done.job.error.code ?? "preview_failed"}: ${done.job.error.message ?? ""}` : "preview job failed");
           return JSON.stringify({ error: err });
         }
         if (done.outcome === "timeout") {
@@ -304,7 +321,19 @@ function buildPreviewComponentTool(spec, ex, opts) {
             note: `component preview still rendering after ${Math.round((opts?.jobPoll?.timeoutMs ?? JOB_TIMEOUT_MS) / 1e3)}s \u2014 proceed, or re-preview later`
           });
         }
-        url = done.job?.result?.url;
+        const result = done.job?.result;
+        url = result?.url;
+        artifactKind = result?.artifactKind;
+        contentType = result?.contentType;
+      }
+      const isImage = artifactKind === "image" || contentType?.startsWith("image/") === true || !artifactKind && !contentType && /\.(?:png|jpe?g|webp)(?:\?|$)/i.test(url ?? "");
+      if (url && !isImage) {
+        return JSON.stringify({
+          artifactKind: artifactKind ?? "motion",
+          contentType: contentType ?? "video/webm",
+          url,
+          note: "Motion previews are returned as URLs; they are not attached as image blocks."
+        });
       }
       return inlineStillsOrNote(
         [url],
@@ -386,7 +415,7 @@ function buildVerifyCompositionTool(spec, ex, budget, opts) {
           false
         );
       }
-      const err = done.pollError ?? (done.job?.error ? `${done.job.error.code ?? "verify_failed"}: ${done.job.error.message ?? ""}` : "verify job failed");
+      const err = done.outcome === "cancelled" ? "verify job cancelled" : done.pollError ?? (done.job?.error ? `${done.job.error.code ?? "verify_failed"}: ${done.job.error.message ?? ""}` : "verify job failed");
       return finish(JSON.stringify({ error: err }), false);
     }
   });
@@ -432,6 +461,7 @@ var WAIT_KINDS = [
   "compose",
   "suggestions",
   "verify",
+  "preview_frame",
   "preview",
   "brand_kit_extract",
   "consult"
@@ -444,7 +474,7 @@ function buildWaitJobTool(spec, ex, opts) {
     description: spec.description,
     inputSchema: z.object({
       kind: z.enum(WAIT_KINDS).describe(
-        "What to wait on: a render job, a compose job, a consult advisory, AI clip-suggestion analysis, or a generic async job (verify / preview / brand_kit_extract \u2014 the kind is named in the enqueue receipt)."
+        "What to wait on: a render job, compose job, consult advisory, AI clip-suggestion analysis, or a generic async job (verify / preview_frame / preview / brand_kit_extract \u2014 use the kind in the enqueue receipt)."
       ),
       id: z.string().describe("The job id from the enqueue call (renderId / composeJobId / jobId / mediaItemId for suggestions)."),
       projectId: z.string().optional().describe("Required for render / compose / consult (their status routes are project-scoped)."),

package/dist/mcp/core.js

@@ -17,7 +17,7 @@ import {
   sniffImageMediaType,
   text,
   withMedia
-} from "../chunk-W3SIWT7J.js";
+} from "../chunk-DL7WYISQ.js";
 import "../chunk-2ESYSVXG.js";
 export {
   __resetPreviewCache,

package/dist/mcp/curation.js

@@ -8,7 +8,7 @@ import {
   formatMediaList,
   formatResourceCandidates,
   formatWarnings
-} from "../chunk-AO744WIK.js";
+} from "../chunk-DJW3UGBH.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CRUD_COVERAGE,

package/dist/mcp/server.js

@@ -8,10 +8,10 @@ import {
   registerRawTools,
   registerSkillPrompts,
   titleCase
-} from "../chunk-TD347SSX.js";
-import "../chunk-QETYXKQQ.js";
-import "../chunk-W3SIWT7J.js";
-import "../chunk-AO744WIK.js";
+} from "../chunk-KFECIHED.js";
+import "../chunk-SDCEJAO2.js";
+import "../chunk-DL7WYISQ.js";
+import "../chunk-DJW3UGBH.js";
 import "../chunk-2ESYSVXG.js";
 export {
   RAW_EXCLUDED_OPERATION_IDS,

package/dist/mcp.js

@@ -9,10 +9,10 @@ import {
   registerCuratedTools,
   registerRawTools,
   registerSkillPrompts
-} from "./chunk-TD347SSX.js";
-import "./chunk-QETYXKQQ.js";
-import "./chunk-W3SIWT7J.js";
-import "./chunk-AO744WIK.js";
+} from "./chunk-KFECIHED.js";
+import "./chunk-SDCEJAO2.js";
+import "./chunk-DL7WYISQ.js";
+import "./chunk-DJW3UGBH.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../mcp/src/index.ts

package/dist/media-model/testing.js

@@ -6032,7 +6032,7 @@ function manageArtifactAttachment(attachment) {
   }
 }
 
-// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@22.20.1_@vitest+coverage-v8@4.1.11_j_92db6a7db25e6e55d70dc5d47c837999/node_modules/vitest/dist/chunks/utils.BX5Fg8C4.js
+// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@24.13.3_@vitest+coverage-v8@4.1.11_j_c9dcd8e1465939ba296830f01bf940ab/node_modules/vitest/dist/chunks/utils.BX5Fg8C4.js
 var NAME_WORKER_STATE = "__vitest_worker__";
 function getWorkerState() {
   const workerState = globalThis[NAME_WORKER_STATE];
@@ -12432,10 +12432,10 @@ function offsetToLineNumber(source, offset) {
   return line + 1;
 }
 
-// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@22.20.1_@vitest+coverage-v8@4.1.11_j_92db6a7db25e6e55d70dc5d47c837999/node_modules/vitest/dist/chunks/_commonjsHelpers.D26ty3Ew.js
+// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@24.13.3_@vitest+coverage-v8@4.1.11_j_c9dcd8e1465939ba296830f01bf940ab/node_modules/vitest/dist/chunks/_commonjsHelpers.D26ty3Ew.js
 var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
 
-// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@22.20.1_@vitest+coverage-v8@4.1.11_j_92db6a7db25e6e55d70dc5d47c837999/node_modules/vitest/dist/chunks/rpc.MzXet3jl.js
+// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@24.13.3_@vitest+coverage-v8@4.1.11_j_c9dcd8e1465939ba296830f01bf940ab/node_modules/vitest/dist/chunks/rpc.MzXet3jl.js
 var RealDate = Date;
 var now2 = null;
 var MockDate = class _MockDate extends RealDate {
@@ -13535,7 +13535,7 @@ function raceWith(promise, other) {
   }))]);
 }
 
-// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@22.20.1_@vitest+coverage-v8@4.1.11_j_92db6a7db25e6e55d70dc5d47c837999/node_modules/vitest/dist/chunks/test.DNmyFkvJ.js
+// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@24.13.3_@vitest+coverage-v8@4.1.11_j_c9dcd8e1465939ba296830f01bf940ab/node_modules/vitest/dist/chunks/test.DNmyFkvJ.js
 var fakeTimersSrc = {};
 var global2;
 var hasRequiredGlobal;
@@ -16238,7 +16238,7 @@ Object.defineProperty(globalThis, GLOBAL_EXPECT, {
 var assert4 = chai_exports.assert;
 var should2 = chai_exports.should;
 
-// ../../node_modules/.pnpm/vite@7.3.6_@types+node@22.20.1_jiti@2.7.0_lightningcss@1.33.0_terser@5.51.0_tsx@4.23.12_yaml@2.9.0/node_modules/vite/dist/node/module-runner.js
+// ../../node_modules/.pnpm/vite@7.3.6_@types+node@24.13.3_jiti@2.7.0_lightningcss@1.33.0_terser@5.51.0_tsx@4.23.12_yaml@2.9.0/node_modules/vite/dist/node/module-runner.js
 var SOURCEMAPPING_URL = "sourceMa";
 SOURCEMAPPING_URL += "ppingURL";
 var isWindows = typeof process < "u" && process.platform === "win32";
@@ -16283,7 +16283,7 @@ var envProxy = new Proxy({}, { get(_, p) {
   throw Error(`[module runner] Dynamic access of "import.meta.env" is not supported. Please, use "import.meta.env.${String(p)}" instead.`);
 } });
 
-// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@22.20.1_@vitest+coverage-v8@4.1.11_j_92db6a7db25e6e55d70dc5d47c837999/node_modules/vitest/dist/index.js
+// ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@24.13.3_@vitest+coverage-v8@4.1.11_j_c9dcd8e1465939ba296830f01bf940ab/node_modules/vitest/dist/index.js
 var import_expect_type = __toESM(require_dist(), 1);
 
 // ../data-models/media-model/src/testing/mediaStoreContract.ts

package/dist/nle-export.js

@@ -1,7 +1,7 @@
-import "./chunk-VFMW3JUY.js";
+import "./chunk-TXSFYUZH.js";
 import {
   getPrimitiveText
-} from "./chunk-CAJQ7H5A.js";
+} from "./chunk-HBVAZXYO.js";
 import "./chunk-H5LMJKZU.js";
 import "./chunk-MFHXCHRI.js";
 import "./chunk-JQMPHKLU.js";
@@ -26,9 +26,9 @@ import "./chunk-XHGZ2E77.js";
 import "./chunk-ZFEXATWN.js";
 import "./chunk-CX2IIQ4R.js";
 import "./chunk-DCVJWGIA.js";
-import "./chunk-VHF66LCQ.js";
+import "./chunk-NQSMEUJ6.js";
 import "./chunk-QH3YI3ND.js";
-import "./chunk-XQ72DZKJ.js";
+import "./chunk-ZPRBGW4Y.js";
 import "./chunk-23HFEKV7.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-7PA7FGLD.js";
@@ -36,7 +36,7 @@ import "./chunk-KYRDKK2D.js";
 import "./chunk-JF4JJAFP.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-LLUW26BS.js";
+import "./chunk-AW57IWNW.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../nle-export/src/srt.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueframe/kernel",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "Publish-only aggregate of CueFrame's isomorphic kernel packages — composition, primitives, authoring, MCP, and friends shipped as one npm artifact. Members remain separate workspace packages; this only changes what ships.",
   "files": [
@@ -17,26 +17,26 @@
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.9.3",
-    "@cueframe/account-model": "0.1.0",
     "@cueframe/animate": "0.1.0",
+    "@cueframe/authoring": "0.1.0",
     "@cueframe/brand-derivation": "0.1.0",
     "@cueframe/cloud-import": "0.1.0",
-    "@cueframe/authoring": "0.1.0",
-    "@cueframe/composition-ops": "0.1.0",
     "@cueframe/compose": "0.1.0",
-    "@cueframe/composition": "0.1.0",
-    "@cueframe/mcp": "0.1.0",
+    "@cueframe/composition-ops": "0.1.0",
+    "@cueframe/account-model": "0.1.0",
     "@cueframe/convex-api": "0.1.0",
-    "@cueframe/errors": "0.1.0",
+    "@cueframe/composition": "0.1.0",
+    "@cueframe/director": "0.1.0",
     "@cueframe/core": "0.1.0",
-    "@cueframe/media-model": "0.1.0",
     "@cueframe/foundation": "0.1.0",
+    "@cueframe/nle-export": "0.1.0",
+    "@cueframe/media-model": "0.1.0",
+    "@cueframe/errors": "0.1.0",
+    "@cueframe/mcp": "0.1.0",
     "@cueframe/perception": "0.1.0",
-    "@cueframe/render-harness": "0.1.0",
-    "@cueframe/director": "0.1.0",
     "@cueframe/plane": "0.1.0",
-    "@cueframe/nle-export": "0.1.0",
-    "@cueframe/primitives": "0.1.0"
+    "@cueframe/primitives": "0.1.0",
+    "@cueframe/render-harness": "0.1.0"
   },
   "peerDependencies": {
     "convex": ">=1.42",
@@ -613,6 +613,7 @@
   },
   "author": "CueFrame Inc.",
   "scripts": {
-    "build": "node ../../tools/build-aggregate.mjs kernel"
+    "build": "node ../../tools/build-aggregate.mjs kernel",
+    "check": "pnpm build"
   }
 }