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

package/dist/mcpProjection.mjs

@@ -1,2 +1 @@
-import { AGENT_PLUGIN_MCP_SCHEMA_URL, DOOM_MCP_PROJECTION_RESOLVER_SERVICE, DOOM_MCP_PROJECTION_SERVICE, DOOM_MCP_PROJECTION_VERSION, DoomMcpAgentPluginProjectionSourceSchema, DoomMcpNativeProjectionSourceSchema, DoomMcpProjectionAllowlistSchema, DoomMcpProjectionSchema, DoomMcpProjectionSourceSchema, createDisabledDoomMcpProjection, createDoomMcpProjectionService, isDoomMcpProjection, readDoomMcpProjectionService, requireDoomMcpProjectionService } from "./src/schemas/mcpProjection.mjs";
-export { AGENT_PLUGIN_MCP_SCHEMA_URL, DOOM_MCP_PROJECTION_RESOLVER_SERVICE, DOOM_MCP_PROJECTION_SERVICE, DOOM_MCP_PROJECTION_VERSION, DoomMcpAgentPluginProjectionSourceSchema, DoomMcpNativeProjectionSourceSchema, DoomMcpProjectionAllowlistSchema, DoomMcpProjectionSchema, DoomMcpProjectionSourceSchema, createDisabledDoomMcpProjection, createDoomMcpProjectionService, isDoomMcpProjection, readDoomMcpProjectionService, requireDoomMcpProjectionService };
+export { AGENT_PLUGIN_MCP_SCHEMA_URL, PO_MCP_PROJECTION_RESOLVER_SERVICE, PO_MCP_PROJECTION_SERVICE, PO_MCP_PROJECTION_VERSION, PoMcpAgentPluginProjectionSourceSchema, PoMcpNativeProjectionSourceSchema, PoMcpProjectionAllowlistSchema, PoMcpProjectionSchema, PoMcpProjectionSourceSchema, createDisabledPoMcpProjection, createPoMcpProjectionService, isPoMcpProjection, readPoMcpProjectionService, requirePoMcpProjectionService } from "./src/schemas/mcpProjection.mjs";

package/dist/mcpSchemaCost.cjs

@@ -24,7 +24,7 @@ function asStdioServer(value) {
 		...env ? { env } : {}
 	};
 }
