@tangle-network/agent-app 0.40.0 → 0.41.0

package/dist/{chunk-2FDTJIU4.js → chunk-WFMUDX5J.js}

@@ -9,7 +9,7 @@ import {
 import {
   buildScopedMcpServerEntry,
   createMcpToolHandler
-} from "./chunk-RH74YJIK.js";
+} from "./chunk-7EVZUIHW.js";
 
 // src/design-canvas/operations.ts
 var SCENE_OPERATION_TYPES = [
@@ -1089,4 +1089,4 @@ export {
   DEFAULT_DESIGN_CANVAS_MCP_DESCRIPTION,
   buildDesignCanvasMcpServerEntry
 };
-//# sourceMappingURL=chunk-2FDTJIU4.js.map
+//# sourceMappingURL=chunk-WFMUDX5J.js.map

package/dist/design-canvas/index.d.ts

@@ -6,9 +6,9 @@ import { d as SceneStore, N as NewSceneDecision, a as SceneDocumentRecord } from
 export { S as SceneDecision, b as SceneExportFormat, c as SceneExportRecord, e as SceneStoreScope } from '../store-CFyxgTlD.js';
 export { C as CHANNEL_PRESETS, a as ChannelPreset, b as ChannelPresetId, c as ChannelScaleResult, E as EXPORT_PRESETS, d as ExportCropRect, e as ExportFormat, f as ExportPreset, S as SIZE_PRESETS, g as SizePreset, h as bleedAwareExportBounds, i as bleedAwareExportRect, j as findPreset, m as matchPreset, r as requireChannelPreset, s as scaleForPreset, k as scalePageForChannelPreset } from '../export-presets-DAsU5Wal.js';
 import { c as McpToolDefinition } from '../mcp-rpc-DLw_r9PQ.js';
-import { S as ScopedMcpServerEntryOptions, A as AppToolMcpServer } from '../mcp-4I_RHhNa.js';
-import '../types-wHs0rmtu.js';
-import '../auth-DcK5ERaL.js';
+import { S as ScopedMcpServerEntryOptions, A as AppToolMcpServer } from '../mcp-BHfIoGLW.js';
+import '../types-BEOvc_ue.js';
+import '../auth-DuptSkWh.js';
 
 /**
  * Pre-write validation for scene operations. Every rule runs against a

package/dist/design-canvas/index.js

@@ -11,7 +11,7 @@ import {
   instantiateTemplate,
   listTemplateSlots,
   validateBindings
-} from "../chunk-2FDTJIU4.js";
+} from "../chunk-WFMUDX5J.js";
 import {
   CHANNEL_PRESETS,
   EXPORT_PRESETS,
@@ -47,7 +47,7 @@ import {
   validateSlotValue
 } from "../chunk-M2EBUDZ7.js";
 import "../chunk-HFC4BTWJ.js";
-import "../chunk-RH74YJIK.js";
+import "../chunk-7EVZUIHW.js";
 export {
   CANVAS_ELEMENT_KINDS,
   CANVAS_MCP_TOOLS,

package/dist/eval/index.d.ts

@@ -1,6 +1,6 @@
 import { CompletionRequirement, RuntimeEventLike } from '@tangle-network/agent-eval';
 export { CompletionRequirement, CompletionVerdict, CorrectnessChecker, ProducedState, RuntimeEventLike, SatisfiedBy, TaskGold, createLlmCorrectnessChecker, extractProducedState, verifyCompletion, weightedComposite } from '@tangle-network/agent-eval';
-import { e as AppToolProducedEvent } from '../types-wHs0rmtu.js';
+import { h as AppToolProducedEvent } from '../types-BEOvc_ue.js';
 
 /**
  * Eval — the app-shell BRIDGE to `@tangle-network/agent-eval`, not a reimpl.

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { AppToolRuntimeExecutor, CapabilityTokenOptions, DispatchOptions, ExpiringCapabilityTokenOptions, HandleToolRequestOptions, ResolveToolCapabilitiesOptions, ResolvedToolCapabilities, RuntimeExecutorOptions, ToolCapability, ToolInputError, createAppToolRuntimeExecutor, createCapabilityToken, createExpiringCapabilityToken, dispatchAppTool, handleAppToolRequest, outcomeStatus, resolveToolCapabilities, restrictTaxonomy, verifyCapabilityToken, verifyExpiringCapabilityToken } from './tools/index.js';
-export { A as APP_TOOL_NAMES, a as AppToolName, b as AuthenticateOptions, D as DEFAULT_HEADER_NAMES, O as OpenAIFunctionTool, T as ToolAuthResult, c as ToolHeaderNames, d as authenticateToolRequest, e as buildAppToolOpenAITools, i as isAppToolName, r as readToolArgs } from './auth-DcK5ERaL.js';
-export { A as AppToolMcpServer, B as BuildHttpMcpServerOptions, a as BuildMcpServerOptions, D as DEFAULT_APP_TOOL_PATHS, S as ScopedMcpServerEntryOptions, b as buildAppToolMcpServer, c as buildHttpMcpServer, d as buildScopedMcpServerEntry } from './mcp-4I_RHhNa.js';
+export { A as AuthenticateOptions, D as DEFAULT_HEADER_NAMES, T as ToolAuthResult, a as ToolHeaderNames, b as authenticateToolRequest, r as readToolArgs } from './auth-DuptSkWh.js';
+export { A as APP_TOOL_NAMES, a as AddCitationArgs, b as AddCitationResult, c as AppToolContext, d as AppToolDefinition, e as AppToolHandlers, f as AppToolName, g as AppToolOutcome, h as AppToolProducedEvent, i as AppToolTaxonomy, B as BuildAppToolsOptions, O as OpenAIFunctionTool, R as RenderUiArgs, j as RenderUiResult, S as ScheduleFollowupArgs, k as ScheduleFollowupResult, l as SubmitProposalArgs, m as SubmitProposalResult, n as buildAppToolOpenAITools, o as customToolToOpenAI, p as defineAppTool, q as findCustomTool, r as isAppToolName } from './types-BEOvc_ue.js';
+export { A as AppToolMcpServer, B as BuildHttpMcpServerOptions, a as BuildMcpServerOptions, D as DEFAULT_APP_TOOL_PATHS, S as ScopedMcpServerEntryOptions, b as buildAppToolMcpServer, c as buildHttpMcpServer, d as buildScopedMcpServerEntry } from './mcp-BHfIoGLW.js';
 export { C as CreateMcpToolHandlerOptions, M as MCP_PROTOCOL_VERSIONS, a as McpProtocolVersion, b as McpServerInfo, c as McpToolDefinition, M as SEQUENCES_MCP_PROTOCOL_VERSIONS, 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, B as BuildAppToolsOptions, R as RenderUiArgs, g as RenderUiResult, S as ScheduleFollowupArgs, h as ScheduleFollowupResult, i as SubmitProposalArgs, j as SubmitProposalResult } from './types-wHs0rmtu.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';
 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';
@@ -16,7 +16,7 @@ export { AgentAppConfig, AgentDelegationConfig, AgentIdentityConfig, AgentIntegr
 export { D1Like, D1PreparedLike, DrizzleColumnLike, DrizzleSqliteCoreLike, PRESET_MIGRATION_SQL, PRESET_TABLES, PresetBillingOptions, PresetKnowledgeAccessorOptions, PresetToolHandlerOptions, VaultKv, createD1KnowledgeStateAccessor, createPresetDrizzleSchema, createPresetFieldCrypto, createPresetToolHandlers, createPresetWorkspaceKeyManager, createPresetWorkspaceKeyStore } from './preset-cloudflare/index.js';
 export { KeyCrypto, KeyProvisioner, PlanLimit, PlatformBalanceInfo, PlatformBalanceManager, PlatformBalanceManagerOptions, PlatformBillingClient, PlatformIdentity, PlatformProductUsage, SharedBillingState, TcloudKeyClient, WorkspaceKeyManager, WorkspaceKeyManagerOptions, WorkspaceKeyRecord, WorkspaceKeyStore, WorkspaceModelKeyUsage, createPlatformBalanceManager, createTcloudKeyProvisioner, createWorkspaceKeyManager } from './billing/index.js';
 export { DeriveKeyOptions, createFieldCrypto, decodeHexKey, decryptAesGcm, decryptBytes, decryptWithKey, deriveKey, encryptAesGcm, encryptBytes, encryptWithKey } from './crypto/index.js';
-export { BufferedTurnEvent, D1LikeForTurns, JsonRecord, PersistedChatMessageForTurn, PumpBufferedTurnOptions, ReplayTurnEventsOptions, ResolvedChatTurn, StreamEvent, TURN_EVENTS_MIGRATION_SQL, TurnEventStore, TurnStatus, asRecord, asString, buildUserTextParts, coalesceDeltas, createD1TurnEventStore, createMemoryTurnEventStore, encodeEvent, finalizeAssistantParts, getPartKey, mergePersistedPart, messageHasTurnId, normalizeClientTurnId, normalizePersistedPart, normalizeTime, normalizeToolEvent, pumpBufferedTurn, replayTurnEvents, resolveChatTurn, resolveToolId, resolveToolName } from './stream/index.js';
+export { BufferedTurnEvent, D1LikeForTurns, JsonRecord, PersistedChatMessageForTurn, PumpBufferedTurnOptions, ReplayTurnEventsOptions, ResolvedChatTurn, StreamEvent, TURN_EVENTS_MIGRATION_SQL, TURN_STATUS_SCOPE_MIGRATION_SQL, TurnEventStore, TurnStatus, asRecord, asString, buildUserTextParts, coalesceChatStreamEvents, coalesceDeltas, createD1TurnEventStore, createMemoryTurnEventStore, encodeEvent, finalizeAssistantParts, getPartKey, mergePersistedPart, messageHasTurnId, normalizeClientTurnId, normalizePersistedPart, normalizeTime, normalizeToolEvent, pumpBufferedTurn, replayTurnEvents, resolveChatTurn, resolveToolId, resolveToolName } from './stream/index.js';
 export { HubExecClient, HubExecClientOptions, HubExecErrorCode, HubExecResult, HubInvokeDeps, HubInvokeInput, HubInvokeOutcome, ParsedIntegrationAction, invokeIntegrationHub, resolveIntegrationAction } from './integrations/index.js';
 export { CompleteMissionInput, CreateMissionInput, DEFAULT_MISSION_STEP_KINDS, InMemoryMissionStore, MISSION_CONTROL_CHANNEL_ID, MissionApprovalsPort, MissionAuditEvent, MissionConcurrencyError, MissionCostLedger, MissionEngine, MissionEngineOptions, MissionEventSink, MissionGateKind, MissionGateOptions, MissionGateProposal, MissionOutcome, MissionPlanRunOptions, MissionProposalResolution, MissionRecord, MissionService, MissionServiceOptions, MissionState, MissionStatus, MissionStep, MissionStepState, MissionStepStatus, MissionStorePort, MissionStreamEvent, MissionStreamStatus, MissionStreamStep, MissionStreamStepStatus, MissionUpdateGuard, MissionUpdatePatch, ParseMissionBlocksOptions, ParsedMission, ParsedMissionStep, PlanOutcome, RetryableStepError, SandboxDispatch, SandboxDispatchDoneResult, SandboxDispatchInProgressResult, SandboxDispatchInput, SandboxDispatchResult, SetStepStatusPatch, StepGateClassification, StepOutcome, applyMissionEvent, asMissionStreamEvent, budgetGateProposalId, buildAgentMissionPlan, createInMemoryMissionStore, createMissionEngine, createMissionService, isMissionStopRequested, isMissionTerminal, mergeMissionState, noopEventSink, parseMissionBlocks, parseSessionStreamEnvelope, reduceMissionEvents, stepGateProposalId, volumeGateProposalId } from './missions/index.js';
 export { S as StepAgentActivity, W as WithAgentActivity, s as stepAgentActivity } from './agent-activity-C8ZG0F0M.js';

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   instantiateTemplate,
   listTemplateSlots,
   validateBindings
-} from "./chunk-2FDTJIU4.js";
+} from "./chunk-WFMUDX5J.js";
 import {
   darkTheme,
   lightTheme,
@@ -130,7 +130,7 @@ import {
   validateSetClipText,
   validateSplitClip,
   validateTrimClip
-} from "./chunk-BUUJ7TEQ.js";
+} from "./chunk-NEOV2NQ3.js";
 import {
   MIN_SEQUENCE_CLIP_FRAMES,
   assertClipFitsSequence,
@@ -176,9 +176,11 @@ import {
 } from "./chunk-TA5Q4I2K.js";
 import {
   TURN_EVENTS_MIGRATION_SQL,
+  TURN_STATUS_SCOPE_MIGRATION_SQL,
   asRecord,
   asString,
   buildUserTextParts,
+  coalesceChatStreamEvents,
   coalesceDeltas,
   createD1TurnEventStore,
   createMemoryTurnEventStore,
@@ -196,7 +198,7 @@ import {
   resolveChatTurn,
   resolveToolId,
   resolveToolName
-} from "./chunk-CPI3RILI.js";
+} from "./chunk-ULZEF45E.js";
 import {
   HubExecClient,
   invokeIntegrationHub,
@@ -290,7 +292,7 @@ import {
   verifySandboxTerminalToken,
   verifyTerminalProxyToken,
   writeProfileFilesToBox
-} from "./chunk-DBIG2PHS.js";
+} from "./chunk-IZAH45W2.js";
 import {
   DEFAULT_HARNESS,
   HARNESS_MODEL_POLICIES,
@@ -313,7 +315,7 @@ import {
   restrictTaxonomy,
   verifyCapabilityToken,
   verifyExpiringCapabilityToken
-} from "./chunk-FDJ6JQCI.js";
+} from "./chunk-3II3AWHY.js";
 import {
   DEFAULT_APP_TOOL_PATHS,
   DEFAULT_HEADER_NAMES,
@@ -324,7 +326,7 @@ import {
   buildScopedMcpServerEntry,
   createMcpToolHandler,
   readToolArgs
-} from "./chunk-RH74YJIK.js";
+} from "./chunk-7EVZUIHW.js";
 import {
   DELEGATION_MCP_SERVER_KEY,
   DELEGATION_TOOLS,
@@ -349,7 +351,7 @@ import {
   runToolLoop,
   streamToolLoop,
   toLoopEvents
-} from "./chunk-TQ5M7BFV.js";
+} from "./chunk-2A7STBX7.js";
 import {
   DEFAULT_TANGLE_BILLING_ENFORCEMENT_ENV_VAR,
   DEFAULT_TANGLE_ROUTER_BASE_URL,
@@ -370,10 +372,13 @@ import {
   ToolInputError,
   buildAppToolOpenAITools,
   createAppToolRuntimeExecutor,
+  customToolToOpenAI,
+  defineAppTool,
   dispatchAppTool,
+  findCustomTool,
   isAppToolName,
   outcomeStatus
-} from "./chunk-PPSZNVKT.js";
+} from "./chunk-MFRCM32T.js";
 import {
   createLlmCorrectnessChecker,
   createTokenRecallChecker,
@@ -435,6 +440,7 @@ export {
   SIZE_PRESETS,
   SandboxRuntimeAuthRefreshError,
   TURN_EVENTS_MIGRATION_SQL,
+  TURN_STATUS_SCOPE_MIGRATION_SQL,
   TangleExecutionKeyError,
   ToolInputError,
   VideoContentSchema,
@@ -499,6 +505,7 @@ export {
   clampClipStart,
   classifySeveredStream,
   clearCookieHeader,
+  coalesceChatStreamEvents,
   coalesceDeltas,
   coerceHarness,
   collectSlots,
@@ -542,12 +549,14 @@ export {
   createWorkspaceSandboxManager,
   createWorkspaceSandboxRuntimeProxyHandler,
   createWorkspaceSandboxTerminalUpgradeHandler,
+  customToolToOpenAI,
   darkTheme,
   decodeHexKey,
   decryptAesGcm,
   decryptBytes,
   decryptWithKey,
   defineAgentApp,
+  defineAppTool,
   defineSurfaceKind,
   delegationActivityToFlowSpans,
   delegationMcpForConfig,
@@ -572,6 +581,7 @@ export {
   fetchModelCatalog,
   finalizeAssistantParts,
   findCanvasMcpTool,
+  findCustomTool,
   findElement,
   findPreset,
   findSequenceMcpTool,

package/dist/{mcp-4I_RHhNa.d.ts → mcp-BHfIoGLW.d.ts}

@@ -1,5 +1,5 @@
-import { b as AppToolContext } from './types-wHs0rmtu.js';
-import { c as ToolHeaderNames, a as AppToolName } from './auth-DcK5ERaL.js';
+import { c as AppToolContext, f as AppToolName, d as AppToolDefinition } from './types-BEOvc_ue.js';
+import { a as ToolHeaderNames } from './auth-DuptSkWh.js';
 
 /** 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}). */
@@ -74,16 +74,20 @@ declare function buildScopedMcpServerEntry(opts: ScopedMcpServerEntryOptions & {
     defaultDescription: string;
 }): AppToolMcpServer;
 interface BuildMcpServerOptions {
-    tool: AppToolName;
+    /** A built-in app tool name, or a product-registered {@link AppToolDefinition}.
+     *  A custom tool supplies its route via `AppToolDefinition.path` (or `paths`). */
+    tool: AppToolName | AppToolDefinition;
     baseUrl: string;
     token: string;
     ctx: AppToolContext;
     description: string;
     headerNames?: ToolHeaderNames;
-    paths?: Partial<Record<AppToolName, string>>;
+    paths?: Partial<Record<string, 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. */
+/** Build one app-tool MCP server entry — a thin wrapper over
+ *  {@link buildHttpMcpServer} that resolves the tool's route path. Built-ins map
+ *  through {@link DEFAULT_APP_TOOL_PATHS}; a custom tool uses its own `path`
+ *  (or a `paths` override). */
 declare function buildAppToolMcpServer(opts: BuildMcpServerOptions): AppToolMcpServer;
 
 export { type AppToolMcpServer as A, type BuildHttpMcpServerOptions as B, DEFAULT_APP_TOOL_PATHS as D, type ScopedMcpServerEntryOptions as S, type BuildMcpServerOptions as a, buildAppToolMcpServer as b, buildHttpMcpServer as c, buildScopedMcpServerEntry as d };

package/dist/preset-cloudflare/index.d.ts

@@ -1,6 +1,6 @@
 import { KeyProvisioner, KeyCrypto, WorkspaceKeyManager, WorkspaceKeyStore } from '../billing/index.js';
 import { KnowledgeStateAccessor } from '../knowledge/index.js';
-import { c as AppToolHandlers } from '../types-wHs0rmtu.js';
+import { e as AppToolHandlers } from '../types-BEOvc_ue.js';
 import { KvLike } from '../web/index.js';
 import '@tangle-network/agent-eval';
 

package/dist/runtime/index.d.ts

@@ -3,10 +3,10 @@ export { C as CreateTangleRouterModelConfigOptions, D as DEFAULT_TANGLE_BILLING_
 import * as _tangle_network_agent_runtime from '@tangle-network/agent-runtime';
 import { ToolLoopMessage, ToolLoopResult, StreamToolLoopYield, ToolLoopCall } from '@tangle-network/agent-runtime';
 export { RunToolLoopOptions as AppToolLoopOptions, ToolLoopAssistantToolCall as LoopAssistantToolCall, ToolLoopMessage as LoopMessage, ToolLoopCall as LoopToolCall, StreamToolLoopOptions as StreamAppToolLoopOptions, StreamToolLoopYield as StreamLoopYield, ToolLoopEvent, ToolLoopResult, ToolLoopStopReason, runToolLoop as runAppToolLoop, streamToolLoop as streamAppToolLoop } from '@tangle-network/agent-runtime';
-import { b as AppToolContext, e as AppToolProducedEvent, f as AppToolTaxonomy, c as AppToolHandlers, d as AppToolOutcome } from '../types-wHs0rmtu.js';
+import { c as AppToolContext, h as AppToolProducedEvent, i as AppToolTaxonomy, e as AppToolHandlers, g as AppToolOutcome } from '../types-BEOvc_ue.js';
 import { CertifiedProfile } from '@tangle-network/agent-runtime/intelligence';
-import { A as AppToolMcpServer } from '../mcp-4I_RHhNa.js';
-import '../auth-DcK5ERaL.js';
+import { A as AppToolMcpServer } from '../mcp-BHfIoGLW.js';
+import '../auth-DuptSkWh.js';
 
 /**
  * Events the app's OpenAI-compat stream adapter ({@link toLoopEvents}) yields.

package/dist/runtime/index.js

@@ -12,7 +12,7 @@ import {
   runToolLoop,
   streamToolLoop,
   toLoopEvents
-} from "../chunk-TQ5M7BFV.js";
+} from "../chunk-2A7STBX7.js";
 import {
   DEFAULT_TANGLE_BILLING_ENFORCEMENT_ENV_VAR,
   DEFAULT_TANGLE_ROUTER_BASE_URL,
@@ -28,7 +28,7 @@ import {
   tangleExecutionKeyHttpError,
   trimOrNull
 } from "../chunk-7W5XSTUF.js";
-import "../chunk-PPSZNVKT.js";
+import "../chunk-MFRCM32T.js";
 export {
   DEFAULT_TANGLE_BILLING_ENFORCEMENT_ENV_VAR,
   DEFAULT_TANGLE_ROUTER_BASE_URL,

package/dist/sandbox/index.d.ts

@@ -1,7 +1,7 @@
 import { AgentProfileFileMount, AgentProfileMcpServer, AgentProfile, StorageConfig, SandboxInstance, ScopedTokenScope, PromptResult, Sandbox } from '@tangle-network/sandbox';
 export { StorageConfig } from '@tangle-network/sandbox';
-import { a as AppToolName, c as ToolHeaderNames } from '../auth-DcK5ERaL.js';
-import { b as AppToolContext } from '../types-wHs0rmtu.js';
+import { a as ToolHeaderNames } from '../auth-DuptSkWh.js';
+import { f as AppToolName, c as AppToolContext } from '../types-BEOvc_ue.js';
 import { Harness } from '../harness/index.js';
 import { f as TangleExecutionEnvironment } from '../model-dF2h4xT9.js';
 

package/dist/sandbox/index.js

@@ -47,12 +47,12 @@ import {
   verifySandboxTerminalToken,
   verifyTerminalProxyToken,
   writeProfileFilesToBox
-} from "../chunk-DBIG2PHS.js";
+} from "../chunk-IZAH45W2.js";
 import "../chunk-5VXPDXZJ.js";
-import "../chunk-FDJ6JQCI.js";
-import "../chunk-RH74YJIK.js";
+import "../chunk-3II3AWHY.js";
+import "../chunk-7EVZUIHW.js";
 import "../chunk-7W5XSTUF.js";
-import "../chunk-PPSZNVKT.js";
+import "../chunk-MFRCM32T.js";
 export {
   DEFAULT_SANDBOX_RESOURCES,
   SandboxRuntimeAuthRefreshError,

package/dist/sequences/index.d.ts

@@ -1,10 +1,10 @@
 import { j as SequenceMediaKind, o as SequenceTimeline, r as TimelineInterval, m as SequenceStore } from '../store-gckrNq-g.js';
 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, k as SequenceMeta, l as SequenceStatus, n as SequenceStoreScope, p as SequenceTrack, q as SequenceTrackKind, T as TimelineClipBounds, 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-Gk4raT2j.js';
-import { S as ScopedMcpServerEntryOptions, A as AppToolMcpServer } from '../mcp-4I_RHhNa.js';
+import { S as ScopedMcpServerEntryOptions, A as AppToolMcpServer } from '../mcp-BHfIoGLW.js';
 export { M as SEQUENCES_MCP_PROTOCOL_VERSIONS } from '../mcp-rpc-DLw_r9PQ.js';
-import '../types-wHs0rmtu.js';
-import '../auth-DcK5ERaL.js';
+import '../types-BEOvc_ue.js';
+import '../auth-DuptSkWh.js';
 
 /**
  * Pure interchange-format builders over `SequenceTimeline` — SRT, WebVTT,

package/dist/sequences/index.js

@@ -40,7 +40,7 @@ import {
   validateSetClipText,
   validateSplitClip,
   validateTrimClip
-} from "../chunk-BUUJ7TEQ.js";
+} from "../chunk-NEOV2NQ3.js";
 import {
   MIN_SEQUENCE_CLIP_FRAMES,
   assertClipFitsSequence,
@@ -57,7 +57,7 @@ import {
 import "../chunk-HFC4BTWJ.js";
 import {
   MCP_PROTOCOL_VERSIONS
-} from "../chunk-RH74YJIK.js";
+} from "../chunk-7EVZUIHW.js";
 export {
   DEFAULT_SEQUENCES_MCP_DESCRIPTION,
   MAX_CAPTION_BATCH,

package/dist/stream/index.d.ts

@@ -62,13 +62,35 @@ interface BufferedTurnEvent {
 interface TurnEventStore {
     append(turnId: string, events: BufferedTurnEvent[]): Promise<void>;
     read(turnId: string, fromSeq: number): Promise<BufferedTurnEvent[]>;
-    setStatus(turnId: string, status: TurnStatus): Promise<void>;
+    /** Record turn lifecycle. `scopeId` (a thread/session id) is optional and lets
+     *  {@link TurnEventStore.listRunning} rediscover this turn after a client reload
+     *  loses the turnId; stores that don't track scope ignore it. */
+    setStatus(turnId: string, status: TurnStatus, scopeId?: string): Promise<void>;
     getStatus(turnId: string): Promise<TurnStatus | null>;
+    /** Running turnIds for a scope, newest first — so a reloaded client (clientRunId
+     *  lost) can find and resume the in-flight turn. Optional: a store records it
+     *  only if `setStatus` was given a `scopeId`. */
+    listRunning?(scopeId: string): Promise<string[]>;
 }
 /** Merge consecutive text/reasoning deltas of the same type into one event.
  *  Concatenation-preserving: replaying the coalesced stream produces the same
  *  accumulated text as the original. */
 declare function coalesceDeltas(events: unknown[]): unknown[];
+/**
+ * Coalesce consecutive `message.part.updated` deltas for the SAME part into one
+ * event. agent-runtime products stream `ChatStreamEvent` NDJSON
+ * (`{type:'message.part.updated', data:{part, delta}}`); pumped through the
+ * buffer with the default tool-loop coalescer, every per-token delta persists as
+ * its own row because that coalescer never recognizes the shape. Pass this as
+ * {@link PumpBufferedTurnOptions.coalesce} instead.
+ *
+ * Concatenation-preserving for BOTH consumer styles: the merged event keeps the
+ * LATEST event's `data.part` (already the cumulative accumulation) and sets
+ * `data.delta` to the concatenation of the merged deltas, so a client that
+ * appends `delta` and one that reads the cumulative `part` both reconstruct the
+ * identical final text.
+ */
+declare function coalesceChatStreamEvents(events: unknown[]): unknown[];
 interface PumpBufferedTurnOptions {
     source: AsyncIterable<unknown>;
     store: TurnEventStore;
@@ -78,6 +100,14 @@ interface PumpBufferedTurnOptions {
     write?: (line: string) => Promise<void> | void;
     /** Flush buffered events to the store at most this often. Default 400ms. */
     flushIntervalMs?: number;
+    /** Per-flush coalescer. Default {@link coalesceDeltas} (tool-loop text/reasoning
+     *  deltas). agent-runtime products streaming `ChatStreamEvent` pass
+     *  {@link coalesceChatStreamEvents} so per-token deltas don't each persist as a
+     *  row. Must be concatenation-preserving. */
+    coalesce?: (events: unknown[]) => unknown[];
+    /** Optional scope (thread/session id) recorded with the turn status, so
+     *  {@link TurnEventStore.listRunning} can find this turn after a reload. */
+    scopeId?: string;
 }
 /**
  * Drive a turn to completion regardless of the live client: every source
@@ -118,9 +148,13 @@ interface D1LikeForTurns {
     };
 }
 /** Schema for the D1 store — append to the product's migrations. */
-declare const TURN_EVENTS_MIGRATION_SQL = "\nCREATE TABLE IF NOT EXISTS turn_events (\n  turnId TEXT NOT NULL,\n  seq INTEGER NOT NULL,\n  event TEXT NOT NULL,\n  PRIMARY KEY (turnId, seq)\n);\nCREATE TABLE IF NOT EXISTS turn_status (\n  turnId TEXT PRIMARY KEY,\n  status TEXT NOT NULL,\n  updatedAt TEXT NOT NULL\n);\n";
+declare const TURN_EVENTS_MIGRATION_SQL = "\nCREATE TABLE IF NOT EXISTS turn_events (\n  turnId TEXT NOT NULL,\n  seq INTEGER NOT NULL,\n  event TEXT NOT NULL,\n  PRIMARY KEY (turnId, seq)\n);\nCREATE TABLE IF NOT EXISTS turn_status (\n  turnId TEXT PRIMARY KEY,\n  status TEXT NOT NULL,\n  scopeId TEXT,\n  updatedAt TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS idx_turn_status_scope ON turn_status (scopeId, status);\n";
+/** For deployments whose `turn_status` table predates `scopeId`/`listRunning` —
+ *  run once to add the column (the CREATE above already includes it for new
+ *  deployments). SQLite ignores a duplicate-add error if already applied. */
+declare const TURN_STATUS_SCOPE_MIGRATION_SQL = "ALTER TABLE turn_status ADD COLUMN scopeId TEXT;";
 declare function createD1TurnEventStore(db: D1LikeForTurns): TurnEventStore;
 /** In-memory store for tests and keyless local dev. */
 declare function createMemoryTurnEventStore(): TurnEventStore;
 
-export { type BufferedTurnEvent, type D1LikeForTurns, type JsonRecord, type PersistedChatMessageForTurn, type PumpBufferedTurnOptions, type ReplayTurnEventsOptions, type ResolvedChatTurn, type StreamEvent, TURN_EVENTS_MIGRATION_SQL, type TurnEventStore, type TurnStatus, asRecord, asString, buildUserTextParts, coalesceDeltas, createD1TurnEventStore, createMemoryTurnEventStore, encodeEvent, finalizeAssistantParts, getPartKey, mergePersistedPart, messageHasTurnId, normalizeClientTurnId, normalizePersistedPart, normalizeTime, normalizeToolEvent, pumpBufferedTurn, replayTurnEvents, resolveChatTurn, resolveToolId, resolveToolName };
+export { type BufferedTurnEvent, type D1LikeForTurns, type JsonRecord, type PersistedChatMessageForTurn, type PumpBufferedTurnOptions, type ReplayTurnEventsOptions, type ResolvedChatTurn, type StreamEvent, TURN_EVENTS_MIGRATION_SQL, TURN_STATUS_SCOPE_MIGRATION_SQL, type TurnEventStore, type TurnStatus, asRecord, asString, buildUserTextParts, coalesceChatStreamEvents, coalesceDeltas, createD1TurnEventStore, createMemoryTurnEventStore, encodeEvent, finalizeAssistantParts, getPartKey, mergePersistedPart, messageHasTurnId, normalizeClientTurnId, normalizePersistedPart, normalizeTime, normalizeToolEvent, pumpBufferedTurn, replayTurnEvents, resolveChatTurn, resolveToolId, resolveToolName };

package/dist/stream/index.js

@@ -1,8 +1,10 @@
 import {
   TURN_EVENTS_MIGRATION_SQL,
+  TURN_STATUS_SCOPE_MIGRATION_SQL,
   asRecord,
   asString,
   buildUserTextParts,
+  coalesceChatStreamEvents,
   coalesceDeltas,
   createD1TurnEventStore,
   createMemoryTurnEventStore,
@@ -20,12 +22,14 @@ import {
   resolveChatTurn,
   resolveToolId,
   resolveToolName
-} from "../chunk-CPI3RILI.js";
+} from "../chunk-ULZEF45E.js";
 export {
   TURN_EVENTS_MIGRATION_SQL,
+  TURN_STATUS_SCOPE_MIGRATION_SQL,
   asRecord,
   asString,
   buildUserTextParts,
+  coalesceChatStreamEvents,
   coalesceDeltas,
   createD1TurnEventStore,
   createMemoryTurnEventStore,

package/dist/tools/index.d.ts

@@ -1,8 +1,8 @@
-import { a as AppToolName, c as ToolHeaderNames } from '../auth-DcK5ERaL.js';
-export { A as APP_TOOL_NAMES, b as AuthenticateOptions, D as DEFAULT_HEADER_NAMES, O as OpenAIFunctionTool, T as ToolAuthResult, d as authenticateToolRequest, e as buildAppToolOpenAITools, i as isAppToolName, r as readToolArgs } from '../auth-DcK5ERaL.js';
-import { f as AppToolTaxonomy, c as AppToolHandlers, b as AppToolContext, e as AppToolProducedEvent, d as AppToolOutcome } from '../types-wHs0rmtu.js';
-export { A as AddCitationArgs, a as AddCitationResult, B as BuildAppToolsOptions, R as RenderUiArgs, g as RenderUiResult, S as ScheduleFollowupArgs, h as ScheduleFollowupResult, i as SubmitProposalArgs, j as SubmitProposalResult } from '../types-wHs0rmtu.js';
-export { A as AppToolMcpServer, B as BuildHttpMcpServerOptions, a as BuildMcpServerOptions, D as DEFAULT_APP_TOOL_PATHS, S as ScopedMcpServerEntryOptions, b as buildAppToolMcpServer, c as buildHttpMcpServer, d as buildScopedMcpServerEntry } from '../mcp-4I_RHhNa.js';
+import { a as ToolHeaderNames } from '../auth-DuptSkWh.js';
+export { A as AuthenticateOptions, D as DEFAULT_HEADER_NAMES, T as ToolAuthResult, b as authenticateToolRequest, r as readToolArgs } from '../auth-DuptSkWh.js';
+import { i as AppToolTaxonomy, e as AppToolHandlers, d as AppToolDefinition, c as AppToolContext, h as AppToolProducedEvent, g as AppToolOutcome, f as AppToolName } from '../types-BEOvc_ue.js';
+export { A as APP_TOOL_NAMES, a as AddCitationArgs, b as AddCitationResult, B as BuildAppToolsOptions, O as OpenAIFunctionTool, R as RenderUiArgs, j as RenderUiResult, S as ScheduleFollowupArgs, k as ScheduleFollowupResult, l as SubmitProposalArgs, m as SubmitProposalResult, n as buildAppToolOpenAITools, o as customToolToOpenAI, p as defineAppTool, q as findCustomTool, r as isAppToolName } from '../types-BEOvc_ue.js';
+export { A as AppToolMcpServer, B as BuildHttpMcpServerOptions, a as BuildMcpServerOptions, D as DEFAULT_APP_TOOL_PATHS, S as ScopedMcpServerEntryOptions, b as buildAppToolMcpServer, c as buildHttpMcpServer, d as buildScopedMcpServerEntry } from '../mcp-BHfIoGLW.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';
 
 /** A correctable bad-input error a tool handler throws; the HTTP layer maps it
@@ -131,6 +131,10 @@ declare function restrictTaxonomy(taxonomy: AppToolTaxonomy, allowed: readonly s
 interface DispatchOptions {
     handlers: AppToolHandlers;
     taxonomy: AppToolTaxonomy;
+    /** Product-registered tools beyond the four built-ins. A called name that is
+     *  not a built-in is dispatched to the matching {@link AppToolDefinition.execute}
+     *  through this same validation/outcome path. */
+    customTools?: readonly AppToolDefinition[];
     /** Per-call approval policy. When provided it OVERRIDES the static
      *  `taxonomy.regulatedTypes` membership check, so products can gate by
      *  cost threshold, environment, or first-use instead of always/never.
@@ -180,8 +184,9 @@ interface RuntimeExecutorOptions extends DispatchOptions {
 declare function createAppToolRuntimeExecutor(opts: RuntimeExecutorOptions): AppToolRuntimeExecutor;
 
 interface HandleToolRequestOptions extends DispatchOptions {
-    /** Which app tool this route serves. */
-    tool: AppToolName;
+    /** Which app tool this route serves — a built-in name or a product-registered
+     *  {@link AppToolDefinition} (auto-added to `customTools` for dispatch). */
+    tool: AppToolName | AppToolDefinition;
     /** Verify the bearer capability token belongs to the header user. */
     verifyToken: (userId: string, bearer: string) => Promise<boolean>;
     headerNames?: ToolHeaderNames;
@@ -197,4 +202,4 @@ interface HandleToolRequestOptions extends DispatchOptions {
  */
 declare function handleAppToolRequest(request: Request, opts: HandleToolRequestOptions): Promise<Response>;
 
-export { AppToolContext, AppToolHandlers, AppToolName, AppToolOutcome, AppToolProducedEvent, type AppToolRuntimeExecutor, AppToolTaxonomy, type CapabilityTokenOptions, type DispatchOptions, type ExpiringCapabilityTokenOptions, type HandleToolRequestOptions, type ResolveToolCapabilitiesOptions, type ResolvedToolCapabilities, type RuntimeExecutorOptions, type ToolCapability, ToolHeaderNames, ToolInputError, createAppToolRuntimeExecutor, createCapabilityToken, createExpiringCapabilityToken, dispatchAppTool, handleAppToolRequest, outcomeStatus, resolveToolCapabilities, restrictTaxonomy, verifyCapabilityToken, verifyExpiringCapabilityToken };
+export { AppToolContext, AppToolDefinition, AppToolHandlers, AppToolName, AppToolOutcome, AppToolProducedEvent, type AppToolRuntimeExecutor, AppToolTaxonomy, type CapabilityTokenOptions, type DispatchOptions, type ExpiringCapabilityTokenOptions, type HandleToolRequestOptions, type ResolveToolCapabilitiesOptions, type ResolvedToolCapabilities, type RuntimeExecutorOptions, type ToolCapability, ToolHeaderNames, ToolInputError, createAppToolRuntimeExecutor, createCapabilityToken, createExpiringCapabilityToken, dispatchAppTool, handleAppToolRequest, outcomeStatus, resolveToolCapabilities, restrictTaxonomy, verifyCapabilityToken, verifyExpiringCapabilityToken };

package/dist/tools/index.js

@@ -6,7 +6,7 @@ import {
   restrictTaxonomy,
   verifyCapabilityToken,
   verifyExpiringCapabilityToken
-} from "../chunk-FDJ6JQCI.js";
+} from "../chunk-3II3AWHY.js";
 import {
   DEFAULT_APP_TOOL_PATHS,
   DEFAULT_HEADER_NAMES,
@@ -17,16 +17,19 @@ import {
   buildScopedMcpServerEntry,
   createMcpToolHandler,
   readToolArgs
-} from "../chunk-RH74YJIK.js";
+} from "../chunk-7EVZUIHW.js";
 import {
   APP_TOOL_NAMES,
   ToolInputError,
   buildAppToolOpenAITools,
   createAppToolRuntimeExecutor,
+  customToolToOpenAI,
+  defineAppTool,
   dispatchAppTool,
+  findCustomTool,
   isAppToolName,
   outcomeStatus
-} from "../chunk-PPSZNVKT.js";
+} from "../chunk-MFRCM32T.js";
 export {
   APP_TOOL_NAMES,
   DEFAULT_APP_TOOL_PATHS,
@@ -42,7 +45,10 @@ export {
   createCapabilityToken,
   createExpiringCapabilityToken,
   createMcpToolHandler,
+  customToolToOpenAI,
+  defineAppTool,
   dispatchAppTool,
+  findCustomTool,
   handleAppToolRequest,
   isAppToolName,
   outcomeStatus,

package/dist/{types-wHs0rmtu.d.ts → types-BEOvc_ue.d.ts}

@@ -1,3 +1,67 @@
+/** 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
+ * model-facing descriptions and the follow-up priority enum default to the
+ * Tangle reference vocabulary and can be retuned via {@link BuildAppToolsOptions}
+ * (the tool names + JSON-Schema shapes stay fixed — they are mechanism). Pass
+ * the result to the agent-runtime backend's `tools`.
+ */
+declare function buildAppToolOpenAITools(taxonomy: AppToolTaxonomy, opts?: BuildAppToolsOptions): OpenAIFunctionTool[];
+
+/**
+ * A product-defined app tool — the open registration seam.
+ *
+ * The four built-ins (`submit_proposal`/`schedule_followup`/`render_ui`/
+ * `add_citation`) are mechanism and stay hard-typed. This is how a product adds
+ * a fifth+ tool (e.g. gtm-agent's `set_config`) WITHOUT forking the shell: the
+ * `name` + JSON-Schema `parameters` are what the model sees, and `execute` is
+ * dispatched through the SAME validation/outcome path as the built-ins — a
+ * thrown {@link ToolInputError} becomes a correctable 4xx, any other throw an
+ * internal error, and a tool call never silently "succeeds" without its effect.
+ */
+interface AppToolDefinition<Args = Record<string, unknown>> {
+    /** Stable identifier the model calls (and the MCP server name). Must not
+     *  collide with a built-in app tool. */
+    name: string;
+    /** Model-facing description. */
+    description: string;
+    /** JSON-Schema for the parameters (the OpenAI `function.parameters` object). */
+    parameters: Record<string, unknown>;
+    /** Default route path the per-turn MCP server / HTTP handler is mounted at.
+     *  Overridable per call via `paths`/`buildHttpMcpServer`. */
+    path?: string;
+    /** Fulfil the call; the return value is the tool result the model sees.
+     *  `ctx` is the trusted per-turn identity (never from tool args). */
+    execute: (args: Args, ctx: AppToolContext) => Promise<unknown> | unknown;
+}
+/**
+ * Validate + brand a product tool definition. Throws when the name is empty or
+ * collides with a built-in (those are reserved mechanism). Identity otherwise —
+ * call it at module scope so a bad definition fails at boot, not first use.
+ */
+declare function defineAppTool<Args = Record<string, unknown>>(def: AppToolDefinition<Args>): AppToolDefinition<Args>;
+/** The OpenAI function-tool def for a custom tool — appended to the built-ins by
+ *  `buildAppToolOpenAITools`. */
+declare function customToolToOpenAI(def: AppToolDefinition): OpenAIFunctionTool;
+/** Find a registered custom tool by the name the model called. */
+declare function findCustomTool(name: string, tools: readonly AppToolDefinition[] | undefined): AppToolDefinition | undefined;
+
 /**
  * The structured agent→app tool side channel, domain-seamed.
  *
@@ -47,6 +111,9 @@ interface BuildAppToolsOptions {
     descriptions?: Partial<Record<'submit_proposal' | 'schedule_followup' | 'render_ui' | 'add_citation', string>>;
     /** The `schedule_followup.priority` enum (defaults to `['low','medium','high']`). */
     priorityValues?: readonly string[];
+    /** Product-registered tools to advertise to the model alongside the four
+     *  built-ins (appended in order, after the built-ins). */
+    customTools?: readonly AppToolDefinition[];
 }
 interface SubmitProposalArgs {
     type: string;
@@ -142,4 +209,4 @@ type AppToolOutcome = {
     status?: number;
 };
 
-export type { AddCitationArgs as A, BuildAppToolsOptions as B, RenderUiArgs as R, ScheduleFollowupArgs as S, AddCitationResult as a, AppToolContext as b, AppToolHandlers as c, AppToolOutcome as d, AppToolProducedEvent as e, AppToolTaxonomy as f, RenderUiResult as g, ScheduleFollowupResult as h, SubmitProposalArgs as i, SubmitProposalResult as j };
+export { APP_TOOL_NAMES as A, type BuildAppToolsOptions as B, type OpenAIFunctionTool as O, type RenderUiArgs as R, type ScheduleFollowupArgs as S, type AddCitationArgs as a, type AddCitationResult as b, type AppToolContext as c, type AppToolDefinition as d, type AppToolHandlers as e, type AppToolName as f, type AppToolOutcome as g, type AppToolProducedEvent as h, type AppToolTaxonomy as i, type RenderUiResult as j, type ScheduleFollowupResult as k, type SubmitProposalArgs as l, type SubmitProposalResult as m, buildAppToolOpenAITools as n, customToolToOpenAI as o, defineAppTool as p, findCustomTool as q, isAppToolName as r };