@agimon-ai/po-core 0.0.0-alpha.0

package/dist/toolInventory.mjs

@@ -0,0 +1,133 @@
+import { tokensForSource, tokensForTool } from "./src/services/toolCost/index.mjs";
+//#region src/services/toolInventory/index.ts
+/** Pi tags its own tools with this source; everything else came from an extension. */
+const BUILTIN_SOURCE = "builtin";
+/** Pi's structural tags for an extension path, neither of which is a package name. */
+const CLI_SOURCE = "cli";
+const LOCAL_SOURCE = "local";
+const CORE_KEY = "core";
+const CORE_NAME = "pi";
+const MCP_KEY_PREFIX = "mcp:";
+/** Labels read name first, then kind, because the name is what the eye scans for. */
+const KIND_SUFFIX = {
+	core: "core",
+	mcp: "mcp",
+	extension: "extension"
+};
+const CONNECTED_STATUS = "connected";
+const KIND_ORDER = {
+	core: 0,
+	mcp: 1,
+	extension: 2
+};
+/**
+* Server state worth reporting, which takes the place of the tool count.
+*
+* A connected server is the unremarkable case, so it keeps its count rather
+* than spending the column on a word that says nothing went wrong.
+*/
+function displayStatus(server) {
+	return server.state === CONNECTED_STATUS ? void 0 : server.state.replace(/-/g, " ");
+}
+function toEntry(tool, activeTools) {
+	return {
+		name: tool.name,
+		...tool.description ? { description: tool.description } : {},
+		...tool.parameters === void 0 ? {} : { parameters: tool.parameters },
+		...tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {},
+		...tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {},
+		active: activeTools.has(tool.name)
+	};
+}
+function byName(left, right) {
+	return left.name.localeCompare(right.name);
+}
+function sourceLabel(name, kind) {
+	return `${name} · ${KIND_SUFFIX[kind]}`;
+}
+/**
+* Indexes each server's declared tool names.
+*
+* The snapshot names its tools outright, so attribution is a lookup rather than a
+* guess at the naming scheme. A tool the snapshot does not claim falls through to
+* the extension that registered it.
+*/
+function serverByTool(servers) {
+	const index = /* @__PURE__ */ new Map();
+	for (const server of servers) for (const toolName of server.tools) index.set(toolName, server);
+	return index;
+}
+/**
+* Groups the session's tools by where they came from: Pi itself, one group per
+* MCP server, then one per extension that registered a tool.
+*
+* Every MCP tool is registered by one extension, so `sourceInfo` cannot separate
+* servers; the status snapshot supplies the tool-to-server mapping instead.
+*/
+function buildToolSources(input) {
+	const activeTools = new Set(input.activeTools);
+	const servers = input.mcpServers ?? [];
+	const owningServer = serverByTool(servers);
+	const core = [];
+	const mcpTools = /* @__PURE__ */ new Map();
+	const extensions = /* @__PURE__ */ new Map();
+	for (const tool of input.tools) {
+		const entry = toEntry(tool, activeTools);
+		const server = owningServer.get(tool.name);
+		if (server) {
+			const bucket = mcpTools.get(server.name);
+			if (bucket) bucket.push(entry);
+			else mcpTools.set(server.name, [entry]);
+			continue;
+		}
+		if (tool.sourceInfo.source === BUILTIN_SOURCE) {
+			core.push(entry);
+			continue;
+		}
+		const recordedPath = input.resolveExtensionToolSource?.(tool.name);
+		const key = recordedPath ?? tool.sourceInfo.path;
+		const group = extensions.get(key);
+		if (group) group.tools.push(entry);
+		else {
+			const name = recordedPath !== void 0 || tool.sourceInfo.source === CLI_SOURCE || tool.sourceInfo.source === LOCAL_SOURCE || !tool.sourceInfo.source ? input.resolveExtensionName?.(key) ?? tool.sourceInfo.source ?? key : tool.sourceInfo.source ?? key;
+			const scoped = input.resolveExtensionPackageName?.(key);
+			extensions.set(key, {
+				label: sourceLabel(name, "extension"),
+				detail: key,
+				...scoped ? { packageName: scoped } : {},
+				tools: [entry]
+			});
+		}
+	}
+	const sources = [];
+	if (core.length > 0) sources.push({
+		key: CORE_KEY,
+		label: sourceLabel(CORE_NAME, CORE_KEY),
+		kind: CORE_KEY,
+		tools: core.sort(byName)
+	});
+	for (const server of servers) {
+		const tools = mcpTools.get(server.name) ?? [];
+		const status = displayStatus(server);
+		sources.push({
+			key: `${MCP_KEY_PREFIX}${server.name}`,
+			label: sourceLabel(server.name, "mcp"),
+			kind: "mcp",
+			...status ? { status } : {},
+			tools: tools.sort(byName)
+		});
+	}
+	for (const [key, group] of extensions) sources.push({
+		key,
+		label: group.label,
+		kind: "extension",
+		detail: group.detail,
+		...group.packageName ? { packageName: group.packageName } : {},
+		tools: group.tools.sort(byName)
+	});
+	return sources.sort((left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind] || left.label.localeCompare(right.label));
+}
+//#endregion
+export { buildToolSources, tokensForSource, tokensForTool };
+
+//# sourceMappingURL=toolInventory.mjs.map

