@agimon-ai/doompi-web-contracts 0.0.1-alpha.2 → 0.0.1-alpha.20

package/README.md

@@ -1,27 +1,46 @@
 # @agimon-ai/doompi-web-contracts
 
-Web cockpit plugin contracts for DoomPi.
+Typed plugin, slot, session-channel, and hub-channel contracts for the DoomPi web cockpit.
 
-Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
+This is a library, not a Pi extension. It starts no process and does not belong in `.doom/modes.yaml`.
 
-A DoomPi web plugin has two halves that share these types:
+> **Alpha:** web plugin contracts may change between releases.
 
-- A client entry exporting `webPlugin: WebPluginDefinition`, compiled into the cockpit bundle by
-  the host package's build. It can contribute tabs with panels and badges, session data channels,
-  overlays, Leader Space key bindings, command palette commands, rail, selection bar, and
-  activity dock sections, and tool renderers: one `message` component per claimed tool (by name,
-  or by a `matches` predicate for tools named at runtime) that owns the tool call's whole timeline
-  item, composed from the shared components package's `MessageItem` so it looks like every other
-  item; `toolResultText` and `toolResultTextLines` read a result's text blocks the same way.
-- An optional hub entry exporting `webHubChannels: readonly WebHubChannel[]`, loaded by the cockpit
-  server at startup. A channel watches some data source and answers per-session payloads that reach
-  the page as `ChannelFrame` messages whose frame type is the channel name.
+## Install
 
-Plugin packages declare both entries in a `doompiWeb` block in their package.json; the cockpit's
-build scans the workspace and generates its registration modules from those blocks.
+```bash
+npm install @agimon-ai/doompi-web-contracts
+```
 
-Use `defineWebPlugin` and `defineSessionChannel` for checked literals. Server code should import
-these contracts type-only.
+Web plugin clients also require the package's React, React DOM, and TanStack Store peers when they use
+those surfaces.
+
+## Plugin shape
+
+A web plugin can have two entries:
+
+- A client entry exports `webPlugin: WebPluginDefinition`. It can contribute tabs, slots, Leader
+  bindings, commands, session channels, activity surfaces, and tool renderers.
+- An optional hub entry exports `webHubChannels: readonly WebHubChannel[]`. Each channel watches a
+  data source and emits per-session `ChannelFrame` payloads to the page.
+
+Declare both entries in the plugin package's `doompiWeb` manifest block. The DoomPi cockpit bundler
+reads those declarations and generates the registration modules.
+
+Use the definition helpers for checked literals:
+
+```ts
+import {
+  defineSessionChannel,
+  defineSessionStore,
+  defineSlot,
+  defineWebPlugin,
+  toolResultText,
+} from '@agimon-ai/doompi-web-contracts';
+```
+
+Import contracts type-only from server code. The `/testing` subpath provides channel, render, slot,
+and tool-message fixtures for plugin tests.
 
 ## License
 

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./services/define.cjs"),t=require("./services/sessionStore.cjs"),n=require("./services/toolResult.cjs");exports.defineSessionChannel=e.defineSessionChannel,exports.defineSessionStore=t.defineSessionStore,exports.defineSlot=e.defineSlot,exports.defineWebPlugin=e.defineWebPlugin,exports.toolResultText=n.toolResultText,exports.toolResultTextLines=n.toolResultTextLines;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./services/define.cjs"),t=require("./services/globalStore.cjs"),n=require("./services/sessionStore.cjs"),r=require("./services/toolResult.cjs");exports.defineGlobalStore=t.defineGlobalStore,exports.defineSessionChannel=e.defineSessionChannel,exports.defineSessionStore=n.defineSessionStore,exports.defineSlot=e.defineSlot,exports.defineWebPlugin=e.defineWebPlugin,exports.toolResultText=r.toolResultText,exports.toolResultTextLines=r.toolResultTextLines;

package/dist/index.d.cts

@@ -1,6 +1,8 @@
-import { ActivityGroupContribution, LeaderBindingContribution, LeaderKeyContribution, MinorModeContribution, PaletteCommandContext, PaletteCommandContribution, SelectionAxisContribution, SessionChannelContribution, SessionFrameSender, SessionRecords, SessionStore, SessionStoreChannel, SlotDataFill, SlotDeclaration, SlotFillContribution, SurfaceContribution, TabContribution, ToolMessageRenderProps, ToolRendererContribution, ToolResultView, TransientTab, WebPluginDefinition, WebPluginRuntime, WebPluginSlotProps } from "./types/webPlugin.cjs";
+import { ModelContext, ModelContextAbortSignal, ModelContextBinding, ModelContextExecutionOptions, ModelContextRegistrationOptions, ModelContextTool, ModelContextToolChangeEvent, ModelContextToolChangeListener, ModelContextToolDescriptor } from "./types/modelContext.cjs";
+import { ActivityGroupContribution, ComposerCapture, ComposerSubmission, ContextAction, ContextActionContribution, ContextActionRunContext, DockFaceContribution, FileLinkSource, GlobalStore, LeaderBindingContribution, LeaderKeyContribution, MinorModeContribution, PaletteCommandContext, PaletteCommandContribution, RepositorySettingsPanelContribution, RepositorySettingsPanelProps, RepositorySettingsRepository, SelectionAxisContribution, SessionChannelContribution, SessionFrameSender, SessionRecords, SessionStore, SessionStoreChannel, SettingsFieldContribution, SettingsFieldOption, SettingsPanelContribution, SettingsPanelProps, SettingsSectionContribution, SlotDataFill, SlotDeclaration, SlotFillContribution, SurfaceContribution, TabContribution, ThreadViewOptions, ToolMessageRenderProps, ToolPromptContribution, ToolPromptDialog, ToolPromptRenderProps, ToolRendererContribution, ToolResultView, TransientTab, WebPluginContextInventoryItem, WebPluginContextItem, WebPluginDefinition, WebPluginRuntime, WebPluginSlotProps } from "./types/webPlugin.cjs";
 import { defineSessionChannel, defineSlot, defineWebPlugin } from "./services/define.cjs";
+import { defineGlobalStore } from "./services/globalStore.cjs";
 import { defineSessionStore } from "./services/sessionStore.cjs";
 import { toolResultText, toolResultTextLines } from "./services/toolResult.cjs";
-import { ChannelFrame, HubChannelHost, HubChannelSource, HubSessionScope, WebHubChannel } from "./types/webHub.cjs";
-export { type ActivityGroupContribution, type ChannelFrame, type HubChannelHost, type HubChannelSource, type HubSessionScope, type LeaderBindingContribution, type LeaderKeyContribution, type MinorModeContribution, type PaletteCommandContext, type PaletteCommandContribution, type SelectionAxisContribution, type SessionChannelContribution, type SessionFrameSender, type SessionRecords, type SessionStore, type SessionStoreChannel, type SlotDataFill, type SlotDeclaration, type SlotFillContribution, type SurfaceContribution, type TabContribution, type ToolMessageRenderProps, type ToolRendererContribution, type ToolResultView, type TransientTab, type WebHubChannel, type WebPluginDefinition, type WebPluginRuntime, type WebPluginSlotProps, defineSessionChannel, defineSessionStore, defineSlot, defineWebPlugin, toolResultText, toolResultTextLines };
+import { ChannelFrame, ComputerUseHostBinding, ComputerUseHostOperation, ComputerUseHostRequest, HubChannelConnection, HubChannelHost, HubChannelLifecycle, HubChannelSource, HubSessionApiRequest, HubSessionScope, WebHubChannel } from "./types/webHub.cjs";
+export { type ActivityGroupContribution, type ChannelFrame, type ComposerCapture, type ComposerSubmission, type ComputerUseHostBinding, type ComputerUseHostOperation, type ComputerUseHostRequest, type ContextAction, type ContextActionContribution, type ContextActionRunContext, type DockFaceContribution, type FileLinkSource, type GlobalStore, type HubChannelConnection, type HubChannelHost, type HubChannelLifecycle, type HubChannelSource, type HubSessionApiRequest, type HubSessionScope, type LeaderBindingContribution, type LeaderKeyContribution, type MinorModeContribution, type ModelContext, type ModelContextAbortSignal, type ModelContextBinding, type ModelContextExecutionOptions, type ModelContextRegistrationOptions, type ModelContextTool, type ModelContextToolChangeEvent, type ModelContextToolChangeListener, type ModelContextToolDescriptor, type PaletteCommandContext, type PaletteCommandContribution, type RepositorySettingsPanelContribution, type RepositorySettingsPanelProps, type RepositorySettingsRepository, type SelectionAxisContribution, type SessionChannelContribution, type SessionFrameSender, type SessionRecords, type SessionStore, type SessionStoreChannel, type SettingsFieldContribution, type SettingsFieldOption, type SettingsPanelContribution, type SettingsPanelProps, type SettingsSectionContribution, type SlotDataFill, type SlotDeclaration, type SlotFillContribution, type SurfaceContribution, type TabContribution, type ThreadViewOptions, type ToolMessageRenderProps, type ToolPromptContribution, type ToolPromptDialog, type ToolPromptRenderProps, type ToolRendererContribution, type ToolResultView, type TransientTab, type WebHubChannel, type WebPluginContextInventoryItem, type WebPluginContextItem, type WebPluginDefinition, type WebPluginRuntime, type WebPluginSlotProps, defineGlobalStore, defineSessionChannel, defineSessionStore, defineSlot, defineWebPlugin, toolResultText, toolResultTextLines };

package/dist/index.d.mts

@@ -1,6 +1,8 @@
-import { ActivityGroupContribution, LeaderBindingContribution, LeaderKeyContribution, MinorModeContribution, PaletteCommandContext, PaletteCommandContribution, SelectionAxisContribution, SessionChannelContribution, SessionFrameSender, SessionRecords, SessionStore, SessionStoreChannel, SlotDataFill, SlotDeclaration, SlotFillContribution, SurfaceContribution, TabContribution, ToolMessageRenderProps, ToolRendererContribution, ToolResultView, TransientTab, WebPluginDefinition, WebPluginRuntime, WebPluginSlotProps } from "./types/webPlugin.mjs";
+import { ModelContext, ModelContextAbortSignal, ModelContextBinding, ModelContextExecutionOptions, ModelContextRegistrationOptions, ModelContextTool, ModelContextToolChangeEvent, ModelContextToolChangeListener, ModelContextToolDescriptor } from "./types/modelContext.mjs";
+import { ActivityGroupContribution, ComposerCapture, ComposerSubmission, ContextAction, ContextActionContribution, ContextActionRunContext, DockFaceContribution, FileLinkSource, GlobalStore, LeaderBindingContribution, LeaderKeyContribution, MinorModeContribution, PaletteCommandContext, PaletteCommandContribution, RepositorySettingsPanelContribution, RepositorySettingsPanelProps, RepositorySettingsRepository, SelectionAxisContribution, SessionChannelContribution, SessionFrameSender, SessionRecords, SessionStore, SessionStoreChannel, SettingsFieldContribution, SettingsFieldOption, SettingsPanelContribution, SettingsPanelProps, SettingsSectionContribution, SlotDataFill, SlotDeclaration, SlotFillContribution, SurfaceContribution, TabContribution, ThreadViewOptions, ToolMessageRenderProps, ToolPromptContribution, ToolPromptDialog, ToolPromptRenderProps, ToolRendererContribution, ToolResultView, TransientTab, WebPluginContextInventoryItem, WebPluginContextItem, WebPluginDefinition, WebPluginRuntime, WebPluginSlotProps } from "./types/webPlugin.mjs";
 import { defineSessionChannel, defineSlot, defineWebPlugin } from "./services/define.mjs";
+import { defineGlobalStore } from "./services/globalStore.mjs";
 import { defineSessionStore } from "./services/sessionStore.mjs";
 import { toolResultText, toolResultTextLines } from "./services/toolResult.mjs";
-import { ChannelFrame, HubChannelHost, HubChannelSource, HubSessionScope, WebHubChannel } from "./types/webHub.mjs";
-export { type ActivityGroupContribution, type ChannelFrame, type HubChannelHost, type HubChannelSource, type HubSessionScope, type LeaderBindingContribution, type LeaderKeyContribution, type MinorModeContribution, type PaletteCommandContext, type PaletteCommandContribution, type SelectionAxisContribution, type SessionChannelContribution, type SessionFrameSender, type SessionRecords, type SessionStore, type SessionStoreChannel, type SlotDataFill, type SlotDeclaration, type SlotFillContribution, type SurfaceContribution, type TabContribution, type ToolMessageRenderProps, type ToolRendererContribution, type ToolResultView, type TransientTab, type WebHubChannel, type WebPluginDefinition, type WebPluginRuntime, type WebPluginSlotProps, defineSessionChannel, defineSessionStore, defineSlot, defineWebPlugin, toolResultText, toolResultTextLines };
+import { ChannelFrame, ComputerUseHostBinding, ComputerUseHostOperation, ComputerUseHostRequest, HubChannelConnection, HubChannelHost, HubChannelLifecycle, HubChannelSource, HubSessionApiRequest, HubSessionScope, WebHubChannel } from "./types/webHub.mjs";
+export { type ActivityGroupContribution, type ChannelFrame, type ComposerCapture, type ComposerSubmission, type ComputerUseHostBinding, type ComputerUseHostOperation, type ComputerUseHostRequest, type ContextAction, type ContextActionContribution, type ContextActionRunContext, type DockFaceContribution, type FileLinkSource, type GlobalStore, type HubChannelConnection, type HubChannelHost, type HubChannelLifecycle, type HubChannelSource, type HubSessionApiRequest, type HubSessionScope, type LeaderBindingContribution, type LeaderKeyContribution, type MinorModeContribution, type ModelContext, type ModelContextAbortSignal, type ModelContextBinding, type ModelContextExecutionOptions, type ModelContextRegistrationOptions, type ModelContextTool, type ModelContextToolChangeEvent, type ModelContextToolChangeListener, type ModelContextToolDescriptor, type PaletteCommandContext, type PaletteCommandContribution, type RepositorySettingsPanelContribution, type RepositorySettingsPanelProps, type RepositorySettingsRepository, type SelectionAxisContribution, type SessionChannelContribution, type SessionFrameSender, type SessionRecords, type SessionStore, type SessionStoreChannel, type SettingsFieldContribution, type SettingsFieldOption, type SettingsPanelContribution, type SettingsPanelProps, type SettingsSectionContribution, type SlotDataFill, type SlotDeclaration, type SlotFillContribution, type SurfaceContribution, type TabContribution, type ThreadViewOptions, type ToolMessageRenderProps, type ToolPromptContribution, type ToolPromptDialog, type ToolPromptRenderProps, type ToolRendererContribution, type ToolResultView, type TransientTab, type WebHubChannel, type WebPluginContextInventoryItem, type WebPluginContextItem, type WebPluginDefinition, type WebPluginRuntime, type WebPluginSlotProps, defineGlobalStore, defineSessionChannel, defineSessionStore, defineSlot, defineWebPlugin, toolResultText, toolResultTextLines };

