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

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

@@ -141,7 +141,8 @@ export interface ComposerCapture {
 export interface CaptureStatusEvent {
   sessionId: string;
   captureId: string;
-  status: 'queued' | 'working' | 'completed' | 'error';
+  /** `untracked`: sent and accepted, but this page can no longer see how it ends. */
+  status: 'queued' | 'working' | 'completed' | 'error' | 'untracked';
   error?: string;
 }
 /** One accepted composer delivery, published before its browser draft is cleared. */
@@ -451,7 +452,7 @@ export interface SettingsFieldOption {
 }
 /** One repository the host has admitted into repository-scoped settings. */
 export interface RepositorySettingsRepository {
-  /** Opaque hub-issued identity. Package APIs resolve this through DoomApiContext. */
+  /** Opaque hub-issued identity. Package APIs resolve this through PoApiContext. */
   id: string;
   /** Last path segment, for compact pickers and headings. */
   name: string;
@@ -549,8 +550,14 @@ export interface DockFaceContribution {
   label: string;
   /** Lower values appear first after the host faces, then id breaks ties. */
   order?: number;
-  /** Select this face when it becomes available for the focused session. */
-  autoSelect?: boolean;
+  /**
+   * Select this face when it becomes available. A boolean selects once per
+   * session; a predicate selects each time a matching tab becomes active.
+   */
+  autoSelect?: boolean | ((context: {
+    sessionId: string | null;
+    tabId: string | null;
+  }) => boolean);
   /** Hide this face unless the session's named minor mode is active. */
   requiredMinorMode?: string;
   panel: ComponentType<WebPluginSlotProps>;
@@ -932,6 +939,11 @@ export interface WebPluginRuntime {
   onHubConnected(listener: () => void): () => void;
   /** Acquires the browser's WebMCP surface, or the page-lifetime simulator when unavailable. */
   acquireModelContext?(): Promise<ModelContextBinding>;
+  /** Live minor-mode facts for browser capabilities whose registration follows agent access. */
+  minorModes?: {
+    active(sessionId: string | null): readonly string[];
+    subscribe(sessionId: string | null, listener: () => void): () => void;
+  };
   /** Observes accepted composer submissions for page-lifetime plugin correlation. */
   onComposerSubmitted?(listener: (submission: ComposerSubmission) => void): () => void;
   /** Execution events follow accepted submission and use context.id as captureId. */
@@ -939,7 +951,7 @@ export interface WebPluginRuntime {
 }
 export interface WebPluginDefinition {
   id: string;
-  /** Independently installed contributions, using the same ownership levels as server facets. */
+  /** Independently installed contributions, using the same ownership levels as server plugins. */
   global?: WebPluginContributions;
   workspace?: WebPluginContributions;
   session?: WebPluginContributions;

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

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

package/dist/testMode.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_index = require("./src/services/testMode/index.cjs");
+exports.getValidatedTestContext = require_index.getValidatedTestContext;
+exports.initializeTestMode = require_index.initializeTestMode;

package/dist/testMode.d.mts

@@ -0,0 +1,2 @@
+import { getValidatedTestContext, initializeTestMode } from "./src/services/testMode/index.mjs";
+export { getValidatedTestContext, initializeTestMode };

package/dist/testMode.mjs

@@ -0,0 +1 @@
+export { getValidatedTestContext, initializeTestMode } from "./src/services/testMode/index.mjs";

package/dist/testing.cjs

@@ -6,6 +6,6 @@ const require_index$1 = require("./src/services/packageApiHarness/index.cjs");
 const require_index$2 = require("./src/services/apiSurfaceAssert/index.cjs");
 exports.assertContractSurface = require_index$2.assertContractSurface;
 exports.createPiTestHost = require_testHost.createPiTestHost;
-exports.doomHubChannelHarness = require_index.doomHubChannelHarness;
 exports.mountPackageApi = require_index$1.mountPackageApi;
+exports.poHubChannelHarness = require_index.poHubChannelHarness;
 exports.standardExtensionScenarios = require_extensionScenarios.standardExtensionScenarios;

package/dist/testing.d.mts

@@ -1,6 +1,6 @@
 import { PiTestContextOptions, PiTestDialogAnswers, PiTestHost, PiTestHostOptions, RecordedCommand, RecordedEntry, RecordedExec, RecordedMessage, RecordedNotification, RecordedProvider, RecordedRenderer, RecordedShortcut, RecordedStatus, RecordedUserMessage, RecordedWidget, createPiTestHost } from "./src/testing/pi/testHost.mjs";
 import { ExtensionContractScenario, StandardExtensionContractOptions, standardExtensionScenarios } from "./src/testing/pi/extensionScenarios.mjs";
-import { DoomHubChannelHarness, DoomHubChannelHarnessOptions, doomHubChannelHarness } from "./src/services/hubChannelHarness/index.mjs";
+import { PoHubChannelHarness, PoHubChannelHarnessOptions, poHubChannelHarness } from "./src/services/hubChannelHarness/index.mjs";
 import { MountPackageApiOptions, MountedPackageApi, mountPackageApi } from "./src/services/packageApiHarness/index.mjs";
 import { ApiSurfaceOptions, assertContractSurface } from "./src/services/apiSurfaceAssert/index.mjs";
-export { type ApiSurfaceOptions, type DoomHubChannelHarness, type DoomHubChannelHarnessOptions, type ExtensionContractScenario, type MountPackageApiOptions, type MountedPackageApi, type PiTestContextOptions, type PiTestDialogAnswers, type PiTestHost, type PiTestHostOptions, type RecordedCommand, type RecordedEntry, type RecordedExec, type RecordedMessage, type RecordedNotification, type RecordedProvider, type RecordedRenderer, type RecordedShortcut, type RecordedStatus, type RecordedUserMessage, type RecordedWidget, type StandardExtensionContractOptions, assertContractSurface, createPiTestHost, doomHubChannelHarness, mountPackageApi, standardExtensionScenarios };
+export { type ApiSurfaceOptions, type ExtensionContractScenario, type MountPackageApiOptions, type MountedPackageApi, type PiTestContextOptions, type PiTestDialogAnswers, type PiTestHost, type PiTestHostOptions, type PoHubChannelHarness, type PoHubChannelHarnessOptions, type RecordedCommand, type RecordedEntry, type RecordedExec, type RecordedMessage, type RecordedNotification, type RecordedProvider, type RecordedRenderer, type RecordedShortcut, type RecordedStatus, type RecordedUserMessage, type RecordedWidget, type StandardExtensionContractOptions, assertContractSurface, createPiTestHost, mountPackageApi, poHubChannelHarness, standardExtensionScenarios };

package/dist/testing.mjs

@@ -1,6 +1,6 @@
 import { createPiTestHost } from "./src/testing/pi/testHost.mjs";
 import { standardExtensionScenarios } from "./src/testing/pi/extensionScenarios.mjs";
-import { doomHubChannelHarness } from "./src/services/hubChannelHarness/index.mjs";
+import { poHubChannelHarness } from "./src/services/hubChannelHarness/index.mjs";
 import { mountPackageApi } from "./src/services/packageApiHarness/index.mjs";
 import { assertContractSurface } from "./src/services/apiSurfaceAssert/index.mjs";
-export { assertContractSurface, createPiTestHost, doomHubChannelHarness, mountPackageApi, standardExtensionScenarios };
+export { assertContractSurface, createPiTestHost, mountPackageApi, poHubChannelHarness, standardExtensionScenarios };

package/dist/toolInventory.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"toolInventory.cjs","names":[],"sources":["../src/services/toolInventory/index.ts"],"sourcesContent":["import type { McpServerSnapshot } from '../../exports/mcpStatus';\n\nexport type ToolSourceKind = 'core' | 'mcp' | 'extension';\n\nexport interface ToolEntry {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  /** One-line snippet Pi keys by tool name in the system prompt. */\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  active: boolean;\n}\n\nexport interface ToolSource {\n  key: string;\n  label: string;\n  kind: ToolSourceKind;\n  /** Server state for MCP sources, e.g. `disabled`; absent for core and extensions. */\n  status?: string;\n  /** The registering file for extension sources. */\n  detail?: string;\n  /**\n   * Package name as its manifest spells it, scope included.\n   *\n   * `label` is shortened for reading. Attribution joins against `.po`\n   * configuration, which names packages in full, so the unshortened name is\n   * carried separately rather than recovered from the label.\n   */\n  packageName?: string;\n  tools: readonly ToolEntry[];\n}\n\n/** One server row of the MCP status snapshot. */\nexport type McpServerStatus = McpServerSnapshot;\n\nexport interface ToolInfo {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  sourceInfo: { path: string; source?: string };\n}\n\nexport interface ToolInventoryInput {\n  tools: readonly ToolInfo[];\n  activeTools: readonly string[];\n  /** Absent when the MCP adapter is not loaded or has not published yet. */\n  mcpServers?: readonly McpServerStatus[];\n  resolveExtensionName?: (entryPath: string) => string;\n  /** Unshortened package name for the same entry path, for attribution. */\n  resolveExtensionPackageName?: (entryPath: string) => string | undefined;\n  resolveExtensionToolSource?: (toolName: string) => string | undefined;\n}\n\n/** Pi tags its own tools with this source; everything else came from an extension. */\nconst BUILTIN_SOURCE = 'builtin';\n/** Pi's structural tags for an extension path, neither of which is a package name. */\nconst CLI_SOURCE = 'cli';\nconst LOCAL_SOURCE = 'local';\nconst CORE_KEY = 'core';\nconst CORE_NAME = 'pi';\nconst MCP_KEY_PREFIX = 'mcp:';\n/** Labels read name first, then kind, because the name is what the eye scans for. */\nconst KIND_SUFFIX: Record<ToolSourceKind, string> = { core: 'core', mcp: 'mcp', extension: 'extension' };\nconst CONNECTED_STATUS = 'connected';\nconst KIND_ORDER: Record<ToolSourceKind, number> = { core: 0, mcp: 1, extension: 2 };\n\n/**\n * Server state worth reporting, which takes the place of the tool count.\n *\n * A connected server is the unremarkable case, so it keeps its count rather\n * than spending the column on a word that says nothing went wrong.\n */\nfunction displayStatus(server: McpServerStatus): string | undefined {\n  return server.state === CONNECTED_STATUS ? undefined : server.state.replace(/-/g, ' ');\n}\n\nfunction toEntry(tool: ToolInfo, activeTools: ReadonlySet<string>): ToolEntry {\n  return {\n    name: tool.name,\n    ...(tool.description ? { description: tool.description } : {}),\n    ...(tool.parameters === undefined ? {} : { parameters: tool.parameters }),\n    ...(tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {}),\n    ...(tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {}),\n    active: activeTools.has(tool.name),\n  };\n}\n\nfunction byName(left: ToolEntry, right: ToolEntry): number {\n  return left.name.localeCompare(right.name);\n}\n\nfunction sourceLabel(name: string, kind: ToolSourceKind): string {\n  return `${name} · ${KIND_SUFFIX[kind]}`;\n}\n\n/**\n * Indexes each server's declared tool names.\n *\n * The snapshot names its tools outright, so attribution is a lookup rather than a\n * guess at the naming scheme. A tool the snapshot does not claim falls through to\n * the extension that registered it.\n */\nfunction serverByTool(servers: readonly McpServerStatus[]): Map<string, McpServerStatus> {\n  const index = new Map<string, McpServerStatus>();\n  for (const server of servers) {\n    for (const toolName of server.tools) index.set(toolName, server);\n  }\n  return index;\n}\n\n/**\n * Groups the session's tools by where they came from: Pi itself, one group per\n * MCP server, then one per extension that registered a tool.\n *\n * Every MCP tool is registered by one extension, so `sourceInfo` cannot separate\n * servers; the status snapshot supplies the tool-to-server mapping instead.\n */\nexport function buildToolSources(input: ToolInventoryInput): readonly ToolSource[] {\n  const activeTools = new Set(input.activeTools);\n  const servers = input.mcpServers ?? [];\n  const owningServer = serverByTool(servers);\n  const core: ToolEntry[] = [];\n  const mcpTools = new Map<string, ToolEntry[]>();\n  const extensions = new Map<string, { label: string; detail: string; packageName?: string; tools: ToolEntry[] }>();\n\n  for (const tool of input.tools) {\n    const entry = toEntry(tool, activeTools);\n    const server = owningServer.get(tool.name);\n    if (server) {\n      const bucket = mcpTools.get(server.name);\n      if (bucket) bucket.push(entry);\n      else mcpTools.set(server.name, [entry]);\n      continue;\n    }\n    if (tool.sourceInfo.source === BUILTIN_SOURCE) {\n      core.push(entry);\n      continue;\n    }\n    // A composed bundle has one Pi source path for every factory inside it. Doom's\n    // compiler records the original entry at registration time so those extensions\n    // remain separate here even though Pi can only see the outer bundle.\n    const recordedPath = input.resolveExtensionToolSource?.(tool.name);\n    const key = recordedPath ?? tool.sourceInfo.path;\n    const group = extensions.get(key);\n    if (group) group.tools.push(entry);\n    else {\n      const structuralSource =\n        recordedPath !== undefined ||\n        tool.sourceInfo.source === CLI_SOURCE ||\n        tool.sourceInfo.source === LOCAL_SOURCE ||\n        !tool.sourceInfo.source;\n      const name = structuralSource\n        ? (input.resolveExtensionName?.(key) ?? tool.sourceInfo.source ?? key)\n        : (tool.sourceInfo.source ?? key);\n      const scoped = input.resolveExtensionPackageName?.(key);\n      extensions.set(key, {\n        label: sourceLabel(name, 'extension'),\n        detail: key,\n        ...(scoped ? { packageName: scoped } : {}),\n        tools: [entry],\n      });\n    }\n  }\n\n  const sources: ToolSource[] = [];\n  if (core.length > 0) {\n    sources.push({ key: CORE_KEY, label: sourceLabel(CORE_NAME, CORE_KEY), kind: CORE_KEY, tools: core.sort(byName) });\n  }\n  for (const server of servers) {\n    const tools = mcpTools.get(server.name) ?? [];\n    const status = displayStatus(server);\n    // Every configured server is listed, including one with no tools: attribution\n    // is exact now, so an empty list is a fact about the server rather than a\n    // failure to recognise its tool names.\n    sources.push({\n      key: `${MCP_KEY_PREFIX}${server.name}`,\n      label: sourceLabel(server.name, 'mcp'),\n      kind: 'mcp',\n      ...(status ? { status } : {}),\n      tools: tools.sort(byName),\n    });\n  }\n  for (const [key, group] of extensions) {\n    sources.push({\n      key,\n      label: group.label,\n      kind: 'extension',\n      detail: group.detail,\n      ...(group.packageName ? { packageName: group.packageName } : {}),\n      tools: group.tools.sort(byName),\n    });\n  }\n\n  return sources.sort(\n    (left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind] || left.label.localeCompare(right.label),\n  );\n}\n\nexport { type CountTokens, type ToolCost, tokensForSource, tokensForTool } from '../toolCost';\n"],"mappings":"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"}
+{"version":3,"file":"toolInventory.cjs","names":[],"sources":["../src/services/toolInventory/index.ts"],"sourcesContent":["import type { McpServerSnapshot } from '../../exports/mcpStatus';\n\nexport type ToolSourceKind = 'core' | 'mcp' | 'extension';\n\nexport interface ToolEntry {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  /** One-line snippet Pi keys by tool name in the system prompt. */\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  active: boolean;\n}\n\nexport interface ToolSource {\n  key: string;\n  label: string;\n  kind: ToolSourceKind;\n  /** Server state for MCP sources, e.g. `disabled`; absent for core and extensions. */\n  status?: string;\n  /** The registering file for extension sources. */\n  detail?: string;\n  /**\n   * Package name as its manifest spells it, scope included.\n   *\n   * `label` is shortened for reading. Attribution joins against `.po`\n   * configuration, which names packages in full, so the unshortened name is\n   * carried separately rather than recovered from the label.\n   */\n  packageName?: string;\n  tools: readonly ToolEntry[];\n}\n\n/** One server row of the MCP status snapshot. */\nexport type McpServerStatus = McpServerSnapshot;\n\nexport interface ToolInfo {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  sourceInfo: { path: string; source?: string };\n}\n\nexport interface ToolInventoryInput {\n  tools: readonly ToolInfo[];\n  activeTools: readonly string[];\n  /** Absent when the MCP adapter is not loaded or has not published yet. */\n  mcpServers?: readonly McpServerStatus[];\n  resolveExtensionName?: (entryPath: string) => string;\n  /** Unshortened package name for the same entry path, for attribution. */\n  resolveExtensionPackageName?: (entryPath: string) => string | undefined;\n  resolveExtensionToolSource?: (toolName: string) => string | undefined;\n}\n\n/** Pi tags its own tools with this source; everything else came from an extension. */\nconst BUILTIN_SOURCE = 'builtin';\n/** Pi's structural tags for an extension path, neither of which is a package name. */\nconst CLI_SOURCE = 'cli';\nconst LOCAL_SOURCE = 'local';\nconst CORE_KEY = 'core';\nconst CORE_NAME = 'pi';\nconst MCP_KEY_PREFIX = 'mcp:';\n/** Labels read name first, then kind, because the name is what the eye scans for. */\nconst KIND_SUFFIX: Record<ToolSourceKind, string> = { core: 'core', mcp: 'mcp', extension: 'extension' };\nconst CONNECTED_STATUS = 'connected';\nconst KIND_ORDER: Record<ToolSourceKind, number> = { core: 0, mcp: 1, extension: 2 };\n\n/**\n * Server state worth reporting, which takes the place of the tool count.\n *\n * A connected server is the unremarkable case, so it keeps its count rather\n * than spending the column on a word that says nothing went wrong.\n */\nfunction displayStatus(server: McpServerStatus): string | undefined {\n  return server.state === CONNECTED_STATUS ? undefined : server.state.replace(/-/g, ' ');\n}\n\nfunction toEntry(tool: ToolInfo, activeTools: ReadonlySet<string>): ToolEntry {\n  return {\n    name: tool.name,\n    ...(tool.description ? { description: tool.description } : {}),\n    ...(tool.parameters === undefined ? {} : { parameters: tool.parameters }),\n    ...(tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {}),\n    ...(tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {}),\n    active: activeTools.has(tool.name),\n  };\n}\n\nfunction byName(left: ToolEntry, right: ToolEntry): number {\n  return left.name.localeCompare(right.name);\n}\n\nfunction sourceLabel(name: string, kind: ToolSourceKind): string {\n  return `${name} · ${KIND_SUFFIX[kind]}`;\n}\n\n/**\n * Indexes each server's declared tool names.\n *\n * The snapshot names its tools outright, so attribution is a lookup rather than a\n * guess at the naming scheme. A tool the snapshot does not claim falls through to\n * the extension that registered it.\n */\nfunction serverByTool(servers: readonly McpServerStatus[]): Map<string, McpServerStatus> {\n  const index = new Map<string, McpServerStatus>();\n  for (const server of servers) {\n    for (const toolName of server.tools) index.set(toolName, server);\n  }\n  return index;\n}\n\n/**\n * Groups the session's tools by where they came from: Pi itself, one group per\n * MCP server, then one per extension that registered a tool.\n *\n * Every MCP tool is registered by one extension, so `sourceInfo` cannot separate\n * servers; the status snapshot supplies the tool-to-server mapping instead.\n */\nexport function buildToolSources(input: ToolInventoryInput): readonly ToolSource[] {\n  const activeTools = new Set(input.activeTools);\n  const servers = input.mcpServers ?? [];\n  const owningServer = serverByTool(servers);\n  const core: ToolEntry[] = [];\n  const mcpTools = new Map<string, ToolEntry[]>();\n  const extensions = new Map<string, { label: string; detail: string; packageName?: string; tools: ToolEntry[] }>();\n\n  for (const tool of input.tools) {\n    const entry = toEntry(tool, activeTools);\n    const server = owningServer.get(tool.name);\n    if (server) {\n      const bucket = mcpTools.get(server.name);\n      if (bucket) bucket.push(entry);\n      else mcpTools.set(server.name, [entry]);\n      continue;\n    }\n    if (tool.sourceInfo.source === BUILTIN_SOURCE) {\n      core.push(entry);\n      continue;\n    }\n    // A composed bundle has one Pi source path for every factory inside it. Po's\n    // compiler records the original entry at registration time so those extensions\n    // remain separate here even though Pi can only see the outer bundle.\n    const recordedPath = input.resolveExtensionToolSource?.(tool.name);\n    const key = recordedPath ?? tool.sourceInfo.path;\n    const group = extensions.get(key);\n    if (group) group.tools.push(entry);\n    else {\n      const structuralSource =\n        recordedPath !== undefined ||\n        tool.sourceInfo.source === CLI_SOURCE ||\n        tool.sourceInfo.source === LOCAL_SOURCE ||\n        !tool.sourceInfo.source;\n      const name = structuralSource\n        ? (input.resolveExtensionName?.(key) ?? tool.sourceInfo.source ?? key)\n        : (tool.sourceInfo.source ?? key);\n      const scoped = input.resolveExtensionPackageName?.(key);\n      extensions.set(key, {\n        label: sourceLabel(name, 'extension'),\n        detail: key,\n        ...(scoped ? { packageName: scoped } : {}),\n        tools: [entry],\n      });\n    }\n  }\n\n  const sources: ToolSource[] = [];\n  if (core.length > 0) {\n    sources.push({ key: CORE_KEY, label: sourceLabel(CORE_NAME, CORE_KEY), kind: CORE_KEY, tools: core.sort(byName) });\n  }\n  for (const server of servers) {\n    const tools = mcpTools.get(server.name) ?? [];\n    const status = displayStatus(server);\n    // Every configured server is listed, including one with no tools: attribution\n    // is exact now, so an empty list is a fact about the server rather than a\n    // failure to recognise its tool names.\n    sources.push({\n      key: `${MCP_KEY_PREFIX}${server.name}`,\n      label: sourceLabel(server.name, 'mcp'),\n      kind: 'mcp',\n      ...(status ? { status } : {}),\n      tools: tools.sort(byName),\n    });\n  }\n  for (const [key, group] of extensions) {\n    sources.push({\n      key,\n      label: group.label,\n      kind: 'extension',\n      detail: group.detail,\n      ...(group.packageName ? { packageName: group.packageName } : {}),\n      tools: group.tools.sort(byName),\n    });\n  }\n\n  return sources.sort(\n    (left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind] || left.label.localeCompare(right.label),\n  );\n}\n\nexport { type CountTokens, type ToolCost, tokensForSource, tokensForTool } from '../toolCost';\n"],"mappings":"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"}

package/dist/toolInventory.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"toolInventory.mjs","names":[],"sources":["../src/services/toolInventory/index.ts"],"sourcesContent":["import type { McpServerSnapshot } from '../../exports/mcpStatus';\n\nexport type ToolSourceKind = 'core' | 'mcp' | 'extension';\n\nexport interface ToolEntry {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  /** One-line snippet Pi keys by tool name in the system prompt. */\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  active: boolean;\n}\n\nexport interface ToolSource {\n  key: string;\n  label: string;\n  kind: ToolSourceKind;\n  /** Server state for MCP sources, e.g. `disabled`; absent for core and extensions. */\n  status?: string;\n  /** The registering file for extension sources. */\n  detail?: string;\n  /**\n   * Package name as its manifest spells it, scope included.\n   *\n   * `label` is shortened for reading. Attribution joins against `.po`\n   * configuration, which names packages in full, so the unshortened name is\n   * carried separately rather than recovered from the label.\n   */\n  packageName?: string;\n  tools: readonly ToolEntry[];\n}\n\n/** One server row of the MCP status snapshot. */\nexport type McpServerStatus = McpServerSnapshot;\n\nexport interface ToolInfo {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  sourceInfo: { path: string; source?: string };\n}\n\nexport interface ToolInventoryInput {\n  tools: readonly ToolInfo[];\n  activeTools: readonly string[];\n  /** Absent when the MCP adapter is not loaded or has not published yet. */\n  mcpServers?: readonly McpServerStatus[];\n  resolveExtensionName?: (entryPath: string) => string;\n  /** Unshortened package name for the same entry path, for attribution. */\n  resolveExtensionPackageName?: (entryPath: string) => string | undefined;\n  resolveExtensionToolSource?: (toolName: string) => string | undefined;\n}\n\n/** Pi tags its own tools with this source; everything else came from an extension. */\nconst BUILTIN_SOURCE = 'builtin';\n/** Pi's structural tags for an extension path, neither of which is a package name. */\nconst CLI_SOURCE = 'cli';\nconst LOCAL_SOURCE = 'local';\nconst CORE_KEY = 'core';\nconst CORE_NAME = 'pi';\nconst MCP_KEY_PREFIX = 'mcp:';\n/** Labels read name first, then kind, because the name is what the eye scans for. */\nconst KIND_SUFFIX: Record<ToolSourceKind, string> = { core: 'core', mcp: 'mcp', extension: 'extension' };\nconst CONNECTED_STATUS = 'connected';\nconst KIND_ORDER: Record<ToolSourceKind, number> = { core: 0, mcp: 1, extension: 2 };\n\n/**\n * Server state worth reporting, which takes the place of the tool count.\n *\n * A connected server is the unremarkable case, so it keeps its count rather\n * than spending the column on a word that says nothing went wrong.\n */\nfunction displayStatus(server: McpServerStatus): string | undefined {\n  return server.state === CONNECTED_STATUS ? undefined : server.state.replace(/-/g, ' ');\n}\n\nfunction toEntry(tool: ToolInfo, activeTools: ReadonlySet<string>): ToolEntry {\n  return {\n    name: tool.name,\n    ...(tool.description ? { description: tool.description } : {}),\n    ...(tool.parameters === undefined ? {} : { parameters: tool.parameters }),\n    ...(tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {}),\n    ...(tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {}),\n    active: activeTools.has(tool.name),\n  };\n}\n\nfunction byName(left: ToolEntry, right: ToolEntry): number {\n  return left.name.localeCompare(right.name);\n}\n\nfunction sourceLabel(name: string, kind: ToolSourceKind): string {\n  return `${name} · ${KIND_SUFFIX[kind]}`;\n}\n\n/**\n * Indexes each server's declared tool names.\n *\n * The snapshot names its tools outright, so attribution is a lookup rather than a\n * guess at the naming scheme. A tool the snapshot does not claim falls through to\n * the extension that registered it.\n */\nfunction serverByTool(servers: readonly McpServerStatus[]): Map<string, McpServerStatus> {\n  const index = new Map<string, McpServerStatus>();\n  for (const server of servers) {\n    for (const toolName of server.tools) index.set(toolName, server);\n  }\n  return index;\n}\n\n/**\n * Groups the session's tools by where they came from: Pi itself, one group per\n * MCP server, then one per extension that registered a tool.\n *\n * Every MCP tool is registered by one extension, so `sourceInfo` cannot separate\n * servers; the status snapshot supplies the tool-to-server mapping instead.\n */\nexport function buildToolSources(input: ToolInventoryInput): readonly ToolSource[] {\n  const activeTools = new Set(input.activeTools);\n  const servers = input.mcpServers ?? [];\n  const owningServer = serverByTool(servers);\n  const core: ToolEntry[] = [];\n  const mcpTools = new Map<string, ToolEntry[]>();\n  const extensions = new Map<string, { label: string; detail: string; packageName?: string; tools: ToolEntry[] }>();\n\n  for (const tool of input.tools) {\n    const entry = toEntry(tool, activeTools);\n    const server = owningServer.get(tool.name);\n    if (server) {\n      const bucket = mcpTools.get(server.name);\n      if (bucket) bucket.push(entry);\n      else mcpTools.set(server.name, [entry]);\n      continue;\n    }\n    if (tool.sourceInfo.source === BUILTIN_SOURCE) {\n      core.push(entry);\n      continue;\n    }\n    // A composed bundle has one Pi source path for every factory inside it. Doom's\n    // compiler records the original entry at registration time so those extensions\n    // remain separate here even though Pi can only see the outer bundle.\n    const recordedPath = input.resolveExtensionToolSource?.(tool.name);\n    const key = recordedPath ?? tool.sourceInfo.path;\n    const group = extensions.get(key);\n    if (group) group.tools.push(entry);\n    else {\n      const structuralSource =\n        recordedPath !== undefined ||\n        tool.sourceInfo.source === CLI_SOURCE ||\n        tool.sourceInfo.source === LOCAL_SOURCE ||\n        !tool.sourceInfo.source;\n      const name = structuralSource\n        ? (input.resolveExtensionName?.(key) ?? tool.sourceInfo.source ?? key)\n        : (tool.sourceInfo.source ?? key);\n      const scoped = input.resolveExtensionPackageName?.(key);\n      extensions.set(key, {\n        label: sourceLabel(name, 'extension'),\n        detail: key,\n        ...(scoped ? { packageName: scoped } : {}),\n        tools: [entry],\n      });\n    }\n  }\n\n  const sources: ToolSource[] = [];\n  if (core.length > 0) {\n    sources.push({ key: CORE_KEY, label: sourceLabel(CORE_NAME, CORE_KEY), kind: CORE_KEY, tools: core.sort(byName) });\n  }\n  for (const server of servers) {\n    const tools = mcpTools.get(server.name) ?? [];\n    const status = displayStatus(server);\n    // Every configured server is listed, including one with no tools: attribution\n    // is exact now, so an empty list is a fact about the server rather than a\n    // failure to recognise its tool names.\n    sources.push({\n      key: `${MCP_KEY_PREFIX}${server.name}`,\n      label: sourceLabel(server.name, 'mcp'),\n      kind: 'mcp',\n      ...(status ? { status } : {}),\n      tools: tools.sort(byName),\n    });\n  }\n  for (const [key, group] of extensions) {\n    sources.push({\n      key,\n      label: group.label,\n      kind: 'extension',\n      detail: group.detail,\n      ...(group.packageName ? { packageName: group.packageName } : {}),\n      tools: group.tools.sort(byName),\n    });\n  }\n\n  return sources.sort(\n    (left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind] || left.label.localeCompare(right.label),\n  );\n}\n\nexport { type CountTokens, type ToolCost, tokensForSource, tokensForTool } from '../toolCost';\n"],"mappings":"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"}
+{"version":3,"file":"toolInventory.mjs","names":[],"sources":["../src/services/toolInventory/index.ts"],"sourcesContent":["import type { McpServerSnapshot } from '../../exports/mcpStatus';\n\nexport type ToolSourceKind = 'core' | 'mcp' | 'extension';\n\nexport interface ToolEntry {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  /** One-line snippet Pi keys by tool name in the system prompt. */\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  active: boolean;\n}\n\nexport interface ToolSource {\n  key: string;\n  label: string;\n  kind: ToolSourceKind;\n  /** Server state for MCP sources, e.g. `disabled`; absent for core and extensions. */\n  status?: string;\n  /** The registering file for extension sources. */\n  detail?: string;\n  /**\n   * Package name as its manifest spells it, scope included.\n   *\n   * `label` is shortened for reading. Attribution joins against `.po`\n   * configuration, which names packages in full, so the unshortened name is\n   * carried separately rather than recovered from the label.\n   */\n  packageName?: string;\n  tools: readonly ToolEntry[];\n}\n\n/** One server row of the MCP status snapshot. */\nexport type McpServerStatus = McpServerSnapshot;\n\nexport interface ToolInfo {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  sourceInfo: { path: string; source?: string };\n}\n\nexport interface ToolInventoryInput {\n  tools: readonly ToolInfo[];\n  activeTools: readonly string[];\n  /** Absent when the MCP adapter is not loaded or has not published yet. */\n  mcpServers?: readonly McpServerStatus[];\n  resolveExtensionName?: (entryPath: string) => string;\n  /** Unshortened package name for the same entry path, for attribution. */\n  resolveExtensionPackageName?: (entryPath: string) => string | undefined;\n  resolveExtensionToolSource?: (toolName: string) => string | undefined;\n}\n\n/** Pi tags its own tools with this source; everything else came from an extension. */\nconst BUILTIN_SOURCE = 'builtin';\n/** Pi's structural tags for an extension path, neither of which is a package name. */\nconst CLI_SOURCE = 'cli';\nconst LOCAL_SOURCE = 'local';\nconst CORE_KEY = 'core';\nconst CORE_NAME = 'pi';\nconst MCP_KEY_PREFIX = 'mcp:';\n/** Labels read name first, then kind, because the name is what the eye scans for. */\nconst KIND_SUFFIX: Record<ToolSourceKind, string> = { core: 'core', mcp: 'mcp', extension: 'extension' };\nconst CONNECTED_STATUS = 'connected';\nconst KIND_ORDER: Record<ToolSourceKind, number> = { core: 0, mcp: 1, extension: 2 };\n\n/**\n * Server state worth reporting, which takes the place of the tool count.\n *\n * A connected server is the unremarkable case, so it keeps its count rather\n * than spending the column on a word that says nothing went wrong.\n */\nfunction displayStatus(server: McpServerStatus): string | undefined {\n  return server.state === CONNECTED_STATUS ? undefined : server.state.replace(/-/g, ' ');\n}\n\nfunction toEntry(tool: ToolInfo, activeTools: ReadonlySet<string>): ToolEntry {\n  return {\n    name: tool.name,\n    ...(tool.description ? { description: tool.description } : {}),\n    ...(tool.parameters === undefined ? {} : { parameters: tool.parameters }),\n    ...(tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {}),\n    ...(tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {}),\n    active: activeTools.has(tool.name),\n  };\n}\n\nfunction byName(left: ToolEntry, right: ToolEntry): number {\n  return left.name.localeCompare(right.name);\n}\n\nfunction sourceLabel(name: string, kind: ToolSourceKind): string {\n  return `${name} · ${KIND_SUFFIX[kind]}`;\n}\n\n/**\n * Indexes each server's declared tool names.\n *\n * The snapshot names its tools outright, so attribution is a lookup rather than a\n * guess at the naming scheme. A tool the snapshot does not claim falls through to\n * the extension that registered it.\n */\nfunction serverByTool(servers: readonly McpServerStatus[]): Map<string, McpServerStatus> {\n  const index = new Map<string, McpServerStatus>();\n  for (const server of servers) {\n    for (const toolName of server.tools) index.set(toolName, server);\n  }\n  return index;\n}\n\n/**\n * Groups the session's tools by where they came from: Pi itself, one group per\n * MCP server, then one per extension that registered a tool.\n *\n * Every MCP tool is registered by one extension, so `sourceInfo` cannot separate\n * servers; the status snapshot supplies the tool-to-server mapping instead.\n */\nexport function buildToolSources(input: ToolInventoryInput): readonly ToolSource[] {\n  const activeTools = new Set(input.activeTools);\n  const servers = input.mcpServers ?? [];\n  const owningServer = serverByTool(servers);\n  const core: ToolEntry[] = [];\n  const mcpTools = new Map<string, ToolEntry[]>();\n  const extensions = new Map<string, { label: string; detail: string; packageName?: string; tools: ToolEntry[] }>();\n\n  for (const tool of input.tools) {\n    const entry = toEntry(tool, activeTools);\n    const server = owningServer.get(tool.name);\n    if (server) {\n      const bucket = mcpTools.get(server.name);\n      if (bucket) bucket.push(entry);\n      else mcpTools.set(server.name, [entry]);\n      continue;\n    }\n    if (tool.sourceInfo.source === BUILTIN_SOURCE) {\n      core.push(entry);\n      continue;\n    }\n    // A composed bundle has one Pi source path for every factory inside it. Po's\n    // compiler records the original entry at registration time so those extensions\n    // remain separate here even though Pi can only see the outer bundle.\n    const recordedPath = input.resolveExtensionToolSource?.(tool.name);\n    const key = recordedPath ?? tool.sourceInfo.path;\n    const group = extensions.get(key);\n    if (group) group.tools.push(entry);\n    else {\n      const structuralSource =\n        recordedPath !== undefined ||\n        tool.sourceInfo.source === CLI_SOURCE ||\n        tool.sourceInfo.source === LOCAL_SOURCE ||\n        !tool.sourceInfo.source;\n      const name = structuralSource\n        ? (input.resolveExtensionName?.(key) ?? tool.sourceInfo.source ?? key)\n        : (tool.sourceInfo.source ?? key);\n      const scoped = input.resolveExtensionPackageName?.(key);\n      extensions.set(key, {\n        label: sourceLabel(name, 'extension'),\n        detail: key,\n        ...(scoped ? { packageName: scoped } : {}),\n        tools: [entry],\n      });\n    }\n  }\n\n  const sources: ToolSource[] = [];\n  if (core.length > 0) {\n    sources.push({ key: CORE_KEY, label: sourceLabel(CORE_NAME, CORE_KEY), kind: CORE_KEY, tools: core.sort(byName) });\n  }\n  for (const server of servers) {\n    const tools = mcpTools.get(server.name) ?? [];\n    const status = displayStatus(server);\n    // Every configured server is listed, including one with no tools: attribution\n    // is exact now, so an empty list is a fact about the server rather than a\n    // failure to recognise its tool names.\n    sources.push({\n      key: `${MCP_KEY_PREFIX}${server.name}`,\n      label: sourceLabel(server.name, 'mcp'),\n      kind: 'mcp',\n      ...(status ? { status } : {}),\n      tools: tools.sort(byName),\n    });\n  }\n  for (const [key, group] of extensions) {\n    sources.push({\n      key,\n      label: group.label,\n      kind: 'extension',\n      detail: group.detail,\n      ...(group.packageName ? { packageName: group.packageName } : {}),\n      tools: group.tools.sort(byName),\n    });\n  }\n\n  return sources.sort(\n    (left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind] || left.label.localeCompare(right.label),\n  );\n}\n\nexport { type CountTokens, type ToolCost, tokensForSource, tokensForTool } from '../toolCost';\n"],"mappings":"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"}

package/dist/toolNames.mjs

@@ -1,2 +1 @@
-import { toClaudeToolName, toPiToolName } from "./runtimeToolNames.mjs";
-export { toClaudeToolName, toPiToolName };
+export { toClaudeToolName, toPiToolName } from "./runtimeToolNames.mjs";

package/dist/toolOverrides.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_toolOverrides = require("./src/schemas/toolOverrides.cjs");
 const require_index = require("./src/services/toolOverrides/index.cjs");
-exports.DOOM_TOOL_OVERRIDES_SERVICE = require_toolOverrides.DOOM_TOOL_OVERRIDES_SERVICE;
-exports.createDoomToolOverridesService = require_index.createDoomToolOverridesService;
-exports.readDoomToolOverrides = require_toolOverrides.readDoomToolOverrides;
-exports.requireDoomToolOverrides = require_toolOverrides.requireDoomToolOverrides;
+exports.PO_TOOL_OVERRIDES_SERVICE = require_toolOverrides.PO_TOOL_OVERRIDES_SERVICE;
+exports.createPoToolOverridesService = require_index.createPoToolOverridesService;
+exports.readPoToolOverrides = require_toolOverrides.readPoToolOverrides;
+exports.requirePoToolOverrides = require_toolOverrides.requirePoToolOverrides;

package/dist/toolOverrides.d.mts

@@ -1,3 +1,3 @@
-import { DOOM_TOOL_OVERRIDES_SERVICE, DoomToolOverrideClaim, DoomToolOverrideRegistration, DoomToolOverridesService, readDoomToolOverrides, requireDoomToolOverrides } from "./src/schemas/toolOverrides.mjs";
-import { createDoomToolOverridesService } from "./src/services/toolOverrides/index.mjs";
-export { DOOM_TOOL_OVERRIDES_SERVICE, type DoomToolOverrideClaim, type DoomToolOverrideRegistration, type DoomToolOverridesService, createDoomToolOverridesService, readDoomToolOverrides, requireDoomToolOverrides };
+import { PO_TOOL_OVERRIDES_SERVICE, PoToolOverrideClaim, PoToolOverrideRegistration, PoToolOverridesService, readPoToolOverrides, requirePoToolOverrides } from "./src/schemas/toolOverrides.mjs";
+import { createPoToolOverridesService } from "./src/services/toolOverrides/index.mjs";
+export { PO_TOOL_OVERRIDES_SERVICE, type PoToolOverrideClaim, type PoToolOverrideRegistration, type PoToolOverridesService, createPoToolOverridesService, readPoToolOverrides, requirePoToolOverrides };

package/dist/toolOverrides.mjs

@@ -1,3 +1,3 @@
-import { DOOM_TOOL_OVERRIDES_SERVICE, readDoomToolOverrides, requireDoomToolOverrides } from "./src/schemas/toolOverrides.mjs";
-import { createDoomToolOverridesService } from "./src/services/toolOverrides/index.mjs";
-export { DOOM_TOOL_OVERRIDES_SERVICE, createDoomToolOverridesService, readDoomToolOverrides, requireDoomToolOverrides };
+import { PO_TOOL_OVERRIDES_SERVICE, readPoToolOverrides, requirePoToolOverrides } from "./src/schemas/toolOverrides.mjs";
+import { createPoToolOverridesService } from "./src/services/toolOverrides/index.mjs";
+export { PO_TOOL_OVERRIDES_SERVICE, createPoToolOverridesService, readPoToolOverrides, requirePoToolOverrides };

package/dist/toolSurface.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_toolSurface = require("./src/schemas/toolSurface.cjs");
 const require_index = require("./src/services/toolSurface/index.cjs");
-exports.DOOM_TOOL_SURFACE_SERVICE = require_toolSurface.DOOM_TOOL_SURFACE_SERVICE;
-exports.createDoomToolSurface = require_index.createDoomToolSurface;
-exports.readDoomToolSurface = require_toolSurface.readDoomToolSurface;
-exports.requireDoomToolSurface = require_toolSurface.requireDoomToolSurface;
+exports.PO_TOOL_SURFACE_SERVICE = require_toolSurface.PO_TOOL_SURFACE_SERVICE;
+exports.createPoToolSurface = require_index.createPoToolSurface;
+exports.readPoToolSurface = require_toolSurface.readPoToolSurface;
+exports.requirePoToolSurface = require_toolSurface.requirePoToolSurface;

package/dist/toolSurface.d.mts

@@ -1,3 +1,3 @@
-import { DOOM_TOOL_SURFACE_SERVICE, DoomToolRestriction, DoomToolRestrictionDefinition, DoomToolRestrictionHandle, DoomToolSurfaceEntry, DoomToolSurfaceService, readDoomToolSurface, requireDoomToolSurface } from "./src/schemas/toolSurface.mjs";
-import { CreateDoomToolSurfaceOptions, createDoomToolSurface } from "./src/services/toolSurface/index.mjs";
-export { type CreateDoomToolSurfaceOptions, DOOM_TOOL_SURFACE_SERVICE, type DoomToolRestriction, type DoomToolRestrictionDefinition, type DoomToolRestrictionHandle, type DoomToolSurfaceEntry, type DoomToolSurfaceService, createDoomToolSurface, readDoomToolSurface, requireDoomToolSurface };
+import { PO_TOOL_SURFACE_SERVICE, PoToolRestriction, PoToolRestrictionDefinition, PoToolRestrictionHandle, PoToolSurfaceEntry, PoToolSurfaceService, readPoToolSurface, requirePoToolSurface } from "./src/schemas/toolSurface.mjs";
+import { CreatePoToolSurfaceOptions, createPoToolSurface } from "./src/services/toolSurface/index.mjs";
+export { type CreatePoToolSurfaceOptions, PO_TOOL_SURFACE_SERVICE, type PoToolRestriction, type PoToolRestrictionDefinition, type PoToolRestrictionHandle, type PoToolSurfaceEntry, type PoToolSurfaceService, createPoToolSurface, readPoToolSurface, requirePoToolSurface };

package/dist/toolSurface.mjs

@@ -1,3 +1,3 @@
-import { DOOM_TOOL_SURFACE_SERVICE, readDoomToolSurface, requireDoomToolSurface } from "./src/schemas/toolSurface.mjs";
-import { createDoomToolSurface } from "./src/services/toolSurface/index.mjs";
-export { DOOM_TOOL_SURFACE_SERVICE, createDoomToolSurface, readDoomToolSurface, requireDoomToolSurface };
+import { PO_TOOL_SURFACE_SERVICE, readPoToolSurface, requirePoToolSurface } from "./src/schemas/toolSurface.mjs";
+import { createPoToolSurface } from "./src/services/toolSurface/index.mjs";
+export { PO_TOOL_SURFACE_SERVICE, createPoToolSurface, readPoToolSurface, requirePoToolSurface };

package/dist/transition.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtimeTransition = require("./runtimeTransition.cjs");
-exports.DOOM_TRANSITION_SERVICE = require_runtimeTransition.DOOM_TRANSITION_SERVICE;
-exports.readDoomTransitionCoordinator = require_runtimeTransition.readDoomTransitionCoordinator;
-exports.requireDoomTransitionCoordinator = require_runtimeTransition.requireDoomTransitionCoordinator;
+exports.PO_TRANSITION_SERVICE = require_runtimeTransition.PO_TRANSITION_SERVICE;
+exports.readPoTransitionCoordinator = require_runtimeTransition.readPoTransitionCoordinator;
+exports.requirePoTransitionCoordinator = require_runtimeTransition.requirePoTransitionCoordinator;

package/dist/transition.d.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtimeTransition = require("./runtimeTransition.cjs");
-exports.DOOM_TRANSITION_SERVICE = require_runtimeTransition.DOOM_TRANSITION_SERVICE;
-exports.readDoomTransitionCoordinator = require_runtimeTransition.readDoomTransitionCoordinator;
-exports.requireDoomTransitionCoordinator = require_runtimeTransition.requireDoomTransitionCoordinator;
+exports.PO_TRANSITION_SERVICE = require_runtimeTransition.PO_TRANSITION_SERVICE;
+exports.readPoTransitionCoordinator = require_runtimeTransition.readPoTransitionCoordinator;
+exports.requirePoTransitionCoordinator = require_runtimeTransition.requirePoTransitionCoordinator;

package/dist/transition.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_TRANSITION_SERVICE, DomainTransitionTarget, DoomTransitionCoordinator, DoomTransitionPlan, DoomTransitionRequest, DoomTransitionResult, LiveTransitionTarget, MajorModeTransitionTarget, ProfileTransitionTarget, StructuralTransitionExecution, TransitionAxis, TransitionDiagnosticCode, TransitionDisposition, TransitionExecutionStrategy, TransitionGeneration, TransitionOutcome, TransitionSelectionSnapshot, TransitionSource, TransitionSynchronization, TransitionTarget, readDoomTransitionCoordinator, requireDoomTransitionCoordinator } from "./runtimeTransition.mjs";
-export { DOOM_TRANSITION_SERVICE, type DomainTransitionTarget, type DoomTransitionCoordinator, type DoomTransitionPlan, type DoomTransitionRequest, type DoomTransitionResult, type LiveTransitionTarget, type MajorModeTransitionTarget, type ProfileTransitionTarget, type StructuralTransitionExecution, type TransitionAxis, type TransitionDiagnosticCode, type TransitionDisposition, type TransitionExecutionStrategy, type TransitionGeneration, type TransitionOutcome, type TransitionSelectionSnapshot, type TransitionSource, type TransitionSynchronization, type TransitionTarget, readDoomTransitionCoordinator, requireDoomTransitionCoordinator };
+import { DomainTransitionTarget, LiveTransitionTarget, MajorModeTransitionTarget, PO_TRANSITION_SERVICE, PoTransitionCoordinator, PoTransitionPlan, PoTransitionRequest, PoTransitionResult, ProfileTransitionTarget, StructuralTransitionExecution, TransitionAxis, TransitionDiagnosticCode, TransitionDisposition, TransitionExecutionStrategy, TransitionGeneration, TransitionOutcome, TransitionSelectionSnapshot, TransitionSource, TransitionSynchronization, TransitionTarget, readPoTransitionCoordinator, requirePoTransitionCoordinator } from "./runtimeTransition.mjs";
+export { type DomainTransitionTarget, type LiveTransitionTarget, type MajorModeTransitionTarget, PO_TRANSITION_SERVICE, type PoTransitionCoordinator, type PoTransitionPlan, type PoTransitionRequest, type PoTransitionResult, type ProfileTransitionTarget, type StructuralTransitionExecution, type TransitionAxis, type TransitionDiagnosticCode, type TransitionDisposition, type TransitionExecutionStrategy, type TransitionGeneration, type TransitionOutcome, type TransitionSelectionSnapshot, type TransitionSource, type TransitionSynchronization, type TransitionTarget, readPoTransitionCoordinator, requirePoTransitionCoordinator };

package/dist/transition.mjs

@@ -1,2 +1 @@
-import { DOOM_TRANSITION_SERVICE, readDoomTransitionCoordinator, requireDoomTransitionCoordinator } from "./runtimeTransition.mjs";
-export { DOOM_TRANSITION_SERVICE, readDoomTransitionCoordinator, requireDoomTransitionCoordinator };
+export { PO_TRANSITION_SERVICE, readPoTransitionCoordinator, requirePoTransitionCoordinator } from "./runtimeTransition.mjs";

package/dist/transitionClassifier.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transitionClassifier.cjs","names":[],"sources":["../src/services/transitionClassifier/index.ts"],"sourcesContent":["import type {\n  DoomTransitionPlan,\n  DoomTransitionRequest,\n  TransitionDiagnosticCode,\n  TransitionDisposition,\n  TransitionExecutionStrategy,\n  TransitionSelectionSnapshot,\n  TransitionSynchronization,\n} from '../../exports/transition';\n\nexport interface TransitionCompositionResolution {\n  readonly fingerprint: string;\n  readonly parentActivation: readonly string[];\n  readonly childActivation: readonly string[];\n}\n\nexport interface TransitionClassifierContext {\n  readonly current: TransitionSelectionSnapshot;\n  readonly resolveLayers: (majorMode: string) => readonly string[];\n  readonly extensionLayers: (layers: readonly string[]) => readonly string[];\n  readonly synchronization: TransitionSynchronization;\n  readonly resolveComposition?: (selection: TransitionSelectionSnapshot) => TransitionCompositionResolution | undefined;\n}\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction copySnapshot(snapshot: TransitionSelectionSnapshot): TransitionSelectionSnapshot {\n  return {\n    ...snapshot,\n    domains: [...snapshot.domains],\n    layers: [...snapshot.layers],\n    ...(snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {}),\n    ...(snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}),\n  };\n}\n\nfunction plan(\n  request: DoomTransitionRequest,\n  disposition: TransitionDisposition,\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  diagnostic: TransitionDiagnosticCode,\n  strategy?: TransitionExecutionStrategy,\n): DoomTransitionPlan {\n  return {\n    operationId: request.operationId,\n    axis: request.target.axis,\n    disposition,\n    ...(strategy ? { strategy } : {}),\n    previous,\n    candidate,\n    diagnostics: [diagnostic],\n    reloadHandoffRequired: disposition === 'reload' || disposition === 'relaunch',\n    externalRelaunchRequired: disposition === 'relaunch',\n  };\n}\n\nfunction withComposition(\n  candidate: TransitionSelectionSnapshot,\n  context: TransitionClassifierContext,\n): TransitionSelectionSnapshot {\n  const composition = context.resolveComposition?.(candidate);\n  if (!composition) return candidate;\n  return {\n    ...candidate,\n    compositionFingerprint: composition.fingerprint,\n    parentActivation: [...composition.parentActivation],\n    childActivation: [...composition.childActivation],\n  };\n}\n\nfunction launcherNeedsRelaunch(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n): boolean {\n  if (previous.parentActivation && candidate.parentActivation) {\n    return !sameStrings(previous.parentActivation, candidate.parentActivation);\n  }\n  return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));\n}\n\nfunction majorModeDisposition(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  synchronization: TransitionSynchronization,\n): {\n  disposition: TransitionDisposition;\n  diagnostic: TransitionDiagnosticCode;\n  strategy?: TransitionExecutionStrategy;\n} {\n  // The entry composes from live selection on every load, so any candidate is\n  // reachable: a built aggregate when one exists, the individual entries when\n  // it does not. Nothing here can be sync-required.\n  if (synchronization.kind === 'launcher-composed') {\n    return { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n  }\n  if (synchronization.kind === 'synchronized') {\n    if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.resolution',\n      };\n    }\n    if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.artifact',\n      };\n    }\n    return {\n      disposition: 'reload',\n      diagnostic: 'transition.reload.major-mode',\n      strategy: 'pi-reload',\n    };\n  }\n  return launcherNeedsRelaunch(extensionLayers, previous, candidate)\n    ? {\n        disposition: 'relaunch',\n        diagnostic: 'transition.relaunch.extension-closure',\n        strategy: 'process-relaunch',\n      }\n    : { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n}\n\nexport function classifyTransition(\n  request: DoomTransitionRequest,\n  context: TransitionClassifierContext,\n): DoomTransitionPlan {\n  const previous = copySnapshot(context.current);\n\n  switch (request.target.axis) {\n    case 'live':\n      return plan(request, 'live', previous, copySnapshot(previous), 'transition.live.capability');\n    case 'domains': {\n      const candidate = { ...copySnapshot(previous), domains: [...request.target.domains] };\n      if (sameStrings(previous.domains, candidate.domains)) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.domains', 'pi-reload');\n    }\n    case 'profile': {\n      const candidate = { ...copySnapshot(previous), profile: request.target.profile };\n      if (previous.profile === candidate.profile) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.profile', 'pi-reload');\n    }\n    case 'major-mode': {\n      const candidateLayers = context.resolveLayers(request.target.majorMode);\n      const candidate = withComposition(\n        {\n          ...copySnapshot(previous),\n          majorMode: request.target.majorMode,\n          layers: candidateLayers,\n          compositionFingerprint: undefined,\n          parentActivation: undefined,\n          childActivation: undefined,\n        },\n        context,\n      );\n      if (\n        (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers)) ||\n        (previous.compositionFingerprint !== undefined &&\n          previous.compositionFingerprint === candidate.compositionFingerprint)\n      ) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      const classification = majorModeDisposition(\n        context.extensionLayers,\n        previous,\n        candidate,\n        context.synchronization,\n      );\n      return plan(\n        request,\n        classification.disposition,\n        previous,\n        candidate,\n        classification.diagnostic,\n        classification.strategy,\n      );\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"transitionClassifier.cjs","names":[],"sources":["../src/services/transitionClassifier/index.ts"],"sourcesContent":["import type {\n  PoTransitionPlan,\n  PoTransitionRequest,\n  TransitionDiagnosticCode,\n  TransitionDisposition,\n  TransitionExecutionStrategy,\n  TransitionSelectionSnapshot,\n  TransitionSynchronization,\n} from '../../exports/transition';\n\nexport interface TransitionCompositionResolution {\n  readonly fingerprint: string;\n  readonly parentActivation: readonly string[];\n  readonly childActivation: readonly string[];\n}\n\nexport interface TransitionClassifierContext {\n  readonly current: TransitionSelectionSnapshot;\n  readonly resolveLayers: (majorMode: string) => readonly string[];\n  readonly extensionLayers: (layers: readonly string[]) => readonly string[];\n  readonly synchronization: TransitionSynchronization;\n  readonly resolveComposition?: (selection: TransitionSelectionSnapshot) => TransitionCompositionResolution | undefined;\n}\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction copySnapshot(snapshot: TransitionSelectionSnapshot): TransitionSelectionSnapshot {\n  return {\n    ...snapshot,\n    domains: [...snapshot.domains],\n    layers: [...snapshot.layers],\n    ...(snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {}),\n    ...(snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}),\n  };\n}\n\nfunction plan(\n  request: PoTransitionRequest,\n  disposition: TransitionDisposition,\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  diagnostic: TransitionDiagnosticCode,\n  strategy?: TransitionExecutionStrategy,\n): PoTransitionPlan {\n  return {\n    operationId: request.operationId,\n    axis: request.target.axis,\n    disposition,\n    ...(strategy ? { strategy } : {}),\n    previous,\n    candidate,\n    diagnostics: [diagnostic],\n    reloadHandoffRequired: disposition === 'reload' || disposition === 'relaunch',\n    externalRelaunchRequired: disposition === 'relaunch',\n  };\n}\n\nfunction withComposition(\n  candidate: TransitionSelectionSnapshot,\n  context: TransitionClassifierContext,\n): TransitionSelectionSnapshot {\n  const composition = context.resolveComposition?.(candidate);\n  if (!composition) return candidate;\n  return {\n    ...candidate,\n    compositionFingerprint: composition.fingerprint,\n    parentActivation: [...composition.parentActivation],\n    childActivation: [...composition.childActivation],\n  };\n}\n\nfunction launcherNeedsRelaunch(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n): boolean {\n  if (previous.parentActivation && candidate.parentActivation) {\n    return !sameStrings(previous.parentActivation, candidate.parentActivation);\n  }\n  return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));\n}\n\nfunction majorModeDisposition(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  synchronization: TransitionSynchronization,\n): {\n  disposition: TransitionDisposition;\n  diagnostic: TransitionDiagnosticCode;\n  strategy?: TransitionExecutionStrategy;\n} {\n  // The entry composes from live selection on every load, so any candidate is\n  // reachable: a built aggregate when one exists, the individual entries when\n  // it does not. Nothing here can be sync-required.\n  if (synchronization.kind === 'launcher-composed') {\n    return { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n  }\n  if (synchronization.kind === 'synchronized') {\n    if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.resolution',\n      };\n    }\n    if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.artifact',\n      };\n    }\n    return {\n      disposition: 'reload',\n      diagnostic: 'transition.reload.major-mode',\n      strategy: 'pi-reload',\n    };\n  }\n  return launcherNeedsRelaunch(extensionLayers, previous, candidate)\n    ? {\n        disposition: 'relaunch',\n        diagnostic: 'transition.relaunch.extension-closure',\n        strategy: 'process-relaunch',\n      }\n    : { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n}\n\nexport function classifyTransition(\n  request: PoTransitionRequest,\n  context: TransitionClassifierContext,\n): PoTransitionPlan {\n  const previous = copySnapshot(context.current);\n\n  switch (request.target.axis) {\n    case 'live':\n      return plan(request, 'live', previous, copySnapshot(previous), 'transition.live.capability');\n    case 'domains': {\n      const candidate = { ...copySnapshot(previous), domains: [...request.target.domains] };\n      if (sameStrings(previous.domains, candidate.domains)) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.domains', 'pi-reload');\n    }\n    case 'profile': {\n      const candidate = { ...copySnapshot(previous), profile: request.target.profile };\n      if (previous.profile === candidate.profile) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.profile', 'pi-reload');\n    }\n    case 'major-mode': {\n      const candidateLayers = context.resolveLayers(request.target.majorMode);\n      const candidate = withComposition(\n        {\n          ...copySnapshot(previous),\n          majorMode: request.target.majorMode,\n          layers: candidateLayers,\n          compositionFingerprint: undefined,\n          parentActivation: undefined,\n          childActivation: undefined,\n        },\n        context,\n      );\n      if (\n        (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers)) ||\n        (previous.compositionFingerprint !== undefined &&\n          previous.compositionFingerprint === candidate.compositionFingerprint)\n      ) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      const classification = majorModeDisposition(\n        context.extensionLayers,\n        previous,\n        candidate,\n        context.synchronization,\n      );\n      return plan(\n        request,\n        classification.disposition,\n        previous,\n        candidate,\n        classification.diagnostic,\n        classification.strategy,\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/transitionClassifier.d.mts

@@ -1,4 +1,4 @@
-import { DoomTransitionPlan, DoomTransitionRequest, TransitionSelectionSnapshot, TransitionSynchronization } from "./runtimeTransition.mjs";
+import { PoTransitionPlan, PoTransitionRequest, TransitionSelectionSnapshot, TransitionSynchronization } from "./runtimeTransition.mjs";
 import "./transition.mjs";
 //#region src/services/transitionClassifier/index.d.ts
 export interface TransitionCompositionResolution {
@@ -13,6 +13,6 @@ export interface TransitionClassifierContext {
   readonly synchronization: TransitionSynchronization;
   readonly resolveComposition?: (selection: TransitionSelectionSnapshot) => TransitionCompositionResolution | undefined;
 }
-export declare function classifyTransition(request: DoomTransitionRequest, context: TransitionClassifierContext): DoomTransitionPlan;
+export declare function classifyTransition(request: PoTransitionRequest, context: TransitionClassifierContext): PoTransitionPlan;
 //#endregion
 //# sourceMappingURL=transitionClassifier.d.mts.map

package/dist/transitionClassifier.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"transitionClassifier.d.mts","names":[],"sources":["../src/services/transitionClassifier/index.ts"],"mappings":";;;iBAUiB;WACN;WACA;WACA;;iBAGM;WACN,SAAS;WACT,gBAAgB;WAChB,kBAAkB;WAClB,iBAAiB;WACjB,sBAAsB,WAAW,gCAAgC;;wBA2G5D,mBACd,SAAS,uBACT,SAAS,8BACR"}
+{"version":3,"file":"transitionClassifier.d.mts","names":[],"sources":["../src/services/transitionClassifier/index.ts"],"mappings":";;;iBAUiB;WACN;WACA;WACA;;iBAGM;WACN,SAAS;WACT,gBAAgB;WAChB,kBAAkB;WAClB,iBAAiB;WACjB,sBAAsB,WAAW,gCAAgC;;wBA2G5D,mBACd,SAAS,qBACT,SAAS,8BACR"}

package/dist/transitionClassifier.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transitionClassifier.mjs","names":[],"sources":["../src/services/transitionClassifier/index.ts"],"sourcesContent":["import type {\n  DoomTransitionPlan,\n  DoomTransitionRequest,\n  TransitionDiagnosticCode,\n  TransitionDisposition,\n  TransitionExecutionStrategy,\n  TransitionSelectionSnapshot,\n  TransitionSynchronization,\n} from '../../exports/transition';\n\nexport interface TransitionCompositionResolution {\n  readonly fingerprint: string;\n  readonly parentActivation: readonly string[];\n  readonly childActivation: readonly string[];\n}\n\nexport interface TransitionClassifierContext {\n  readonly current: TransitionSelectionSnapshot;\n  readonly resolveLayers: (majorMode: string) => readonly string[];\n  readonly extensionLayers: (layers: readonly string[]) => readonly string[];\n  readonly synchronization: TransitionSynchronization;\n  readonly resolveComposition?: (selection: TransitionSelectionSnapshot) => TransitionCompositionResolution | undefined;\n}\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction copySnapshot(snapshot: TransitionSelectionSnapshot): TransitionSelectionSnapshot {\n  return {\n    ...snapshot,\n    domains: [...snapshot.domains],\n    layers: [...snapshot.layers],\n    ...(snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {}),\n    ...(snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}),\n  };\n}\n\nfunction plan(\n  request: DoomTransitionRequest,\n  disposition: TransitionDisposition,\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  diagnostic: TransitionDiagnosticCode,\n  strategy?: TransitionExecutionStrategy,\n): DoomTransitionPlan {\n  return {\n    operationId: request.operationId,\n    axis: request.target.axis,\n    disposition,\n    ...(strategy ? { strategy } : {}),\n    previous,\n    candidate,\n    diagnostics: [diagnostic],\n    reloadHandoffRequired: disposition === 'reload' || disposition === 'relaunch',\n    externalRelaunchRequired: disposition === 'relaunch',\n  };\n}\n\nfunction withComposition(\n  candidate: TransitionSelectionSnapshot,\n  context: TransitionClassifierContext,\n): TransitionSelectionSnapshot {\n  const composition = context.resolveComposition?.(candidate);\n  if (!composition) return candidate;\n  return {\n    ...candidate,\n    compositionFingerprint: composition.fingerprint,\n    parentActivation: [...composition.parentActivation],\n    childActivation: [...composition.childActivation],\n  };\n}\n\nfunction launcherNeedsRelaunch(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n): boolean {\n  if (previous.parentActivation && candidate.parentActivation) {\n    return !sameStrings(previous.parentActivation, candidate.parentActivation);\n  }\n  return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));\n}\n\nfunction majorModeDisposition(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  synchronization: TransitionSynchronization,\n): {\n  disposition: TransitionDisposition;\n  diagnostic: TransitionDiagnosticCode;\n  strategy?: TransitionExecutionStrategy;\n} {\n  // The entry composes from live selection on every load, so any candidate is\n  // reachable: a built aggregate when one exists, the individual entries when\n  // it does not. Nothing here can be sync-required.\n  if (synchronization.kind === 'launcher-composed') {\n    return { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n  }\n  if (synchronization.kind === 'synchronized') {\n    if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.resolution',\n      };\n    }\n    if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.artifact',\n      };\n    }\n    return {\n      disposition: 'reload',\n      diagnostic: 'transition.reload.major-mode',\n      strategy: 'pi-reload',\n    };\n  }\n  return launcherNeedsRelaunch(extensionLayers, previous, candidate)\n    ? {\n        disposition: 'relaunch',\n        diagnostic: 'transition.relaunch.extension-closure',\n        strategy: 'process-relaunch',\n      }\n    : { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n}\n\nexport function classifyTransition(\n  request: DoomTransitionRequest,\n  context: TransitionClassifierContext,\n): DoomTransitionPlan {\n  const previous = copySnapshot(context.current);\n\n  switch (request.target.axis) {\n    case 'live':\n      return plan(request, 'live', previous, copySnapshot(previous), 'transition.live.capability');\n    case 'domains': {\n      const candidate = { ...copySnapshot(previous), domains: [...request.target.domains] };\n      if (sameStrings(previous.domains, candidate.domains)) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.domains', 'pi-reload');\n    }\n    case 'profile': {\n      const candidate = { ...copySnapshot(previous), profile: request.target.profile };\n      if (previous.profile === candidate.profile) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.profile', 'pi-reload');\n    }\n    case 'major-mode': {\n      const candidateLayers = context.resolveLayers(request.target.majorMode);\n      const candidate = withComposition(\n        {\n          ...copySnapshot(previous),\n          majorMode: request.target.majorMode,\n          layers: candidateLayers,\n          compositionFingerprint: undefined,\n          parentActivation: undefined,\n          childActivation: undefined,\n        },\n        context,\n      );\n      if (\n        (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers)) ||\n        (previous.compositionFingerprint !== undefined &&\n          previous.compositionFingerprint === candidate.compositionFingerprint)\n      ) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      const classification = majorModeDisposition(\n        context.extensionLayers,\n        previous,\n        candidate,\n        context.synchronization,\n      );\n      return plan(\n        request,\n        classification.disposition,\n        previous,\n        candidate,\n        classification.diagnostic,\n        classification.strategy,\n      );\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"transitionClassifier.mjs","names":[],"sources":["../src/services/transitionClassifier/index.ts"],"sourcesContent":["import type {\n  PoTransitionPlan,\n  PoTransitionRequest,\n  TransitionDiagnosticCode,\n  TransitionDisposition,\n  TransitionExecutionStrategy,\n  TransitionSelectionSnapshot,\n  TransitionSynchronization,\n} from '../../exports/transition';\n\nexport interface TransitionCompositionResolution {\n  readonly fingerprint: string;\n  readonly parentActivation: readonly string[];\n  readonly childActivation: readonly string[];\n}\n\nexport interface TransitionClassifierContext {\n  readonly current: TransitionSelectionSnapshot;\n  readonly resolveLayers: (majorMode: string) => readonly string[];\n  readonly extensionLayers: (layers: readonly string[]) => readonly string[];\n  readonly synchronization: TransitionSynchronization;\n  readonly resolveComposition?: (selection: TransitionSelectionSnapshot) => TransitionCompositionResolution | undefined;\n}\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction copySnapshot(snapshot: TransitionSelectionSnapshot): TransitionSelectionSnapshot {\n  return {\n    ...snapshot,\n    domains: [...snapshot.domains],\n    layers: [...snapshot.layers],\n    ...(snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {}),\n    ...(snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}),\n  };\n}\n\nfunction plan(\n  request: PoTransitionRequest,\n  disposition: TransitionDisposition,\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  diagnostic: TransitionDiagnosticCode,\n  strategy?: TransitionExecutionStrategy,\n): PoTransitionPlan {\n  return {\n    operationId: request.operationId,\n    axis: request.target.axis,\n    disposition,\n    ...(strategy ? { strategy } : {}),\n    previous,\n    candidate,\n    diagnostics: [diagnostic],\n    reloadHandoffRequired: disposition === 'reload' || disposition === 'relaunch',\n    externalRelaunchRequired: disposition === 'relaunch',\n  };\n}\n\nfunction withComposition(\n  candidate: TransitionSelectionSnapshot,\n  context: TransitionClassifierContext,\n): TransitionSelectionSnapshot {\n  const composition = context.resolveComposition?.(candidate);\n  if (!composition) return candidate;\n  return {\n    ...candidate,\n    compositionFingerprint: composition.fingerprint,\n    parentActivation: [...composition.parentActivation],\n    childActivation: [...composition.childActivation],\n  };\n}\n\nfunction launcherNeedsRelaunch(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n): boolean {\n  if (previous.parentActivation && candidate.parentActivation) {\n    return !sameStrings(previous.parentActivation, candidate.parentActivation);\n  }\n  return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));\n}\n\nfunction majorModeDisposition(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  synchronization: TransitionSynchronization,\n): {\n  disposition: TransitionDisposition;\n  diagnostic: TransitionDiagnosticCode;\n  strategy?: TransitionExecutionStrategy;\n} {\n  // The entry composes from live selection on every load, so any candidate is\n  // reachable: a built aggregate when one exists, the individual entries when\n  // it does not. Nothing here can be sync-required.\n  if (synchronization.kind === 'launcher-composed') {\n    return { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n  }\n  if (synchronization.kind === 'synchronized') {\n    if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.resolution',\n      };\n    }\n    if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.artifact',\n      };\n    }\n    return {\n      disposition: 'reload',\n      diagnostic: 'transition.reload.major-mode',\n      strategy: 'pi-reload',\n    };\n  }\n  return launcherNeedsRelaunch(extensionLayers, previous, candidate)\n    ? {\n        disposition: 'relaunch',\n        diagnostic: 'transition.relaunch.extension-closure',\n        strategy: 'process-relaunch',\n      }\n    : { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n}\n\nexport function classifyTransition(\n  request: PoTransitionRequest,\n  context: TransitionClassifierContext,\n): PoTransitionPlan {\n  const previous = copySnapshot(context.current);\n\n  switch (request.target.axis) {\n    case 'live':\n      return plan(request, 'live', previous, copySnapshot(previous), 'transition.live.capability');\n    case 'domains': {\n      const candidate = { ...copySnapshot(previous), domains: [...request.target.domains] };\n      if (sameStrings(previous.domains, candidate.domains)) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.domains', 'pi-reload');\n    }\n    case 'profile': {\n      const candidate = { ...copySnapshot(previous), profile: request.target.profile };\n      if (previous.profile === candidate.profile) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.profile', 'pi-reload');\n    }\n    case 'major-mode': {\n      const candidateLayers = context.resolveLayers(request.target.majorMode);\n      const candidate = withComposition(\n        {\n          ...copySnapshot(previous),\n          majorMode: request.target.majorMode,\n          layers: candidateLayers,\n          compositionFingerprint: undefined,\n          parentActivation: undefined,\n          childActivation: undefined,\n        },\n        context,\n      );\n      if (\n        (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers)) ||\n        (previous.compositionFingerprint !== undefined &&\n          previous.compositionFingerprint === candidate.compositionFingerprint)\n      ) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      const classification = majorModeDisposition(\n        context.extensionLayers,\n        previous,\n        candidate,\n        context.synchronization,\n      );\n      return plan(\n        request,\n        classification.disposition,\n        previous,\n        candidate,\n        classification.diagnostic,\n        classification.strategy,\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/transitionCoordinator.cjs

@@ -25,8 +25,8 @@ function generationDiagnostic(expected, current) {
 	if (expected.hostGeneration !== current.hostGeneration) return STALE_GENERATION_DIAGNOSTIC;
 	if (expected.configGeneration !== current.configGeneration) return "transition.stale.config";
 }
-function createDoomTransitionCoordinator(options) {
-	const hostGeneration = options.hostGeneration ?? `doom-transition:${crypto.randomUUID()}`;
+function createPoTransitionCoordinator(options) {
+	const hostGeneration = options.hostGeneration ?? `po-transition:${crypto.randomUUID()}`;
 	const readGeneration = options.generation ?? (() => defaultGeneration(options.sessionId, hostGeneration));
 	const operationIds = /* @__PURE__ */ new Set();
 	let committedSelection;
@@ -126,6 +126,6 @@ function createDoomTransitionCoordinator(options) {
 	};
 }
 //#endregion
-exports.createDoomTransitionCoordinator = createDoomTransitionCoordinator;
+exports.createPoTransitionCoordinator = createPoTransitionCoordinator;
 
 //# sourceMappingURL=transitionCoordinator.cjs.map

package/dist/transitionCoordinator.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transitionCoordinator.cjs","names":["classifyTransition"],"sources":["../src/services/transitionCoordinator/index.ts"],"sourcesContent":["import type {\n  DoomTransitionCoordinator,\n  DoomTransitionPlan,\n  DoomTransitionRequest,\n  DoomTransitionResult,\n  StructuralTransitionExecution,\n  TransitionDiagnosticCode,\n  TransitionGeneration,\n  TransitionOutcome,\n} from '../../exports/transition';\nimport { classifyTransition, type TransitionClassifierContext } from '../transitionClassifier';\n\nconst LIVE_AXIS = 'live';\nconst STALE_SESSION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.stale.session';\nconst STALE_GENERATION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.stale.generation';\nconst ABORTED_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.rejected.aborted';\nconst EXECUTION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.rejected.execution';\nconst NO_CHANGE_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.no-change';\n\nexport interface TransitionCoordinatorOptions {\n  readonly sessionId: string;\n  readonly hostGeneration?: string;\n  readonly classifierContext: () => TransitionClassifierContext;\n  /** Captures identities that must remain stable while a transition is queued. */\n  readonly generation?: () => TransitionGeneration;\n  readonly acceptGenerationChange?: (\n    before: TransitionGeneration,\n    after: TransitionGeneration,\n    plan: DoomTransitionPlan,\n  ) => boolean;\n  readonly executeStructural?: (request: DoomTransitionRequest, plan: DoomTransitionPlan) => Promise<TransitionOutcome>;\n}\n\nfunction result(\n  plan: DoomTransitionPlan,\n  outcome: TransitionOutcome,\n  diagnostic?: TransitionDiagnosticCode,\n): DoomTransitionResult {\n  return {\n    ...plan,\n    outcome,\n    diagnostics: diagnostic ? [...plan.diagnostics, diagnostic] : plan.diagnostics,\n  };\n}\n\nfunction defaultGeneration(sessionId: string, hostGeneration: string): TransitionGeneration {\n  return { sessionId, hostGeneration };\n}\n\nfunction generationDiagnostic(\n  expected: TransitionGeneration,\n  current: TransitionGeneration,\n): TransitionDiagnosticCode | undefined {\n  if (expected.sessionId !== current.sessionId) return STALE_SESSION_DIAGNOSTIC;\n  if (expected.hostGeneration !== current.hostGeneration) return STALE_GENERATION_DIAGNOSTIC;\n  if (expected.configGeneration !== current.configGeneration) return 'transition.stale.config';\n  return undefined;\n}\n\nexport function createDoomTransitionCoordinator(options: TransitionCoordinatorOptions): DoomTransitionCoordinator {\n  const hostGeneration = options.hostGeneration ?? `doom-transition:${crypto.randomUUID()}`;\n  const readGeneration = options.generation ?? (() => defaultGeneration(options.sessionId, hostGeneration));\n  const operationIds = new Set<string>();\n  let committedSelection: DoomTransitionPlan['candidate'] | undefined;\n  let structuralTail: Promise<void> = Promise.resolve();\n  let structuralPending = 0;\n  let disposed = false;\n\n  const plan = (request: DoomTransitionRequest): DoomTransitionPlan => {\n    const context = options.classifierContext();\n    const current = {\n      ...(committedSelection ?? context.current),\n    };\n    return classifyTransition(request, { ...context, current });\n  };\n\n  const requestDiagnostic = (request: DoomTransitionRequest): TransitionDiagnosticCode | undefined => {\n    if (request.sessionId !== options.sessionId) return STALE_SESSION_DIAGNOSTIC;\n    if (request.hostGeneration !== hostGeneration) return STALE_GENERATION_DIAGNOSTIC;\n    if (disposed || request.signal?.aborted) return ABORTED_DIAGNOSTIC;\n    if (request.target.axis !== LIVE_AXIS && operationIds.has(request.operationId)) {\n      return 'transition.rejected.duplicate';\n    }\n    return undefined;\n  };\n\n  const executeLive = async (\n    request: DoomTransitionRequest,\n    transitionPlan: DoomTransitionPlan,\n    execution: StructuralTransitionExecution | undefined,\n    expectedGeneration: TransitionGeneration,\n  ): Promise<DoomTransitionResult> => {\n    if (request.target.axis !== LIVE_AXIS) {\n      return result(transitionPlan, 'rejected', EXECUTION_DIAGNOSTIC);\n    }\n    if (!execution) return result(transitionPlan, 'rejected', 'transition.rejected.unavailable');\n    const before = generationDiagnostic(expectedGeneration, readGeneration());\n    if (before) return result(transitionPlan, 'stale', before);\n    try {\n      {\n        const outcome = await execution(request, transitionPlan);\n        const currentGeneration = readGeneration();\n        const after = generationDiagnostic(expectedGeneration, currentGeneration);\n        if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) {\n          return result(transitionPlan, 'stale', after);\n        }\n        return result(transitionPlan, outcome);\n      }\n    } catch {\n      return result(transitionPlan, 'rejected', EXECUTION_DIAGNOSTIC);\n    }\n  };\n\n  const executeStructural = async (\n    request: DoomTransitionRequest,\n    transitionPlan: DoomTransitionPlan,\n    execution: StructuralTransitionExecution | undefined,\n    expectedGeneration: TransitionGeneration,\n  ): Promise<DoomTransitionResult> => {\n    if (disposed || request.signal?.aborted) {\n      return result(transitionPlan, 'rejected', ABORTED_DIAGNOSTIC);\n    }\n    const stale = generationDiagnostic(expectedGeneration, readGeneration());\n    if (stale) return result(transitionPlan, 'stale', stale);\n    if (transitionPlan.disposition === 'sync-required') {\n      return result(transitionPlan, 'rejected');\n    }\n    const selectedExecution = execution ?? options.executeStructural;\n    if (!selectedExecution) {\n      const outcome = transitionPlan.disposition === 'live' ? 'applied' : 'queued';\n      if (outcome === 'applied') committedSelection = transitionPlan.candidate;\n      return result(transitionPlan, outcome);\n    }\n    const outcome = await selectedExecution(request, transitionPlan);\n    const currentGeneration = readGeneration();\n    const after = generationDiagnostic(expectedGeneration, currentGeneration);\n    if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) {\n      return result(transitionPlan, 'stale', after);\n    }\n    if (outcome === 'applied') committedSelection = transitionPlan.candidate;\n    return result(transitionPlan, outcome);\n  };\n\n  return {\n    sessionId: options.sessionId,\n    hostGeneration,\n    plan,\n    async execute(request, execution) {\n      const admission = requestDiagnostic(request);\n      if (admission) {\n        const outcome = admission.startsWith('transition.rejected.') ? 'rejected' : 'stale';\n        return result(plan(request), outcome, admission);\n      }\n      const expectedGeneration = readGeneration();\n      if (expectedGeneration.sessionId !== options.sessionId) {\n        return result(plan(request), 'stale', STALE_SESSION_DIAGNOSTIC);\n      }\n      if (expectedGeneration.hostGeneration !== hostGeneration) {\n        return result(plan(request), 'stale', STALE_GENERATION_DIAGNOSTIC);\n      }\n      if (request.target.axis !== LIVE_AXIS) operationIds.add(request.operationId);\n\n      if (request.target.axis === LIVE_AXIS) {\n        const transitionPlan = plan(request);\n        if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, 'unchanged');\n        return executeLive(request, transitionPlan, execution, expectedGeneration);\n      }\n\n      structuralPending += 1;\n      const queued = structuralTail.then(async () => {\n        const transitionPlan = plan(request);\n        const stale = generationDiagnostic(expectedGeneration, readGeneration());\n        if (stale) return result(transitionPlan, 'stale', stale);\n        if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, 'unchanged');\n        return executeStructural(request, transitionPlan, execution, expectedGeneration);\n      });\n      structuralTail = queued.then(\n        () => undefined,\n        () => undefined,\n      );\n      try {\n        return await queued;\n      } finally {\n        structuralPending -= 1;\n      }\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      committedSelection = undefined;\n      operationIds.clear();\n      if (structuralPending === 0) structuralTail = Promise.resolve();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"transitionCoordinator.cjs","names":["classifyTransition"],"sources":["../src/services/transitionCoordinator/index.ts"],"sourcesContent":["import type {\n  PoTransitionCoordinator,\n  PoTransitionPlan,\n  PoTransitionRequest,\n  PoTransitionResult,\n  StructuralTransitionExecution,\n  TransitionDiagnosticCode,\n  TransitionGeneration,\n  TransitionOutcome,\n} from '../../exports/transition';\nimport { classifyTransition, type TransitionClassifierContext } from '../transitionClassifier';\n\nconst LIVE_AXIS = 'live';\nconst STALE_SESSION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.stale.session';\nconst STALE_GENERATION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.stale.generation';\nconst ABORTED_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.rejected.aborted';\nconst EXECUTION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.rejected.execution';\nconst NO_CHANGE_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.no-change';\n\nexport interface TransitionCoordinatorOptions {\n  readonly sessionId: string;\n  readonly hostGeneration?: string;\n  readonly classifierContext: () => TransitionClassifierContext;\n  /** Captures identities that must remain stable while a transition is queued. */\n  readonly generation?: () => TransitionGeneration;\n  readonly acceptGenerationChange?: (\n    before: TransitionGeneration,\n    after: TransitionGeneration,\n    plan: PoTransitionPlan,\n  ) => boolean;\n  readonly executeStructural?: (request: PoTransitionRequest, plan: PoTransitionPlan) => Promise<TransitionOutcome>;\n}\n\nfunction result(\n  plan: PoTransitionPlan,\n  outcome: TransitionOutcome,\n  diagnostic?: TransitionDiagnosticCode,\n): PoTransitionResult {\n  return {\n    ...plan,\n    outcome,\n    diagnostics: diagnostic ? [...plan.diagnostics, diagnostic] : plan.diagnostics,\n  };\n}\n\nfunction defaultGeneration(sessionId: string, hostGeneration: string): TransitionGeneration {\n  return { sessionId, hostGeneration };\n}\n\nfunction generationDiagnostic(\n  expected: TransitionGeneration,\n  current: TransitionGeneration,\n): TransitionDiagnosticCode | undefined {\n  if (expected.sessionId !== current.sessionId) return STALE_SESSION_DIAGNOSTIC;\n  if (expected.hostGeneration !== current.hostGeneration) return STALE_GENERATION_DIAGNOSTIC;\n  if (expected.configGeneration !== current.configGeneration) return 'transition.stale.config';\n  return undefined;\n}\n\nexport function createPoTransitionCoordinator(options: TransitionCoordinatorOptions): PoTransitionCoordinator {\n  const hostGeneration = options.hostGeneration ?? `po-transition:${crypto.randomUUID()}`;\n  const readGeneration = options.generation ?? (() => defaultGeneration(options.sessionId, hostGeneration));\n  const operationIds = new Set<string>();\n  let committedSelection: PoTransitionPlan['candidate'] | undefined;\n  let structuralTail: Promise<void> = Promise.resolve();\n  let structuralPending = 0;\n  let disposed = false;\n\n  const plan = (request: PoTransitionRequest): PoTransitionPlan => {\n    const context = options.classifierContext();\n    const current = {\n      ...(committedSelection ?? context.current),\n    };\n    return classifyTransition(request, { ...context, current });\n  };\n\n  const requestDiagnostic = (request: PoTransitionRequest): TransitionDiagnosticCode | undefined => {\n    if (request.sessionId !== options.sessionId) return STALE_SESSION_DIAGNOSTIC;\n    if (request.hostGeneration !== hostGeneration) return STALE_GENERATION_DIAGNOSTIC;\n    if (disposed || request.signal?.aborted) return ABORTED_DIAGNOSTIC;\n    if (request.target.axis !== LIVE_AXIS && operationIds.has(request.operationId)) {\n      return 'transition.rejected.duplicate';\n    }\n    return undefined;\n  };\n\n  const executeLive = async (\n    request: PoTransitionRequest,\n    transitionPlan: PoTransitionPlan,\n    execution: StructuralTransitionExecution | undefined,\n    expectedGeneration: TransitionGeneration,\n  ): Promise<PoTransitionResult> => {\n    if (request.target.axis !== LIVE_AXIS) {\n      return result(transitionPlan, 'rejected', EXECUTION_DIAGNOSTIC);\n    }\n    if (!execution) return result(transitionPlan, 'rejected', 'transition.rejected.unavailable');\n    const before = generationDiagnostic(expectedGeneration, readGeneration());\n    if (before) return result(transitionPlan, 'stale', before);\n    try {\n      {\n        const outcome = await execution(request, transitionPlan);\n        const currentGeneration = readGeneration();\n        const after = generationDiagnostic(expectedGeneration, currentGeneration);\n        if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) {\n          return result(transitionPlan, 'stale', after);\n        }\n        return result(transitionPlan, outcome);\n      }\n    } catch {\n      return result(transitionPlan, 'rejected', EXECUTION_DIAGNOSTIC);\n    }\n  };\n\n  const executeStructural = async (\n    request: PoTransitionRequest,\n    transitionPlan: PoTransitionPlan,\n    execution: StructuralTransitionExecution | undefined,\n    expectedGeneration: TransitionGeneration,\n  ): Promise<PoTransitionResult> => {\n    if (disposed || request.signal?.aborted) {\n      return result(transitionPlan, 'rejected', ABORTED_DIAGNOSTIC);\n    }\n    const stale = generationDiagnostic(expectedGeneration, readGeneration());\n    if (stale) return result(transitionPlan, 'stale', stale);\n    if (transitionPlan.disposition === 'sync-required') {\n      return result(transitionPlan, 'rejected');\n    }\n    const selectedExecution = execution ?? options.executeStructural;\n    if (!selectedExecution) {\n      const outcome = transitionPlan.disposition === 'live' ? 'applied' : 'queued';\n      if (outcome === 'applied') committedSelection = transitionPlan.candidate;\n      return result(transitionPlan, outcome);\n    }\n    const outcome = await selectedExecution(request, transitionPlan);\n    const currentGeneration = readGeneration();\n    const after = generationDiagnostic(expectedGeneration, currentGeneration);\n    if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) {\n      return result(transitionPlan, 'stale', after);\n    }\n    if (outcome === 'applied') committedSelection = transitionPlan.candidate;\n    return result(transitionPlan, outcome);\n  };\n\n  return {\n    sessionId: options.sessionId,\n    hostGeneration,\n    plan,\n    async execute(request, execution) {\n      const admission = requestDiagnostic(request);\n      if (admission) {\n        const outcome = admission.startsWith('transition.rejected.') ? 'rejected' : 'stale';\n        return result(plan(request), outcome, admission);\n      }\n      const expectedGeneration = readGeneration();\n      if (expectedGeneration.sessionId !== options.sessionId) {\n        return result(plan(request), 'stale', STALE_SESSION_DIAGNOSTIC);\n      }\n      if (expectedGeneration.hostGeneration !== hostGeneration) {\n        return result(plan(request), 'stale', STALE_GENERATION_DIAGNOSTIC);\n      }\n      if (request.target.axis !== LIVE_AXIS) operationIds.add(request.operationId);\n\n      if (request.target.axis === LIVE_AXIS) {\n        const transitionPlan = plan(request);\n        if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, 'unchanged');\n        return executeLive(request, transitionPlan, execution, expectedGeneration);\n      }\n\n      structuralPending += 1;\n      const queued = structuralTail.then(async () => {\n        const transitionPlan = plan(request);\n        const stale = generationDiagnostic(expectedGeneration, readGeneration());\n        if (stale) return result(transitionPlan, 'stale', stale);\n        if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, 'unchanged');\n        return executeStructural(request, transitionPlan, execution, expectedGeneration);\n      });\n      structuralTail = queued.then(\n        () => undefined,\n        () => undefined,\n      );\n      try {\n        return await queued;\n      } finally {\n        structuralPending -= 1;\n      }\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      committedSelection = undefined;\n      operationIds.clear();\n      if (structuralPending === 0) structuralTail = Promise.resolve();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/transitionCoordinator.d.mts

@@ -1,4 +1,4 @@
-import { DoomTransitionCoordinator, DoomTransitionPlan, DoomTransitionRequest, TransitionGeneration, TransitionOutcome } from "./runtimeTransition.mjs";
+import { PoTransitionCoordinator, PoTransitionPlan, PoTransitionRequest, TransitionGeneration, TransitionOutcome } from "./runtimeTransition.mjs";
 import "./transition.mjs";
 import { TransitionClassifierContext } from "./transitionClassifier.mjs";
 //#region src/services/transitionCoordinator/index.d.ts
@@ -8,9 +8,9 @@ export interface TransitionCoordinatorOptions {
   readonly classifierContext: () => TransitionClassifierContext;
   /** Captures identities that must remain stable while a transition is queued. */
   readonly generation?: () => TransitionGeneration;
-  readonly acceptGenerationChange?: (before: TransitionGeneration, after: TransitionGeneration, plan: DoomTransitionPlan) => boolean;
-  readonly executeStructural?: (request: DoomTransitionRequest, plan: DoomTransitionPlan) => Promise<TransitionOutcome>;
+  readonly acceptGenerationChange?: (before: TransitionGeneration, after: TransitionGeneration, plan: PoTransitionPlan) => boolean;
+  readonly executeStructural?: (request: PoTransitionRequest, plan: PoTransitionPlan) => Promise<TransitionOutcome>;
 }
-export declare function createDoomTransitionCoordinator(options: TransitionCoordinatorOptions): DoomTransitionCoordinator;
+export declare function createPoTransitionCoordinator(options: TransitionCoordinatorOptions): PoTransitionCoordinator;
 //#endregion
 //# sourceMappingURL=transitionCoordinator.d.mts.map

package/dist/transitionCoordinator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"transitionCoordinator.d.mts","names":[],"sources":["../src/services/transitionCoordinator/index.ts"],"mappings":";;;;iBAmBiB;WACN;WACA;WACA,yBAAyB;;WAEzB,mBAAmB;WACnB,0BACP,QAAQ,sBACR,OAAO,sBACP,MAAM;WAEC,qBAAqB,SAAS,uBAAuB,MAAM,uBAAuB,QAAQ;;wBA6BrF,gCAAgC,SAAS,+BAA+B"}
+{"version":3,"file":"transitionCoordinator.d.mts","names":[],"sources":["../src/services/transitionCoordinator/index.ts"],"mappings":";;;;iBAmBiB;WACN;WACA;WACA,yBAAyB;;WAEzB,mBAAmB;WACnB,0BACP,QAAQ,sBACR,OAAO,sBACP,MAAM;WAEC,qBAAqB,SAAS,qBAAqB,MAAM,qBAAqB,QAAQ;;wBA6BjF,8BAA8B,SAAS,+BAA+B"}