package/dist/toolInventory.mjs.map

@@ -0,0 +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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"}

package/dist/toolNames.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtimeToolNames = require("./runtimeToolNames.cjs");
+exports.toClaudeToolName = require_runtimeToolNames.toClaudeToolName;
+exports.toPiToolName = require_runtimeToolNames.toPiToolName;

package/dist/toolNames.d.mts

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

package/dist/toolNames.mjs

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

package/dist/toolOverrides.cjs

@@ -0,0 +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;

package/dist/toolOverrides.d.mts

@@ -0,0 +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 };

package/dist/toolOverrides.mjs

@@ -0,0 +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 };

package/dist/toolSurface.cjs

@@ -0,0 +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;

package/dist/toolSurface.d.mts

@@ -0,0 +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 };

package/dist/toolSurface.mjs

@@ -0,0 +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 };

package/dist/transition.cjs

@@ -0,0 +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;

package/dist/transition.d.cjs

@@ -0,0 +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;

package/dist/transition.d.mts

@@ -0,0 +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 };

package/dist/transition.mjs

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

package/dist/transitionClassifier.cjs

@@ -0,0 +1,112 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/services/transitionClassifier/index.ts
+function sameStrings(left, right) {
+	return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function copySnapshot(snapshot) {
+	return {
+		...snapshot,
+		domains: [...snapshot.domains],
+		layers: [...snapshot.layers],
+		...snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {},
+		...snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}
+	};
+}
+function plan(request, disposition, previous, candidate, diagnostic, strategy) {
+	return {
+		operationId: request.operationId,
+		axis: request.target.axis,
+		disposition,
+		...strategy ? { strategy } : {},
+		previous,
+		candidate,
+		diagnostics: [diagnostic],
+		reloadHandoffRequired: disposition === "reload" || disposition === "relaunch",
+		externalRelaunchRequired: disposition === "relaunch"
+	};
+}
+function withComposition(candidate, context) {
+	const composition = context.resolveComposition?.(candidate);
+	if (!composition) return candidate;
+	return {
+		...candidate,
+		compositionFingerprint: composition.fingerprint,
+		parentActivation: [...composition.parentActivation],
+		childActivation: [...composition.childActivation]
+	};
+}
+function launcherNeedsRelaunch(extensionLayers, previous, candidate) {
+	if (previous.parentActivation && candidate.parentActivation) return !sameStrings(previous.parentActivation, candidate.parentActivation);
+	return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));
+}
+function majorModeDisposition(extensionLayers, previous, candidate, synchronization) {
+	if (synchronization.kind === "launcher-composed") return {
+		disposition: "reload",
+		diagnostic: "transition.reload.major-mode",
+		strategy: "pi-reload"
+	};
+	if (synchronization.kind === "synchronized") {
+		if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) return {
+			disposition: "sync-required",
+			diagnostic: "transition.sync-required.resolution"
+		};
+		if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) return {
+			disposition: "sync-required",
+			diagnostic: "transition.sync-required.artifact"
+		};
+		return {
+			disposition: "reload",
+			diagnostic: "transition.reload.major-mode",
+			strategy: "pi-reload"
+		};
+	}
+	return launcherNeedsRelaunch(extensionLayers, previous, candidate) ? {
+		disposition: "relaunch",
+		diagnostic: "transition.relaunch.extension-closure",
+		strategy: "process-relaunch"
+	} : {
+		disposition: "reload",
+		diagnostic: "transition.reload.major-mode",
+		strategy: "pi-reload"
+	};
+}
+function classifyTransition(request, context) {
+	const previous = copySnapshot(context.current);
+	switch (request.target.axis) {
+		case "live": return plan(request, "live", previous, copySnapshot(previous), "transition.live.capability");
+		case "domains": {
+			const candidate = {
+				...copySnapshot(previous),
+				domains: [...request.target.domains]
+			};
+			if (sameStrings(previous.domains, candidate.domains)) return plan(request, "live", previous, candidate, "transition.no-change");
+			return plan(request, "reload", previous, candidate, "transition.reload.domains", "pi-reload");
+		}
+		case "profile": {
+			const candidate = {
+				...copySnapshot(previous),
+				profile: request.target.profile
+			};
+			if (previous.profile === candidate.profile) return plan(request, "live", previous, candidate, "transition.no-change");
+			return plan(request, "reload", previous, candidate, "transition.reload.profile", "pi-reload");
+		}
+		case "major-mode": {
+			const candidateLayers = context.resolveLayers(request.target.majorMode);
+			const candidate = withComposition({
+				...copySnapshot(previous),
+				majorMode: request.target.majorMode,
+				layers: candidateLayers,
+				compositionFingerprint: void 0,
+				parentActivation: void 0,
+				childActivation: void 0
+			}, context);
+			if (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers) || previous.compositionFingerprint !== void 0 && previous.compositionFingerprint === candidate.compositionFingerprint) return plan(request, "live", previous, candidate, "transition.no-change");
+			const classification = majorModeDisposition(context.extensionLayers, previous, candidate, context.synchronization);
+			return plan(request, classification.disposition, previous, candidate, classification.diagnostic, classification.strategy);
+		}
+	}
+}
+//#endregion
+exports.classifyTransition = classifyTransition;
+
+//# sourceMappingURL=transitionClassifier.cjs.map