package/dist/index.mjs

@@ -1 +1 @@
-import{defineSessionChannel as e,defineSlot as t,defineWebPlugin as n}from"./services/define.mjs";import{defineSessionStore as r}from"./services/sessionStore.mjs";import{toolResultText as i,toolResultTextLines as a}from"./services/toolResult.mjs";export{e as defineSessionChannel,r as defineSessionStore,t as defineSlot,n as defineWebPlugin,i as toolResultText,a as toolResultTextLines};
+import{defineSessionChannel as e,defineSlot as t,defineWebPlugin as n}from"./services/define.mjs";import{defineGlobalStore as r}from"./services/globalStore.mjs";import{defineSessionStore as i}from"./services/sessionStore.mjs";import{toolResultText as a,toolResultTextLines as o}from"./services/toolResult.mjs";export{r as defineGlobalStore,e as defineSessionChannel,i as defineSessionStore,t as defineSlot,n as defineWebPlugin,a as toolResultText,o as toolResultTextLines};

package/dist/services/globalStore.cjs

@@ -0,0 +1,2 @@
+let e=require("@tanstack/store");function t(t){let n=new e.Store(t);return{store:n,update:e=>{let t=n.state,r=e(t);r!==t&&n.setState(()=>r)},reset:()=>{n.setState(e=>e===t?e:t)}}}exports.defineGlobalStore=t;
+//# sourceMappingURL=globalStore.cjs.map

package/dist/services/globalStore.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalStore.cjs","names":["Store"],"sources":["../../src/services/globalStore.ts"],"sourcesContent":["import { Store } from '@tanstack/store';\nimport type { GlobalStore } from '../types/webPlugin.ts';\n\n/** Page-wide plugin state shared by every contribution from the plugin. */\nexport function defineGlobalStore<T>(initial: T): GlobalStore<T> {\n  const store = new Store<T>(initial);\n\n  const update = (updater: (current: T) => T): void => {\n    const current = store.state;\n    const next = updater(current);\n    if (next !== current) store.setState(() => next);\n  };\n\n  const reset = (): void => {\n    store.setState((current) => (current === initial ? current : initial));\n  };\n\n  return { store, update, reset };\n}\n"],"mappings":"iCAIA,SAAgB,EAAqB,EAA4B,CAC/D,IAAM,EAAQ,IAAIA,EAAAA,MAAS,CAAO,EAYlC,MAAO,CAAE,QAAO,OAVA,GAAqC,CACnD,IAAM,EAAU,EAAM,MAChB,EAAO,EAAQ,CAAO,EACxB,IAAS,GAAS,EAAM,aAAe,CAAI,CACjD,EAMwB,UAJE,CACxB,EAAM,SAAU,GAAa,IAAY,EAAU,EAAU,CAAQ,CACvE,CAE8B,CAChC"}

package/dist/services/globalStore.d.cts

@@ -0,0 +1,7 @@
+import { GlobalStore } from "../types/webPlugin.cjs";
+//#region src/services/globalStore.d.ts
+/** Page-wide plugin state shared by every contribution from the plugin. */
+declare function defineGlobalStore<T>(initial: T): GlobalStore<T>;
+//#endregion
+export { defineGlobalStore };
+//# sourceMappingURL=globalStore.d.cts.map

package/dist/services/globalStore.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalStore.d.cts","names":[],"sources":["../../src/services/globalStore.ts"],"mappings":";;;iBAIgB,kBAAkB,GAAG,SAAS,IAAI,YAAY"}

package/dist/services/globalStore.d.mts

@@ -0,0 +1,7 @@
+import { GlobalStore } from "../types/webPlugin.mjs";
+//#region src/services/globalStore.d.ts
+/** Page-wide plugin state shared by every contribution from the plugin. */
+declare function defineGlobalStore<T>(initial: T): GlobalStore<T>;
+//#endregion
+export { defineGlobalStore };
+//# sourceMappingURL=globalStore.d.mts.map

package/dist/services/globalStore.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalStore.d.mts","names":[],"sources":["../../src/services/globalStore.ts"],"mappings":";;;iBAIgB,kBAAkB,GAAG,SAAS,IAAI,YAAY"}

package/dist/services/globalStore.mjs

@@ -0,0 +1,2 @@
+import{Store as e}from"@tanstack/store";function t(t){let n=new e(t);return{store:n,update:e=>{let t=n.state,r=e(t);r!==t&&n.setState(()=>r)},reset:()=>{n.setState(e=>e===t?e:t)}}}export{t as defineGlobalStore};
+//# sourceMappingURL=globalStore.mjs.map

package/dist/services/globalStore.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalStore.mjs","names":[],"sources":["../../src/services/globalStore.ts"],"sourcesContent":["import { Store } from '@tanstack/store';\nimport type { GlobalStore } from '../types/webPlugin.ts';\n\n/** Page-wide plugin state shared by every contribution from the plugin. */\nexport function defineGlobalStore<T>(initial: T): GlobalStore<T> {\n  const store = new Store<T>(initial);\n\n  const update = (updater: (current: T) => T): void => {\n    const current = store.state;\n    const next = updater(current);\n    if (next !== current) store.setState(() => next);\n  };\n\n  const reset = (): void => {\n    store.setState((current) => (current === initial ? current : initial));\n  };\n\n  return { store, update, reset };\n}\n"],"mappings":"wCAIA,SAAgB,EAAqB,EAA4B,CAC/D,IAAM,EAAQ,IAAI,EAAS,CAAO,EAYlC,MAAO,CAAE,QAAO,OAVA,GAAqC,CACnD,IAAM,EAAU,EAAM,MAChB,EAAO,EAAQ,CAAO,EACxB,IAAS,GAAS,EAAM,aAAe,CAAI,CACjD,EAMwB,UAJE,CACxB,EAAM,SAAU,GAAa,IAAY,EAAU,EAAU,CAAQ,CACvE,CAE8B,CAChC"}

package/dist/services/testing/channels.cjs

@@ -1,2 +1,2 @@
-function e(e,t,n){let r=e.parse(n);return r===null?{accepted:!1}:(e.apply(t,r),{accepted:!0})}const t={sessionId:`s1`,cwd:`/repo`};function n(e,n={}){let r=[...n.sessions??[t]],i=[],a=[],o=e.start({sessions:()=>r,publish:(t,n)=>{i.push({type:e.frameType,sessionId:t,payload:n})},onNotice:e=>a.push(e)});return{source:o,published:i,notices:a,snapshot(e){let n=r.find(t=>t.sessionId===e)??r[0]??t;return o.payloadFor(n)},addSession(e){r.push(e),o.sessionAdded?.(e)},removeSession(e){let t=r.findIndex(t=>t.sessionId===e);t>=0&&r.splice(t,1),o.sessionRemoved?.(e)},close:()=>o.close()}}exports.driveChannel=e,exports.hubChannelHarness=n;
+function e(e,t,n){let r=e.parse(n);return r===null?{accepted:!1}:(e.apply(t,r),{accepted:!0})}const t={sessionId:`s1`,cwd:`/repo`};function n(e,n={}){let r=[...n.sessions??[t]],i=[],a=[],o=e.start({sessions:()=>r,publish:(t,n)=>{i.push({type:e.frameType,sessionId:t,payload:n})},requestSessionApi:()=>Promise.resolve(Response.json({error:`No session API in the channel harness.`},{status:501})),onNotice:e=>a.push(e)});return{source:o,published:i,notices:a,snapshot(e){let n=r.find(t=>t.sessionId===e)??r[0]??t;return o.payloadFor(n)},addSession(e){r.push(e),o.sessionAdded?.(e)},removeSession(e){let t=r.findIndex(t=>t.sessionId===e);t>=0&&r.splice(t,1),o.sessionRemoved?.(e)},close:()=>o.close()}}exports.driveChannel=e,exports.hubChannelHarness=n;
 //# sourceMappingURL=channels.cjs.map

