@cueframe/kernel 0.1.0 → 0.1.2

package/dist/_members/render-harness/resolveAssets.d.ts

@@ -1,33 +1,9 @@
-/**
- * Scan RenderInput for remote asset URLs, download them locally,
- * and return a URL mapping table for replacement.
- *
- * Handles: overlay images, GIFs, Lottie JSON, audio tracks,
- * brand kit assets (logos, fonts, intro/outro videos).
- *
- * Private cloud render-harness module — used only by materializeSources for the
- * Modal render sandbox (no desktop/OSS consumers).
- */
 import type { RenderInput } from '../core/render/index.js';
 export interface AssetMap {
-    /** Original URL → local HTTP URL */
     urlMap: Record<string, string>;
-    /** Number of assets downloaded */
     count: number;
 }
 type DownloadFn = (url: string, destPath: string) => Promise<void>;
-/**
- * Scan a RenderInput for all remote asset URLs, download each to tempDir,
- * and return a mapping from original URL → local media server URL.
- *
- * The caller should replace all URLs in the RenderInput using the map
- * before passing to render.mjs.
- *
- * @param renderInput - the composition to scan
- * @param tempDir - directory to download assets into
- * @param mediaServerUrl - base URL of the local media server
- * @param download - function to download a URL to a local path
- */
 export declare function resolveAssets(renderInput: RenderInput, tempDir: string, mediaServerUrl: string, download: DownloadFn): Promise<AssetMap>;
 export {};
 //# sourceMappingURL=resolveAssets.d.ts.map

