@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/types/server/directHarnessRuntime.d.mts

@@ -1,8 +1,8 @@
-import { HistoryOwnership } from "../../services/historyImport/index.mjs";
+import { PoPlatform } from "../../schemas/platform.mjs";
 import { Static, TSchema } from "typebox";
-import { CompactionPolicy, Conversation, ConversationStreamOptions, Harness, QueueMode, Session, Storage } from "@earendil-works/pi-durable";
-import { Context, JsonValue } from "@earendil-works/chord";
+import { CompactionPolicy, Conversation, ConversationId, ConversationStreamOptions, Cursor, EntryQuery, EntryRecord, Harness, Page, QueueMode, Session, Storage } from "@earendil-works/pi-durable";
 import { Api, CredentialStore, ImageContent, Message, Model, ModelThinkingLevel, Models, MutableModels, Provider, RetryPolicy, Tool, ToolResultMessage, Usage } from "@earendil-works/pi-ai";
+import { Context, JsonValue } from "@earendil-works/chord";
 //#region src/types/server/directHarnessRuntime.d.ts
 export type AgentMessage = Message | import('@earendil-works/pi-coding-agent').SessionMessageEntry['message'];
 export type ThinkingLevel = ModelThinkingLevel;
@@ -60,6 +60,8 @@ export type Entry = {
   summary: string;
   tokensBefore: number;
   retainedTail: AgentMessage[];
+  /** The first entry kept verbatim, as the harness stored the cut. */
+  firstKeptEntryId?: string;
   fromHook: boolean;
   details?: JsonValue;
   usage?: Usage;
@@ -87,7 +89,6 @@ export interface SessionStats {
   cost: number;
   usage: Usage;
   sessionId?: string;
-  sessionFile?: string;
   totalMessages?: number;
   totalCost?: number;
   contextUsage?: import('@earendil-works/pi-coding-agent').ContextUsage;
@@ -97,7 +98,7 @@ export interface CompactionPreparation {
   messages: AgentMessage[];
   tokensBefore: number;
   retainedTail: AgentMessage[];
-  firstKeptEntryId?: string;
+  firstKeptEntryId: string;
   messagesToSummarize: AgentMessage[];
   turnPrefixMessages: AgentMessage[];
   isSplitTurn: boolean;
@@ -197,12 +198,12 @@ export type HarnessEvent = ({
   message: import('@earendil-works/pi-ai').AssistantMessage;
   event: import('@earendil-works/pi-ai').AssistantMessageEvent;
 } | {
-  type: 'tool_start';
+  type: 'tool_execution_start';
   toolCallId: string;
   toolName: string;
   args: Record<string, JsonValue>;
 } | {
-  type: 'tool_update';
+  type: 'tool_execution_update';
   toolCallId: string;
   toolName: string;
   partialResult: {
@@ -210,7 +211,7 @@ export type HarnessEvent = ({
     details?: JsonValue;
   };
 } | {
-  type: 'tool_end';
+  type: 'tool_execution_end';
   toolCallId: string;
   toolName: string;
   result: {
@@ -219,7 +220,7 @@ export type HarnessEvent = ({
   };
   isError: boolean;
 } | {
-  type: 'entry_added';
+  type: 'entry_appended';
   entry: Entry;
 } | {
   type: 'queue_update';
@@ -297,10 +298,14 @@ export interface DirectHarnessModelBoundary {
   resources: AgentHarnessResources;
 }
 export interface DirectHarnessRuntimeOptions<TContext extends object | undefined = object | undefined> {
-  /** Stable session identity. Existing session files are authoritative when omitted. */
+  /** Stable session identity. The stored identity is authoritative when omitted. */
   sessionId?: string;
-  /** Working directory used by NodeExecutionEnv and newly-created sessions. */
+  /** Reopen this stored session only; never create it. */
+  resume?: boolean;
+  /** Working directory used by the execution env and newly-created sessions. */
   cwd: string;
+  /** Host capabilities: the tools' execution env at `cwd` and the agent session storage. */
+  platform: PoPlatform;
   /** Stable lane identity. Defaults to `main`. */
   lane?: string;
   /** Stable host identity exposed to the parent orchestrator. */
@@ -308,20 +313,10 @@ export interface DirectHarnessRuntimeOptions<TContext extends object | undefined
   sessionName?: string;
   /** Injecting a Session is supported for tests and hosts that already own storage. */
   session?: Session;
+  /** Storage the caller owns and closes; replaces `platform.sessions`. */
   durableStorage?: Storage;
-  /** Durable hosts write SQLite. The legacy JSONL selector is rejected. */
-  storage?: 'jsonl' | 'sqlite';
-  /** Existing durable-v1 SQLite session path. Requires historyOwnership for its lifetime. */
-  sessionPath?: string;
-  /** Existing v3 JSONL path. It is never opened for writing. */
-  legacySessionPath?: string;
   /** Parent identity recorded on newly-created sessions. */
   parentSessionId?: string;
-  sessionsRoot?: string;
-  /** Required when opening any existing session or importing legacy history. */
-  historyOwnership?: HistoryOwnership;
-  historyOriginalPath?: string;
-  historyStatePath?: string;
   /** Public pi-ai model/provider/credential registries. */
   models?: Models | MutableModels;
   providers?: readonly Provider[];
@@ -364,6 +359,10 @@ export interface DirectHarnessRuntimeOptions<TContext extends object | undefined
   /** Returns false when the text is not an active package command, preserving normal prompt handling. */
   dispatchCommand?: (text: string) => Promise<boolean>;
 }
+/** A further lane on an open runtime's Harness, such as a subagent's: its own conversation, tools, prompt and hooks. */
+export type DirectHarnessLaneOptions<TContext extends object | undefined = object | undefined> = Omit<DirectHarnessRuntimeOptions<TContext>, 'platform' | 'resume' | 'lane' | 'session' | 'durableStorage' | 'parentSessionId' | 'models' | 'providers' | 'credentials' | 'initialFastMode' | 'initialAgentLocked' | 'retry' | 'compaction' | 'steeringMode' | 'followUpMode' | 'toolExecution' | 'streamOptions'> & {
+  sessionId: string;
+};
 export interface DirectHarnessEventListener {
   (event: HarnessEvent, context: Context): void | Promise<void>;
 }
@@ -373,7 +372,7 @@ export interface DirectHarnessQueuedInput {
   images?: ImageContent[];
   delivery: 'steer' | 'followUp' | 'nextRun';
   scheduling: 'automatic' | 'held';
-  disposition: 'pending' | 'handoff' | 'uncertain';
+  disposition: 'pending' | 'handoff';
 }
 export interface DirectHarnessLifecycle {
   revision: number;
@@ -388,7 +387,6 @@ export interface DirectHarnessLifecycle {
 /** Direct, same-process AgentHarness runtime owned by one session host. */
 export interface DirectHarnessRuntime<TContext extends object | undefined = object | undefined> {
   readonly sessionId: string;
-  readonly sessionFile?: string;
   readonly laneName: string;
   readonly harnessId: string;
   readonly session: Session;
@@ -413,7 +411,21 @@ export interface DirectHarnessRuntime<TContext extends object | undefined = obje
     entries: Entry[];
     leafId: string | null;
   }>;
-  /** Detached canonical context, before facet hooks, with unchanged custom metadata restored and no system message. */
+  /** Inclusive numeric-sequence suffix, oldest first, with the same projection and parents as readEntries. */
+  readEntriesFrom(seq: number): Promise<{
+    entries: Entry[];
+    leafId: string | null;
+  }>;
+  /** Fork-aware keyset scan of the active conversation, for bounded transcript pages. */
+  scanEntries(query: Omit<EntryQuery, 'conversationId'>, limit: number, cursor: Cursor | undefined, context: Context): Promise<Page<EntryRecord, Cursor>>;
+  /** Profile identity entries of the active conversation, from its identity history document. */
+  readIdentities(context: Context): Promise<{
+    readonly items: readonly {
+      seq: number;
+      data: JsonValue;
+    }[];
+  } | undefined>;
+  /** Detached canonical context, before package hooks, with unchanged custom metadata restored and no system message. */
   getContextMessages(): Promise<AgentMessage[]>;
   listCommands(): readonly {
     name: string;
@@ -446,10 +458,17 @@ export interface DirectHarnessRuntime<TContext extends object | undefined = obje
     followUp: never[];
   }>;
   setName(name: string): Promise<void>;
+  /** Stores already normalized groups and emits SESSION_GROUPS_CHANGED_FRAME. */
+  setGroups(groups: readonly string[]): Promise<void>;
   getSessionStats(): Promise<SessionStats>;
   replaceTools(tools: AgentHarnessTool<TContext>[]): Promise<void>;
   replaceResources(resources: AgentHarnessResources): Promise<void>;
   readResources(): Promise<AgentHarnessResources>;
+  /**
+   * UI configuration only: waits for the whole tool batch, or runs when idle.
+   * Resolves with the completed callback result. Tool bodies must not await this API.
+   */
+  runAtToolBoundary<T>(callback: () => Promise<T>): Promise<T>;
   /** Runs one non-agent operation while idle. Waiting is opt-in and does not guarantee ordering. */
   runExternalOperation<T>(operation: () => Promise<T>, options?: {
     signal?: AbortSignal;
@@ -499,9 +518,12 @@ export interface DirectHarnessRuntime<TContext extends object | undefined = obje
    * `nextTurn` stages without writing or waking the agent and returns resolved settled.
    * Only the next ordinary user prompt admission flushes it, not automatic or internal runs.
    * Reuse requestId to deduplicate retries of steer/followUp admission.
+   * During a user interruption the input is admitted after it, without delaying the return; `admitted` then
+   * resolves once the input is durable, so a caller that acknowledges delivery awaits it.
    */
   submitInternalMessage(message: string | AgentMessage, delivery?: 'steer' | 'followUp' | 'nextTurn', requestId?: string): Promise<{
     settled: Promise<void>;
+    admitted?: Promise<void>;
   }>;
   steer(message: string | AgentMessage, images?: ImageContent[], targetOperationId?: string): Promise<void>;
   followUp(message: string | AgentMessage, images?: ImageContent[]): Promise<void>;
@@ -521,6 +543,13 @@ export interface DirectHarnessRuntime<TContext extends object | undefined = obje
   }>;
   /** Continues a persisted in-flight operation; false when the lane had none. */
   resume(): Promise<boolean>;
+  /**
+   * Runs `conversation` of this runtime's Harness as a further lane with its own tools, prompt and hooks; the main
+   * lane only. Disposing the lane detaches it and never aborts its work, so a child resumes with the Harness.
+   */
+  openLane(conversation: Conversation, options: DirectHarnessLaneOptions<TContext>): Promise<DirectHarnessRuntime<TContext>>;
+  /** Removes a finished lane's tools, prompt and hooks from the Harness; the main lane only. */
+  closeLane(conversationId: ConversationId): void;
   dispose(): Promise<void>;
 }
 //#endregion

package/dist/src/types/server/directHarnessRuntime.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"directHarnessRuntime.d.mts","names":[],"sources":["../../../../src/types/server/directHarnessRuntime.ts"],"mappings":"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"}
+{"version":3,"file":"directHarnessRuntime.d.mts","names":[],"sources":["../../../../src/types/server/directHarnessRuntime.ts"],"mappings":"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"}

package/dist/src/types/server/sessionToolSurface.d.mts

@@ -1,5 +1,5 @@
-import { DoomMcpUiResource } from "../../schemas/mcpFacet.mjs";
-import { DoomHeadlessTool, DoomHeadlessToolResult, DoomMcpSkillAccess } from "../../schemas/headless.mjs";
+import { PoMcpUiResource } from "../../schemas/mcpFacet.mjs";
+import { PoHeadlessTool, PoHeadlessToolResult, PoMcpSkillAccess } from "../../schemas/headless.mjs";
 import { TSchema } from "typebox";
 //#region src/types/server/sessionToolSurface.d.ts
 export interface SessionToolDescriptor {
@@ -7,16 +7,16 @@ export interface SessionToolDescriptor {
   readonly label: string;
   readonly description: string;
   readonly parameters: TSchema;
-  readonly annotations?: DoomHeadlessTool['annotations'];
-  readonly outputSchema?: DoomHeadlessTool['outputSchema'];
-  readonly _meta?: DoomHeadlessTool['_meta'];
+  readonly annotations?: PoHeadlessTool['annotations'];
+  readonly outputSchema?: PoHeadlessTool['outputSchema'];
+  readonly _meta?: PoHeadlessTool['_meta'];
 }
 export interface SessionSkillDescriptor {
   readonly name: string;
   readonly description: string;
   readonly uri: string;
 }
-export type SessionUiResourceDescriptor = Omit<DoomMcpUiResource, 'read'>;
+export type SessionUiResourceDescriptor = Omit<PoMcpUiResource, 'read'>;
 export interface SessionToolSurfaceSnapshot {
   readonly revision: number;
   readonly tools: readonly SessionToolDescriptor[];
@@ -29,14 +29,14 @@ export interface SessionToolInvocation {
   readonly arguments: Record<string, unknown>;
   readonly signal?: AbortSignal;
   /** Grant-filtered remote skills for this invocation only. */
-  readonly mcpSkills?: DoomMcpSkillAccess;
+  readonly mcpSkills?: PoMcpSkillAccess;
   readonly authorize?: () => void | Promise<void>;
-  readonly onUpdate?: (result: DoomHeadlessToolResult) => void;
+  readonly onUpdate?: (result: PoHeadlessToolResult) => void;
 }
 /** Live, session-owned boundary used by transports that expose the applied capability surface. */
 export interface SessionToolSurface {
   readSurface(): SessionToolSurfaceSnapshot;
-  invokeTool(invocation: SessionToolInvocation): Promise<DoomHeadlessToolResult>;
+  invokeTool(invocation: SessionToolInvocation): Promise<PoHeadlessToolResult>;
   readSkill(revision: number, uri: string): string | Promise<string>;
   readUiResource?(revision: number, uri: string): string | Promise<string>;
 }

package/dist/src/web/services/apiClient/index.d.mts

@@ -149,4 +149,5 @@ export interface ApiClientOptions<TScopes extends ApiScopeName> {
  */
 export declare function createApiClient<const TScopes extends ApiScopeName, const TRoutes extends ApiRoutes>(routes: TRoutes, options: ApiClientOptions<TScopes>): ApiClient<TScopes, TRoutes>;
 //#endregion
+export {};
 //# sourceMappingURL=index.d.mts.map

package/dist/src/web/services/apiPaths/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../../../../src/web/services/apiPaths/index.ts"],"sourcesContent":["/**\n * The byte shape of every URL the browser addresses a package API with.\n *\n * One implementation, because the alternative is what the cockpit had: twelve\n * packages each concatenating `${sessionApiPath(id)}/plugins/${base}${path}` by\n * hand, three of them spelling the prefix a fourth way, and one rewriting it\n * with `String.replace`. A route that moves by one character is answered by the\n * service worker out of the signed bundle cache instead of the network, so the\n * failure is a 404 nowhere near its cause.\n *\n * The host builds the same strings from `doomApiMountPath` and, for OpenAPI\n * templating, from `createApiDocuments`. Those live in the node half of this\n * package and cannot be imported here: `src/web` is a separate tree that reads\n * neither `src/schemas` nor `src/services`. The three are held together by the\n * agreement test instead of by a call, which is the guarantee that matters.\n */\n\n/**\n * Who a request is addressed to. Ids are supplied decoded and encoded here, so\n * a caller never double-encodes and a workspace with a slash in its name cannot\n * forge a path segment.\n */\nexport type ApiScopeAddress =\n  | { readonly scope: 'global' }\n  | { readonly scope: 'workspace'; readonly workspaceId: string }\n  | { readonly scope: 'session'; readonly workspaceId: string; readonly sessionId: string };\n\n/** Path parameter values, substituted into a route's `:name` segments. */\nexport type ApiParams = Readonly<Record<string, string>>;\n\n/** Query values a route may carry. `undefined` drops the parameter rather than sending 'undefined'. */\nexport type ApiQuery = Readonly<Record<string, string | number | boolean | undefined>>;\n\n/** The base path the host reserves for its own settings API, mounted outside /plugins/. */\nexport const SETTINGS_BASE_PATH = 'settings';\n\n/** The scope's own resource root: what a host-owned route hangs off. */\nexport function scopeApiRoot(address: ApiScopeAddress): string {\n  if (address.scope === 'global') return '/api';\n  const workspace = `/api/workspaces/${encodeURIComponent(address.workspaceId)}`;\n  if (address.scope === 'workspace') return workspace;\n  return `${workspace}/sessions/${encodeURIComponent(address.sessionId)}`;\n}\n\n/**\n * The mount one package API answers on.\n *\n * `basePath` is omitted for a host-owned route, which the contract schema\n * already spells that way, so the session file-bytes route and a plugin route\n * are the same construction with one field different rather than two code\n * paths. `settings` is the host's own API and sits beside `/plugins`, not\n * under it.\n */\nexport function pluginApiBase(address: ApiScopeAddress, basePath: string | undefined): string {\n  const root = scopeApiRoot(address);\n  if (basePath === undefined) return root;\n  if (basePath === SETTINGS_BASE_PATH) return `${root}/${SETTINGS_BASE_PATH}`;\n  return `${root}/plugins/${basePath}`;\n}\n\n/**\n * The query string, `encodeURIComponent` per pair rather than `URLSearchParams`.\n *\n * `URLSearchParams` writes a space as `+`, which only decodes back to a space\n * under form-urlencoded rules; `%20` decodes to a space everywhere. The\n * cockpit already relied on that difference in both directions, so picking the\n * unambiguous one is what lets a single encoder serve every route.\n */\nexport function apiQueryString(query: ApiQuery | undefined): string {\n  if (query === undefined) return '';\n  const pairs: string[] = [];\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined) continue;\n    pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  }\n  return pairs.length === 0 ? '' : `?${pairs.join('&')}`;\n}\n\n/**\n * The absolute, root-relative URL for one route.\n *\n * Root-relative on purpose: the sealed transport refuses anything else, because\n * a remote session relays its requests through a gateway that will not forward\n * an arbitrary origin.\n *\n * A route whose path is exactly '/' addresses the mount itself, so the slash is\n * dropped rather than doubled.\n */\nexport function pluginApiUrl(\n  address: ApiScopeAddress,\n  basePath: string | undefined,\n  path: string,\n  query?: ApiQuery,\n  params?: ApiParams,\n): string {\n  const resolved = applyPathParams(path, params);\n  return `${pluginApiBase(address, basePath)}${resolved === '/' ? '' : resolved}${apiQueryString(query)}`;\n}\n\n/**\n * Substitutes a route's `:name` segments, as Hono spells them.\n *\n * Encoded per segment, so a value containing a slash names one segment rather\n * than inventing another. A declared parameter with no value is left as the\n * literal `:name`, which fails visibly at the route instead of silently\n * addressing the collection above it.\n */\nexport function applyPathParams(path: string, params: ApiParams | undefined): string {\n  if (params === undefined || !path.includes(':')) return path;\n  return path\n    .split('/')\n    .map((segment) => {\n      if (!segment.startsWith(':')) return segment;\n      // Hono writes a multi-segment parameter as `:name{.+}`. Its value is a\n      // relative path, so the slashes inside it are structure the route means\n      // to keep; encoding them would address one oddly-named file instead of a\n      // nested one. Each piece is still escaped on its own.\n      const catchAll = segment.endsWith('}');\n      const name = catchAll ? segment.slice(1, segment.indexOf('{')) : segment.slice(1);\n      const value = params[name];\n      if (value === undefined) return segment;\n      return catchAll ? value.split('/').map(encodeURIComponent).join('/') : encodeURIComponent(value);\n    })\n    .join('/');\n}\n"],"mappings":";;AAkCA,MAAa,qBAAqB;;AAGlC,SAAgB,aAAa,SAAkC;CAC7D,IAAI,QAAQ,UAAU,UAAU,OAAO;CACvC,MAAM,YAAY,mBAAmB,mBAAmB,QAAQ,WAAW;CAC3E,IAAI,QAAQ,UAAU,aAAa,OAAO;CAC1C,OAAO,GAAG,UAAU,YAAY,mBAAmB,QAAQ,SAAS;AACtE;;;;;;;;;;AAWA,SAAgB,cAAc,SAA0B,UAAsC;CAC5F,MAAM,OAAO,aAAa,OAAO;CACjC,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,IAAI,aAAA,YAAiC,OAAO,GAAG,KAAK,GAAG;CACvD,OAAO,GAAG,KAAK,WAAW;AAC5B;;;;;;;;;AAUA,SAAgB,eAAe,OAAqC;CAClE,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;EAChD,IAAI,UAAU,KAAA,GAAW;EACzB,MAAM,KAAK,GAAG,mBAAmB,GAAG,EAAE,GAAG,mBAAmB,OAAO,KAAK,CAAC,GAAG;CAC9E;CACA,OAAO,MAAM,WAAW,IAAI,KAAK,IAAI,MAAM,KAAK,GAAG;AACrD;;;;;;;;;;;AAYA,SAAgB,aACd,SACA,UACA,MACA,OACA,QACQ;CACR,MAAM,WAAW,gBAAgB,MAAM,MAAM;CAC7C,OAAO,GAAG,cAAc,SAAS,QAAQ,IAAI,aAAa,MAAM,KAAK,WAAW,eAAe,KAAK;AACtG;;;;;;;;;AAUA,SAAgB,gBAAgB,MAAc,QAAuC;CACnF,IAAI,WAAW,KAAA,KAAa,CAAC,KAAK,SAAS,GAAG,GAAG,OAAO;CACxD,OAAO,KACJ,MAAM,GAAG,CAAC,CACV,KAAK,YAAY;EAChB,IAAI,CAAC,QAAQ,WAAW,GAAG,GAAG,OAAO;EAKrC,MAAM,WAAW,QAAQ,SAAS,GAAG;EAErC,MAAM,QAAQ,OADD,WAAW,QAAQ,MAAM,GAAG,QAAQ,QAAQ,GAAG,CAAC,IAAI,QAAQ,MAAM,CAAC;EAEhF,IAAI,UAAU,KAAA,GAAW,OAAO;EAChC,OAAO,WAAW,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,KAAK,GAAG,IAAI,mBAAmB,KAAK;CACjG,CAAC,CAAC,CACD,KAAK,GAAG;AACb"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../../src/web/services/apiPaths/index.ts"],"sourcesContent":["/**\n * The byte shape of every URL the browser addresses a package API with.\n *\n * One implementation, because the alternative is what the cockpit had: twelve\n * packages each concatenating `${sessionApiPath(id)}/plugins/${base}${path}` by\n * hand, three of them spelling the prefix a fourth way, and one rewriting it\n * with `String.replace`. A route that moves by one character is answered by the\n * service worker out of the signed bundle cache instead of the network, so the\n * failure is a 404 nowhere near its cause.\n *\n * The host builds the same strings from `poApiMountPath` and, for OpenAPI\n * templating, from `createApiDocuments`. Those live in the node half of this\n * package and cannot be imported here: `src/web` is a separate tree that reads\n * neither `src/schemas` nor `src/services`. The three are held together by the\n * agreement test instead of by a call, which is the guarantee that matters.\n */\n\n/**\n * Who a request is addressed to. Ids are supplied decoded and encoded here, so\n * a caller never double-encodes and a workspace with a slash in its name cannot\n * forge a path segment.\n */\nexport type ApiScopeAddress =\n  | { readonly scope: 'global' }\n  | { readonly scope: 'workspace'; readonly workspaceId: string }\n  | { readonly scope: 'session'; readonly workspaceId: string; readonly sessionId: string };\n\n/** Path parameter values, substituted into a route's `:name` segments. */\nexport type ApiParams = Readonly<Record<string, string>>;\n\n/** Query values a route may carry. `undefined` drops the parameter rather than sending 'undefined'. */\nexport type ApiQuery = Readonly<Record<string, string | number | boolean | undefined>>;\n\n/** The base path the host reserves for its own settings API, mounted outside /plugins/. */\nexport const SETTINGS_BASE_PATH = 'settings';\n\n/** The scope's own resource root: what a host-owned route hangs off. */\nexport function scopeApiRoot(address: ApiScopeAddress): string {\n  if (address.scope === 'global') return '/api';\n  const workspace = `/api/workspaces/${encodeURIComponent(address.workspaceId)}`;\n  if (address.scope === 'workspace') return workspace;\n  return `${workspace}/sessions/${encodeURIComponent(address.sessionId)}`;\n}\n\n/**\n * The mount one package API answers on.\n *\n * `basePath` is omitted for a host-owned route, which the contract schema\n * already spells that way, so the session file-bytes route and a plugin route\n * are the same construction with one field different rather than two code\n * paths. `settings` is the host's own API and sits beside `/plugins`, not\n * under it.\n */\nexport function pluginApiBase(address: ApiScopeAddress, basePath: string | undefined): string {\n  const root = scopeApiRoot(address);\n  if (basePath === undefined) return root;\n  if (basePath === SETTINGS_BASE_PATH) return `${root}/${SETTINGS_BASE_PATH}`;\n  return `${root}/plugins/${basePath}`;\n}\n\n/**\n * The query string, `encodeURIComponent` per pair rather than `URLSearchParams`.\n *\n * `URLSearchParams` writes a space as `+`, which only decodes back to a space\n * under form-urlencoded rules; `%20` decodes to a space everywhere. The\n * cockpit already relied on that difference in both directions, so picking the\n * unambiguous one is what lets a single encoder serve every route.\n */\nexport function apiQueryString(query: ApiQuery | undefined): string {\n  if (query === undefined) return '';\n  const pairs: string[] = [];\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined) continue;\n    pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  }\n  return pairs.length === 0 ? '' : `?${pairs.join('&')}`;\n}\n\n/**\n * The absolute, root-relative URL for one route.\n *\n * Root-relative on purpose: the sealed transport refuses anything else, because\n * a remote session relays its requests through a gateway that will not forward\n * an arbitrary origin.\n *\n * A route whose path is exactly '/' addresses the mount itself, so the slash is\n * dropped rather than doubled.\n */\nexport function pluginApiUrl(\n  address: ApiScopeAddress,\n  basePath: string | undefined,\n  path: string,\n  query?: ApiQuery,\n  params?: ApiParams,\n): string {\n  const resolved = applyPathParams(path, params);\n  return `${pluginApiBase(address, basePath)}${resolved === '/' ? '' : resolved}${apiQueryString(query)}`;\n}\n\n/**\n * Substitutes a route's `:name` segments, as Hono spells them.\n *\n * Encoded per segment, so a value containing a slash names one segment rather\n * than inventing another. A declared parameter with no value is left as the\n * literal `:name`, which fails visibly at the route instead of silently\n * addressing the collection above it.\n */\nexport function applyPathParams(path: string, params: ApiParams | undefined): string {\n  if (params === undefined || !path.includes(':')) return path;\n  return path\n    .split('/')\n    .map((segment) => {\n      if (!segment.startsWith(':')) return segment;\n      // Hono writes a multi-segment parameter as `:name{.+}`. Its value is a\n      // relative path, so the slashes inside it are structure the route means\n      // to keep; encoding them would address one oddly-named file instead of a\n      // nested one. Each piece is still escaped on its own.\n      const catchAll = segment.endsWith('}');\n      const name = catchAll ? segment.slice(1, segment.indexOf('{')) : segment.slice(1);\n      const value = params[name];\n      if (value === undefined) return segment;\n      return catchAll ? value.split('/').map(encodeURIComponent).join('/') : encodeURIComponent(value);\n    })\n    .join('/');\n}\n"],"mappings":";;AAkCA,MAAa,qBAAqB;;AAGlC,SAAgB,aAAa,SAAkC;CAC7D,IAAI,QAAQ,UAAU,UAAU,OAAO;CACvC,MAAM,YAAY,mBAAmB,mBAAmB,QAAQ,WAAW;CAC3E,IAAI,QAAQ,UAAU,aAAa,OAAO;CAC1C,OAAO,GAAG,UAAU,YAAY,mBAAmB,QAAQ,SAAS;AACtE;;;;;;;;;;AAWA,SAAgB,cAAc,SAA0B,UAAsC;CAC5F,MAAM,OAAO,aAAa,OAAO;CACjC,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,IAAI,aAAA,YAAiC,OAAO,GAAG,KAAK,GAAG;CACvD,OAAO,GAAG,KAAK,WAAW;AAC5B;;;;;;;;;AAUA,SAAgB,eAAe,OAAqC;CAClE,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;EAChD,IAAI,UAAU,KAAA,GAAW;EACzB,MAAM,KAAK,GAAG,mBAAmB,GAAG,EAAE,GAAG,mBAAmB,OAAO,KAAK,CAAC,GAAG;CAC9E;CACA,OAAO,MAAM,WAAW,IAAI,KAAK,IAAI,MAAM,KAAK,GAAG;AACrD;;;;;;;;;;;AAYA,SAAgB,aACd,SACA,UACA,MACA,OACA,QACQ;CACR,MAAM,WAAW,gBAAgB,MAAM,MAAM;CAC7C,OAAO,GAAG,cAAc,SAAS,QAAQ,IAAI,aAAa,MAAM,KAAK,WAAW,eAAe,KAAK;AACtG;;;;;;;;;AAUA,SAAgB,gBAAgB,MAAc,QAAuC;CACnF,IAAI,WAAW,KAAA,KAAa,CAAC,KAAK,SAAS,GAAG,GAAG,OAAO;CACxD,OAAO,KACJ,MAAM,GAAG,CAAC,CACV,KAAK,YAAY;EAChB,IAAI,CAAC,QAAQ,WAAW,GAAG,GAAG,OAAO;EAKrC,MAAM,WAAW,QAAQ,SAAS,GAAG;EAErC,MAAM,QAAQ,OADD,WAAW,QAAQ,MAAM,GAAG,QAAQ,QAAQ,GAAG,CAAC,IAAI,QAAQ,MAAM,CAAC;EAEhF,IAAI,UAAU,KAAA,GAAW,OAAO;EAChC,OAAO,WAAW,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,KAAK,GAAG,IAAI,mBAAmB,KAAK;CACjG,CAAC,CAAC,CACD,KAAK,GAAG;AACb"}

package/dist/src/web/services/apiPaths/index.d.mts

@@ -9,7 +9,7 @@
  * service worker out of the signed bundle cache instead of the network, so the
  * failure is a 404 nowhere near its cause.
  *
- * The host builds the same strings from `doomApiMountPath` and, for OpenAPI
+ * The host builds the same strings from `poApiMountPath` and, for OpenAPI
  * templating, from `createApiDocuments`. Those live in the node half of this
  * package and cannot be imported here: `src/web` is a separate tree that reads
  * neither `src/schemas` nor `src/services`. The three are held together by the

package/dist/src/web/services/apiPaths/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/web/services/apiPaths/index.ts"],"sourcesContent":["/**\n * The byte shape of every URL the browser addresses a package API with.\n *\n * One implementation, because the alternative is what the cockpit had: twelve\n * packages each concatenating `${sessionApiPath(id)}/plugins/${base}${path}` by\n * hand, three of them spelling the prefix a fourth way, and one rewriting it\n * with `String.replace`. A route that moves by one character is answered by the\n * service worker out of the signed bundle cache instead of the network, so the\n * failure is a 404 nowhere near its cause.\n *\n * The host builds the same strings from `doomApiMountPath` and, for OpenAPI\n * templating, from `createApiDocuments`. Those live in the node half of this\n * package and cannot be imported here: `src/web` is a separate tree that reads\n * neither `src/schemas` nor `src/services`. The three are held together by the\n * agreement test instead of by a call, which is the guarantee that matters.\n */\n\n/**\n * Who a request is addressed to. Ids are supplied decoded and encoded here, so\n * a caller never double-encodes and a workspace with a slash in its name cannot\n * forge a path segment.\n */\nexport type ApiScopeAddress =\n  | { readonly scope: 'global' }\n  | { readonly scope: 'workspace'; readonly workspaceId: string }\n  | { readonly scope: 'session'; readonly workspaceId: string; readonly sessionId: string };\n\n/** Path parameter values, substituted into a route's `:name` segments. */\nexport type ApiParams = Readonly<Record<string, string>>;\n\n/** Query values a route may carry. `undefined` drops the parameter rather than sending 'undefined'. */\nexport type ApiQuery = Readonly<Record<string, string | number | boolean | undefined>>;\n\n/** The base path the host reserves for its own settings API, mounted outside /plugins/. */\nexport const SETTINGS_BASE_PATH = 'settings';\n\n/** The scope's own resource root: what a host-owned route hangs off. */\nexport function scopeApiRoot(address: ApiScopeAddress): string {\n  if (address.scope === 'global') return '/api';\n  const workspace = `/api/workspaces/${encodeURIComponent(address.workspaceId)}`;\n  if (address.scope === 'workspace') return workspace;\n  return `${workspace}/sessions/${encodeURIComponent(address.sessionId)}`;\n}\n\n/**\n * The mount one package API answers on.\n *\n * `basePath` is omitted for a host-owned route, which the contract schema\n * already spells that way, so the session file-bytes route and a plugin route\n * are the same construction with one field different rather than two code\n * paths. `settings` is the host's own API and sits beside `/plugins`, not\n * under it.\n */\nexport function pluginApiBase(address: ApiScopeAddress, basePath: string | undefined): string {\n  const root = scopeApiRoot(address);\n  if (basePath === undefined) return root;\n  if (basePath === SETTINGS_BASE_PATH) return `${root}/${SETTINGS_BASE_PATH}`;\n  return `${root}/plugins/${basePath}`;\n}\n\n/**\n * The query string, `encodeURIComponent` per pair rather than `URLSearchParams`.\n *\n * `URLSearchParams` writes a space as `+`, which only decodes back to a space\n * under form-urlencoded rules; `%20` decodes to a space everywhere. The\n * cockpit already relied on that difference in both directions, so picking the\n * unambiguous one is what lets a single encoder serve every route.\n */\nexport function apiQueryString(query: ApiQuery | undefined): string {\n  if (query === undefined) return '';\n  const pairs: string[] = [];\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined) continue;\n    pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  }\n  return pairs.length === 0 ? '' : `?${pairs.join('&')}`;\n}\n\n/**\n * The absolute, root-relative URL for one route.\n *\n * Root-relative on purpose: the sealed transport refuses anything else, because\n * a remote session relays its requests through a gateway that will not forward\n * an arbitrary origin.\n *\n * A route whose path is exactly '/' addresses the mount itself, so the slash is\n * dropped rather than doubled.\n */\nexport function pluginApiUrl(\n  address: ApiScopeAddress,\n  basePath: string | undefined,\n  path: string,\n  query?: ApiQuery,\n  params?: ApiParams,\n): string {\n  const resolved = applyPathParams(path, params);\n  return `${pluginApiBase(address, basePath)}${resolved === '/' ? '' : resolved}${apiQueryString(query)}`;\n}\n\n/**\n * Substitutes a route's `:name` segments, as Hono spells them.\n *\n * Encoded per segment, so a value containing a slash names one segment rather\n * than inventing another. A declared parameter with no value is left as the\n * literal `:name`, which fails visibly at the route instead of silently\n * addressing the collection above it.\n */\nexport function applyPathParams(path: string, params: ApiParams | undefined): string {\n  if (params === undefined || !path.includes(':')) return path;\n  return path\n    .split('/')\n    .map((segment) => {\n      if (!segment.startsWith(':')) return segment;\n      // Hono writes a multi-segment parameter as `:name{.+}`. Its value is a\n      // relative path, so the slashes inside it are structure the route means\n      // to keep; encoding them would address one oddly-named file instead of a\n      // nested one. Each piece is still escaped on its own.\n      const catchAll = segment.endsWith('}');\n      const name = catchAll ? segment.slice(1, segment.indexOf('{')) : segment.slice(1);\n      const value = params[name];\n      if (value === undefined) return segment;\n      return catchAll ? value.split('/').map(encodeURIComponent).join('/') : encodeURIComponent(value);\n    })\n    .join('/');\n}\n"],"mappings":";;AAkCA,MAAa,qBAAqB;;AAGlC,SAAgB,aAAa,SAAkC;CAC7D,IAAI,QAAQ,UAAU,UAAU,OAAO;CACvC,MAAM,YAAY,mBAAmB,mBAAmB,QAAQ,WAAW;CAC3E,IAAI,QAAQ,UAAU,aAAa,OAAO;CAC1C,OAAO,GAAG,UAAU,YAAY,mBAAmB,QAAQ,SAAS;AACtE;;;;;;;;;;AAWA,SAAgB,cAAc,SAA0B,UAAsC;CAC5F,MAAM,OAAO,aAAa,OAAO;CACjC,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,IAAI,aAAA,YAAiC,OAAO,GAAG,KAAK,GAAG;CACvD,OAAO,GAAG,KAAK,WAAW;AAC5B;;;;;;;;;AAUA,SAAgB,eAAe,OAAqC;CAClE,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;EAChD,IAAI,UAAU,KAAA,GAAW;EACzB,MAAM,KAAK,GAAG,mBAAmB,GAAG,EAAE,GAAG,mBAAmB,OAAO,KAAK,CAAC,GAAG;CAC9E;CACA,OAAO,MAAM,WAAW,IAAI,KAAK,IAAI,MAAM,KAAK,GAAG;AACrD;;;;;;;;;;;AAYA,SAAgB,aACd,SACA,UACA,MACA,OACA,QACQ;CACR,MAAM,WAAW,gBAAgB,MAAM,MAAM;CAC7C,OAAO,GAAG,cAAc,SAAS,QAAQ,IAAI,aAAa,MAAM,KAAK,WAAW,eAAe,KAAK;AACtG;;;;;;;;;AAUA,SAAgB,gBAAgB,MAAc,QAAuC;CACnF,IAAI,WAAW,KAAA,KAAa,CAAC,KAAK,SAAS,GAAG,GAAG,OAAO;CACxD,OAAO,KACJ,MAAM,GAAG,CAAC,CACV,KAAK,YAAY;EAChB,IAAI,CAAC,QAAQ,WAAW,GAAG,GAAG,OAAO;EAKrC,MAAM,WAAW,QAAQ,SAAS,GAAG;EAErC,MAAM,QAAQ,OADD,WAAW,QAAQ,MAAM,GAAG,QAAQ,QAAQ,GAAG,CAAC,IAAI,QAAQ,MAAM,CAAC;EAEhF,IAAI,UAAU,KAAA,GAAW,OAAO;EAChC,OAAO,WAAW,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,KAAK,GAAG,IAAI,mBAAmB,KAAK;CACjG,CAAC,CAAC,CACD,KAAK,GAAG;AACb"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/web/services/apiPaths/index.ts"],"sourcesContent":["/**\n * The byte shape of every URL the browser addresses a package API with.\n *\n * One implementation, because the alternative is what the cockpit had: twelve\n * packages each concatenating `${sessionApiPath(id)}/plugins/${base}${path}` by\n * hand, three of them spelling the prefix a fourth way, and one rewriting it\n * with `String.replace`. A route that moves by one character is answered by the\n * service worker out of the signed bundle cache instead of the network, so the\n * failure is a 404 nowhere near its cause.\n *\n * The host builds the same strings from `poApiMountPath` and, for OpenAPI\n * templating, from `createApiDocuments`. Those live in the node half of this\n * package and cannot be imported here: `src/web` is a separate tree that reads\n * neither `src/schemas` nor `src/services`. The three are held together by the\n * agreement test instead of by a call, which is the guarantee that matters.\n */\n\n/**\n * Who a request is addressed to. Ids are supplied decoded and encoded here, so\n * a caller never double-encodes and a workspace with a slash in its name cannot\n * forge a path segment.\n */\nexport type ApiScopeAddress =\n  | { readonly scope: 'global' }\n  | { readonly scope: 'workspace'; readonly workspaceId: string }\n  | { readonly scope: 'session'; readonly workspaceId: string; readonly sessionId: string };\n\n/** Path parameter values, substituted into a route's `:name` segments. */\nexport type ApiParams = Readonly<Record<string, string>>;\n\n/** Query values a route may carry. `undefined` drops the parameter rather than sending 'undefined'. */\nexport type ApiQuery = Readonly<Record<string, string | number | boolean | undefined>>;\n\n/** The base path the host reserves for its own settings API, mounted outside /plugins/. */\nexport const SETTINGS_BASE_PATH = 'settings';\n\n/** The scope's own resource root: what a host-owned route hangs off. */\nexport function scopeApiRoot(address: ApiScopeAddress): string {\n  if (address.scope === 'global') return '/api';\n  const workspace = `/api/workspaces/${encodeURIComponent(address.workspaceId)}`;\n  if (address.scope === 'workspace') return workspace;\n  return `${workspace}/sessions/${encodeURIComponent(address.sessionId)}`;\n}\n\n/**\n * The mount one package API answers on.\n *\n * `basePath` is omitted for a host-owned route, which the contract schema\n * already spells that way, so the session file-bytes route and a plugin route\n * are the same construction with one field different rather than two code\n * paths. `settings` is the host's own API and sits beside `/plugins`, not\n * under it.\n */\nexport function pluginApiBase(address: ApiScopeAddress, basePath: string | undefined): string {\n  const root = scopeApiRoot(address);\n  if (basePath === undefined) return root;\n  if (basePath === SETTINGS_BASE_PATH) return `${root}/${SETTINGS_BASE_PATH}`;\n  return `${root}/plugins/${basePath}`;\n}\n\n/**\n * The query string, `encodeURIComponent` per pair rather than `URLSearchParams`.\n *\n * `URLSearchParams` writes a space as `+`, which only decodes back to a space\n * under form-urlencoded rules; `%20` decodes to a space everywhere. The\n * cockpit already relied on that difference in both directions, so picking the\n * unambiguous one is what lets a single encoder serve every route.\n */\nexport function apiQueryString(query: ApiQuery | undefined): string {\n  if (query === undefined) return '';\n  const pairs: string[] = [];\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined) continue;\n    pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  }\n  return pairs.length === 0 ? '' : `?${pairs.join('&')}`;\n}\n\n/**\n * The absolute, root-relative URL for one route.\n *\n * Root-relative on purpose: the sealed transport refuses anything else, because\n * a remote session relays its requests through a gateway that will not forward\n * an arbitrary origin.\n *\n * A route whose path is exactly '/' addresses the mount itself, so the slash is\n * dropped rather than doubled.\n */\nexport function pluginApiUrl(\n  address: ApiScopeAddress,\n  basePath: string | undefined,\n  path: string,\n  query?: ApiQuery,\n  params?: ApiParams,\n): string {\n  const resolved = applyPathParams(path, params);\n  return `${pluginApiBase(address, basePath)}${resolved === '/' ? '' : resolved}${apiQueryString(query)}`;\n}\n\n/**\n * Substitutes a route's `:name` segments, as Hono spells them.\n *\n * Encoded per segment, so a value containing a slash names one segment rather\n * than inventing another. A declared parameter with no value is left as the\n * literal `:name`, which fails visibly at the route instead of silently\n * addressing the collection above it.\n */\nexport function applyPathParams(path: string, params: ApiParams | undefined): string {\n  if (params === undefined || !path.includes(':')) return path;\n  return path\n    .split('/')\n    .map((segment) => {\n      if (!segment.startsWith(':')) return segment;\n      // Hono writes a multi-segment parameter as `:name{.+}`. Its value is a\n      // relative path, so the slashes inside it are structure the route means\n      // to keep; encoding them would address one oddly-named file instead of a\n      // nested one. Each piece is still escaped on its own.\n      const catchAll = segment.endsWith('}');\n      const name = catchAll ? segment.slice(1, segment.indexOf('{')) : segment.slice(1);\n      const value = params[name];\n      if (value === undefined) return segment;\n      return catchAll ? value.split('/').map(encodeURIComponent).join('/') : encodeURIComponent(value);\n    })\n    .join('/');\n}\n"],"mappings":";;AAkCA,MAAa,qBAAqB;;AAGlC,SAAgB,aAAa,SAAkC;CAC7D,IAAI,QAAQ,UAAU,UAAU,OAAO;CACvC,MAAM,YAAY,mBAAmB,mBAAmB,QAAQ,WAAW;CAC3E,IAAI,QAAQ,UAAU,aAAa,OAAO;CAC1C,OAAO,GAAG,UAAU,YAAY,mBAAmB,QAAQ,SAAS;AACtE;;;;;;;;;;AAWA,SAAgB,cAAc,SAA0B,UAAsC;CAC5F,MAAM,OAAO,aAAa,OAAO;CACjC,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,IAAI,aAAA,YAAiC,OAAO,GAAG,KAAK,GAAG;CACvD,OAAO,GAAG,KAAK,WAAW;AAC5B;;;;;;;;;AAUA,SAAgB,eAAe,OAAqC;CAClE,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;EAChD,IAAI,UAAU,KAAA,GAAW;EACzB,MAAM,KAAK,GAAG,mBAAmB,GAAG,EAAE,GAAG,mBAAmB,OAAO,KAAK,CAAC,GAAG;CAC9E;CACA,OAAO,MAAM,WAAW,IAAI,KAAK,IAAI,MAAM,KAAK,GAAG;AACrD;;;;;;;;;;;AAYA,SAAgB,aACd,SACA,UACA,MACA,OACA,QACQ;CACR,MAAM,WAAW,gBAAgB,MAAM,MAAM;CAC7C,OAAO,GAAG,cAAc,SAAS,QAAQ,IAAI,aAAa,MAAM,KAAK,WAAW,eAAe,KAAK;AACtG;;;;;;;;;AAUA,SAAgB,gBAAgB,MAAc,QAAuC;CACnF,IAAI,WAAW,KAAA,KAAa,CAAC,KAAK,SAAS,GAAG,GAAG,OAAO;CACxD,OAAO,KACJ,MAAM,GAAG,CAAC,CACV,KAAK,YAAY;EAChB,IAAI,CAAC,QAAQ,WAAW,GAAG,GAAG,OAAO;EAKrC,MAAM,WAAW,QAAQ,SAAS,GAAG;EAErC,MAAM,QAAQ,OADD,WAAW,QAAQ,MAAM,GAAG,QAAQ,QAAQ,GAAG,CAAC,IAAI,QAAQ,MAAM,CAAC;EAEhF,IAAI,UAAU,KAAA,GAAW,OAAO;EAChC,OAAO,WAAW,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,KAAK,GAAG,IAAI,mBAAmB,KAAK;CACjG,CAAC,CAAC,CACD,KAAK,GAAG;AACb"}

package/dist/src/web/services/mcpWidget.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcpWidget.cjs","names":[],"sources":["../../../../src/web/services/mcpWidget.ts"],"sourcesContent":["import type { DoomMcpWidgetProps } from '../types/mcpWidget';\n\n/** Types one package-owned MCP widget without coupling the route to the composed host. */\nexport function defineMcpWidget<T extends (props: DoomMcpWidgetProps) => unknown>(widget: T): T {\n  return widget;\n}\n"],"mappings":";;AAGA,SAAgB,gBAAkE,QAAc;CAC9F,OAAO;AACT"}
+{"version":3,"file":"mcpWidget.cjs","names":[],"sources":["../../../../src/web/services/mcpWidget.ts"],"sourcesContent":["import type { PoMcpWidgetProps } from '../types/mcpWidget';\n\n/** Types one package-owned MCP widget without coupling the route to the composed host. */\nexport function defineMcpWidget<T extends (props: PoMcpWidgetProps) => unknown>(widget: T): T {\n  return widget;\n}\n"],"mappings":";;AAGA,SAAgB,gBAAgE,QAAc;CAC5F,OAAO;AACT"}

package/dist/src/web/services/mcpWidget.d.mts

@@ -1,6 +1,6 @@
-import { DoomMcpWidgetProps } from "../types/mcpWidget.mjs";
+import { PoMcpWidgetProps } from "../types/mcpWidget.mjs";
 //#region src/web/services/mcpWidget.d.ts
 /** Types one package-owned MCP widget without coupling the route to the composed host. */
-export declare function defineMcpWidget<T extends (props: DoomMcpWidgetProps) => unknown>(widget: T): T;
+export declare function defineMcpWidget<T extends (props: PoMcpWidgetProps) => unknown>(widget: T): T;
 //#endregion
 //# sourceMappingURL=mcpWidget.d.mts.map

package/dist/src/web/services/mcpWidget.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mcpWidget.d.mts","names":[],"sources":["../../../../src/web/services/mcpWidget.ts"],"mappings":";;;wBAGgB,gBAAgB,WAAW,OAAO,gCAAgC,QAAQ,IAAI"}
+{"version":3,"file":"mcpWidget.d.mts","names":[],"sources":["../../../../src/web/services/mcpWidget.ts"],"mappings":";;;wBAGgB,gBAAgB,WAAW,OAAO,8BAA8B,QAAQ,IAAI"}

package/dist/src/web/services/mcpWidget.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcpWidget.mjs","names":[],"sources":["../../../../src/web/services/mcpWidget.ts"],"sourcesContent":["import type { DoomMcpWidgetProps } from '../types/mcpWidget';\n\n/** Types one package-owned MCP widget without coupling the route to the composed host. */\nexport function defineMcpWidget<T extends (props: DoomMcpWidgetProps) => unknown>(widget: T): T {\n  return widget;\n}\n"],"mappings":";;AAGA,SAAgB,gBAAkE,QAAc;CAC9F,OAAO;AACT"}
+{"version":3,"file":"mcpWidget.mjs","names":[],"sources":["../../../../src/web/services/mcpWidget.ts"],"sourcesContent":["import type { PoMcpWidgetProps } from '../types/mcpWidget';\n\n/** Types one package-owned MCP widget without coupling the route to the composed host. */\nexport function defineMcpWidget<T extends (props: PoMcpWidgetProps) => unknown>(widget: T): T {\n  return widget;\n}\n"],"mappings":";;AAGA,SAAgB,gBAAgE,QAAc;CAC5F,OAAO;AACT"}

package/dist/src/web/services/testing/templateRail.cjs

@@ -109,6 +109,9 @@ function templateRailStub(options = {}) {
 	const recorded = {
 		openSession: record("openSession"),
 		renameSession: record("renameSession"),
+		setSessionGroups: record("setSessionGroups", Promise.resolve(void 0)),
+		renameGroup: record("renameGroup", Promise.resolve(void 0)),
+		deleteGroup: record("deleteGroup", Promise.resolve(void 0)),
 		restartSession: record("restartSession"),
 		removeSession: record("removeSession", Promise.resolve(void 0)),
 		resumeSession: record("resumeSession"),

package/dist/src/web/services/testing/templateRail.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"templateRail.cjs","names":[],"sources":["../../../../../src/web/services/testing/templateRail.ts"],"sourcesContent":["import type {\n  WebTemplateRail,\n  WebTemplateRailActions,\n  WebTemplateRailSession,\n  WebTemplateRailWorkspace,\n} from '../../types/template';\n\n/**\n * The rail a template receives, built for a test or story.\n *\n * Two workspaces with sessions that exercise the card's branches (a branch\n * with a dirty star, a profile avatar, a nested child, workflow sessions in\n * each state, a pending setup), plus\n * actions that record what the template asked for. Override any part.\n */\n\nexport interface RecordedRailAction {\n  action: keyof WebTemplateRailActions;\n  args: readonly unknown[];\n}\n\nexport interface TemplateRailFixture {\n  rail: WebTemplateRail;\n  /** Every action the template called, in order. */\n  readonly actions: readonly RecordedRailAction[];\n}\n\nexport interface TemplateRailOptions {\n  workspaces?: readonly WebTemplateRailWorkspace[];\n  addWorkspace?: WebTemplateRail['addWorkspace'];\n  remote?: WebTemplateRail['remote'];\n  actions?: Partial<WebTemplateRailActions>;\n}\n\n/** A tiny transparent PNG, so avatar markup renders an image without a network request. */\nconst AVATAR_URL =\n  'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';\n\nexport function railSession(overrides: Partial<WebTemplateRailSession> & { id: string }): WebTemplateRailSession {\n  return {\n    name: overrides.id,\n    ordinal: 1,\n    active: false,\n    nested: false,\n    status: 'idle · done 2m ago',\n    awaitingInput: false,\n    restarting: false,\n    pendingSetups: [],\n    ...overrides,\n  };\n}\n\nexport function defaultRailWorkspaces(): WebTemplateRailWorkspace[] {\n  return [\n    {\n      id: 'po',\n      name: 'po',\n      root: '/Users/dev/workspace/po',\n      available: true,\n      legacy: false,\n      sessions: [\n        railSession({\n          id: 'rail',\n          name: 'rail redesign',\n          ordinal: 1,\n          active: true,\n          status: 'running · 3m',\n          git: { branch: 'main', dirty: true },\n          profile: { name: 'ponytail', label: 'Ponytail', initials: 'PO', avatarUrl: AVATAR_URL },\n        }),\n        railSession({\n          id: 'rail-worktree',\n          name: 'worktree child',\n          ordinal: 2,\n          nested: true,\n          provenance: 'worktree',\n          git: { branch: 'feature/rail', dirty: false },\n          profile: { name: 'reviewer', label: 'Reviewer', initials: 'RE' },\n          pendingSetups: [\n            {\n              id: 'setup',\n              name: 'docs worktree',\n              status: 'automatic worktree setup failed',\n              failed: true,\n              recovery: 'Resolve the Git setup, then retry the authenticated conversation.',\n            },\n          ],\n        }),\n        railSession({\n          id: 'rail-workflow',\n          name: 'release-hardening',\n          ordinal: 3,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'workflow · build › edit token.ts · 4m',\n        }),\n        railSession({\n          id: 'rail-workflow-failed',\n          name: 'nightly',\n          ordinal: 4,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'workflow failed · test',\n          awaitingInput: true,\n        }),\n        railSession({\n          id: 'rail-workflow-done',\n          name: 'hotfix',\n          ordinal: 5,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'stopped · open to wake',\n        }),\n      ],\n    },\n    {\n      id: 'notes',\n      name: 'Notes',\n      root: '/Users/dev/.po/workspace/Notes',\n      available: true,\n      legacy: false,\n      sessions: [],\n    },\n  ];\n}\n\nexport function templateRailStub(options: TemplateRailOptions = {}): TemplateRailFixture {\n  const actions: RecordedRailAction[] = [];\n  const record =\n    <Name extends keyof WebTemplateRailActions>(action: Name, result?: unknown) =>\n    (...args: unknown[]) => {\n      actions.push({ action, args });\n      return result;\n    };\n  const recorded: WebTemplateRailActions = {\n    openSession: record('openSession'),\n    renameSession: record('renameSession'),\n    restartSession: record('restartSession'),\n    removeSession: record('removeSession', Promise.resolve(undefined)) as WebTemplateRailActions['removeSession'],\n    resumeSession: record('resumeSession'),\n    createSession: record('createSession'),\n    resumeInWorkspace: record('resumeInWorkspace'),\n    openWorkspaceSettings: record('openWorkspaceSettings'),\n    deleteWorkspace: record('deleteWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['deleteWorkspace'],\n    openAddWorkspace: record('openAddWorkspace'),\n    closeAddWorkspace: record('closeAddWorkspace'),\n    addWorkspace: record('addWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['addWorkspace'],\n    searchDirectories: record(\n      'searchDirectories',\n      Promise.resolve(['/Users/dev/workspace/po', '/Users/dev/workspace/docs']),\n    ) as WebTemplateRailActions['searchDirectories'],\n    listDirectory: record(\n      'listDirectory',\n      Promise.resolve({\n        path: '/Users/dev',\n        parent: '/Users',\n        directories: ['/Users/dev/workspace', '/Users/dev/notes'],\n      }),\n    ) as WebTemplateRailActions['listDirectory'],\n    removePendingSetup: record(\n      'removePendingSetup',\n      Promise.resolve(undefined),\n    ) as WebTemplateRailActions['removePendingSetup'],\n    openSettings: record('openSettings'),\n    openRemoteAccess: record('openRemoteAccess'),\n    turnRemoteAccessOff: record('turnRemoteAccessOff'),\n    renderSessionMenuItems: () => null,\n  };\n  return {\n    rail: {\n      workspaces: options.workspaces ?? defaultRailWorkspaces(),\n      remote: options.remote ?? { status: 'off', deviceCount: 0 },\n      pluginContent: null,\n      ...(options.addWorkspace === undefined ? {} : { addWorkspace: options.addWorkspace }),\n      actions: { ...recorded, ...options.actions },\n    },\n    actions,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"templateRail.cjs","names":[],"sources":["../../../../../src/web/services/testing/templateRail.ts"],"sourcesContent":["import type {\n  WebTemplateRail,\n  WebTemplateRailActions,\n  WebTemplateRailSession,\n  WebTemplateRailWorkspace,\n} from '../../types/template';\n\n/**\n * The rail a template receives, built for a test or story.\n *\n * Two workspaces with sessions that exercise the card's branches (a branch\n * with a dirty star, a profile avatar, a nested child, workflow sessions in\n * each state, a pending setup), plus\n * actions that record what the template asked for. Override any part.\n */\n\nexport interface RecordedRailAction {\n  action: keyof WebTemplateRailActions;\n  args: readonly unknown[];\n}\n\nexport interface TemplateRailFixture {\n  rail: WebTemplateRail;\n  /** Every action the template called, in order. */\n  readonly actions: readonly RecordedRailAction[];\n}\n\nexport interface TemplateRailOptions {\n  workspaces?: readonly WebTemplateRailWorkspace[];\n  addWorkspace?: WebTemplateRail['addWorkspace'];\n  remote?: WebTemplateRail['remote'];\n  actions?: Partial<WebTemplateRailActions>;\n}\n\n/** A tiny transparent PNG, so avatar markup renders an image without a network request. */\nconst AVATAR_URL =\n  'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';\n\nexport function railSession(overrides: Partial<WebTemplateRailSession> & { id: string }): WebTemplateRailSession {\n  return {\n    name: overrides.id,\n    ordinal: 1,\n    active: false,\n    nested: false,\n    status: 'idle · done 2m ago',\n    awaitingInput: false,\n    restarting: false,\n    pendingSetups: [],\n    ...overrides,\n  };\n}\n\nexport function defaultRailWorkspaces(): WebTemplateRailWorkspace[] {\n  return [\n    {\n      id: 'po',\n      name: 'po',\n      root: '/Users/dev/workspace/po',\n      available: true,\n      legacy: false,\n      sessions: [\n        railSession({\n          id: 'rail',\n          name: 'rail redesign',\n          ordinal: 1,\n          active: true,\n          status: 'running · 3m',\n          git: { branch: 'main', dirty: true },\n          profile: { name: 'ponytail', label: 'Ponytail', initials: 'PO', avatarUrl: AVATAR_URL },\n        }),\n        railSession({\n          id: 'rail-worktree',\n          name: 'worktree child',\n          ordinal: 2,\n          nested: true,\n          provenance: 'worktree',\n          git: { branch: 'feature/rail', dirty: false },\n          profile: { name: 'reviewer', label: 'Reviewer', initials: 'RE' },\n          pendingSetups: [\n            {\n              id: 'setup',\n              name: 'docs worktree',\n              status: 'automatic worktree setup failed',\n              failed: true,\n              recovery: 'Resolve the Git setup, then retry the authenticated conversation.',\n            },\n          ],\n        }),\n        railSession({\n          id: 'rail-workflow',\n          name: 'release-hardening',\n          ordinal: 3,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'workflow · build › edit token.ts · 4m',\n        }),\n        railSession({\n          id: 'rail-workflow-failed',\n          name: 'nightly',\n          ordinal: 4,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'workflow failed · test',\n          awaitingInput: true,\n        }),\n        railSession({\n          id: 'rail-workflow-done',\n          name: 'hotfix',\n          ordinal: 5,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'stopped · open to wake',\n        }),\n      ],\n    },\n    {\n      id: 'notes',\n      name: 'Notes',\n      root: '/Users/dev/.po/workspace/Notes',\n      available: true,\n      legacy: false,\n      sessions: [],\n    },\n  ];\n}\n\nexport function templateRailStub(options: TemplateRailOptions = {}): TemplateRailFixture {\n  const actions: RecordedRailAction[] = [];\n  const record =\n    <Name extends keyof WebTemplateRailActions>(action: Name, result?: unknown) =>\n    (...args: unknown[]) => {\n      actions.push({ action, args });\n      return result;\n    };\n  const recorded: WebTemplateRailActions = {\n    openSession: record('openSession'),\n    renameSession: record('renameSession'),\n    setSessionGroups: record(\n      'setSessionGroups',\n      Promise.resolve(undefined),\n    ) as WebTemplateRailActions['setSessionGroups'],\n    renameGroup: record('renameGroup', Promise.resolve(undefined)) as WebTemplateRailActions['renameGroup'],\n    deleteGroup: record('deleteGroup', Promise.resolve(undefined)) as WebTemplateRailActions['deleteGroup'],\n    restartSession: record('restartSession'),\n    removeSession: record('removeSession', Promise.resolve(undefined)) as WebTemplateRailActions['removeSession'],\n    resumeSession: record('resumeSession'),\n    createSession: record('createSession'),\n    resumeInWorkspace: record('resumeInWorkspace'),\n    openWorkspaceSettings: record('openWorkspaceSettings'),\n    deleteWorkspace: record('deleteWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['deleteWorkspace'],\n    openAddWorkspace: record('openAddWorkspace'),\n    closeAddWorkspace: record('closeAddWorkspace'),\n    addWorkspace: record('addWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['addWorkspace'],\n    searchDirectories: record(\n      'searchDirectories',\n      Promise.resolve(['/Users/dev/workspace/po', '/Users/dev/workspace/docs']),\n    ) as WebTemplateRailActions['searchDirectories'],\n    listDirectory: record(\n      'listDirectory',\n      Promise.resolve({\n        path: '/Users/dev',\n        parent: '/Users',\n        directories: ['/Users/dev/workspace', '/Users/dev/notes'],\n      }),\n    ) as WebTemplateRailActions['listDirectory'],\n    removePendingSetup: record(\n      'removePendingSetup',\n      Promise.resolve(undefined),\n    ) as WebTemplateRailActions['removePendingSetup'],\n    openSettings: record('openSettings'),\n    openRemoteAccess: record('openRemoteAccess'),\n    turnRemoteAccessOff: record('turnRemoteAccessOff'),\n    renderSessionMenuItems: () => null,\n  };\n  return {\n    rail: {\n      workspaces: options.workspaces ?? defaultRailWorkspaces(),\n      remote: options.remote ?? { status: 'off', deviceCount: 0 },\n      pluginContent: null,\n      ...(options.addWorkspace === undefined ? {} : { addWorkspace: options.addWorkspace }),\n      actions: { ...recorded, ...options.actions },\n    },\n    actions,\n  };\n}\n"],"mappings":"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"}

package/dist/src/web/services/testing/templateRail.mjs

@@ -109,6 +109,9 @@ function templateRailStub(options = {}) {
 	const recorded = {
 		openSession: record("openSession"),
 		renameSession: record("renameSession"),
+		setSessionGroups: record("setSessionGroups", Promise.resolve(void 0)),
+		renameGroup: record("renameGroup", Promise.resolve(void 0)),
+		deleteGroup: record("deleteGroup", Promise.resolve(void 0)),
 		restartSession: record("restartSession"),
 		removeSession: record("removeSession", Promise.resolve(void 0)),
 		resumeSession: record("resumeSession"),

package/dist/src/web/services/testing/templateRail.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"templateRail.mjs","names":[],"sources":["../../../../../src/web/services/testing/templateRail.ts"],"sourcesContent":["import type {\n  WebTemplateRail,\n  WebTemplateRailActions,\n  WebTemplateRailSession,\n  WebTemplateRailWorkspace,\n} from '../../types/template';\n\n/**\n * The rail a template receives, built for a test or story.\n *\n * Two workspaces with sessions that exercise the card's branches (a branch\n * with a dirty star, a profile avatar, a nested child, workflow sessions in\n * each state, a pending setup), plus\n * actions that record what the template asked for. Override any part.\n */\n\nexport interface RecordedRailAction {\n  action: keyof WebTemplateRailActions;\n  args: readonly unknown[];\n}\n\nexport interface TemplateRailFixture {\n  rail: WebTemplateRail;\n  /** Every action the template called, in order. */\n  readonly actions: readonly RecordedRailAction[];\n}\n\nexport interface TemplateRailOptions {\n  workspaces?: readonly WebTemplateRailWorkspace[];\n  addWorkspace?: WebTemplateRail['addWorkspace'];\n  remote?: WebTemplateRail['remote'];\n  actions?: Partial<WebTemplateRailActions>;\n}\n\n/** A tiny transparent PNG, so avatar markup renders an image without a network request. */\nconst AVATAR_URL =\n  'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';\n\nexport function railSession(overrides: Partial<WebTemplateRailSession> & { id: string }): WebTemplateRailSession {\n  return {\n    name: overrides.id,\n    ordinal: 1,\n    active: false,\n    nested: false,\n    status: 'idle · done 2m ago',\n    awaitingInput: false,\n    restarting: false,\n    pendingSetups: [],\n    ...overrides,\n  };\n}\n\nexport function defaultRailWorkspaces(): WebTemplateRailWorkspace[] {\n  return [\n    {\n      id: 'po',\n      name: 'po',\n      root: '/Users/dev/workspace/po',\n      available: true,\n      legacy: false,\n      sessions: [\n        railSession({\n          id: 'rail',\n          name: 'rail redesign',\n          ordinal: 1,\n          active: true,\n          status: 'running · 3m',\n          git: { branch: 'main', dirty: true },\n          profile: { name: 'ponytail', label: 'Ponytail', initials: 'PO', avatarUrl: AVATAR_URL },\n        }),\n        railSession({\n          id: 'rail-worktree',\n          name: 'worktree child',\n          ordinal: 2,\n          nested: true,\n          provenance: 'worktree',\n          git: { branch: 'feature/rail', dirty: false },\n          profile: { name: 'reviewer', label: 'Reviewer', initials: 'RE' },\n          pendingSetups: [\n            {\n              id: 'setup',\n              name: 'docs worktree',\n              status: 'automatic worktree setup failed',\n              failed: true,\n              recovery: 'Resolve the Git setup, then retry the authenticated conversation.',\n            },\n          ],\n        }),\n        railSession({\n          id: 'rail-workflow',\n          name: 'release-hardening',\n          ordinal: 3,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'workflow · build › edit token.ts · 4m',\n        }),\n        railSession({\n          id: 'rail-workflow-failed',\n          name: 'nightly',\n          ordinal: 4,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'workflow failed · test',\n          awaitingInput: true,\n        }),\n        railSession({\n          id: 'rail-workflow-done',\n          name: 'hotfix',\n          ordinal: 5,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'stopped · open to wake',\n        }),\n      ],\n    },\n    {\n      id: 'notes',\n      name: 'Notes',\n      root: '/Users/dev/.po/workspace/Notes',\n      available: true,\n      legacy: false,\n      sessions: [],\n    },\n  ];\n}\n\nexport function templateRailStub(options: TemplateRailOptions = {}): TemplateRailFixture {\n  const actions: RecordedRailAction[] = [];\n  const record =\n    <Name extends keyof WebTemplateRailActions>(action: Name, result?: unknown) =>\n    (...args: unknown[]) => {\n      actions.push({ action, args });\n      return result;\n    };\n  const recorded: WebTemplateRailActions = {\n    openSession: record('openSession'),\n    renameSession: record('renameSession'),\n    restartSession: record('restartSession'),\n    removeSession: record('removeSession', Promise.resolve(undefined)) as WebTemplateRailActions['removeSession'],\n    resumeSession: record('resumeSession'),\n    createSession: record('createSession'),\n    resumeInWorkspace: record('resumeInWorkspace'),\n    openWorkspaceSettings: record('openWorkspaceSettings'),\n    deleteWorkspace: record('deleteWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['deleteWorkspace'],\n    openAddWorkspace: record('openAddWorkspace'),\n    closeAddWorkspace: record('closeAddWorkspace'),\n    addWorkspace: record('addWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['addWorkspace'],\n    searchDirectories: record(\n      'searchDirectories',\n      Promise.resolve(['/Users/dev/workspace/po', '/Users/dev/workspace/docs']),\n    ) as WebTemplateRailActions['searchDirectories'],\n    listDirectory: record(\n      'listDirectory',\n      Promise.resolve({\n        path: '/Users/dev',\n        parent: '/Users',\n        directories: ['/Users/dev/workspace', '/Users/dev/notes'],\n      }),\n    ) as WebTemplateRailActions['listDirectory'],\n    removePendingSetup: record(\n      'removePendingSetup',\n      Promise.resolve(undefined),\n    ) as WebTemplateRailActions['removePendingSetup'],\n    openSettings: record('openSettings'),\n    openRemoteAccess: record('openRemoteAccess'),\n    turnRemoteAccessOff: record('turnRemoteAccessOff'),\n    renderSessionMenuItems: () => null,\n  };\n  return {\n    rail: {\n      workspaces: options.workspaces ?? defaultRailWorkspaces(),\n      remote: options.remote ?? { status: 'off', deviceCount: 0 },\n      pluginContent: null,\n      ...(options.addWorkspace === undefined ? {} : { addWorkspace: options.addWorkspace }),\n      actions: { ...recorded, ...options.actions },\n    },\n    actions,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"templateRail.mjs","names":[],"sources":["../../../../../src/web/services/testing/templateRail.ts"],"sourcesContent":["import type {\n  WebTemplateRail,\n  WebTemplateRailActions,\n  WebTemplateRailSession,\n  WebTemplateRailWorkspace,\n} from '../../types/template';\n\n/**\n * The rail a template receives, built for a test or story.\n *\n * Two workspaces with sessions that exercise the card's branches (a branch\n * with a dirty star, a profile avatar, a nested child, workflow sessions in\n * each state, a pending setup), plus\n * actions that record what the template asked for. Override any part.\n */\n\nexport interface RecordedRailAction {\n  action: keyof WebTemplateRailActions;\n  args: readonly unknown[];\n}\n\nexport interface TemplateRailFixture {\n  rail: WebTemplateRail;\n  /** Every action the template called, in order. */\n  readonly actions: readonly RecordedRailAction[];\n}\n\nexport interface TemplateRailOptions {\n  workspaces?: readonly WebTemplateRailWorkspace[];\n  addWorkspace?: WebTemplateRail['addWorkspace'];\n  remote?: WebTemplateRail['remote'];\n  actions?: Partial<WebTemplateRailActions>;\n}\n\n/** A tiny transparent PNG, so avatar markup renders an image without a network request. */\nconst AVATAR_URL =\n  'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';\n\nexport function railSession(overrides: Partial<WebTemplateRailSession> & { id: string }): WebTemplateRailSession {\n  return {\n    name: overrides.id,\n    ordinal: 1,\n    active: false,\n    nested: false,\n    status: 'idle · done 2m ago',\n    awaitingInput: false,\n    restarting: false,\n    pendingSetups: [],\n    ...overrides,\n  };\n}\n\nexport function defaultRailWorkspaces(): WebTemplateRailWorkspace[] {\n  return [\n    {\n      id: 'po',\n      name: 'po',\n      root: '/Users/dev/workspace/po',\n      available: true,\n      legacy: false,\n      sessions: [\n        railSession({\n          id: 'rail',\n          name: 'rail redesign',\n          ordinal: 1,\n          active: true,\n          status: 'running · 3m',\n          git: { branch: 'main', dirty: true },\n          profile: { name: 'ponytail', label: 'Ponytail', initials: 'PO', avatarUrl: AVATAR_URL },\n        }),\n        railSession({\n          id: 'rail-worktree',\n          name: 'worktree child',\n          ordinal: 2,\n          nested: true,\n          provenance: 'worktree',\n          git: { branch: 'feature/rail', dirty: false },\n          profile: { name: 'reviewer', label: 'Reviewer', initials: 'RE' },\n          pendingSetups: [\n            {\n              id: 'setup',\n              name: 'docs worktree',\n              status: 'automatic worktree setup failed',\n              failed: true,\n              recovery: 'Resolve the Git setup, then retry the authenticated conversation.',\n            },\n          ],\n        }),\n        railSession({\n          id: 'rail-workflow',\n          name: 'release-hardening',\n          ordinal: 3,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'workflow · build › edit token.ts · 4m',\n        }),\n        railSession({\n          id: 'rail-workflow-failed',\n          name: 'nightly',\n          ordinal: 4,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'workflow failed · test',\n          awaitingInput: true,\n        }),\n        railSession({\n          id: 'rail-workflow-done',\n          name: 'hotfix',\n          ordinal: 5,\n          nested: true,\n          provenance: 'workflow-session',\n          status: 'stopped · open to wake',\n        }),\n      ],\n    },\n    {\n      id: 'notes',\n      name: 'Notes',\n      root: '/Users/dev/.po/workspace/Notes',\n      available: true,\n      legacy: false,\n      sessions: [],\n    },\n  ];\n}\n\nexport function templateRailStub(options: TemplateRailOptions = {}): TemplateRailFixture {\n  const actions: RecordedRailAction[] = [];\n  const record =\n    <Name extends keyof WebTemplateRailActions>(action: Name, result?: unknown) =>\n    (...args: unknown[]) => {\n      actions.push({ action, args });\n      return result;\n    };\n  const recorded: WebTemplateRailActions = {\n    openSession: record('openSession'),\n    renameSession: record('renameSession'),\n    setSessionGroups: record(\n      'setSessionGroups',\n      Promise.resolve(undefined),\n    ) as WebTemplateRailActions['setSessionGroups'],\n    renameGroup: record('renameGroup', Promise.resolve(undefined)) as WebTemplateRailActions['renameGroup'],\n    deleteGroup: record('deleteGroup', Promise.resolve(undefined)) as WebTemplateRailActions['deleteGroup'],\n    restartSession: record('restartSession'),\n    removeSession: record('removeSession', Promise.resolve(undefined)) as WebTemplateRailActions['removeSession'],\n    resumeSession: record('resumeSession'),\n    createSession: record('createSession'),\n    resumeInWorkspace: record('resumeInWorkspace'),\n    openWorkspaceSettings: record('openWorkspaceSettings'),\n    deleteWorkspace: record('deleteWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['deleteWorkspace'],\n    openAddWorkspace: record('openAddWorkspace'),\n    closeAddWorkspace: record('closeAddWorkspace'),\n    addWorkspace: record('addWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['addWorkspace'],\n    searchDirectories: record(\n      'searchDirectories',\n      Promise.resolve(['/Users/dev/workspace/po', '/Users/dev/workspace/docs']),\n    ) as WebTemplateRailActions['searchDirectories'],\n    listDirectory: record(\n      'listDirectory',\n      Promise.resolve({\n        path: '/Users/dev',\n        parent: '/Users',\n        directories: ['/Users/dev/workspace', '/Users/dev/notes'],\n      }),\n    ) as WebTemplateRailActions['listDirectory'],\n    removePendingSetup: record(\n      'removePendingSetup',\n      Promise.resolve(undefined),\n    ) as WebTemplateRailActions['removePendingSetup'],\n    openSettings: record('openSettings'),\n    openRemoteAccess: record('openRemoteAccess'),\n    turnRemoteAccessOff: record('turnRemoteAccessOff'),\n    renderSessionMenuItems: () => null,\n  };\n  return {\n    rail: {\n      workspaces: options.workspaces ?? defaultRailWorkspaces(),\n      remote: options.remote ?? { status: 'off', deviceCount: 0 },\n      pluginContent: null,\n      ...(options.addWorkspace === undefined ? {} : { addWorkspace: options.addWorkspace }),\n      actions: { ...recorded, ...options.actions },\n    },\n    actions,\n  };\n}\n"],"mappings":"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"}

package/dist/src/web/types/mcpWidget.d.mts

@@ -1,7 +1,7 @@
 import { CallToolResult } from "@modelcontextprotocol/server";
 //#region src/web/types/mcpWidget.d.ts
 /** The MCP host supplies invocation data. Widgets never receive host services or credentials. */
-export interface DoomMcpWidgetProps {
+export interface PoMcpWidgetProps {
   readonly toolName: string;
   readonly args: Readonly<Record<string, unknown>>;
   readonly result: CallToolResult | null;

package/dist/src/web/types/nativeTemplate.d.mts

@@ -6,7 +6,7 @@ import { ComponentType } from "react";
  * `WebTemplateRailActions`, so a template's menus behave as the cockpit's do. The app owns the
  * sheets these open (new session, resume); the template owns its own menus and confirmations.
  */
-export type NativeTemplateSessionsActions = Pick<WebTemplateRailActions, 'openSession' | 'renameSession' | 'restartSession' | 'removeSession' | 'resumeSession' | 'createSession' | 'resumeInWorkspace' | 'deleteWorkspace'>;
+export type NativeTemplateSessionsActions = Pick<WebTemplateRailActions, 'openSession' | 'renameSession' | 'restartSession' | 'removeSession' | 'resumeSession' | 'createSession' | 'resumeInWorkspace' | 'deleteWorkspace'> & Partial<Pick<WebTemplateRailActions, 'addWorkspace' | 'searchDirectories' | 'listDirectory' | 'setSessionGroups' | 'renameGroup' | 'deleteGroup' | 'removePendingSetup'>>;
 /**
  * What the phone app hands a template's session list.
  *

package/dist/src/web/types/nativeTemplate.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"nativeTemplate.d.mts","names":[],"sources":["../../../../src/web/types/nativeTemplate.ts"],"mappings":";;;;;;;;YASY,gCAAgC,KAC1C;;;;;;;;iBAkBe;;EAEf,qBAAqB;EACrB,cAAc;EACd,SAAS;;;iBAIM;EACf,WAAW,cAAc;;;iBAIV;EACf;EACA;EACA;EACA;EACA,SAAS"}
+{"version":3,"file":"nativeTemplate.d.mts","names":[],"sources":["../../../../src/web/types/nativeTemplate.ts"],"mappings":";;;;;;;;YASY,gCAAgC,KAC1C,8KAWA,QACE,KACE;;;;;;;;iBAkBW;;EAEf,qBAAqB;EACrB,cAAc;EACd,SAAS;;;iBAIM;EACf,WAAW,cAAc;;;iBAIV;EACf;EACA;EACA;EACA;EACA,SAAS"}

package/dist/src/web/types/template.d.mts

@@ -40,6 +40,8 @@ export interface WebTemplateRailSession {
     branch: string;
     dirty: boolean;
   };
+  /** User-assigned groups, shown under the branch line. Absent when the session has none. */
+  groups?: readonly string[];
   profile?: {
     name: string;
     /** Display name, falling back to the profile name. */
@@ -72,6 +74,12 @@ export interface WebTemplateRailDirectoryListing {
 export interface WebTemplateRailActions {
   openSession: (sessionId: string) => void;
   renameSession: (sessionId: string, name: string) => void;
+  /** Replaces the session's groups, live or dormant. The server trims, deduplicates, and rejects invalid names. */
+  setSessionGroups: (sessionId: string, groups: readonly string[]) => WebTemplateRailResult;
+  /** Renames a group on every session in it. */
+  renameGroup: (from: string, to: string) => WebTemplateRailResult;
+  /** Takes a group off every session in it. */
+  deleteGroup: (name: string) => WebTemplateRailResult;
   restartSession: (sessionId: string) => void;
   removeSession: (sessionId: string) => WebTemplateRailResult;
   /** Opens the session history request, rendered by the selected dashboard. */

package/dist/src/web/types/template.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.mts","names":[],"sources":["../../../../src/web/types/template.ts"],"mappings":";;;iBAGiB;EACf;EACA;;;iBAIe;EACf;EACA;;EAEA;EACA;;EAEA;;;iBAIe;EACf;EACA;;EAEA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;;;;;EAKA;;EAEA;EACA;IAAQ;IAAgB;;EACxB;IACE;;IAEA;IACA;;IAEA;;EAEF,wBAAwB;;iBAGT;EACf;EACA;EACA;EACA;;EAEA;EACA,mBAAmB;;;YAIT,wBAAwB;EAAU;;iBAE7B;EACf;EACA;EACA;;;iBAIe;EACf,cAAc;EACd,gBAAgB,mBAAmB;EACnC,iBAAiB;EACjB,gBAAgB,sBAAsB;;EAEtC,gBAAgB;;EAEhB,gBAAgB;EAChB,oBAAoB;EACpB,wBAAwB;EACxB,kBAAkB,wBAAwB;EAC1C;EACA;;EAEA,eAAe;IAAS;IAAc;QAAoB;EAC1D,oBAAoB,kBAAkB;;EAEtC,gBAAgB,kBAAkB,QAAQ;IAAoC;;EAC9E,qBAAqB,mBAAmB,oBAAoB;EAC5D;EACA;EACA;;EAEA,yBAAyB,sBAAsB;;;iBAIhC;;EAEf,qBAAqB;EACrB;IAAU;IAA8C;IAAe;IAAqB;;;EAE5F,eAAe;;;;;EAKf;IAAiB;;;EAEjB,YAAY,YAAY;EACxB,SAAS;;;iBAIM;EACf;EACA;EACA;EACA;EACA,KAAK"}
+{"version":3,"file":"template.d.mts","names":[],"sources":["../../../../src/web/types/template.ts"],"mappings":";;;iBAGiB;EACf;EACA;;;iBAIe;EACf;EACA;;EAEA;EACA;;EAEA;;;iBAIe;EACf;EACA;;EAEA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;;;;;EAKA;;EAEA;EACA;IAAQ;IAAgB;;;EAExB;EACA;IACE;;IAEA;IACA;;IAEA;;EAEF,wBAAwB;;iBAGT;EACf;EACA;EACA;EACA;;EAEA;EACA,mBAAmB;;;YAIT,wBAAwB;EAAU;;iBAE7B;EACf;EACA;EACA;;;iBAIe;EACf,cAAc;EACd,gBAAgB,mBAAmB;;EAEnC,mBAAmB,mBAAmB,8BAA8B;;EAEpE,cAAc,cAAc,eAAe;;EAE3C,cAAc,iBAAiB;EAC/B,iBAAiB;EACjB,gBAAgB,sBAAsB;;EAEtC,gBAAgB;;EAEhB,gBAAgB;EAChB,oBAAoB;EACpB,wBAAwB;EACxB,kBAAkB,wBAAwB;EAC1C;EACA;;EAEA,eAAe;IAAS;IAAc;QAAoB;EAC1D,oBAAoB,kBAAkB;;EAEtC,gBAAgB,kBAAkB,QAAQ;IAAoC;;EAC9E,qBAAqB,mBAAmB,oBAAoB;EAC5D;EACA;EACA;;EAEA,yBAAyB,sBAAsB;;;iBAIhC;;EAEf,qBAAqB;EACrB;IAAU;IAA8C;IAAe;IAAqB;;;EAE5F,eAAe;;;;;EAKf;IAAiB;;;EAEjB,YAAY,YAAY;EACxB,SAAS;;;iBAIM;EACf;EACA;EACA;EACA;EACA,KAAK"}