@tangle-network/agent-app 0.11.1 → 0.13.0

package/dist/index.js

@@ -1,3 +1,108 @@
+import {
+  DEFAULT_SEQUENCES_MCP_DESCRIPTION,
+  MAX_CAPTION_BATCH,
+  SEQUENCES_MCP_PROTOCOL_VERSIONS,
+  SEQUENCE_EXPORT_FORMATS,
+  SEQUENCE_MCP_TOOLS,
+  SEQUENCE_MEDIA_KINDS,
+  SEQUENCE_OPERATION_TYPES,
+  SEQUENCE_TRACK_KINDS,
+  applySequenceOperation,
+  applySequenceOperations,
+  assertSequenceMediaUrl,
+  buildCaptionChunks,
+  buildContactSheetManifest,
+  buildEdl,
+  buildOtio,
+  buildSequencesMcpServerEntry,
+  buildSrt,
+  buildVtt,
+  captionCoverage,
+  captionTrackNameForLanguage,
+  createSequencesMcpHandler,
+  findSequenceMcpTool,
+  lastClipEndFrame,
+  normalizeLanguageTag,
+  parseSequenceOperations,
+  planLanguageFanout,
+  resolveCaptionPlacement,
+  resolveCaptionTarget,
+  resolvePlaceClipTrack,
+  validateAddCaption,
+  validateCreateTrack,
+  validateDeleteClip,
+  validateExtendSequence,
+  validateMoveClip,
+  validatePlaceClip,
+  validateQueueExport,
+  validateSequenceOperation,
+  validateSequenceOperations,
+  validateSetClipDisabled,
+  validateSetClipText,
+  validateSplitClip,
+  validateTrimClip
+} 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,
+  chooseCaptionPlacement,
+  clampClipDuration,
+  clampClipStart,
+  formatSeconds,
+  formatTimecode,
+  framesToSeconds,
+  secondsToFrames,
+  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,
@@ -136,17 +241,23 @@ import {
   invokeIntegrationHub,
   resolveIntegrationAction
 } from "./chunk-L2TG5DBW.js";
