@tangle-network/agent-app 0.12.0 → 0.13.0

package/dist/export-presets-Dl5Aa5xj.d.ts

@@ -0,0 +1,284 @@
+import { d as SceneElement, N as NewPageOptions, P as PageBleed, a as PageGuides, g as ScenePage, B as Bounds } from './model-BHLN208Z.js';
+
+/**
+ * The design-canvas operation union — the ONE mutation vocabulary shared by
+ * the editor's command stack (human edits, undo/redo), the MCP tool
+ * dispatcher (agent edits), and programmatic automation (template
+ * instantiation, data sync). Every state change the editor can express is an
+ * operation here; anything not expressible here does not happen to a
+ * document. That closure is the automation contract: replaying a decision
+ * log reproduces the document.
+ *
+ * Attribute patches are validated per element kind in ./validate before
+ * ./apply mutates the document; both run server-side on every path.
+ */
+
+/** Per-kind attribute patch. `kind` is immutable after creation; ids are
+ *  immutable always. Validation rejects attrs foreign to the target's kind. */
+type SceneAttrsPatch = Partial<Omit<SceneElement, 'id' | 'kind' | 'children'>> & {
+    text?: string;
+    width?: number;
+    height?: number;
+    points?: number[];
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    cornerRadius?: number;
+    dash?: number[];
+    fontFamily?: string;
+    fontSize?: number;
+    fontStyle?: 'normal' | 'bold' | 'italic' | 'bold italic';
+    align?: 'left' | 'center' | 'right';
+    lineHeight?: number;
+    letterSpacing?: number;
+    src?: string;
+    posterSrc?: string;
+    fit?: 'fill' | 'cover' | 'contain';
+};
+interface AddElementOperation {
+    type: 'add_element';
+    pageId: string;
+    /** Complete element including caller-minted id (reconciled like sequences
+     *  clips when the server re-mints). */
+    element: SceneElement;
+    /** Insertion z-index; omitted → top. */
+    index?: number;
+    /** Parent group; omitted → page root. */
+    parentGroupId?: string;
+}
+interface SetAttrsOperation {
+    type: 'set_attrs';
+    pageId: string;
+    elementId: string;
+    attrs: SceneAttrsPatch;
+}
+interface ReorderElementOperation {
+    type: 'reorder_element';
+    pageId: string;
+    elementId: string;
+    /** Target index within the element's CURRENT owner (page root or group). */
+    toIndex: number;
+}
+interface DeleteElementOperation {
+    type: 'delete_element';
+    pageId: string;
+    elementId: string;
+}
+interface GroupElementsOperation {
+    type: 'group_elements';
+    pageId: string;
+    /** ≥ 2 sibling elements (same owner); grouped in their current z-order. */
+    elementIds: string[];
+    /** Caller-minted id for the new group. */
+    groupId: string;
+    name?: string;
+}
+interface UngroupElementOperation {
+    type: 'ungroup_element';
+    pageId: string;
+    groupId: string;
+}
+interface AddPageOperation {
+    type: 'add_page';
+    /** Caller-minted page id. */
+    pageId: string;
+    options?: NewPageOptions;
+    /** Position in the page list; omitted → end. */
+    index?: number;
+}
+interface DuplicatePageOperation {
+    type: 'duplicate_page';
+    sourcePageId: string;
+    /** Caller-minted id for the copy; element ids are re-minted server-side. */
+    pageId: string;
+}
+interface DeletePageOperation {
+    type: 'delete_page';
+    pageId: string;
+}
+interface ReorderPageOperation {
+    type: 'reorder_page';
+    pageId: string;
+    toIndex: number;
+}
+interface SetPagePropsOperation {
+    type: 'set_page_props';
+    pageId: string;
+    name?: string;
+    width?: number;
+    height?: number;
+    background?: string;
+    /** null clears bleed; omitted leaves unchanged. */
+    bleed?: PageBleed | null;
+}
+interface SetPageGuidesOperation {
+    type: 'set_page_guides';
+    pageId: string;
+    guides: PageGuides;
+}
+interface BindSlotOperation {
+    type: 'bind_slot';
+    pageId: string;
+    elementId: string;
+    /** null unbinds. Slot names are unique document-wide. */
+    slot: string | null;
+}
+/** Fill slots with data — text slots take strings, image/video slots take
+ *  src URLs. Unknown slot names throw; partial application is allowed. */
+interface ApplyDataOperation {
+    type: 'apply_data';
+    bindings: Record<string, string>;
+}
+interface SetDocumentTitleOperation {
+    type: 'set_document_title';
+    title: string;
+}
+type SceneOperation = AddElementOperation | SetAttrsOperation | ReorderElementOperation | DeleteElementOperation | GroupElementsOperation | UngroupElementOperation | AddPageOperation | DuplicatePageOperation | DeletePageOperation | ReorderPageOperation | SetPagePropsOperation | SetPageGuidesOperation | BindSlotOperation | ApplyDataOperation | SetDocumentTitleOperation;
+interface ScenePlan {
+    summary: string;
+    operations: SceneOperation[];
+}
+type SceneOperationType = SceneOperation['type'];
+declare const SCENE_OPERATION_TYPES: readonly SceneOperationType[];
+
+/**
+ * Page size presets, channel-size output presets, and export math for the
+ * design canvas.
+ *
+ * Size presets (SizePreset / SIZE_PRESETS) describe page dimensions for the
+ * new-page dialog. Export presets (ExportPreset / EXPORT_PRESETS) pin pixel
+ * ratio, output dimensions, bleed, and format for the export dialog and the
+ * MCP export tool. Channel presets (ChannelPreset / CHANNEL_PRESETS) are the
+ * fixed output resolutions the export UI offers; `scaleForPreset` + the
+ * letterbox helper derive Konva stage parameters from them.
+ *
+ * All dimensions are CSS pixels at 96 DPI unless noted otherwise.
+ */
+
+interface SizePreset {
+    id: string;
+    label: string;
+    category: 'social' | 'print' | 'presentation' | 'custom';
+    width: number;
+    height: number;
+}
+declare const SIZE_PRESETS: readonly SizePreset[];
+declare function findPreset(id: string): SizePreset | null;
+/** Match a (width, height) pair against the preset table. Returns the first
+ *  exact match or null — used to drive the dropdown selection indicator. */
+declare function matchPreset(width: number, height: number): SizePreset | null;
+type ExportFormat = 'png' | 'jpeg';
+/**
+ * Export quality preset — pins pixel density, optional output dimensions,
+ * bleed inclusion, and raster format so callers pass a preset id rather than
+ * a full parameter bag.
+ *
+ * `outputWidth` / `outputHeight`: when non-null, the pixel ratio is derived
+ * from the crop rect width (see `scaleForPreset`) so the output is exactly
+ * this many pixels wide. When null, `pixelRatio` applies directly.
+ */
+interface ExportPreset {
+    name: string;
+    /** Target pixels-per-document-px for stage.toDataURL. */
+    pixelRatio: number;
+    outputWidth: number | null;
+    outputHeight: number | null;
+    /** Whether bleed margins are included in the crop rect. */
+    includeBleed: boolean;
+    format: ExportFormat;
+}
+declare const EXPORT_PRESETS: Record<string, ExportPreset>;
+interface ExportCropRect {
+    /** Page-coordinate origin. Negative when bleed extends outside page bounds. */
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Crop rectangle in page coordinates for a given page, optionally expanded to
+ * include bleed margins. Bleed extends OUTSIDE the page bounds, so the origin
+ * goes negative when bleed is included.
+ *
+ * When `includeBleed` is true but `page.bleed` is null, the page rect is
+ * returned unchanged — the caller must not assume symmetric expansion.
+ */
+declare function bleedAwareExportBounds(page: ScenePage, includeBleed: boolean): ExportCropRect;
+/**
+ * Pixel ratio for stage.toDataURL given a crop rect and an export preset.
+ *
+ * When the preset pins `outputWidth`, the ratio is derived from the crop rect
+ * width so the final raster is exactly that many pixels wide. When there is no
+ * output pin, the preset's declared `pixelRatio` is returned directly.
+ *
+ * The crop rect must already account for bleed inclusion before this call.
+ */
+declare function scaleForPreset(preset: ExportPreset, cropRect: ExportCropRect): number;
+interface ChannelPreset {
+    id: string;
+    label: string;
+    width: number;
+    height: number;
+}
+/**
+ * Fixed output resolution presets for the channel/platform export dialog.
+ * Width × height are OUTPUT pixels (the raster the export produces), not page
+ * CSS px — they describe the target delivery format, not the canvas layout.
+ * The a4_print_2480x3508 preset corresponds to A4 at 300 dpi.
+ */
+declare const CHANNEL_PRESETS: readonly ChannelPreset[];
+type ChannelPresetId = (typeof CHANNEL_PRESETS)[number]['id'];
+/** Throws when the id is unknown — callers should only pass ids sourced from
+ *  `CHANNEL_PRESETS`. */
+declare function requireChannelPreset(id: string): ChannelPreset;
+interface ChannelScaleResult {
+    /**
+     * Konva stage pixelRatio: the stage logical size stays at page dimensions;
+     * the backing canvas renders at `pixelRatio × page` px. Setting Konva's
+     * pixelRatio to this value yields an output canvas exactly
+     * `channelPreset.width × channelPreset.height` pixels.
+     */
+    pixelRatio: number;
+    /**
+     * Horizontal letterbox offset in PAGE-coordinate px. Add to the stage x
+     * translation so the page is centered horizontally in the output frame.
+     * Zero when the page fills the full width after scaling.
+     */
+    offsetX: number;
+    /**
+     * Vertical letterbox offset in PAGE-coordinate px. Add to the stage y
+     * translation. Zero when the page fills the full height.
+     */
+    offsetY: number;
+    fit: 'contain';
+}
+/**
+ * Computes the Konva stage parameters to render `page` centered inside
+ * `channelPreset` without cropping (contain / letterbox).
+ *
+ * Exact-ratio fast path: when page and preset share the same aspect ratio
+ * (within 1e-9 floating-point tolerance) both offsets are 0 and pixelRatio
+ * is exact.
+ *
+ * Example — 1080×1080 page into 1920×1080 preset:
+ *   scaleX = 1920/1080 ≈ 1.7778, scaleY = 1080/1080 = 1.0
+ *   pixelRatio = 1.0, rendered page = 1080×1080 px
+ *   offsetX = (1920 − 1080) / 2 / 1.0 = 420 page-px, offsetY = 0
+ */
+declare function scalePageForChannelPreset(page: Pick<ScenePage, 'width' | 'height'>, channelPreset: ChannelPreset): ChannelScaleResult;
+/**
+ * Export rectangle in page coordinates that includes bleed margins when
+ * present. When `page.bleed` is null, returns the trim rectangle (origin 0,0;
+ * size = page dimensions).
+ *
+ * The bleed rectangle extends OUTSIDE the page: x and y are negative (bleed
+ * bleeds off the left/top edge), width and height exceed the page by the
+ * combined bleed on each axis. Pass into Konva's clip/export bounds to
+ * include the bleed zone in the render.
+ *
+ * Named `bleedAwareExportRect` to avoid collision with the two-arg
+ * `bleedAwareExportBounds(page, includeBleed)` above.
+ */
+declare function bleedAwareExportRect(page: Pick<ScenePage, 'width' | 'height' | 'bleed'>): Bounds;
+
+export { type AddElementOperation as A, type BindSlotOperation as B, CHANNEL_PRESETS as C, type DeleteElementOperation as D, EXPORT_PRESETS as E, scaleForPreset as F, type GroupElementsOperation as G, scalePageForChannelPreset as H, type ReorderElementOperation as R, SCENE_OPERATION_TYPES as S, type UngroupElementOperation as U, type AddPageOperation as a, type ApplyDataOperation as b, type ChannelPreset as c, type ChannelPresetId as d, type ChannelScaleResult as e, type DeletePageOperation as f, type DuplicatePageOperation as g, type ExportCropRect as h, type ExportFormat as i, type ExportPreset as j, type ReorderPageOperation as k, SIZE_PRESETS as l, type SceneAttrsPatch as m, type SceneOperation as n, type SceneOperationType as o, type ScenePlan as p, type SetAttrsOperation as q, type SetDocumentTitleOperation as r, type SetPageGuidesOperation as s, type SetPagePropsOperation as t, type SizePreset as u, bleedAwareExportBounds as v, bleedAwareExportRect as w, findPreset as x, matchPreset as y, requireChannelPreset as z };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { AppToolRuntimeExecutor, CapabilityTokenOptions, DispatchOptions, ExpiringCapabilityTokenOptions, HandleToolRequestOptions, RuntimeExecutorOptions, ToolInputError, createAppToolRuntimeExecutor, createCapabilityToken, createExpiringCapabilityToken, dispatchAppTool, handleAppToolRequest, outcomeStatus, verifyCapabilityToken, verifyExpiringCapabilityToken } from './tools/index.js';
 export { A as APP_TOOL_NAMES, a as AppToolMcpServer, b as AppToolName, c as AuthenticateOptions, B as BuildHttpMcpServerOptions, d as BuildMcpServerOptions, D as DEFAULT_APP_TOOL_PATHS, e as DEFAULT_HEADER_NAMES, O as OpenAIFunctionTool, T as ToolAuthResult, f as ToolHeaderNames, g as authenticateToolRequest, h as buildAppToolMcpServer, i as buildAppToolOpenAITools, j as buildHttpMcpServer, k as isAppToolName, r as readToolArgs } from './mcp-CIupfjxV.js';
+export { C as CreateMcpToolHandlerOptions, M as MCP_PROTOCOL_VERSIONS, a as McpProtocolVersion, b as McpServerInfo, c as McpToolDefinition, d as createMcpToolHandler } from './mcp-rpc-DLw_r9PQ.js';
 export { A as AddCitationArgs, a as AddCitationResult, b as AppToolContext, c as AppToolHandlers, d as AppToolOutcome, e as AppToolProducedEvent, f as AppToolTaxonomy, R as RenderUiArgs, g as RenderUiResult, S as ScheduleFollowupArgs, h as ScheduleFollowupResult, i as SubmitProposalArgs, j as SubmitProposalResult } from './types-By4B3K37.js';
 export { BuildDelegationOptions, DELEGATION_MCP_SERVER_KEY, DELEGATION_TOOLS, DelegationMcpServer, buildDelegationMcpServer, delegationMcpForConfig } from './delegation/index.js';
 export { BrokerToken, BrokerTokenMinter, BrokerTokenProvider, BrokerTokenProviderOptions, ConsentUrlInput, buildConsentUrl, createBrokerTokenProvider } from './tangle/index.js';
@@ -23,6 +24,10 @@ export { DistributionSummary, FlowSpan, FlowTrace, LoopTraceEventLike, MissionFl
 export { M as MIN_SEQUENCE_CLIP_FRAMES, N as NewSequenceClip, a as NewSequenceDecision, b as NewSequenceTrack, S as SequenceClip, c as SequenceClipMedia, d as SequenceClipPatch, e as SequenceDecision, f as SequenceExportFormat, g as SequenceExportRecord, h as SequenceExportStatus, i as SequenceFrameSnapshot, j as SequenceMediaKind, k as SequenceMeta, l as SequenceStatus, m as SequenceStore, n as SequenceStoreScope, o as SequenceTimeline, p as SequenceTrack, q as SequenceTrackKind, T as TimelineClipBounds, r as TimelineInterval, s as assertClipFitsSequence, t as chooseCaptionPlacement, u as clampClipDuration, v as clampClipStart, w as formatSeconds, x as formatTimecode, y as framesToSeconds, z as secondsToFrames, A as snapshotFrame, B as trackIntervals } from './store-gckrNq-g.js';
 export { A as AddCaptionOperation, C as CaptionTargetResolution, a as CreateTrackOperation, D as DeleteClipOperation, E as ExtendSequenceOperation, M as MoveClipOperation, P as PlaceClipOperation, Q as QueueExportOperation, S as SEQUENCE_OPERATION_TYPES, b as SequenceApplyResult, c as SequenceOperation, d as SequenceOperationContext, e as SequenceOperationType, f as SequencePlan, g as SetClipDisabledOperation, h as SetClipTextOperation, i as SplitClipOperation, T as TrimClipOperation, j as applySequenceOperation, k as applySequenceOperations, l as assertSequenceMediaUrl, m as captionTrackNameForLanguage, n as lastClipEndFrame, p as parseSequenceOperations, r as resolveCaptionPlacement, o as resolveCaptionTarget, q as resolvePlaceClipTrack, v as validateAddCaption, s as validateCreateTrack, t as validateDeleteClip, u as validateExtendSequence, w as validateMoveClip, x as validatePlaceClip, y as validateQueueExport, z as validateSequenceOperation, B as validateSequenceOperations, F as validateSetClipDisabled, G as validateSetClipText, H as validateSplitClip, I as validateTrimClip } from './apply-Cp8c3K9D.js';
 export { BuildCaptionChunksOptions, BuildSequencesMcpServerEntryOptions, CaptionChunk, CaptionCoverageEntry, CaptionExportOptions, ContactSheetEntry, ContactSheetManifest, CreateSequencesMcpHandlerOptions, DEFAULT_SEQUENCES_MCP_DESCRIPTION, LanguageFanoutOptions, MAX_CAPTION_BATCH, OtioClip, OtioExternalReference, OtioGap, OtioMissingReference, OtioRationalTime, OtioStack, OtioTimeRange, OtioTimeline, OtioTrack, SEQUENCES_MCP_PROTOCOL_VERSIONS, SEQUENCE_EXPORT_FORMATS, SEQUENCE_MCP_TOOLS, SEQUENCE_MEDIA_KINDS, SEQUENCE_TRACK_KINDS, SequenceMcpToolDefinition, SequenceMcpToolEnv, SequencesMcpServerInfo, TranscriptSegment, buildCaptionChunks, buildContactSheetManifest, buildEdl, buildOtio, buildSequencesMcpServerEntry, buildSrt, buildVtt, captionCoverage, createSequencesMcpHandler, findSequenceMcpTool, normalizeLanguageTag, planLanguageFanout } from './sequences/index.js';
+export { B as Bounds, E as EllipseElement, G as GroupElement, I as ImageElement, L as LineElement, N as NewPageOptions, P as PageBleed, a as PageGuides, R as RectElement, S as SCENE_ELEMENT_KINDS, b as SCENE_SCHEMA_VERSION, c as SceneDocument, d as SceneElement, e as SceneElementBase, f as SceneElementKind, g as ScenePage, h as SceneSettings, T as TextElement, V as VideoElement, i as assertColor, j as assertFinite, k as assertPositiveFinite, l as assertSceneMediaSrc, m as boundsIntersect, n as collectSlots, o as createEmptyDocument, p as createPage, q as elementAabb, r as elementExtent, s as estimateTextHeight, t as findElement, u as requireElement, v as requirePage } from './model-BHLN208Z.js';
+export { A as AddElementOperation, a as AddPageOperation, b as ApplyDataOperation, B as BindSlotOperation, C as CHANNEL_PRESETS, c as ChannelPreset, d as ChannelPresetId, e as ChannelScaleResult, D as DeleteElementOperation, f as DeletePageOperation, g as DuplicatePageOperation, E as EXPORT_PRESETS, h as ExportCropRect, i as ExportFormat, j as ExportPreset, G as GroupElementsOperation, R as ReorderElementOperation, k as ReorderPageOperation, S as SCENE_OPERATION_TYPES, l as SIZE_PRESETS, m as SceneAttrsPatch, n as SceneOperation, o as SceneOperationType, p as ScenePlan, q as SetAttrsOperation, r as SetDocumentTitleOperation, s as SetPageGuidesOperation, t as SetPagePropsOperation, u as SizePreset, U as UngroupElementOperation, v as bleedAwareExportBounds, w as bleedAwareExportRect, x as findPreset, y as matchPreset, z as requireChannelPreset, F as scaleForPreset, H as scalePageForChannelPreset } from './export-presets-Dl5Aa5xj.js';
+export { N as NewSceneDecision, S as SceneDecision, a as SceneDocumentRecord, b as SceneExportFormat, c as SceneExportRecord, d as SceneStore, e as SceneStoreScope } from './store-CUStmtdH.js';
+export { ApplySceneOptions, BuildDesignCanvasMcpServerEntryOptions, CANVAS_ELEMENT_KINDS, CANVAS_MCP_TOOLS, CANVAS_MCP_TOOL_NAMES, CreateDesignCanvasMcpHandlerOptions, DEFAULT_DESIGN_CANVAS_MCP_DESCRIPTION, DesignCanvasMcpServerInfo, DesignCanvasMcpToolEnv, InstantiateOptions, SceneApplyResult, SlotFillKind, TemplateSlot, applyBindingsToDocument, applySceneOperation, applySceneOperations, buildDesignCanvasMcpServerEntry, createDesignCanvasMcpHandler, findCanvasMcpTool, instantiateTemplate, listTemplateSlots, storeApplyScenePlan, validateBindings, validateSceneOperation, validateSceneOperations, validateSlotValue } from './design-canvas/index.js';
 export { C as CatalogModel, M as ModelCatalog, R as RouterModel, _ as __resetCatalogCache, b as buildCatalog, f as fetchModelCatalog, n as normalizeModelId } from './model-catalog-BEAEVDaa.js';
 export { CompletionRequirement, CompletionVerdict, CorrectnessChecker, ProducedState, RuntimeEventLike, SatisfiedBy, TaskGold, createLlmCorrectnessChecker, extractProducedState, verifyCompletion, weightedComposite } from '@tangle-network/agent-eval';
 export { C as CreateTangleRouterModelConfigOptions, D as DEFAULT_TANGLE_BILLING_ENFORCEMENT_ENV_VAR, a as DEFAULT_TANGLE_ROUTER_BASE_URL, R as ResolveModelOptions, b as ResolveUserTangleExecutionKeyForUserOptions, c as ResolveUserTangleExecutionKeyOptions, d as ResolvedTangleExecutionKey, T as TangleBillingEnforcementOptions, e as TangleExecutionEnvironment, f as TangleExecutionKeyError, g as TangleExecutionKeyErrorCode, h as TangleExecutionKeyHttpError, i as TangleExecutionKeySource, j as TangleModelConfig, k as createTangleRouterModelConfig, l as isTangleBillingEnforcementDisabled, m as isTangleExecutionKeyError, r as resolveTangleExecutionEnvironment, n as resolveTangleModelConfig, o as resolveUserTangleExecutionKey, p as resolveUserTangleExecutionKeyForUser, t as tangleExecutionKeyHttpError } from './model-CKzniMMr.js';

package/dist/index.js

@@ -41,7 +41,21 @@ import {
   validateSetClipText,
   validateSplitClip,
   validateTrimClip
-} from "./chunk-3WAJWYKD.js";
+} from "./chunk-6UOE5CTA.js";
+import {
+  CANVAS_ELEMENT_KINDS,
+  CANVAS_MCP_TOOLS,
+  CANVAS_MCP_TOOL_NAMES,
+  DEFAULT_DESIGN_CANVAS_MCP_DESCRIPTION,
+  SCENE_OPERATION_TYPES,
+  applyBindingsToDocument,
+  buildDesignCanvasMcpServerEntry,
+  createDesignCanvasMcpHandler,
+  findCanvasMcpTool,
+  instantiateTemplate,
+  listTemplateSlots,
+  validateBindings
+} from "./chunk-7QCIYDGC.js";
 import {
   MIN_SEQUENCE_CLIP_FRAMES,
   assertClipFitsSequence,
@@ -55,6 +69,40 @@ import {
   snapshotFrame,
   trackIntervals
 } from "./chunk-ZYBWGSAZ.js";
+import {
+  CHANNEL_PRESETS,
+  EXPORT_PRESETS,
+  SCENE_ELEMENT_KINDS,
+  SCENE_SCHEMA_VERSION,
+  SIZE_PRESETS,
+  applySceneOperation,
+  applySceneOperations,
+  assertColor,
+  assertFinite,
+  assertPositiveFinite,
+  assertSceneMediaSrc,
+  bleedAwareExportBounds,
+  bleedAwareExportRect,
+  boundsIntersect,
+  collectSlots,
+  createEmptyDocument,
+  createPage,
+  elementAabb,
+  elementExtent,
+  estimateTextHeight,
+  findElement,
+  findPreset,
+  matchPreset,
+  requireChannelPreset,
+  requireElement,
+  requirePage,
+  scaleForPreset,
+  scalePageForChannelPreset,
+  storeApplyScenePlan,
+  validateSceneOperation,
+  validateSceneOperations,
+  validateSlotValue
+} from "./chunk-JZAJE3JL.js";
 import {
   DEFAULT_MISSION_STEP_KINDS,
   MISSION_CONTROL_CHANNEL_ID,
@@ -199,15 +247,17 @@ import {
   handleAppToolRequest,
   verifyCapabilityToken,
   verifyExpiringCapabilityToken
-} from "./chunk-CF5DZELC.js";
+} from "./chunk-ABGSFUJQ.js";
 import {
   DEFAULT_APP_TOOL_PATHS,
   DEFAULT_HEADER_NAMES,
+  MCP_PROTOCOL_VERSIONS,
   authenticateToolRequest,
   buildAppToolMcpServer,
   buildHttpMcpServer,
+  createMcpToolHandler,
   readToolArgs
-} from "./chunk-IJZJWKUK.js";
+} from "./chunk-A76ZHWNF.js";
 import {
   DELEGATION_MCP_SERVER_KEY,
   DELEGATION_TOOLS,
@@ -270,9 +320,14 @@ export {
   APP_TOOL_NAMES,
   ApprovalEventSchema,
   BrandTokensSchema,
+  CANVAS_ELEMENT_KINDS,
+  CANVAS_MCP_TOOLS,
+  CANVAS_MCP_TOOL_NAMES,
+  CHANNEL_PRESETS,
   ConversionMetricsSchema,
   CopyContentSchema,
   DEFAULT_APP_TOOL_PATHS,
+  DEFAULT_DESIGN_CANVAS_MCP_DESCRIPTION,
   DEFAULT_HARNESS,
   DEFAULT_HEADER_NAMES,
   DEFAULT_MISSION_STEP_KINDS,
@@ -282,23 +337,29 @@ export {
   DEFAULT_TANGLE_ROUTER_BASE_URL,
   DELEGATION_MCP_SERVER_KEY,
   DELEGATION_TOOLS,
+  EXPORT_PRESETS,
   EmailContentSchema,
   HubExecClient,
   ImageContentSchema,
   KNOWN_HARNESSES,
   MAX_CAPTION_BATCH,
+  MCP_PROTOCOL_VERSIONS,
   MIN_SEQUENCE_CLIP_FRAMES,
   MISSION_CONTROL_CHANNEL_ID,
   MissionConcurrencyError,
   PRESET_MIGRATION_SQL,
   PRESET_TABLES,
   RetryableStepError,
+  SCENE_ELEMENT_KINDS,
+  SCENE_OPERATION_TYPES,
+  SCENE_SCHEMA_VERSION,
   SEQUENCES_MCP_PROTOCOL_VERSIONS,
   SEQUENCE_EXPORT_FORMATS,
   SEQUENCE_MCP_TOOLS,
   SEQUENCE_MEDIA_KINDS,
   SEQUENCE_OPERATION_TYPES,
   SEQUENCE_TRACK_KINDS,
+  SIZE_PRESETS,
   TURN_EVENTS_MIGRATION_SQL,
   TangleExecutionKeyError,
   ToolInputError,
@@ -306,15 +367,25 @@ export {
   __resetCatalogCache,
   addSecurityHeaders,
   agentAppConfigJsonSchema,
+  applyBindingsToDocument,
   applyMissionEvent,
+  applySceneOperation,
+  applySceneOperations,
   applySequenceOperation,
   applySequenceOperations,
   asMissionStreamEvent,
   asRecord,
   asString,
   assertClipFitsSequence,
+  assertColor,
+  assertFinite,
+  assertPositiveFinite,
+  assertSceneMediaSrc,
   assertSequenceMediaUrl,
   authenticateToolRequest,
+  bleedAwareExportBounds,
+  bleedAwareExportRect,
+  boundsIntersect,
   budgetGateProposalId,
   buildAgentMissionPlan,
   buildAppToolMcpServer,
@@ -324,6 +395,7 @@ export {
   buildConsentUrl,
   buildContactSheetManifest,
   buildDelegationMcpServer,
+  buildDesignCanvasMcpServerEntry,
   buildEdl,
   buildFlowTrace,
   buildHttpMcpServer,
@@ -344,6 +416,7 @@ export {
   clearCookieHeader,
   coalesceDeltas,
   coerceHarness,
+  collectSlots,
   composeMissionFlowTrace,
   createAgentRuntime,
   createAppToolRuntimeExecutor,
@@ -351,16 +424,20 @@ export {
   createCapabilityToken,
   createD1KnowledgeStateAccessor,
   createD1TurnEventStore,
+  createDesignCanvasMcpHandler,
+  createEmptyDocument,
   createExpiringCapabilityToken,
   createFieldCrypto,
   createInMemoryMissionStore,
   createKnowledgeLoop,
   createLlmCorrectnessChecker,
+  createMcpToolHandler,
   createMemoryTurnEventStore,
   createMissionEngine,
   createMissionService,
   createMissionTraceContext,
   createOpenAICompatStreamTurn,
+  createPage,
   createPlatformBalanceManager,
   createPresetDrizzleSchema,
   createPresetFieldCrypto,
@@ -386,20 +463,27 @@ export {
   deriveSignals,
   detectSpans,
   dispatchAppTool,
+  elementAabb,
+  elementExtent,
   encodeEvent,
   encryptAesGcm,
   encryptBytes,
   encryptWithKey,
+  estimateTextHeight,
   extractProducedState,
   extractRequestContext,
   fetchModelCatalog,
   finalizeAssistantParts,
+  findCanvasMcpTool,
+  findElement,
+  findPreset,
   findSequenceMcpTool,
   formatSeconds,
   formatTimecode,
   framesToSeconds,
   getPartKey,
   handleAppToolRequest,
+  instantiateTemplate,
   invokeIntegrationHub,
   isAppToolName,
   isHarness,
@@ -408,8 +492,10 @@ export {
   isTangleBillingEnforcementDisabled,
   isTangleExecutionKeyError,
   lastClipEndFrame,
+  listTemplateSlots,
   loopTraceEventsToFlowSpans,
   maskSpans,
+  matchPreset,
   mergeMissionState,
   mergePersistedPart,
   mergeSurfaceOverlay,
@@ -437,6 +523,9 @@ export {
   renderHistogram,
   renderWaterfall,
   replayTurnEvents,
+  requireChannelPreset,
+  requireElement,
+  requirePage,
   requireString,
   resolveCaptionPlacement,
   resolveCaptionTarget,
@@ -454,12 +543,15 @@ export {
   reviewCandidate,
   runAppToolLoop,
   safeParseAssetSpec,
+  scaleForPreset,
+  scalePageForChannelPreset,
   secondsToFrames,
   serializeCookie,
   snapshotFrame,
   stepActivityFlowTrace,
   stepAgentActivity,
   stepGateProposalId,
+  storeApplyScenePlan,
   streamAppToolLoop,
   summarize,
   tangleExecutionKeyHttpError,
@@ -468,16 +560,20 @@ export {
   traceEnv,
   trackIntervals,
   validateAddCaption,
+  validateBindings,
   validateCreateTrack,
   validateDeleteClip,
   validateExtendSequence,
   validateMoveClip,
   validatePlaceClip,
   validateQueueExport,
+  validateSceneOperation,
+  validateSceneOperations,
   validateSequenceOperation,
   validateSequenceOperations,
   validateSetClipDisabled,
   validateSetClipText,
+  validateSlotValue,
   validateSplitClip,
   validateTrimClip,
   verifyCapabilityToken,

package/dist/mcp-rpc-DLw_r9PQ.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Generic streamable-HTTP JSON-RPC 2.0 envelope for a tools-only MCP server.
+ * Stateless, Workers-compatible: no session table, no SSE — every request gets
+ * a single `application/json` response, which the streamable-HTTP transport
+ * explicitly permits for tools-only servers.
+ *
+ * Protocol surface:
+ *   initialize   → echo client's protocolVersion if supported, else latest
+ *   ping         → empty result {}
+ *   notifications/* (no `id`)  → 202 with no body
+ *   tools/list   → tool manifest
+ *   tools/call   → run + surface execution failures as isError text results
+ *   anything else → -32601
+ *
+ * Execution failures (argument shape, validation, store throws) become `isError`
+ * tool results carrying the thrown message verbatim — the model reads WHY and
+ * retries. Protocol misuse becomes a JSON-RPC error object.
+ */
+declare const MCP_PROTOCOL_VERSIONS: readonly ["2025-06-18", "2025-03-26", "2024-11-05"];
+type McpProtocolVersion = (typeof MCP_PROTOCOL_VERSIONS)[number];
+interface McpServerInfo {
+    name: string;
+    version: string;
+}
+/** One tool entry in the registry the handler owns. */
+interface McpToolDefinition<TEnv = Record<string, never>> {
+    name: string;
+    description: string;
+    /** JSON Schema for the `params.arguments` object. */
+    inputSchema: Record<string, unknown>;
+    /** Receive validated (Record) args + the env the handler threaded; throw to
+     *  surface an isError result — never throw for protocol/framing issues. */
+    run(args: Record<string, unknown>, env: TEnv): Promise<unknown>;
+}
+interface CreateMcpToolHandlerOptions<TEnv = Record<string, never>> {
+    serverInfo: McpServerInfo;
+    /** Full tool list; order IS the tools/list order. */
+    tools: McpToolDefinition<TEnv>[];
+    /** Per-request environment threaded into every `run` call. If your tools are
+     *  stateless (or carry state through closure) pass an empty builder:
+     *  `() => ({} as TEnv)`. */
+    buildEnv(request: Request): TEnv | Promise<TEnv>;
+}
+/**
+ * Build a request handler for a tools-only MCP server. The returned function
+ * accepts a standard `Request` and resolves to a `Response` — mount it on any
+ * Cloudflare Worker route or Remix `loader`.
+ *
+ * The handler calls `buildEnv` exactly ONCE per `tools/call` request (after
+ * the tool is found, before `run`) — non-`tools/call` paths skip it entirely
+ * so metadata requests do not pay env-build cost.
+ */
+declare function createMcpToolHandler<TEnv = Record<string, never>>(opts: CreateMcpToolHandlerOptions<TEnv>): (request: Request) => Promise<Response>;
+
+export { type CreateMcpToolHandlerOptions as C, MCP_PROTOCOL_VERSIONS as M, type McpProtocolVersion as a, type McpServerInfo as b, type McpToolDefinition as c, createMcpToolHandler as d };