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

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/sessionRegistry.cjs"),i=require("./services/toolResult.cjs");exports.HUB_ADVERTISEMENT_VERSION=r.HUB_ADVERTISEMENT_VERSION,exports.REGISTRY_DIR_ENV=r.REGISTRY_DIR_ENV,exports.SESSION_LINEAGE_RECORD_VERSION=r.SESSION_LINEAGE_RECORD_VERSION,exports.defineGlobalStore=t.defineGlobalStore,exports.defineSessionChannel=e.defineSessionChannel,exports.defineSessionStore=n.defineSessionStore,exports.defineSlot=e.defineSlot,exports.defineWebPlugin=e.defineWebPlugin,exports.hubAdvertisementPath=r.hubAdvertisementPath,exports.parseHubAdvertisement=r.parseHubAdvertisement,exports.parseSessionLineage=r.parseSessionLineage,exports.resolveRegistryDir=r.resolveRegistryDir,exports.sessionLineagePath=r.sessionLineagePath,exports.toolResultText=i.toolResultText,exports.toolResultTextLines=i.toolResultTextLines;

package/dist/index.d.cts

@@ -1,6 +1,10 @@
-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, CaptureStatusEvent, 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, UserMessageActionContribution, UserMessageActionRunContext, 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 { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from "./types/sessionRegistry.cjs";
+import { HUB_ADVERTISEMENT_VERSION, REGISTRY_DIR_ENV, SESSION_LINEAGE_RECORD_VERSION, hubAdvertisementPath, parseHubAdvertisement, parseSessionLineage, resolveRegistryDir, sessionLineagePath } from "./services/sessionRegistry.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 CaptureStatusEvent, type ChannelFrame, type ComposerCapture, type ComposerSubmission, type ComputerUseHostBinding, type ComputerUseHostOperation, type ComputerUseHostRequest, type ContextAction, type ContextActionContribution, type ContextActionRunContext, type DockFaceContribution, type FileLinkSource, type GlobalStore, HUB_ADVERTISEMENT_VERSION, type HubAdvertisement, 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, REGISTRY_DIR_ENV, type RegistryDirInput, type RepositorySettingsPanelContribution, type RepositorySettingsPanelProps, type RepositorySettingsRepository, SESSION_LINEAGE_RECORD_VERSION, type SelectionAxisContribution, type SessionChannelContribution, type SessionFrameSender, type SessionLineageRecord, 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 UserMessageActionContribution, type UserMessageActionRunContext, type WebHubChannel, type WebPluginContextInventoryItem, type WebPluginContextItem, type WebPluginDefinition, type WebPluginRuntime, type WebPluginSlotProps, defineGlobalStore, defineSessionChannel, defineSessionStore, defineSlot, defineWebPlugin, hubAdvertisementPath, parseHubAdvertisement, parseSessionLineage, resolveRegistryDir, sessionLineagePath, toolResultText, toolResultTextLines };

package/dist/index.d.mts

@@ -1,6 +1,10 @@
-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, CaptureStatusEvent, 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, UserMessageActionContribution, UserMessageActionRunContext, 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 { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from "./types/sessionRegistry.mjs";
+import { HUB_ADVERTISEMENT_VERSION, REGISTRY_DIR_ENV, SESSION_LINEAGE_RECORD_VERSION, hubAdvertisementPath, parseHubAdvertisement, parseSessionLineage, resolveRegistryDir, sessionLineagePath } from "./services/sessionRegistry.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 CaptureStatusEvent, type ChannelFrame, type ComposerCapture, type ComposerSubmission, type ComputerUseHostBinding, type ComputerUseHostOperation, type ComputerUseHostRequest, type ContextAction, type ContextActionContribution, type ContextActionRunContext, type DockFaceContribution, type FileLinkSource, type GlobalStore, HUB_ADVERTISEMENT_VERSION, type HubAdvertisement, 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, REGISTRY_DIR_ENV, type RegistryDirInput, type RepositorySettingsPanelContribution, type RepositorySettingsPanelProps, type RepositorySettingsRepository, SESSION_LINEAGE_RECORD_VERSION, type SelectionAxisContribution, type SessionChannelContribution, type SessionFrameSender, type SessionLineageRecord, 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 UserMessageActionContribution, type UserMessageActionRunContext, type WebHubChannel, type WebPluginContextInventoryItem, type WebPluginContextItem, type WebPluginDefinition, type WebPluginRuntime, type WebPluginSlotProps, defineGlobalStore, defineSessionChannel, defineSessionStore, defineSlot, defineWebPlugin, hubAdvertisementPath, parseHubAdvertisement, parseSessionLineage, resolveRegistryDir, sessionLineagePath, 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{HUB_ADVERTISEMENT_VERSION as a,REGISTRY_DIR_ENV as o,SESSION_LINEAGE_RECORD_VERSION as s,hubAdvertisementPath as c,parseHubAdvertisement as l,parseSessionLineage as u,resolveRegistryDir as d,sessionLineagePath as f}from"./services/sessionRegistry.mjs";import{toolResultText as p,toolResultTextLines as m}from"./services/toolResult.mjs";export{a as HUB_ADVERTISEMENT_VERSION,o as REGISTRY_DIR_ENV,s as SESSION_LINEAGE_RECORD_VERSION,r as defineGlobalStore,e as defineSessionChannel,i as defineSessionStore,t as defineSlot,n as defineWebPlugin,c as hubAdvertisementPath,l as parseHubAdvertisement,u as parseSessionLineage,d as resolveRegistryDir,f as sessionLineagePath,p as toolResultText,m as toolResultTextLines};

package/dist/services/define.d.cts

@@ -1,20 +1,19 @@
 import { SessionChannelContribution, SlotDeclaration, WebPluginDefinition } from "../types/webPlugin.cjs";
 //#region src/services/define.d.ts
 /** Identity helper so plugin modules get checked literals without a type annotation. */
-declare function defineWebPlugin(plugin: WebPluginDefinition): WebPluginDefinition;
+export declare function defineWebPlugin(plugin: WebPluginDefinition): WebPluginDefinition;
 /**
  * The one audited erasure from Payload to unknown. Channels are stored
  * untyped in the host registry; the payload type lives entirely inside the
  * plugin, behind its own parse gate.
  */
-declare function defineSessionChannel<Payload>(channel: SessionChannelContribution<Payload>): SessionChannelContribution;
+export declare function defineSessionChannel<Payload>(channel: SessionChannelContribution<Payload>): SessionChannelContribution;
 /**
  * Identity helper for a typed slot handle: the owner keeps the
  * SlotDeclaration<Data> to read its fills back through slotData, and the
  * plugin's `slots` array holds it erased. No cast is needed because Data only
  * appears in the parse gate's return position.
  */
-declare function defineSlot<Data>(slot: SlotDeclaration<Data>): SlotDeclaration<Data>;
+export declare function defineSlot<Data>(slot: SlotDeclaration<Data>): SlotDeclaration<Data>;
 //#endregion
-export { defineSessionChannel, defineSlot, defineWebPlugin };
 //# sourceMappingURL=define.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"define.d.cts","names":[],"sources":["../../src/services/define.ts"],"mappings":";;;iBAGgB,gBAAgB,QAAQ,sBAAsB;;;;;;iBAS9C,qBAAqB,SACnC,SAAS,2BAA2B,WACnC;;;;;;;iBAUa,WAAW,MAAM,MAAM,gBAAgB,QAAQ,gBAAgB"}
+{"version":3,"file":"define.d.cts","names":[],"sources":["../../src/services/define.ts"],"mappings":";;;wBAGgB,gBAAgB,QAAQ,sBAAsB;;;;;;wBAS9C,qBAAqB,SACnC,SAAS,2BAA2B,WACnC;;;;;;;wBAUa,WAAW,MAAM,MAAM,gBAAgB,QAAQ,gBAAgB"}

package/dist/services/define.d.mts

@@ -1,20 +1,19 @@
 import { SessionChannelContribution, SlotDeclaration, WebPluginDefinition } from "../types/webPlugin.mjs";
 //#region src/services/define.d.ts
 /** Identity helper so plugin modules get checked literals without a type annotation. */
-declare function defineWebPlugin(plugin: WebPluginDefinition): WebPluginDefinition;
+export declare function defineWebPlugin(plugin: WebPluginDefinition): WebPluginDefinition;
 /**
  * The one audited erasure from Payload to unknown. Channels are stored
  * untyped in the host registry; the payload type lives entirely inside the
  * plugin, behind its own parse gate.
  */
-declare function defineSessionChannel<Payload>(channel: SessionChannelContribution<Payload>): SessionChannelContribution;
+export declare function defineSessionChannel<Payload>(channel: SessionChannelContribution<Payload>): SessionChannelContribution;
 /**
  * Identity helper for a typed slot handle: the owner keeps the
  * SlotDeclaration<Data> to read its fills back through slotData, and the
  * plugin's `slots` array holds it erased. No cast is needed because Data only
  * appears in the parse gate's return position.
  */
-declare function defineSlot<Data>(slot: SlotDeclaration<Data>): SlotDeclaration<Data>;
+export declare function defineSlot<Data>(slot: SlotDeclaration<Data>): SlotDeclaration<Data>;
 //#endregion
-export { defineSessionChannel, defineSlot, defineWebPlugin };
 //# sourceMappingURL=define.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"define.d.mts","names":[],"sources":["../../src/services/define.ts"],"mappings":";;;iBAGgB,gBAAgB,QAAQ,sBAAsB;;;;;;iBAS9C,qBAAqB,SACnC,SAAS,2BAA2B,WACnC;;;;;;;iBAUa,WAAW,MAAM,MAAM,gBAAgB,QAAQ,gBAAgB"}
+{"version":3,"file":"define.d.mts","names":[],"sources":["../../src/services/define.ts"],"mappings":";;;wBAGgB,gBAAgB,QAAQ,sBAAsB;;;;;;wBAS9C,qBAAqB,SACnC,SAAS,2BAA2B,WACnC;;;;;;;wBAUa,WAAW,MAAM,MAAM,gBAAgB,QAAQ,gBAAgB"}

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,6 @@
+import { GlobalStore } from "../types/webPlugin.cjs";
+//#region src/services/globalStore.d.ts
+/** Page-wide plugin state shared by every contribution from the plugin. */
+export declare function defineGlobalStore<T>(initial: T): GlobalStore<T>;
+//#endregion
+//# 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":";;;wBAIgB,kBAAkB,GAAG,SAAS,IAAI,YAAY"}

package/dist/services/globalStore.d.mts

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

@@ -0,0 +1,2 @@
+function e(e){return e.flagValue?e.flagValue:e.envValue?e.envValue:`${e.homeDir}/.doompi/run`}function t(e,t){return`${e}/sessions/${t}.lineage.json`}function n(e){let t;try{t=JSON.parse(e)}catch{return}if(typeof t!=`object`||!t)return;let n=t;if(n.version!==1||typeof n.parentSessionId!=`string`||n.parentSessionId===``)return;let r=typeof n.provenance==`string`?n.provenance:``;return{version:1,parentSessionId:n.parentSessionId,provenance:r}}function r(e){return`${e}/hub.json`}function i(e){let t;try{t=JSON.parse(e)}catch{return}if(typeof t!=`object`||!t)return;let n=t;if(n.version===1&&typeof n.url==`string`&&a(n.url)&&!(typeof n.pid!=`number`||!Number.isInteger(n.pid)||n.pid<=0))return{version:1,url:n.url,pid:n.pid}}function a(e){let t;try{t=new URL(e)}catch{return!1}return t.protocol===`http:`?t.hostname===`127.0.0.1`||t.hostname===`localhost`||t.hostname===`[::1]`||t.hostname===`::1`:!1}exports.HUB_ADVERTISEMENT_VERSION=1,exports.REGISTRY_DIR_ENV=`DOOMPI_RUNTIME_DIR`,exports.SESSION_LINEAGE_RECORD_VERSION=1,exports.hubAdvertisementPath=r,exports.parseHubAdvertisement=i,exports.parseSessionLineage=n,exports.resolveRegistryDir=e,exports.sessionLineagePath=t;
+//# sourceMappingURL=sessionRegistry.cjs.map

package/dist/services/sessionRegistry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionRegistry.cjs","names":[],"sources":["../../src/services/sessionRegistry.ts"],"sourcesContent":["import type { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from '../types/sessionRegistry.ts';\n\n/** Overrides the runtime directory the hub and its session servers share. */\nexport const REGISTRY_DIR_ENV = 'DOOMPI_RUNTIME_DIR';\n\n/** The version a lineage sidecar must carry to be read at all. */\nexport const SESSION_LINEAGE_RECORD_VERSION = 1;\n\n/** The version a hub advertisement must carry to be read at all. */\nexport const HUB_ADVERTISEMENT_VERSION = 1;\n\nconst DEFAULT_RUN_DIR_SEGMENT = '.doompi/run';\nconst SESSIONS_SEGMENT = 'sessions';\nconst LINEAGE_EXTENSION = '.lineage.json';\nconst HUB_ADVERTISEMENT_FILE = 'hub.json';\n\n/**\n * The single definition of where the session registry lives.\n *\n * The hub, the session server, and any package that spawns a session must land\n * on the same directory or a spawned session never appears in the rail. This\n * used to be copied into each of them; it lives here so there is one answer.\n */\nexport function resolveRegistryDir(input: RegistryDirInput): string {\n  if (input.flagValue) return input.flagValue;\n  if (input.envValue) return input.envValue;\n  return `${input.homeDir}/${DEFAULT_RUN_DIR_SEGMENT}`;\n}\n\n/** The lineage sidecar's path, beside the session's own record file. */\nexport function sessionLineagePath(registryDir: string, sessionId: string): string {\n  return `${registryDir}/${SESSIONS_SEGMENT}/${sessionId}${LINEAGE_EXTENSION}`;\n}\n\n/**\n * Reads a lineage sidecar's contents.\n *\n * Every failure means the same thing to a caller: this session has no known\n * parent. A torn write, a version this build predates, or a file that is not\n * JSON at all are all normal, because the sidecar is written by a separate\n * process that may be mid-write or newer than the reader.\n */\nexport function parseSessionLineage(raw: string): SessionLineageRecord | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Partial<SessionLineageRecord>;\n  if (record.version !== SESSION_LINEAGE_RECORD_VERSION) return undefined;\n  if (typeof record.parentSessionId !== 'string' || record.parentSessionId === '') return undefined;\n  const provenance = typeof record.provenance === 'string' ? record.provenance : '';\n  return { version: SESSION_LINEAGE_RECORD_VERSION, parentSessionId: record.parentSessionId, provenance };\n}\n\n/** Where the hub publishes its local address, at the registry root. */\nexport function hubAdvertisementPath(registryDir: string): string {\n  return `${registryDir}/${HUB_ADVERTISEMENT_FILE}`;\n}\n\n/**\n * Reads a hub advertisement's contents.\n *\n * Like the lineage sidecar, every failure collapses to \"no hub advertised\",\n * because a caller can do nothing different with a torn write than with a\n * missing file. The url is required to be a loopback http origin: this file is\n * a discovery hint for local processes, and honouring an arbitrary address out\n * of it would let anything that can write the registry directory redirect a\n * session-create call to a host of its choosing.\n */\nexport function parseHubAdvertisement(raw: string): HubAdvertisement | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Partial<HubAdvertisement>;\n  if (record.version !== HUB_ADVERTISEMENT_VERSION) return undefined;\n  if (typeof record.url !== 'string' || !isLoopbackHttpUrl(record.url)) return undefined;\n  if (typeof record.pid !== 'number' || !Number.isInteger(record.pid) || record.pid <= 0) return undefined;\n  return { version: HUB_ADVERTISEMENT_VERSION, url: record.url, pid: record.pid };\n}\n\n/** Whether a url is plain http to this machine, which is all this file may name. */\nfunction isLoopbackHttpUrl(value: string): boolean {\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return false;\n  }\n  if (url.protocol !== 'http:') return false;\n  return (\n    url.hostname === '127.0.0.1' || url.hostname === 'localhost' || url.hostname === '[::1]' || url.hostname === '::1'\n  );\n}\n"],"mappings":"AAuBA,SAAgB,EAAmB,EAAiC,CAGlE,OAFI,EAAM,UAAkB,EAAM,UAC9B,EAAM,SAAiB,EAAM,SAC1B,GAAG,EAAM,QAAQ,aAC1B,CAGA,SAAgB,EAAmB,EAAqB,EAA2B,CACjF,MAAO,GAAG,EAAY,YAAuB,gBAC/C,CAUA,SAAgB,EAAoB,EAA+C,CACjF,IAAI,EACJ,GAAI,CACF,EAAS,KAAK,MAAM,CAAG,CACzB,MAAQ,CACN,MACF,CACA,GAAI,OAAO,GAAW,WAAY,EAAiB,OACnD,IAAM,EAAS,EAEf,GADI,EAAO,UAAA,GACP,OAAO,EAAO,iBAAoB,UAAY,EAAO,kBAAoB,GAAI,OACjF,IAAM,EAAa,OAAO,EAAO,YAAe,SAAW,EAAO,WAAa,GAC/E,MAAO,CAAE,QAAA,EAAyC,gBAAiB,EAAO,gBAAiB,YAAW,CACxG,CAGA,SAAgB,EAAqB,EAA6B,CAChE,MAAO,GAAG,EAAY,UACxB,CAYA,SAAgB,EAAsB,EAA2C,CAC/E,IAAI,EACJ,GAAI,CACF,EAAS,KAAK,MAAM,CAAG,CACzB,MAAQ,CACN,MACF,CACA,GAAI,OAAO,GAAW,WAAY,EAAiB,OACnD,IAAM,EAAS,EACX,KAAO,UAAA,GACP,OAAO,EAAO,KAAQ,UAAa,EAAkB,EAAO,GAAG,GAC/D,SAAO,EAAO,KAAQ,UAAY,CAAC,OAAO,UAAU,EAAO,GAAG,GAAK,EAAO,KAAO,GACrF,MAAO,CAAE,QAAA,EAAoC,IAAK,EAAO,IAAK,IAAK,EAAO,GAAI,CAChF,CAGA,SAAS,EAAkB,EAAwB,CACjD,IAAI,EACJ,GAAI,CACF,EAAM,IAAI,IAAI,CAAK,CACrB,MAAQ,CACN,MAAO,EACT,CAEA,OADI,EAAI,WAAa,QAEnB,EAAI,WAAa,aAAe,EAAI,WAAa,aAAe,EAAI,WAAa,SAAW,EAAI,WAAa,MAF1E,EAIvC"}

