@tangle-network/agent-app 0.43.56 → 0.43.57

package/dist/teams-react/index.d.ts

@@ -1,5 +1,5 @@
-import { f as WorkspaceRole } from '../roles-BC1n4t37.js';
-import { c as InvitationPermission, d as InvitationStatus, b as InvitationEmailStatus } from '../invitations-CZ5G2tIn.js';
+import { f as WorkspaceRole } from '../roles-B4nU3jDi.js';
+import { c as InvitationPermission, d as InvitationStatus, b as InvitationEmailStatus } from '../invitations-DoYMvXea.js';
 import * as react from 'react';
 
 /**
@@ -22,6 +22,7 @@ interface MemberView {
     /** true = inherited org owner/admin access (managed at the org level). */
     inherited?: boolean;
 }
+/** Define properties and callbacks for managing members and their roles in a workspace panel */
 interface MembersPanelProps {
     members: MemberView[];
     /** The viewer's effective role — gates which controls are interactive. */
@@ -66,6 +67,7 @@ interface InvitationView {
     /** Shareable accept link, for copy-to-clipboard. */
     inviteUrl: string;
 }
+/** Define properties and callbacks for managing workspace invitations and user roles */
 interface InvitationsPanelProps {
     invitations: InvitationView[];
     /** The viewer's effective role — gates whether the invite controls are interactive. */
@@ -95,7 +97,9 @@ interface InvitationsPanelProps {
         message: string;
     }): void;
 }
+/** Define possible statuses for the acceptance state of an invitation */
 type InviteAcceptStatus = 'pending' | 'invalid' | 'already-accepted' | 'expired' | 'revoked';
+/** Describe details of an accepted invite including status, workspace, inviter, role, emails, and expiration */
 interface InviteAcceptDetails {
     status: InviteAcceptStatus;
     /** Workspace the invite grants access to. */
@@ -113,6 +117,7 @@ interface InviteAcceptDetails {
     /** True when the signed-in user must verify their email before they can accept. */
     needsEmailVerification?: boolean;
 }
+/** Define properties and callbacks for handling invite acceptance and navigation actions on the invite page */
 interface InviteAcceptPageProps {
     details: InviteAcceptDetails;
     /** Accept the invite; resolve with the workspace to navigate to. */

package/dist/teams-react/index.js

@@ -1,13 +1,13 @@
 import {
   MembersPanel
-} from "../chunk-GNL3MG5J.js";
+} from "../chunk-S564OFTL.js";
 import {
   InvitationsPanel
-} from "../chunk-7C64WKAH.js";
+} from "../chunk-5SXS3YAB.js";
 import {
   InviteAcceptPage
 } from "../chunk-VCPZ3HTN.js";