package/dist/_members/render-harness/resolveAssets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveAssets.d.ts","sourceRoot":"","sources":["../src/resolveAssets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,UAAU,GACnB,OAAO,CAAC,QAAQ,CAAC,CAyDnB"}
+{"version":3,"file":"resolveAssets.d.ts","sourceRoot":"","sources":["../src/resolveAssets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnE,wBAAsB,aAAa,CACjC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,UAAU,GACnB,OAAO,CAAC,QAAQ,CAAC,CAsDnB"}

package/dist/_members/render-harness/sandboxGlobalSpecs.d.ts

@@ -1,23 +1,9 @@
-/** Sentinel: the export lives in `sandbox-globals.ts` itself (the wrappers). */
 export declare const GLOBALS_MODULE = "@@sandbox-globals@@";
-/** One global endowment's resolution spec: which module + which export. */
 export interface SandboxGlobalSpec {
-    /** Module specifier to resolve the value from (or GLOBALS_MODULE sentinel). */
     readonly module: string;
-    /** Export name to pull; `'default'` = the module's default export. */
     readonly exportName: string;
 }
-/**
- * name -> resolution spec for every Remotion sandbox global EXCEPT:
- *   - `console` (desktop-sandbox-only; the box keeps real Node console), and
- *   - the `@cueframe/animate` `sandboxScope` keys, which are DYNAMIC (a full set
- *     on the desktop / pro build, empty on the OSS/box stub). Those are spread from
- *     the resolved `@cueframe/animate` module at build time by each consumer, so
- *     they can't be a static list here. `ANIMATE_MODULE` records the source.
- */
 export declare const SANDBOX_GLOBAL_SPECS: Readonly<Record<string, SandboxGlobalSpec>>;
-/** Module the `@cueframe/animate` `sandboxScope` keys are spread from. */
 export declare const ANIMATE_MODULE = "@cueframe/animate";
-/** The static endowment names (everything except console + the animate spread). */
 export declare const SANDBOX_GLOBAL_NAMES: readonly string[];
 //# sourceMappingURL=sandboxGlobalSpecs.d.ts.map

package/dist/_members/render-harness/sandboxGlobalSpecs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandboxGlobalSpecs.d.ts","sourceRoot":"","sources":["../src/sandboxGlobalSpecs.ts"],"names":[],"mappings":"AAuCA,gFAAgF;AAChF,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAEpD,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAmE5E,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAsC,CAAC"}
+{"version":3,"file":"sandboxGlobalSpecs.d.ts","sourceRoot":"","sources":["../src/sandboxGlobalSpecs.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAwD5E,CAAC;AAEF,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAsC,CAAC"}

package/dist/account-model/validators.js

@@ -9,7 +9,7 @@ import {
   UploadTokenScope,
   UserSettings,
   WorkingComposition
-} from "../chunk-6EQXLEP6.js";
+} from "../chunk-IEXAKOEX.js";
 import "../chunk-XELS2BGA.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/account-model.js

@@ -9,7 +9,7 @@ import {
   UploadTokenScope,
   UserSettings,
   WorkingComposition
-} from "./chunk-6EQXLEP6.js";
+} from "./chunk-IEXAKOEX.js";
 import "./chunk-XELS2BGA.js";
 import "./chunk-2ESYSVXG.js";
 export {

package/dist/animate.js

@@ -183,7 +183,6 @@ var Write = ({
             display: "inline-block",
             opacity: progress,
             transform: `translateY(${yOffset}px)`,
-            // Preserve whitespace width
             minWidth: char === " " ? "0.25em" : void 0
           }
         },
@@ -891,37 +890,28 @@ import {
 
 // ../execution/animate/src/index.ts
 var sandboxScope = {
-  // Easing
   smooth,
   smootherstep,
   rushInto,
   rushFrom,
-  // Phase 1: Core Animations
   Create,
   GrowFromCenter,
   FadeIn,
-  // Phase 2: Animations
   Write,
   Indicate,
   Wiggle,
-  // Phase 2: Composition
   LaggedStart,
   AnimationGroup,
   Succession,
-  // Phase 3: Animations
   Transform,
   MoveAlongPath,
   GrowArrow,
-  // Phase 3: Mobjects
   Arrow,
   makeArrowPath,
   BrandBox,
-  // Phase 5: Graph
   Graph,
   DiGraph,
-  // Phase 4: Three.js
   ThreeCanvas,
-  // drei — Shapes
   Box,
   Sphere,
   Cylinder,
@@ -938,10 +928,8 @@ var sandboxScope = {
   Extrude,
   Lathe,
   Tube,
-  // drei — Text
   Text,
   Text3D,
-  // drei — Staging & Lighting
   Float,
   Environment,
   ContactShadows,
@@ -953,11 +941,9 @@ var sandboxScope = {
   Stars,
   Sparkles,
   Cloud,
-  // drei — Lines & Curves
   QuadraticBezierLine,
   CubicBezierLine,
   CatmullRomLine,
-  // drei — Materials & Effects
   MeshDistortMaterial,
   MeshWobbleMaterial,
   MeshReflectorMaterial,
@@ -966,7 +952,6 @@ var sandboxScope = {
   Outlines,
   GradientTexture,
   RoundedBox,
-  // drei — Helpers
   Billboard,
   Html,
   PivotControls,

package/dist/authoring/build-tools.js

@@ -4,17 +4,17 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-LM4WDUQJ.js";
-import "../chunk-VOO5FQSS.js";
+} from "../chunk-TPA6PYN2.js";
+import "../chunk-BZZTVOGG.js";
 import "../chunk-JOURGVOR.js";
-import "../chunk-ZB3C3HM7.js";
-import "../chunk-XWKZB5U5.js";
+import "../chunk-DCVJWGIA.js";
+import "../chunk-ICSZF37W.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-KYRDKK2D.js";
-import "../chunk-NFEGPWGS.js";
-import "../chunk-MXFAADCQ.js";
-import "../chunk-W35ZMOXB.js";
-import "../chunk-EA6MYCYW.js";
+import "../chunk-TFGKUWHY.js";
+import "../chunk-WZH57M53.js";
+import "../chunk-WPZKOVYF.js";
+import "../chunk-2B5VJZHL.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/authoring/composer.js

@@ -2,46 +2,26 @@ import "../chunk-2ESYSVXG.js";
 
 // ../authoring/src/composer/scopes.ts
 var EDITOR_TOOLS = [
-  // Orientation — ONE read for composition + media pool + transcript + brand.
-  // Call it before get_composition/get_media_context, which stay for the
-  // per-item follow-ups.
   "get_context",
-  // Composition read/write — the same ops the /v1 routes serve (etag,
-  // webhooks, authorKind inherited automatically).
   "get_composition",
   "apply_composition",
   "validate_composition",
   "new_composition",
-  // Media + perception context
   "list_media",
   "get_media_context",
   "import_media",
-  // Footage intelligence — find moments by what they LOOK like (search_library,
-  // CLIP over the org's own frames) or by what is SAID (analyze_transcript, a
-  // metered LLM read whose spans are ~15s-grain and must be refined against
-  // word timings before they become a cut).
   "search_library",
   "analyze_transcript",
-  // Discovery
   "list_catalog",
   "search_fonts",
   "search_resources",
   "import_resource",
-  // Custom graphics — author/fork motion components. preview_component is
-  // deliberately EXCLUDED: buildCuratedToolSet serves its INTERNAL in-loop
-  // variant first (session-box scoped), which a sessionless chat agent can't
-  // drive; the agent sees placed graphics through preview_frame instead.
   "create_component",
   "get_component_source",
-  // Sight + judgment + output. score_composition and create_render both ENQUEUE
-  // and return a receipt, so wait_job rides with them — without it the agent
-  // gets a jobId it can never resolve and the verdict evaporates (adapter.ts
-  // documents the prod run that scored into the void exactly that way).
   "preview_frame",
   "score_composition",
   "create_render",
   "wait_job",
-  // Generation
   "generate_media"
 ];
 function editorScope(projectId) {

package/dist/authoring/context.js

@@ -1,12 +1,12 @@
 import {
   buildDirectorContext
-} from "../chunk-IBYQG46O.js";
-import "../chunk-XWKZB5U5.js";
+} from "../chunk-DWLNPNC4.js";
+import "../chunk-ICSZF37W.js";
 import "../chunk-KYRDKK2D.js";
-import "../chunk-NFEGPWGS.js";
-import "../chunk-MXFAADCQ.js";
-import "../chunk-W35ZMOXB.js";
-import "../chunk-EA6MYCYW.js";
+import "../chunk-TFGKUWHY.js";
+import "../chunk-WZH57M53.js";
+import "../chunk-WPZKOVYF.js";
+import "../chunk-2B5VJZHL.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/authoring/pipelineTrace.js

@@ -1,6 +1,6 @@
 import {
   PipelineTrace
-} from "../chunk-LD5ZOUFT.js";
+} from "../chunk-GF52TW4I.js";
 import "../chunk-2ESYSVXG.js";
 export {
   PipelineTrace

package/dist/authoring/prompts.js

@@ -11,7 +11,7 @@ import {
   buildPlannerUserMessage,
   formatPlanSteps,
   initCodeGenPrompts
-} from "../chunk-UY4SWJVE.js";
+} from "../chunk-K2IUBCND.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CODE_GEN_FEW_SHOT_EXAMPLES,

package/dist/authoring/resource-routing.js

@@ -5,7 +5,7 @@ import {
   searchSoundEffectsCandidates,
   searchStockPhotoCandidates,
   searchStockVideos
-} from "../chunk-ZE76SSRT.js";
+} from "../chunk-FMODQD5P.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../authoring/src/resource-routing.ts

package/dist/authoring/resources.js

@@ -14,7 +14,7 @@ import {
   searchStockPhotos,
   searchStockVideos,
   trendingKlipy
-} from "../chunk-ZE76SSRT.js";
+} from "../chunk-FMODQD5P.js";
 import "../chunk-2ESYSVXG.js";
 export {
   popularPixabayPhotos,

package/dist/authoring/tools.js

@@ -6,16 +6,16 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "../chunk-VOO5FQSS.js";
+} from "../chunk-BZZTVOGG.js";
 import "../chunk-JOURGVOR.js";
-import "../chunk-ZB3C3HM7.js";
-import "../chunk-XWKZB5U5.js";
+import "../chunk-DCVJWGIA.js";
+import "../chunk-ICSZF37W.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-KYRDKK2D.js";
-import "../chunk-NFEGPWGS.js";
-import "../chunk-MXFAADCQ.js";
-import "../chunk-W35ZMOXB.js";
-import "../chunk-EA6MYCYW.js";
+import "../chunk-TFGKUWHY.js";
+import "../chunk-WZH57M53.js";
+import "../chunk-WPZKOVYF.js";
+import "../chunk-2B5VJZHL.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/authoring.js

@@ -1,6 +1,6 @@
 import {
   buildDirectorContext
-} from "./chunk-IBYQG46O.js";
+} from "./chunk-DWLNPNC4.js";
 import {
   buildFastModel,
   buildModel,
@@ -8,7 +8,7 @@ import {
 } from "./chunk-ZT7MHRQU.js";
 import {
   PipelineTrace
-} from "./chunk-LD5ZOUFT.js";
+} from "./chunk-GF52TW4I.js";
 import {
   CODE_GEN_FEW_SHOT_EXAMPLES,
   COMPONENT_CONTRACT,
@@ -22,14 +22,14 @@ import {
   buildPlannerUserMessage,
   formatPlanSteps,
   initCodeGenPrompts
-} from "./chunk-UY4SWJVE.js";
+} from "./chunk-K2IUBCND.js";
 import {
   ZERO_USAGE,
   buildDirectorTools,
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "./chunk-LM4WDUQJ.js";
+} from "./chunk-TPA6PYN2.js";
 import {
   COMPOSE_MOTION_TOOLS,
   COMPOSE_MOTION_VERIFY_TOOLS,
@@ -38,27 +38,27 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "./chunk-VOO5FQSS.js";
+} from "./chunk-BZZTVOGG.js";
 import {
   AgentFixableCaptureError,
   getExcludedTools
 } from "./chunk-JOURGVOR.js";
-import "./chunk-ZB3C3HM7.js";
-import "./chunk-XWKZB5U5.js";
+import "./chunk-DCVJWGIA.js";
+import "./chunk-ICSZF37W.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-KYRDKK2D.js";
-import "./chunk-GEA7E2FL.js";
+import "./chunk-PIURX6IZ.js";
 import {
   cssLayoutVars
-} from "./chunk-FYZVH3MC.js";
+} from "./chunk-YQ7FFW3G.js";
 import "./chunk-DSMLHYJ4.js";
 import "./chunk-JF4JJAFP.js";