package/dist/services/sessionRegistry.d.cts

@@ -0,0 +1,42 @@
+import { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from "../types/sessionRegistry.cjs";
+//#region src/services/sessionRegistry.d.ts
+/** Overrides the runtime directory the hub and its session servers share. */
+export declare const REGISTRY_DIR_ENV = "DOOMPI_RUNTIME_DIR";
+/** The version a lineage sidecar must carry to be read at all. */
+export declare const SESSION_LINEAGE_RECORD_VERSION = 1;
+/** The version a hub advertisement must carry to be read at all. */
+export declare const HUB_ADVERTISEMENT_VERSION = 1;
+/**
+ * The single definition of where the session registry lives.
+ *
+ * The hub, the session server, and any package that spawns a session must land
+ * on the same directory or a spawned session never appears in the rail. This
+ * used to be copied into each of them; it lives here so there is one answer.
+ */
+export declare function resolveRegistryDir(input: RegistryDirInput): string;
+/** The lineage sidecar's path, beside the session's own record file. */
+export declare function sessionLineagePath(registryDir: string, sessionId: string): string;
+/**
+ * Reads a lineage sidecar's contents.
+ *
+ * Every failure means the same thing to a caller: this session has no known
+ * parent. A torn write, a version this build predates, or a file that is not
+ * JSON at all are all normal, because the sidecar is written by a separate
+ * process that may be mid-write or newer than the reader.
+ */
+export declare function parseSessionLineage(raw: string): SessionLineageRecord | undefined;
+/** Where the hub publishes its local address, at the registry root. */
+export declare function hubAdvertisementPath(registryDir: string): string;
+/**
+ * Reads a hub advertisement's contents.
+ *
+ * Like the lineage sidecar, every failure collapses to "no hub advertised",
+ * because a caller can do nothing different with a torn write than with a
+ * missing file. The url is required to be a loopback http origin: this file is
+ * a discovery hint for local processes, and honouring an arbitrary address out
+ * of it would let anything that can write the registry directory redirect a
+ * session-create call to a host of its choosing.
+ */
+export declare function parseHubAdvertisement(raw: string): HubAdvertisement | undefined;
+//#endregion
+//# sourceMappingURL=sessionRegistry.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionRegistry.d.cts","names":[],"sources":["../../src/services/sessionRegistry.ts"],"mappings":";;;qBAGa;;qBAGA;;qBAGA;;;;;;;;wBAcG,mBAAmB,OAAO;;wBAO1B,mBAAmB,qBAAqB;;;;;;;;;wBAYxC,oBAAoB,cAAc;;wBAgBlC,qBAAqB;;;;;;;;;;;wBAcrB,sBAAsB,cAAc"}

package/dist/services/sessionRegistry.d.mts

@@ -0,0 +1,42 @@
+import { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from "../types/sessionRegistry.mjs";
+//#region src/services/sessionRegistry.d.ts
+/** Overrides the runtime directory the hub and its session servers share. */
+export declare const REGISTRY_DIR_ENV = "DOOMPI_RUNTIME_DIR";
+/** The version a lineage sidecar must carry to be read at all. */
+export declare const SESSION_LINEAGE_RECORD_VERSION = 1;
+/** The version a hub advertisement must carry to be read at all. */
+export declare const HUB_ADVERTISEMENT_VERSION = 1;
+/**
+ * The single definition of where the session registry lives.
+ *
+ * The hub, the session server, and any package that spawns a session must land
+ * on the same directory or a spawned session never appears in the rail. This
+ * used to be copied into each of them; it lives here so there is one answer.
+ */
+export declare function resolveRegistryDir(input: RegistryDirInput): string;
+/** The lineage sidecar's path, beside the session's own record file. */
+export declare function sessionLineagePath(registryDir: string, sessionId: string): string;
+/**
+ * Reads a lineage sidecar's contents.
+ *
+ * Every failure means the same thing to a caller: this session has no known
+ * parent. A torn write, a version this build predates, or a file that is not
+ * JSON at all are all normal, because the sidecar is written by a separate
+ * process that may be mid-write or newer than the reader.
+ */
+export declare function parseSessionLineage(raw: string): SessionLineageRecord | undefined;
+/** Where the hub publishes its local address, at the registry root. */
+export declare function hubAdvertisementPath(registryDir: string): string;
+/**
+ * Reads a hub advertisement's contents.
+ *
+ * Like the lineage sidecar, every failure collapses to "no hub advertised",
+ * because a caller can do nothing different with a torn write than with a
+ * missing file. The url is required to be a loopback http origin: this file is
+ * a discovery hint for local processes, and honouring an arbitrary address out
+ * of it would let anything that can write the registry directory redirect a
+ * session-create call to a host of its choosing.
+ */
+export declare function parseHubAdvertisement(raw: string): HubAdvertisement | undefined;
+//#endregion
+//# sourceMappingURL=sessionRegistry.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionRegistry.d.mts","names":[],"sources":["../../src/services/sessionRegistry.ts"],"mappings":";;;qBAGa;;qBAGA;;qBAGA;;;;;;;;wBAcG,mBAAmB,OAAO;;wBAO1B,mBAAmB,qBAAqB;;;;;;;;;wBAYxC,oBAAoB,cAAc;;wBAgBlC,qBAAqB;;;;;;;;;;;wBAcrB,sBAAsB,cAAc"}

package/dist/services/sessionRegistry.mjs

@@ -0,0 +1,2 @@
+const e=`DOOMPI_RUNTIME_DIR`,t=1,n=1;function r(e){return e.flagValue?e.flagValue:e.envValue?e.envValue:`${e.homeDir}/.doompi/run`}function i(e,t){return`${e}/sessions/${t}.lineage.json`}function a(e){let t;try{t=JSON.parse(e)}catch{return}if(typeof t!=`object`||!t)return;let n=t;if(n.version!==1||typeof n.parentSessionId!=`string`||n.parentSessionId===``)return;let r=typeof n.provenance==`string`?n.provenance:``;return{version:1,parentSessionId:n.parentSessionId,provenance:r}}function o(e){return`${e}/hub.json`}function s(e){let t;try{t=JSON.parse(e)}catch{return}if(typeof t!=`object`||!t)return;let n=t;if(n.version===1&&typeof n.url==`string`&&c(n.url)&&!(typeof n.pid!=`number`||!Number.isInteger(n.pid)||n.pid<=0))return{version:1,url:n.url,pid:n.pid}}function c(e){let t;try{t=new URL(e)}catch{return!1}return t.protocol===`http:`?t.hostname===`127.0.0.1`||t.hostname===`localhost`||t.hostname===`[::1]`||t.hostname===`::1`:!1}export{n as HUB_ADVERTISEMENT_VERSION,e as REGISTRY_DIR_ENV,t as SESSION_LINEAGE_RECORD_VERSION,o as hubAdvertisementPath,s as parseHubAdvertisement,a as parseSessionLineage,r as resolveRegistryDir,i as sessionLineagePath};
+//# sourceMappingURL=sessionRegistry.mjs.map

package/dist/services/sessionRegistry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionRegistry.mjs","names":[],"sources":["../../src/services/sessionRegistry.ts"],"sourcesContent":["import type { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from '../types/sessionRegistry.ts';\n\n/** Overrides the runtime directory the hub and its session servers share. */\nexport const REGISTRY_DIR_ENV = 'DOOMPI_RUNTIME_DIR';\n\n/** The version a lineage sidecar must carry to be read at all. */\nexport const SESSION_LINEAGE_RECORD_VERSION = 1;\n\n/** The version a hub advertisement must carry to be read at all. */\nexport const HUB_ADVERTISEMENT_VERSION = 1;\n\nconst DEFAULT_RUN_DIR_SEGMENT = '.doompi/run';\nconst SESSIONS_SEGMENT = 'sessions';\nconst LINEAGE_EXTENSION = '.lineage.json';\nconst HUB_ADVERTISEMENT_FILE = 'hub.json';\n\n/**\n * The single definition of where the session registry lives.\n *\n * The hub, the session server, and any package that spawns a session must land\n * on the same directory or a spawned session never appears in the rail. This\n * used to be copied into each of them; it lives here so there is one answer.\n */\nexport function resolveRegistryDir(input: RegistryDirInput): string {\n  if (input.flagValue) return input.flagValue;\n  if (input.envValue) return input.envValue;\n  return `${input.homeDir}/${DEFAULT_RUN_DIR_SEGMENT}`;\n}\n\n/** The lineage sidecar's path, beside the session's own record file. */\nexport function sessionLineagePath(registryDir: string, sessionId: string): string {\n  return `${registryDir}/${SESSIONS_SEGMENT}/${sessionId}${LINEAGE_EXTENSION}`;\n}\n\n/**\n * Reads a lineage sidecar's contents.\n *\n * Every failure means the same thing to a caller: this session has no known\n * parent. A torn write, a version this build predates, or a file that is not\n * JSON at all are all normal, because the sidecar is written by a separate\n * process that may be mid-write or newer than the reader.\n */\nexport function parseSessionLineage(raw: string): SessionLineageRecord | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Partial<SessionLineageRecord>;\n  if (record.version !== SESSION_LINEAGE_RECORD_VERSION) return undefined;\n  if (typeof record.parentSessionId !== 'string' || record.parentSessionId === '') return undefined;\n  const provenance = typeof record.provenance === 'string' ? record.provenance : '';\n  return { version: SESSION_LINEAGE_RECORD_VERSION, parentSessionId: record.parentSessionId, provenance };\n}\n\n/** Where the hub publishes its local address, at the registry root. */\nexport function hubAdvertisementPath(registryDir: string): string {\n  return `${registryDir}/${HUB_ADVERTISEMENT_FILE}`;\n}\n\n/**\n * Reads a hub advertisement's contents.\n *\n * Like the lineage sidecar, every failure collapses to \"no hub advertised\",\n * because a caller can do nothing different with a torn write than with a\n * missing file. The url is required to be a loopback http origin: this file is\n * a discovery hint for local processes, and honouring an arbitrary address out\n * of it would let anything that can write the registry directory redirect a\n * session-create call to a host of its choosing.\n */\nexport function parseHubAdvertisement(raw: string): HubAdvertisement | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Partial<HubAdvertisement>;\n  if (record.version !== HUB_ADVERTISEMENT_VERSION) return undefined;\n  if (typeof record.url !== 'string' || !isLoopbackHttpUrl(record.url)) return undefined;\n  if (typeof record.pid !== 'number' || !Number.isInteger(record.pid) || record.pid <= 0) return undefined;\n  return { version: HUB_ADVERTISEMENT_VERSION, url: record.url, pid: record.pid };\n}\n\n/** Whether a url is plain http to this machine, which is all this file may name. */\nfunction isLoopbackHttpUrl(value: string): boolean {\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return false;\n  }\n  if (url.protocol !== 'http:') return false;\n  return (\n    url.hostname === '127.0.0.1' || url.hostname === 'localhost' || url.hostname === '[::1]' || url.hostname === '::1'\n  );\n}\n"],"mappings":"AAGA,MAAa,EAAmB,qBAGnB,EAAiC,EAGjC,EAA4B,EAczC,SAAgB,EAAmB,EAAiC,CAGlE,OAFI,EAAM,UAAkB,EAAM,UAC9B,EAAM,SAAiB,EAAM,SAC1B,GAAG,EAAM,QAAQ,aAC1B,CAGA,SAAgB,EAAmB,EAAqB,EAA2B,CACjF,MAAO,GAAG,EAAY,YAAuB,gBAC/C,CAUA,SAAgB,EAAoB,EAA+C,CACjF,IAAI,EACJ,GAAI,CACF,EAAS,KAAK,MAAM,CAAG,CACzB,MAAQ,CACN,MACF,CACA,GAAI,OAAO,GAAW,WAAY,EAAiB,OACnD,IAAM,EAAS,EAEf,GADI,EAAO,UAAA,GACP,OAAO,EAAO,iBAAoB,UAAY,EAAO,kBAAoB,GAAI,OACjF,IAAM,EAAa,OAAO,EAAO,YAAe,SAAW,EAAO,WAAa,GAC/E,MAAO,CAAE,QAAA,EAAyC,gBAAiB,EAAO,gBAAiB,YAAW,CACxG,CAGA,SAAgB,EAAqB,EAA6B,CAChE,MAAO,GAAG,EAAY,UACxB,CAYA,SAAgB,EAAsB,EAA2C,CAC/E,IAAI,EACJ,GAAI,CACF,EAAS,KAAK,MAAM,CAAG,CACzB,MAAQ,CACN,MACF,CACA,GAAI,OAAO,GAAW,WAAY,EAAiB,OACnD,IAAM,EAAS,EACX,KAAO,UAAA,GACP,OAAO,EAAO,KAAQ,UAAa,EAAkB,EAAO,GAAG,GAC/D,SAAO,EAAO,KAAQ,UAAY,CAAC,OAAO,UAAU,EAAO,GAAG,GAAK,EAAO,KAAO,GACrF,MAAO,CAAE,QAAA,EAAoC,IAAK,EAAO,IAAK,IAAK,EAAO,GAAI,CAChF,CAGA,SAAS,EAAkB,EAAwB,CACjD,IAAI,EACJ,GAAI,CACF,EAAM,IAAI,IAAI,CAAK,CACrB,MAAQ,CACN,MAAO,EACT,CAEA,OADI,EAAI,WAAa,QAEnB,EAAI,WAAa,aAAe,EAAI,WAAa,aAAe,EAAI,WAAa,SAAW,EAAI,WAAa,MAF1E,EAIvC"}