package/dist/services/testing/channels.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"channels.cjs","names":[],"sources":["../../../src/services/testing/channels.ts"],"sourcesContent":["import type {\n  ChannelFrame,\n  HubChannelHost,\n  HubChannelSource,\n  HubSessionScope,\n  WebHubChannel,\n} from '../../types/webHub.ts';\nimport type { SessionChannelContribution } from '../../types/webPlugin.ts';\n\n/**\n * The two halves of a plugin's data channel, driven the way the hub drives them.\n *\n * A channel is the one place a plugin parses input it did not produce, so its\n * parse gate is the boundary that matters, and a test that calls `apply`\n * directly steps straight over it. `driveChannel` sends a wire payload the way\n * the page does: through `parse` first, and nothing applied when it is\n * rejected.\n */\n\nexport interface ChannelDelivery {\n  /** Whether the parse gate accepted the payload. */\n  accepted: boolean;\n}\n\n/**\n * Sends one wire payload to a session channel.\n *\n * Returns whether the gate accepted it, so a test can assert a rejection\n * without knowing what the plugin's parsed shape looks like.\n */\nexport function driveChannel(\n  channel: SessionChannelContribution,\n  sessionId: string,\n  payload: unknown,\n): ChannelDelivery {\n  const parsed: unknown = channel.parse(payload);\n  if (parsed === null) return { accepted: false };\n  channel.apply(sessionId, parsed);\n  return { accepted: true };\n}\n\nexport interface HubChannelHarness {\n  /** The running source, as the hub holds it. */\n  source: HubChannelSource;\n  /** Everything the source pushed, in order. */\n  readonly published: readonly ChannelFrame[];\n  /** What the source told the hub. */\n  readonly notices: readonly string[];\n  /** The subscribe-time snapshot one session would receive; undefined means no frame. */\n  snapshot(sessionId?: string): unknown;\n  /** Registers a session with the source, as the hub does when one appears. */\n  addSession(scope: HubSessionScope): void;\n  removeSession(sessionId: string): void;\n  close(): void;\n}\n\nexport interface HubChannelHarnessOptions {\n  /** Sessions the hub already manages when the channel starts. */\n  sessions?: readonly HubSessionScope[];\n}\n\nconst DEFAULT_SESSION: HubSessionScope = { sessionId: 's1', cwd: '/repo' };\n\n/**\n * A plugin's hub channel, started against a real host.\n *\n * The hub calls `payloadFor` once per subscriber and pushes through `publish`\n * afterwards, and a channel that only answers one of those looks correct in a\n * test that exercises the other.\n */\nexport function hubChannelHarness(channel: WebHubChannel, options: HubChannelHarnessOptions = {}): HubChannelHarness {\n  const sessions = [...(options.sessions ?? [DEFAULT_SESSION])];\n  const published: ChannelFrame[] = [];\n  const notices: string[] = [];\n  const host: HubChannelHost = {\n    sessions: () => sessions,\n    publish: (sessionId, payload) => {\n      published.push({ type: channel.frameType, sessionId, payload });\n    },\n    onNotice: (message) => notices.push(message),\n  };\n  const source = channel.start(host);\n\n  return {\n    source,\n    published,\n    notices,\n    snapshot(sessionId) {\n      const scope = sessions.find((candidate) => candidate.sessionId === sessionId) ?? sessions[0] ?? DEFAULT_SESSION;\n      return source.payloadFor(scope);\n    },\n    addSession(scope) {\n      sessions.push(scope);\n      source.sessionAdded?.(scope);\n    },\n    removeSession(sessionId) {\n      const index = sessions.findIndex((candidate) => candidate.sessionId === sessionId);\n      if (index >= 0) sessions.splice(index, 1);\n      source.sessionRemoved?.(sessionId);\n    },\n    close: () => source.close(),\n  };\n}\n"],"mappings":"AA8BA,SAAgB,EACd,EACA,EACA,EACiB,CACjB,IAAM,EAAkB,EAAQ,MAAM,CAAO,EAG7C,OAFI,IAAW,KAAa,CAAE,SAAU,EAAM,GAC9C,EAAQ,MAAM,EAAW,CAAM,EACxB,CAAE,SAAU,EAAK,EAC1B,CAsBA,MAAM,EAAmC,CAAE,UAAW,KAAM,IAAK,OAAQ,EASzE,SAAgB,EAAkB,EAAwB,EAAoC,CAAC,EAAsB,CACnH,IAAM,EAAW,CAAC,GAAI,EAAQ,UAAY,CAAC,CAAe,CAAE,EACtD,EAA4B,CAAC,EAC7B,EAAoB,CAAC,EAQrB,EAAS,EAAQ,MAAM,CAN3B,aAAgB,EAChB,SAAU,EAAW,IAAY,CAC/B,EAAU,KAAK,CAAE,KAAM,EAAQ,UAAW,YAAW,SAAQ,CAAC,CAChE,EACA,SAAW,GAAY,EAAQ,KAAK,CAAO,CAEb,CAAC,EAEjC,MAAO,CACL,SACA,YACA,UACA,SAAS,EAAW,CAClB,IAAM,EAAQ,EAAS,KAAM,GAAc,EAAU,YAAc,CAAS,GAAK,EAAS,IAAM,EAChG,OAAO,EAAO,WAAW,CAAK,CAChC,EACA,WAAW,EAAO,CAChB,EAAS,KAAK,CAAK,EACnB,EAAO,eAAe,CAAK,CAC7B,EACA,cAAc,EAAW,CACvB,IAAM,EAAQ,EAAS,UAAW,GAAc,EAAU,YAAc,CAAS,EAC7E,GAAS,GAAG,EAAS,OAAO,EAAO,CAAC,EACxC,EAAO,iBAAiB,CAAS,CACnC,EACA,UAAa,EAAO,MAAM,CAC5B,CACF"}
+{"version":3,"file":"channels.cjs","names":[],"sources":["../../../src/services/testing/channels.ts"],"sourcesContent":["import type {\n  ChannelFrame,\n  HubChannelHost,\n  HubChannelSource,\n  HubSessionScope,\n  WebHubChannel,\n} from '../../types/webHub.ts';\nimport type { SessionChannelContribution } from '../../types/webPlugin.ts';\n\n/**\n * The two halves of a plugin's data channel, driven the way the hub drives them.\n *\n * A channel is the one place a plugin parses input it did not produce, so its\n * parse gate is the boundary that matters, and a test that calls `apply`\n * directly steps straight over it. `driveChannel` sends a wire payload the way\n * the page does: through `parse` first, and nothing applied when it is\n * rejected.\n */\n\nexport interface ChannelDelivery {\n  /** Whether the parse gate accepted the payload. */\n  accepted: boolean;\n}\n\n/**\n * Sends one wire payload to a session channel.\n *\n * Returns whether the gate accepted it, so a test can assert a rejection\n * without knowing what the plugin's parsed shape looks like.\n */\nexport function driveChannel(\n  channel: SessionChannelContribution,\n  sessionId: string,\n  payload: unknown,\n): ChannelDelivery {\n  const parsed: unknown = channel.parse(payload);\n  if (parsed === null) return { accepted: false };\n  channel.apply(sessionId, parsed);\n  return { accepted: true };\n}\n\nexport interface HubChannelHarness {\n  /** The running source, as the hub holds it. */\n  source: HubChannelSource;\n  /** Everything the source pushed, in order. */\n  readonly published: readonly ChannelFrame[];\n  /** What the source told the hub. */\n  readonly notices: readonly string[];\n  /** The subscribe-time snapshot one session would receive; undefined means no frame. */\n  snapshot(sessionId?: string): unknown;\n  /** Registers a session with the source, as the hub does when one appears. */\n  addSession(scope: HubSessionScope): void;\n  removeSession(sessionId: string): void;\n  close(): void;\n}\n\nexport interface HubChannelHarnessOptions {\n  /** Sessions the hub already manages when the channel starts. */\n  sessions?: readonly HubSessionScope[];\n}\n\nconst DEFAULT_SESSION: HubSessionScope = { sessionId: 's1', cwd: '/repo' };\n\n/**\n * A plugin's hub channel, started against a real host.\n *\n * The hub calls `payloadFor` once per subscriber and pushes through `publish`\n * afterwards, and a channel that only answers one of those looks correct in a\n * test that exercises the other.\n */\nexport function hubChannelHarness(channel: WebHubChannel, options: HubChannelHarnessOptions = {}): HubChannelHarness {\n  const sessions = [...(options.sessions ?? [DEFAULT_SESSION])];\n  const published: ChannelFrame[] = [];\n  const notices: string[] = [];\n  const host: HubChannelHost = {\n    sessions: () => sessions,\n    publish: (sessionId, payload) => {\n      published.push({ type: channel.frameType, sessionId, payload });\n    },\n    requestSessionApi: () =>\n      Promise.resolve(Response.json({ error: 'No session API in the channel harness.' }, { status: 501 })),\n    onNotice: (message) => notices.push(message),\n  };\n  const source = channel.start(host);\n\n  return {\n    source,\n    published,\n    notices,\n    snapshot(sessionId) {\n      const scope = sessions.find((candidate) => candidate.sessionId === sessionId) ?? sessions[0] ?? DEFAULT_SESSION;\n      return source.payloadFor(scope);\n    },\n    addSession(scope) {\n      sessions.push(scope);\n      source.sessionAdded?.(scope);\n    },\n    removeSession(sessionId) {\n      const index = sessions.findIndex((candidate) => candidate.sessionId === sessionId);\n      if (index >= 0) sessions.splice(index, 1);\n      source.sessionRemoved?.(sessionId);\n    },\n    close: () => source.close(),\n  };\n}\n"],"mappings":"AA8BA,SAAgB,EACd,EACA,EACA,EACiB,CACjB,IAAM,EAAkB,EAAQ,MAAM,CAAO,EAG7C,OAFI,IAAW,KAAa,CAAE,SAAU,EAAM,GAC9C,EAAQ,MAAM,EAAW,CAAM,EACxB,CAAE,SAAU,EAAK,EAC1B,CAsBA,MAAM,EAAmC,CAAE,UAAW,KAAM,IAAK,OAAQ,EASzE,SAAgB,EAAkB,EAAwB,EAAoC,CAAC,EAAsB,CACnH,IAAM,EAAW,CAAC,GAAI,EAAQ,UAAY,CAAC,CAAe,CAAE,EACtD,EAA4B,CAAC,EAC7B,EAAoB,CAAC,EAUrB,EAAS,EAAQ,MAAM,CAR3B,aAAgB,EAChB,SAAU,EAAW,IAAY,CAC/B,EAAU,KAAK,CAAE,KAAM,EAAQ,UAAW,YAAW,SAAQ,CAAC,CAChE,EACA,sBACE,QAAQ,QAAQ,SAAS,KAAK,CAAE,MAAO,wCAAyC,EAAG,CAAE,OAAQ,GAAI,CAAC,CAAC,EACrG,SAAW,GAAY,EAAQ,KAAK,CAAO,CAEb,CAAC,EAEjC,MAAO,CACL,SACA,YACA,UACA,SAAS,EAAW,CAClB,IAAM,EAAQ,EAAS,KAAM,GAAc,EAAU,YAAc,CAAS,GAAK,EAAS,IAAM,EAChG,OAAO,EAAO,WAAW,CAAK,CAChC,EACA,WAAW,EAAO,CAChB,EAAS,KAAK,CAAK,EACnB,EAAO,eAAe,CAAK,CAC7B,EACA,cAAc,EAAW,CACvB,IAAM,EAAQ,EAAS,UAAW,GAAc,EAAU,YAAc,CAAS,EAC7E,GAAS,GAAG,EAAS,OAAO,EAAO,CAAC,EACxC,EAAO,iBAAiB,CAAS,CACnC,EACA,UAAa,EAAO,MAAM,CAC5B,CACF"}

package/dist/services/testing/channels.mjs

@@ -1,2 +1,2 @@
-function e(e,t,n){let r=e.parse(n);return r===null?{accepted:!1}:(e.apply(t,r),{accepted:!0})}const t={sessionId:`s1`,cwd:`/repo`};function n(e,n={}){let r=[...n.sessions??[t]],i=[],a=[],o=e.start({sessions:()=>r,publish:(t,n)=>{i.push({type:e.frameType,sessionId:t,payload:n})},onNotice:e=>a.push(e)});return{source:o,published:i,notices:a,snapshot(e){let n=r.find(t=>t.sessionId===e)??r[0]??t;return o.payloadFor(n)},addSession(e){r.push(e),o.sessionAdded?.(e)},removeSession(e){let t=r.findIndex(t=>t.sessionId===e);t>=0&&r.splice(t,1),o.sessionRemoved?.(e)},close:()=>o.close()}}export{e as driveChannel,n as hubChannelHarness};
+function e(e,t,n){let r=e.parse(n);return r===null?{accepted:!1}:(e.apply(t,r),{accepted:!0})}const t={sessionId:`s1`,cwd:`/repo`};function n(e,n={}){let r=[...n.sessions??[t]],i=[],a=[],o=e.start({sessions:()=>r,publish:(t,n)=>{i.push({type:e.frameType,sessionId:t,payload:n})},requestSessionApi:()=>Promise.resolve(Response.json({error:`No session API in the channel harness.`},{status:501})),onNotice:e=>a.push(e)});return{source:o,published:i,notices:a,snapshot(e){let n=r.find(t=>t.sessionId===e)??r[0]??t;return o.payloadFor(n)},addSession(e){r.push(e),o.sessionAdded?.(e)},removeSession(e){let t=r.findIndex(t=>t.sessionId===e);t>=0&&r.splice(t,1),o.sessionRemoved?.(e)},close:()=>o.close()}}export{e as driveChannel,n as hubChannelHarness};
 //# sourceMappingURL=channels.mjs.map

