@cueframe/kernel 0.1.0 → 0.1.2

package/dist/director/testing.js

@@ -0,0 +1,22 @@
+import "../chunk-2ESYSVXG.js";
+
+// ../director/src/testing/contract.ts
+var HOME = { location: "home", project: null, selectedMediaIds: [], fastMode: false };
+async function collectRuntime(runtime, prompt = "hello") {
+  const events = [];
+  for await (const event of runtime.run({
+    conversationId: "contract-conversation",
+    context: HOME,
+    messages: [{ role: "user", content: prompt }]
+  })) events.push(event);
+  return events;
+}
+async function assertDirectorRuntimeContract(runtime) {
+  const events = await collectRuntime(runtime);
+  if (events.length === 0) throw new Error("DirectorRuntime emitted no events");
+  if (events.at(-1)?.type !== "finish") throw new Error("DirectorRuntime did not finish explicitly");
+}
+export {
+  assertDirectorRuntimeContract,
+  collectRuntime
+};

package/dist/director.d.ts

@@ -0,0 +1 @@
+export * from "./_members/director/index.js";

package/dist/director.js

@@ -0,0 +1,86 @@
+import {
+  CueFrameIteration,
+  CueFrameMessageMetadata,
+  CueFramePhase,
+  CueFramePlan,
+  CueFrameRunOutcome,
+  CueFrameSuggestions,
+  chunksForDirectorEvent,
+  cueFrameDataPartSchemas,
+  dataChunk,
+  generationArtifactFromToolResult,
+  projectDirectorHistory
+} from "./chunk-LJ5W4ZBU.js";
+import "./chunk-FTVZF4GO.js";
+import {
+  ChatErrorView,
+  ConversationId,
+  DirectorEvent,
+  DirectorRunId,
+  DirectorTurnContext,
+  DirectorTurnEnvelope,
+  ProjectRef,
+  chatErrorViewFromEnvelope,
+  chatErrorViewFromUnknown
+} from "./chunk-ZPLJ24OV.js";
+import {
+  ClientRequestId,
+  GenerateMediaCommand,
+  GenerationArtifact,
+  GenerationCapabilities,
+  GenerationCapability,
+  GenerationFailure,
+  GenerationGroupId,
+  GenerationId,
+  GenerationReceipt,
+  GenerationReference,
+  GenerationStatus,
+  MediaGenerator,
+  MediaId,
+  MediaKind,
+  ProjectHome,
+  deriveGenerationStatus
+} from "./chunk-73DQTUWY.js";
+import "./chunk-BADZHXLR.js";
+import "./chunk-U3JPILZS.js";
+import "./chunk-XELS2BGA.js";
+import "./chunk-LLUW26BS.js";
+import "./chunk-2ESYSVXG.js";
+export {
+  ChatErrorView,
+  ClientRequestId,
+  ConversationId,
+  CueFrameIteration,
+  CueFrameMessageMetadata,
+  CueFramePhase,
+  CueFramePlan,
+  CueFrameRunOutcome,
+  CueFrameSuggestions,
+  DirectorEvent,
+  DirectorRunId,
+  DirectorTurnContext,
+  DirectorTurnEnvelope,
+  GenerateMediaCommand,
+  GenerationArtifact,
+  GenerationCapabilities,
+  GenerationCapability,
+  GenerationFailure,
+  GenerationGroupId,
+  GenerationId,
+  GenerationReceipt,
+  GenerationReference,
+  GenerationStatus,
+  MediaGenerator,
+  MediaId,
+  MediaKind,
+  ProjectHome,
+  ProjectRef,
+  chatErrorViewFromEnvelope,
+  chatErrorViewFromUnknown,
+  chunksForDirectorEvent,
+  cueFrameDataPartSchemas,
+  dataChunk,
+  deriveGenerationStatus,
+  generationArtifactFromToolResult,
+  projectDirectorHistory
+};

package/dist/errors.js

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

package/dist/foundation.js

@@ -1,3 +1,4 @@
+import "./chunk-BADZHXLR.js";
 import {
   InvariantError
 } from "./chunk-U3JPILZS.js";

package/dist/mcp/adapter.js