-import "./chunk-NFEGPWGS.js";
-import "./chunk-MXFAADCQ.js";
-import "./chunk-W35ZMOXB.js";
-import "./chunk-EA6MYCYW.js";
+import "./chunk-TFGKUWHY.js";
+import "./chunk-WZH57M53.js";
+import "./chunk-WPZKOVYF.js";
+import "./chunk-2B5VJZHL.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-37NJ27UU.js";
+import "./chunk-LLUW26BS.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../authoring/src/agent.ts
@@ -102,7 +102,6 @@ function buildPrepareStep(policy) {
       return {
         messages: pruneMessages({
           messages: withStubs,
-          // Effectively "never" — tool calls/results are managed above.
           toolCalls: `before-last-${99999}-messages`,
           reasoning: "before-last-message",
           emptyMessages: "remove"
@@ -115,9 +114,6 @@ function buildPrepareStep(policy) {
     messages: pruneMessages({
       messages,
       toolCalls,
-      // Coupled to tool-call pruning, never 'none': see pruneReasoning above —
-      // older turns lose thinking WHOLESALE (valid) instead of keeping a
-      // signed thinking block on a message whose tool_use was pruned (400).
       reasoning: "before-last-message",
       emptyMessages: "remove"
     })
@@ -208,8 +204,6 @@ Above are ${frames.length} captured frames. Use them to evaluate visual criteria
     schema: CriteriaEvaluationSchema,
     instructions: CRITERIA_EVALUATOR_PROMPT,
     messages: [{ role: "user", content: contentParts }],
-    // One verbose feedback string per criterion; an 8-9 criterion evaluation
-    // runs ~2.5-4k tokens. A tighter cap truncates the JSON mid-string.
     maxOutputTokens: 8e3
   });
   const criterionNames = Object.keys(criteria);
@@ -298,7 +292,6 @@ ${dimensionsText}${criteriaText}
 
 ARTIFACT TO EVALUATE:
 ${artifact}`,
-    // critique + evidence run long; a tighter cap truncates the JSON mid-string.
     maxOutputTokens: 8e3
   });
   return toEvaluationResult(object, rubric);
@@ -328,7 +321,6 @@ Above are ${capturedFrames.length} captured frames. Inspect for visual quality,
     schema: EvaluationSchema,
     instructions: EVALUATOR_PROMPT,
     messages: [{ role: "user", content: contentParts }],
-    // critique + evidence run long; a tighter cap truncates the JSON mid-string.
     maxOutputTokens: 8e3
   });
   return toEvaluationResult(object, rubric);
@@ -365,7 +357,6 @@ var Agent = class {
   messages = [];
   excludedTools;
   log;
-  /** Monotonic step index for onStepMetrics; reset per run(). */
   stepCounter = 0;
   constructor(config) {
     this.config = config;
@@ -382,17 +373,9 @@ var Agent = class {
       }
     };
   }
-  /** Reset conversation history (new session). */
   reset() {
     this.messages = [];
   }
-  /**
-   * Run the agent with a prompt.
-   *
-   * Without criteria/rubric: single generation pass.
-   * With criteria + maxAttempts > 1: generate → evaluate → refine loop (criteria mode).
-   * With rubric + maxAttempts > 1: generate → evaluate → refine loop (rubric mode).
-   */
   async run(prompt, opts = {}) {
     this.stepCounter = 0;
     const { criteria, rubric, maxAttempts = 1 } = opts;
@@ -407,7 +390,6 @@ var Agent = class {
     }
     return this.runWithCriteria(prompt, opts);
   }
-  // ── Quality loop: criteria mode (pass/fail per criterion) ──
   async runWithCriteria(prompt, opts) {
     const { criteria, maxAttempts = 1 } = opts;
     let bestResult;
@@ -459,7 +441,6 @@ var Agent = class {
     }
     return bestResult;
   }
-  // ── Quality loop: rubric mode (weighted numeric scoring) ──
   async runWithRubric(prompt, opts) {
     const { rubric, verificationCriteria = [], maxAttempts = 1 } = opts;
     let bestResult;
@@ -509,7 +490,6 @@ var Agent = class {
     }
     return bestResult;
   }
-  // ── Private: single execution pass ──
   async executeOnce(prompt, opts) {
     this.messages.push({ role: "user", content: prompt });
     const hasTools = !!this.capabilities;
@@ -518,7 +498,6 @@ var Agent = class {
     }
     return this.executeWithTools(prompt, opts);
   }
-  // ── Text-only execution (no capabilities) ──
   async executeText(_prompt, opts) {
     try {
       const cacheBreakpoint = {
@@ -558,7 +537,6 @@ var Agent = class {
       return { success: false, text: errMsg, attempts: 1, usage: ZERO_USAGE };
     }
   }
-  // ── Tool-based execution ──
   async executeWithTools(_prompt, opts) {
     const capabilities = this.capabilities;
     const context = buildDirectorContext(capabilities, { maxChars: 32e3 });
@@ -597,9 +575,6 @@ ${contextJson}
     const agent = new ToolLoopAgent({
       model: this.config.model,
       maxOutputTokens,
-      // Config uses a structural per-provider record (the nominal
-      // ProviderOptions type isn't re-exported by every ai@6 minor); derive
-      // the SDK's own type from the constructor so the cast tracks upgrades.
       ...this.config.providerOptions ? {
         providerOptions: this.config.providerOptions
       } : {},
@@ -611,17 +586,10 @@ ${contextJson}
         }
       },
       tools: wrappedTools,
-      // B6: halt on an infra-sentinel tool-error step (second condition) — the
-      // model cannot fix a dead scratch/session, so further steps are waste.
       stopWhen: [
         isStepCount(maxSteps),
         ({ steps }) => infraErrorFromSteps(steps) !== null
       ],
-      // Observability: log each step's tool calls so the agent's craft
-      // behaviour — which tools it invokes vs SKIPS — is visible in the worker
-      // logs instead of a ~100s black box between phases. Names only (args are
-      // verbose); enough to see the tool sequence (e.g. did it call
-      // set_crop_intents / enable_captions_behind_speaker / capture_frames).
       onStepEnd: (step) => {
         const names = (step.toolCalls ?? []).map((t) => t.toolName);
         this.log.info(`[agent] step tools=[${names.join(", ") || "none"}] finish=${step.finishReason ?? "?"}`);
@@ -646,16 +614,6 @@ ${contextJson}
           });
         }
       },
-      // Context management: evict stale tool content between steps so a long
-      // tool-heavy run (accumulating tool-results + base64 capture images)
-      // stays under the model's window. Off unless the caller sets a policy.
-      // The moving cache breakpoint applies only when eviction is OFF: the
-      // sliding prune window rewrites messages BEFORE the prior step's
-      // breakpoint each step, so stamped tail entries would be written at
-      // 1.25x and never read back — strictly worse than no stamp. (Possible
-      // follow-up: stamp the eviction boundary instead, whose pruned prefix
-      // is stable step-over-step.) See promptCache.ts for why the
-      // system-only breakpoint leaves image tool-results uncached.
       prepareStep: this.config.finalStepTools ? reserveFinalStep(
         this.config.contextManagement ? buildPrepareStep(this.config.contextManagement) : cachePrepareStep,
         maxSteps,
@@ -726,7 +684,6 @@ ${contextJson}
       return { success: false, text: errMsg, attempts: 1, usage: ZERO_USAGE };
     }
   }
-  // ── Hook wiring ──
   wrapToolsWithHooks(tools, beforeHook, afterHook) {
     if (!beforeHook && !afterHook) return tools;
     const wrapped = {};
@@ -768,7 +725,6 @@ ${contextJson}
     }
     return wrapped;
   }
-  // ── Evaluation ──
   async evaluateResult(result, task, criteria, _opts) {
     const evalModel = this.config.evaluationModel ?? this.config.model;
     const capabilities = this.capabilities;
@@ -810,7 +766,6 @@ ${contextJson}
       artifact: result.text
     });
   }
-  // ── Rubric-based evaluation ──
   async evaluateWithRubric(result, task, rubric, verificationCriteria, _opts) {
     const evalModel = this.config.evaluationModel ?? this.config.model;
     const capabilities = this.capabilities;
@@ -830,7 +785,6 @@ ${contextJson}
     }
     return evaluateArtifact(evalModel, result.text ?? "", task, rubric, verificationCriteria);
   }
-  // ── Refinement prompts ──
   buildRefinementPrompt(originalTask, evaluation, criteria) {
     const failedCriteria = evaluation.criteria.filter((c) => !c.passed).map((c) => {
       const desc = criteria[c.name] ?? "";
@@ -1097,21 +1051,11 @@ function generateMotionShell(cardHtml, opts) {
   const sustain = PRESET_SUSTAIN[opts.preset];
   const tokenVars = cssLayoutVars(opts.tokens, void 0);
   const staggerBlock = opts.preset === "stagger-reveal" ? `
-  // Per-child reveal + sustained breathing: values are computed from the
-  // CURRENT frame and emitted as static nth-child rules \u2014 legal under
-  // Remotion's seek-and-freeze (this is per-frame static CSS, not a CSS
-  // animation). Children live inside the verbatim markup's [data-stagger]
-  // container; extra rules no-op. Breathing gives each tile a phase-offset
-  // \xB1${STAGGER_BREATHE.amp}px float for the whole hold, so a revealed mosaic never freezes.
   const staggerF = Math.max(1, Math.round((${staggerMs} / 1000) * fps));
   const staggerRules = Array.from({ length: ${MAX_STAGGER_CHILDREN} }, (_, i) => {
     const s = enterF + i * staggerF;
     const o = interpolate(frame, [s, s + enterF], [0, 1], { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
     const breathe = ${STAGGER_BREATHE.amp} * Math.sin((tSec / ${STAGGER_BREATHE.periodS}) * Math.PI * 2 + i * ${STAGGER_BREATHE.phase});
-    // 'translate' (the independent CSS property), NOT 'transform': this rule
-    // out-specifies any author class (0,2,0), so a transform here would
-    // clobber an author rotate/scale on the tile; the independent property
-    // composes with the author transform in Chromium.
     return '[data-stagger] > *:nth-child(' + (i + 1) + ') { opacity: ' + o + '; translate: 0 ' + breathe.toFixed(3) + 'px; }';
   }).join('\\n');` : "";
   const staggerStyleEl = opts.preset === "stagger-reveal" ? `<style>{staggerRules}</style>` : "";
@@ -1128,10 +1072,6 @@ export default function CardMotionShell({ durationInFrames, params }) {
     [Math.max(enterF + 1, durationInFrames - exitF), durationInFrames], [1, 0],
     { easing: Easing.in(Easing.cubic), extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
   const opacity = Math.min(enter, exit);
-  // SUSTAIN: post-entrance micro-motion for the full remaining clip. 'hold'
-  // runs 0\u21921 linearly from entrance-end to the last frame (linear on purpose \u2014
-  // constant perceived velocity = ambient life); tSec is seconds since the
-  // entrance completed (drives the settle wobble / breathing phases).
   const hold = interpolate(frame, [enterF, durationInFrames], [0, 1],
     { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
   const tSec = Math.max(0, frame - enterF) / fps;
@@ -1159,6 +1099,8 @@ var MotionPresetError = class extends Error {
     this.opIndex = opIndex;
     this.name = "MotionPresetError";
   }
+  code;
+  opIndex;
 };
 function resolveMotionPresetCard(composition, input) {
   if (!MOTION_PRESETS.includes(input.preset)) {
@@ -1185,13 +1127,7 @@ function resolveMotionPresetCard(composition, input) {
   }
   return {
     cardHtml: clip.source.html,
-    // The card's token layer rides with the markup — generateMotionShell bakes
-    // it as `--cf-*` vars so the shelled card keeps the values it was authored
-    // against (the custom render lane applies no token vars).
     ...clip.source.tokens !== void 0 ? { tokens: clip.source.tokens } : {},
-    // Depth rides through the shell: a behind-subject card must stay behind
-    // after the source swap, or the preset silently pops it in front of the
-    // subject (2026-08-10 issue — the sink's whole-source replace dropped it).
     ...clip.source.zPlane !== void 0 ? { zPlane: clip.source.zPlane } : {}
   };
 }

package/dist/{chunk-TWQOKKAF.js → chunk-23HFEKV7.js}

@@ -411,8 +411,6 @@ function projectChild(child, compound, source) {
         duration,
         source: windowedSource(clip, headDelta, duration),
         ...clip.animate ? { animate: windowedAnimate(clip, headDelta, duration) } : {},
-        // A child's link group must not merge with an identically-named one in
-        // the host or a sibling instance — scope it like the ids.
         ...clip.linkGroupId ? { linkGroupId: `${compound.id}:${clip.linkGroupId}` } : {}
       };
       contents.push(projected);
@@ -480,8 +478,6 @@ function planSlip(composition, clipId, deltaSeconds, sourceDuration) {
     clipId,
     trackKind: ctx.trackKind,
     patch: {
-      // startTime and duration are DELIBERATELY absent: that is what makes this
-      // a slip rather than a move.
       source: { ...source, trim: { ...source.trim, start, end } }
     }
   });
@@ -592,7 +588,6 @@ function planSlide(composition, clipId, deltaSeconds, sourceDurations) {
       op: "updateClip",
       clipId,
       trackKind: ctx.trackKind,
-      // Content untouched — only where it sits.
       patch: { startTime: ctx.clip.startTime + deltaSeconds }
     },
     {
@@ -703,7 +698,6 @@ function expandMovesToLinkGroups(composition, moves, clipsById) {
       named.add(partnerId);
       out.push({
         clipId: partnerId,
-        // The partner keeps its own lane — linking couples TIME, not track.
         toTrackId: trackIdOf(composition, partnerId) ?? move.toTrackId,
         startTime: Math.max(0, partner.startTime + delta),
         duration: partner.duration