package/dist/services/testing/channels.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"channels.mjs","names":[],"sources":["../../../src/services/testing/channels.ts"],"sourcesContent":["import type {\n  ChannelFrame,\n  HubChannelHost,\n  HubChannelSource,\n  HubSessionScope,\n  WebHubChannel,\n} from '../../types/webHub.ts';\nimport type { SessionChannelContribution } from '../../types/webPlugin.ts';\n\n/**\n * The two halves of a plugin's data channel, driven the way the hub drives them.\n *\n * A channel is the one place a plugin parses input it did not produce, so its\n * parse gate is the boundary that matters, and a test that calls `apply`\n * directly steps straight over it. `driveChannel` sends a wire payload the way\n * the page does: through `parse` first, and nothing applied when it is\n * rejected.\n */\n\nexport interface ChannelDelivery {\n  /** Whether the parse gate accepted the payload. */\n  accepted: boolean;\n}\n\n/**\n * Sends one wire payload to a session channel.\n *\n * Returns whether the gate accepted it, so a test can assert a rejection\n * without knowing what the plugin's parsed shape looks like.\n */\nexport function driveChannel(\n  channel: SessionChannelContribution,\n  sessionId: string,\n  payload: unknown,\n): ChannelDelivery {\n  const parsed: unknown = channel.parse(payload);\n  if (parsed === null) return { accepted: false };\n  channel.apply(sessionId, parsed);\n  return { accepted: true };\n}\n\nexport interface HubChannelHarness {\n  /** The running source, as the hub holds it. */\n  source: HubChannelSource;\n  /** Everything the source pushed, in order. */\n  readonly published: readonly ChannelFrame[];\n  /** What the source told the hub. */\n  readonly notices: readonly string[];\n  /** The subscribe-time snapshot one session would receive; undefined means no frame. */\n  snapshot(sessionId?: string): unknown;\n  /** Registers a session with the source, as the hub does when one appears. */\n  addSession(scope: HubSessionScope): void;\n  removeSession(sessionId: string): void;\n  close(): void;\n}\n\nexport interface HubChannelHarnessOptions {\n  /** Sessions the hub already manages when the channel starts. */\n  sessions?: readonly HubSessionScope[];\n}\n\nconst DEFAULT_SESSION: HubSessionScope = { sessionId: 's1', cwd: '/repo' };\n\n/**\n * A plugin's hub channel, started against a real host.\n *\n * The hub calls `payloadFor` once per subscriber and pushes through `publish`\n * afterwards, and a channel that only answers one of those looks correct in a\n * test that exercises the other.\n */\nexport function hubChannelHarness(channel: WebHubChannel, options: HubChannelHarnessOptions = {}): HubChannelHarness {\n  const sessions = [...(options.sessions ?? [DEFAULT_SESSION])];\n  const published: ChannelFrame[] = [];\n  const notices: string[] = [];\n  const host: HubChannelHost = {\n    sessions: () => sessions,\n    publish: (sessionId, payload) => {\n      published.push({ type: channel.frameType, sessionId, payload });\n    },\n    onNotice: (message) => notices.push(message),\n  };\n  const source = channel.start(host);\n\n  return {\n    source,\n    published,\n    notices,\n    snapshot(sessionId) {\n      const scope = sessions.find((candidate) => candidate.sessionId === sessionId) ?? sessions[0] ?? DEFAULT_SESSION;\n      return source.payloadFor(scope);\n    },\n    addSession(scope) {\n      sessions.push(scope);\n      source.sessionAdded?.(scope);\n    },\n    removeSession(sessionId) {\n      const index = sessions.findIndex((candidate) => candidate.sessionId === sessionId);\n      if (index >= 0) sessions.splice(index, 1);\n      source.sessionRemoved?.(sessionId);\n    },\n    close: () => source.close(),\n  };\n}\n"],"mappings":"AA8BA,SAAgB,EACd,EACA,EACA,EACiB,CACjB,IAAM,EAAkB,EAAQ,MAAM,CAAO,EAG7C,OAFI,IAAW,KAAa,CAAE,SAAU,EAAM,GAC9C,EAAQ,MAAM,EAAW,CAAM,EACxB,CAAE,SAAU,EAAK,EAC1B,CAsBA,MAAM,EAAmC,CAAE,UAAW,KAAM,IAAK,OAAQ,EASzE,SAAgB,EAAkB,EAAwB,EAAoC,CAAC,EAAsB,CACnH,IAAM,EAAW,CAAC,GAAI,EAAQ,UAAY,CAAC,CAAe,CAAE,EACtD,EAA4B,CAAC,EAC7B,EAAoB,CAAC,EAQrB,EAAS,EAAQ,MAAM,CAN3B,aAAgB,EAChB,SAAU,EAAW,IAAY,CAC/B,EAAU,KAAK,CAAE,KAAM,EAAQ,UAAW,YAAW,SAAQ,CAAC,CAChE,EACA,SAAW,GAAY,EAAQ,KAAK,CAAO,CAEb,CAAC,EAEjC,MAAO,CACL,SACA,YACA,UACA,SAAS,EAAW,CAClB,IAAM,EAAQ,EAAS,KAAM,GAAc,EAAU,YAAc,CAAS,GAAK,EAAS,IAAM,EAChG,OAAO,EAAO,WAAW,CAAK,CAChC,EACA,WAAW,EAAO,CAChB,EAAS,KAAK,CAAK,EACnB,EAAO,eAAe,CAAK,CAC7B,EACA,cAAc,EAAW,CACvB,IAAM,EAAQ,EAAS,UAAW,GAAc,EAAU,YAAc,CAAS,EAC7E,GAAS,GAAG,EAAS,OAAO,EAAO,CAAC,EACxC,EAAO,iBAAiB,CAAS,CACnC,EACA,UAAa,EAAO,MAAM,CAC5B,CACF"}
+{"version":3,"file":"channels.mjs","names":[],"sources":["../../../src/services/testing/channels.ts"],"sourcesContent":["import type {\n  ChannelFrame,\n  HubChannelHost,\n  HubChannelSource,\n  HubSessionScope,\n  WebHubChannel,\n} from '../../types/webHub.ts';\nimport type { SessionChannelContribution } from '../../types/webPlugin.ts';\n\n/**\n * The two halves of a plugin's data channel, driven the way the hub drives them.\n *\n * A channel is the one place a plugin parses input it did not produce, so its\n * parse gate is the boundary that matters, and a test that calls `apply`\n * directly steps straight over it. `driveChannel` sends a wire payload the way\n * the page does: through `parse` first, and nothing applied when it is\n * rejected.\n */\n\nexport interface ChannelDelivery {\n  /** Whether the parse gate accepted the payload. */\n  accepted: boolean;\n}\n\n/**\n * Sends one wire payload to a session channel.\n *\n * Returns whether the gate accepted it, so a test can assert a rejection\n * without knowing what the plugin's parsed shape looks like.\n */\nexport function driveChannel(\n  channel: SessionChannelContribution,\n  sessionId: string,\n  payload: unknown,\n): ChannelDelivery {\n  const parsed: unknown = channel.parse(payload);\n  if (parsed === null) return { accepted: false };\n  channel.apply(sessionId, parsed);\n  return { accepted: true };\n}\n\nexport interface HubChannelHarness {\n  /** The running source, as the hub holds it. */\n  source: HubChannelSource;\n  /** Everything the source pushed, in order. */\n  readonly published: readonly ChannelFrame[];\n  /** What the source told the hub. */\n  readonly notices: readonly string[];\n  /** The subscribe-time snapshot one session would receive; undefined means no frame. */\n  snapshot(sessionId?: string): unknown;\n  /** Registers a session with the source, as the hub does when one appears. */\n  addSession(scope: HubSessionScope): void;\n  removeSession(sessionId: string): void;\n  close(): void;\n}\n\nexport interface HubChannelHarnessOptions {\n  /** Sessions the hub already manages when the channel starts. */\n  sessions?: readonly HubSessionScope[];\n}\n\nconst DEFAULT_SESSION: HubSessionScope = { sessionId: 's1', cwd: '/repo' };\n\n/**\n * A plugin's hub channel, started against a real host.\n *\n * The hub calls `payloadFor` once per subscriber and pushes through `publish`\n * afterwards, and a channel that only answers one of those looks correct in a\n * test that exercises the other.\n */\nexport function hubChannelHarness(channel: WebHubChannel, options: HubChannelHarnessOptions = {}): HubChannelHarness {\n  const sessions = [...(options.sessions ?? [DEFAULT_SESSION])];\n  const published: ChannelFrame[] = [];\n  const notices: string[] = [];\n  const host: HubChannelHost = {\n    sessions: () => sessions,\n    publish: (sessionId, payload) => {\n      published.push({ type: channel.frameType, sessionId, payload });\n    },\n    requestSessionApi: () =>\n      Promise.resolve(Response.json({ error: 'No session API in the channel harness.' }, { status: 501 })),\n    onNotice: (message) => notices.push(message),\n  };\n  const source = channel.start(host);\n\n  return {\n    source,\n    published,\n    notices,\n    snapshot(sessionId) {\n      const scope = sessions.find((candidate) => candidate.sessionId === sessionId) ?? sessions[0] ?? DEFAULT_SESSION;\n      return source.payloadFor(scope);\n    },\n    addSession(scope) {\n      sessions.push(scope);\n      source.sessionAdded?.(scope);\n    },\n    removeSession(sessionId) {\n      const index = sessions.findIndex((candidate) => candidate.sessionId === sessionId);\n      if (index >= 0) sessions.splice(index, 1);\n      source.sessionRemoved?.(sessionId);\n    },\n    close: () => source.close(),\n  };\n}\n"],"mappings":"AA8BA,SAAgB,EACd,EACA,EACA,EACiB,CACjB,IAAM,EAAkB,EAAQ,MAAM,CAAO,EAG7C,OAFI,IAAW,KAAa,CAAE,SAAU,EAAM,GAC9C,EAAQ,MAAM,EAAW,CAAM,EACxB,CAAE,SAAU,EAAK,EAC1B,CAsBA,MAAM,EAAmC,CAAE,UAAW,KAAM,IAAK,OAAQ,EASzE,SAAgB,EAAkB,EAAwB,EAAoC,CAAC,EAAsB,CACnH,IAAM,EAAW,CAAC,GAAI,EAAQ,UAAY,CAAC,CAAe,CAAE,EACtD,EAA4B,CAAC,EAC7B,EAAoB,CAAC,EAUrB,EAAS,EAAQ,MAAM,CAR3B,aAAgB,EAChB,SAAU,EAAW,IAAY,CAC/B,EAAU,KAAK,CAAE,KAAM,EAAQ,UAAW,YAAW,SAAQ,CAAC,CAChE,EACA,sBACE,QAAQ,QAAQ,SAAS,KAAK,CAAE,MAAO,wCAAyC,EAAG,CAAE,OAAQ,GAAI,CAAC,CAAC,EACrG,SAAW,GAAY,EAAQ,KAAK,CAAO,CAEb,CAAC,EAEjC,MAAO,CACL,SACA,YACA,UACA,SAAS,EAAW,CAClB,IAAM,EAAQ,EAAS,KAAM,GAAc,EAAU,YAAc,CAAS,GAAK,EAAS,IAAM,EAChG,OAAO,EAAO,WAAW,CAAK,CAChC,EACA,WAAW,EAAO,CAChB,EAAS,KAAK,CAAK,EACnB,EAAO,eAAe,CAAK,CAC7B,EACA,cAAc,EAAW,CACvB,IAAM,EAAQ,EAAS,UAAW,GAAc,EAAU,YAAc,CAAS,EAC7E,GAAS,GAAG,EAAS,OAAO,EAAO,CAAC,EACxC,EAAO,iBAAiB,CAAS,CACnC,EACA,UAAa,EAAO,MAAM,CAC5B,CACF"}

package/dist/services/testing/slotProps.cjs

@@ -1,2 +1,2 @@
-function e(e={}){let t=[];return{props:{sessionId:e.sessionId===void 0?`s1`:e.sessionId,statuses:e.statuses??{},openTab:e=>{t.push({action:`openTab`,target:e})},openTransientTab:e=>{t.push({action:`openTransientTab`,target:e.id})},closeTransientTab:e=>{t.push({action:`closeTransientTab`,target:e})},sendSessionFrame:(e,n)=>{t.push({action:`sendSessionFrame`,target:e,frame:n})},renderThread:t=>e.thread?.(t)??null,renderSlot:t=>e.slotContent?.[t]??null,slotData:t=>e.slotData?.[t.slot]??[]},actions:t,frames:()=>t.flatMap(e=>e.frame?[e.frame]:[])}}function t(t){let n=e(t),r=t.result===void 0?null:t.result;return{...n,props:{...n.props,toolCallId:t.toolCallId??`call-1`,toolName:t.toolName,args:t.args??{},result:r,output:t.output??``,running:t.running??!1,isError:t.isError??!1}}}exports.slotPropsFixture=e,exports.toolMessagePropsFixture=t;
+function e(e={}){let t=[],n={sessionId:e.sessionId===void 0?`s1`:e.sessionId,statuses:e.statuses??{},contextInventory:e.contextInventory??[],openTab:e=>{t.push({action:`openTab`,target:e})},openTransientTab:e=>{t.push({action:`openTransientTab`,target:e.id})},closeTransientTab:e=>{t.push({action:`closeTransientTab`,target:e})},fileTabFor:t=>e.fileTab?.(t),appendComposerDraft:e=>{t.push({action:`appendComposerDraft`,target:n.sessionId,text:e})},attachComposerContext:e=>{t.push({action:`attachComposerContext`,target:n.sessionId,context:e})},attachComposerCapture:e=>{t.push({action:`attachComposerCapture`,target:n.sessionId,capture:e})},contextActionsFor:t=>e.contextActions?.(t)??[],sendSessionFrame:(e,n)=>{t.push({action:`sendSessionFrame`,target:e,frame:n})},renderThread:(t,n)=>e.thread?.(t,n)??null,renderSlot:t=>e.slotContent?.[t]??null,slotData:t=>e.slotData?.[t.slot]??[]};return{props:n,actions:t,frames:()=>t.flatMap(e=>e.frame?[e.frame]:[])}}function t(t){let n=e(t),r=t.result===void 0?null:t.result;return{...n,props:{...n.props,toolCallId:t.toolCallId??`call-1`,toolName:t.toolName,args:t.args??{},result:r,output:t.output??``,running:t.running??!1,isError:t.isError??!1}}}exports.slotPropsFixture=e,exports.toolMessagePropsFixture=t;
 //# sourceMappingURL=slotProps.cjs.map

