@agimon-ai/po-mcp 0.0.0-alpha.13 → 0.0.0-alpha.14

package/dist/extensions/mcp.cjs

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 let _agimon_ai_po_core_mcpFacet = require("@agimon-ai/po-core/mcpFacet");
-let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+let _agimon_ai_po_core_serverPlugin = require("@agimon-ai/po-core/serverPlugin");
 let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
 require("typebox/value");
 let typebox = require("typebox");
@@ -11,7 +11,7 @@ let typebox = require("typebox");
 var po_use_mcp_mcp_default = (0, _agimon_ai_po_core_mcpFacet.defineMcpSkill)({
 	name: "po-use-mcp",
 	description: "Use Po Pi MCP to inspect domain-scoped servers, authenticate, reload configuration, and troubleshoot tool availability.",
-	read: () => (0, _agimon_ai_po_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-mcp/SKILL.md")
+	read: () => (0, _agimon_ai_po_core_serverPlugin.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-mcp/SKILL.md")
 });
 //#endregion
 //#region src/services/mcpHeadlessTools/index.ts

package/dist/extensions/mcp.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.cjs","names":["defineMcpSkill","readPackageResource","defineMcpTool","defineMcpTool","Type","defineRoutedContribution","defineMcpTool","defineMcpPlugin","skillPoUseMcp","toolMcpUse","toolSaveFile","toolSessionMcp","toolShareFile"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-mcp.mcp.ts","../../src/services/mcpHeadlessTools/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/mcp_use.mcp.ts","../../src/extensions/workspaces/sessions/(backend)/tool/save_file.mcp.ts","../../src/schemas/mcpHeadlessTool.ts","../../src/services/mcpSessionTools/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/session_mcp.mcp.ts","../../src/extensions/workspaces/sessions/(backend)/tool/share_file.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-use-mcp',\n  description:\n    'Use Po Pi MCP to inspect domain-scoped servers, authenticate, reload configuration, and troubleshoot tool availability.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-mcp/SKILL.md'),\n});\n","import type { PoHeadlessTool } from '@agimon-ai/po-core/headless';\nimport type { PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\nimport type { Context } from '@deepseek-ai/cordis';\n\nexport const MCP_HEADLESS_TOOLS_SERVICE = 'po/mcp-headless-tools';\n\nexport interface McpHeadlessToolCatalog {\n  get(name: string): PoHeadlessTool | undefined;\n}\n\nexport function mountMcpHeadlessTools(tools: readonly PoHeadlessTool[]) {\n  return (context: Context): void => {\n    context.plugin((providerContext) => {\n      providerContext.provide(MCP_HEADLESS_TOOLS_SERVICE, {\n        get: (name) => tools.find((tool) => tool.name === name),\n      } satisfies McpHeadlessToolCatalog);\n    });\n  };\n}\n\nexport function bindMcpHeadlessTool(context: PoMcpPluginContext, name: string): PoHeadlessTool {\n  const tool = context.services.get<McpHeadlessToolCatalog>(MCP_HEADLESS_TOOLS_SERVICE)?.get(name);\n  if (!tool) throw new Error(`MCP tool is unavailable: ${name}`);\n  return {\n    ...tool,\n    execute(toolCallId, parameters, signal, onUpdate) {\n      const executionSignal = AbortSignal.any([context.signal, signal ?? context.signal]);\n      return tool.execute(toolCallId, parameters, executionSignal, onUpdate, context.execution);\n    },\n  };\n}\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'mcp_use'));\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'save_file'));\n","import { Type } from 'typebox';\n\nexport const McpHeadlessToolParameters = Type.Object({\n  server: Type.String({ minLength: 1 }),\n  tool: Type.String({ minLength: 1 }),\n  arguments: Type.Optional(Type.Record(Type.String(), Type.Unknown())),\n});\n","import type { PoChildSessionMcpCatalog, PoChildSessionMcpTool } from '@agimon-ai/po-core/childSession';\nimport type { PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport type { ReadResourceResult } from '@modelcontextprotocol/server';\nimport type { Static, TSchema } from 'typebox';\nimport { Value } from 'typebox/value';\n\nimport { McpHeadlessToolParameters } from '../../schemas/mcpHeadlessTool';\nimport { mcpToolExecutionMetadata, type CatalogTool } from '../mcpCatalog';\nimport { modelInputSchema } from '../mcpFileParams';\nimport type { McpSession } from '../mcpSession';\n\nexport const MCP_SESSION_TOOLS_SERVICE = 'po/mcp-session-tools';\n\n/** This projection needs no caller-owned execution context and can be borrowed unchanged. */\nexport interface McpDirectTool extends PoHeadlessTool {\n  execute(toolCallId: string, parameters: unknown, signal?: AbortSignal): Promise<PoHeadlessToolResult>;\n}\n\n/** Narrow cross-root access to the Pi session's existing upstream MCP runtime. */\nexport interface McpSessionToolsService {\n  readonly generation: string;\n  runtimeRevision(): number;\n  readAppResource(server: string, tool: string, resourceUri: string, signal?: AbortSignal): Promise<ReadResourceResult>;\n  snapshot(): readonly CatalogTool[];\n  project(): readonly McpDirectTool[];\n  refresh(): void;\n  dispose(): void;\n  resolveSelectors(selectors: readonly string[]): readonly string[];\n  onChange(listener: () => void): () => void;\n  invoke(name: string, parameters: Record<string, unknown>, signal?: AbortSignal): Promise<PoHeadlessToolResult>;\n}\n\nexport function createMcpSessionToolsService(\n  session: McpSession,\n  generation: string,\n  assertAvailable: () => void = () => undefined,\n): McpSessionToolsService {\n  let disposed = false;\n  const listeners = new Set<() => void>();\n  const retained = new Map<string, { fingerprint: string; tool: McpDirectTool; retire(): void }>();\n  const snapshot = () => {\n    try {\n      if (disposed) return [];\n      assertAvailable();\n      return session.activeToolDefinitions();\n    } catch {\n      // An inactive or stale parent lends no declarations.\n      return [];\n    }\n  };\n  const project = (): readonly McpDirectTool[] => {\n    const definitions = snapshot();\n    const names = new Set(definitions.map((tool) => tool.piName));\n    for (const [name, entry] of retained) {\n      if (names.has(name)) continue;\n      entry.retire();\n      retained.delete(name);\n    }\n    return definitions.map((definition) => {\n      const fingerprint = JSON.stringify([session.toolGeneration, definition]);\n      const previous = retained.get(definition.piName);\n      if (previous?.fingerprint === fingerprint) return previous.tool;\n      previous?.retire();\n      let retired = false;\n      const invoke = session.bindToolInvocation(definition);\n      const tool: McpDirectTool = {\n        name: definition.piName,\n        label: `${definition.serverName}: ${definition.toolName}`,\n        description: definition.description ?? `${definition.toolName} on the ${definition.serverName} MCP server.`,\n        ...(definition.annotations === undefined ? {} : { annotations: definition.annotations }),\n        ...(definition._meta === undefined ? {} : { _meta: mcpToolExecutionMetadata(definition) }),\n        ...(definition.outputSchema === undefined ? {} : { outputSchema: definition.outputSchema }),\n        // File parameters are validated as the `{path}` objects the model sends.\n        parameters: modelInputSchema(definition) as TSchema,\n        async execute(_toolCallId, parameters, signal) {\n          assertAvailable();\n          if (retired) throw new Error(`MCP tool ${definition.piName} is no longer available.`);\n          signal?.throwIfAborted();\n          const arguments_ = parameters === undefined ? {} : parameters;\n          if (!Value.Check(tool.parameters, arguments_))\n            throw new Error(`Invalid arguments for MCP tool ${definition.piName}.`);\n          const result = await invoke(arguments_ as Record<string, unknown>, signal);\n          signal?.throwIfAborted();\n          return result;\n        },\n      };\n      retained.set(definition.piName, {\n        fingerprint,\n        tool,\n        retire: () => {\n          retired = true;\n        },\n      });\n      return tool;\n    });\n  };\n  const refresh = () => {\n    project();\n    for (const listener of listeners) listener();\n  };\n  // Retirement must happen even if a borrower temporarily has no change listener.\n  const stopSession = session.onChange(refresh);\n  return Object.freeze({\n    generation,\n    runtimeRevision: () => session.toolGeneration,\n    readAppResource: async (server: string, tool: string, resourceUri: string, signal?: AbortSignal) => {\n      assertAvailable();\n      if (disposed) throw new Error('The MCP session is no longer available.');\n      const result = await session.readAppResource(server, tool, resourceUri, signal);\n      assertAvailable();\n      if (disposed) throw new Error('The MCP session is no longer available.');\n      return result;\n    },\n    snapshot,\n    project,\n    refresh,\n    dispose: () => {\n      disposed = true;\n      stopSession();\n      refresh();\n      listeners.clear();\n    },\n    resolveSelectors: (selectors: readonly string[]) => {\n      const active = new Set(snapshot().map((tool) => tool.piName));\n      return session\n        .resolveToolSelectors(selectors)\n        .map((tool) => tool.name)\n        .filter((name) => active.has(name));\n    },\n    onChange: (listener: () => void) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    invoke: async (name: string, parameters: Record<string, unknown>, signal?: AbortSignal) => {\n      assertAvailable();\n      const tool = project().find((candidate) => candidate.name === name);\n      if (!tool) throw new Error(`MCP tool ${name} is not available in this session.`);\n      return tool.execute('mcp', parameters, signal);\n    },\n  });\n}\n\n/** Borrow an existing MCP runtime; a child never starts or disposes its own upstream connections. */\nexport function createMcpChildTool(\n  invoke: (parameters: Static<typeof McpHeadlessToolParameters>, signal?: AbortSignal) => Promise<PoHeadlessToolResult>,\n  catalog?: PoChildSessionMcpCatalog,\n): PoChildSessionMcpTool {\n  return {\n    name: 'mcp',\n    ...(catalog === undefined ? {} : { catalog }),\n    description: 'Call a tool exposed by a connected MCP server.',\n    parameters: McpHeadlessToolParameters,\n    async execute(_toolCallId, parameters, signal) {\n      signal?.throwIfAborted();\n      if (!Value.Check(McpHeadlessToolParameters, parameters)) throw new Error('Invalid MCP tool arguments.');\n      const result = await invoke(parameters, signal);\n      signal?.throwIfAborted();\n      return result;\n    },\n  };\n}\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { PoHeadlessTool } from '@agimon-ai/po-core/headless';\nimport type { PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport {\n  MCP_SESSION_TOOLS_SERVICE,\n  type McpDirectTool,\n  type McpSessionToolsService,\n} from '../../../../../services/mcpSessionTools';\n\nexport default defineRoutedContribution(\n  (context: PoMcpPluginContext): readonly PoHeadlessTool[] => {\n    const service = context.services.get<McpSessionToolsService>(MCP_SESSION_TOOLS_SERVICE);\n    if (!service) return [];\n    let current: readonly McpDirectTool[] = [];\n    const stop = service.onChange(() => {\n      const next = service.project();\n      if (next.length === current.length && next.every((tool, index) => tool === current[index])) return;\n      current = next;\n      context.refresh();\n    });\n    current = service.project();\n    context.signal.addEventListener('abort', stop, { once: true });\n    return current.map((tool) => ({\n      ...tool,\n      execute: (toolCallId, parameters, signal) =>\n        tool.execute(toolCallId, parameters, AbortSignal.any([context.signal, signal ?? context.signal])),\n    }));\n  },\n  { cardinality: 'many' },\n);\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'share_file'));\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUseMcp from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-mcp.mcp';\nimport toolMcpUse from '../src/extensions/workspaces/sessions/(backend)/tool/mcp_use.mcp';\nimport toolSaveFile from '../src/extensions/workspaces/sessions/(backend)/tool/save_file.mcp';\nimport toolSessionMcp from '../src/extensions/workspaces/sessions/(backend)/tool/session_mcp.mcp';\nimport toolShareFile from '../src/extensions/workspaces/sessions/(backend)/tool/share_file.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\ntype ManyFactory<T, C> = (context: C) => T | readonly T[];\nconst many = <T, C>(value: T | readonly T[] | ManyFactory<T, C>, context: C): readonly T[] => {\n  const resolved = typeof value === 'function' ? (value as ManyFactory<T, C>)(context) : value;\n  return Array.isArray(resolved) ? resolved : [resolved as T];\n};\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nconst withWidget = <T>(key: string, value: T): T => value === undefined ? value : ({\n  ...value, _meta: { ...(value as { _meta?: object })._meta, [\"po/widget\"]: key },\n});\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-mcp',\n  session: (context) => ({\n    get skills(): PoMcpSessionPlugin['skills'] { return [at(skillPoUseMcp, context)]; },\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-mcp/mcp_use\", via({ name: 'mcp_use' }, at(toolMcpUse, context))), via({ name: 'save_file' }, at(toolSaveFile, context)), ...many(toolSessionMcp, context).map((tool) => withWidget(\"@agimon-ai/po-mcp/session_mcp\", tool)), via({ name: 'share_file' }, at(toolShareFile, context))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}
+{"version":3,"file":"mcp.cjs","names":["defineMcpSkill","readPackageResource","defineMcpTool","defineMcpTool","Type","defineRoutedContribution","defineMcpTool","defineMcpPlugin","skillPoUseMcp","toolMcpUse","toolSaveFile","toolSessionMcp","toolShareFile"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-mcp.mcp.ts","../../src/services/mcpHeadlessTools/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/mcp_use.mcp.ts","../../src/extensions/workspaces/sessions/(backend)/tool/save_file.mcp.ts","../../src/schemas/mcpHeadlessTool.ts","../../src/services/mcpSessionTools/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/session_mcp.mcp.ts","../../src/extensions/workspaces/sessions/(backend)/tool/share_file.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverPlugin';\n\nexport default defineMcpSkill({\n  name: 'po-use-mcp',\n  description:\n    'Use Po Pi MCP to inspect domain-scoped servers, authenticate, reload configuration, and troubleshoot tool availability.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-mcp/SKILL.md'),\n});\n","import type { PoHeadlessTool } from '@agimon-ai/po-core/headless';\nimport type { PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\nimport type { Context } from '@deepseek-ai/cordis';\n\nexport const MCP_HEADLESS_TOOLS_SERVICE = 'po/mcp-headless-tools';\n\nexport interface McpHeadlessToolCatalog {\n  get(name: string): PoHeadlessTool | undefined;\n}\n\nexport function mountMcpHeadlessTools(tools: readonly PoHeadlessTool[]) {\n  return (context: Context): void => {\n    context.plugin((providerContext) => {\n      providerContext.provide(MCP_HEADLESS_TOOLS_SERVICE, {\n        get: (name) => tools.find((tool) => tool.name === name),\n      } satisfies McpHeadlessToolCatalog);\n    });\n  };\n}\n\nexport function bindMcpHeadlessTool(context: PoMcpPluginContext, name: string): PoHeadlessTool {\n  const tool = context.services.get<McpHeadlessToolCatalog>(MCP_HEADLESS_TOOLS_SERVICE)?.get(name);\n  if (!tool) throw new Error(`MCP tool is unavailable: ${name}`);\n  return {\n    ...tool,\n    execute(toolCallId, parameters, signal, onUpdate) {\n      const executionSignal = AbortSignal.any([context.signal, signal ?? context.signal]);\n      return tool.execute(toolCallId, parameters, executionSignal, onUpdate, context.execution);\n    },\n  };\n}\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'mcp_use'));\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'save_file'));\n","import { Type } from 'typebox';\n\nexport const McpHeadlessToolParameters = Type.Object({\n  server: Type.String({ minLength: 1 }),\n  tool: Type.String({ minLength: 1 }),\n  arguments: Type.Optional(Type.Record(Type.String(), Type.Unknown())),\n});\n","import type { PoChildSessionMcpCatalog, PoChildSessionMcpTool } from '@agimon-ai/po-core/childSession';\nimport type { PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport type { ReadResourceResult } from '@modelcontextprotocol/server';\nimport type { Static, TSchema } from 'typebox';\nimport { Value } from 'typebox/value';\n\nimport { McpHeadlessToolParameters } from '../../schemas/mcpHeadlessTool';\nimport { mcpToolExecutionMetadata, type CatalogTool } from '../mcpCatalog';\nimport { modelInputSchema } from '../mcpFileParams';\nimport type { McpSession } from '../mcpSession';\n\nexport const MCP_SESSION_TOOLS_SERVICE = 'po/mcp-session-tools';\n\n/** This projection needs no caller-owned execution context and can be borrowed unchanged. */\nexport interface McpDirectTool extends PoHeadlessTool {\n  execute(toolCallId: string, parameters: unknown, signal?: AbortSignal): Promise<PoHeadlessToolResult>;\n}\n\n/** Narrow cross-root access to the Pi session's existing upstream MCP runtime. */\nexport interface McpSessionToolsService {\n  readonly generation: string;\n  runtimeRevision(): number;\n  readAppResource(server: string, tool: string, resourceUri: string, signal?: AbortSignal): Promise<ReadResourceResult>;\n  snapshot(): readonly CatalogTool[];\n  project(): readonly McpDirectTool[];\n  refresh(): void;\n  dispose(): void;\n  resolveSelectors(selectors: readonly string[]): readonly string[];\n  onChange(listener: () => void): () => void;\n  invoke(name: string, parameters: Record<string, unknown>, signal?: AbortSignal): Promise<PoHeadlessToolResult>;\n}\n\nexport function createMcpSessionToolsService(\n  session: McpSession,\n  generation: string,\n  assertAvailable: () => void = () => undefined,\n): McpSessionToolsService {\n  let disposed = false;\n  const listeners = new Set<() => void>();\n  const retained = new Map<string, { fingerprint: string; tool: McpDirectTool; retire(): void }>();\n  const snapshot = () => {\n    try {\n      if (disposed) return [];\n      assertAvailable();\n      return session.activeToolDefinitions();\n    } catch {\n      // An inactive or stale parent lends no declarations.\n      return [];\n    }\n  };\n  const project = (): readonly McpDirectTool[] => {\n    const definitions = snapshot();\n    const names = new Set(definitions.map((tool) => tool.piName));\n    for (const [name, entry] of retained) {\n      if (names.has(name)) continue;\n      entry.retire();\n      retained.delete(name);\n    }\n    return definitions.map((definition) => {\n      const fingerprint = JSON.stringify([session.toolGeneration, definition]);\n      const previous = retained.get(definition.piName);\n      if (previous?.fingerprint === fingerprint) return previous.tool;\n      previous?.retire();\n      let retired = false;\n      const invoke = session.bindToolInvocation(definition);\n      const tool: McpDirectTool = {\n        name: definition.piName,\n        label: `${definition.serverName}: ${definition.toolName}`,\n        description: definition.description ?? `${definition.toolName} on the ${definition.serverName} MCP server.`,\n        ...(definition.annotations === undefined ? {} : { annotations: definition.annotations }),\n        ...(definition._meta === undefined ? {} : { _meta: mcpToolExecutionMetadata(definition) }),\n        ...(definition.outputSchema === undefined ? {} : { outputSchema: definition.outputSchema }),\n        // File parameters are validated as the `{path}` objects the model sends.\n        parameters: modelInputSchema(definition) as TSchema,\n        async execute(_toolCallId, parameters, signal) {\n          assertAvailable();\n          if (retired) throw new Error(`MCP tool ${definition.piName} is no longer available.`);\n          signal?.throwIfAborted();\n          const arguments_ = parameters === undefined ? {} : parameters;\n          if (!Value.Check(tool.parameters, arguments_))\n            throw new Error(`Invalid arguments for MCP tool ${definition.piName}.`);\n          const result = await invoke(arguments_ as Record<string, unknown>, signal);\n          signal?.throwIfAborted();\n          return result;\n        },\n      };\n      retained.set(definition.piName, {\n        fingerprint,\n        tool,\n        retire: () => {\n          retired = true;\n        },\n      });\n      return tool;\n    });\n  };\n  const refresh = () => {\n    project();\n    for (const listener of listeners) listener();\n  };\n  // Retirement must happen even if a borrower temporarily has no change listener.\n  const stopSession = session.onChange(refresh);\n  return Object.freeze({\n    generation,\n    runtimeRevision: () => session.toolGeneration,\n    readAppResource: async (server: string, tool: string, resourceUri: string, signal?: AbortSignal) => {\n      assertAvailable();\n      if (disposed) throw new Error('The MCP session is no longer available.');\n      const result = await session.readAppResource(server, tool, resourceUri, signal);\n      assertAvailable();\n      if (disposed) throw new Error('The MCP session is no longer available.');\n      return result;\n    },\n    snapshot,\n    project,\n    refresh,\n    dispose: () => {\n      disposed = true;\n      stopSession();\n      refresh();\n      listeners.clear();\n    },\n    resolveSelectors: (selectors: readonly string[]) => {\n      const active = new Set(snapshot().map((tool) => tool.piName));\n      return session\n        .resolveToolSelectors(selectors)\n        .map((tool) => tool.name)\n        .filter((name) => active.has(name));\n    },\n    onChange: (listener: () => void) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    invoke: async (name: string, parameters: Record<string, unknown>, signal?: AbortSignal) => {\n      assertAvailable();\n      const tool = project().find((candidate) => candidate.name === name);\n      if (!tool) throw new Error(`MCP tool ${name} is not available in this session.`);\n      return tool.execute('mcp', parameters, signal);\n    },\n  });\n}\n\n/** Borrow an existing MCP runtime; a child never starts or disposes its own upstream connections. */\nexport function createMcpChildTool(\n  invoke: (parameters: Static<typeof McpHeadlessToolParameters>, signal?: AbortSignal) => Promise<PoHeadlessToolResult>,\n  catalog?: PoChildSessionMcpCatalog,\n): PoChildSessionMcpTool {\n  return {\n    name: 'mcp',\n    ...(catalog === undefined ? {} : { catalog }),\n    description: 'Call a tool exposed by a connected MCP server.',\n    parameters: McpHeadlessToolParameters,\n    async execute(_toolCallId, parameters, signal) {\n      signal?.throwIfAborted();\n      if (!Value.Check(McpHeadlessToolParameters, parameters)) throw new Error('Invalid MCP tool arguments.');\n      const result = await invoke(parameters, signal);\n      signal?.throwIfAborted();\n      return result;\n    },\n  };\n}\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { PoHeadlessTool } from '@agimon-ai/po-core/headless';\nimport type { PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport {\n  MCP_SESSION_TOOLS_SERVICE,\n  type McpDirectTool,\n  type McpSessionToolsService,\n} from '../../../../../services/mcpSessionTools';\n\nexport default defineRoutedContribution(\n  (context: PoMcpPluginContext): readonly PoHeadlessTool[] => {\n    const service = context.services.get<McpSessionToolsService>(MCP_SESSION_TOOLS_SERVICE);\n    if (!service) return [];\n    let current: readonly McpDirectTool[] = [];\n    const stop = service.onChange(() => {\n      const next = service.project();\n      if (next.length === current.length && next.every((tool, index) => tool === current[index])) return;\n      current = next;\n      context.refresh();\n    });\n    current = service.project();\n    context.signal.addEventListener('abort', stop, { once: true });\n    return current.map((tool) => ({\n      ...tool,\n      execute: (toolCallId, parameters, signal) =>\n        tool.execute(toolCallId, parameters, AbortSignal.any([context.signal, signal ?? context.signal])),\n    }));\n  },\n  { cardinality: 'many' },\n);\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'share_file'));\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUseMcp from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-mcp.mcp';\nimport toolMcpUse from '../src/extensions/workspaces/sessions/(backend)/tool/mcp_use.mcp';\nimport toolSaveFile from '../src/extensions/workspaces/sessions/(backend)/tool/save_file.mcp';\nimport toolSessionMcp from '../src/extensions/workspaces/sessions/(backend)/tool/session_mcp.mcp';\nimport toolShareFile from '../src/extensions/workspaces/sessions/(backend)/tool/share_file.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\ntype ManyFactory<T, C> = (context: C) => T | readonly T[];\nconst many = <T, C>(value: T | readonly T[] | ManyFactory<T, C>, context: C): readonly T[] => {\n  const resolved = typeof value === 'function' ? (value as ManyFactory<T, C>)(context) : value;\n  return Array.isArray(resolved) ? resolved : [resolved as T];\n};\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nconst withWidget = <T>(key: string, value: T): T => value === undefined ? value : ({\n  ...value, _meta: { ...(value as { _meta?: object })._meta, [\"po/widget\"]: key },\n});\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-mcp',\n  session: (context) => ({\n    get skills(): PoMcpSessionPlugin['skills'] { return [at(skillPoUseMcp, context)]; },\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-mcp/mcp_use\", via({ name: 'mcp_use' }, at(toolMcpUse, context))), via({ name: 'save_file' }, at(toolSaveFile, context)), ...many(toolSessionMcp, context).map((tool) => withWidget(\"@agimon-ai/po-mcp/session_mcp\", tool)), via({ name: 'share_file' }, at(toolShareFile, context))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}

package/dist/extensions/mcp.mjs

@@ -1,5 +1,5 @@
 import { defineMcpPlugin, defineMcpSkill, defineMcpTool } from "@agimon-ai/po-core/mcpFacet";
-import { readPackageResource } from "@agimon-ai/po-core/serverFacet";
+import { readPackageResource } from "@agimon-ai/po-core/serverPlugin";
 import { defineRoutedContribution } from "@agimon-ai/po-core/extensionFile";
 import "typebox/value";
 import { Type } from "typebox";

package/dist/extensions/mcp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.mjs","names":["skillPoUseMcp","toolMcpUse","toolSaveFile","toolSessionMcp","toolShareFile"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-mcp.mcp.ts","../../src/services/mcpHeadlessTools/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/mcp_use.mcp.ts","../../src/extensions/workspaces/sessions/(backend)/tool/save_file.mcp.ts","../../src/schemas/mcpHeadlessTool.ts","../../src/services/mcpSessionTools/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/session_mcp.mcp.ts","../../src/extensions/workspaces/sessions/(backend)/tool/share_file.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-use-mcp',\n  description:\n    'Use Po Pi MCP to inspect domain-scoped servers, authenticate, reload configuration, and troubleshoot tool availability.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-mcp/SKILL.md'),\n});\n","import type { PoHeadlessTool } from '@agimon-ai/po-core/headless';\nimport type { PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\nimport type { Context } from '@deepseek-ai/cordis';\n\nexport const MCP_HEADLESS_TOOLS_SERVICE = 'po/mcp-headless-tools';\n\nexport interface McpHeadlessToolCatalog {\n  get(name: string): PoHeadlessTool | undefined;\n}\n\nexport function mountMcpHeadlessTools(tools: readonly PoHeadlessTool[]) {\n  return (context: Context): void => {\n    context.plugin((providerContext) => {\n      providerContext.provide(MCP_HEADLESS_TOOLS_SERVICE, {\n        get: (name) => tools.find((tool) => tool.name === name),\n      } satisfies McpHeadlessToolCatalog);\n    });\n  };\n}\n\nexport function bindMcpHeadlessTool(context: PoMcpPluginContext, name: string): PoHeadlessTool {\n  const tool = context.services.get<McpHeadlessToolCatalog>(MCP_HEADLESS_TOOLS_SERVICE)?.get(name);\n  if (!tool) throw new Error(`MCP tool is unavailable: ${name}`);\n  return {\n    ...tool,\n    execute(toolCallId, parameters, signal, onUpdate) {\n      const executionSignal = AbortSignal.any([context.signal, signal ?? context.signal]);\n      return tool.execute(toolCallId, parameters, executionSignal, onUpdate, context.execution);\n    },\n  };\n}\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'mcp_use'));\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'save_file'));\n","import { Type } from 'typebox';\n\nexport const McpHeadlessToolParameters = Type.Object({\n  server: Type.String({ minLength: 1 }),\n  tool: Type.String({ minLength: 1 }),\n  arguments: Type.Optional(Type.Record(Type.String(), Type.Unknown())),\n});\n","import type { PoChildSessionMcpCatalog, PoChildSessionMcpTool } from '@agimon-ai/po-core/childSession';\nimport type { PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport type { ReadResourceResult } from '@modelcontextprotocol/server';\nimport type { Static, TSchema } from 'typebox';\nimport { Value } from 'typebox/value';\n\nimport { McpHeadlessToolParameters } from '../../schemas/mcpHeadlessTool';\nimport { mcpToolExecutionMetadata, type CatalogTool } from '../mcpCatalog';\nimport { modelInputSchema } from '../mcpFileParams';\nimport type { McpSession } from '../mcpSession';\n\nexport const MCP_SESSION_TOOLS_SERVICE = 'po/mcp-session-tools';\n\n/** This projection needs no caller-owned execution context and can be borrowed unchanged. */\nexport interface McpDirectTool extends PoHeadlessTool {\n  execute(toolCallId: string, parameters: unknown, signal?: AbortSignal): Promise<PoHeadlessToolResult>;\n}\n\n/** Narrow cross-root access to the Pi session's existing upstream MCP runtime. */\nexport interface McpSessionToolsService {\n  readonly generation: string;\n  runtimeRevision(): number;\n  readAppResource(server: string, tool: string, resourceUri: string, signal?: AbortSignal): Promise<ReadResourceResult>;\n  snapshot(): readonly CatalogTool[];\n  project(): readonly McpDirectTool[];\n  refresh(): void;\n  dispose(): void;\n  resolveSelectors(selectors: readonly string[]): readonly string[];\n  onChange(listener: () => void): () => void;\n  invoke(name: string, parameters: Record<string, unknown>, signal?: AbortSignal): Promise<PoHeadlessToolResult>;\n}\n\nexport function createMcpSessionToolsService(\n  session: McpSession,\n  generation: string,\n  assertAvailable: () => void = () => undefined,\n): McpSessionToolsService {\n  let disposed = false;\n  const listeners = new Set<() => void>();\n  const retained = new Map<string, { fingerprint: string; tool: McpDirectTool; retire(): void }>();\n  const snapshot = () => {\n    try {\n      if (disposed) return [];\n      assertAvailable();\n      return session.activeToolDefinitions();\n    } catch {\n      // An inactive or stale parent lends no declarations.\n      return [];\n    }\n  };\n  const project = (): readonly McpDirectTool[] => {\n    const definitions = snapshot();\n    const names = new Set(definitions.map((tool) => tool.piName));\n    for (const [name, entry] of retained) {\n      if (names.has(name)) continue;\n      entry.retire();\n      retained.delete(name);\n    }\n    return definitions.map((definition) => {\n      const fingerprint = JSON.stringify([session.toolGeneration, definition]);\n      const previous = retained.get(definition.piName);\n      if (previous?.fingerprint === fingerprint) return previous.tool;\n      previous?.retire();\n      let retired = false;\n      const invoke = session.bindToolInvocation(definition);\n      const tool: McpDirectTool = {\n        name: definition.piName,\n        label: `${definition.serverName}: ${definition.toolName}`,\n        description: definition.description ?? `${definition.toolName} on the ${definition.serverName} MCP server.`,\n        ...(definition.annotations === undefined ? {} : { annotations: definition.annotations }),\n        ...(definition._meta === undefined ? {} : { _meta: mcpToolExecutionMetadata(definition) }),\n        ...(definition.outputSchema === undefined ? {} : { outputSchema: definition.outputSchema }),\n        // File parameters are validated as the `{path}` objects the model sends.\n        parameters: modelInputSchema(definition) as TSchema,\n        async execute(_toolCallId, parameters, signal) {\n          assertAvailable();\n          if (retired) throw new Error(`MCP tool ${definition.piName} is no longer available.`);\n          signal?.throwIfAborted();\n          const arguments_ = parameters === undefined ? {} : parameters;\n          if (!Value.Check(tool.parameters, arguments_))\n            throw new Error(`Invalid arguments for MCP tool ${definition.piName}.`);\n          const result = await invoke(arguments_ as Record<string, unknown>, signal);\n          signal?.throwIfAborted();\n          return result;\n        },\n      };\n      retained.set(definition.piName, {\n        fingerprint,\n        tool,\n        retire: () => {\n          retired = true;\n        },\n      });\n      return tool;\n    });\n  };\n  const refresh = () => {\n    project();\n    for (const listener of listeners) listener();\n  };\n  // Retirement must happen even if a borrower temporarily has no change listener.\n  const stopSession = session.onChange(refresh);\n  return Object.freeze({\n    generation,\n    runtimeRevision: () => session.toolGeneration,\n    readAppResource: async (server: string, tool: string, resourceUri: string, signal?: AbortSignal) => {\n      assertAvailable();\n      if (disposed) throw new Error('The MCP session is no longer available.');\n      const result = await session.readAppResource(server, tool, resourceUri, signal);\n      assertAvailable();\n      if (disposed) throw new Error('The MCP session is no longer available.');\n      return result;\n    },\n    snapshot,\n    project,\n    refresh,\n    dispose: () => {\n      disposed = true;\n      stopSession();\n      refresh();\n      listeners.clear();\n    },\n    resolveSelectors: (selectors: readonly string[]) => {\n      const active = new Set(snapshot().map((tool) => tool.piName));\n      return session\n        .resolveToolSelectors(selectors)\n        .map((tool) => tool.name)\n        .filter((name) => active.has(name));\n    },\n    onChange: (listener: () => void) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    invoke: async (name: string, parameters: Record<string, unknown>, signal?: AbortSignal) => {\n      assertAvailable();\n      const tool = project().find((candidate) => candidate.name === name);\n      if (!tool) throw new Error(`MCP tool ${name} is not available in this session.`);\n      return tool.execute('mcp', parameters, signal);\n    },\n  });\n}\n\n/** Borrow an existing MCP runtime; a child never starts or disposes its own upstream connections. */\nexport function createMcpChildTool(\n  invoke: (parameters: Static<typeof McpHeadlessToolParameters>, signal?: AbortSignal) => Promise<PoHeadlessToolResult>,\n  catalog?: PoChildSessionMcpCatalog,\n): PoChildSessionMcpTool {\n  return {\n    name: 'mcp',\n    ...(catalog === undefined ? {} : { catalog }),\n    description: 'Call a tool exposed by a connected MCP server.',\n    parameters: McpHeadlessToolParameters,\n    async execute(_toolCallId, parameters, signal) {\n      signal?.throwIfAborted();\n      if (!Value.Check(McpHeadlessToolParameters, parameters)) throw new Error('Invalid MCP tool arguments.');\n      const result = await invoke(parameters, signal);\n      signal?.throwIfAborted();\n      return result;\n    },\n  };\n}\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { PoHeadlessTool } from '@agimon-ai/po-core/headless';\nimport type { PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport {\n  MCP_SESSION_TOOLS_SERVICE,\n  type McpDirectTool,\n  type McpSessionToolsService,\n} from '../../../../../services/mcpSessionTools';\n\nexport default defineRoutedContribution(\n  (context: PoMcpPluginContext): readonly PoHeadlessTool[] => {\n    const service = context.services.get<McpSessionToolsService>(MCP_SESSION_TOOLS_SERVICE);\n    if (!service) return [];\n    let current: readonly McpDirectTool[] = [];\n    const stop = service.onChange(() => {\n      const next = service.project();\n      if (next.length === current.length && next.every((tool, index) => tool === current[index])) return;\n      current = next;\n      context.refresh();\n    });\n    current = service.project();\n    context.signal.addEventListener('abort', stop, { once: true });\n    return current.map((tool) => ({\n      ...tool,\n      execute: (toolCallId, parameters, signal) =>\n        tool.execute(toolCallId, parameters, AbortSignal.any([context.signal, signal ?? context.signal])),\n    }));\n  },\n  { cardinality: 'many' },\n);\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'share_file'));\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUseMcp from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-mcp.mcp';\nimport toolMcpUse from '../src/extensions/workspaces/sessions/(backend)/tool/mcp_use.mcp';\nimport toolSaveFile from '../src/extensions/workspaces/sessions/(backend)/tool/save_file.mcp';\nimport toolSessionMcp from '../src/extensions/workspaces/sessions/(backend)/tool/session_mcp.mcp';\nimport toolShareFile from '../src/extensions/workspaces/sessions/(backend)/tool/share_file.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\ntype ManyFactory<T, C> = (context: C) => T | readonly T[];\nconst many = <T, C>(value: T | readonly T[] | ManyFactory<T, C>, context: C): readonly T[] => {\n  const resolved = typeof value === 'function' ? (value as ManyFactory<T, C>)(context) : value;\n  return Array.isArray(resolved) ? resolved : [resolved as T];\n};\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nconst withWidget = <T>(key: string, value: T): T => value === undefined ? value : ({\n  ...value, _meta: { ...(value as { _meta?: object })._meta, [\"po/widget\"]: key },\n});\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-mcp',\n  session: (context) => ({\n    get skills(): PoMcpSessionPlugin['skills'] { return [at(skillPoUseMcp, context)]; },\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-mcp/mcp_use\", via({ name: 'mcp_use' }, at(toolMcpUse, context))), via({ name: 'save_file' }, at(toolSaveFile, context)), ...many(toolSessionMcp, context).map((tool) => withWidget(\"@agimon-ai/po-mcp/session_mcp\", tool)), via({ name: 'share_file' }, at(toolShareFile, context))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}
+{"version":3,"file":"mcp.mjs","names":["skillPoUseMcp","toolMcpUse","toolSaveFile","toolSessionMcp","toolShareFile"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-mcp.mcp.ts","../../src/services/mcpHeadlessTools/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/mcp_use.mcp.ts","../../src/extensions/workspaces/sessions/(backend)/tool/save_file.mcp.ts","../../src/schemas/mcpHeadlessTool.ts","../../src/services/mcpSessionTools/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/session_mcp.mcp.ts","../../src/extensions/workspaces/sessions/(backend)/tool/share_file.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverPlugin';\n\nexport default defineMcpSkill({\n  name: 'po-use-mcp',\n  description:\n    'Use Po Pi MCP to inspect domain-scoped servers, authenticate, reload configuration, and troubleshoot tool availability.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-mcp/SKILL.md'),\n});\n","import type { PoHeadlessTool } from '@agimon-ai/po-core/headless';\nimport type { PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\nimport type { Context } from '@deepseek-ai/cordis';\n\nexport const MCP_HEADLESS_TOOLS_SERVICE = 'po/mcp-headless-tools';\n\nexport interface McpHeadlessToolCatalog {\n  get(name: string): PoHeadlessTool | undefined;\n}\n\nexport function mountMcpHeadlessTools(tools: readonly PoHeadlessTool[]) {\n  return (context: Context): void => {\n    context.plugin((providerContext) => {\n      providerContext.provide(MCP_HEADLESS_TOOLS_SERVICE, {\n        get: (name) => tools.find((tool) => tool.name === name),\n      } satisfies McpHeadlessToolCatalog);\n    });\n  };\n}\n\nexport function bindMcpHeadlessTool(context: PoMcpPluginContext, name: string): PoHeadlessTool {\n  const tool = context.services.get<McpHeadlessToolCatalog>(MCP_HEADLESS_TOOLS_SERVICE)?.get(name);\n  if (!tool) throw new Error(`MCP tool is unavailable: ${name}`);\n  return {\n    ...tool,\n    execute(toolCallId, parameters, signal, onUpdate) {\n      const executionSignal = AbortSignal.any([context.signal, signal ?? context.signal]);\n      return tool.execute(toolCallId, parameters, executionSignal, onUpdate, context.execution);\n    },\n  };\n}\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'mcp_use'));\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'save_file'));\n","import { Type } from 'typebox';\n\nexport const McpHeadlessToolParameters = Type.Object({\n  server: Type.String({ minLength: 1 }),\n  tool: Type.String({ minLength: 1 }),\n  arguments: Type.Optional(Type.Record(Type.String(), Type.Unknown())),\n});\n","import type { PoChildSessionMcpCatalog, PoChildSessionMcpTool } from '@agimon-ai/po-core/childSession';\nimport type { PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport type { ReadResourceResult } from '@modelcontextprotocol/server';\nimport type { Static, TSchema } from 'typebox';\nimport { Value } from 'typebox/value';\n\nimport { McpHeadlessToolParameters } from '../../schemas/mcpHeadlessTool';\nimport { mcpToolExecutionMetadata, type CatalogTool } from '../mcpCatalog';\nimport { modelInputSchema } from '../mcpFileParams';\nimport type { McpSession } from '../mcpSession';\n\nexport const MCP_SESSION_TOOLS_SERVICE = 'po/mcp-session-tools';\n\n/** This projection needs no caller-owned execution context and can be borrowed unchanged. */\nexport interface McpDirectTool extends PoHeadlessTool {\n  execute(toolCallId: string, parameters: unknown, signal?: AbortSignal): Promise<PoHeadlessToolResult>;\n}\n\n/** Narrow cross-root access to the Pi session's existing upstream MCP runtime. */\nexport interface McpSessionToolsService {\n  readonly generation: string;\n  runtimeRevision(): number;\n  readAppResource(server: string, tool: string, resourceUri: string, signal?: AbortSignal): Promise<ReadResourceResult>;\n  snapshot(): readonly CatalogTool[];\n  project(): readonly McpDirectTool[];\n  refresh(): void;\n  dispose(): void;\n  resolveSelectors(selectors: readonly string[]): readonly string[];\n  onChange(listener: () => void): () => void;\n  invoke(name: string, parameters: Record<string, unknown>, signal?: AbortSignal): Promise<PoHeadlessToolResult>;\n}\n\nexport function createMcpSessionToolsService(\n  session: McpSession,\n  generation: string,\n  assertAvailable: () => void = () => undefined,\n): McpSessionToolsService {\n  let disposed = false;\n  const listeners = new Set<() => void>();\n  const retained = new Map<string, { fingerprint: string; tool: McpDirectTool; retire(): void }>();\n  const snapshot = () => {\n    try {\n      if (disposed) return [];\n      assertAvailable();\n      return session.activeToolDefinitions();\n    } catch {\n      // An inactive or stale parent lends no declarations.\n      return [];\n    }\n  };\n  const project = (): readonly McpDirectTool[] => {\n    const definitions = snapshot();\n    const names = new Set(definitions.map((tool) => tool.piName));\n    for (const [name, entry] of retained) {\n      if (names.has(name)) continue;\n      entry.retire();\n      retained.delete(name);\n    }\n    return definitions.map((definition) => {\n      const fingerprint = JSON.stringify([session.toolGeneration, definition]);\n      const previous = retained.get(definition.piName);\n      if (previous?.fingerprint === fingerprint) return previous.tool;\n      previous?.retire();\n      let retired = false;\n      const invoke = session.bindToolInvocation(definition);\n      const tool: McpDirectTool = {\n        name: definition.piName,\n        label: `${definition.serverName}: ${definition.toolName}`,\n        description: definition.description ?? `${definition.toolName} on the ${definition.serverName} MCP server.`,\n        ...(definition.annotations === undefined ? {} : { annotations: definition.annotations }),\n        ...(definition._meta === undefined ? {} : { _meta: mcpToolExecutionMetadata(definition) }),\n        ...(definition.outputSchema === undefined ? {} : { outputSchema: definition.outputSchema }),\n        // File parameters are validated as the `{path}` objects the model sends.\n        parameters: modelInputSchema(definition) as TSchema,\n        async execute(_toolCallId, parameters, signal) {\n          assertAvailable();\n          if (retired) throw new Error(`MCP tool ${definition.piName} is no longer available.`);\n          signal?.throwIfAborted();\n          const arguments_ = parameters === undefined ? {} : parameters;\n          if (!Value.Check(tool.parameters, arguments_))\n            throw new Error(`Invalid arguments for MCP tool ${definition.piName}.`);\n          const result = await invoke(arguments_ as Record<string, unknown>, signal);\n          signal?.throwIfAborted();\n          return result;\n        },\n      };\n      retained.set(definition.piName, {\n        fingerprint,\n        tool,\n        retire: () => {\n          retired = true;\n        },\n      });\n      return tool;\n    });\n  };\n  const refresh = () => {\n    project();\n    for (const listener of listeners) listener();\n  };\n  // Retirement must happen even if a borrower temporarily has no change listener.\n  const stopSession = session.onChange(refresh);\n  return Object.freeze({\n    generation,\n    runtimeRevision: () => session.toolGeneration,\n    readAppResource: async (server: string, tool: string, resourceUri: string, signal?: AbortSignal) => {\n      assertAvailable();\n      if (disposed) throw new Error('The MCP session is no longer available.');\n      const result = await session.readAppResource(server, tool, resourceUri, signal);\n      assertAvailable();\n      if (disposed) throw new Error('The MCP session is no longer available.');\n      return result;\n    },\n    snapshot,\n    project,\n    refresh,\n    dispose: () => {\n      disposed = true;\n      stopSession();\n      refresh();\n      listeners.clear();\n    },\n    resolveSelectors: (selectors: readonly string[]) => {\n      const active = new Set(snapshot().map((tool) => tool.piName));\n      return session\n        .resolveToolSelectors(selectors)\n        .map((tool) => tool.name)\n        .filter((name) => active.has(name));\n    },\n    onChange: (listener: () => void) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    invoke: async (name: string, parameters: Record<string, unknown>, signal?: AbortSignal) => {\n      assertAvailable();\n      const tool = project().find((candidate) => candidate.name === name);\n      if (!tool) throw new Error(`MCP tool ${name} is not available in this session.`);\n      return tool.execute('mcp', parameters, signal);\n    },\n  });\n}\n\n/** Borrow an existing MCP runtime; a child never starts or disposes its own upstream connections. */\nexport function createMcpChildTool(\n  invoke: (parameters: Static<typeof McpHeadlessToolParameters>, signal?: AbortSignal) => Promise<PoHeadlessToolResult>,\n  catalog?: PoChildSessionMcpCatalog,\n): PoChildSessionMcpTool {\n  return {\n    name: 'mcp',\n    ...(catalog === undefined ? {} : { catalog }),\n    description: 'Call a tool exposed by a connected MCP server.',\n    parameters: McpHeadlessToolParameters,\n    async execute(_toolCallId, parameters, signal) {\n      signal?.throwIfAborted();\n      if (!Value.Check(McpHeadlessToolParameters, parameters)) throw new Error('Invalid MCP tool arguments.');\n      const result = await invoke(parameters, signal);\n      signal?.throwIfAborted();\n      return result;\n    },\n  };\n}\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { PoHeadlessTool } from '@agimon-ai/po-core/headless';\nimport type { PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport {\n  MCP_SESSION_TOOLS_SERVICE,\n  type McpDirectTool,\n  type McpSessionToolsService,\n} from '../../../../../services/mcpSessionTools';\n\nexport default defineRoutedContribution(\n  (context: PoMcpPluginContext): readonly PoHeadlessTool[] => {\n    const service = context.services.get<McpSessionToolsService>(MCP_SESSION_TOOLS_SERVICE);\n    if (!service) return [];\n    let current: readonly McpDirectTool[] = [];\n    const stop = service.onChange(() => {\n      const next = service.project();\n      if (next.length === current.length && next.every((tool, index) => tool === current[index])) return;\n      current = next;\n      context.refresh();\n    });\n    current = service.project();\n    context.signal.addEventListener('abort', stop, { once: true });\n    return current.map((tool) => ({\n      ...tool,\n      execute: (toolCallId, parameters, signal) =>\n        tool.execute(toolCallId, parameters, AbortSignal.any([context.signal, signal ?? context.signal])),\n    }));\n  },\n  { cardinality: 'many' },\n);\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\n\nimport { bindMcpHeadlessTool } from '../../../../../services/mcpHeadlessTools';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => bindMcpHeadlessTool(context, 'share_file'));\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUseMcp from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-mcp.mcp';\nimport toolMcpUse from '../src/extensions/workspaces/sessions/(backend)/tool/mcp_use.mcp';\nimport toolSaveFile from '../src/extensions/workspaces/sessions/(backend)/tool/save_file.mcp';\nimport toolSessionMcp from '../src/extensions/workspaces/sessions/(backend)/tool/session_mcp.mcp';\nimport toolShareFile from '../src/extensions/workspaces/sessions/(backend)/tool/share_file.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\ntype ManyFactory<T, C> = (context: C) => T | readonly T[];\nconst many = <T, C>(value: T | readonly T[] | ManyFactory<T, C>, context: C): readonly T[] => {\n  const resolved = typeof value === 'function' ? (value as ManyFactory<T, C>)(context) : value;\n  return Array.isArray(resolved) ? resolved : [resolved as T];\n};\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nconst withWidget = <T>(key: string, value: T): T => value === undefined ? value : ({\n  ...value, _meta: { ...(value as { _meta?: object })._meta, [\"po/widget\"]: key },\n});\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-mcp',\n  session: (context) => ({\n    get skills(): PoMcpSessionPlugin['skills'] { return [at(skillPoUseMcp, context)]; },\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-mcp/mcp_use\", via({ name: 'mcp_use' }, at(toolMcpUse, context))), via({ name: 'save_file' }, at(toolSaveFile, context)), ...many(toolSessionMcp, context).map((tool) => withWidget(\"@agimon-ai/po-mcp/session_mcp\", tool)), via({ name: 'share_file' }, at(toolShareFile, context))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}

package/dist/extensions/server.cjs

@@ -13,7 +13,7 @@ node_path = require_rolldown_runtime.__toESM(node_path, 1);
 let node_os = require("node:os");
 node_os = require_rolldown_runtime.__toESM(node_os, 1);
 let _agimon_ai_po_core_mcpProjection = require("@agimon-ai/po-core/mcpProjection");
-let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+let _agimon_ai_po_core_serverPlugin = require("@agimon-ai/po-core/serverPlugin");
 let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
 let _agimon_ai_po_core_childSession = require("@agimon-ai/po-core/childSession");
 let _agimon_ai_po_core_headless = require("@agimon-ai/po-core/headless");
@@ -230,7 +230,7 @@ function createFileTransferTools(owner) {
 			const bytes = "download_url" in file ? await downloadPublicFile(file.download_url, signal) : decodeFileBase64(file.data_base64);
 			signal.throwIfAborted();
 			const name = "download_url" in file ? file.file_name : file.name;
-			const result = input.path === void 0 ? await (0, _agimon_ai_po_core_serverFacet.writeSessionAttachment)(context.sessionId, name, bytes, context.environment) : {
+			const result = input.path === void 0 ? await (0, _agimon_ai_po_core_serverPlugin.writeSessionAttachment)(context.sessionId, name, bytes, context.environment) : {
 				path: await writeCwdFile(context.cwd, input.path, bytes),
 				name: node_path.default.basename(input.path),
 				size: bytes.length,
@@ -698,7 +698,7 @@ function createMcpAppsService(tools, getHost, lifetime) {
 	return {
 		dispose,
 		methods: [
-			(0, _agimon_ai_po_core_serverFacet.defineServerMethod)(mcpAppOpenMethod, async ({ toolCallId }, caller) => {
+			(0, _agimon_ai_po_core_serverPlugin.defineServerMethod)(mcpAppOpenMethod, async ({ toolCallId }, caller) => {
 				if (!caller.connectionId || !caller.signal) throw new Error("An authenticated live connection is required.");
 				caller.signal.throwIfAborted();
 				if (disposed || lifetime?.aborted) throw new Error("App session is no longer available.");
@@ -783,12 +783,12 @@ function createMcpAppsService(tools, getHost, lifetime) {
 					opening--;
 				}
 			}),
-			(0, _agimon_ai_po_core_serverFacet.defineServerMethod)(mcpAppActivateMethod, ({ leaseId }, caller) => operation(leaseId, caller, false, async (lease) => {
+			(0, _agimon_ai_po_core_serverPlugin.defineServerMethod)(mcpAppActivateMethod, ({ leaseId }, caller) => operation(leaseId, caller, false, async (lease) => {
 				await confirm(lease, `Enable ${lease.server} App interactions?`, "This App may request tool calls and follow-up messages. Each action still requires approval.");
 				lease.readOnly = false;
 				return { readOnly: false };
 			})),
-			(0, _agimon_ai_po_core_serverFacet.defineServerMethod)(mcpAppCallToolMethod, ({ leaseId, name, arguments: args }, caller) => operation(leaseId, caller, true, async (lease) => {
+			(0, _agimon_ai_po_core_serverPlugin.defineServerMethod)(mcpAppCallToolMethod, ({ leaseId, name, arguments: args }, caller) => operation(leaseId, caller, true, async (lease) => {
 				boundedJson(args, MAX_STATE_BYTES, "Tool arguments");
 				const target = tools.snapshot().find((tool) => tool.serverName === lease.server && tool.toolName === name && require_mcpCatalog.isAppVisibleMcpTool(tool));
 				if (!target) throw new Error("This tool is not available to this App.");
@@ -818,7 +818,7 @@ function createMcpAppsService(tools, getHost, lifetime) {
 					...result.isError === void 0 ? {} : { isError: result.isError }
 				}, MAX_RESULT_BYTES, "Tool result");
 			})),
-			(0, _agimon_ai_po_core_serverFacet.defineServerMethod)(mcpAppSetStateMethod, ({ leaseId, state }, caller) => operation(leaseId, caller, false, async (lease) => {
+			(0, _agimon_ai_po_core_serverPlugin.defineServerMethod)(mcpAppSetStateMethod, ({ leaseId, state }, caller) => operation(leaseId, caller, false, async (lease) => {
 				const saved = boundedJson(state, MAX_STATE_BYTES, "App state");
 				await lease.host.context.session.appendCustomEntry(STATE_ENTRY, {
 					version: 1,
@@ -831,7 +831,7 @@ function createMcpAppsService(tools, getHost, lifetime) {
 				check(lease);
 				return {};
 			})),
-			(0, _agimon_ai_po_core_serverFacet.defineServerMethod)(mcpAppFollowUpMethod, ({ leaseId, prompt }, caller) => operation(leaseId, caller, true, async (lease) => {
+			(0, _agimon_ai_po_core_serverPlugin.defineServerMethod)(mcpAppFollowUpMethod, ({ leaseId, prompt }, caller) => operation(leaseId, caller, true, async (lease) => {
 				const session = lease.host.context.session;
 				if (!session.admitPrompt) throw new Error("App follow-up messages are unavailable in this session.");
 				await confirm(lease, `Send a follow-up from ${lease.server}?`, prompt);
@@ -839,7 +839,7 @@ function createMcpAppsService(tools, getHost, lifetime) {
 				check(lease);
 				return {};
 			})),
-			(0, _agimon_ai_po_core_serverFacet.defineServerMethod)(mcpAppCloseMethod, ({ leaseId }, caller) => {
+			(0, _agimon_ai_po_core_serverPlugin.defineServerMethod)(mcpAppCloseMethod, ({ leaseId }, caller) => {
 				const lease = leases.get(leaseId);
 				if (lease && lease.connectionId !== caller.connectionId) throw new Error("App lease is not owned by this connection.");
 				if (lease) revoke(lease);
@@ -2796,7 +2796,7 @@ var po_use_mcp_server_default = (0, _agimon_ai_po_core_extensionFile.defineResou
 	description: "Inspect domain-scoped MCP servers, authenticate, reload configuration, and troubleshoot tool availability.",
 	when: _agimon_ai_po_core_help.PO_HELP_WHEN,
 	kind: "skill",
-	read: () => (0, _agimon_ai_po_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-mcp/SKILL.md")
+	read: () => (0, _agimon_ai_po_core_serverPlugin.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-mcp/SKILL.md")
 });
 //#endregion
 //#region generated/server.ts
@@ -2809,9 +2809,10 @@ const via = (identity, value) => value === void 0 ? void 0 : {
 	...identity,
 	...value
 };
-const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
+const serverPlugin = (0, _agimon_ai_po_core_serverPlugin.defineServerPlugin)({
 	name: "@agimon-ai/po-mcp",
-	providerOverrides: (0, _agimon_ai_po_core_serverFacet.composeServerProviderOverrides)(root_server_default),
+	providerOverrides: (0, _agimon_ai_po_core_serverPlugin.composeServerProviderOverrides)(root_server_default),
+	injects: (0, _agimon_ai_po_core_extensionFile.composeRootInjects)({ session: [root_server_default] }),
 	global: (context) => ({ get api() {
 		return [at(route_server_default$1, context)];
 	} }),
@@ -2819,7 +2820,7 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 		return [at(route_server_default$1, context)];
 	} }),
 	session: async (context) => {
-		const scopeSession = await root_server_default(context);
+		const scopeSession = await context.scopeRoot("session", root_server_default, context);
 		const contextSession = {
 			...context,
 			root: scopeSession.value
@@ -2846,7 +2847,7 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 	}
 });
 //#endregion
-exports.default = facet;
-exports.facet = facet;
+exports.default = serverPlugin;
+exports.serverPlugin = serverPlugin;
 
 //# sourceMappingURL=server.cjs.map