package/dist/transitionClassifier.cjs.map

@@ -0,0 +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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"}

package/dist/transitionClassifier.d.mts

@@ -0,0 +1,18 @@
+import { DoomTransitionPlan, DoomTransitionRequest, TransitionSelectionSnapshot, TransitionSynchronization } from "./runtimeTransition.mjs";
+import "./transition.mjs";
+//#region src/services/transitionClassifier/index.d.ts
+export interface TransitionCompositionResolution {
+  readonly fingerprint: string;
+  readonly parentActivation: readonly string[];
+  readonly childActivation: readonly string[];
+}
+export interface TransitionClassifierContext {
+  readonly current: TransitionSelectionSnapshot;
+  readonly resolveLayers: (majorMode: string) => readonly string[];
+  readonly extensionLayers: (layers: readonly string[]) => readonly string[];
+  readonly synchronization: TransitionSynchronization;
+  readonly resolveComposition?: (selection: TransitionSelectionSnapshot) => TransitionCompositionResolution | undefined;
+}
+export declare function classifyTransition(request: DoomTransitionRequest, context: TransitionClassifierContext): DoomTransitionPlan;
+//#endregion
+//# sourceMappingURL=transitionClassifier.d.mts.map

package/dist/transitionClassifier.d.mts.map

@@ -0,0 +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"}

package/dist/transitionClassifier.mjs