package/dist/services/testing/slotProps.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"slotProps.cjs","names":[],"sources":["../../../src/services/testing/slotProps.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type {\n  SlotDataFill,\n  SlotDeclaration,\n  ToolMessageRenderProps,\n  ToolResultView,\n  TransientTab,\n  WebPluginSlotProps,\n} from '../../types/webPlugin.ts';\n\n/**\n * The props the cockpit hands a plugin's components, built for a test.\n *\n * A plugin component takes fifteen props and reads three of them. Written out\n * by hand in each test, the other twelve are noise that goes stale the moment\n * the contract grows a member; written as a cast, the component compiles\n * against props the host never sends. This builds all of them, records what the\n * component did with the actions, and lets a test override the two or three it\n * cares about.\n */\n\nexport interface RecordedSlotAction {\n  action: 'openTab' | 'openTransientTab' | 'closeTransientTab' | 'sendSessionFrame';\n  /** The tab id, the transient tab's id, or the target session of a frame. */\n  target: string | null;\n  /** The frame a component sent, for `sendSessionFrame`. */\n  frame?: Record<string, unknown>;\n}\n\nexport interface SlotPropsFixture {\n  props: WebPluginSlotProps;\n  /** Everything the component did through its props, in order. */\n  readonly actions: readonly RecordedSlotAction[];\n  /** Frames the component sent, which is what most assertions want. */\n  frames(): readonly Record<string, unknown>[];\n}\n\nexport interface SlotPropsOptions {\n  sessionId?: string | null;\n  statuses?: Readonly<Record<string, string>>;\n  /** Component fills this slot owner should see; keyed by slot name. */\n  slotContent?: Readonly<Record<string, ReactNode>>;\n  /** Data fills this slot owner should read back, keyed by slot name. */\n  slotData?: Readonly<Record<string, readonly SlotDataFill[]>>;\n  /** What `renderThread` returns for a plugin that renders one. */\n  thread?: (threadId: string) => ReactNode;\n}\n\nconst DEFAULT_SESSION_ID = 's1';\n\nexport function slotPropsFixture(options: SlotPropsOptions = {}): SlotPropsFixture {\n  const actions: RecordedSlotAction[] = [];\n  const props: WebPluginSlotProps = {\n    sessionId: options.sessionId === undefined ? DEFAULT_SESSION_ID : options.sessionId,\n    statuses: options.statuses ?? {},\n    openTab: (tabId) => {\n      actions.push({ action: 'openTab', target: tabId });\n    },\n    openTransientTab: (tab: TransientTab) => {\n      actions.push({ action: 'openTransientTab', target: tab.id });\n    },\n    closeTransientTab: (tabId: string) => {\n      actions.push({ action: 'closeTransientTab', target: tabId });\n    },\n    sendSessionFrame: (sessionId, frame) => {\n      actions.push({ action: 'sendSessionFrame', target: sessionId, frame });\n    },\n    renderThread: (threadId) => options.thread?.(threadId) ?? null,\n    renderSlot: (slot) => options.slotContent?.[slot] ?? null,\n    // The host resolves fills by slot name and hands the owner its own typed\n    // view, so a test declares them by name too.\n    slotData: <Data>(slot: SlotDeclaration<Data>) =>\n      (options.slotData?.[slot.slot] ?? []) as readonly SlotDataFill<Data>[],\n  };\n\n  return {\n    props,\n    actions,\n    frames: () => actions.flatMap((entry) => (entry.frame ? [entry.frame] : [])),\n  };\n}\n\nexport interface ToolMessagePropsOptions extends SlotPropsOptions {\n  toolCallId?: string;\n  toolName: string;\n  args?: Record<string, unknown>;\n  /** The newest result; null is what the host sends before any output. */\n  result?: ToolResultView | null;\n  /** The result's text blocks joined, as the host's own fallback item shows them. */\n  output?: string;\n  running?: boolean;\n  isError?: boolean;\n}\n\nexport interface ToolMessagePropsFixture extends Omit<SlotPropsFixture, 'props'> {\n  props: ToolMessageRenderProps;\n}\n\nconst DEFAULT_TOOL_CALL_ID = 'call-1';\n\n/** The props a tool's timeline item receives, in any of its four states. */\nexport function toolMessagePropsFixture(options: ToolMessagePropsOptions): ToolMessagePropsFixture {\n  const base = slotPropsFixture(options);\n  const result = options.result === undefined ? null : options.result;\n  return {\n    ...base,\n    props: {\n      ...base.props,\n      toolCallId: options.toolCallId ?? DEFAULT_TOOL_CALL_ID,\n      toolName: options.toolName,\n      args: options.args ?? {},\n      result,\n      output: options.output ?? '',\n      running: options.running ?? false,\n      isError: options.isError ?? false,\n    },\n  };\n}\n"],"mappings":"AAkDA,SAAgB,EAAiB,EAA4B,CAAC,EAAqB,CACjF,IAAM,EAAgC,CAAC,EAwBvC,MAAO,CACL,MAAA,CAvBA,UAAW,EAAQ,YAAc,IAAA,GAAY,KAAqB,EAAQ,UAC1E,SAAU,EAAQ,UAAY,CAAC,EAC/B,QAAU,GAAU,CAClB,EAAQ,KAAK,CAAE,OAAQ,UAAW,OAAQ,CAAM,CAAC,CACnD,EACA,iBAAmB,GAAsB,CACvC,EAAQ,KAAK,CAAE,OAAQ,mBAAoB,OAAQ,EAAI,EAAG,CAAC,CAC7D,EACA,kBAAoB,GAAkB,CACpC,EAAQ,KAAK,CAAE,OAAQ,oBAAqB,OAAQ,CAAM,CAAC,CAC7D,EACA,kBAAmB,EAAW,IAAU,CACtC,EAAQ,KAAK,CAAE,OAAQ,mBAAoB,OAAQ,EAAW,OAAM,CAAC,CACvE,EACA,aAAe,GAAa,EAAQ,SAAS,CAAQ,GAAK,KAC1D,WAAa,GAAS,EAAQ,cAAc,IAAS,KAGrD,SAAiB,GACd,EAAQ,WAAW,EAAK,OAAS,CAAC,CAIjC,EACJ,UACA,WAAc,EAAQ,QAAS,GAAW,EAAM,MAAQ,CAAC,EAAM,KAAK,EAAI,CAAC,CAAE,CAC7E,CACF,CAqBA,SAAgB,EAAwB,EAA2D,CACjG,IAAM,EAAO,EAAiB,CAAO,EAC/B,EAAS,EAAQ,SAAW,IAAA,GAAY,KAAO,EAAQ,OAC7D,MAAO,CACL,GAAG,EACH,MAAO,CACL,GAAG,EAAK,MACR,WAAY,EAAQ,YAAc,SAClC,SAAU,EAAQ,SAClB,KAAM,EAAQ,MAAQ,CAAC,EACvB,SACA,OAAQ,EAAQ,QAAU,GAC1B,QAAS,EAAQ,SAAW,GAC5B,QAAS,EAAQ,SAAW,EAC9B,CACF,CACF"}
+{"version":3,"file":"slotProps.cjs","names":[],"sources":["../../../src/services/testing/slotProps.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type {\n  ComposerCapture,\n  ContextAction,\n  SlotDataFill,\n  SlotDeclaration,\n  ThreadViewOptions,\n  ToolMessageRenderProps,\n  ToolResultView,\n  TransientTab,\n  WebPluginContextItem,\n  WebPluginSlotProps,\n} from '../../types/webPlugin.ts';\n\n/**\n * The props the cockpit hands a plugin's components, built for a test.\n *\n * A plugin component takes fifteen props and reads three of them. Written out\n * by hand in each test, the other twelve are noise that goes stale the moment\n * the contract grows a member; written as a cast, the component compiles\n * against props the host never sends. This builds all of them, records what the\n * component did with the actions, and lets a test override the two or three it\n * cares about.\n */\n\nexport interface RecordedSlotAction {\n  action:\n    | 'appendComposerDraft'\n    | 'attachComposerCapture'\n    | 'attachComposerContext'\n    | 'openTab'\n    | 'openTransientTab'\n    | 'closeTransientTab'\n    | 'sendSessionFrame';\n  /** The tab id, the transient tab's id, or the target session of a frame or composer action. */\n  target: string | null;\n  /** The text passed to `appendComposerDraft`. */\n  text?: string;\n  /** The structured item passed to `attachComposerContext`. */\n  context?: WebPluginContextItem;\n  /** The atomic screenshot and context passed to `attachComposerCapture`. */\n  capture?: ComposerCapture;\n  /** The frame a component sent, for `sendSessionFrame`. */\n  frame?: Record<string, unknown>;\n}\n\nexport interface SlotPropsFixture {\n  props: WebPluginSlotProps;\n  /** Everything the component did through its props, in order. */\n  readonly actions: readonly RecordedSlotAction[];\n  /** Frames the component sent, which is what most assertions want. */\n  frames(): readonly Record<string, unknown>[];\n}\n\nexport interface SlotPropsOptions {\n  sessionId?: string | null;\n  statuses?: Readonly<Record<string, string>>;\n  contextInventory?: WebPluginSlotProps['contextInventory'];\n  /** Component fills this slot owner should see; keyed by slot name. */\n  slotContent?: Readonly<Record<string, ReactNode>>;\n  /** Data fills this slot owner should read back, keyed by slot name. */\n  slotData?: Readonly<Record<string, readonly SlotDataFill[]>>;\n  /** What `renderThread` returns for a plugin that renders one. */\n  thread?: (threadId: string, options?: ThreadViewOptions) => ReactNode;\n  /** The tab a path opens; by default no path opens one, as with no file plugin installed. */\n  fileTab?: (path: string) => TransientTab | undefined;\n  /** Context actions installed plugins should offer for the item under test. */\n  contextActions?: (item: WebPluginContextItem) => readonly ContextAction[];\n}\n\nconst DEFAULT_SESSION_ID = 's1';\n\nexport function slotPropsFixture(options: SlotPropsOptions = {}): SlotPropsFixture {\n  const actions: RecordedSlotAction[] = [];\n  const props: WebPluginSlotProps = {\n    sessionId: options.sessionId === undefined ? DEFAULT_SESSION_ID : options.sessionId,\n    statuses: options.statuses ?? {},\n    contextInventory: options.contextInventory ?? [],\n    openTab: (tabId) => {\n      actions.push({ action: 'openTab', target: tabId });\n    },\n    openTransientTab: (tab: TransientTab) => {\n      actions.push({ action: 'openTransientTab', target: tab.id });\n    },\n    closeTransientTab: (tabId: string) => {\n      actions.push({ action: 'closeTransientTab', target: tabId });\n    },\n    fileTabFor: (path: string) => options.fileTab?.(path),\n    appendComposerDraft: (text) => {\n      actions.push({ action: 'appendComposerDraft', target: props.sessionId, text });\n    },\n    attachComposerContext: (context) => {\n      actions.push({ action: 'attachComposerContext', target: props.sessionId, context });\n    },\n    attachComposerCapture: (capture) => {\n      actions.push({ action: 'attachComposerCapture', target: props.sessionId, capture });\n    },\n    contextActionsFor: (item) => options.contextActions?.(item) ?? [],\n    sendSessionFrame: (sessionId, frame) => {\n      actions.push({ action: 'sendSessionFrame', target: sessionId, frame });\n    },\n    renderThread: (threadId, threadOptions) => options.thread?.(threadId, threadOptions) ?? null,\n    renderSlot: (slot) => options.slotContent?.[slot] ?? null,\n    // The host resolves fills by slot name and hands the owner its own typed\n    // view, so a test declares them by name too.\n    slotData: <Data>(slot: SlotDeclaration<Data>) =>\n      (options.slotData?.[slot.slot] ?? []) as readonly SlotDataFill<Data>[],\n  };\n\n  return {\n    props,\n    actions,\n    frames: () => actions.flatMap((entry) => (entry.frame ? [entry.frame] : [])),\n  };\n}\n\nexport interface ToolMessagePropsOptions extends SlotPropsOptions {\n  toolCallId?: string;\n  toolName: string;\n  args?: Record<string, unknown>;\n  /** The newest result; null is what the host sends before any output. */\n  result?: ToolResultView | null;\n  /** The result's text blocks joined, as the host's own fallback item shows them. */\n  output?: string;\n  running?: boolean;\n  isError?: boolean;\n}\n\nexport interface ToolMessagePropsFixture extends Omit<SlotPropsFixture, 'props'> {\n  props: ToolMessageRenderProps;\n}\n\nconst DEFAULT_TOOL_CALL_ID = 'call-1';\n\n/** The props a tool's timeline item receives, in any of its four states. */\nexport function toolMessagePropsFixture(options: ToolMessagePropsOptions): ToolMessagePropsFixture {\n  const base = slotPropsFixture(options);\n  const result = options.result === undefined ? null : options.result;\n  return {\n    ...base,\n    props: {\n      ...base.props,\n      toolCallId: options.toolCallId ?? DEFAULT_TOOL_CALL_ID,\n      toolName: options.toolName,\n      args: options.args ?? {},\n      result,\n      output: options.output ?? '',\n      running: options.running ?? false,\n      isError: options.isError ?? false,\n    },\n  };\n}\n"],"mappings":"AAwEA,SAAgB,EAAiB,EAA4B,CAAC,EAAqB,CACjF,IAAM,EAAgC,CAAC,EACjC,EAA4B,CAChC,UAAW,EAAQ,YAAc,IAAA,GAAY,KAAqB,EAAQ,UAC1E,SAAU,EAAQ,UAAY,CAAC,EAC/B,iBAAkB,EAAQ,kBAAoB,CAAC,EAC/C,QAAU,GAAU,CAClB,EAAQ,KAAK,CAAE,OAAQ,UAAW,OAAQ,CAAM,CAAC,CACnD,EACA,iBAAmB,GAAsB,CACvC,EAAQ,KAAK,CAAE,OAAQ,mBAAoB,OAAQ,EAAI,EAAG,CAAC,CAC7D,EACA,kBAAoB,GAAkB,CACpC,EAAQ,KAAK,CAAE,OAAQ,oBAAqB,OAAQ,CAAM,CAAC,CAC7D,EACA,WAAa,GAAiB,EAAQ,UAAU,CAAI,EACpD,oBAAsB,GAAS,CAC7B,EAAQ,KAAK,CAAE,OAAQ,sBAAuB,OAAQ,EAAM,UAAW,MAAK,CAAC,CAC/E,EACA,sBAAwB,GAAY,CAClC,EAAQ,KAAK,CAAE,OAAQ,wBAAyB,OAAQ,EAAM,UAAW,SAAQ,CAAC,CACpF,EACA,sBAAwB,GAAY,CAClC,EAAQ,KAAK,CAAE,OAAQ,wBAAyB,OAAQ,EAAM,UAAW,SAAQ,CAAC,CACpF,EACA,kBAAoB,GAAS,EAAQ,iBAAiB,CAAI,GAAK,CAAC,EAChE,kBAAmB,EAAW,IAAU,CACtC,EAAQ,KAAK,CAAE,OAAQ,mBAAoB,OAAQ,EAAW,OAAM,CAAC,CACvE,EACA,cAAe,EAAU,IAAkB,EAAQ,SAAS,EAAU,CAAa,GAAK,KACxF,WAAa,GAAS,EAAQ,cAAc,IAAS,KAGrD,SAAiB,GACd,EAAQ,WAAW,EAAK,OAAS,CAAC,CACvC,EAEA,MAAO,CACL,QACA,UACA,WAAc,EAAQ,QAAS,GAAW,EAAM,MAAQ,CAAC,EAAM,KAAK,EAAI,CAAC,CAAE,CAC7E,CACF,CAqBA,SAAgB,EAAwB,EAA2D,CACjG,IAAM,EAAO,EAAiB,CAAO,EAC/B,EAAS,EAAQ,SAAW,IAAA,GAAY,KAAO,EAAQ,OAC7D,MAAO,CACL,GAAG,EACH,MAAO,CACL,GAAG,EAAK,MACR,WAAY,EAAQ,YAAc,SAClC,SAAU,EAAQ,SAClB,KAAM,EAAQ,MAAQ,CAAC,EACvB,SACA,OAAQ,EAAQ,QAAU,GAC1B,QAAS,EAAQ,SAAW,GAC5B,QAAS,EAAQ,SAAW,EAC9B,CACF,CACF"}