package/dist/services/sessionStore.d.cts

@@ -9,7 +9,6 @@ import { SessionStore } from "../types/webPlugin.cjs";
  * per read would re-render forever. Records are therefore immutable values,
  * and updaters and reducers return new ones.
  */
-declare function defineSessionStore<T>(empty: T): SessionStore<T>;
+export declare function defineSessionStore<T>(empty: T): SessionStore<T>;
 //#endregion
-export { defineSessionStore };
 //# sourceMappingURL=sessionStore.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sessionStore.d.cts","names":[],"sources":["../../src/services/sessionStore.ts"],"mappings":";;;;;;;;;;;iBAkBgB,mBAAmB,GAAG,OAAO,IAAI,aAAa"}
+{"version":3,"file":"sessionStore.d.cts","names":[],"sources":["../../src/services/sessionStore.ts"],"mappings":";;;;;;;;;;;wBAkBgB,mBAAmB,GAAG,OAAO,IAAI,aAAa"}

package/dist/services/sessionStore.d.mts

@@ -9,7 +9,6 @@ import { SessionStore } from "../types/webPlugin.mjs";
  * per read would re-render forever. Records are therefore immutable values,
  * and updaters and reducers return new ones.
  */
-declare function defineSessionStore<T>(empty: T): SessionStore<T>;
+export declare function defineSessionStore<T>(empty: T): SessionStore<T>;
 //#endregion