@@ -1,6 +1,6 @@
 import {
   waitForJob
-} from "../chunk-MMEJ3Y7E.js";
+} from "../chunk-QETYXKQQ.js";
 import {
   apiErrorFrom,
   bodySchemaFor,
@@ -11,10 +11,10 @@ import {
   opById,
   safeParse,
   sniffImageMediaType
-} from "../chunk-SIGGQRY2.js";
+} from "../chunk-W3SIWT7J.js";
 import {
   CURATED_TOOLS
-} from "../chunk-HI4UTTPS.js";
+} from "../chunk-AO744WIK.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../mcp/src/adapter.ts
@@ -25,7 +25,6 @@ import { tool } from "ai";
 var INTERNAL_LOOP_TOOLS = [
   {
     name: "render_frame",
-    // Sessionless — the same op the public `preview_frame` uses.
     operationId: "previewFrame",
     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.)",
@@ -52,30 +51,10 @@ var INTERNAL_LOOP_TOOLS = [
     description: "Promote this run's scratch composition to the project's active composition. DENIED to ensemble author/designer candidates (only the WINNER saves downstream); buildable only via an explicit allowedNames."
   },
   {
-    // ADAPTER-ONLY (brand-kit-from-inspiration, spec D9: the public MCP gains NO
-    // new tools). The director's author/designer loops reach it via allowedNames
-    // + `opts.brandKitId` (the director injects the bound kit); a public hosted
-    // caller has no way to name a kit, so the {id} path param would resolve to
-    // String(undefined) → POST /v1/brand-kits/undefined/exemplars → always 404.
-    // Living here (not in CURATED_TOOLS) keeps it OFF the public server —
-    // server.ts:registerCuratedTools iterates CURATED_TOOLS only — while
-    // buildCuratedToolSet iterates INTERNAL_LOOP_TOOLS + CURATED_TOOLS, so the
-    // designer/author allow-lists still build it. The kit id comes from
-    // opts.brandKitId, never the LLM, so it has no path/query args here.
     name: "view_style_reference",
     operationId: "getBrandKitExemplars",
     description: "SEE the brand kit's inspiration exemplar frames (the reference pixels). Call with {motifId} to see the frames a specific motif was observed in before authoring that graphic. Frames are the ground truth the judge grades against \u2014 match their language, not the house style."
   },
-  // ── One-vocabulary merge (2026-08-07) ───────────────────────────────────
-  // `get_context`, `search_library` and `analyze_transcript` are the names the
-  // DESKTOP agent already speaks; the /v1 twins landed in tasks 2-4 so one tool
-  // vocabulary can serve local and cloud through one Executor seam. They live
-  // HERE, not in CURATED_TOOLS, on purpose: server.ts:registerCuratedTools
-  // iterates CURATED_TOOLS procedurally, so membership there IS publication on
-  // the hosted MCP server. These three are internal-lane only until the desktop
-  // merge lands and the surface is deliberately widened. `buildCuratedToolSet`
-  // iterates INTERNAL_LOOP_TOOLS + CURATED_TOOLS (adapter.ts), so the editor
-  // agent and the Director build them without server.ts changing at all.
   {
     name: "get_context",
     operationId: "getProjectContext",
@@ -86,24 +65,12 @@ var INTERNAL_LOOP_TOOLS = [
   {
     name: "search_library",
     operationId: "searchLibrary",
-    // The op takes NO path params and NO body — `q`/`limit` are QUERY params,
-    // and `queryArgs` is the only mechanism that puts them on the wire (the raw
-    // registrar drops query params entirely, which is why its raw twin is
-    // excluded in server.ts). Without this block the tool would call
-    // GET /v1/media/search with no `q` and 400 on every invocation.
     queryArgs: {
       q: 'REQUIRED. What the moment should LOOK like, in plain language \u2014 describe the IMAGE, not the words spoken ("wide shot of a speaker at a whiteboard", "hands on a keyboard"). Omitting it is a 400.',
       limit: "Maximum moments to return. Default 10, maximum 25."
     },
     description: "FIND MOMENTS IN YOUR OWN FOOTAGE by describing what they look like. The query is embedded with the same CLIP model that embedded every indexed frame, so it matches on VISUAL content \u2014 including shots nobody talks about, which is exactly where transcript search fails. Returns time-ranged moments best-first: feed `mediaId` + `startSec`/`endSec` straight into apply_composition as a clip. To SEE a hit rather than trust its score, place it and call preview_frame at its `startSec` \u2014 a result row carries the media item's poster, never a frame of the matched moment. `indexing` is COVERAGE, not emptiness \u2014 true whenever some of the org's footage is not in the visual index yet (media that predates it, or still processing), and it can be true ALONGSIDE results; read those as \"the best moments among what we have looked at so far\". Empty `results` with `indexing: true` is a state, not a failure. TIMING: the text encoder scales to zero, so the first search after an idle period can take up to ~90s while it cold-starts \u2014 a documented wait, not a hang. Reach for search_resources instead when you need STOCK rather than the org's own footage.",
     annotations: { readOnlyHint: true }
-    // NO `preview` block, deliberately. `thumbUrl` is the ITEM's poster frame
-    // (schemas.ts: "the media item's poster"), not the matched moment's — and a
-    // result row is a CHUNK, so a 10-hit search over ONE video inlines the same
-    // unrelated poster ten times, uncaptioned. That is the confabulation class
-    // previews exist to fix, running backwards: the agent would judge moments
-    // against a frame none of them contains. The right eye on a hit is
-    // preview_frame at its startSec, which the description points at.
   },
   {
     name: "analyze_transcript",
@@ -111,15 +78,6 @@ var INTERNAL_LOOP_TOOLS = [
     pathArgs: { mediaItemId: "id" },
     description: "Ask ONE editorial question of a media item's transcript and get the answer as text. `body.task`: 'summary' (what is actually said, plus the takeaways), 'chapters' (where the subject changes), or 'highlights' (the moments that stand alone as a short). Pass `body.window` {startSec, endSec} to analyse one slice; omit it for the whole thing. PRECISION \u2014 READ THIS BEFORE YOU CUT: timestamps are ABSOLUTE seconds from the start of the media and every one is verified against the transcript before you see it (a fabricated timestamp fails the call rather than shipping), but they are LINE-START markers roughly 15s apart, so a boundary can sit up to 15s BEFORE the moment you asked for. Treat every span as APPROXIMATE \u2014 use it to LOCATE the moment, then refine the in/out against the word timings from get_context / get_media_context. Feeding a raw span straight into a clip trim WILL start it mid-sentence. This is a METERED LLM call, not a read: it bills on measured token spend. 422 `transcript_too_long` (over ~100k characters, roughly two hours of speech) means narrow it with `window` \u2014 it refuses rather than silently summarising only the first half; 422 `media_no_transcript` means no speech on file (or none inside your window) \u2014 get_media_context shows the transcript state."
   },
-  // `wait_job` is the ONE infrastructure verb on the adapter surface. The hosted
-  // MCP server registers its own copy procedurally (server.ts:registerWaitJob),
-  // so it must NEVER appear in CURATED_TOOLS — registerCuratedTools would then
-  // register the name twice and the whole server would fail to build. It lives
-  // here so `buildCuratedToolSet` can build it too: without it an allow-list
-  // carrying an ASYNC verb (create_render, score_composition, generate_media)
-  // hands the agent a receipt it can never resolve — the 2026-07-07 prod run
-  // that scored into the void. `operationId` is the representative status op;
-  // buildWaitJobTool resolves the real one PER KIND (wait.ts KINDS).
   {
     name: "wait_job",
     operationId: "getJob",
@@ -134,9 +92,6 @@ var INFRA_TOOL_ERROR_CODES = /* @__PURE__ */ new Set([
   "scratch_not_found",
   "session_not_found",
   "session_not_ready",
-  // Version-gate timeout: the box's daemon/subscription is dead — no tool call
-  // can revive it (2026-07-12: 234 dead renders, two 24-min blind designer
-  // attempts before design-lock).
   "session_version_timeout"
 ]);
 var InfraToolError = class extends Error {
@@ -145,6 +100,7 @@ var InfraToolError = class extends Error {
     this.code = code;
     this.name = "InfraToolError";
   }
+  code;
   infra = true;
 };
 function isInfraToolError(v) {
@@ -278,15 +234,7 @@ function buildRenderFrameTool(spec, ex, budget, opts) {
   const mapArg = (p) => sessionPathValue(reverse[p], opts) ?? void 0;
   return tool({
     description: spec.description,
-    // composition is omitted; session_id (stamped below) makes the server render
-    // the session SCRATCH — the composition this agent is actually editing. The
-    // box cutover left this body bare and previewFrame fell back to the project's
-    // ACTIVE row, so the designer refined against stills WITHOUT its own edits
-    // until the capture budget refused (prod 2026-07-14, rs7fanev…).
     inputSchema: z.object({ body: z.object({ timestamps: z.array(z.number()).min(1) }) }),
-    // K4: teach BATCHED inspection — several timestamps bracketing the edited
-    // window in ONE call (the measured anti-pattern: repeated single-frame
-    // renders, each costing a capture from the same budget).
     inputExamples: [{ input: { body: { timestamps: [14.2, 14.8, 15.6] } } }],
     execute: async (args) => {
       if (++budget.used.captures > budget.caps.captures) {
@@ -296,11 +244,6 @@ function buildRenderFrameTool(spec, ex, budget, opts) {
       }
       const res = await invokeOp(ex, op, mapArg, {
         timestamps: args.body.timestamps,
-        // Vision-bound shrink (2026-07-17 trace audit): this tool is the AGENT's
-        // eyes — full-res PNG stills base64'd into context cost +10k tokens per
-        // look and slower renders. The judge grades jpeg/0.5/70; the agent sees
-        // the same. The PUBLIC preview_frame (human preview) stays full-res —
-        // this body rides the dedicated internal-loop builder only.
         imageFormat: "jpeg",
         scale: 0.5,
         jpegQuality: 70,
@@ -591,9 +534,6 @@ function buildOneTool(spec, ex, budget, opts) {
   return tool({
     description: spec.description,
     inputSchema: z.object(shape),
-    // K4: worked examples from the curated spec (apply_composition teaches the
-    // targeted patch). Serialized as Anthropic input_examples; the provider
-    // adds the advanced-tool-use beta itself.
     ...schemaSafeExamples?.length ? { inputExamples: schemaSafeExamples } : {},
     execute: async (args) => {
       const toolCallId = `tc_${crypto.randomUUID().slice(0, 8)}`;
@@ -623,6 +563,7 @@ function buildOneTool(spec, ex, budget, opts) {
         toolName: spec.name,
         success: ok,
         message: output.slice(0, 200),
+        ...json !== void 0 ? { data: json } : {},
         toolCallId,
         timestamp: Date.now()
       });

package/dist/mcp/core.js

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

package/dist/mcp/curation.js

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

package/dist/mcp/server.js

@@ -8,10 +8,10 @@ import {
   registerRawTools,
   registerSkillPrompts,
   titleCase
-} from "../chunk-RF7U3SCL.js";
-import "../chunk-MMEJ3Y7E.js";
-import "../chunk-SIGGQRY2.js";
-import "../chunk-HI4UTTPS.js";
+} from "../chunk-TD347SSX.js";
+import "../chunk-QETYXKQQ.js";
+import "../chunk-W3SIWT7J.js";
+import "../chunk-AO744WIK.js";
 import "../chunk-2ESYSVXG.js";
 export {
   RAW_EXCLUDED_OPERATION_IDS,

package/dist/mcp.js

@@ -9,10 +9,10 @@ import {
   registerCuratedTools,
   registerRawTools,
   registerSkillPrompts
-} from "./chunk-RF7U3SCL.js";
-import "./chunk-MMEJ3Y7E.js";
-import "./chunk-SIGGQRY2.js";
-import "./chunk-HI4UTTPS.js";
+} from "./chunk-TD347SSX.js";
+import "./chunk-QETYXKQQ.js";
+import "./chunk-W3SIWT7J.js";
+import "./chunk-AO744WIK.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../mcp/src/index.ts

package/dist/media-model/generation.d.ts

@@ -0,0 +1 @@
+export * from "../_members/media-model/generation.js";

package/dist/media-model/generation.js

@@ -0,0 +1,40 @@
+import {
+  ClientRequestId,
+  GenerateMediaCommand,
+  GenerationArtifact,
+  GenerationCapabilities,
+  GenerationCapability,
+  GenerationFailure,
+  GenerationGroupId,
+  GenerationId,
+  GenerationReceipt,
+  GenerationReference,
+  GenerationStatus,
+  MediaGenerator,
+  MediaId,
+  MediaKind,
+  ProjectHome,
+  deriveGenerationStatus
+} from "../chunk-73DQTUWY.js";
+import "../chunk-BADZHXLR.js";
+import "../chunk-U3JPILZS.js";
+import "../chunk-XELS2BGA.js";
+import "../chunk-2ESYSVXG.js";
+export {
+  ClientRequestId,
+  GenerateMediaCommand,
+  GenerationArtifact,
+  GenerationCapabilities,
+  GenerationCapability,
+  GenerationFailure,
+  GenerationGroupId,
+  GenerationId,
+  GenerationReceipt,
+  GenerationReference,
+  GenerationStatus,
+  MediaGenerator,
+  MediaId,
+  MediaKind,
+  ProjectHome,
+  deriveGenerationStatus
+};