package/dist/services/testing/slotProps.d.cts

@@ -1,4 +1,4 @@
-import { SlotDataFill, ToolMessageRenderProps, ToolResultView, WebPluginSlotProps } from "../../types/webPlugin.cjs";
+import { ComposerCapture, ContextAction, SlotDataFill, ThreadViewOptions, ToolMessageRenderProps, ToolResultView, TransientTab, WebPluginContextItem, WebPluginSlotProps } from "../../types/webPlugin.cjs";
 import { ReactNode } from "react";
 //#region src/services/testing/slotProps.d.ts
 /**
@@ -12,9 +12,15 @@ import { ReactNode } from "react";
  * cares about.
  */
 interface RecordedSlotAction {
-  action: 'openTab' | 'openTransientTab' | 'closeTransientTab' | 'sendSessionFrame';
-  /** The tab id, the transient tab's id, or the target session of a frame. */
+  action: 'appendComposerDraft' | 'attachComposerCapture' | 'attachComposerContext' | 'openTab' | 'openTransientTab' | 'closeTransientTab' | 'sendSessionFrame';
+  /** The tab id, the transient tab's id, or the target session of a frame or composer action. */
   target: string | null;
+  /** The text passed to `appendComposerDraft`. */
+  text?: string;
+  /** The structured item passed to `attachComposerContext`. */
+  context?: WebPluginContextItem;
+  /** The atomic screenshot and context passed to `attachComposerCapture`. */
+  capture?: ComposerCapture;
   /** The frame a component sent, for `sendSessionFrame`. */
   frame?: Record<string, unknown>;
 }