-export { defineSessionStore };
 //# sourceMappingURL=sessionStore.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sessionStore.d.mts","names":[],"sources":["../../src/services/sessionStore.ts"],"mappings":";;;;;;;;;;;iBAkBgB,mBAAmB,GAAG,OAAO,IAAI,aAAa"}
+{"version":3,"file":"sessionStore.d.mts","names":[],"sources":["../../src/services/sessionStore.ts"],"mappings":";;;;;;;;;;;wBAkBgB,mBAAmB,GAAG,OAAO,IAAI,aAAa"}

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.d.cts

@@ -10,7 +10,7 @@ import { ChannelFrame, HubChannelSource, HubSessionScope, WebHubChannel } from "
  * the page does: through `parse` first, and nothing applied when it is
  * rejected.
  */
-interface ChannelDelivery {
+export interface ChannelDelivery {
   /** Whether the parse gate accepted the payload. */
   accepted: boolean;
 }
@@ -20,8 +20,8 @@ interface ChannelDelivery {
  * Returns whether the gate accepted it, so a test can assert a rejection
  * without knowing what the plugin's parsed shape looks like.
  */
-declare function driveChannel(channel: SessionChannelContribution, sessionId: string, payload: unknown): ChannelDelivery;
-interface HubChannelHarness {
+export declare function driveChannel(channel: SessionChannelContribution, sessionId: string, payload: unknown): ChannelDelivery;
+export interface HubChannelHarness {
   /** The running source, as the hub holds it. */
   source: HubChannelSource;
   /** Everything the source pushed, in order. */
@@ -35,7 +35,7 @@ interface HubChannelHarness {
   removeSession(sessionId: string): void;
   close(): void;
 }
-interface HubChannelHarnessOptions {
+export interface HubChannelHarnessOptions {
   /** Sessions the hub already manages when the channel starts. */
   sessions?: readonly HubSessionScope[];
 }
@@ -46,7 +46,6 @@ interface HubChannelHarnessOptions {
  * afterwards, and a channel that only answers one of those looks correct in a
  * test that exercises the other.
  */
-declare function hubChannelHarness(channel: WebHubChannel, options?: HubChannelHarnessOptions): HubChannelHarness;
+export declare function hubChannelHarness(channel: WebHubChannel, options?: HubChannelHarnessOptions): HubChannelHarness;
 //#endregion
-export { ChannelDelivery, HubChannelHarness, HubChannelHarnessOptions, driveChannel, hubChannelHarness };
 //# sourceMappingURL=channels.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"channels.d.cts","names":[],"sources":["../../../src/services/testing/channels.ts"],"mappings":";;;;;;;;;;;;UAmBiB;;EAEf;;;;;;;;iBASc,aACd,SAAS,4BACT,mBACA,mBACC;UAOc;;EAEf,QAAQ;;WAEC,oBAAoB;;WAEpB;;EAET,SAAS;;EAET,WAAW,OAAO;EAClB,cAAc;EACd;;UAGe;;EAEf,oBAAoB;;;;;;;;;iBAYN,kBAAkB,SAAS,eAAe,UAAS,2BAAgC"}
+{"version":3,"file":"channels.d.cts","names":[],"sources":["../../../src/services/testing/channels.ts"],"mappings":";;;;;;;;;;;;iBAmBiB;;EAEf;;;;;;;;wBASc,aACd,SAAS,4BACT,mBACA,mBACC;iBAOc;;EAEf,QAAQ;;WAEC,oBAAoB;;WAEpB;;EAET,SAAS;;EAET,WAAW,OAAO;EAClB,cAAc;EACd;;iBAGe;;EAEf,oBAAoB;;;;;;;;;wBAYN,kBAAkB,SAAS,eAAe,UAAS,2BAAgC"}

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

@@ -10,7 +10,7 @@ import { ChannelFrame, HubChannelSource, HubSessionScope, WebHubChannel } from "
  * the page does: through `parse` first, and nothing applied when it is
  * rejected.
  */
-interface ChannelDelivery {
+export interface ChannelDelivery {
   /** Whether the parse gate accepted the payload. */
   accepted: boolean;
 }
@@ -20,8 +20,8 @@ interface ChannelDelivery {
  * Returns whether the gate accepted it, so a test can assert a rejection
  * without knowing what the plugin's parsed shape looks like.
  */
-declare function driveChannel(channel: SessionChannelContribution, sessionId: string, payload: unknown): ChannelDelivery;
-interface HubChannelHarness {
+export declare function driveChannel(channel: SessionChannelContribution, sessionId: string, payload: unknown): ChannelDelivery;
+export interface HubChannelHarness {
   /** The running source, as the hub holds it. */
   source: HubChannelSource;
   /** Everything the source pushed, in order. */
@@ -35,7 +35,7 @@ interface HubChannelHarness {
   removeSession(sessionId: string): void;
   close(): void;
 }
-interface HubChannelHarnessOptions {
+export interface HubChannelHarnessOptions {
   /** Sessions the hub already manages when the channel starts. */
   sessions?: readonly HubSessionScope[];
 }
@@ -46,7 +46,6 @@ interface HubChannelHarnessOptions {
  * afterwards, and a channel that only answers one of those looks correct in a
  * test that exercises the other.
  */
-declare function hubChannelHarness(channel: WebHubChannel, options?: HubChannelHarnessOptions): HubChannelHarness;
+export declare function hubChannelHarness(channel: WebHubChannel, options?: HubChannelHarnessOptions): HubChannelHarness;
 //#endregion
-export { ChannelDelivery, HubChannelHarness, HubChannelHarnessOptions, driveChannel, hubChannelHarness };
 //# sourceMappingURL=channels.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"channels.d.mts","names":[],"sources":["../../../src/services/testing/channels.ts"],"mappings":";;;;;;;;;;;;UAmBiB;;EAEf;;;;;;;;iBASc,aACd,SAAS,4BACT,mBACA,mBACC;UAOc;;EAEf,QAAQ;;WAEC,oBAAoB;;WAEpB;;EAET,SAAS;;EAET,WAAW,OAAO;EAClB,cAAc;EACd;;UAGe;;EAEf,oBAAoB;;;;;;;;;iBAYN,kBAAkB,SAAS,eAAe,UAAS,2BAAgC"}
+{"version":3,"file":"channels.d.mts","names":[],"sources":["../../../src/services/testing/channels.ts"],"mappings":";;;;;;;;;;;;iBAmBiB;;EAEf;;;;;;;;wBASc,aACd,SAAS,4BACT,mBACA,mBACC;iBAOc;;EAEf,QAAQ;;WAEC,oBAAoB;;WAEpB;;EAET,SAAS;;EAET,WAAW,OAAO;EAClB,cAAc;EACd;;iBAGe;;EAEf,oBAAoB;;;;;;;;;wBAYN,kBAAkB,SAAS,eAAe,UAAS,2BAAgC"}

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/render.d.cts

@@ -18,7 +18,7 @@ import { ComponentType } from "react";
  * Callers pass components as values, never as JSX, so a plugin package needs no
  * JSX configuration in the project that holds its tests.
  */
-interface RenderedPlugin {
+export interface RenderedPlugin {
   /** The markup, or an empty string when the component threw. */
   html: string;
   /** What the component threw, which the host would have swallowed. */
@@ -26,7 +26,6 @@ interface RenderedPlugin {
   /** Whether the rendered markup contains this text, ignoring the tags around it. */
   includes(text: string): boolean;
 }
-declare function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin;
+export declare function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin;
 //#endregion
-export { RenderedPlugin, renderPlugin };
 //# sourceMappingURL=render.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"render.d.cts","names":[],"sources":["../../../src/services/testing/render.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;UAuBiB;;EAEf;;EAEA,OAAO;;EAEP,SAAS;;iBAWK,aAAa,sBAAsB,WAAW,cAAc,QAAQ,OAAO,QAAQ"}
+{"version":3,"file":"render.d.cts","names":[],"sources":["../../../src/services/testing/render.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAuBiB;;EAEf;;EAEA,OAAO;;EAEP,SAAS;;wBAWK,aAAa,sBAAsB,WAAW,cAAc,QAAQ,OAAO,QAAQ"}

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

@@ -18,7 +18,7 @@ import { ComponentType } from "react";
  * Callers pass components as values, never as JSX, so a plugin package needs no
  * JSX configuration in the project that holds its tests.
  */
-interface RenderedPlugin {
+export interface RenderedPlugin {
   /** The markup, or an empty string when the component threw. */
   html: string;
   /** What the component threw, which the host would have swallowed. */
@@ -26,7 +26,6 @@ interface RenderedPlugin {
   /** Whether the rendered markup contains this text, ignoring the tags around it. */
   includes(text: string): boolean;
 }
-declare function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin;
+export declare function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin;
 //#endregion
-export { RenderedPlugin, renderPlugin };
 //# sourceMappingURL=render.d.mts.map