-import "../chunk-63CE7FEZ.js";
+import "../chunk-6XIAPIW6.js";
 export {
   InvitationsPanel,
   InviteAcceptPage,

package/dist/teams-react/lazy.d.ts

@@ -1,11 +1,14 @@
 import * as react from 'react';
 import { InvitationsPanel, InviteAcceptPage, MembersPanel } from './index.js';
 export { InvitationsPanelProps, InviteAcceptPageProps, MembersPanelProps } from './index.js';
-import '../roles-BC1n4t37.js';
-import '../invitations-CZ5G2tIn.js';
+import '../roles-B4nU3jDi.js';
+import '../invitations-DoYMvXea.js';
 
+/** Load MembersPanel component lazily to optimize initial rendering performance */
 declare const MembersPanelLazy: react.LazyExoticComponent<typeof MembersPanel>;
+/** Load InvitationsPanel component lazily to optimize initial rendering performance */
 declare const InvitationsPanelLazy: react.LazyExoticComponent<typeof InvitationsPanel>;
+/** Load InviteAcceptPage component lazily for optimized code splitting and performance */
 declare const InviteAcceptPageLazy: react.LazyExoticComponent<typeof InviteAcceptPage>;
 
 export { InvitationsPanelLazy, InviteAcceptPageLazy, MembersPanelLazy };

package/dist/teams-react/lazy.js

@@ -1,10 +1,10 @@
 // src/teams-react/lazy.tsx
 import { lazy } from "react";
 var MembersPanelLazy = lazy(
-  () => import("../MembersPanel-FOVHWUQ3.js").then((m) => ({ default: m.MembersPanel }))
+  () => import("../MembersPanel-BB4OD2KB.js").then((m) => ({ default: m.MembersPanel }))
 );
 var InvitationsPanelLazy = lazy(
-  () => import("../InvitationsPanel-XUUWZBPV.js").then((m) => ({ default: m.InvitationsPanel }))
+  () => import("../InvitationsPanel-CJ7DR4F7.js").then((m) => ({ default: m.InvitationsPanel }))
 );
 var InviteAcceptPageLazy = lazy(
   () => import("../InviteAcceptPage-P3QJC3C6.js").then((m) => ({ default: m.InviteAcceptPage }))

package/dist/teams-react/lazy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/teams-react/lazy.tsx"],"sourcesContent":["/**\n * Code-split entries for the teams React surface. Products that don't need the\n * members UI on initial load import these `React.lazy` handles instead of the\n * components directly, so the panel/page chunks load on first render. Mount\n * inside a `<Suspense>` boundary; the product provides the fallback.\n */\n\nimport { lazy } from 'react'\nimport type { MembersPanelProps, InvitationsPanelProps, InviteAcceptPageProps } from './contracts'\n\nexport type { MembersPanelProps, InvitationsPanelProps, InviteAcceptPageProps }\n\nexport const MembersPanelLazy = lazy(\n  () => import('./components/MembersPanel').then((m) => ({ default: m.MembersPanel })),\n)\n\nexport const InvitationsPanelLazy = lazy(\n  () => import('./components/InvitationsPanel').then((m) => ({ default: m.InvitationsPanel })),\n)\n\nexport const InviteAcceptPageLazy = lazy(\n  () => import('./components/InviteAcceptPage').then((m) => ({ default: m.InviteAcceptPage })),\n)\n"],"mappings":";AAOA,SAAS,YAAY;AAKd,IAAM,mBAAmB;AAAA,EAC9B,MAAM,OAAO,6BAA2B,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE;AACrF;AAEO,IAAM,uBAAuB;AAAA,EAClC,MAAM,OAAO,iCAA+B,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE;AAC7F;AAEO,IAAM,uBAAuB;AAAA,EAClC,MAAM,OAAO,iCAA+B,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE;AAC7F;","names":[]}
+{"version":3,"sources":["../../src/teams-react/lazy.tsx"],"sourcesContent":["/**\n * Code-split entries for the teams React surface. Products that don't need the\n * members UI on initial load import these `React.lazy` handles instead of the\n * components directly, so the panel/page chunks load on first render. Mount\n * inside a `<Suspense>` boundary; the product provides the fallback.\n */\n\nimport { lazy } from 'react'\nimport type { MembersPanelProps, InvitationsPanelProps, InviteAcceptPageProps } from './contracts'\n\nexport type { MembersPanelProps, InvitationsPanelProps, InviteAcceptPageProps }\n\n/** Load MembersPanel component lazily to optimize initial rendering performance */\nexport const MembersPanelLazy = lazy(\n  () => import('./components/MembersPanel').then((m) => ({ default: m.MembersPanel })),\n)\n\n/** Load InvitationsPanel component lazily to optimize initial rendering performance */\nexport const InvitationsPanelLazy = lazy(\n  () => import('./components/InvitationsPanel').then((m) => ({ default: m.InvitationsPanel })),\n)\n\n/** Load InviteAcceptPage component lazily for optimized code splitting and performance */\nexport const InviteAcceptPageLazy = lazy(\n  () => import('./components/InviteAcceptPage').then((m) => ({ default: m.InviteAcceptPage })),\n)\n"],"mappings":";AAOA,SAAS,YAAY;AAMd,IAAM,mBAAmB;AAAA,EAC9B,MAAM,OAAO,6BAA2B,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE;AACrF;AAGO,IAAM,uBAAuB;AAAA,EAClC,MAAM,OAAO,iCAA+B,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE;AAC7F;AAGO,IAAM,uBAAuB;AAAA,EAClC,MAAM,OAAO,iCAA+B,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE;AAC7F;","names":[]}

package/dist/theme/index.d.ts

@@ -66,7 +66,9 @@ interface CanvasRenderPalette {
     /** Broken/loading image placeholder stroke (ElementNode ImageNode). */
     brokenStroke: string;
 }
+/** Define a light color theme with specific background, foreground, and accent color values */
 declare const lightTheme: AgentAppTheme;
+/** Define a dark color scheme for the Agent app interface with specific background and foreground hues */
 declare const darkTheme: AgentAppTheme;
 /** Wrap a channel triple in `hsl()`; pass through values already in a color form. */
 declare function themeColor(value: string): string;

package/dist/theme/index.js

@@ -4,7 +4,7 @@ import {
   lightTheme,
   themeColor,
   themeToCssVars
-} from "../chunk-47C6PJCW.js";
+} from "../chunk-TZO3SOUL.js";
 export {
   darkTheme,
   lightTheme,

package/dist/theme/tailwind-preset.d.ts

@@ -11,6 +11,7 @@
  * design-canvas/sequences need no preset — they consume vars via arbitrary
  * values (bg-[var(--bg-input)]), which Tailwind supports without color config.
  */
+/** Define a preset configuration for dark mode and extended theme colors with foreground variants */
 declare const agentAppPreset: {
     darkMode: [string, string];
     theme: {

package/dist/theme/tailwind-preset.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/tailwind-preset.ts"],"sourcesContent":["/**\n * Tailwind preset mapping the shadcn semantic color names used by web-react\n * (bg-card, text-muted-foreground, border-border, …) onto the CSS variables in\n * tokens.css — so a consuming app themes every agent-app surface from one source.\n *\n *   // tailwind.config.{js,ts}\n *   import agentAppPreset from '@tangle-network/agent-app/tailwind-preset'\n *   export default { presets: [agentAppPreset], content: [...] }\n *\n * Pair with `import '@tangle-network/agent-app/styles'` for the variable values.\n * design-canvas/sequences need no preset — they consume vars via arbitrary\n * values (bg-[var(--bg-input)]), which Tailwind supports without color config.\n */\n\nconst withForeground = (name: string) => ({\n  DEFAULT: `hsl(var(--${name}))`,\n  foreground: `hsl(var(--${name}-foreground))`,\n})\n\nconst agentAppPreset = {\n  darkMode: ['class', '[data-theme=\"dark\"]'] as [string, string],\n  theme: {\n    extend: {\n      colors: {\n        background: 'hsl(var(--background))',\n        foreground: 'hsl(var(--foreground))',\n        border: 'hsl(var(--border))',\n        input: 'hsl(var(--input))',\n        ring: 'hsl(var(--ring))',\n        success: withForeground('success'),\n        warning: withForeground('warning'),\n        card: withForeground('card'),\n        popover: withForeground('popover'),\n        primary: withForeground('primary'),\n        secondary: withForeground('secondary'),\n        muted: withForeground('muted'),\n        accent: withForeground('accent'),\n        destructive: withForeground('destructive'),\n        // MD3 surface ladder — wires sandbox-ui's `bg-surface-container*`\n        // utilities (used by AgentComposer + its pickers) onto the shadcn\n        // elevation triples, so those components render on-palette here.\n        'surface-container': 'hsl(var(--card))',\n        'surface-container-high': 'hsl(var(--popover))',\n        'surface-container-highest': 'hsl(var(--secondary))',\n      },\n    },\n  },\n}\n\nexport default agentAppPreset\n"],"mappings":";AAcA,IAAM,iBAAiB,CAAC,UAAkB;AAAA,EACxC,SAAS,aAAa,IAAI;AAAA,EAC1B,YAAY,aAAa,IAAI;AAC/B;AAEA,IAAM,iBAAiB;AAAA,EACrB,UAAU,CAAC,SAAS,qBAAqB;AAAA,EACzC,OAAO;AAAA,IACL,QAAQ;AAAA,MACN,QAAQ;AAAA,QACN,YAAY;AAAA,QACZ,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,MAAM;AAAA,QACN,SAAS,eAAe,SAAS;AAAA,QACjC,SAAS,eAAe,SAAS;AAAA,QACjC,MAAM,eAAe,MAAM;AAAA,QAC3B,SAAS,eAAe,SAAS;AAAA,QACjC,SAAS,eAAe,SAAS;AAAA,QACjC,WAAW,eAAe,WAAW;AAAA,QACrC,OAAO,eAAe,OAAO;AAAA,QAC7B,QAAQ,eAAe,QAAQ;AAAA,QAC/B,aAAa,eAAe,aAAa;AAAA;AAAA;AAAA;AAAA,QAIzC,qBAAqB;AAAA,QACrB,0BAA0B;AAAA,QAC1B,6BAA6B;AAAA,MAC/B;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,0BAAQ;","names":[]}
+{"version":3,"sources":["../../src/theme/tailwind-preset.ts"],"sourcesContent":["/**\n * Tailwind preset mapping the shadcn semantic color names used by web-react\n * (bg-card, text-muted-foreground, border-border, …) onto the CSS variables in\n * tokens.css — so a consuming app themes every agent-app surface from one source.\n *\n *   // tailwind.config.{js,ts}\n *   import agentAppPreset from '@tangle-network/agent-app/tailwind-preset'\n *   export default { presets: [agentAppPreset], content: [...] }\n *\n * Pair with `import '@tangle-network/agent-app/styles'` for the variable values.\n * design-canvas/sequences need no preset — they consume vars via arbitrary\n * values (bg-[var(--bg-input)]), which Tailwind supports without color config.\n */\n\nconst withForeground = (name: string) => ({\n  DEFAULT: `hsl(var(--${name}))`,\n  foreground: `hsl(var(--${name}-foreground))`,\n})\n\n/** Define a preset configuration for dark mode and extended theme colors with foreground variants */\nconst agentAppPreset = {\n  darkMode: ['class', '[data-theme=\"dark\"]'] as [string, string],\n  theme: {\n    extend: {\n      colors: {\n        background: 'hsl(var(--background))',\n        foreground: 'hsl(var(--foreground))',\n        border: 'hsl(var(--border))',\n        input: 'hsl(var(--input))',\n        ring: 'hsl(var(--ring))',\n        success: withForeground('success'),\n        warning: withForeground('warning'),\n        card: withForeground('card'),\n        popover: withForeground('popover'),\n        primary: withForeground('primary'),\n        secondary: withForeground('secondary'),\n        muted: withForeground('muted'),\n        accent: withForeground('accent'),\n        destructive: withForeground('destructive'),\n        // MD3 surface ladder — wires sandbox-ui's `bg-surface-container*`\n        // utilities (used by AgentComposer + its pickers) onto the shadcn\n        // elevation triples, so those components render on-palette here.\n        'surface-container': 'hsl(var(--card))',\n        'surface-container-high': 'hsl(var(--popover))',\n        'surface-container-highest': 'hsl(var(--secondary))',\n      },\n    },\n  },\n}\n\nexport default agentAppPreset\n"],"mappings":";AAcA,IAAM,iBAAiB,CAAC,UAAkB;AAAA,EACxC,SAAS,aAAa,IAAI;AAAA,EAC1B,YAAY,aAAa,IAAI;AAC/B;AAGA,IAAM,iBAAiB;AAAA,EACrB,UAAU,CAAC,SAAS,qBAAqB;AAAA,EACzC,OAAO;AAAA,IACL,QAAQ;AAAA,MACN,QAAQ;AAAA,QACN,YAAY;AAAA,QACZ,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,MAAM;AAAA,QACN,SAAS,eAAe,SAAS;AAAA,QACjC,SAAS,eAAe,SAAS;AAAA,QACjC,MAAM,eAAe,MAAM;AAAA,QAC3B,SAAS,eAAe,SAAS;AAAA,QACjC,SAAS,eAAe,SAAS;AAAA,QACjC,WAAW,eAAe,WAAW;AAAA,QACrC,OAAO,eAAe,OAAO;AAAA,QAC7B,QAAQ,eAAe,QAAQ;AAAA,QAC/B,aAAa,eAAe,aAAa;AAAA;AAAA;AAAA;AAAA,QAIzC,qBAAqB;AAAA,QACrB,0BAA0B;AAAA,QAC1B,6BAA6B;AAAA,MAC/B;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,0BAAQ;","names":[]}

package/dist/theme-contract/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   checkThemeContract
-} from "../chunk-NYATNLRK.js";
+} from "../chunk-RT5RKAFX.js";
 
 // src/theme-contract/cli.ts
 function parseArgs(argv) {

package/dist/theme-contract/index.d.ts

@@ -45,6 +45,7 @@
  * subpath, NOT `./theme`, which must stay browser-clean (it's in the
  * browser-safe manifest test).
  */
+/** Define options for scanning source directories and CSS token files in a theme contract */
 interface ThemeContractOptions {
     /** Consumer source directories to scan for token references (recursively). */
     srcDirs: string[];
@@ -66,6 +67,7 @@ interface ThemeContractOptions {
      */
     allowlist?: string[];
 }
+/** Describe a missing theme contract variable and where it was referenced */
 interface ThemeContractMiss {
     /** The undefined custom property, e.g. `--popover`. */
     varName: string;
@@ -76,6 +78,7 @@ interface ThemeContractMiss {
      */
     referencedIn: string;
 }
+/** Describe the result of validating a theme contract including success status and missing items */
 interface ThemeContractResult {
     ok: boolean;
     missing: ThemeContractMiss[];

package/dist/theme-contract/index.js

@@ -1,6 +1,6 @@
 import {
   checkThemeContract
-} from "../chunk-NYATNLRK.js";
+} from "../chunk-RT5RKAFX.js";
 export {
   checkThemeContract
 };

package/dist/tools/index.d.ts

@@ -1,9 +1,9 @@
-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';
+import { a as ToolHeaderNames } from '../auth-_FU8w01b.js';
+export { A as AuthenticateOptions, D as DEFAULT_HEADER_NAMES, T as ToolAuthResult, b as authenticateToolRequest, r as readToolArgs } from '../auth-_FU8w01b.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-CBRyqijY.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-CBRyqijY.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-BjPqQ-3C.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-BfUOsalw.js';
 
 /** A correctable bad-input error a tool handler throws; the HTTP layer maps it
  *  to a 4xx with the code, the runtime layer to a failed tool_result. So the
@@ -30,6 +30,7 @@ declare class ToolInputError extends Error {
  * server rather than fake an authorized call). WebCrypto only — runs on
  * Workers, Node, and the browser with no Node `crypto` dependency.
  */
+/** Define options for creating and verifying capability tokens including secret and prefix */
 interface CapabilityTokenOptions {
     /** Shared HMAC secret. When absent, mint returns undefined / verify returns false. */
     secret?: string;
@@ -43,6 +44,7 @@ declare function createCapabilityToken(userId: string, opts: CapabilityTokenOpti
 /** Verify a capability token against `userId`. Returns false (never throws) for
  *  an unconfigured secret, a wrong prefix, a malformed token, or a mismatch. */
 declare function verifyCapabilityToken(userId: string, token: string, opts: CapabilityTokenOptions): Promise<boolean>;
+/** Define options for capability tokens that expire after a specified lifetime in milliseconds */
 interface ExpiringCapabilityTokenOptions extends CapabilityTokenOptions {
     /** Token lifetime. Expired tokens verify false regardless of signature. */
     expiresInMs: number;
@@ -96,6 +98,7 @@ interface ToolCapability {
      *  unions them. */
     toolGroups?: readonly string[];
 }
+/** Resolve options for determining tool capabilities based on taxonomy, capabilities, and enabled IDs */
 interface ResolveToolCapabilitiesOptions {
     taxonomy: AppToolTaxonomy;
     /** The product's full capability registry. */
@@ -109,6 +112,7 @@ interface ResolveToolCapabilitiesOptions {
      *  "domain actions" are the taxonomy types no capability claims. */
     baseProposalTypes?: readonly string[];
 }
+/** Describe resolved capabilities including proposal types and product tool groups to expose */
 interface ResolvedToolCapabilities {
     /** Proposal types to keep — feed to {@link restrictTaxonomy}. */
     proposalTypes: string[];
@@ -128,6 +132,7 @@ declare function resolveToolCapabilities(opts: ResolveToolCapabilitiesOptions):
  */
 declare function restrictTaxonomy(taxonomy: AppToolTaxonomy, allowed: readonly string[]): AppToolTaxonomy;
 
+/** Define options for dispatching tools including handlers, taxonomy, custom tools, and approval policies */
 interface DispatchOptions {
     handlers: AppToolHandlers;
     taxonomy: AppToolTaxonomy;
@@ -170,6 +175,7 @@ type AppToolRuntimeExecutor = (call: {
     toolName: string;
     args: Record<string, unknown>;
 }) => Promise<AppToolOutcome>;
+/** Define options for executing runtime tasks with a trusted per-turn context */
 interface RuntimeExecutorOptions extends DispatchOptions {
     /** The trusted per-turn context — supplied directly (not from headers), since
      *  the runtime path has no HTTP request. */
@@ -183,6 +189,7 @@ interface RuntimeExecutorOptions extends DispatchOptions {
  */
 declare function createAppToolRuntimeExecutor(opts: RuntimeExecutorOptions): AppToolRuntimeExecutor;
 
+/** Define options for handling tool requests including tool identification and token verification */
 interface HandleToolRequestOptions extends DispatchOptions {
     /** Which app tool this route serves — a built-in name or a product-registered
      *  {@link AppToolDefinition} (auto-added to `customTools` for dispatch). */

package/dist/tools/index.js

@@ -6,7 +6,7 @@ import {
   restrictTaxonomy,
   verifyCapabilityToken,
   verifyExpiringCapabilityToken
-} from "../chunk-PJC4NXPA.js";
+} from "../chunk-YKBDH2UY.js";
 import {
   DEFAULT_APP_TOOL_PATHS,
   DEFAULT_HEADER_NAMES,
@@ -17,7 +17,7 @@ import {
   buildScopedMcpServerEntry,
   createMcpToolHandler,
   readToolArgs
-} from "../chunk-7EVZUIHW.js";
+} from "../chunk-3EJ6SFJI.js";
 import "../chunk-S5SRJJQG.js";
 import {
   APP_TOOL_NAMES,
@@ -30,7 +30,7 @@ import {
   findCustomTool,
   isAppToolName,
   outcomeStatus
-} from "../chunk-MFRCM32T.js";
+} from "../chunk-7CTIUCQ4.js";
 export {
   APP_TOOL_NAMES,
   DEFAULT_APP_TOOL_PATHS,

package/dist/trace/index.d.ts

@@ -1,4 +1,4 @@
-import { a as FlowTrace, F as FlowSpan } from '../flow-types-Cb_AblZs.js';
+import { a as FlowTrace, F as FlowSpan } from '../flow-types-CqomVAUN.js';
 import { S as StepAgentActivity } from '../agent-activity-C8ZG0F0M.js';
 
 /**
@@ -23,6 +23,7 @@ interface MissionTraceContext {
     /** 16-hex span id of the mission root — the parent of every step span. */
     rootSpanId: string;
 }
+/** Define context information for a step span including trace, span, and parent span identifiers */
 interface StepSpanContext {
     traceId: string;
     /** 16-hex span id of this step attempt (or any nested unit of work). */
@@ -111,6 +112,7 @@ declare function stepActivityFlowTrace(activity: StepAgentActivity[], opts?: {
     startedAt?: number;
     nowMs?: number;
 }): FlowTrace;
+/** Define a step in a mission flow with id, intent, optional status, start time, and duration */
 interface MissionFlowStep {
     id: string;
     intent: string;
@@ -150,6 +152,7 @@ declare function composeMissionFlowTrace(input: {
  * carry `approx: true` to keep reports honest about that.
  */
 
+/** Represent a timed event with a timestamp and associated event data */
 interface TimedEvent {
     /** ms since turn start (`_t` stamped by pumpBufferedTurn). */
     t: number;
@@ -172,6 +175,7 @@ declare function buildFlowTrace(events: TimedEvent[], opts?: {
 declare function renderWaterfall(trace: FlowTrace, opts?: {
     width?: number;
 }): string;
+/** Summarize key statistics of a numerical distribution including count, min, percentiles, and max */
 interface DistributionSummary {
     n: number;
     min: number;
@@ -179,6 +183,7 @@ interface DistributionSummary {
     p90: number;
     max: number;
 }
+/** Summarize numeric values into a distribution summary including count, min, median, 90th percentile, and max */
 declare function summarize(values: number[]): DistributionSummary;
 /** ASCII histogram for multi-run samples (eval latencies, costs, scores). */
 declare function renderHistogram(values: number[], opts?: {

package/dist/trace/index.js

@@ -7,13 +7,13 @@ import {
   summarize,
   timedEventsFromLines,
   traceEnv
-} from "../chunk-GQRL6VNU.js";
+} from "../chunk-LGBO24FL.js";
 import {
   composeMissionFlowTrace,
   delegationActivityToFlowSpans,
   loopTraceEventsToFlowSpans,
   stepActivityFlowTrace
-} from "../chunk-2QI7XV2T.js";
+} from "../chunk-FBVLEGEG.js";
 export {
   buildFlowTrace,
   childSpanContext,

package/dist/{turn-buffer-C9mEgoop.d.ts → turn-buffer-DGnAPKwa.d.ts}

@@ -16,11 +16,13 @@
  * deltas with identical concatenation.
  */
 type TurnStatus = 'running' | 'complete' | 'error';
+/** Represent a buffered turn event with a sequence number and serialized event data */
 interface BufferedTurnEvent {
     seq: number;
     /** The serialized event line (JSON string, no trailing newline). */
     event: string;
 }
+/** Manage and query turn events and their lifecycle statuses within a scoped event store */
 interface TurnEventStore {
     append(turnId: string, events: BufferedTurnEvent[]): Promise<void>;
     read(turnId: string, fromSeq: number): Promise<BufferedTurnEvent[]>;
@@ -53,6 +55,7 @@ declare function coalesceDeltas(events: unknown[]): unknown[];
  * identical final text.
  */
 declare function coalesceChatStreamEvents(events: unknown[]): unknown[];
+/** Define options for buffering and flushing turn events with optional live client delivery and event coalescing */
 interface BufferedTurnOptions {
     store: TurnEventStore;
     turnId: string;
@@ -92,6 +95,7 @@ interface BufferedTurnTap {
  *     no `TurnEventStore` seam.
  */
 declare function createBufferedTurnTap(opts: BufferedTurnOptions): BufferedTurnTap;
+/** Define options to pump data from an asynchronous iterable source with buffered turn control */
 interface PumpBufferedTurnOptions extends BufferedTurnOptions {
     source: AsyncIterable<unknown>;
 }
@@ -104,6 +108,7 @@ interface PumpBufferedTurnOptions extends BufferedTurnOptions {
  * what was produced) and rethrows.
  */
 declare function pumpBufferedTurn(opts: PumpBufferedTurnOptions): Promise<void>;
+/** Define options for replaying turn events with control over sequence, polling, and timeout */
 interface ReplayTurnEventsOptions {
     store: TurnEventStore;
     turnId: string;
@@ -139,6 +144,7 @@ declare const TURN_EVENTS_MIGRATION_SQL = "\nCREATE TABLE IF NOT EXISTS turn_eve
  *  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;";
+/** Resolve a TurnEventStore that appends and reads turn events using a D1-like database interface */
 declare function createD1TurnEventStore(db: D1LikeForTurns): TurnEventStore;
 /** In-memory store for tests and keyless local dev. */
 declare function createMemoryTurnEventStore(): TurnEventStore;

package/dist/turn-stream/index.d.ts

@@ -1,5 +1,5 @@
-import { R as ReconcileStaleTurnLockOptions } from '../stale-turn-lock-C8Na1cFZ.js';
-import { d as TurnEventStore } from '../turn-buffer-C9mEgoop.js';
+import { R as ReconcileStaleTurnLockOptions } from '../stale-turn-lock-DucQzvXu.js';
+import { d as TurnEventStore } from '../turn-buffer-DGnAPKwa.js';
 
 /**
  * `/turn-stream` core — the pure, substrate-free half of the shared durable
@@ -26,21 +26,28 @@ interface TurnStreamEvent {
 /** Terminal run markers: they close a turn segment and auto-release the
  *  channel's chat-turn lock for the segment's execution. */
 declare function isTerminalRunEvent(type: string): boolean;
+/** Define the scope level for acquiring a turn lock within thread or workspace contexts */
 type TurnLockScope = 'thread' | 'workspace';
+/** Generate a unique string key combining workspace and thread identifiers */
 declare function threadChannelKey(workspaceId: string, threadId: string): string;
+/** Generate a unique channel key based on the given workspace identifier */
 declare function workspaceChannelKey(workspaceId: string): string;
 /** The channel a lock lives on: workspace-scope locks serialize every thread
  *  in the workspace (one shared sandbox), thread-scope locks serialize one
  *  thread (router lane). Same keying as the reference consumer, so a product
  *  swapping its fork for this package contends on identical instances. */
 declare function turnLockChannelKey(workspaceId: string, threadId: string, scope: TurnLockScope): string;
+/** Generate a storage channel key string for a given turn identifier */
 declare function turnStorageChannelKey(turnId: string): string;
+/** Generate a unique channel key string based on the provided scope identifier */
 declare function scopeIndexChannelKey(scopeId: string): string;
+/** Represent a segment of a turn containing events, sequence limit, and terminal status */
 interface TurnSegment {
     events: TurnStreamEvent[];
     maxSeq: number;
     terminal: boolean;
 }
+/** Define a store managing segments and tracking the active execution identifier */
 interface SegmentStore {
     segments: Map<string, TurnSegment>;
     activeExecutionId: string | null;
@@ -54,6 +61,7 @@ declare const MAX_RECENT_CREATED = 50;
 /** A responding marker older than this is treated as stale, so a dropped
  *  `end` broadcast can't leave a permanently-stuck "responding" dot. */
 declare const ACTIVITY_TTL_MS: number;
+/** Create a SegmentStore with initialized segments and no active execution ID */
 declare function createSegmentStore(): SegmentStore;
 /**
  * Append a per-turn event to its execution's segment, assigning a monotonic
@@ -97,6 +105,7 @@ interface DurableTurnLock {
      *  defer seam — the base package never sets it on its own. */
     releasePending?: boolean;
 }
+/** Define input parameters required to acquire a turn-based lock in a workspace thread */
 interface TurnLockAcquireInput {
     workspaceId: string;
     threadId: string;
@@ -105,6 +114,7 @@ interface TurnLockAcquireInput {
     lockId: string;
     turnId?: string;
 }
+/** Resolve the result of attempting to acquire a turn lock indicating success or active lock status */
 type TurnLockAcquireResult = {
     acquired: true;
     lock: DurableTurnLock;
@@ -112,6 +122,7 @@ type TurnLockAcquireResult = {
     acquired: false;
     active: DurableTurnLock;
 };
+/** Define input parameters required to release a turn lock in a specific workspace thread */
 interface TurnLockReleaseInput {
     workspaceId: string;
     threadId: string;
@@ -133,6 +144,7 @@ interface TurnLockInterruptedReleaseInput {
 }
 /** `stored` is what the DO read from storage; expired locks are dead. */
 declare function activeTurnLock(stored: DurableTurnLock | undefined, now: number): DurableTurnLock | null;
+/** Create a durable turn lock object with timing and scope based on input parameters */
 declare function createTurnLock(input: TurnLockAcquireInput, now: number, ttlMs?: number): DurableTurnLock;
 /** A cooperative release must present the lock's own identity — both the
  *  execution and the lockId minted at acquire — so a retry of a PREVIOUS turn
@@ -156,6 +168,7 @@ declare function interruptedReleaseApplies(active: DurableTurnLock, input: {
     interruptedAt: number;
     turnId?: string;
 }): boolean;
+/** Provide constant paths for managing chat turn streams and locks */
 declare const TURN_STREAM_PATHS: {
     readonly broadcast: "/broadcast";
     readonly lockAcquire: "/chat-turn-lock/acquire";
@@ -247,6 +260,7 @@ interface TurnStreamDOState {
     acceptWebSocket(ws: TurnStreamSocket): void;
     getWebSockets(): TurnStreamSocket[];
 }
+/** Define options to override default TTL and event limits for TURN stream DO operations */
 interface TurnStreamDOOptions {
     /** Override {@link TURN_LOCK_TTL_MS}. */
     lockTtlMs?: number;
@@ -255,6 +269,7 @@ interface TurnStreamDOOptions {
     /** Override {@link ACTIVITY_TTL_MS}. */
     activityTtlMs?: number;
 }
+/** Manage per-turn segments and track active threads with durable event storage */
 declare class TurnStreamDO {
     protected readonly state: TurnStreamDOState;
     protected readonly env: unknown;
@@ -335,6 +350,7 @@ declare class TurnStreamDO {
  * contract the reference consumer already runs.
  */
 
+/** Resolve a stub interface for handling fetch requests with optional initialization parameters */
 interface TurnStreamStubLike {
     fetch(input: Request | string, init?: RequestInit): Promise<Response>;
 }
@@ -352,6 +368,7 @@ interface TurnStreamNamespaceLike {
  * instance. Drops in wherever `createD1TurnEventStore(env.DB)` would.
  */
 declare function createDurableObjectTurnEventStore(namespace: TurnStreamNamespaceLike): TurnEventStore;
+/** Define input parameters required to acquire a durable turn lock in a workspace thread context */
 interface AcquireDurableTurnLockInput {
     workspaceId: string;
     threadId: string;
@@ -361,11 +378,14 @@ interface AcquireDurableTurnLockInput {
     /** Supply to reclaim/retry with a stable id; default mints a UUID. */
     lockId?: string;
 }
+/** Acquire a durable turn lock in the specified namespace with given input parameters */
 declare function acquireDurableTurnLock(namespace: TurnStreamNamespaceLike, input: AcquireDurableTurnLockInput): Promise<TurnLockAcquireResult>;
+/** Release a durable turn lock and indicate if the release was successful or deferred */
 declare function releaseDurableTurnLock(namespace: TurnStreamNamespaceLike, input: TurnLockReleaseInput): Promise<{
     released: boolean;
     deferred?: boolean;
 }>;
+/** Define input parameters to release an interrupted durable turn lock in a workspace or thread */
 interface ReleaseInterruptedDurableTurnLockInput {
     workspaceId: string;
     threadId: string;
@@ -379,6 +399,7 @@ interface ReleaseInterruptedDurableTurnLockInput {
  *  after `interruptedAt`) and a turnId mismatch. Returns whether any scope
  *  released. */
 declare function releaseInterruptedDurableTurnLock(namespace: TurnStreamNamespaceLike, input: ReleaseInterruptedDurableTurnLockInput): Promise<boolean>;
+/** Define options to reconcile stale durable turn locks with context, namespace, workspace, and active lock details */
 interface ReconcileStaleDurableTurnLockOptions extends Pick<ReconcileStaleTurnLockOptions, 'probeSandbox' | 'probeSession' | 'graceMs' | 'terminalGraceMs' | 'context' | 'log' | 'now'> {
     namespace: TurnStreamNamespaceLike;
     workspaceId: string;
@@ -419,6 +440,7 @@ type TurnLockSeamResult = {
     acquired: false;
     response: Response;
 };
+/** Define options for creating a durable turn lock with customizable scope and identification methods */
 interface CreateDurableTurnLockOptions<TContext> {
     namespace: TurnStreamNamespaceLike;
     /** Which lane serializes this turn: `'workspace'` (shared sandbox — one
@@ -480,12 +502,14 @@ declare function broadcastThreadCreated(namespace: TurnStreamNamespaceLike, work
     threadId: string;
     title: string;
 }): Promise<void>;
+/** Represent success or failure of a TURN stream upgrade authorization with optional response data */
 type TurnStreamUpgradeAuthorization = {
     ok: true;
 } | {
     ok: false;
     response: Response;
 };
+/** Define options for creating a TURN stream upgrade handler including namespace, path, and authorization logic */
 interface CreateTurnStreamUpgradeHandlerOptions {
     namespace: TurnStreamNamespaceLike;
     /** The worker route serving the stream. Default `/api/session-stream`. */
@@ -526,6 +550,7 @@ interface MemoryTurnStreamSocket extends TurnStreamSocket {
     readonly frames: string[];
     readonly closed: boolean;
 }
+/** Define an in-memory channel for streaming turn-based data with viewer socket connection support */
 interface MemoryTurnStreamChannel {
     /** Attach a viewer socket to this channel (bypasses the HTTP 101 — the
      *  upgrade handshake is Cloudflare-runtime-only) and run its `sync`. */
@@ -536,6 +561,7 @@ interface MemoryTurnStreamChannel {
     }): Promise<MemoryTurnStreamSocket>;
     readonly instance: TurnStreamDO;
 }
+/** Provide an interface to manage channels and namespaces for memory-based turn stream testing */
 interface MemoryTurnStreamHarness {
     namespace: TurnStreamNamespaceLike;
     /** The channel (creating its DO instance if needed) for a channel key —

package/dist/turn-stream/index.js

@@ -1,6 +1,6 @@
 import {
   reconcileStaleTurnLock
-} from "../chunk-BQV42AFK.js";
+} from "../chunk-CCVWR33L.js";
 
 // src/turn-stream/core.ts
 function isTerminalRunEvent(type) {