@@ -28,12 +34,17 @@ interface SlotPropsFixture {
 interface SlotPropsOptions {
   sessionId?: string | null;
   statuses?: Readonly<Record<string, string>>;
+  contextInventory?: WebPluginSlotProps['contextInventory'];
   /** Component fills this slot owner should see; keyed by slot name. */
   slotContent?: Readonly<Record<string, ReactNode>>;
   /** Data fills this slot owner should read back, keyed by slot name. */
   slotData?: Readonly<Record<string, readonly SlotDataFill[]>>;
   /** What `renderThread` returns for a plugin that renders one. */
-  thread?: (threadId: string) => ReactNode;
+  thread?: (threadId: string, options?: ThreadViewOptions) => ReactNode;
+  /** The tab a path opens; by default no path opens one, as with no file plugin installed. */
+  fileTab?: (path: string) => TransientTab | undefined;
+  /** Context actions installed plugins should offer for the item under test. */
+  contextActions?: (item: WebPluginContextItem) => readonly ContextAction[];
 }
 declare function slotPropsFixture(options?: SlotPropsOptions): SlotPropsFixture;
 interface ToolMessagePropsOptions extends SlotPropsOptions {

package/dist/services/testing/slotProps.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"slotProps.d.cts","names":[],"sources":["../../../src/services/testing/slotProps.ts"],"mappings":";;;;;;;;;;;;;UAqBiB;EACf;;EAEA;;EAEA,QAAQ;;UAGO;EACf,OAAO;;WAEE,kBAAkB;;EAE3B,mBAAmB;;UAGJ;EACf;EACA,WAAW,SAAS;;EAEpB,cAAc,SAAS,eAAe;;EAEtC,WAAW,SAAS,wBAAwB;;EAE5C,UAAU,qBAAqB;;iBAKjB,iBAAiB,UAAS,mBAAwB;UAgCjD,gCAAgC;EAC/C;EACA;EACA,OAAO;;EAEP,SAAS;;EAET;EACA;EACA;;UAGe,gCAAgC,KAAK;EACpD,OAAO;;;iBAMO,wBAAwB,SAAS,0BAA0B"}
+{"version":3,"file":"slotProps.d.cts","names":[],"sources":["../../../src/services/testing/slotProps.ts"],"mappings":";;;;;;;;;;;;;UAyBiB;EACf;;EASA;;EAEA;;EAEA,UAAU;;EAEV,UAAU;;EAEV,QAAQ;;UAGO;EACf,OAAO;;WAEE,kBAAkB;;EAE3B,mBAAmB;;UAGJ;EACf;EACA,WAAW,SAAS;EACpB,mBAAmB;;EAEnB,cAAc,SAAS,eAAe;;EAEtC,WAAW,SAAS,wBAAwB;;EAE5C,UAAU,kBAAkB,UAAU,sBAAsB;;EAE5D,WAAW,iBAAiB;;EAE5B,kBAAkB,MAAM,kCAAkC;;iBAK5C,iBAAiB,UAAS,mBAAwB;UA4CjD,gCAAgC;EAC/C;EACA;EACA,OAAO;;EAEP,SAAS;;EAET;EACA;EACA;;UAGe,gCAAgC,KAAK;EACpD,OAAO;;;iBAMO,wBAAwB,SAAS,0BAA0B"}

package/dist/services/testing/slotProps.d.mts

@@ -1,4 +1,4 @@
-import { SlotDataFill, ToolMessageRenderProps, ToolResultView, WebPluginSlotProps } from "../../types/webPlugin.mjs";
+import { ComposerCapture, ContextAction, SlotDataFill, ThreadViewOptions, ToolMessageRenderProps, ToolResultView, TransientTab, WebPluginContextItem, WebPluginSlotProps } from "../../types/webPlugin.mjs";
 import { ReactNode } from "react";
 //#region src/services/testing/slotProps.d.ts
 /**
@@ -12,9 +12,15 @@ import { ReactNode } from "react";
  * cares about.
  */
 interface RecordedSlotAction {
-  action: 'openTab' | 'openTransientTab' | 'closeTransientTab' | 'sendSessionFrame';
-  /** The tab id, the transient tab's id, or the target session of a frame. */
+  action: 'appendComposerDraft' | 'attachComposerCapture' | 'attachComposerContext' | 'openTab' | 'openTransientTab' | 'closeTransientTab' | 'sendSessionFrame';
+  /** The tab id, the transient tab's id, or the target session of a frame or composer action. */
   target: string | null;
+  /** The text passed to `appendComposerDraft`. */
+  text?: string;
+  /** The structured item passed to `attachComposerContext`. */
+  context?: WebPluginContextItem;
+  /** The atomic screenshot and context passed to `attachComposerCapture`. */
+  capture?: ComposerCapture;
   /** The frame a component sent, for `sendSessionFrame`. */
   frame?: Record<string, unknown>;
 }
@@ -28,12 +34,17 @@ interface SlotPropsFixture {
 interface SlotPropsOptions {
   sessionId?: string | null;
   statuses?: Readonly<Record<string, string>>;
+  contextInventory?: WebPluginSlotProps['contextInventory'];
   /** Component fills this slot owner should see; keyed by slot name. */
   slotContent?: Readonly<Record<string, ReactNode>>;
   /** Data fills this slot owner should read back, keyed by slot name. */
   slotData?: Readonly<Record<string, readonly SlotDataFill[]>>;
   /** What `renderThread` returns for a plugin that renders one. */
-  thread?: (threadId: string) => ReactNode;
+  thread?: (threadId: string, options?: ThreadViewOptions) => ReactNode;
+  /** The tab a path opens; by default no path opens one, as with no file plugin installed. */
+  fileTab?: (path: string) => TransientTab | undefined;
+  /** Context actions installed plugins should offer for the item under test. */
+  contextActions?: (item: WebPluginContextItem) => readonly ContextAction[];
 }
 declare function slotPropsFixture(options?: SlotPropsOptions): SlotPropsFixture;
 interface ToolMessagePropsOptions extends SlotPropsOptions {

package/dist/services/testing/slotProps.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"slotProps.d.mts","names":[],"sources":["../../../src/services/testing/slotProps.ts"],"mappings":";;;;;;;;;;;;;UAqBiB;EACf;;EAEA;;EAEA,QAAQ;;UAGO;EACf,OAAO;;WAEE,kBAAkB;;EAE3B,mBAAmB;;UAGJ;EACf;EACA,WAAW,SAAS;;EAEpB,cAAc,SAAS,eAAe;;EAEtC,WAAW,SAAS,wBAAwB;;EAE5C,UAAU,qBAAqB;;iBAKjB,iBAAiB,UAAS,mBAAwB;UAgCjD,gCAAgC;EAC/C;EACA;EACA,OAAO;;EAEP,SAAS;;EAET;EACA;EACA;;UAGe,gCAAgC,KAAK;EACpD,OAAO;;;iBAMO,wBAAwB,SAAS,0BAA0B"}
+{"version":3,"file":"slotProps.d.mts","names":[],"sources":["../../../src/services/testing/slotProps.ts"],"mappings":";;;;;;;;;;;;;UAyBiB;EACf;;EASA;;EAEA;;EAEA,UAAU;;EAEV,UAAU;;EAEV,QAAQ;;UAGO;EACf,OAAO;;WAEE,kBAAkB;;EAE3B,mBAAmB;;UAGJ;EACf;EACA,WAAW,SAAS;EACpB,mBAAmB;;EAEnB,cAAc,SAAS,eAAe;;EAEtC,WAAW,SAAS,wBAAwB;;EAE5C,UAAU,kBAAkB,UAAU,sBAAsB;;EAE5D,WAAW,iBAAiB;;EAE5B,kBAAkB,MAAM,kCAAkC;;iBAK5C,iBAAiB,UAAS,mBAAwB;UA4CjD,gCAAgC;EAC/C;EACA;EACA,OAAO;;EAEP,SAAS;;EAET;EACA;EACA;;UAGe,gCAAgC,KAAK;EACpD,OAAO;;;iBAMO,wBAAwB,SAAS,0BAA0B"}

package/dist/services/testing/slotProps.mjs

@@ -1,2 +1,2 @@
-function e(e={}){let t=[];return{props:{sessionId:e.sessionId===void 0?`s1`:e.sessionId,statuses:e.statuses??{},openTab:e=>{t.push({action:`openTab`,target:e})},openTransientTab:e=>{t.push({action:`openTransientTab`,target:e.id})},closeTransientTab:e=>{t.push({action:`closeTransientTab`,target:e})},sendSessionFrame:(e,n)=>{t.push({action:`sendSessionFrame`,target:e,frame:n})},renderThread:t=>e.thread?.(t)??null,renderSlot:t=>e.slotContent?.[t]??null,slotData:t=>e.slotData?.[t.slot]??[]},actions:t,frames:()=>t.flatMap(e=>e.frame?[e.frame]:[])}}function t(t){let n=e(t),r=t.result===void 0?null:t.result;return{...n,props:{...n.props,toolCallId:t.toolCallId??`call-1`,toolName:t.toolName,args:t.args??{},result:r,output:t.output??``,running:t.running??!1,isError:t.isError??!1}}}export{e as slotPropsFixture,t as toolMessagePropsFixture};
+function e(e={}){let t=[],n={sessionId:e.sessionId===void 0?`s1`:e.sessionId,statuses:e.statuses??{},contextInventory:e.contextInventory??[],openTab:e=>{t.push({action:`openTab`,target:e})},openTransientTab:e=>{t.push({action:`openTransientTab`,target:e.id})},closeTransientTab:e=>{t.push({action:`closeTransientTab`,target:e})},fileTabFor:t=>e.fileTab?.(t),appendComposerDraft:e=>{t.push({action:`appendComposerDraft`,target:n.sessionId,text:e})},attachComposerContext:e=>{t.push({action:`attachComposerContext`,target:n.sessionId,context:e})},attachComposerCapture:e=>{t.push({action:`attachComposerCapture`,target:n.sessionId,capture:e})},contextActionsFor:t=>e.contextActions?.(t)??[],sendSessionFrame:(e,n)=>{t.push({action:`sendSessionFrame`,target:e,frame:n})},renderThread:(t,n)=>e.thread?.(t,n)??null,renderSlot:t=>e.slotContent?.[t]??null,slotData:t=>e.slotData?.[t.slot]??[]};return{props:n,actions:t,frames:()=>t.flatMap(e=>e.frame?[e.frame]:[])}}function t(t){let n=e(t),r=t.result===void 0?null:t.result;return{...n,props:{...n.props,toolCallId:t.toolCallId??`call-1`,toolName:t.toolName,args:t.args??{},result:r,output:t.output??``,running:t.running??!1,isError:t.isError??!1}}}export{e as slotPropsFixture,t as toolMessagePropsFixture};
 //# sourceMappingURL=slotProps.mjs.map

package/dist/services/testing/slotProps.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"slotProps.mjs","names":[],"sources":["../../../src/services/testing/slotProps.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type {\n  SlotDataFill,\n  SlotDeclaration,\n  ToolMessageRenderProps,\n  ToolResultView,\n  TransientTab,\n  WebPluginSlotProps,\n} from '../../types/webPlugin.ts';\n\n/**\n * The props the cockpit hands a plugin's components, built for a test.\n *\n * A plugin component takes fifteen props and reads three of them. Written out\n * by hand in each test, the other twelve are noise that goes stale the moment\n * the contract grows a member; written as a cast, the component compiles\n * against props the host never sends. This builds all of them, records what the\n * component did with the actions, and lets a test override the two or three it\n * cares about.\n */\n\nexport interface RecordedSlotAction {\n  action: 'openTab' | 'openTransientTab' | 'closeTransientTab' | 'sendSessionFrame';\n  /** The tab id, the transient tab's id, or the target session of a frame. */\n  target: string | null;\n  /** The frame a component sent, for `sendSessionFrame`. */\n  frame?: Record<string, unknown>;\n}\n\nexport interface SlotPropsFixture {\n  props: WebPluginSlotProps;\n  /** Everything the component did through its props, in order. */\n  readonly actions: readonly RecordedSlotAction[];\n  /** Frames the component sent, which is what most assertions want. */\n  frames(): readonly Record<string, unknown>[];\n}\n\nexport interface SlotPropsOptions {\n  sessionId?: string | null;\n  statuses?: Readonly<Record<string, string>>;\n  /** Component fills this slot owner should see; keyed by slot name. */\n  slotContent?: Readonly<Record<string, ReactNode>>;\n  /** Data fills this slot owner should read back, keyed by slot name. */\n  slotData?: Readonly<Record<string, readonly SlotDataFill[]>>;\n  /** What `renderThread` returns for a plugin that renders one. */\n  thread?: (threadId: string) => ReactNode;\n}\n\nconst DEFAULT_SESSION_ID = 's1';\n\nexport function slotPropsFixture(options: SlotPropsOptions = {}): SlotPropsFixture {\n  const actions: RecordedSlotAction[] = [];\n  const props: WebPluginSlotProps = {\n    sessionId: options.sessionId === undefined ? DEFAULT_SESSION_ID : options.sessionId,\n    statuses: options.statuses ?? {},\n    openTab: (tabId) => {\n      actions.push({ action: 'openTab', target: tabId });\n    },\n    openTransientTab: (tab: TransientTab) => {\n      actions.push({ action: 'openTransientTab', target: tab.id });\n    },\n    closeTransientTab: (tabId: string) => {\n      actions.push({ action: 'closeTransientTab', target: tabId });\n    },\n    sendSessionFrame: (sessionId, frame) => {\n      actions.push({ action: 'sendSessionFrame', target: sessionId, frame });\n    },\n    renderThread: (threadId) => options.thread?.(threadId) ?? null,\n    renderSlot: (slot) => options.slotContent?.[slot] ?? null,\n    // The host resolves fills by slot name and hands the owner its own typed\n    // view, so a test declares them by name too.\n    slotData: <Data>(slot: SlotDeclaration<Data>) =>\n      (options.slotData?.[slot.slot] ?? []) as readonly SlotDataFill<Data>[],\n  };\n\n  return {\n    props,\n    actions,\n    frames: () => actions.flatMap((entry) => (entry.frame ? [entry.frame] : [])),\n  };\n}\n\nexport interface ToolMessagePropsOptions extends SlotPropsOptions {\n  toolCallId?: string;\n  toolName: string;\n  args?: Record<string, unknown>;\n  /** The newest result; null is what the host sends before any output. */\n  result?: ToolResultView | null;\n  /** The result's text blocks joined, as the host's own fallback item shows them. */\n  output?: string;\n  running?: boolean;\n  isError?: boolean;\n}\n\nexport interface ToolMessagePropsFixture extends Omit<SlotPropsFixture, 'props'> {\n  props: ToolMessageRenderProps;\n}\n\nconst DEFAULT_TOOL_CALL_ID = 'call-1';\n\n/** The props a tool's timeline item receives, in any of its four states. */\nexport function toolMessagePropsFixture(options: ToolMessagePropsOptions): ToolMessagePropsFixture {\n  const base = slotPropsFixture(options);\n  const result = options.result === undefined ? null : options.result;\n  return {\n    ...base,\n    props: {\n      ...base.props,\n      toolCallId: options.toolCallId ?? DEFAULT_TOOL_CALL_ID,\n      toolName: options.toolName,\n      args: options.args ?? {},\n      result,\n      output: options.output ?? '',\n      running: options.running ?? false,\n      isError: options.isError ?? false,\n    },\n  };\n}\n"],"mappings":"AAkDA,SAAgB,EAAiB,EAA4B,CAAC,EAAqB,CACjF,IAAM,EAAgC,CAAC,EAwBvC,MAAO,CACL,MAAA,CAvBA,UAAW,EAAQ,YAAc,IAAA,GAAY,KAAqB,EAAQ,UAC1E,SAAU,EAAQ,UAAY,CAAC,EAC/B,QAAU,GAAU,CAClB,EAAQ,KAAK,CAAE,OAAQ,UAAW,OAAQ,CAAM,CAAC,CACnD,EACA,iBAAmB,GAAsB,CACvC,EAAQ,KAAK,CAAE,OAAQ,mBAAoB,OAAQ,EAAI,EAAG,CAAC,CAC7D,EACA,kBAAoB,GAAkB,CACpC,EAAQ,KAAK,CAAE,OAAQ,oBAAqB,OAAQ,CAAM,CAAC,CAC7D,EACA,kBAAmB,EAAW,IAAU,CACtC,EAAQ,KAAK,CAAE,OAAQ,mBAAoB,OAAQ,EAAW,OAAM,CAAC,CACvE,EACA,aAAe,GAAa,EAAQ,SAAS,CAAQ,GAAK,KAC1D,WAAa,GAAS,EAAQ,cAAc,IAAS,KAGrD,SAAiB,GACd,EAAQ,WAAW,EAAK,OAAS,CAAC,CAIjC,EACJ,UACA,WAAc,EAAQ,QAAS,GAAW,EAAM,MAAQ,CAAC,EAAM,KAAK,EAAI,CAAC,CAAE,CAC7E,CACF,CAqBA,SAAgB,EAAwB,EAA2D,CACjG,IAAM,EAAO,EAAiB,CAAO,EAC/B,EAAS,EAAQ,SAAW,IAAA,GAAY,KAAO,EAAQ,OAC7D,MAAO,CACL,GAAG,EACH,MAAO,CACL,GAAG,EAAK,MACR,WAAY,EAAQ,YAAc,SAClC,SAAU,EAAQ,SAClB,KAAM,EAAQ,MAAQ,CAAC,EACvB,SACA,OAAQ,EAAQ,QAAU,GAC1B,QAAS,EAAQ,SAAW,GAC5B,QAAS,EAAQ,SAAW,EAC9B,CACF,CACF"}
+{"version":3,"file":"slotProps.mjs","names":[],"sources":["../../../src/services/testing/slotProps.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type {\n  ComposerCapture,\n  ContextAction,\n  SlotDataFill,\n  SlotDeclaration,\n  ThreadViewOptions,\n  ToolMessageRenderProps,\n  ToolResultView,\n  TransientTab,\n  WebPluginContextItem,\n  WebPluginSlotProps,\n} from '../../types/webPlugin.ts';\n\n/**\n * The props the cockpit hands a plugin's components, built for a test.\n *\n * A plugin component takes fifteen props and reads three of them. Written out\n * by hand in each test, the other twelve are noise that goes stale the moment\n * the contract grows a member; written as a cast, the component compiles\n * against props the host never sends. This builds all of them, records what the\n * component did with the actions, and lets a test override the two or three it\n * cares about.\n */\n\nexport interface RecordedSlotAction {\n  action:\n    | 'appendComposerDraft'\n    | 'attachComposerCapture'\n    | 'attachComposerContext'\n    | 'openTab'\n    | 'openTransientTab'\n    | 'closeTransientTab'\n    | 'sendSessionFrame';\n  /** The tab id, the transient tab's id, or the target session of a frame or composer action. */\n  target: string | null;\n  /** The text passed to `appendComposerDraft`. */\n  text?: string;\n  /** The structured item passed to `attachComposerContext`. */\n  context?: WebPluginContextItem;\n  /** The atomic screenshot and context passed to `attachComposerCapture`. */\n  capture?: ComposerCapture;\n  /** The frame a component sent, for `sendSessionFrame`. */\n  frame?: Record<string, unknown>;\n}\n\nexport interface SlotPropsFixture {\n  props: WebPluginSlotProps;\n  /** Everything the component did through its props, in order. */\n  readonly actions: readonly RecordedSlotAction[];\n  /** Frames the component sent, which is what most assertions want. */\n  frames(): readonly Record<string, unknown>[];\n}\n\nexport interface SlotPropsOptions {\n  sessionId?: string | null;\n  statuses?: Readonly<Record<string, string>>;\n  contextInventory?: WebPluginSlotProps['contextInventory'];\n  /** Component fills this slot owner should see; keyed by slot name. */\n  slotContent?: Readonly<Record<string, ReactNode>>;\n  /** Data fills this slot owner should read back, keyed by slot name. */\n  slotData?: Readonly<Record<string, readonly SlotDataFill[]>>;\n  /** What `renderThread` returns for a plugin that renders one. */\n  thread?: (threadId: string, options?: ThreadViewOptions) => ReactNode;\n  /** The tab a path opens; by default no path opens one, as with no file plugin installed. */\n  fileTab?: (path: string) => TransientTab | undefined;\n  /** Context actions installed plugins should offer for the item under test. */\n  contextActions?: (item: WebPluginContextItem) => readonly ContextAction[];\n}\n\nconst DEFAULT_SESSION_ID = 's1';\n\nexport function slotPropsFixture(options: SlotPropsOptions = {}): SlotPropsFixture {\n  const actions: RecordedSlotAction[] = [];\n  const props: WebPluginSlotProps = {\n    sessionId: options.sessionId === undefined ? DEFAULT_SESSION_ID : options.sessionId,\n    statuses: options.statuses ?? {},\n    contextInventory: options.contextInventory ?? [],\n    openTab: (tabId) => {\n      actions.push({ action: 'openTab', target: tabId });\n    },\n    openTransientTab: (tab: TransientTab) => {\n      actions.push({ action: 'openTransientTab', target: tab.id });\n    },\n    closeTransientTab: (tabId: string) => {\n      actions.push({ action: 'closeTransientTab', target: tabId });\n    },\n    fileTabFor: (path: string) => options.fileTab?.(path),\n    appendComposerDraft: (text) => {\n      actions.push({ action: 'appendComposerDraft', target: props.sessionId, text });\n    },\n    attachComposerContext: (context) => {\n      actions.push({ action: 'attachComposerContext', target: props.sessionId, context });\n    },\n    attachComposerCapture: (capture) => {\n      actions.push({ action: 'attachComposerCapture', target: props.sessionId, capture });\n    },\n    contextActionsFor: (item) => options.contextActions?.(item) ?? [],\n    sendSessionFrame: (sessionId, frame) => {\n      actions.push({ action: 'sendSessionFrame', target: sessionId, frame });\n    },\n    renderThread: (threadId, threadOptions) => options.thread?.(threadId, threadOptions) ?? null,\n    renderSlot: (slot) => options.slotContent?.[slot] ?? null,\n    // The host resolves fills by slot name and hands the owner its own typed\n    // view, so a test declares them by name too.\n    slotData: <Data>(slot: SlotDeclaration<Data>) =>\n      (options.slotData?.[slot.slot] ?? []) as readonly SlotDataFill<Data>[],\n  };\n\n  return {\n    props,\n    actions,\n    frames: () => actions.flatMap((entry) => (entry.frame ? [entry.frame] : [])),\n  };\n}\n\nexport interface ToolMessagePropsOptions extends SlotPropsOptions {\n  toolCallId?: string;\n  toolName: string;\n  args?: Record<string, unknown>;\n  /** The newest result; null is what the host sends before any output. */\n  result?: ToolResultView | null;\n  /** The result's text blocks joined, as the host's own fallback item shows them. */\n  output?: string;\n  running?: boolean;\n  isError?: boolean;\n}\n\nexport interface ToolMessagePropsFixture extends Omit<SlotPropsFixture, 'props'> {\n  props: ToolMessageRenderProps;\n}\n\nconst DEFAULT_TOOL_CALL_ID = 'call-1';\n\n/** The props a tool's timeline item receives, in any of its four states. */\nexport function toolMessagePropsFixture(options: ToolMessagePropsOptions): ToolMessagePropsFixture {\n  const base = slotPropsFixture(options);\n  const result = options.result === undefined ? null : options.result;\n  return {\n    ...base,\n    props: {\n      ...base.props,\n      toolCallId: options.toolCallId ?? DEFAULT_TOOL_CALL_ID,\n      toolName: options.toolName,\n      args: options.args ?? {},\n      result,\n      output: options.output ?? '',\n      running: options.running ?? false,\n      isError: options.isError ?? false,\n    },\n  };\n}\n"],"mappings":"AAwEA,SAAgB,EAAiB,EAA4B,CAAC,EAAqB,CACjF,IAAM,EAAgC,CAAC,EACjC,EAA4B,CAChC,UAAW,EAAQ,YAAc,IAAA,GAAY,KAAqB,EAAQ,UAC1E,SAAU,EAAQ,UAAY,CAAC,EAC/B,iBAAkB,EAAQ,kBAAoB,CAAC,EAC/C,QAAU,GAAU,CAClB,EAAQ,KAAK,CAAE,OAAQ,UAAW,OAAQ,CAAM,CAAC,CACnD,EACA,iBAAmB,GAAsB,CACvC,EAAQ,KAAK,CAAE,OAAQ,mBAAoB,OAAQ,EAAI,EAAG,CAAC,CAC7D,EACA,kBAAoB,GAAkB,CACpC,EAAQ,KAAK,CAAE,OAAQ,oBAAqB,OAAQ,CAAM,CAAC,CAC7D,EACA,WAAa,GAAiB,EAAQ,UAAU,CAAI,EACpD,oBAAsB,GAAS,CAC7B,EAAQ,KAAK,CAAE,OAAQ,sBAAuB,OAAQ,EAAM,UAAW,MAAK,CAAC,CAC/E,EACA,sBAAwB,GAAY,CAClC,EAAQ,KAAK,CAAE,OAAQ,wBAAyB,OAAQ,EAAM,UAAW,SAAQ,CAAC,CACpF,EACA,sBAAwB,GAAY,CAClC,EAAQ,KAAK,CAAE,OAAQ,wBAAyB,OAAQ,EAAM,UAAW,SAAQ,CAAC,CACpF,EACA,kBAAoB,GAAS,EAAQ,iBAAiB,CAAI,GAAK,CAAC,EAChE,kBAAmB,EAAW,IAAU,CACtC,EAAQ,KAAK,CAAE,OAAQ,mBAAoB,OAAQ,EAAW,OAAM,CAAC,CACvE,EACA,cAAe,EAAU,IAAkB,EAAQ,SAAS,EAAU,CAAa,GAAK,KACxF,WAAa,GAAS,EAAQ,cAAc,IAAS,KAGrD,SAAiB,GACd,EAAQ,WAAW,EAAK,OAAS,CAAC,CACvC,EAEA,MAAO,CACL,QACA,UACA,WAAc,EAAQ,QAAS,GAAW,EAAM,MAAQ,CAAC,EAAM,KAAK,EAAI,CAAC,CAAE,CAC7E,CACF,CAqBA,SAAgB,EAAwB,EAA2D,CACjG,IAAM,EAAO,EAAiB,CAAO,EAC/B,EAAS,EAAQ,SAAW,IAAA,GAAY,KAAO,EAAQ,OAC7D,MAAO,CACL,GAAG,EACH,MAAO,CACL,GAAG,EAAK,MACR,WAAY,EAAQ,YAAc,SAClC,SAAU,EAAQ,SAClB,KAAM,EAAQ,MAAQ,CAAC,EACvB,SACA,OAAQ,EAAQ,QAAU,GAC1B,QAAS,EAAQ,SAAW,GAC5B,QAAS,EAAQ,SAAW,EAC9B,CACF,CACF"}

package/dist/types/modelContext.d.cts

@@ -0,0 +1,44 @@
+//#region src/types/modelContext.d.ts
+/** The model-visible part of a WebMCP tool registration. */
+interface ModelContextToolDescriptor {
+  readonly name: string;
+  readonly description: string;
+  readonly inputSchema: Readonly<Record<string, unknown>>;
+}
+interface ModelContextAbortSignal {
+  readonly aborted: boolean;
+  readonly reason?: unknown;
+  addEventListener(type: 'abort', listener: () => void, options?: {
+    readonly once?: boolean;
+  }): void;
+  removeEventListener(type: 'abort', listener: () => void): void;
+}
+interface ModelContextExecutionOptions {
+  readonly signal: ModelContextAbortSignal;
+}
+interface ModelContextRegistrationOptions {
+  readonly signal: ModelContextAbortSignal;
+}
+/** A descriptor plus the page callback that implements it. */
+interface ModelContextTool extends ModelContextToolDescriptor {
+  execute(input: string, options: ModelContextExecutionOptions): Promise<unknown>;
+}
+interface ModelContextToolChangeEvent {
+  readonly type: 'toolchange';
+}
+type ModelContextToolChangeListener = (event: ModelContextToolChangeEvent) => void;
+/** The common surface supplied by either the browser or DoomPi's simulator. */
+interface ModelContext {
+  registerTool(tool: ModelContextTool, options: ModelContextRegistrationOptions): void | Promise<void>;
+  getTools(): Promise<readonly ModelContextToolDescriptor[]>;
+  executeTool(name: string, input: string, options: ModelContextExecutionOptions): Promise<unknown>;
+  addEventListener(type: 'toolchange', listener: ModelContextToolChangeListener): void;
+  removeEventListener(type: 'toolchange', listener: ModelContextToolChangeListener): void;
+}
+interface ModelContextBinding {
+  readonly kind: 'native' | 'simulator';
+  readonly modelContext: ModelContext;
+}
+//#endregion
+export { ModelContext, ModelContextAbortSignal, ModelContextBinding, ModelContextExecutionOptions, ModelContextRegistrationOptions, ModelContextTool, ModelContextToolChangeEvent, ModelContextToolChangeListener, ModelContextToolDescriptor };
+//# sourceMappingURL=modelContext.d.cts.map

package/dist/types/modelContext.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelContext.d.cts","names":[],"sources":["../../src/types/modelContext.ts"],"mappings":";;UACiB;WACN;WACA;WACA,aAAa,SAAS;;UAGhB;WACN;WACA;EACT,iBAAiB,eAAe,sBAAsB;aAAqB;;EAC3E,oBAAoB,eAAe;;UAGpB;WACN,QAAQ;;UAGF;WACN,QAAQ;;;UAIF,yBAAyB;EACxC,QAAQ,eAAe,SAAS,+BAA+B;;UAGhD;WACN;;KAGC,kCAAkC,OAAO;;UAGpC;EACf,aAAa,MAAM,kBAAkB,SAAS,yCAAyC;EACvF,YAAY,iBAAiB;EAC7B,YAAY,cAAc,eAAe,SAAS,+BAA+B;EACjF,iBAAiB,oBAAoB,UAAU;EAC/C,oBAAoB,oBAAoB,UAAU;;UAGnC;WACN;WACA,cAAc"}

package/dist/types/modelContext.d.mts

@@ -0,0 +1,44 @@
+//#region src/types/modelContext.d.ts
+/** The model-visible part of a WebMCP tool registration. */
+interface ModelContextToolDescriptor {
+  readonly name: string;
+  readonly description: string;
+  readonly inputSchema: Readonly<Record<string, unknown>>;
+}
+interface ModelContextAbortSignal {
+  readonly aborted: boolean;
+  readonly reason?: unknown;
+  addEventListener(type: 'abort', listener: () => void, options?: {
+    readonly once?: boolean;
+  }): void;
+  removeEventListener(type: 'abort', listener: () => void): void;
+}
+interface ModelContextExecutionOptions {
+  readonly signal: ModelContextAbortSignal;
+}
+interface ModelContextRegistrationOptions {
+  readonly signal: ModelContextAbortSignal;
+}
+/** A descriptor plus the page callback that implements it. */
+interface ModelContextTool extends ModelContextToolDescriptor {
+  execute(input: string, options: ModelContextExecutionOptions): Promise<unknown>;
+}
+interface ModelContextToolChangeEvent {
+  readonly type: 'toolchange';
+}
+type ModelContextToolChangeListener = (event: ModelContextToolChangeEvent) => void;
+/** The common surface supplied by either the browser or DoomPi's simulator. */
+interface ModelContext {
+  registerTool(tool: ModelContextTool, options: ModelContextRegistrationOptions): void | Promise<void>;
+  getTools(): Promise<readonly ModelContextToolDescriptor[]>;
+  executeTool(name: string, input: string, options: ModelContextExecutionOptions): Promise<unknown>;
+  addEventListener(type: 'toolchange', listener: ModelContextToolChangeListener): void;
+  removeEventListener(type: 'toolchange', listener: ModelContextToolChangeListener): void;
+}
+interface ModelContextBinding {
+  readonly kind: 'native' | 'simulator';
+  readonly modelContext: ModelContext;
+}
+//#endregion
+export { ModelContext, ModelContextAbortSignal, ModelContextBinding, ModelContextExecutionOptions, ModelContextRegistrationOptions, ModelContextTool, ModelContextToolChangeEvent, ModelContextToolChangeListener, ModelContextToolDescriptor };
+//# sourceMappingURL=modelContext.d.mts.map

package/dist/types/modelContext.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelContext.d.mts","names":[],"sources":["../../src/types/modelContext.ts"],"mappings":";;UACiB;WACN;WACA;WACA,aAAa,SAAS;;UAGhB;WACN;WACA;EACT,iBAAiB,eAAe,sBAAsB;aAAqB;;EAC3E,oBAAoB,eAAe;;UAGpB;WACN,QAAQ;;UAGF;WACN,QAAQ;;;UAIF,yBAAyB;EACxC,QAAQ,eAAe,SAAS,+BAA+B;;UAGhD;WACN;;KAGC,kCAAkC,OAAO;;UAGpC;EACf,aAAa,MAAM,kBAAkB,SAAS,yCAAyC;EACvF,YAAY,iBAAiB;EAC7B,YAAY,cAAc,eAAe,SAAS,+BAA+B;EACjF,iBAAiB,oBAAoB,UAAU;EAC/C,oBAAoB,oBAAoB,UAAU;;UAGnC;WACN;WACA,cAAc"}

package/dist/types/webHub.d.cts

@@ -20,12 +20,41 @@ interface HubSessionScope {
   /** The session's working directory, for repo-scoped data sources. */
   cwd: string;
 }
+interface HubSessionApiRequest {
+  basePath: string;
+  path: string;
+  method: string;
+  body?: string | Uint8Array<ArrayBuffer> | null;
+  signal?: AbortSignal;
+}
+type ComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';
+interface ComputerUseHostRequest {
+  readonly operation: ComputerUseHostOperation;
+  readonly payload?: unknown;
+  readonly signal?: AbortSignal;
+}
+/** Narrow optional binding supplied only by a Desktop-owned cockpit hub. */
+interface ComputerUseHostBinding {
+  readonly available: boolean;
+  request(scope: HubSessionScope, request: ComputerUseHostRequest): Promise<unknown>;
+  close?(): void;
+}
+interface HubChannelConnection {
+  /** Opaque for one page socket lifetime. */
+  connectionId: string;
+}
 /** What the hub hands a channel when it starts. */
 interface HubChannelHost {
   /** Every session the hub currently manages. */
   sessions(): readonly HubSessionScope[];
   /** Live fan-out to the session's page subscribers. */
   publish(sessionId: string, payload: unknown): void;
+  /** Delivers only to the authenticated page socket named by connectionId. */
+  publishToConnection?(connectionId: string, sessionId: string, payload: unknown): boolean;
+  /** Authenticated machine-local transport to a session package API. */
+  requestSessionApi(scope: HubSessionScope, request: HubSessionApiRequest): Promise<Response>;
+  /** Absent unless this exact hub is the child owned by DoomPi Desktop. */
+  computerUse?: ComputerUseHostBinding;
   onNotice(message: string): void;
 }
 /**
@@ -46,11 +75,23 @@ interface HubChannelSource {
   threadJournal?(scope: HubSessionScope, threadId: string): string | undefined;
   close(): void;
 }
+type HubChannelLifecycle = 'session' | 'hub';
 interface WebHubChannel {
   /** Wire frame type; globally unique across every loaded plugin. */
   frameType: string;
+  /**
+   * Whether this channel source belongs to one session or the whole hub.
+   * Omitted channels retain the session-local lifecycle for compatibility.
+   */
+  lifecycle?: HubChannelLifecycle;
   start(host: HubChannelHost): HubChannelSource;
+  /** Allows an authenticated connection to acknowledge targeted frames after its session subscription changes. */
+  receiveWithoutSubscription?: boolean;
+  /** Receives only frames matching frameType and a live session scope. */
+  receive?(scope: HubSessionScope, payload: unknown, connection: HubChannelConnection): void;
+  /** The authenticated page socket has closed. */
+  disconnected?(connection: HubChannelConnection): void;
 }
 //#endregion