+import {
+  createCapabilityToken,
+  createExpiringCapabilityToken,
+  handleAppToolRequest,
+  verifyCapabilityToken,
+  verifyExpiringCapabilityToken
+} from "./chunk-ABGSFUJQ.js";
 import {
   DEFAULT_APP_TOOL_PATHS,
   DEFAULT_HEADER_NAMES,
+  MCP_PROTOCOL_VERSIONS,
   authenticateToolRequest,
   buildAppToolMcpServer,
   buildHttpMcpServer,
-  createCapabilityToken,
-  handleAppToolRequest,
-  readToolArgs,
-  verifyCapabilityToken
-} from "./chunk-OLCVUGGI.js";
+  createMcpToolHandler,
+  readToolArgs
+} from "./chunk-A76ZHWNF.js";
 import {
   DELEGATION_MCP_SERVER_KEY,
   DELEGATION_TOOLS,
@@ -162,12 +273,15 @@ import {
   buildCatalog,
   createAgentRuntime,
   createOpenAICompatStreamTurn,
+  createSurfaceRegistry,
+  defineSurfaceKind,
   fetchModelCatalog,
+  mergeSurfaceOverlay,
   normalizeModelId,
   runAppToolLoop,
   streamAppToolLoop,
   toLoopEvents
-} from "./chunk-4YTWB5MG.js";
+} from "./chunk-ETX4O4BB.js";
 import {
   DEFAULT_TANGLE_BILLING_ENFORCEMENT_ENV_VAR,
   DEFAULT_TANGLE_ROUTER_BASE_URL,
@@ -206,26 +320,46 @@ 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,
   DEFAULT_REDACTION_PATTERNS,
+  DEFAULT_SEQUENCES_MCP_DESCRIPTION,
   DEFAULT_TANGLE_BILLING_ENFORCEMENT_ENV_VAR,
   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,
@@ -233,28 +367,56 @@ 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,
   buildAppToolOpenAITools,
+  buildCaptionChunks,
   buildCatalog,
   buildConsentUrl,
+  buildContactSheetManifest,
   buildDelegationMcpServer,
+  buildDesignCanvasMcpServerEntry,
+  buildEdl,
   buildFlowTrace,
   buildHttpMcpServer,
   buildKnowledgeRequirements,
+  buildOtio,
   buildRedactedDocument,
+  buildSequencesMcpServerEntry,
+  buildSrt,
   buildUserTextParts,
+  buildVtt,
+  captionCoverage,
+  captionTrackNameForLanguage,
   checkRateLimit,
   childSpanContext,
+  chooseCaptionPlacement,
+  clampClipDuration,
+  clampClipStart,
   clearCookieHeader,
   coalesceDeltas,
   coerceHarness,
+  collectSlots,
   composeMissionFlowTrace,
   createAgentRuntime,
   createAppToolRuntimeExecutor,
@@ -262,15 +424,20 @@ export {
   createCapabilityToken,
   createD1KnowledgeStateAccessor,
   createD1TurnEventStore,
+  createDesignCanvasMcpHandler,
+  createEmptyDocument,
+  createExpiringCapabilityToken,
   createFieldCrypto,
   createInMemoryMissionStore,
   createKnowledgeLoop,
   createLlmCorrectnessChecker,
+  createMcpToolHandler,
   createMemoryTurnEventStore,
   createMissionEngine,
   createMissionService,
   createMissionTraceContext,
   createOpenAICompatStreamTurn,
+  createPage,
   createPlatformBalanceManager,
   createPresetDrizzleSchema,
   createPresetFieldCrypto,
@@ -278,6 +445,8 @@ export {
   createPresetWorkspaceKeyManager,
   createPresetWorkspaceKeyStore,
   createReviewerDecider,
+  createSequencesMcpHandler,
+  createSurfaceRegistry,
   createTangleRouterModelConfig,
   createTcloudKeyProvisioner,
   createTokenRecallChecker,
@@ -287,22 +456,34 @@ export {
   decryptBytes,
   decryptWithKey,
   defineAgentApp,
+  defineSurfaceKind,
   delegationActivityToFlowSpans,
   delegationMcpForConfig,
   deriveKey,
   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,
@@ -310,13 +491,18 @@ export {
   isMissionTerminal,
   isTangleBillingEnforcementDisabled,
   isTangleExecutionKeyError,
+  lastClipEndFrame,
+  listTemplateSlots,
   loopTraceEventsToFlowSpans,
   maskSpans,
+  matchPreset,
   mergeMissionState,
   mergePersistedPart,
+  mergeSurfaceOverlay,
   messageHasTurnId,
   noopEventSink,
   normalizeClientTurnId,
+  normalizeLanguageTag,
   normalizeModelId,
   normalizePersistedPart,
   normalizeTime,
@@ -325,7 +511,9 @@ export {
   parseAssetSpec,
   parseJsonObjectBody,
   parseMissionBlocks,
+  parseSequenceOperations,
   parseSessionStreamEnvelope,
+  planLanguageFanout,
   producedFromToolEvents,
   pumpBufferedTurn,
   readCookieValue,
@@ -335,9 +523,15 @@ export {
   renderHistogram,
   renderWaterfall,
   replayTurnEvents,
+  requireChannelPreset,
+  requireElement,
+  requirePage,
   requireString,
+  resolveCaptionPlacement,
+  resolveCaptionTarget,
   resolveChatTurn,
   resolveIntegrationAction,
+  resolvePlaceClipTrack,
   resolveSessionHarness,
   resolveTangleExecutionEnvironment,
   resolveTangleModelConfig,
@@ -349,18 +543,42 @@ export {
   reviewCandidate,
   runAppToolLoop,
   safeParseAssetSpec,
+  scaleForPreset,
+  scalePageForChannelPreset,
+  secondsToFrames,
   serializeCookie,
+  snapshotFrame,
   stepActivityFlowTrace,
   stepAgentActivity,
   stepGateProposalId,
+  storeApplyScenePlan,
   streamAppToolLoop,
   summarize,
   tangleExecutionKeyHttpError,
   timedEventsFromLines,
   toLoopEvents,
   traceEnv,
+  trackIntervals,
+  validateAddCaption,
+  validateBindings,
+  validateCreateTrack,
+  validateDeleteClip,
+  validateExtendSequence,
+  validateMoveClip,
+  validatePlaceClip,
+  validateQueueExport,
+  validateSceneOperation,
+  validateSceneOperations,
+  validateSequenceOperation,
+  validateSequenceOperations,
+  validateSetClipDisabled,
+  validateSetClipText,
+  validateSlotValue,
+  validateSplitClip,
+  validateTrimClip,
   verifyCapabilityToken,
   verifyCompletion,
+  verifyExpiringCapabilityToken,
   volumeGateProposalId,
   weightedComposite
 };

package/dist/mcp-CIupfjxV.d.ts

@@ -0,0 +1,112 @@
+import { f as AppToolTaxonomy, b as AppToolContext } from './types-By4B3K37.js';
+
+/** The four canonical app-tool names. Stable identifiers the model calls in
+ *  both the sandbox (MCP server name) and runtime (function-tool name) paths. */
+declare const APP_TOOL_NAMES: readonly ["submit_proposal", "schedule_followup", "render_ui", "add_citation"];
+type AppToolName = (typeof APP_TOOL_NAMES)[number];
+declare function isAppToolName(name: string): name is AppToolName;
+/** A minimal OpenAI Chat Completions function-tool shape — structurally
+ *  compatible with `@tangle-network/agent-runtime`'s `OpenAIChatTool` without
+ *  importing it (keeps this package runtime-free). */
+interface OpenAIFunctionTool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/**
+ * Build the four app tools in OpenAI function-tool shape. `submit_proposal`'s
+ * `type` enum is the product's {@link AppToolTaxonomy.proposalTypes}; the other
+ * three are fixed. Pass the result to the agent-runtime backend's `tools`.
+ */
+declare function buildAppToolOpenAITools(taxonomy: AppToolTaxonomy): OpenAIFunctionTool[];
+
+/**
+ * Header names carrying the server-set per-turn context + the capability token.
+ * Defaults are product-neutral (`X-Agent-App-*`); a product that already ships
+ * a header convention (e.g. `X-Acme-User-Id`) passes its own.
+ */
+interface ToolHeaderNames {
+    userId: string;
+    workspaceId: string;
+    threadId: string;
+}
+declare const DEFAULT_HEADER_NAMES: ToolHeaderNames;
+interface AuthenticateOptions {
+    /** Verify the bearer capability token belongs to `userId`. The product's
+     *  HMAC/JWT impl — the seam that keeps token crypto out of this package. */
+    verifyToken: (userId: string, bearer: string) => Promise<boolean>;
+    headerNames?: ToolHeaderNames;
+}
+type ToolAuthResult = {
+    ok: true;
+    ctx: AppToolContext;
+} | {
+    ok: false;
+    response: Response;
+};
+/**
+ * Recover + verify the trusted context for a tool request. The user comes from
+ * a server-set header and the bearer token MUST verify against THAT user; the
+ * workspace comes from a header too — never from tool args — so the model can
+ * neither forge identity nor target another workspace. Fail-closed: any missing
+ * credential or a token minted for another user yields a 401/400 Response.
+ */
+declare function authenticateToolRequest(request: Request, opts: AuthenticateOptions): Promise<ToolAuthResult>;
+/** Read a tool's argument object from the request body, tolerant of MCP host
+ *  aliases (`args` / `arguments`) or a bare body. Returns null on non-JSON. */
+declare function readToolArgs<T>(request: Request): Promise<T | null>;
+
+/** Default route path each app tool is served at. A product mounts its routes
+ *  at these paths (or supplies its own via {@link BuildMcpServerOptions.paths}). */
+declare const DEFAULT_APP_TOOL_PATHS: Record<AppToolName, string>;
+/** The portable MCP server entry the sandbox SDK accepts (transport + url +
+ *  headers). Matches `AgentProfileMcpServer` structurally without importing the
+ *  sandbox SDK — products spread it into their profile's `mcp` map. */
+interface AppToolMcpServer {
+    transport: 'http';
+    url: string;
+    headers: Record<string, string>;
+    enabled: true;
+    metadata: {
+        description: string;
+    };
+}
+interface BuildHttpMcpServerOptions {
+    /** Route path on the app the sandbox POSTs to (e.g. `/api/tools/propose`). */
+    path: string;
+    /** App base URL the sandbox reaches back to (no trailing slash required). */
+    baseUrl: string;
+    /** Per-user capability token, baked into the Authorization header. */
+    token: string;
+    ctx: AppToolContext;
+    /** Tool description the model sees. */
+    description: string;
+    headerNames?: ToolHeaderNames;
+}
+/**
+ * Build ONE HTTP MCP server entry — the generic agent→app bridge. The
+ * capability token + the user/workspace/thread ids ride in server-set headers
+ * (never tool args), so the model can't forge identity or target another
+ * workspace. Workspace/thread headers are omitted when their `ctx` value is
+ * empty/null (e.g. an integration-invoke bridge that's user-scoped only). Used
+ * directly for non-app-tool bridges (integration_invoke) and via
+ * {@link buildAppToolMcpServer} for the four app tools.
+ */
+declare function buildHttpMcpServer(opts: BuildHttpMcpServerOptions): AppToolMcpServer;
+interface BuildMcpServerOptions {
+    tool: AppToolName;
+    baseUrl: string;
+    token: string;
+    ctx: AppToolContext;
+    description: string;
+    headerNames?: ToolHeaderNames;
+    paths?: Partial<Record<AppToolName, string>>;
+}
+/** Build one of the four app-tool MCP servers — a thin wrapper over
+ *  {@link buildHttpMcpServer} that maps the tool name to its route path. */
+declare function buildAppToolMcpServer(opts: BuildMcpServerOptions): AppToolMcpServer;
+
+export { APP_TOOL_NAMES as A, type BuildHttpMcpServerOptions as B, DEFAULT_APP_TOOL_PATHS as D, type OpenAIFunctionTool as O, type ToolAuthResult as T, type AppToolMcpServer as a, type AppToolName as b, type AuthenticateOptions as c, type BuildMcpServerOptions as d, DEFAULT_HEADER_NAMES as e, type ToolHeaderNames as f, authenticateToolRequest as g, buildAppToolMcpServer as h, buildAppToolOpenAITools as i, buildHttpMcpServer as j, isAppToolName as k, readToolArgs as r };

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 };