-function cachePath(server, homeDoomDirectory) {
+function cachePath(server, homePoDirectory) {
 	const env = Object.entries(server.env ?? {}).sort(([left], [right]) => left.localeCompare(right));
 	const identity = [
 		CACHE_VERSION,
@@ -33,7 +33,7 @@ function cachePath(server, homeDoomDirectory) {
 		env
 	];
 	const digest = node_crypto.default.createHash("sha256").update(JSON.stringify(identity)).digest("hex");
-	return node_path.default.join(homeDoomDirectory, CACHE_DIRECTORY, `${digest}.json`);
+	return node_path.default.join(homePoDirectory, CACHE_DIRECTORY, `${digest}.json`);
 }
 function readCache(file) {
 	try {
@@ -141,7 +141,7 @@ async function priceServer(name, configured, options) {
 		cached: false,
 		unavailable: "not a stdio server"
 	};
-	const file = cachePath(server, options.homeDoomDirectory);
+	const file = cachePath(server, options.homePoDirectory);
 	const hit = readCache(file);
 	if (hit) return {
 		name,
@@ -176,7 +176,7 @@ async function priceServer(name, configured, options) {
 * prompt.
 *
 * Servers only report their tools once connected, so this spawns each one and
-* snapshots the result under the home Doom directory. Handshakes run in
+* snapshots the result under the home Po directory. Handshakes run in
 * parallel and the snapshot is keyed on the server descriptor, so a changed
 * command or pinned version re-prices and everything else stays instant.
 */

package/dist/mcpSchemaCost.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcpSchemaCost.cjs","names":["crypto","path","fs","spawn"],"sources":["../src/services/mcpSchemaCost/index.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nconst CACHE_DIRECTORY = 'mcp-schema-cache';\nconst CACHE_VERSION = 1;\nconst PROTOCOL_VERSION = '2024-11-05';\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\ninterface StdioServer {\n  command: string;\n  args: string[];\n  env?: Record<string, string>;\n}\n\nexport interface McpServerCost {\n  name: string;\n  tokens: number;\n  toolCount: number;\n  /** Read from the on-disk snapshot rather than a fresh handshake. */\n  cached: boolean;\n  /** Why this server could not be priced. Set only when tokens is 0. */\n  unavailable?: string;\n}\n\nexport interface McpSchemaCost {\n  servers: McpServerCost[];\n  totalTokens: number;\n}\n\nexport interface McpSchemaCostOptions {\n  /** The resolved MCP config Pi will load. */\n  configPath: string;\n  homeDoomDirectory: string;\n  cwd: string;\n  environment: NodeJS.ProcessEnv;\n  countTokens: (text: string) => number;\n  timeoutMs?: number;\n}\n\nfunction asStdioServer(value: unknown): StdioServer | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Record<string, unknown>;\n  if (typeof record.command !== 'string' || !record.command) return undefined;\n  const args = Array.isArray(record.args) ? record.args.filter((arg): arg is string => typeof arg === 'string') : [];\n  const env =\n    typeof record.env === 'object' && record.env !== null\n      ? Object.fromEntries(\n          Object.entries(record.env as Record<string, unknown>).filter(\n            (entry): entry is [string, string] => typeof entry[1] === 'string',\n          ),\n        )\n      : undefined;\n  return { command: record.command, args, ...(env ? { env } : {}) };\n}\n\nfunction cachePath(server: StdioServer, homeDoomDirectory: string): string {\n  const env = Object.entries(server.env ?? {}).sort(([left], [right]) => left.localeCompare(right));\n  const identity = [CACHE_VERSION, server.command, server.args, env];\n  const digest = crypto.createHash('sha256').update(JSON.stringify(identity)).digest('hex');\n  return path.join(homeDoomDirectory, CACHE_DIRECTORY, `${digest}.json`);\n}\n\nfunction readCache(file: string): { tokens: number; toolCount: number } | undefined {\n  try {\n    const parsed = JSON.parse(fs.readFileSync(file, 'utf8')) as unknown;\n    if (typeof parsed !== 'object' || parsed === null) return undefined;\n    const { tokens, toolCount } = parsed as Record<string, unknown>;\n    if (typeof tokens !== 'number' || typeof toolCount !== 'number') return undefined;\n    return { tokens, toolCount };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction writeCache(file: string, value: { tokens: number; toolCount: number }): void {\n  try {\n    fs.mkdirSync(path.dirname(file), { recursive: true });\n    fs.writeFileSync(file, JSON.stringify(value), { mode: 0o600 });\n  } catch {\n    // A cache that cannot be written only costs the next run a handshake.\n  }\n}\n\n/**\n * Runs the MCP initialize/tools handshake and returns the advertised tools.\n *\n * The server is a configured executable, so this trusts it the same way a\n * session does, but it is killed as soon as the tool list arrives rather than\n * being left running.\n */\nfunction listTools(server: StdioServer, options: McpSchemaCostOptions): Promise<unknown[]> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(server.command, server.args, {\n      cwd: options.cwd,\n      env: { ...options.environment, ...server.env },\n      stdio: ['pipe', 'pipe', 'ignore'],\n    });\n\n    let settled = false;\n    const finish = (outcome: () => void): void => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      child.kill();\n      outcome();\n    };\n\n    const timer = setTimeout(\n      () => finish(() => reject(new Error('timed out'))),\n      options.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n    );\n\n    const send = (message: unknown): void => {\n      if (!child.stdin.destroyed) child.stdin.write(`${JSON.stringify(message)}\\n`);\n    };\n\n    let buffer = '';\n    child.stdout.on('data', (chunk: Buffer) => {\n      buffer += chunk.toString();\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() ?? '';\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        let message: { id?: number; result?: { tools?: unknown[] } };\n        try {\n          message = JSON.parse(line) as typeof message;\n        } catch {\n          continue;\n        }\n        if (message.id === 1) {\n          send({ jsonrpc: '2.0', method: 'notifications/initialized' });\n          send({ jsonrpc: '2.0', id: 2, method: 'tools/list' });\n        }\n        if (message.id === 2) finish(() => resolve(message.result?.tools ?? []));\n      }\n    });\n\n    child.on('error', (error) => finish(() => reject(error)));\n    child.on('exit', () => finish(() => reject(new Error('server exited before reporting tools'))));\n\n    send({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: PROTOCOL_VERSION,\n        capabilities: {},\n        clientInfo: { name: 'po-explain', version: '1' },\n      },\n    });\n  });\n}\n\nasync function priceServer(name: string, configured: unknown, options: McpSchemaCostOptions): Promise<McpServerCost> {\n  const server = asStdioServer(configured);\n  if (!server) return { name, tokens: 0, toolCount: 0, cached: false, unavailable: 'not a stdio server' };\n\n  const file = cachePath(server, options.homeDoomDirectory);\n  const hit = readCache(file);\n  if (hit) return { name, tokens: hit.tokens, toolCount: hit.toolCount, cached: true };\n\n  try {\n    const tools = await listTools(server, options);\n    const value = { tokens: options.countTokens(JSON.stringify(tools)), toolCount: tools.length };\n    writeCache(file, value);\n    return { name, ...value, cached: false };\n  } catch (error) {\n    const detail = error instanceof Error ? error.message : String(error);\n    return { name, tokens: 0, toolCount: 0, cached: false, unavailable: detail };\n  }\n}\n\n/**\n * Prices the tool schemas every configured MCP server puts in the system\n * prompt.\n *\n * Servers only report their tools once connected, so this spawns each one and\n * snapshots the result under the home Doom directory. Handshakes run in\n * parallel and the snapshot is keyed on the server descriptor, so a changed\n * command or pinned version re-prices and everything else stays instant.\n */\nexport async function priceMcpToolSchemas(options: McpSchemaCostOptions): Promise<McpSchemaCost> {\n  const parsed = JSON.parse(fs.readFileSync(options.configPath, 'utf8')) as {\n    mcpServers?: Record<string, unknown>;\n  };\n  const entries = Object.entries(parsed.mcpServers ?? {});\n  const servers = await Promise.all(entries.map(([name, configured]) => priceServer(name, configured, options)));\n  return { servers, totalTokens: servers.reduce((total, server) => total + server.tokens, 0) };\n}\n"],"mappings":"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"}
+{"version":3,"file":"mcpSchemaCost.cjs","names":["crypto","path","fs","spawn"],"sources":["../src/services/mcpSchemaCost/index.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nconst CACHE_DIRECTORY = 'mcp-schema-cache';\nconst CACHE_VERSION = 1;\nconst PROTOCOL_VERSION = '2024-11-05';\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\ninterface StdioServer {\n  command: string;\n  args: string[];\n  env?: Record<string, string>;\n}\n\nexport interface McpServerCost {\n  name: string;\n  tokens: number;\n  toolCount: number;\n  /** Read from the on-disk snapshot rather than a fresh handshake. */\n  cached: boolean;\n  /** Why this server could not be priced. Set only when tokens is 0. */\n  unavailable?: string;\n}\n\nexport interface McpSchemaCost {\n  servers: McpServerCost[];\n  totalTokens: number;\n}\n\nexport interface McpSchemaCostOptions {\n  /** The resolved MCP config Pi will load. */\n  configPath: string;\n  homePoDirectory: string;\n  cwd: string;\n  environment: NodeJS.ProcessEnv;\n  countTokens: (text: string) => number;\n  timeoutMs?: number;\n}\n\nfunction asStdioServer(value: unknown): StdioServer | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Record<string, unknown>;\n  if (typeof record.command !== 'string' || !record.command) return undefined;\n  const args = Array.isArray(record.args) ? record.args.filter((arg): arg is string => typeof arg === 'string') : [];\n  const env =\n    typeof record.env === 'object' && record.env !== null\n      ? Object.fromEntries(\n          Object.entries(record.env as Record<string, unknown>).filter(\n            (entry): entry is [string, string] => typeof entry[1] === 'string',\n          ),\n        )\n      : undefined;\n  return { command: record.command, args, ...(env ? { env } : {}) };\n}\n\nfunction cachePath(server: StdioServer, homePoDirectory: string): string {\n  const env = Object.entries(server.env ?? {}).sort(([left], [right]) => left.localeCompare(right));\n  const identity = [CACHE_VERSION, server.command, server.args, env];\n  const digest = crypto.createHash('sha256').update(JSON.stringify(identity)).digest('hex');\n  return path.join(homePoDirectory, CACHE_DIRECTORY, `${digest}.json`);\n}\n\nfunction readCache(file: string): { tokens: number; toolCount: number } | undefined {\n  try {\n    const parsed = JSON.parse(fs.readFileSync(file, 'utf8')) as unknown;\n    if (typeof parsed !== 'object' || parsed === null) return undefined;\n    const { tokens, toolCount } = parsed as Record<string, unknown>;\n    if (typeof tokens !== 'number' || typeof toolCount !== 'number') return undefined;\n    return { tokens, toolCount };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction writeCache(file: string, value: { tokens: number; toolCount: number }): void {\n  try {\n    fs.mkdirSync(path.dirname(file), { recursive: true });\n    fs.writeFileSync(file, JSON.stringify(value), { mode: 0o600 });\n  } catch {\n    // A cache that cannot be written only costs the next run a handshake.\n  }\n}\n\n/**\n * Runs the MCP initialize/tools handshake and returns the advertised tools.\n *\n * The server is a configured executable, so this trusts it the same way a\n * session does, but it is killed as soon as the tool list arrives rather than\n * being left running.\n */\nfunction listTools(server: StdioServer, options: McpSchemaCostOptions): Promise<unknown[]> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(server.command, server.args, {\n      cwd: options.cwd,\n      env: { ...options.environment, ...server.env },\n      stdio: ['pipe', 'pipe', 'ignore'],\n    });\n\n    let settled = false;\n    const finish = (outcome: () => void): void => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      child.kill();\n      outcome();\n    };\n\n    const timer = setTimeout(\n      () => finish(() => reject(new Error('timed out'))),\n      options.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n    );\n\n    const send = (message: unknown): void => {\n      if (!child.stdin.destroyed) child.stdin.write(`${JSON.stringify(message)}\\n`);\n    };\n\n    let buffer = '';\n    child.stdout.on('data', (chunk: Buffer) => {\n      buffer += chunk.toString();\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() ?? '';\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        let message: { id?: number; result?: { tools?: unknown[] } };\n        try {\n          message = JSON.parse(line) as typeof message;\n        } catch {\n          continue;\n        }\n        if (message.id === 1) {\n          send({ jsonrpc: '2.0', method: 'notifications/initialized' });\n          send({ jsonrpc: '2.0', id: 2, method: 'tools/list' });\n        }\n        if (message.id === 2) finish(() => resolve(message.result?.tools ?? []));\n      }\n    });\n\n    child.on('error', (error) => finish(() => reject(error)));\n    child.on('exit', () => finish(() => reject(new Error('server exited before reporting tools'))));\n\n    send({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: PROTOCOL_VERSION,\n        capabilities: {},\n        clientInfo: { name: 'po-explain', version: '1' },\n      },\n    });\n  });\n}\n\nasync function priceServer(name: string, configured: unknown, options: McpSchemaCostOptions): Promise<McpServerCost> {\n  const server = asStdioServer(configured);\n  if (!server) return { name, tokens: 0, toolCount: 0, cached: false, unavailable: 'not a stdio server' };\n\n  const file = cachePath(server, options.homePoDirectory);\n  const hit = readCache(file);\n  if (hit) return { name, tokens: hit.tokens, toolCount: hit.toolCount, cached: true };\n\n  try {\n    const tools = await listTools(server, options);\n    const value = { tokens: options.countTokens(JSON.stringify(tools)), toolCount: tools.length };\n    writeCache(file, value);\n    return { name, ...value, cached: false };\n  } catch (error) {\n    const detail = error instanceof Error ? error.message : String(error);\n    return { name, tokens: 0, toolCount: 0, cached: false, unavailable: detail };\n  }\n}\n\n/**\n * Prices the tool schemas every configured MCP server puts in the system\n * prompt.\n *\n * Servers only report their tools once connected, so this spawns each one and\n * snapshots the result under the home Po directory. Handshakes run in\n * parallel and the snapshot is keyed on the server descriptor, so a changed\n * command or pinned version re-prices and everything else stays instant.\n */\nexport async function priceMcpToolSchemas(options: McpSchemaCostOptions): Promise<McpSchemaCost> {\n  const parsed = JSON.parse(fs.readFileSync(options.configPath, 'utf8')) as {\n    mcpServers?: Record<string, unknown>;\n  };\n  const entries = Object.entries(parsed.mcpServers ?? {});\n  const servers = await Promise.all(entries.map(([name, configured]) => priceServer(name, configured, options)));\n  return { servers, totalTokens: servers.reduce((total, server) => total + server.tokens, 0) };\n}\n"],"mappings":"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"}

package/dist/mcpSchemaCost.d.mts

@@ -15,7 +15,7 @@ export interface McpSchemaCost {
 export interface McpSchemaCostOptions {
   /** The resolved MCP config Pi will load. */
   configPath: string;
-  homeDoomDirectory: string;
+  homePoDirectory: string;
   cwd: string;
   environment: NodeJS.ProcessEnv;
   countTokens: (text: string) => number;
@@ -26,7 +26,7 @@ export interface McpSchemaCostOptions {
  * prompt.
  *
  * Servers only report their tools once connected, so this spawns each one and
- * snapshots the result under the home Doom directory. Handshakes run in
+ * snapshots the result under the home Po directory. Handshakes run in
  * parallel and the snapshot is keyed on the server descriptor, so a changed
  * command or pinned version re-prices and everything else stays instant.
  */

package/dist/mcpSchemaCost.mjs

@@ -19,7 +19,7 @@ function asStdioServer(value) {
 		...env ? { env } : {}
 	};
 }
-function cachePath(server, homeDoomDirectory) {
+function cachePath(server, homePoDirectory) {
 	const env = Object.entries(server.env ?? {}).sort(([left], [right]) => left.localeCompare(right));
 	const identity = [
 		CACHE_VERSION,
@@ -28,7 +28,7 @@ function cachePath(server, homeDoomDirectory) {
 		env
 	];
 	const digest = crypto.createHash("sha256").update(JSON.stringify(identity)).digest("hex");
-	return path.join(homeDoomDirectory, CACHE_DIRECTORY, `${digest}.json`);
+	return path.join(homePoDirectory, CACHE_DIRECTORY, `${digest}.json`);
 }
 function readCache(file) {
 	try {
@@ -136,7 +136,7 @@ async function priceServer(name, configured, options) {
 		cached: false,
 		unavailable: "not a stdio server"
 	};
-	const file = cachePath(server, options.homeDoomDirectory);
+	const file = cachePath(server, options.homePoDirectory);
 	const hit = readCache(file);
 	if (hit) return {
 		name,
@@ -171,7 +171,7 @@ async function priceServer(name, configured, options) {
 * prompt.
 *
 * Servers only report their tools once connected, so this spawns each one and
-* snapshots the result under the home Doom directory. Handshakes run in
+* snapshots the result under the home Po directory. Handshakes run in
 * parallel and the snapshot is keyed on the server descriptor, so a changed
 * command or pinned version re-prices and everything else stays instant.
 */

package/dist/mcpSchemaCost.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcpSchemaCost.mjs","names":[],"sources":["../src/services/mcpSchemaCost/index.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nconst CACHE_DIRECTORY = 'mcp-schema-cache';\nconst CACHE_VERSION = 1;\nconst PROTOCOL_VERSION = '2024-11-05';\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\ninterface StdioServer {\n  command: string;\n  args: string[];\n  env?: Record<string, string>;\n}\n\nexport interface McpServerCost {\n  name: string;\n  tokens: number;\n  toolCount: number;\n  /** Read from the on-disk snapshot rather than a fresh handshake. */\n  cached: boolean;\n  /** Why this server could not be priced. Set only when tokens is 0. */\n  unavailable?: string;\n}\n\nexport interface McpSchemaCost {\n  servers: McpServerCost[];\n  totalTokens: number;\n}\n\nexport interface McpSchemaCostOptions {\n  /** The resolved MCP config Pi will load. */\n  configPath: string;\n  homeDoomDirectory: string;\n  cwd: string;\n  environment: NodeJS.ProcessEnv;\n  countTokens: (text: string) => number;\n  timeoutMs?: number;\n}\n\nfunction asStdioServer(value: unknown): StdioServer | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Record<string, unknown>;\n  if (typeof record.command !== 'string' || !record.command) return undefined;\n  const args = Array.isArray(record.args) ? record.args.filter((arg): arg is string => typeof arg === 'string') : [];\n  const env =\n    typeof record.env === 'object' && record.env !== null\n      ? Object.fromEntries(\n          Object.entries(record.env as Record<string, unknown>).filter(\n            (entry): entry is [string, string] => typeof entry[1] === 'string',\n          ),\n        )\n      : undefined;\n  return { command: record.command, args, ...(env ? { env } : {}) };\n}\n\nfunction cachePath(server: StdioServer, homeDoomDirectory: string): string {\n  const env = Object.entries(server.env ?? {}).sort(([left], [right]) => left.localeCompare(right));\n  const identity = [CACHE_VERSION, server.command, server.args, env];\n  const digest = crypto.createHash('sha256').update(JSON.stringify(identity)).digest('hex');\n  return path.join(homeDoomDirectory, CACHE_DIRECTORY, `${digest}.json`);\n}\n\nfunction readCache(file: string): { tokens: number; toolCount: number } | undefined {\n  try {\n    const parsed = JSON.parse(fs.readFileSync(file, 'utf8')) as unknown;\n    if (typeof parsed !== 'object' || parsed === null) return undefined;\n    const { tokens, toolCount } = parsed as Record<string, unknown>;\n    if (typeof tokens !== 'number' || typeof toolCount !== 'number') return undefined;\n    return { tokens, toolCount };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction writeCache(file: string, value: { tokens: number; toolCount: number }): void {\n  try {\n    fs.mkdirSync(path.dirname(file), { recursive: true });\n    fs.writeFileSync(file, JSON.stringify(value), { mode: 0o600 });\n  } catch {\n    // A cache that cannot be written only costs the next run a handshake.\n  }\n}\n\n/**\n * Runs the MCP initialize/tools handshake and returns the advertised tools.\n *\n * The server is a configured executable, so this trusts it the same way a\n * session does, but it is killed as soon as the tool list arrives rather than\n * being left running.\n */\nfunction listTools(server: StdioServer, options: McpSchemaCostOptions): Promise<unknown[]> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(server.command, server.args, {\n      cwd: options.cwd,\n      env: { ...options.environment, ...server.env },\n      stdio: ['pipe', 'pipe', 'ignore'],\n    });\n\n    let settled = false;\n    const finish = (outcome: () => void): void => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      child.kill();\n      outcome();\n    };\n\n    const timer = setTimeout(\n      () => finish(() => reject(new Error('timed out'))),\n      options.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n    );\n\n    const send = (message: unknown): void => {\n      if (!child.stdin.destroyed) child.stdin.write(`${JSON.stringify(message)}\\n`);\n    };\n\n    let buffer = '';\n    child.stdout.on('data', (chunk: Buffer) => {\n      buffer += chunk.toString();\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() ?? '';\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        let message: { id?: number; result?: { tools?: unknown[] } };\n        try {\n          message = JSON.parse(line) as typeof message;\n        } catch {\n          continue;\n        }\n        if (message.id === 1) {\n          send({ jsonrpc: '2.0', method: 'notifications/initialized' });\n          send({ jsonrpc: '2.0', id: 2, method: 'tools/list' });\n        }\n        if (message.id === 2) finish(() => resolve(message.result?.tools ?? []));\n      }\n    });\n\n    child.on('error', (error) => finish(() => reject(error)));\n    child.on('exit', () => finish(() => reject(new Error('server exited before reporting tools'))));\n\n    send({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: PROTOCOL_VERSION,\n        capabilities: {},\n        clientInfo: { name: 'po-explain', version: '1' },\n      },\n    });\n  });\n}\n\nasync function priceServer(name: string, configured: unknown, options: McpSchemaCostOptions): Promise<McpServerCost> {\n  const server = asStdioServer(configured);\n  if (!server) return { name, tokens: 0, toolCount: 0, cached: false, unavailable: 'not a stdio server' };\n\n  const file = cachePath(server, options.homeDoomDirectory);\n  const hit = readCache(file);\n  if (hit) return { name, tokens: hit.tokens, toolCount: hit.toolCount, cached: true };\n\n  try {\n    const tools = await listTools(server, options);\n    const value = { tokens: options.countTokens(JSON.stringify(tools)), toolCount: tools.length };\n    writeCache(file, value);\n    return { name, ...value, cached: false };\n  } catch (error) {\n    const detail = error instanceof Error ? error.message : String(error);\n    return { name, tokens: 0, toolCount: 0, cached: false, unavailable: detail };\n  }\n}\n\n/**\n * Prices the tool schemas every configured MCP server puts in the system\n * prompt.\n *\n * Servers only report their tools once connected, so this spawns each one and\n * snapshots the result under the home Doom directory. Handshakes run in\n * parallel and the snapshot is keyed on the server descriptor, so a changed\n * command or pinned version re-prices and everything else stays instant.\n */\nexport async function priceMcpToolSchemas(options: McpSchemaCostOptions): Promise<McpSchemaCost> {\n  const parsed = JSON.parse(fs.readFileSync(options.configPath, 'utf8')) as {\n    mcpServers?: Record<string, unknown>;\n  };\n  const entries = Object.entries(parsed.mcpServers ?? {});\n  const servers = await Promise.all(entries.map(([name, configured]) => priceServer(name, configured, options)));\n  return { servers, totalTokens: servers.reduce((total, server) => total + server.tokens, 0) };\n}\n"],"mappings":";;;;;AAKA,MAAM,kBAAkB;AACxB,MAAM,gBAAgB;AACtB,MAAM,mBAAmB;AACzB,MAAM,qBAAqB;AAiC3B,SAAS,cAAc,OAAyC;CAC9D,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,SAAS;CACf,IAAI,OAAO,OAAO,YAAY,YAAY,CAAC,OAAO,SAAS,OAAO,KAAA;CAClE,MAAM,OAAO,MAAM,QAAQ,OAAO,IAAI,IAAI,OAAO,KAAK,QAAQ,QAAuB,OAAO,QAAQ,QAAQ,IAAI,CAAC;CACjH,MAAM,MACJ,OAAO,OAAO,QAAQ,YAAY,OAAO,QAAQ,OAC7C,OAAO,YACL,OAAO,QAAQ,OAAO,GAA8B,CAAC,CAAC,QACnD,UAAqC,OAAO,MAAM,OAAO,QAC5D,CACF,IACA,KAAA;CACN,OAAO;EAAE,SAAS,OAAO;EAAS;EAAM,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;CAAG;AAClE;AAEA,SAAS,UAAU,QAAqB,mBAAmC;CACzE,MAAM,MAAM,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,cAAc,KAAK,CAAC;CAChG,MAAM,WAAW;EAAC;EAAe,OAAO;EAAS,OAAO;EAAM;CAAG;CACjE,MAAM,SAAS,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,UAAU,QAAQ,CAAC,CAAC,CAAC,OAAO,KAAK;CACxF,OAAO,KAAK,KAAK,mBAAmB,iBAAiB,GAAG,OAAO,MAAM;AACvE;AAEA,SAAS,UAAU,MAAiE;CAClF,IAAI;EACF,MAAM,SAAS,KAAK,MAAM,GAAG,aAAa,MAAM,MAAM,CAAC;EACvD,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO,KAAA;EAC1D,MAAM,EAAE,QAAQ,cAAc;EAC9B,IAAI,OAAO,WAAW,YAAY,OAAO,cAAc,UAAU,OAAO,KAAA;EACxE,OAAO;GAAE;GAAQ;EAAU;CAC7B,QAAQ;EACN;CACF;AACF;AAEA,SAAS,WAAW,MAAc,OAAoD;CACpF,IAAI;EACF,GAAG,UAAU,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;EACpD,GAAG,cAAc,MAAM,KAAK,UAAU,KAAK,GAAG,EAAE,MAAM,IAAM,CAAC;CAC/D,QAAQ,CAER;AACF;;;;;;;;AASA,SAAS,UAAU,QAAqB,SAAmD;CACzF,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,QAAQ,MAAM,OAAO,SAAS,OAAO,MAAM;GAC/C,KAAK,QAAQ;GACb,KAAK;IAAE,GAAG,QAAQ;IAAa,GAAG,OAAO;GAAI;GAC7C,OAAO;IAAC;IAAQ;IAAQ;GAAQ;EAClC,CAAC;EAED,IAAI,UAAU;EACd,MAAM,UAAU,YAA8B;GAC5C,IAAI,SAAS;GACb,UAAU;GACV,aAAa,KAAK;GAClB,MAAM,KAAK;GACX,QAAQ;EACV;EAEA,MAAM,QAAQ,iBACN,aAAa,uBAAO,IAAI,MAAM,WAAW,CAAC,CAAC,GACjD,QAAQ,aAAa,kBACvB;EAEA,MAAM,QAAQ,YAA2B;GACvC,IAAI,CAAC,MAAM,MAAM,WAAW,MAAM,MAAM,MAAM,GAAG,KAAK,UAAU,OAAO,EAAE,GAAG;EAC9E;EAEA,IAAI,SAAS;EACb,MAAM,OAAO,GAAG,SAAS,UAAkB;GACzC,UAAU,MAAM,SAAS;GACzB,MAAM,QAAQ,OAAO,MAAM,IAAI;GAC/B,SAAS,MAAM,IAAI,KAAK;GACxB,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,CAAC,KAAK,KAAK,GAAG;IAClB,IAAI;IACJ,IAAI;KACF,UAAU,KAAK,MAAM,IAAI;IAC3B,QAAQ;KACN;IACF;IACA,IAAI,QAAQ,OAAO,GAAG;KACpB,KAAK;MAAE,SAAS;MAAO,QAAQ;KAA4B,CAAC;KAC5D,KAAK;MAAE,SAAS;MAAO,IAAI;MAAG,QAAQ;KAAa,CAAC;IACtD;IACA,IAAI,QAAQ,OAAO,GAAG,aAAa,QAAQ,QAAQ,QAAQ,SAAS,CAAC,CAAC,CAAC;GACzE;EACF,CAAC;EAED,MAAM,GAAG,UAAU,UAAU,aAAa,OAAO,KAAK,CAAC,CAAC;EACxD,MAAM,GAAG,cAAc,aAAa,uBAAO,IAAI,MAAM,sCAAsC,CAAC,CAAC,CAAC;EAE9F,KAAK;GACH,SAAS;GACT,IAAI;GACJ,QAAQ;GACR,QAAQ;IACN,iBAAiB;IACjB,cAAc,CAAC;IACf,YAAY;KAAE,MAAM;KAAc,SAAS;IAAI;GACjD;EACF,CAAC;CACH,CAAC;AACH;AAEA,eAAe,YAAY,MAAc,YAAqB,SAAuD;CACnH,MAAM,SAAS,cAAc,UAAU;CACvC,IAAI,CAAC,QAAQ,OAAO;EAAE;EAAM,QAAQ;EAAG,WAAW;EAAG,QAAQ;EAAO,aAAa;CAAqB;CAEtG,MAAM,OAAO,UAAU,QAAQ,QAAQ,iBAAiB;CACxD,MAAM,MAAM,UAAU,IAAI;CAC1B,IAAI,KAAK,OAAO;EAAE;EAAM,QAAQ,IAAI;EAAQ,WAAW,IAAI;EAAW,QAAQ;CAAK;CAEnF,IAAI;EACF,MAAM,QAAQ,MAAM,UAAU,QAAQ,OAAO;EAC7C,MAAM,QAAQ;GAAE,QAAQ,QAAQ,YAAY,KAAK,UAAU,KAAK,CAAC;GAAG,WAAW,MAAM;EAAO;EAC5F,WAAW,MAAM,KAAK;EACtB,OAAO;GAAE;GAAM,GAAG;GAAO,QAAQ;EAAM;CACzC,SAAS,OAAO;EAEd,OAAO;GAAE;GAAM,QAAQ;GAAG,WAAW;GAAG,QAAQ;GAAO,aADxC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACO;CAC7E;AACF;;;;;;;;;;AAWA,eAAsB,oBAAoB,SAAuD;CAC/F,MAAM,SAAS,KAAK,MAAM,GAAG,aAAa,QAAQ,YAAY,MAAM,CAAC;CAGrE,MAAM,UAAU,OAAO,QAAQ,OAAO,cAAc,CAAC,CAAC;CACtD,MAAM,UAAU,MAAM,QAAQ,IAAI,QAAQ,KAAK,CAAC,MAAM,gBAAgB,YAAY,MAAM,YAAY,OAAO,CAAC,CAAC;CAC7G,OAAO;EAAE;EAAS,aAAa,QAAQ,QAAQ,OAAO,WAAW,QAAQ,OAAO,QAAQ,CAAC;CAAE;AAC7F"}
+{"version":3,"file":"mcpSchemaCost.mjs","names":[],"sources":["../src/services/mcpSchemaCost/index.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nconst CACHE_DIRECTORY = 'mcp-schema-cache';\nconst CACHE_VERSION = 1;\nconst PROTOCOL_VERSION = '2024-11-05';\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\ninterface StdioServer {\n  command: string;\n  args: string[];\n  env?: Record<string, string>;\n}\n\nexport interface McpServerCost {\n  name: string;\n  tokens: number;\n  toolCount: number;\n  /** Read from the on-disk snapshot rather than a fresh handshake. */\n  cached: boolean;\n  /** Why this server could not be priced. Set only when tokens is 0. */\n  unavailable?: string;\n}\n\nexport interface McpSchemaCost {\n  servers: McpServerCost[];\n  totalTokens: number;\n}\n\nexport interface McpSchemaCostOptions {\n  /** The resolved MCP config Pi will load. */\n  configPath: string;\n  homePoDirectory: string;\n  cwd: string;\n  environment: NodeJS.ProcessEnv;\n  countTokens: (text: string) => number;\n  timeoutMs?: number;\n}\n\nfunction asStdioServer(value: unknown): StdioServer | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Record<string, unknown>;\n  if (typeof record.command !== 'string' || !record.command) return undefined;\n  const args = Array.isArray(record.args) ? record.args.filter((arg): arg is string => typeof arg === 'string') : [];\n  const env =\n    typeof record.env === 'object' && record.env !== null\n      ? Object.fromEntries(\n          Object.entries(record.env as Record<string, unknown>).filter(\n            (entry): entry is [string, string] => typeof entry[1] === 'string',\n          ),\n        )\n      : undefined;\n  return { command: record.command, args, ...(env ? { env } : {}) };\n}\n\nfunction cachePath(server: StdioServer, homePoDirectory: string): string {\n  const env = Object.entries(server.env ?? {}).sort(([left], [right]) => left.localeCompare(right));\n  const identity = [CACHE_VERSION, server.command, server.args, env];\n  const digest = crypto.createHash('sha256').update(JSON.stringify(identity)).digest('hex');\n  return path.join(homePoDirectory, CACHE_DIRECTORY, `${digest}.json`);\n}\n\nfunction readCache(file: string): { tokens: number; toolCount: number } | undefined {\n  try {\n    const parsed = JSON.parse(fs.readFileSync(file, 'utf8')) as unknown;\n    if (typeof parsed !== 'object' || parsed === null) return undefined;\n    const { tokens, toolCount } = parsed as Record<string, unknown>;\n    if (typeof tokens !== 'number' || typeof toolCount !== 'number') return undefined;\n    return { tokens, toolCount };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction writeCache(file: string, value: { tokens: number; toolCount: number }): void {\n  try {\n    fs.mkdirSync(path.dirname(file), { recursive: true });\n    fs.writeFileSync(file, JSON.stringify(value), { mode: 0o600 });\n  } catch {\n    // A cache that cannot be written only costs the next run a handshake.\n  }\n}\n\n/**\n * Runs the MCP initialize/tools handshake and returns the advertised tools.\n *\n * The server is a configured executable, so this trusts it the same way a\n * session does, but it is killed as soon as the tool list arrives rather than\n * being left running.\n */\nfunction listTools(server: StdioServer, options: McpSchemaCostOptions): Promise<unknown[]> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(server.command, server.args, {\n      cwd: options.cwd,\n      env: { ...options.environment, ...server.env },\n      stdio: ['pipe', 'pipe', 'ignore'],\n    });\n\n    let settled = false;\n    const finish = (outcome: () => void): void => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      child.kill();\n      outcome();\n    };\n\n    const timer = setTimeout(\n      () => finish(() => reject(new Error('timed out'))),\n      options.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n    );\n\n    const send = (message: unknown): void => {\n      if (!child.stdin.destroyed) child.stdin.write(`${JSON.stringify(message)}\\n`);\n    };\n\n    let buffer = '';\n    child.stdout.on('data', (chunk: Buffer) => {\n      buffer += chunk.toString();\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() ?? '';\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        let message: { id?: number; result?: { tools?: unknown[] } };\n        try {\n          message = JSON.parse(line) as typeof message;\n        } catch {\n          continue;\n        }\n        if (message.id === 1) {\n          send({ jsonrpc: '2.0', method: 'notifications/initialized' });\n          send({ jsonrpc: '2.0', id: 2, method: 'tools/list' });\n        }\n        if (message.id === 2) finish(() => resolve(message.result?.tools ?? []));\n      }\n    });\n\n    child.on('error', (error) => finish(() => reject(error)));\n    child.on('exit', () => finish(() => reject(new Error('server exited before reporting tools'))));\n\n    send({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: PROTOCOL_VERSION,\n        capabilities: {},\n        clientInfo: { name: 'po-explain', version: '1' },\n      },\n    });\n  });\n}\n\nasync function priceServer(name: string, configured: unknown, options: McpSchemaCostOptions): Promise<McpServerCost> {\n  const server = asStdioServer(configured);\n  if (!server) return { name, tokens: 0, toolCount: 0, cached: false, unavailable: 'not a stdio server' };\n\n  const file = cachePath(server, options.homePoDirectory);\n  const hit = readCache(file);\n  if (hit) return { name, tokens: hit.tokens, toolCount: hit.toolCount, cached: true };\n\n  try {\n    const tools = await listTools(server, options);\n    const value = { tokens: options.countTokens(JSON.stringify(tools)), toolCount: tools.length };\n    writeCache(file, value);\n    return { name, ...value, cached: false };\n  } catch (error) {\n    const detail = error instanceof Error ? error.message : String(error);\n    return { name, tokens: 0, toolCount: 0, cached: false, unavailable: detail };\n  }\n}\n\n/**\n * Prices the tool schemas every configured MCP server puts in the system\n * prompt.\n *\n * Servers only report their tools once connected, so this spawns each one and\n * snapshots the result under the home Po directory. Handshakes run in\n * parallel and the snapshot is keyed on the server descriptor, so a changed\n * command or pinned version re-prices and everything else stays instant.\n */\nexport async function priceMcpToolSchemas(options: McpSchemaCostOptions): Promise<McpSchemaCost> {\n  const parsed = JSON.parse(fs.readFileSync(options.configPath, 'utf8')) as {\n    mcpServers?: Record<string, unknown>;\n  };\n  const entries = Object.entries(parsed.mcpServers ?? {});\n  const servers = await Promise.all(entries.map(([name, configured]) => priceServer(name, configured, options)));\n  return { servers, totalTokens: servers.reduce((total, server) => total + server.tokens, 0) };\n}\n"],"mappings":"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"}

package/dist/mcpSession.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_mcpSession = require("./src/schemas/mcpSession.cjs");
-exports.DOOM_MCP_SESSION_ENV_VAR = require_mcpSession.DOOM_MCP_SESSION_ENV_VAR;
-exports.DoomMcpSessionAllowlistSchema = require_mcpSession.DoomMcpSessionAllowlistSchema;
-exports.DoomMcpSessionConfigSchema = require_mcpSession.DoomMcpSessionConfigSchema;
-exports.doomMcpSessionEnvironment = require_mcpSession.doomMcpSessionEnvironment;
-exports.parseDoomMcpSessionConfig = require_mcpSession.parseDoomMcpSessionConfig;
-exports.readDoomMcpSessionConfig = require_mcpSession.readDoomMcpSessionConfig;
-exports.serializeDoomMcpSessionConfig = require_mcpSession.serializeDoomMcpSessionConfig;
+exports.PO_MCP_SESSION_ENV_VAR = require_mcpSession.PO_MCP_SESSION_ENV_VAR;
+exports.PoMcpSessionAllowlistSchema = require_mcpSession.PoMcpSessionAllowlistSchema;
+exports.PoMcpSessionConfigSchema = require_mcpSession.PoMcpSessionConfigSchema;
+exports.parsePoMcpSessionConfig = require_mcpSession.parsePoMcpSessionConfig;
+exports.poMcpSessionEnvironment = require_mcpSession.poMcpSessionEnvironment;
+exports.readPoMcpSessionConfig = require_mcpSession.readPoMcpSessionConfig;
+exports.serializePoMcpSessionConfig = require_mcpSession.serializePoMcpSessionConfig;

package/dist/mcpSession.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_MCP_SESSION_ENV_VAR, DoomMcpSessionAllowlist, DoomMcpSessionAllowlistSchema, DoomMcpSessionConfig, DoomMcpSessionConfigSchema, doomMcpSessionEnvironment, parseDoomMcpSessionConfig, readDoomMcpSessionConfig, serializeDoomMcpSessionConfig } from "./src/schemas/mcpSession.mjs";
-export { DOOM_MCP_SESSION_ENV_VAR, type DoomMcpSessionAllowlist, DoomMcpSessionAllowlistSchema, type DoomMcpSessionConfig, DoomMcpSessionConfigSchema, doomMcpSessionEnvironment, parseDoomMcpSessionConfig, readDoomMcpSessionConfig, serializeDoomMcpSessionConfig };
+import { PO_MCP_SESSION_ENV_VAR, PoMcpSessionAllowlist, PoMcpSessionAllowlistSchema, PoMcpSessionConfig, PoMcpSessionConfigSchema, parsePoMcpSessionConfig, poMcpSessionEnvironment, readPoMcpSessionConfig, serializePoMcpSessionConfig } from "./src/schemas/mcpSession.mjs";
+export { PO_MCP_SESSION_ENV_VAR, type PoMcpSessionAllowlist, PoMcpSessionAllowlistSchema, type PoMcpSessionConfig, PoMcpSessionConfigSchema, parsePoMcpSessionConfig, poMcpSessionEnvironment, readPoMcpSessionConfig, serializePoMcpSessionConfig };

package/dist/mcpSession.mjs

@@ -1,2 +1 @@
-import { DOOM_MCP_SESSION_ENV_VAR, DoomMcpSessionAllowlistSchema, DoomMcpSessionConfigSchema, doomMcpSessionEnvironment, parseDoomMcpSessionConfig, readDoomMcpSessionConfig, serializeDoomMcpSessionConfig } from "./src/schemas/mcpSession.mjs";
-export { DOOM_MCP_SESSION_ENV_VAR, DoomMcpSessionAllowlistSchema, DoomMcpSessionConfigSchema, doomMcpSessionEnvironment, parseDoomMcpSessionConfig, readDoomMcpSessionConfig, serializeDoomMcpSessionConfig };
+export { PO_MCP_SESSION_ENV_VAR, PoMcpSessionAllowlistSchema, PoMcpSessionConfigSchema, parsePoMcpSessionConfig, poMcpSessionEnvironment, readPoMcpSessionConfig, serializePoMcpSessionConfig } from "./src/schemas/mcpSession.mjs";

package/dist/mcpStatus.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_mcpStatus = require("./src/schemas/mcpStatus.cjs");
-exports.DOOM_MCP_STATUS_SERVICE = require_mcpStatus.DOOM_MCP_STATUS_SERVICE;
 exports.McpServerSnapshotSchema = require_mcpStatus.McpServerSnapshotSchema;
 exports.McpServerStateSchema = require_mcpStatus.McpServerStateSchema;
 exports.McpStatusSnapshotSchema = require_mcpStatus.McpStatusSnapshotSchema;
-exports.readDoomMcpStatus = require_mcpStatus.readDoomMcpStatus;
+exports.PO_MCP_STATUS_SERVICE = require_mcpStatus.PO_MCP_STATUS_SERVICE;
+exports.readPoMcpStatus = require_mcpStatus.readPoMcpStatus;

package/dist/mcpStatus.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_MCP_STATUS_SERVICE, DoomMcpStatusService, McpServerSnapshot, McpServerSnapshotSchema, McpServerState, McpServerStateSchema, McpStatusSnapshot, McpStatusSnapshotSchema, readDoomMcpStatus } from "./src/schemas/mcpStatus.mjs";
-export { DOOM_MCP_STATUS_SERVICE, type DoomMcpStatusService, type McpServerSnapshot, McpServerSnapshotSchema, type McpServerState, McpServerStateSchema, type McpStatusSnapshot, McpStatusSnapshotSchema, readDoomMcpStatus };
+import { McpServerSnapshot, McpServerSnapshotSchema, McpServerState, McpServerStateSchema, McpStatusSnapshot, McpStatusSnapshotSchema, PO_MCP_STATUS_SERVICE, PoMcpStatusService, readPoMcpStatus } from "./src/schemas/mcpStatus.mjs";
+export { type McpServerSnapshot, McpServerSnapshotSchema, type McpServerState, McpServerStateSchema, type McpStatusSnapshot, McpStatusSnapshotSchema, PO_MCP_STATUS_SERVICE, type PoMcpStatusService, readPoMcpStatus };

package/dist/mcpStatus.mjs

@@ -1,2 +1 @@
-import { DOOM_MCP_STATUS_SERVICE, McpServerSnapshotSchema, McpServerStateSchema, McpStatusSnapshotSchema, readDoomMcpStatus } from "./src/schemas/mcpStatus.mjs";
-export { DOOM_MCP_STATUS_SERVICE, McpServerSnapshotSchema, McpServerStateSchema, McpStatusSnapshotSchema, readDoomMcpStatus };
+export { McpServerSnapshotSchema, McpServerStateSchema, McpStatusSnapshotSchema, PO_MCP_STATUS_SERVICE, readPoMcpStatus } from "./src/schemas/mcpStatus.mjs";

package/dist/mcpToolResolver.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_mcpToolResolver = require("./src/schemas/mcpToolResolver.cjs");
-exports.DOOM_MCP_TOOL_RESOLVER_SERVICE = require_mcpToolResolver.DOOM_MCP_TOOL_RESOLVER_SERVICE;
-exports.readDoomMcpToolResolver = require_mcpToolResolver.readDoomMcpToolResolver;
-exports.requireDoomMcpToolResolver = require_mcpToolResolver.requireDoomMcpToolResolver;
+exports.PO_MCP_TOOL_RESOLVER_SERVICE = require_mcpToolResolver.PO_MCP_TOOL_RESOLVER_SERVICE;
+exports.readPoMcpToolResolver = require_mcpToolResolver.readPoMcpToolResolver;
+exports.requirePoMcpToolResolver = require_mcpToolResolver.requirePoMcpToolResolver;

package/dist/mcpToolResolver.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_MCP_TOOL_RESOLVER_SERVICE, DoomMcpResolvedToolSelection, DoomMcpToolResolverService, readDoomMcpToolResolver, requireDoomMcpToolResolver } from "./src/schemas/mcpToolResolver.mjs";
-export { DOOM_MCP_TOOL_RESOLVER_SERVICE, type DoomMcpResolvedToolSelection, type DoomMcpToolResolverService, readDoomMcpToolResolver, requireDoomMcpToolResolver };
+import { PO_MCP_TOOL_RESOLVER_SERVICE, PoMcpResolvedToolSelection, PoMcpToolResolverService, readPoMcpToolResolver, requirePoMcpToolResolver } from "./src/schemas/mcpToolResolver.mjs";
+export { PO_MCP_TOOL_RESOLVER_SERVICE, type PoMcpResolvedToolSelection, type PoMcpToolResolverService, readPoMcpToolResolver, requirePoMcpToolResolver };

package/dist/mcpToolResolver.mjs

@@ -1,2 +1 @@
-import { DOOM_MCP_TOOL_RESOLVER_SERVICE, readDoomMcpToolResolver, requireDoomMcpToolResolver } from "./src/schemas/mcpToolResolver.mjs";
-export { DOOM_MCP_TOOL_RESOLVER_SERVICE, readDoomMcpToolResolver, requireDoomMcpToolResolver };
+export { PO_MCP_TOOL_RESOLVER_SERVICE, readPoMcpToolResolver, requirePoMcpToolResolver } from "./src/schemas/mcpToolResolver.mjs";

package/dist/mcpWidget.d.mts

@@ -1,2 +1,2 @@
-import { DoomMcpWidgetProps } from "./src/web/types/mcpWidget.mjs";
-export type { DoomMcpWidgetProps };
+import { PoMcpWidgetProps } from "./src/web/types/mcpWidget.mjs";
+export type { PoMcpWidgetProps };

package/dist/moduleResolution.cjs

@@ -1,6 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
-const require_runtimePiSettings = require("./runtimePiSettings.cjs");
+const require_core = require("./src/services/piSettings/core.cjs");
+require("./runtimePiSettings.cjs");
+const require_index = require("./src/services/testMode/index.cjs");
 let node_fs = require("node:fs");
 node_fs = require_runtime.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -126,6 +128,24 @@ function packageEntry(name, origin = require("url").pathToFileURL(__filename).hr
 	if (!entry) throw new Error(`Cannot resolve package entry ${name} from ${origin}`);
 	return node_fs.default.realpathSync(entry);
 }
+/**
+* The entry a module running from a Po checkout finds in that checkout's own closure.
+* A checkout package is never an implicit override for a consumer, so callers try
+* the consumer first and use this only as the last resort.
+*/
+function checkoutPackageEntry(name, origin) {
+	const from = node_path.default.dirname((0, node_url.fileURLToPath)(origin));
+	if (!runsFromCheckout(from)) return void 0;
+	const entry = packageRootEntry(name, from, findInstalledPackage(splitPackageSpecifier(name).name, from));
+	return entry === void 0 ? void 0 : node_fs.default.realpathSync(entry);
+}
+/** Whether the package that owns this directory is a package of a Po source checkout. */
+function runsFromCheckout(directory) {
+	for (let current = directory;; current = node_path.default.dirname(current)) {
+		if (node_fs.default.existsSync(node_path.default.join(current, PACKAGE_MANIFEST))) return require_index.isCheckoutPoPackage(current);
+		if (node_path.default.dirname(current) === current) return false;
+	}
+}
 /** Same as packageEntry, but returns undefined when the package is absent. */
 function optionalPackageEntry(name, origin = require("url").pathToFileURL(__filename).href) {
 	try {
@@ -184,12 +204,20 @@ function findInstalledPackage(name, consumerRoot) {
 		directory = parent;
 	}
 }
+/** Checkout package overrides inherited by the web, server and sync children of `po --test`. */
+function testPackageRoot(name, environment = process.env) {
+	if (environment.PO_TEST !== "1" || !environment.PO_TEST_PACKAGES) return void 0;
+	const packages = JSON.parse(environment.PO_TEST_PACKAGES);
+	if (!isRecord(packages)) throw new Error("PO_TEST_PACKAGES must be a package-to-directory map.");
+	const root = packages[name];
+	return typeof root === "string" ? root : void 0;
+}
 /**
 * Finds a package Po installed into its shared runtime (`<po home>/runtime`),
 * without touching the consumer's own package manifest.
 */
 function findRuntimePackage(name, environment) {
-	const candidate = node_path.default.join(require_runtimePiSettings.poRuntimeDirectory(void 0, environment), NODE_MODULES, name);
+	const candidate = node_path.default.join(require_core.poRuntimeDirectory(void 0, environment), NODE_MODULES, name);
 	return node_fs.default.existsSync(node_path.default.join(candidate, PACKAGE_MANIFEST)) ? candidate : void 0;
 }
 /**
@@ -199,7 +227,7 @@ function findRuntimePackage(name, environment) {
 * counts.
 */
 function runtimePackageDeclared(name, environment) {
-	const manifestPath = node_path.default.join(require_runtimePiSettings.poRuntimeDirectory(void 0, environment), PACKAGE_MANIFEST);
+	const manifestPath = node_path.default.join(require_core.poRuntimeDirectory(void 0, environment), PACKAGE_MANIFEST);
 	if (!node_fs.default.existsSync(manifestPath)) return true;
 	try {
 		return name in (JSON.parse(node_fs.default.readFileSync(manifestPath, "utf8")).dependencies ?? {});
@@ -216,10 +244,12 @@ function runtimePackageDeclared(name, environment) {
 * their state split between them.
 */
 function findConsumerPackage(name, consumerRoot, environment) {
+	const local = testPackageRoot(name, environment);
+	if (local !== void 0) return local;
 	const installed = findInstalledPackage(name, consumerRoot);
-	if (installed) return installed;
+	if (installed && (environment.PO_TEST === "1" || !require_index.isCheckoutPoPackage(installed))) return installed;
 	const runtime = findRuntimePackage(name, environment);
-	return runtime && runtimePackageDeclared(name, environment) ? runtime : void 0;
+	return runtime && (environment.PO_TEST === "1" || !require_index.isCheckoutPoPackage(runtime)) && runtimePackageDeclared(name, environment) ? runtime : void 0;
 }
 /** Resolves every extension declared by a bare package's standard Pi manifest. */
 function packageEntries(specifier, origin = require("url").pathToFileURL(__filename).href) {
@@ -245,7 +275,7 @@ function optionalPackageEntries(specifier, origin = require("url").pathToFileURL
 * Resolves manifest entries from the consumer repository's dependency tree.
 *
 * The meta-package cannot resolve what the repository declares: under an
-* isolated node_modules layout Doom Pi only sees its own dependencies. Walking
+* isolated node_modules layout Po Pi only sees its own dependencies. Walking
 * the consumer's module chain lets its package manifest answer first without
 * accidentally falling through to Po's dependency tree.
 */
@@ -266,9 +296,12 @@ function consumerPackageEntries(specifier, consumerRoot, environment = process.e
 * `environment` names the Po home whose shared runtime answers after the consumer's own tree.
 */
 function consumerPackageEntry(specifier, consumerRoot, environment = process.env) {
-	const { name, subpath } = splitPackageSpecifier(specifier);
-	const packageRoot = findConsumerPackage(name, consumerRoot, environment);
+	return packageRootEntry(specifier, consumerRoot, findConsumerPackage(splitPackageSpecifier(specifier).name, consumerRoot, environment));
+}
+/** One export or package-relative path of an already located package. */
+function packageRootEntry(specifier, consumerRoot, packageRoot) {
 	if (!packageRoot) return void 0;
+	const { subpath } = splitPackageSpecifier(specifier);
 	if (subpath === ".") return localEntry(packageRoot, consumerRoot) ?? extensionIndexEntry(packageRoot);
 	const manifestPath = node_path.default.join(packageRoot, PACKAGE_MANIFEST);
 	const directTarget = node_path.default.join(packageRoot, subpath);
@@ -395,6 +428,7 @@ function piCliPath() {
 	return node_path.default.join(node_path.default.dirname(packageEntry("@earendil-works/pi-coding-agent")), "cli.js");
 }
 //#endregion
+exports.checkoutPackageEntry = checkoutPackageEntry;
 exports.consumerPackageEntries = consumerPackageEntries;
 exports.consumerPackageEntry = consumerPackageEntry;
 exports.localEntries = localEntries;
@@ -408,5 +442,6 @@ exports.packageEntries = packageEntries;
 exports.packageEntry = packageEntry;
 exports.piCliPath = piCliPath;
 exports.splitPackageSpecifier = splitPackageSpecifier;
+exports.testPackageRoot = testPackageRoot;
 
 //# sourceMappingURL=moduleResolution.cjs.map

package/dist/moduleResolution.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"moduleResolution.cjs","names":["fs","path","fileURLToPath","poRuntimeDirectory"],"sources":["../src/services/moduleResolution/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { minimatch } from 'minimatch';\n\nimport { poRuntimeDirectory } from '../piSettings';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst NODE_MODULES = 'node_modules';\nconst CURRENT_DIRECTORY_PREFIX = './';\nconst MANIFEST_PATTERN_PREFIXES = ['!', '+', '-'] as const;\nconst GLOB_CHARACTERS = /[*?[\\]{}()]/;\nconst EXTENSION_INDEX_NAMES = ['index.ts', 'index.js', 'index.mts', 'index.mjs', 'index.cts', 'index.cjs'] as const;\nconst EXTENSION_FILE_SUFFIXES = new Set(['.ts', '.js', '.mts', '.mjs', '.cts', '.cjs']);\n/** Import-side conditions, in the order Node prefers them for an ESM consumer. */\nconst IMPORT_CONDITIONS = ['import', 'module', 'node', 'default'] as const;\n\ninterface PackageManifest {\n  name?: unknown;\n  exports?: unknown;\n  module?: unknown;\n  main?: unknown;\n  pi?: unknown;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction readPackageManifest(packageRoot: string): PackageManifest | undefined {\n  try {\n    const parsed: unknown = JSON.parse(fs.readFileSync(path.join(packageRoot, PACKAGE_MANIFEST), 'utf8'));\n    return isRecord(parsed) ? parsed : undefined;\n  } catch {\n    // An unreadable manifest is equivalent to an absent package declaration;\n    // the normal export resolver remains available as the compatibility path.\n    return undefined;\n  }\n}\n\nfunction manifestDeclaresExtensions(manifest: PackageManifest | undefined): boolean {\n  return Boolean(manifest && isRecord(manifest.pi) && Object.hasOwn(manifest.pi, 'extensions'));\n}\n\nfunction isManifestPattern(entry: string): boolean {\n  return MANIFEST_PATTERN_PREFIXES.some((prefix) => entry.startsWith(prefix));\n}\n\nfunction normalizedRelativePath(packageRoot: string, target: string): string {\n  return path.relative(packageRoot, target).split(path.sep).join('/');\n}\n\nfunction matchesManifestPattern(target: string, pattern: string, packageRoot: string): boolean {\n  const normalizedPattern = pattern.replaceAll('\\\\', '/').replace(/^\\.\\//, '');\n  const relative = normalizedRelativePath(packageRoot, target);\n  return (\n    minimatch(relative, normalizedPattern) ||\n    minimatch(path.basename(target), normalizedPattern) ||\n    minimatch(target.split(path.sep).join('/'), normalizedPattern)\n  );\n}\n\nfunction matchesExactManifestPath(target: string, pattern: string, packageRoot: string): boolean {\n  const normalizedPattern = pattern.replaceAll('\\\\', '/').replace(/^\\.\\//, '');\n  return (\n    normalizedRelativePath(packageRoot, target) === normalizedPattern ||\n    target.split(path.sep).join('/') === normalizedPattern\n  );\n}\n\nfunction extensionIndexEntry(directory: string): string | undefined {\n  for (const indexName of EXTENSION_INDEX_NAMES) {\n    const candidate = path.join(directory, indexName);\n    if (fs.existsSync(candidate)) return candidate;\n  }\n  return undefined;\n}\n\nfunction extensionFilesAt(target: string): string[] {\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return [];\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return [];\n\n  const files: string[] = [];\n  for (const entry of fs\n    .readdirSync(target, { withFileTypes: true })\n    .sort((left, right) => left.name.localeCompare(right.name))) {\n    const entryPath = path.join(target, entry.name);\n    if ((entry.isFile() || entry.isSymbolicLink()) && EXTENSION_FILE_SUFFIXES.has(path.extname(entry.name))) {\n      files.push(entryPath);\n      continue;\n    }\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n    const indexEntry = extensionIndexEntry(entryPath);\n    if (indexEntry) files.push(indexEntry);\n  }\n  return files;\n}\n\n/** Resolves the standard package.json pi.extensions declaration exactly as a layer contribution. */\nfunction manifestExtensionEntries(\n  packageRoot: string,\n  manifest: PackageManifest | undefined,\n  packageName: string,\n): string[] | undefined {\n  if (!manifestDeclaresExtensions(manifest) || !isRecord(manifest?.pi)) return undefined;\n  const configured = manifest.pi.extensions;\n  if (!Array.isArray(configured) || !configured.every((entry) => typeof entry === 'string')) {\n    throw new Error(`${packageName} package.json pi.extensions must be an array of strings.`);\n  }\n\n  const allPaths: string[] = [];\n  for (const configuredEntry of configured.filter((entry) => !isManifestPattern(entry))) {\n    const candidates = GLOB_CHARACTERS.test(configuredEntry)\n      ? fs.globSync(configuredEntry, { cwd: packageRoot }).sort()\n      : [configuredEntry];\n    for (const candidate of candidates) {\n      for (const target of extensionFilesAt(path.resolve(packageRoot, candidate))) {\n        if (!allPaths.includes(target)) allPaths.push(target);\n      }\n    }\n  }\n\n  const excluded = configured.filter((entry) => entry.startsWith('!')).map((entry) => entry.slice(1));\n  const forceIncluded = configured.filter((entry) => entry.startsWith('+')).map((entry) => entry.slice(1));\n  const forceExcluded = configured.filter((entry) => entry.startsWith('-')).map((entry) => entry.slice(1));\n  const selected = allPaths.filter(\n    (target) => !excluded.some((pattern) => matchesManifestPattern(target, pattern, packageRoot)),\n  );\n  for (const target of allPaths) {\n    if (\n      !selected.includes(target) &&\n      forceIncluded.some((pattern) => matchesExactManifestPath(target, pattern, packageRoot))\n    ) {\n      selected.push(target);\n    }\n  }\n  const filtered = selected.filter(\n    (target) => !forceExcluded.some((pattern) => matchesExactManifestPath(target, pattern, packageRoot)),\n  );\n  return filtered.length > 0 ? filtered : undefined;\n}\n\n/**\n * Resolves the on-disk entry point of an installed package.\n *\n * Pi loads extensions by absolute path, so anything contributed as an\n * extension has to be resolved to a file before it can be passed along.\n */\nexport function packageEntry(name: string, origin: string = import.meta.url): string {\n  const entry = consumerPackageEntry(name, path.dirname(fileURLToPath(origin)));\n  if (!entry) throw new Error(`Cannot resolve package entry ${name} from ${origin}`);\n  return fs.realpathSync(entry);\n}\n\n/** Same as packageEntry, but returns undefined when the package is absent. */\nexport function optionalPackageEntry(name: string, origin: string = import.meta.url): string | undefined {\n  try {\n    return packageEntry(name, origin);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Splits `@scope/name/sub/path` into the package name and its export subpath.\n *\n * A scoped name owns two segments, an unscoped name one. Everything after that\n * is the subpath the package's own `exports` map has to answer for.\n */\nexport function splitPackageSpecifier(specifier: string): { name: string; subpath: string } {\n  const segments = specifier.split('/');\n  const nameSegments = specifier.startsWith('@') ? 2 : 1;\n  const name = segments.slice(0, nameSegments).join('/');\n  const rest = segments.slice(nameSegments).join('/');\n  return { name, subpath: rest ? `${CURRENT_DIRECTORY_PREFIX}${rest}` : '.' };\n}\n\n/** Picks the import-side target out of one `exports` entry. */\nfunction selectImportTarget(value: unknown): string | undefined {\n  if (typeof value === 'string') return value;\n  if (Array.isArray(value)) {\n    for (const candidate of value) {\n      const target = selectImportTarget(candidate);\n      if (target) return target;\n    }\n    return undefined;\n  }\n  if (typeof value !== 'object' || value === null) return undefined;\n  const conditions = value as Record<string, unknown>;\n  for (const condition of IMPORT_CONDITIONS) {\n    if (condition in conditions) {\n      const target = selectImportTarget(conditions[condition]);\n      if (target) return target;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Finds an installed package directory by walking the consumer's module chain.\n *\n * Node's own lookup order, so a workspace link in the repository root is found\n * exactly where the repository installed it, and nothing outside that chain can\n * answer for a specifier the repository declared.\n */\nfunction findInstalledPackage(name: string, consumerRoot: string): string | undefined {\n  let directory = path.resolve(consumerRoot);\n  while (true) {\n    const candidate = path.join(directory, NODE_MODULES, name);\n    if (fs.existsSync(path.join(candidate, PACKAGE_MANIFEST))) return candidate;\n    const parent = path.dirname(directory);\n    if (parent === directory) return undefined;\n    directory = parent;\n  }\n}\n\n/** The environment a lookup runs for; it names the Po home, and so the shared runtime. */\ntype LookupEnvironment = Readonly<Record<string, string | undefined>>;\n\n/**\n * Finds a package Po installed into its shared runtime (`<po home>/runtime`),\n * without touching the consumer's own package manifest.\n */\nfunction findRuntimePackage(name: string, environment: LookupEnvironment): string | undefined {\n  const candidate = path.join(poRuntimeDirectory(undefined, environment), NODE_MODULES, name);\n  return fs.existsSync(path.join(candidate, PACKAGE_MANIFEST)) ? candidate : undefined;\n}\n\n/**\n * Whether a Po root asked for this package, rather than it arriving\n * transitively. The runtime's manifest is that list, shared by every root; a\n * runtime without one has nothing to check against and every package in it\n * counts.\n */\nfunction runtimePackageDeclared(name: string, environment: LookupEnvironment): boolean {\n  const manifestPath = path.join(poRuntimeDirectory(undefined, environment), PACKAGE_MANIFEST);\n  if (!fs.existsSync(manifestPath)) return true;\n  try {\n    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { dependencies?: Record<string, unknown> };\n    return name in (manifest.dependencies ?? {});\n  } catch {\n    // An unreadable manifest declares nothing, so the runtime answers for nothing.\n    return false;\n  }\n}\n\n/**\n * The consumer's own dependency tree answers first, then the packages a Po\n * root asked the shared runtime for. A package that merely arrived in the\n * runtime as a dependency of one of those (po-config beneath a layer package,\n * say) is not the answer: declining lets the caller's fallback resolve it from\n * Po's own tree, so one session never loads two copies of a core package with\n * their state split between them.\n */\nfunction findConsumerPackage(name: string, consumerRoot: string, environment: LookupEnvironment): string | undefined {\n  const installed = findInstalledPackage(name, consumerRoot);\n  if (installed) return installed;\n  const runtime = findRuntimePackage(name, environment);\n  return runtime && runtimePackageDeclared(name, environment) ? runtime : undefined;\n}\n\n/** Resolves every extension declared by a bare package's standard Pi manifest. */\nexport function packageEntries(specifier: string, origin: string = import.meta.url): string[] {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  if (subpath !== '.') return [packageEntry(specifier, origin)];\n\n  const packageRoot = findInstalledPackage(name, path.dirname(fileURLToPath(origin)));\n  if (!packageRoot) throw new Error(`Cannot resolve package ${name}.`);\n  const manifest = readPackageManifest(packageRoot);\n  if (!manifestDeclaresExtensions(manifest)) {\n    throw new Error(`${name} package.json does not declare pi.extensions.`);\n  }\n  const manifestEntries = manifestExtensionEntries(packageRoot, manifest, name);\n  if (!manifestEntries?.length) throw new Error(`${name} package.json pi.extensions resolves no extension files.`);\n  return manifestEntries;\n}\n\n/** Same as packageEntries, but returns undefined when the package is absent. */\nexport function optionalPackageEntries(specifier: string, origin: string = import.meta.url): string[] | undefined {\n  try {\n    return packageEntries(specifier, origin);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolves manifest entries from the consumer repository's dependency tree.\n *\n * The meta-package cannot resolve what the repository declares: under an\n * isolated node_modules layout Doom Pi only sees its own dependencies. Walking\n * the consumer's module chain lets its package manifest answer first without\n * accidentally falling through to Po's dependency tree.\n */\nexport function consumerPackageEntries(\n  specifier: string,\n  consumerRoot: string,\n  environment: LookupEnvironment = process.env,\n): string[] | undefined {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  const packageRoot = findConsumerPackage(name, consumerRoot, environment);\n  if (!packageRoot) return undefined;\n  if (subpath === '.') {\n    const manifest = readPackageManifest(packageRoot);\n    if (!manifestDeclaresExtensions(manifest)) return [];\n    return manifestExtensionEntries(packageRoot, manifest, name) ?? [];\n  }\n  const entry = consumerPackageEntry(specifier, consumerRoot, environment);\n  return entry ? [entry] : [];\n}\n\n/**\n * Resolves one explicit package export or direct package-relative path from the consumer.\n * `environment` names the Po home whose shared runtime answers after the consumer's own tree.\n */\nexport function consumerPackageEntry(\n  specifier: string,\n  consumerRoot: string,\n  environment: LookupEnvironment = process.env,\n): string | undefined {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  const packageRoot = findConsumerPackage(name, consumerRoot, environment);\n  if (!packageRoot) return undefined;\n\n  if (subpath === '.') return localEntry(packageRoot, consumerRoot) ?? extensionIndexEntry(packageRoot);\n\n  const manifestPath = path.join(packageRoot, PACKAGE_MANIFEST);\n  // A relative subpath that the package does not export is still loadable by\n  // path, which is how layers point at a file inside a package (`.../index.ts`).\n  const directTarget = path.join(packageRoot, subpath);\n  let manifest: { exports?: unknown };\n  try {\n    manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { exports?: unknown };\n  } catch {\n    return fs.existsSync(directTarget) ? directTarget : undefined;\n  }\n\n  const exports = manifest.exports;\n  if (exports !== undefined && exports !== null) {\n    const entry =\n      typeof exports === 'object' && !Array.isArray(exports)\n        ? (exports as Record<string, unknown>)[subpath]\n        : undefined;\n    const target = selectImportTarget(entry);\n    if (target) {\n      const resolved = path.join(packageRoot, target);\n      if (fs.existsSync(resolved)) return resolved;\n    }\n  }\n\n  return fs.existsSync(directTarget) ? directTarget : undefined;\n}\n\n/** Resolves one exports subpath from a path-style package directory. */\nexport function localPackageExport(specifier: string, baseDirectory: string, subpath: string): string | undefined {\n  const packageRoot = path.resolve(baseDirectory, specifier);\n  const manifest = readPackageManifest(packageRoot);\n  const exports = manifest?.exports;\n  if (exports === undefined || exports === null) return undefined;\n  const target = selectImportTarget(isRecord(exports) ? exports[subpath] : undefined);\n  if (!target) return undefined;\n  const resolved = path.join(packageRoot, target);\n  return fs.existsSync(resolved) ? resolved : undefined;\n}\n\n/** Manifest fields consulted when a local package declares no `exports`. */\nconst MAIN_FIELDS = ['module', 'main'] as const;\n\n/**\n * Returns the canonical name of a path-style package directory.\n *\n * A direct file is intentionally anonymous: treating the repository manifest\n * above it as the file's identity would collapse every local extension in that\n * repository. Only a directory with its own named manifest represents a package\n * that can replace another installed version by logical identity.\n */\nexport function localPackageName(specifier: string, baseDirectory: string): string | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  try {\n    if (!fs.statSync(target).isDirectory()) return undefined;\n    const manifest = JSON.parse(fs.readFileSync(path.join(target, PACKAGE_MANIFEST), 'utf8')) as {\n      name?: unknown;\n    };\n    return typeof manifest.name === 'string' && manifest.name.trim() ? manifest.name.trim() : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolves Pi extension entries from a local file, extension directory, or package.\n *\n * A file is taken as the extension entry as written. A package directory uses\n * its native `pi.extensions` declaration or legacy root entry. A plain directory\n * follows Pi's extension discovery convention for scripts and child `index`\n * modules. This lets unpublished extensions live in the repository, or beside\n * the global config in `~/.po`, and still load in deterministic order.\n */\nexport function localEntries(specifier: string, baseDirectory: string): string[] | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return undefined;\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return undefined;\n\n  const manifest = readPackageManifest(target);\n  const manifestEntries = manifestExtensionEntries(\n    target,\n    manifest,\n    localPackageName(specifier, baseDirectory) ?? target,\n  );\n  if (manifestEntries !== undefined) return manifestEntries;\n  const entry = localEntry(specifier, baseDirectory);\n  return entry ? [entry] : extensionFilesAt(target);\n}\n\n/**\n * Resolves a local package selection through its standard Pi manifest.\n * Direct files and extension directories remain valid explicit local paths.\n */\nexport function localPackageEntries(specifier: string, baseDirectory: string): string[] | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return undefined;\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return undefined;\n\n  const manifestPath = path.join(target, PACKAGE_MANIFEST);\n  if (!fs.existsSync(manifestPath)) return extensionFilesAt(target);\n  const manifest = readPackageManifest(target);\n  if (!manifestDeclaresExtensions(manifest)) return [];\n  return manifestExtensionEntries(target, manifest, localPackageName(specifier, baseDirectory) ?? target) ?? [];\n}\n\n/** Resolves the legacy single entry from a local package's exports, module, or main field. */\nexport function localEntry(specifier: string, baseDirectory: string): string | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let isDirectory: boolean;\n  try {\n    const stats = fs.statSync(target);\n    if (stats.isFile()) return target;\n    isDirectory = stats.isDirectory();\n  } catch {\n    return undefined;\n  }\n  if (!isDirectory) return undefined;\n\n  let manifest: { exports?: unknown; module?: unknown; main?: unknown };\n  try {\n    manifest = JSON.parse(fs.readFileSync(path.join(target, PACKAGE_MANIFEST), 'utf8')) as typeof manifest;\n  } catch {\n    return undefined;\n  }\n\n  const exports = manifest.exports;\n  const rootExport =\n    typeof exports === 'object' && exports !== null && !Array.isArray(exports)\n      ? ((exports as Record<string, unknown>)['.'] ?? exports)\n      : exports;\n  const candidates = [selectImportTarget(rootExport)];\n  for (const field of MAIN_FIELDS) {\n    if (typeof manifest[field] === 'string') candidates.push(manifest[field]);\n  }\n\n  for (const candidate of candidates) {\n    if (!candidate) continue;\n    const resolved = path.join(target, candidate);\n    if (fs.existsSync(resolved)) return resolved;\n  }\n  return extensionIndexEntry(target);\n}\n\n/** Path to Pi's own CLI, which the launch command spawns. */\nexport function piCliPath(): string {\n  return path.join(path.dirname(packageEntry('@earendil-works/pi-coding-agent')), 'cli.js');\n}\n"],"mappings":"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"}
+{"version":3,"file":"moduleResolution.cjs","names":["fs","path","fileURLToPath","isCheckoutPoPackage","poRuntimeDirectory"],"sources":["../src/services/moduleResolution/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { minimatch } from 'minimatch';\n\nimport { poRuntimeDirectory } from '../piSettings';\nimport { isCheckoutPoPackage } from '../testMode';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst NODE_MODULES = 'node_modules';\nconst CURRENT_DIRECTORY_PREFIX = './';\nconst MANIFEST_PATTERN_PREFIXES = ['!', '+', '-'] as const;\nconst GLOB_CHARACTERS = /[*?[\\]{}()]/;\nconst EXTENSION_INDEX_NAMES = ['index.ts', 'index.js', 'index.mts', 'index.mjs', 'index.cts', 'index.cjs'] as const;\nconst EXTENSION_FILE_SUFFIXES = new Set(['.ts', '.js', '.mts', '.mjs', '.cts', '.cjs']);\n/** Import-side conditions, in the order Node prefers them for an ESM consumer. */\nconst IMPORT_CONDITIONS = ['import', 'module', 'node', 'default'] as const;\n\ninterface PackageManifest {\n  name?: unknown;\n  exports?: unknown;\n  module?: unknown;\n  main?: unknown;\n  pi?: unknown;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction readPackageManifest(packageRoot: string): PackageManifest | undefined {\n  try {\n    const parsed: unknown = JSON.parse(fs.readFileSync(path.join(packageRoot, PACKAGE_MANIFEST), 'utf8'));\n    return isRecord(parsed) ? parsed : undefined;\n  } catch {\n    // An unreadable manifest is equivalent to an absent package declaration;\n    // the normal export resolver remains available as the compatibility path.\n    return undefined;\n  }\n}\n\nfunction manifestDeclaresExtensions(manifest: PackageManifest | undefined): boolean {\n  return Boolean(manifest && isRecord(manifest.pi) && Object.hasOwn(manifest.pi, 'extensions'));\n}\n\nfunction isManifestPattern(entry: string): boolean {\n  return MANIFEST_PATTERN_PREFIXES.some((prefix) => entry.startsWith(prefix));\n}\n\nfunction normalizedRelativePath(packageRoot: string, target: string): string {\n  return path.relative(packageRoot, target).split(path.sep).join('/');\n}\n\nfunction matchesManifestPattern(target: string, pattern: string, packageRoot: string): boolean {\n  const normalizedPattern = pattern.replaceAll('\\\\', '/').replace(/^\\.\\//, '');\n  const relative = normalizedRelativePath(packageRoot, target);\n  return (\n    minimatch(relative, normalizedPattern) ||\n    minimatch(path.basename(target), normalizedPattern) ||\n    minimatch(target.split(path.sep).join('/'), normalizedPattern)\n  );\n}\n\nfunction matchesExactManifestPath(target: string, pattern: string, packageRoot: string): boolean {\n  const normalizedPattern = pattern.replaceAll('\\\\', '/').replace(/^\\.\\//, '');\n  return (\n    normalizedRelativePath(packageRoot, target) === normalizedPattern ||\n    target.split(path.sep).join('/') === normalizedPattern\n  );\n}\n\nfunction extensionIndexEntry(directory: string): string | undefined {\n  for (const indexName of EXTENSION_INDEX_NAMES) {\n    const candidate = path.join(directory, indexName);\n    if (fs.existsSync(candidate)) return candidate;\n  }\n  return undefined;\n}\n\nfunction extensionFilesAt(target: string): string[] {\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return [];\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return [];\n\n  const files: string[] = [];\n  for (const entry of fs\n    .readdirSync(target, { withFileTypes: true })\n    .sort((left, right) => left.name.localeCompare(right.name))) {\n    const entryPath = path.join(target, entry.name);\n    if ((entry.isFile() || entry.isSymbolicLink()) && EXTENSION_FILE_SUFFIXES.has(path.extname(entry.name))) {\n      files.push(entryPath);\n      continue;\n    }\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n    const indexEntry = extensionIndexEntry(entryPath);\n    if (indexEntry) files.push(indexEntry);\n  }\n  return files;\n}\n\n/** Resolves the standard package.json pi.extensions declaration exactly as a layer contribution. */\nfunction manifestExtensionEntries(\n  packageRoot: string,\n  manifest: PackageManifest | undefined,\n  packageName: string,\n): string[] | undefined {\n  if (!manifestDeclaresExtensions(manifest) || !isRecord(manifest?.pi)) return undefined;\n  const configured = manifest.pi.extensions;\n  if (!Array.isArray(configured) || !configured.every((entry) => typeof entry === 'string')) {\n    throw new Error(`${packageName} package.json pi.extensions must be an array of strings.`);\n  }\n\n  const allPaths: string[] = [];\n  for (const configuredEntry of configured.filter((entry) => !isManifestPattern(entry))) {\n    const candidates = GLOB_CHARACTERS.test(configuredEntry)\n      ? fs.globSync(configuredEntry, { cwd: packageRoot }).sort()\n      : [configuredEntry];\n    for (const candidate of candidates) {\n      for (const target of extensionFilesAt(path.resolve(packageRoot, candidate))) {\n        if (!allPaths.includes(target)) allPaths.push(target);\n      }\n    }\n  }\n\n  const excluded = configured.filter((entry) => entry.startsWith('!')).map((entry) => entry.slice(1));\n  const forceIncluded = configured.filter((entry) => entry.startsWith('+')).map((entry) => entry.slice(1));\n  const forceExcluded = configured.filter((entry) => entry.startsWith('-')).map((entry) => entry.slice(1));\n  const selected = allPaths.filter(\n    (target) => !excluded.some((pattern) => matchesManifestPattern(target, pattern, packageRoot)),\n  );\n  for (const target of allPaths) {\n    if (\n      !selected.includes(target) &&\n      forceIncluded.some((pattern) => matchesExactManifestPath(target, pattern, packageRoot))\n    ) {\n      selected.push(target);\n    }\n  }\n  const filtered = selected.filter(\n    (target) => !forceExcluded.some((pattern) => matchesExactManifestPath(target, pattern, packageRoot)),\n  );\n  return filtered.length > 0 ? filtered : undefined;\n}\n\n/**\n * Resolves the on-disk entry point of an installed package.\n *\n * Pi loads extensions by absolute path, so anything contributed as an\n * extension has to be resolved to a file before it can be passed along.\n */\nexport function packageEntry(name: string, origin: string = import.meta.url): string {\n  const from = path.dirname(fileURLToPath(origin));\n  const entry = consumerPackageEntry(name, from);\n  if (!entry) throw new Error(`Cannot resolve package entry ${name} from ${origin}`);\n  return fs.realpathSync(entry);\n}\n\n/**\n * The entry a module running from a Po checkout finds in that checkout's own closure.\n * A checkout package is never an implicit override for a consumer, so callers try\n * the consumer first and use this only as the last resort.\n */\nexport function checkoutPackageEntry(name: string, origin: string): string | undefined {\n  const from = path.dirname(fileURLToPath(origin));\n  if (!runsFromCheckout(from)) return undefined;\n  const entry = packageRootEntry(name, from, findInstalledPackage(splitPackageSpecifier(name).name, from));\n  return entry === undefined ? undefined : fs.realpathSync(entry);\n}\n\n/** Whether the package that owns this directory is a package of a Po source checkout. */\nfunction runsFromCheckout(directory: string): boolean {\n  for (let current = directory; ; current = path.dirname(current)) {\n    if (fs.existsSync(path.join(current, PACKAGE_MANIFEST))) return isCheckoutPoPackage(current);\n    if (path.dirname(current) === current) return false;\n  }\n}\n\n/** Same as packageEntry, but returns undefined when the package is absent. */\nexport function optionalPackageEntry(name: string, origin: string = import.meta.url): string | undefined {\n  try {\n    return packageEntry(name, origin);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Splits `@scope/name/sub/path` into the package name and its export subpath.\n *\n * A scoped name owns two segments, an unscoped name one. Everything after that\n * is the subpath the package's own `exports` map has to answer for.\n */\nexport function splitPackageSpecifier(specifier: string): { name: string; subpath: string } {\n  const segments = specifier.split('/');\n  const nameSegments = specifier.startsWith('@') ? 2 : 1;\n  const name = segments.slice(0, nameSegments).join('/');\n  const rest = segments.slice(nameSegments).join('/');\n  return { name, subpath: rest ? `${CURRENT_DIRECTORY_PREFIX}${rest}` : '.' };\n}\n\n/** Picks the import-side target out of one `exports` entry. */\nfunction selectImportTarget(value: unknown): string | undefined {\n  if (typeof value === 'string') return value;\n  if (Array.isArray(value)) {\n    for (const candidate of value) {\n      const target = selectImportTarget(candidate);\n      if (target) return target;\n    }\n    return undefined;\n  }\n  if (typeof value !== 'object' || value === null) return undefined;\n  const conditions = value as Record<string, unknown>;\n  for (const condition of IMPORT_CONDITIONS) {\n    if (condition in conditions) {\n      const target = selectImportTarget(conditions[condition]);\n      if (target) return target;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Finds an installed package directory by walking the consumer's module chain.\n *\n * Node's own lookup order, so a workspace link in the repository root is found\n * exactly where the repository installed it, and nothing outside that chain can\n * answer for a specifier the repository declared.\n */\nfunction findInstalledPackage(name: string, consumerRoot: string): string | undefined {\n  let directory = path.resolve(consumerRoot);\n  while (true) {\n    const candidate = path.join(directory, NODE_MODULES, name);\n    if (fs.existsSync(path.join(candidate, PACKAGE_MANIFEST))) return candidate;\n    const parent = path.dirname(directory);\n    if (parent === directory) return undefined;\n    directory = parent;\n  }\n}\n\n/** The environment a lookup runs for; it names the Po home, and so the shared runtime. */\ntype LookupEnvironment = Readonly<Record<string, string | undefined>>;\n\n/** Checkout package overrides inherited by the web, server and sync children of `po --test`. */\nexport function testPackageRoot(name: string, environment: LookupEnvironment = process.env): string | undefined {\n  if (environment.PO_TEST !== '1' || !environment.PO_TEST_PACKAGES) return undefined;\n  const packages: unknown = JSON.parse(environment.PO_TEST_PACKAGES);\n  if (!isRecord(packages)) throw new Error('PO_TEST_PACKAGES must be a package-to-directory map.');\n  const root = packages[name];\n  return typeof root === 'string' ? root : undefined;\n}\n\n/**\n * Finds a package Po installed into its shared runtime (`<po home>/runtime`),\n * without touching the consumer's own package manifest.\n */\nfunction findRuntimePackage(name: string, environment: LookupEnvironment): string | undefined {\n  const candidate = path.join(poRuntimeDirectory(undefined, environment), NODE_MODULES, name);\n  return fs.existsSync(path.join(candidate, PACKAGE_MANIFEST)) ? candidate : undefined;\n}\n\n/**\n * Whether a Po root asked for this package, rather than it arriving\n * transitively. The runtime's manifest is that list, shared by every root; a\n * runtime without one has nothing to check against and every package in it\n * counts.\n */\nfunction runtimePackageDeclared(name: string, environment: LookupEnvironment): boolean {\n  const manifestPath = path.join(poRuntimeDirectory(undefined, environment), PACKAGE_MANIFEST);\n  if (!fs.existsSync(manifestPath)) return true;\n  try {\n    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { dependencies?: Record<string, unknown> };\n    return name in (manifest.dependencies ?? {});\n  } catch {\n    // An unreadable manifest declares nothing, so the runtime answers for nothing.\n    return false;\n  }\n}\n\n/**\n * The consumer's own dependency tree answers first, then the packages a Po\n * root asked the shared runtime for. A package that merely arrived in the\n * runtime as a dependency of one of those (po-config beneath a layer package,\n * say) is not the answer: declining lets the caller's fallback resolve it from\n * Po's own tree, so one session never loads two copies of a core package with\n * their state split between them.\n */\nfunction findConsumerPackage(name: string, consumerRoot: string, environment: LookupEnvironment): string | undefined {\n  const local = testPackageRoot(name, environment);\n  if (local !== undefined) return local;\n  const installed = findInstalledPackage(name, consumerRoot);\n  if (installed && (environment.PO_TEST === '1' || !isCheckoutPoPackage(installed))) return installed;\n  const runtime = findRuntimePackage(name, environment);\n  return runtime &&\n    (environment.PO_TEST === '1' || !isCheckoutPoPackage(runtime)) &&\n    runtimePackageDeclared(name, environment)\n    ? runtime\n    : undefined;\n}\n\n/** Resolves every extension declared by a bare package's standard Pi manifest. */\nexport function packageEntries(specifier: string, origin: string = import.meta.url): string[] {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  if (subpath !== '.') return [packageEntry(specifier, origin)];\n\n  const packageRoot = findInstalledPackage(name, path.dirname(fileURLToPath(origin)));\n  if (!packageRoot) throw new Error(`Cannot resolve package ${name}.`);\n  const manifest = readPackageManifest(packageRoot);\n  if (!manifestDeclaresExtensions(manifest)) {\n    throw new Error(`${name} package.json does not declare pi.extensions.`);\n  }\n  const manifestEntries = manifestExtensionEntries(packageRoot, manifest, name);\n  if (!manifestEntries?.length) throw new Error(`${name} package.json pi.extensions resolves no extension files.`);\n  return manifestEntries;\n}\n\n/** Same as packageEntries, but returns undefined when the package is absent. */\nexport function optionalPackageEntries(specifier: string, origin: string = import.meta.url): string[] | undefined {\n  try {\n    return packageEntries(specifier, origin);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolves manifest entries from the consumer repository's dependency tree.\n *\n * The meta-package cannot resolve what the repository declares: under an\n * isolated node_modules layout Po Pi only sees its own dependencies. Walking\n * the consumer's module chain lets its package manifest answer first without\n * accidentally falling through to Po's dependency tree.\n */\nexport function consumerPackageEntries(\n  specifier: string,\n  consumerRoot: string,\n  environment: LookupEnvironment = process.env,\n): string[] | undefined {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  const packageRoot = findConsumerPackage(name, consumerRoot, environment);\n  if (!packageRoot) return undefined;\n  if (subpath === '.') {\n    const manifest = readPackageManifest(packageRoot);\n    if (!manifestDeclaresExtensions(manifest)) return [];\n    return manifestExtensionEntries(packageRoot, manifest, name) ?? [];\n  }\n  const entry = consumerPackageEntry(specifier, consumerRoot, environment);\n  return entry ? [entry] : [];\n}\n\n/**\n * Resolves one explicit package export or direct package-relative path from the consumer.\n * `environment` names the Po home whose shared runtime answers after the consumer's own tree.\n */\nexport function consumerPackageEntry(\n  specifier: string,\n  consumerRoot: string,\n  environment: LookupEnvironment = process.env,\n): string | undefined {\n  const packageRoot = findConsumerPackage(splitPackageSpecifier(specifier).name, consumerRoot, environment);\n  return packageRootEntry(specifier, consumerRoot, packageRoot);\n}\n\n/** One export or package-relative path of an already located package. */\nfunction packageRootEntry(\n  specifier: string,\n  consumerRoot: string,\n  packageRoot: string | undefined,\n): string | undefined {\n  if (!packageRoot) return undefined;\n  const { subpath } = splitPackageSpecifier(specifier);\n  if (subpath === '.') return localEntry(packageRoot, consumerRoot) ?? extensionIndexEntry(packageRoot);\n  const manifestPath = path.join(packageRoot, PACKAGE_MANIFEST);\n  // A relative subpath that the package does not export is still loadable by\n  // path, which is how layers point at a file inside a package (`.../index.ts`).\n  const directTarget = path.join(packageRoot, subpath);\n  let manifest: { exports?: unknown };\n  try {\n    manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { exports?: unknown };\n  } catch {\n    return fs.existsSync(directTarget) ? directTarget : undefined;\n  }\n\n  const exports = manifest.exports;\n  if (exports !== undefined && exports !== null) {\n    const entry =\n      typeof exports === 'object' && !Array.isArray(exports)\n        ? (exports as Record<string, unknown>)[subpath]\n        : undefined;\n    const target = selectImportTarget(entry);\n    if (target) {\n      const resolved = path.join(packageRoot, target);\n      if (fs.existsSync(resolved)) return resolved;\n    }\n  }\n\n  return fs.existsSync(directTarget) ? directTarget : undefined;\n}\n\n/** Resolves one exports subpath from a path-style package directory. */\nexport function localPackageExport(specifier: string, baseDirectory: string, subpath: string): string | undefined {\n  const packageRoot = path.resolve(baseDirectory, specifier);\n  const manifest = readPackageManifest(packageRoot);\n  const exports = manifest?.exports;\n  if (exports === undefined || exports === null) return undefined;\n  const target = selectImportTarget(isRecord(exports) ? exports[subpath] : undefined);\n  if (!target) return undefined;\n  const resolved = path.join(packageRoot, target);\n  return fs.existsSync(resolved) ? resolved : undefined;\n}\n\n/** Manifest fields consulted when a local package declares no `exports`. */\nconst MAIN_FIELDS = ['module', 'main'] as const;\n\n/**\n * Returns the canonical name of a path-style package directory.\n *\n * A direct file is intentionally anonymous: treating the repository manifest\n * above it as the file's identity would collapse every local extension in that\n * repository. Only a directory with its own named manifest represents a package\n * that can replace another installed version by logical identity.\n */\nexport function localPackageName(specifier: string, baseDirectory: string): string | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  try {\n    if (!fs.statSync(target).isDirectory()) return undefined;\n    const manifest = JSON.parse(fs.readFileSync(path.join(target, PACKAGE_MANIFEST), 'utf8')) as {\n      name?: unknown;\n    };\n    return typeof manifest.name === 'string' && manifest.name.trim() ? manifest.name.trim() : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolves Pi extension entries from a local file, extension directory, or package.\n *\n * A file is taken as the extension entry as written. A package directory uses\n * its native `pi.extensions` declaration or legacy root entry. A plain directory\n * follows Pi's extension discovery convention for scripts and child `index`\n * modules. This lets unpublished extensions live in the repository, or beside\n * the global config in `~/.po`, and still load in deterministic order.\n */\nexport function localEntries(specifier: string, baseDirectory: string): string[] | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return undefined;\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return undefined;\n\n  const manifest = readPackageManifest(target);\n  const manifestEntries = manifestExtensionEntries(\n    target,\n    manifest,\n    localPackageName(specifier, baseDirectory) ?? target,\n  );\n  if (manifestEntries !== undefined) return manifestEntries;\n  const entry = localEntry(specifier, baseDirectory);\n  return entry ? [entry] : extensionFilesAt(target);\n}\n\n/**\n * Resolves a local package selection through its standard Pi manifest.\n * Direct files and extension directories remain valid explicit local paths.\n */\nexport function localPackageEntries(specifier: string, baseDirectory: string): string[] | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return undefined;\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return undefined;\n\n  const manifestPath = path.join(target, PACKAGE_MANIFEST);\n  if (!fs.existsSync(manifestPath)) return extensionFilesAt(target);\n  const manifest = readPackageManifest(target);\n  if (!manifestDeclaresExtensions(manifest)) return [];\n  return manifestExtensionEntries(target, manifest, localPackageName(specifier, baseDirectory) ?? target) ?? [];\n}\n\n/** Resolves the legacy single entry from a local package's exports, module, or main field. */\nexport function localEntry(specifier: string, baseDirectory: string): string | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let isDirectory: boolean;\n  try {\n    const stats = fs.statSync(target);\n    if (stats.isFile()) return target;\n    isDirectory = stats.isDirectory();\n  } catch {\n    return undefined;\n  }\n  if (!isDirectory) return undefined;\n\n  let manifest: { exports?: unknown; module?: unknown; main?: unknown };\n  try {\n    manifest = JSON.parse(fs.readFileSync(path.join(target, PACKAGE_MANIFEST), 'utf8')) as typeof manifest;\n  } catch {\n    return undefined;\n  }\n\n  const exports = manifest.exports;\n  const rootExport =\n    typeof exports === 'object' && exports !== null && !Array.isArray(exports)\n      ? ((exports as Record<string, unknown>)['.'] ?? exports)\n      : exports;\n  const candidates = [selectImportTarget(rootExport)];\n  for (const field of MAIN_FIELDS) {\n    if (typeof manifest[field] === 'string') candidates.push(manifest[field]);\n  }\n\n  for (const candidate of candidates) {\n    if (!candidate) continue;\n    const resolved = path.join(target, candidate);\n    if (fs.existsSync(resolved)) return resolved;\n  }\n  return extensionIndexEntry(target);\n}\n\n/** Path to Pi's own CLI, which the launch command spawns. */\nexport function piCliPath(): string {\n  return path.join(path.dirname(packageEntry('@earendil-works/pi-coding-agent')), 'cli.js');\n}\n"],"mappings":";;;;;;;;;;;;AASA,MAAM,mBAAmB;AACzB,MAAM,eAAe;AACrB,MAAM,2BAA2B;AACjC,MAAM,4BAA4B;CAAC;CAAK;CAAK;AAAG;AAChD,MAAM,kBAAkB;AACxB,MAAM,wBAAwB;CAAC;CAAY;CAAY;CAAa;CAAa;CAAa;AAAW;AACzG,MAAM,0CAA0B,IAAI,IAAI;CAAC;CAAO;CAAO;CAAQ;CAAQ;CAAQ;AAAM,CAAC;;AAEtF,MAAM,oBAAoB;CAAC;CAAU;CAAU;CAAQ;AAAS;AAUhE,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,oBAAoB,aAAkD;CAC7E,IAAI;EACF,MAAM,SAAkB,KAAK,MAAMA,QAAAA,QAAG,aAAaC,UAAAA,QAAK,KAAK,aAAa,gBAAgB,GAAG,MAAM,CAAC;EACpG,OAAO,SAAS,MAAM,IAAI,SAAS,KAAA;CACrC,QAAQ;EAGN;CACF;AACF;AAEA,SAAS,2BAA2B,UAAgD;CAClF,OAAO,QAAQ,YAAY,SAAS,SAAS,EAAE,KAAK,OAAO,OAAO,SAAS,IAAI,YAAY,CAAC;AAC9F;AAEA,SAAS,kBAAkB,OAAwB;CACjD,OAAO,0BAA0B,MAAM,WAAW,MAAM,WAAW,MAAM,CAAC;AAC5E;AAEA,SAAS,uBAAuB,aAAqB,QAAwB;CAC3E,OAAOA,UAAAA,QAAK,SAAS,aAAa,MAAM,CAAC,CAAC,MAAMA,UAAAA,QAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AACpE;AAEA,SAAS,uBAAuB,QAAgB,SAAiB,aAA8B;CAC7F,MAAM,oBAAoB,QAAQ,WAAW,MAAM,GAAG,CAAC,CAAC,QAAQ,SAAS,EAAE;CAC3E,MAAM,WAAW,uBAAuB,aAAa,MAAM;CAC3D,QAAA,GACE,UAAA,UAAA,CAAU,UAAU,iBAAiB,MAAA,GACrC,UAAA,UAAA,CAAUA,UAAAA,QAAK,SAAS,MAAM,GAAG,iBAAiB,MAAA,GAClD,UAAA,UAAA,CAAU,OAAO,MAAMA,UAAAA,QAAK,GAAG,CAAC,CAAC,KAAK,GAAG,GAAG,iBAAiB;AAEjE;AAEA,SAAS,yBAAyB,QAAgB,SAAiB,aAA8B;CAC/F,MAAM,oBAAoB,QAAQ,WAAW,MAAM,GAAG,CAAC,CAAC,QAAQ,SAAS,EAAE;CAC3E,OACE,uBAAuB,aAAa,MAAM,MAAM,qBAChD,OAAO,MAAMA,UAAAA,QAAK,GAAG,CAAC,CAAC,KAAK,GAAG,MAAM;AAEzC;AAEA,SAAS,oBAAoB,WAAuC;CAClE,KAAK,MAAM,aAAa,uBAAuB;EAC7C,MAAM,YAAYA,UAAAA,QAAK,KAAK,WAAW,SAAS;EAChD,IAAID,QAAAA,QAAG,WAAW,SAAS,GAAG,OAAO;CACvC;AAEF;AAEA,SAAS,iBAAiB,QAA0B;CAClD,IAAI;CACJ,IAAI;EACF,QAAQA,QAAAA,QAAG,SAAS,MAAM;CAC5B,QAAQ;EACN,OAAO,CAAC;CACV;CACA,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM;CAClC,IAAI,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;CAElC,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,SAASA,QAAAA,QACjB,YAAY,QAAQ,EAAE,eAAe,KAAK,CAAC,CAAC,CAC5C,MAAM,MAAM,UAAU,KAAK,KAAK,cAAc,MAAM,IAAI,CAAC,GAAG;EAC7D,MAAM,YAAYC,UAAAA,QAAK,KAAK,QAAQ,MAAM,IAAI;EAC9C,KAAK,MAAM,OAAO,KAAK,MAAM,eAAe,MAAM,wBAAwB,IAAIA,UAAAA,QAAK,QAAQ,MAAM,IAAI,CAAC,GAAG;GACvG,MAAM,KAAK,SAAS;GACpB;EACF;EACA,IAAI,CAAC,MAAM,YAAY,KAAK,CAAC,MAAM,eAAe,GAAG;EACrD,MAAM,aAAa,oBAAoB,SAAS;EAChD,IAAI,YAAY,MAAM,KAAK,UAAU;CACvC;CACA,OAAO;AACT;;AAGA,SAAS,yBACP,aACA,UACA,aACsB;CACtB,IAAI,CAAC,2BAA2B,QAAQ,KAAK,CAAC,SAAS,UAAU,EAAE,GAAG,OAAO,KAAA;CAC7E,MAAM,aAAa,SAAS,GAAG;CAC/B,IAAI,CAAC,MAAM,QAAQ,UAAU,KAAK,CAAC,WAAW,OAAO,UAAU,OAAO,UAAU,QAAQ,GACtF,MAAM,IAAI,MAAM,GAAG,YAAY,yDAAyD;CAG1F,MAAM,WAAqB,CAAC;CAC5B,KAAK,MAAM,mBAAmB,WAAW,QAAQ,UAAU,CAAC,kBAAkB,KAAK,CAAC,GAAG;EACrF,MAAM,aAAa,gBAAgB,KAAK,eAAe,IACnDD,QAAAA,QAAG,SAAS,iBAAiB,EAAE,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,IACxD,CAAC,eAAe;EACpB,KAAK,MAAM,aAAa,YACtB,KAAK,MAAM,UAAU,iBAAiBC,UAAAA,QAAK,QAAQ,aAAa,SAAS,CAAC,GACxE,IAAI,CAAC,SAAS,SAAS,MAAM,GAAG,SAAS,KAAK,MAAM;CAG1D;CAEA,MAAM,WAAW,WAAW,QAAQ,UAAU,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;CAClG,MAAM,gBAAgB,WAAW,QAAQ,UAAU,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;CACvG,MAAM,gBAAgB,WAAW,QAAQ,UAAU,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;CACvG,MAAM,WAAW,SAAS,QACvB,WAAW,CAAC,SAAS,MAAM,YAAY,uBAAuB,QAAQ,SAAS,WAAW,CAAC,CAC9F;CACA,KAAK,MAAM,UAAU,UACnB,IACE,CAAC,SAAS,SAAS,MAAM,KACzB,cAAc,MAAM,YAAY,yBAAyB,QAAQ,SAAS,WAAW,CAAC,GAEtF,SAAS,KAAK,MAAM;CAGxB,MAAM,WAAW,SAAS,QACvB,WAAW,CAAC,cAAc,MAAM,YAAY,yBAAyB,QAAQ,SAAS,WAAW,CAAC,CACrG;CACA,OAAO,SAAS,SAAS,IAAI,WAAW,KAAA;AAC1C;;;;;;;AAQA,SAAgB,aAAa,MAAc,SAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,MAA0C;CAEnF,MAAM,QAAQ,qBAAqB,MADtBA,UAAAA,QAAK,SAAA,GAAQC,SAAAA,cAAAA,CAAc,MAAM,CACF,CAAC;CAC7C,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,gCAAgC,KAAK,QAAQ,QAAQ;CACjF,OAAOF,QAAAA,QAAG,aAAa,KAAK;AAC9B;;;;;;AAOA,SAAgB,qBAAqB,MAAc,QAAoC;CACrF,MAAM,OAAOC,UAAAA,QAAK,SAAA,GAAQC,SAAAA,cAAAA,CAAc,MAAM,CAAC;CAC/C,IAAI,CAAC,iBAAiB,IAAI,GAAG,OAAO,KAAA;CACpC,MAAM,QAAQ,iBAAiB,MAAM,MAAM,qBAAqB,sBAAsB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;CACvG,OAAO,UAAU,KAAA,IAAY,KAAA,IAAYF,QAAAA,QAAG,aAAa,KAAK;AAChE;;AAGA,SAAS,iBAAiB,WAA4B;CACpD,KAAK,IAAI,UAAU,YAAa,UAAUC,UAAAA,QAAK,QAAQ,OAAO,GAAG;EAC/D,IAAID,QAAAA,QAAG,WAAWC,UAAAA,QAAK,KAAK,SAAS,gBAAgB,CAAC,GAAG,OAAOE,cAAAA,oBAAoB,OAAO;EAC3F,IAAIF,UAAAA,QAAK,QAAQ,OAAO,MAAM,SAAS,OAAO;CAChD;AACF;;AAGA,SAAgB,qBAAqB,MAAc,SAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,MAAsD;CACvG,IAAI;EACF,OAAO,aAAa,MAAM,MAAM;CAClC,QAAQ;EACN;CACF;AACF;;;;;;;AAQA,SAAgB,sBAAsB,WAAsD;CAC1F,MAAM,WAAW,UAAU,MAAM,GAAG;CACpC,MAAM,eAAe,UAAU,WAAW,GAAG,IAAI,IAAI;CACrD,MAAM,OAAO,SAAS,MAAM,GAAG,YAAY,CAAC,CAAC,KAAK,GAAG;CACrD,MAAM,OAAO,SAAS,MAAM,YAAY,CAAC,CAAC,KAAK,GAAG;CAClD,OAAO;EAAE;EAAM,SAAS,OAAO,GAAG,2BAA2B,SAAS;CAAI;AAC5E;;AAGA,SAAS,mBAAmB,OAAoC;CAC9D,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxB,KAAK,MAAM,aAAa,OAAO;GAC7B,MAAM,SAAS,mBAAmB,SAAS;GAC3C,IAAI,QAAQ,OAAO;EACrB;EACA;CACF;CACA,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,aAAa;CACnB,KAAK,MAAM,aAAa,mBACtB,IAAI,aAAa,YAAY;EAC3B,MAAM,SAAS,mBAAmB,WAAW,UAAU;EACvD,IAAI,QAAQ,OAAO;CACrB;AAGJ;;;;;;;;AASA,SAAS,qBAAqB,MAAc,cAA0C;CACpF,IAAI,YAAYA,UAAAA,QAAK,QAAQ,YAAY;CACzC,OAAO,MAAM;EACX,MAAM,YAAYA,UAAAA,QAAK,KAAK,WAAW,cAAc,IAAI;EACzD,IAAID,QAAAA,QAAG,WAAWC,UAAAA,QAAK,KAAK,WAAW,gBAAgB,CAAC,GAAG,OAAO;EAClE,MAAM,SAASA,UAAAA,QAAK,QAAQ,SAAS;EACrC,IAAI,WAAW,WAAW,OAAO,KAAA;EACjC,YAAY;CACd;AACF;;AAMA,SAAgB,gBAAgB,MAAc,cAAiC,QAAQ,KAAyB;CAC9G,IAAI,YAAY,YAAY,OAAO,CAAC,YAAY,kBAAkB,OAAO,KAAA;CACzE,MAAM,WAAoB,KAAK,MAAM,YAAY,gBAAgB;CACjE,IAAI,CAAC,SAAS,QAAQ,GAAG,MAAM,IAAI,MAAM,sDAAsD;CAC/F,MAAM,OAAO,SAAS;CACtB,OAAO,OAAO,SAAS,WAAW,OAAO,KAAA;AAC3C;;;;;AAMA,SAAS,mBAAmB,MAAc,aAAoD;CAC5F,MAAM,YAAYA,UAAAA,QAAK,KAAKG,aAAAA,mBAAmB,KAAA,GAAW,WAAW,GAAG,cAAc,IAAI;CAC1F,OAAOJ,QAAAA,QAAG,WAAWC,UAAAA,QAAK,KAAK,WAAW,gBAAgB,CAAC,IAAI,YAAY,KAAA;AAC7E;;;;;;;AAQA,SAAS,uBAAuB,MAAc,aAAyC;CACrF,MAAM,eAAeA,UAAAA,QAAK,KAAKG,aAAAA,mBAAmB,KAAA,GAAW,WAAW,GAAG,gBAAgB;CAC3F,IAAI,CAACJ,QAAAA,QAAG,WAAW,YAAY,GAAG,OAAO;CACzC,IAAI;EAEF,OAAO,SADU,KAAK,MAAMA,QAAAA,QAAG,aAAa,cAAc,MAAM,CACzC,CAAC,CAAC,gBAAgB,CAAC;CAC5C,QAAQ;EAEN,OAAO;CACT;AACF;;;;;;;;;AAUA,SAAS,oBAAoB,MAAc,cAAsB,aAAoD;CACnH,MAAM,QAAQ,gBAAgB,MAAM,WAAW;CAC/C,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,MAAM,YAAY,qBAAqB,MAAM,YAAY;CACzD,IAAI,cAAc,YAAY,YAAY,OAAO,CAACG,cAAAA,oBAAoB,SAAS,IAAI,OAAO;CAC1F,MAAM,UAAU,mBAAmB,MAAM,WAAW;CACpD,OAAO,YACJ,YAAY,YAAY,OAAO,CAACA,cAAAA,oBAAoB,OAAO,MAC5D,uBAAuB,MAAM,WAAW,IACtC,UACA,KAAA;AACN;;AAGA,SAAgB,eAAe,WAAmB,SAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,MAA4C;CAC5F,MAAM,EAAE,MAAM,YAAY,sBAAsB,SAAS;CACzD,IAAI,YAAY,KAAK,OAAO,CAAC,aAAa,WAAW,MAAM,CAAC;CAE5D,MAAM,cAAc,qBAAqB,MAAMF,UAAAA,QAAK,SAAA,GAAQC,SAAAA,cAAAA,CAAc,MAAM,CAAC,CAAC;CAClF,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,0BAA0B,KAAK,EAAE;CACnE,MAAM,WAAW,oBAAoB,WAAW;CAChD,IAAI,CAAC,2BAA2B,QAAQ,GACtC,MAAM,IAAI,MAAM,GAAG,KAAK,8CAA8C;CAExE,MAAM,kBAAkB,yBAAyB,aAAa,UAAU,IAAI;CAC5E,IAAI,CAAC,iBAAiB,QAAQ,MAAM,IAAI,MAAM,GAAG,KAAK,yDAAyD;CAC/G,OAAO;AACT;;AAGA,SAAgB,uBAAuB,WAAmB,SAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,MAAwD;CAChH,IAAI;EACF,OAAO,eAAe,WAAW,MAAM;CACzC,QAAQ;EACN;CACF;AACF;;;;;;;;;AAUA,SAAgB,uBACd,WACA,cACA,cAAiC,QAAQ,KACnB;CACtB,MAAM,EAAE,MAAM,YAAY,sBAAsB,SAAS;CACzD,MAAM,cAAc,oBAAoB,MAAM,cAAc,WAAW;CACvE,IAAI,CAAC,aAAa,OAAO,KAAA;CACzB,IAAI,YAAY,KAAK;EACnB,MAAM,WAAW,oBAAoB,WAAW;EAChD,IAAI,CAAC,2BAA2B,QAAQ,GAAG,OAAO,CAAC;EACnD,OAAO,yBAAyB,aAAa,UAAU,IAAI,KAAK,CAAC;CACnE;CACA,MAAM,QAAQ,qBAAqB,WAAW,cAAc,WAAW;CACvE,OAAO,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC5B;;;;;AAMA,SAAgB,qBACd,WACA,cACA,cAAiC,QAAQ,KACrB;CAEpB,OAAO,iBAAiB,WAAW,cADf,oBAAoB,sBAAsB,SAAS,CAAC,CAAC,MAAM,cAAc,WAClC,CAAC;AAC9D;;AAGA,SAAS,iBACP,WACA,cACA,aACoB;CACpB,IAAI,CAAC,aAAa,OAAO,KAAA;CACzB,MAAM,EAAE,YAAY,sBAAsB,SAAS;CACnD,IAAI,YAAY,KAAK,OAAO,WAAW,aAAa,YAAY,KAAK,oBAAoB,WAAW;CACpG,MAAM,eAAeD,UAAAA,QAAK,KAAK,aAAa,gBAAgB;CAG5D,MAAM,eAAeA,UAAAA,QAAK,KAAK,aAAa,OAAO;CACnD,IAAI;CACJ,IAAI;EACF,WAAW,KAAK,MAAMD,QAAAA,QAAG,aAAa,cAAc,MAAM,CAAC;CAC7D,QAAQ;EACN,OAAOA,QAAAA,QAAG,WAAW,YAAY,IAAI,eAAe,KAAA;CACtD;CAEA,MAAM,UAAU,SAAS;CACzB,IAAI,YAAY,KAAA,KAAa,YAAY,MAAM;EAK7C,MAAM,SAAS,mBAHb,OAAO,YAAY,YAAY,CAAC,MAAM,QAAQ,OAAO,IAChD,QAAoC,WACrC,KAAA,CACiC;EACvC,IAAI,QAAQ;GACV,MAAM,WAAWC,UAAAA,QAAK,KAAK,aAAa,MAAM;GAC9C,IAAID,QAAAA,QAAG,WAAW,QAAQ,GAAG,OAAO;EACtC;CACF;CAEA,OAAOA,QAAAA,QAAG,WAAW,YAAY,IAAI,eAAe,KAAA;AACtD;;AAGA,SAAgB,mBAAmB,WAAmB,eAAuB,SAAqC;CAChH,MAAM,cAAcC,UAAAA,QAAK,QAAQ,eAAe,SAAS;CAEzD,MAAM,UADW,oBAAoB,WACd,CAAC,EAAE;CAC1B,IAAI,YAAY,KAAA,KAAa,YAAY,MAAM,OAAO,KAAA;CACtD,MAAM,SAAS,mBAAmB,SAAS,OAAO,IAAI,QAAQ,WAAW,KAAA,CAAS;CAClF,IAAI,CAAC,QAAQ,OAAO,KAAA;CACpB,MAAM,WAAWA,UAAAA,QAAK,KAAK,aAAa,MAAM;CAC9C,OAAOD,QAAAA,QAAG,WAAW,QAAQ,IAAI,WAAW,KAAA;AAC9C;;AAGA,MAAM,cAAc,CAAC,UAAU,MAAM;;;;;;;;;AAUrC,SAAgB,iBAAiB,WAAmB,eAA2C;CAC7F,MAAM,SAASC,UAAAA,QAAK,QAAQ,eAAe,SAAS;CACpD,IAAI;EACF,IAAI,CAACD,QAAAA,QAAG,SAAS,MAAM,CAAC,CAAC,YAAY,GAAG,OAAO,KAAA;EAC/C,MAAM,WAAW,KAAK,MAAMA,QAAAA,QAAG,aAAaC,UAAAA,QAAK,KAAK,QAAQ,gBAAgB,GAAG,MAAM,CAAC;EAGxF,OAAO,OAAO,SAAS,SAAS,YAAY,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,KAAK,IAAI,KAAA;CAC5F,QAAQ;EACN;CACF;AACF;;;;;;;;;;AAWA,SAAgB,aAAa,WAAmB,eAA6C;CAC3F,MAAM,SAASA,UAAAA,QAAK,QAAQ,eAAe,SAAS;CACpD,IAAI;CACJ,IAAI;EACF,QAAQD,QAAAA,QAAG,SAAS,MAAM;CAC5B,QAAQ;EACN;CACF;CACA,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM;CAClC,IAAI,CAAC,MAAM,YAAY,GAAG,OAAO,KAAA;CAGjC,MAAM,kBAAkB,yBACtB,QAFe,oBAAoB,MAG5B,GACP,iBAAiB,WAAW,aAAa,KAAK,MAChD;CACA,IAAI,oBAAoB,KAAA,GAAW,OAAO;CAC1C,MAAM,QAAQ,WAAW,WAAW,aAAa;CACjD,OAAO,QAAQ,CAAC,KAAK,IAAI,iBAAiB,MAAM;AAClD;;;;;AAMA,SAAgB,oBAAoB,WAAmB,eAA6C;CAClG,MAAM,SAASC,UAAAA,QAAK,QAAQ,eAAe,SAAS;CACpD,IAAI;CACJ,IAAI;EACF,QAAQD,QAAAA,QAAG,SAAS,MAAM;CAC5B,QAAQ;EACN;CACF;CACA,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM;CAClC,IAAI,CAAC,MAAM,YAAY,GAAG,OAAO,KAAA;CAEjC,MAAM,eAAeC,UAAAA,QAAK,KAAK,QAAQ,gBAAgB;CACvD,IAAI,CAACD,QAAAA,QAAG,WAAW,YAAY,GAAG,OAAO,iBAAiB,MAAM;CAChE,MAAM,WAAW,oBAAoB,MAAM;CAC3C,IAAI,CAAC,2BAA2B,QAAQ,GAAG,OAAO,CAAC;CACnD,OAAO,yBAAyB,QAAQ,UAAU,iBAAiB,WAAW,aAAa,KAAK,MAAM,KAAK,CAAC;AAC9G;;AAGA,SAAgB,WAAW,WAAmB,eAA2C;CACvF,MAAM,SAASC,UAAAA,QAAK,QAAQ,eAAe,SAAS;CACpD,IAAI;CACJ,IAAI;EACF,MAAM,QAAQD,QAAAA,QAAG,SAAS,MAAM;EAChC,IAAI,MAAM,OAAO,GAAG,OAAO;EAC3B,cAAc,MAAM,YAAY;CAClC,QAAQ;EACN;CACF;CACA,IAAI,CAAC,aAAa,OAAO,KAAA;CAEzB,IAAI;CACJ,IAAI;EACF,WAAW,KAAK,MAAMA,QAAAA,QAAG,aAAaC,UAAAA,QAAK,KAAK,QAAQ,gBAAgB,GAAG,MAAM,CAAC;CACpF,QAAQ;EACN;CACF;CAEA,MAAM,UAAU,SAAS;CAKzB,MAAM,aAAa,CAAC,mBAHlB,OAAO,YAAY,YAAY,YAAY,QAAQ,CAAC,MAAM,QAAQ,OAAO,IACnE,QAAoC,QAAQ,UAC9C,OAC2C,CAAC;CAClD,KAAK,MAAM,SAAS,aAClB,IAAI,OAAO,SAAS,WAAW,UAAU,WAAW,KAAK,SAAS,MAAM;CAG1E,KAAK,MAAM,aAAa,YAAY;EAClC,IAAI,CAAC,WAAW;EAChB,MAAM,WAAWA,UAAAA,QAAK,KAAK,QAAQ,SAAS;EAC5C,IAAID,QAAAA,QAAG,WAAW,QAAQ,GAAG,OAAO;CACtC;CACA,OAAO,oBAAoB,MAAM;AACnC;;AAGA,SAAgB,YAAoB;CAClC,OAAOC,UAAAA,QAAK,KAAKA,UAAAA,QAAK,QAAQ,aAAa,iCAAiC,CAAC,GAAG,QAAQ;AAC1F"}

package/dist/moduleResolution.d.mts

@@ -6,6 +6,12 @@
  * extension has to be resolved to a file before it can be passed along.
  */
 export declare function packageEntry(name: string, origin?: string): string;
+/**
+ * The entry a module running from a Po checkout finds in that checkout's own closure.
+ * A checkout package is never an implicit override for a consumer, so callers try
+ * the consumer first and use this only as the last resort.
+ */
+export declare function checkoutPackageEntry(name: string, origin: string): string | undefined;
 /** Same as packageEntry, but returns undefined when the package is absent. */
 export declare function optionalPackageEntry(name: string, origin?: string): string | undefined;
 /**
@@ -20,6 +26,8 @@ export declare function splitPackageSpecifier(specifier: string): {
 };
 /** The environment a lookup runs for; it names the Po home, and so the shared runtime. */
 type LookupEnvironment = Readonly<Record<string, string | undefined>>;
+/** Checkout package overrides inherited by the web, server and sync children of `po --test`. */
+export declare function testPackageRoot(name: string, environment?: LookupEnvironment): string | undefined;
 /** Resolves every extension declared by a bare package's standard Pi manifest. */
 export declare function packageEntries(specifier: string, origin?: string): string[];
 /** Same as packageEntries, but returns undefined when the package is absent. */
@@ -28,7 +36,7 @@ export declare function optionalPackageEntries(specifier: string, origin?: strin
  * Resolves manifest entries from the consumer repository's dependency tree.
  *
  * The meta-package cannot resolve what the repository declares: under an
- * isolated node_modules layout Doom Pi only sees its own dependencies. Walking
+ * isolated node_modules layout Po Pi only sees its own dependencies. Walking
  * the consumer's module chain lets its package manifest answer first without
  * accidentally falling through to Po's dependency tree.
  */
@@ -69,4 +77,5 @@ export declare function localEntry(specifier: string, baseDirectory: string): st
 /** Path to Pi's own CLI, which the launch command spawns. */
 export declare function piCliPath(): string;
 //#endregion
+export {};
 //# sourceMappingURL=moduleResolution.d.mts.map