-export { ChannelFrame, HubChannelHost, HubChannelSource, HubSessionScope, WebHubChannel };
+export { ChannelFrame, ComputerUseHostBinding, ComputerUseHostOperation, ComputerUseHostRequest, HubChannelConnection, HubChannelHost, HubChannelLifecycle, HubChannelSource, HubSessionApiRequest, HubSessionScope, WebHubChannel };
 //# sourceMappingURL=webHub.d.cts.map

package/dist/types/webHub.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"webHub.d.cts","names":[],"sources":["../../src/types/webHub.ts"],"mappings":";;;;;;;;;;;;UAYiB;EACf;EACA;EACA;;UAGe;EACf;;EAEA;;;UAIe;;EAEf,qBAAqB;;EAErB,QAAQ,mBAAmB;EAC3B,SAAS;;;;;;;UAQM;;EAEf,WAAW,OAAO;EAClB,cAAc,OAAO;EACrB,gBAAgB;;;;;;EAMhB,eAAe,OAAO,iBAAiB;EACvC;;UAGe;;EAEf;EACA,MAAM,MAAM,iBAAiB"}
+{"version":3,"file":"webHub.d.cts","names":[],"sources":["../../src/types/webHub.ts"],"mappings":";;;;;;;;;;;;UAYiB;EACf;EACA;EACA;;UAGe;EACf;;EAEA;;UAGe;EACf;EACA;EACA;EACA,gBAAgB,WAAW;EAC3B,SAAS;;KAGC;UAEK;WACN,WAAW;WACX;WACA,SAAS;;;UAIH;WACN;EACT,QAAQ,OAAO,iBAAiB,SAAS,yBAAyB;EAClE;;UAGe;;EAEf;;;UAIe;;EAEf,qBAAqB;;EAErB,QAAQ,mBAAmB;;EAE3B,qBAAqB,sBAAsB,mBAAmB;;EAE9D,kBAAkB,OAAO,iBAAiB,SAAS,uBAAuB,QAAQ;;EAElF,cAAc;EACd,SAAS;;;;;;;UAQM;;EAEf,WAAW,OAAO;EAClB,cAAc,OAAO;EACrB,gBAAgB;;;;;;EAMhB,eAAe,OAAO,iBAAiB;EACvC;;KAGU;UAEK;;EAEf;;;;;EAKA,YAAY;EACZ,MAAM,MAAM,iBAAiB;;EAE7B;;EAEA,SAAS,OAAO,iBAAiB,kBAAkB,YAAY;;EAE/D,cAAc,YAAY"}