@@ -0,0 +1,111 @@
+//#region src/services/transitionClassifier/index.ts
+function sameStrings(left, right) {
+	return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function copySnapshot(snapshot) {
+	return {
+		...snapshot,
+		domains: [...snapshot.domains],
+		layers: [...snapshot.layers],
+		...snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {},
+		...snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}
+	};
+}
+function plan(request, disposition, previous, candidate, diagnostic, strategy) {
+	return {
+		operationId: request.operationId,
+		axis: request.target.axis,
+		disposition,
+		...strategy ? { strategy } : {},
+		previous,
+		candidate,
+		diagnostics: [diagnostic],
+		reloadHandoffRequired: disposition === "reload" || disposition === "relaunch",
+		externalRelaunchRequired: disposition === "relaunch"
+	};
+}
+function withComposition(candidate, context) {
+	const composition = context.resolveComposition?.(candidate);
+	if (!composition) return candidate;
+	return {
+		...candidate,
+		compositionFingerprint: composition.fingerprint,
+		parentActivation: [...composition.parentActivation],
+		childActivation: [...composition.childActivation]
+	};
+}
+function launcherNeedsRelaunch(extensionLayers, previous, candidate) {
+	if (previous.parentActivation && candidate.parentActivation) return !sameStrings(previous.parentActivation, candidate.parentActivation);
+	return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));
+}
+function majorModeDisposition(extensionLayers, previous, candidate, synchronization) {
+	if (synchronization.kind === "launcher-composed") return {
+		disposition: "reload",
+		diagnostic: "transition.reload.major-mode",
+		strategy: "pi-reload"
+	};
+	if (synchronization.kind === "synchronized") {
+		if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) return {
+			disposition: "sync-required",
+			diagnostic: "transition.sync-required.resolution"
+		};
+		if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) return {
+			disposition: "sync-required",
+			diagnostic: "transition.sync-required.artifact"
+		};
+		return {
+			disposition: "reload",
+			diagnostic: "transition.reload.major-mode",
+			strategy: "pi-reload"
+		};
+	}
+	return launcherNeedsRelaunch(extensionLayers, previous, candidate) ? {
+		disposition: "relaunch",
+		diagnostic: "transition.relaunch.extension-closure",
+		strategy: "process-relaunch"
+	} : {
+		disposition: "reload",
+		diagnostic: "transition.reload.major-mode",
+		strategy: "pi-reload"
+	};
+}
+function classifyTransition(request, context) {
+	const previous = copySnapshot(context.current);
+	switch (request.target.axis) {
+		case "live": return plan(request, "live", previous, copySnapshot(previous), "transition.live.capability");
+		case "domains": {
+			const candidate = {
+				...copySnapshot(previous),
+				domains: [...request.target.domains]
+			};
+			if (sameStrings(previous.domains, candidate.domains)) return plan(request, "live", previous, candidate, "transition.no-change");
+			return plan(request, "reload", previous, candidate, "transition.reload.domains", "pi-reload");
+		}
+		case "profile": {
+			const candidate = {
+				...copySnapshot(previous),
+				profile: request.target.profile
+			};
+			if (previous.profile === candidate.profile) return plan(request, "live", previous, candidate, "transition.no-change");
+			return plan(request, "reload", previous, candidate, "transition.reload.profile", "pi-reload");
+		}
+		case "major-mode": {
+			const candidateLayers = context.resolveLayers(request.target.majorMode);
+			const candidate = withComposition({
+				...copySnapshot(previous),
+				majorMode: request.target.majorMode,
+				layers: candidateLayers,
+				compositionFingerprint: void 0,
+				parentActivation: void 0,
+				childActivation: void 0
+			}, context);
+			if (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers) || previous.compositionFingerprint !== void 0 && previous.compositionFingerprint === candidate.compositionFingerprint) return plan(request, "live", previous, candidate, "transition.no-change");
+			const classification = majorModeDisposition(context.extensionLayers, previous, candidate, context.synchronization);
+			return plan(request, classification.disposition, previous, candidate, classification.diagnostic, classification.strategy);
+		}
+	}
+}
+//#endregion
+export { classifyTransition };
+
+//# sourceMappingURL=transitionClassifier.mjs.map

package/dist/transitionClassifier.mjs.map

@@ -0,0 +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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"}