@agentproto/mcp-server 0.2.0 → 0.2.2

package/LICENSE

@@ -1 +1,202 @@
-MIT License — Copyright (c) 2026 agentproto contributors
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.mjs

@@ -146,10 +146,8 @@ function contentText(payload) {
 }
 function buildMcpTool(opts) {
   const { tool, candidates } = opts;
-  const objectShape = asObjectShape(tool.inputSchema);
-  const inputShape = objectShape ?? {
-    input: tool.inputSchema
-  };
+  const objectShape = tool.inputSchema != null ? asObjectShape(tool.inputSchema) : void 0;
+  const inputShape = objectShape ?? (tool.inputSchema != null ? { input: tool.inputSchema } : {});
   const resolveContext = async () => typeof opts.context === "function" ? await opts.context() : opts.context;
   return {
     name: opts.name ? mcpName(opts.name) : mcpName(tool.id),

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/self-inspect-tool.ts","../src/to-mcp-tool.ts","../src/index.ts"],"names":["join","z","contentText"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * self_inspect — MCP tool that lets an agent query its own AIP-42 manifest\n * without knowing its disk path.\n *\n * The agent supplies its logical `id`; the runtime resolves\n * `<workspace>/.agents/<id>/AGENT.md`, loads it via `agentVerbs`, resolves\n * each tool and routine ref to a `{ id, description }` summary, and returns\n * `{ agentPath, tools, routines }`.\n *\n * Injection mechanism: the workspace path is captured in the\n * `registerSelfInspectTool` closure at server-creation time (same pattern as\n * `registerFsTools`). The agent provides its logical id (known from its own\n * system-prompt frontmatter) — not an absolute path.\n */\n\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { z } from \"zod\"\nimport { join } from \"node:path\"\nimport { agentVerbs } from \"@agentproto/agent\"\nimport { toolVerbs } from \"@agentproto/tool\"\nimport { routineVerbs } from \"@agentproto/routine\"\n\nexport interface RefSummary {\n  id: string\n  description: string\n}\n\nexport interface SelfInspectResult {\n  agentPath: string\n  tools: RefSummary[]\n  routines: RefSummary[]\n}\n\n/**\n * Reduce one AIP-27 ref block (from an agent's `tools[]`) to `{id, description}`.\n *\n * - `file:` → load the TOOL.md and extract `id` + `description` from the handle.\n *   `baseDir` is the workspace root (tools live at `<workspace>/tools/<id>/TOOL.md`\n *   by the AIP-14 `pathOf` convention, or wherever the file pointer says).\n * - `inline:` → use the inline params directly.\n * - `ref:` or `string` → surface the ref identifier as the id (registry resolution\n *   requires an external resolver not available here at inspect time).\n */\nexport async function summarizeToolRef(\n  raw: unknown,\n  workspace: string,\n): Promise<RefSummary> {\n  if (typeof raw === \"string\") {\n    return { id: raw, description: \"(string ref — not locally resolved)\" }\n  }\n  if (typeof raw !== \"object\" || raw === null) {\n    return { id: String(raw), description: \"(unknown ref shape)\" }\n  }\n  const block = raw as { ref?: string; file?: string; inline?: Record<string, unknown> }\n  if (block.file) {\n    try {\n      const handle = await toolVerbs.resolve(\n        { file: block.file },\n        { baseDir: workspace },\n      )\n      return { id: handle.id, description: handle.description ?? \"\" }\n    } catch {\n      return { id: block.file, description: \"(file ref — could not load)\" }\n    }\n  }\n  if (block.inline) {\n    return {\n      id: String(block.inline.id ?? \"\"),\n      description: String(block.inline.description ?? \"\"),\n    }\n  }\n  if (block.ref) {\n    return { id: block.ref, description: \"(ref — not locally resolved)\" }\n  }\n  return { id: JSON.stringify(raw), description: \"(unknown ref shape)\" }\n}\n\n/**\n * Same logic for AIP-41 routine refs. Routines live at\n * `<workspace>/.routines/<id>/ROUTINE.md` by `routineSpec.pathOf` convention.\n */\nexport async function summarizeRoutineRef(\n  raw: unknown,\n  workspace: string,\n): Promise<RefSummary> {\n  if (typeof raw === \"string\") {\n    return { id: raw, description: \"(string ref — not locally resolved)\" }\n  }\n  if (typeof raw !== \"object\" || raw === null) {\n    return { id: String(raw), description: \"(unknown ref shape)\" }\n  }\n  const block = raw as { ref?: string; file?: string; inline?: Record<string, unknown> }\n  if (block.file) {\n    try {\n      const handle = await routineVerbs.resolve(\n        { file: block.file },\n        { baseDir: workspace },\n      )\n      return { id: handle.id, description: handle.description ?? \"\" }\n    } catch {\n      return { id: block.file, description: \"(file ref — could not load)\" }\n    }\n  }\n  if (block.inline) {\n    return {\n      id: String(block.inline.id ?? \"\"),\n      description: String(block.inline.description ?? \"\"),\n    }\n  }\n  if (block.ref) {\n    return { id: block.ref, description: \"(ref — not locally resolved)\" }\n  }\n  return { id: JSON.stringify(raw), description: \"(unknown ref shape)\" }\n}\n\n/**\n * Core logic, extracted for testability.\n * Throws with `{ error, message }` on `agent_not_found`.\n */\nexport async function selfInspect(\n  agentId: string,\n  workspace: string,\n): Promise<SelfInspectResult> {\n  const agentPath = join(workspace, \".agents\", agentId, \"AGENT.md\")\n\n  let handle: Awaited<ReturnType<typeof agentVerbs.load>>[\"handle\"]\n  try {\n    const result = await agentVerbs.load(agentPath)\n    handle = result.handle\n  } catch (err) {\n    const e = new Error(\n      `No AGENT.md found for agent '${agentId}' at '${agentPath}'. ` +\n        `Ensure an AGENT.md exists at <workspace>/.agents/${agentId}/AGENT.md.`,\n    )\n    ;(e as NodeJS.ErrnoException).code = \"agent_not_found\"\n    throw e\n  }\n\n  const rawTools = (handle.tools ?? []) as unknown[]\n  const rawRoutines = (handle.routines ?? []) as unknown[]\n\n  const [tools, routines] = await Promise.all([\n    Promise.all(rawTools.map((r) => summarizeToolRef(r, workspace))),\n    Promise.all(rawRoutines.map((r) => summarizeRoutineRef(r, workspace))),\n  ])\n\n  return { agentPath, tools, routines }\n}\n\n/**\n * Register the `self_inspect` MCP tool on `server`.\n *\n * The workspace path is injected at registration time; the agent only needs to\n * supply its logical `id` at call time — not a disk path. This is called from\n * `createMcpServer` whenever a workspace is provided.\n */\nexport function registerSelfInspectTool(\n  server: McpServer,\n  opts: { workspace: string },\n): void {\n  server.tool(\n    \"self_inspect\",\n    \"Return this agent's AIP-42 manifest summary (tools + routines) without requiring knowledge of disk paths. \" +\n      \"Pass the agent's logical `id` (the `id:` field in its AGENT.md frontmatter); the runtime resolves it to \" +\n      \"`<workspace>/.agents/<agentId>/AGENT.md`. Returns `{ agentPath, tools, routines }` — each item has at \" +\n      \"minimum `{ id, description }`. File refs are loaded; string/ref refs are surfaced as-is.\",\n    {\n      agentId: z\n        .string()\n        .min(1)\n        .describe(\n          \"The agent's logical id (e.g. 'writer'). Matches the `id:` field in the AGENT.md frontmatter. \" +\n            \"The runtime resolves this to `<workspace>/.agents/<agentId>/AGENT.md` — \" +\n            \"you do not need to know the absolute disk path.\",\n        ),\n    },\n    async ({ agentId }) => {\n      try {\n        const result = await selfInspect(agentId, opts.workspace)\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: JSON.stringify(result, null, 2),\n            },\n          ],\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err)\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: JSON.stringify({ error: \"agent_not_found\", message }, null, 2),\n            },\n          ],\n          isError: true,\n        }\n      }\n    },\n  )\n}\n","/**\n * toMcpTool — expose an AIP-14 TOOL contract as a callable MCP tool whose body\n * is `runTool` (resolve DRIVER → validate → execute → validate). The mirror of\n * the Mastra `resolveTool` adapter: one TOOL handle, one resolver, three call\n * surfaces (CLI, agent, MCP) with no per-surface re-coding.\n *\n * Framework-only: it takes a handle + candidate DRIVERs and never knows what\n * the tool does. The injected per-call `context` (live capabilities such as a\n * warm browser session) is baked in at registration by the composition root —\n * an MCP client supplies only the tool's declared input, never context.\n */\n\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport type { ZodRawShape, ZodType } from \"zod\"\nimport { runTool, type DriverHandle, type ResolverContext } from \"@agentproto/driver\"\nimport type { ToolContext, ToolHandle } from \"@agentproto/tool\"\n\nexport interface ToMcpToolOptions<\n  TInput,\n  TOutput,\n  TContext extends ToolContext,\n> {\n  /** The AIP-14 contract to expose. */\n  tool: ToolHandle<TInput, TOutput, TContext>\n  /** Candidate DRIVERs the resolver dispatches over. */\n  candidates: readonly DriverHandle[]\n  /**\n   * Per-call injected context (live capabilities). A value, or a factory run\n   * once per invocation (e.g. to lease a fresh session). Omit for context-free\n   * tools (`report.render`).\n   */\n  context?:\n    | TContext\n    | (() => TContext | Promise<TContext>)\n  /** Resolver routing hints (region, pinned provider, policy tags). */\n  resolverContext?: ResolverContext\n  /** Resolved secrets to inject into the DriverContext. */\n  secrets?: Record<string, string>\n  /** Override the advertised MCP tool name (default: tool id, `:`/`.`→`_`). */\n  name?: string\n}\n\n/** What `buildMcpTool` produces — registerable on any McpServer, and directly\n *  callable in tests without standing up a transport. */\nexport interface McpToolRegistration {\n  name: string\n  description: string\n  inputShape: ZodRawShape\n  handler: (args: Record<string, unknown>) => Promise<{\n    content: Array<{ type: \"text\"; text: string }>\n  }>\n}\n\n/** A ZodObject exposes a `.shape` raw-shape getter; everything else doesn't. */\nfunction asObjectShape(schema: ZodType): ZodRawShape | undefined {\n  const shape = (schema as { shape?: unknown }).shape\n  return shape && typeof shape === \"object\"\n    ? (shape as ZodRawShape)\n    : undefined\n}\n\nfunction mcpName(id: string): string {\n  return id.replace(/[-:.]/g, \"_\")\n}\n\nfunction contentText(payload: unknown): {\n  content: Array<{ type: \"text\"; text: string }>\n} {\n  return {\n    content: [{ type: \"text\", text: JSON.stringify(payload, null, 2) }],\n  }\n}\n\n/**\n * Build (but do not register) the MCP tool. When the contract's `inputSchema`\n * is an object schema, its fields become the MCP tool's parameters directly;\n * otherwise the input is taken under a single `input` parameter carrying the\n * whole schema.\n */\nexport function buildMcpTool<TInput, TOutput, TContext extends ToolContext>(\n  opts: ToMcpToolOptions<TInput, TOutput, TContext>,\n): McpToolRegistration {\n  const { tool, candidates } = opts\n  const objectShape = asObjectShape(tool.inputSchema)\n  const inputShape: ZodRawShape = objectShape ?? {\n    input: tool.inputSchema,\n  }\n\n  const resolveContext = async (): Promise<unknown> =>\n    typeof opts.context === \"function\"\n      ? await (opts.context as () => TContext | Promise<TContext>)()\n      : opts.context\n\n  return {\n    name: opts.name ? mcpName(opts.name) : mcpName(tool.id),\n    description: tool.description,\n    inputShape,\n    handler: async (args) => {\n      const input = objectShape ? args : (args.input as unknown)\n      const context = await resolveContext()\n      const output = await runTool({\n        tool,\n        candidates,\n        input,\n        context,\n        resolverContext: opts.resolverContext,\n        secrets: opts.secrets,\n      })\n      return contentText(output)\n    },\n  }\n}\n\n/**\n * Register a TOOL contract as a callable MCP tool on `server`, dispatching each\n * call through `runTool`. Returns the registration (handy for diagnostics /\n * tests). Once registered, the tool is callable from any MCP host with no\n * per-host code.\n */\nexport function toMcpTool<TInput, TOutput, TContext extends ToolContext>(\n  server: McpServer,\n  opts: ToMcpToolOptions<TInput, TOutput, TContext>,\n): McpToolRegistration {\n  const reg = buildMcpTool(opts)\n  server.tool(reg.name, reg.description, reg.inputShape, reg.handler)\n  return reg\n}\n","/**\n * @agentproto/mcp-server — exposes AIP doctype verbs as MCP tools.\n *\n * Hand a list of `DoctypeSpec` instances (one per registered AIP) and\n * optionally a workspace dir; the server registers\n * `create_<name> / load_<name> / list_<name> / update_<name> /\n * resolve_<name> / delete_<name>` for each spec, including AIP-40\n * extensions auto-loaded from `<workspace>/extensions/<slug>/EXTENSION.md`.\n *\n * Two ways to run it:\n *   1. **Embedded** — call `createMcpServer({ specs, workspace })` and\n *      attach to your own transport (stdio, websocket, …).\n *   2. **Standalone** — `runStdioServer({ specs, workspace })` wires\n *      stdio for you. Useful as a `mcp_servers.<id>` config entry on\n *      Claude Desktop / Cursor / any MCP host.\n */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\"\nimport { z } from \"zod\"\nimport { existsSync } from \"node:fs\"\nimport { readFile } from \"node:fs/promises\"\nimport { isAbsolute, join, resolve } from \"node:path\"\nimport { createVerbs, type DoctypeSpec } from \"@agentproto/manifest\"\nimport {\n  parseExtensionManifest,\n  specFromExtension,\n} from \"@agentproto/extension\"\nimport { registerSelfInspectTool } from \"./self-inspect-tool.js\"\n\n// `RegisterableSpec<TParams, THandle>` is just `DoctypeSpec` plus the\n// constraint that callers passing different generics across the array\n// must type-erase via `as unknown as DoctypeSpec<...>` at the boundary.\n// We don't try to express the heterogeneous list in TS — same trick\n// `@agentproto/driver`'s `implementations[]` uses.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnySpec = DoctypeSpec<any, any>\n\nexport interface CreateMcpServerOptions {\n  /** Doctype specs registered as MCP tools. One per AIP. */\n  specs: readonly AnySpec[]\n  /**\n   * Optional workspace dir. If provided, the server scans\n   * `<workspace>/extensions/` for `EXTENSION.md` files and registers\n   * each as a local doctype. The parent of each extension is resolved\n   * by matching the extension's `extends:` field (`aip-N`) against\n   * `specs.find(s => s.aip === N)` — so the spec list MUST include the\n   * parents the extensions reference, else loading throws.\n   */\n  workspace?: string\n  /** Server name advertised over MCP. Default `agentproto-mcp-server`. */\n  name?: string\n  /** Server version advertised over MCP. Default `0.1.0-alpha`. */\n  version?: string\n}\n\nexport interface CreateMcpServerResult {\n  /** The wired McpServer; attach a transport to start serving. */\n  server: McpServer\n  /**\n   * The list of doctype names the server registered tools for —\n   * useful for tests + diagnostics. Includes any extensions loaded\n   * from `workspace/extensions/`.\n   */\n  registered: readonly string[]\n}\n\nexport async function createMcpServer(\n  opts: CreateMcpServerOptions,\n): Promise<CreateMcpServerResult> {\n  const server = new McpServer({\n    name: opts.name ?? \"agentproto-mcp-server\",\n    version: opts.version ?? \"0.1.0-alpha\",\n  })\n\n  const allSpecs: AnySpec[] = [...opts.specs]\n\n  // Load extensions when a workspace is given.\n  if (opts.workspace) {\n    const extensions = await loadExtensions(opts.workspace, opts.specs)\n    allSpecs.push(...extensions)\n  }\n\n  // Path-anchoring: when a workspace is set, resolve all relative\n  // dir/path arguments against it. Agents pass logical paths like\n  // \"tools\" or \"tools/echo/TOOL.md\"; the server pins them to the\n  // workspace so they don't leak into process.cwd() (which is\n  // wherever the host happened to spawn the server).\n  const anchor = (p: string): string =>\n    isAbsolute(p) || !opts.workspace ? p : join(opts.workspace, p)\n\n  for (const spec of allSpecs) {\n    registerVerbs(server, spec, anchor)\n  }\n\n  // self_inspect: contextual tool injected when a workspace is provided so\n  // agents can query their own AIP-42 manifest by logical id — no disk path\n  // knowledge required.\n  if (opts.workspace) {\n    registerSelfInspectTool(server, { workspace: opts.workspace })\n  }\n\n  return {\n    server,\n    registered: allSpecs.map((s) => s.name),\n  }\n}\n\n/**\n * Wire `createMcpServer` to stdio for use as an `mcp_servers.<id>`\n * entry on Claude Desktop / Cursor / etc. Resolves once the\n * transport closes.\n */\nexport async function runStdioServer(\n  opts: CreateMcpServerOptions,\n): Promise<void> {\n  const { server } = await createMcpServer(opts)\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nexport {\n  toMcpTool,\n  buildMcpTool,\n  type ToMcpToolOptions,\n  type McpToolRegistration,\n} from \"./to-mcp-tool.js\"\nexport {\n  registerSelfInspectTool,\n  selfInspect,\n  summarizeToolRef,\n  summarizeRoutineRef,\n  type RefSummary,\n  type SelfInspectResult,\n} from \"./self-inspect-tool.js\"\n\n// ── verb registration ───────────────────────────────────────────────\n\nfunction registerVerbs(\n  server: McpServer,\n  spec: AnySpec,\n  anchor: (p: string) => string,\n): void {\n  const verbs = createVerbs(spec)\n  // Tool name uses snake_case to match MCP convention; spec.name may\n  // be kebab (driver-cli) or namespaced (acme:deal). Map all to snake.\n  const verbName = (verb: string) =>\n    `${verb}_${spec.name.replace(/[-:]/g, \"_\")}`\n  const description = (verb: string, body: string) =>\n    `${verb} the AIP-${spec.aip} ${spec.name} doctype. ${body}`\n\n  // create\n  server.tool(\n    verbName(\"create\"),\n    description(\n      \"create\",\n      \"Author a new manifest from params. Returns { path, rendered }.\",\n    ),\n    {\n      params: z\n        .record(z.string(), z.unknown())\n        .describe(`The ${spec.name} definition fields.`),\n      dir: z.string().describe(\"Workspace-relative or absolute target directory.\"),\n      body: z\n        .string()\n        .optional()\n        .describe(\"Markdown body after the frontmatter. Defaults to a stub.\"),\n      dryRun: z\n        .boolean()\n        .optional()\n        .describe(\"Render only — don't write to disk.\"),\n    },\n    async ({ params, dir, body, dryRun }) => {\n      const result = await verbs.create(params, {\n        dir: anchor(dir),\n        body,\n        dryRun,\n      })\n      return contentText({\n        path: result.path,\n        rendered: result.rendered,\n      })\n    },\n  )\n\n  // load\n  server.tool(\n    verbName(\"load\"),\n    description(\"load\", \"Read a manifest from disk. Returns the parsed handle.\"),\n    {\n      path: z.string().describe(\"Absolute or workspace-relative path to the .md file.\"),\n    },\n    async ({ path }) => {\n      const result = await verbs.load(anchor(path))\n      return contentText({ path: result.path, handle: result.handle })\n    },\n  )\n\n  // list\n  server.tool(\n    verbName(\"list\"),\n    description(\n      \"list\",\n      \"Walk a directory tree and return all manifests of this doctype.\",\n    ),\n    {\n      dir: z.string().describe(\"Directory to walk.\"),\n      skipDirs: z\n        .array(z.string())\n        .optional()\n        .describe(\"Subdir names to skip (default: node_modules, .git, dist).\"),\n    },\n    async ({ dir, skipDirs }) => {\n      const handles = await verbs.list(anchor(dir), { skipDirs })\n      return contentText({ count: handles.length, handles })\n    },\n  )\n\n  // update\n  server.tool(\n    verbName(\"update\"),\n    description(\n      \"update\",\n      \"Patch an existing manifest. The patch is shallow-merged into the existing params.\",\n    ),\n    {\n      path: z.string().describe(\"Path to the manifest to update.\"),\n      patch: z\n        .record(z.string(), z.unknown())\n        .describe(\"Partial fields to merge into the existing manifest.\"),\n      body: z.string().optional().describe(\"New body markdown (default: keep existing).\"),\n    },\n    async ({ path, patch, body }) => {\n      const result = await verbs.update(\n        anchor(path),\n        (existing: Record<string, unknown>) => ({ ...existing, ...patch }),\n        { body },\n      )\n      return contentText({ path: result.path, rendered: result.rendered })\n    },\n  )\n\n  // resolve\n  server.tool(\n    verbName(\"resolve\"),\n    description(\n      \"resolve\",\n      \"Resolve an inline | ref | file block to a fully-typed handle.\",\n    ),\n    {\n      block: z\n        .union([\n          z.object({ inline: z.record(z.string(), z.unknown()) }),\n          z.object({ ref: z.string() }),\n          z.object({ file: z.string() }),\n        ])\n        .describe(\n          'The composition block. Exactly one of: { \"inline\": {...params} } | { \"ref\": \"@scope/id\" } | { \"file\": \"relative/path.md\" }. Omitting the wrapping key causes invalid_union.',\n        ),\n      baseDir: z\n        .string()\n        .optional()\n        .describe(\"Base dir for `file:` references.\"),\n    },\n    async ({ block, baseDir }) => {\n      const handle = await verbs.resolve(block, {\n        baseDir: baseDir ? anchor(baseDir) : undefined,\n      })\n      return contentText({ handle })\n    },\n  )\n\n  // delete\n  server.tool(\n    verbName(\"delete\"),\n    description(\"delete\", \"Remove a manifest file from disk.\"),\n    {\n      path: z.string().describe(\"Path to the manifest to delete.\"),\n    },\n    async ({ path }) => {\n      const target = anchor(path)\n      await verbs.delete(target)\n      return contentText({ deleted: target })\n    },\n  )\n}\n\n// ── extension loader ────────────────────────────────────────────────\n\nasync function loadExtensions(\n  workspace: string,\n  specs: readonly AnySpec[],\n): Promise<AnySpec[]> {\n  const extDir = resolve(workspace, \"extensions\")\n  if (!existsSync(extDir)) return []\n\n  const out: AnySpec[] = []\n  const { readdir } = await import(\"node:fs/promises\")\n  type SimpleDirent = { name: string; isDirectory(): boolean }\n\n  let entries: SimpleDirent[]\n  try {\n    entries = (await readdir(extDir, {\n      withFileTypes: true,\n    })) as unknown as SimpleDirent[]\n  } catch {\n    return out\n  }\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue\n    const manifestPath = join(extDir, String(entry.name), \"EXTENSION.md\")\n    if (!existsSync(manifestPath)) continue\n\n    const source = await readFile(manifestPath, \"utf8\")\n    const parsed = parseExtensionManifest(source)\n    const ext = parsed.frontmatter\n\n    let parent: AnySpec | undefined\n    if (ext.extends && ext.extends !== \"none\") {\n      const aipMatch = ext.extends.match(/^aip-(\\d+)$/)\n      if (!aipMatch) {\n        throw new Error(\n          `mcp-server: extension '${ext.slug}' has invalid extends '${ext.extends}'`,\n        )\n      }\n      const parentAip = Number(aipMatch[1])\n      parent = specs.find((s) => s.aip === parentAip)\n      if (!parent) {\n        throw new Error(\n          `mcp-server: extension '${ext.slug}' extends aip-${parentAip}, but no spec for that AIP was registered. Pass the parent spec in opts.specs.`,\n        )\n      }\n    }\n\n    out.push(specFromExtension(ext, { parent }) as AnySpec)\n  }\n\n  return out\n}\n\n// ── tool result helpers ─────────────────────────────────────────────\n\nfunction contentText(payload: unknown): {\n  content: Array<{ type: \"text\"; text: string }>\n} {\n  return {\n    content: [\n      {\n        type: \"text\",\n        text: JSON.stringify(payload, null, 2),\n      },\n    ],\n  }\n}\n"]}
+{"version":3,"sources":["../src/self-inspect-tool.ts","../src/to-mcp-tool.ts","../src/index.ts"],"names":["join","z","contentText"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * self_inspect — MCP tool that lets an agent query its own AIP-42 manifest\n * without knowing its disk path.\n *\n * The agent supplies its logical `id`; the runtime resolves\n * `<workspace>/.agents/<id>/AGENT.md`, loads it via `agentVerbs`, resolves\n * each tool and routine ref to a `{ id, description }` summary, and returns\n * `{ agentPath, tools, routines }`.\n *\n * Injection mechanism: the workspace path is captured in the\n * `registerSelfInspectTool` closure at server-creation time (same pattern as\n * `registerFsTools`). The agent provides its logical id (known from its own\n * system-prompt frontmatter) — not an absolute path.\n */\n\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { z } from \"zod\"\nimport { join } from \"node:path\"\nimport { agentVerbs } from \"@agentproto/agent\"\nimport { toolVerbs } from \"@agentproto/tool\"\nimport { routineVerbs } from \"@agentproto/routine\"\n\nexport interface RefSummary {\n  id: string\n  description: string\n}\n\nexport interface SelfInspectResult {\n  agentPath: string\n  tools: RefSummary[]\n  routines: RefSummary[]\n}\n\n/**\n * Reduce one AIP-27 ref block (from an agent's `tools[]`) to `{id, description}`.\n *\n * - `file:` → load the TOOL.md and extract `id` + `description` from the handle.\n *   `baseDir` is the workspace root (tools live at `<workspace>/tools/<id>/TOOL.md`\n *   by the AIP-14 `pathOf` convention, or wherever the file pointer says).\n * - `inline:` → use the inline params directly.\n * - `ref:` or `string` → surface the ref identifier as the id (registry resolution\n *   requires an external resolver not available here at inspect time).\n */\nexport async function summarizeToolRef(\n  raw: unknown,\n  workspace: string,\n): Promise<RefSummary> {\n  if (typeof raw === \"string\") {\n    return { id: raw, description: \"(string ref — not locally resolved)\" }\n  }\n  if (typeof raw !== \"object\" || raw === null) {\n    return { id: String(raw), description: \"(unknown ref shape)\" }\n  }\n  const block = raw as { ref?: string; file?: string; inline?: Record<string, unknown> }\n  if (block.file) {\n    try {\n      const handle = await toolVerbs.resolve(\n        { file: block.file },\n        { baseDir: workspace },\n      )\n      return { id: handle.id, description: handle.description ?? \"\" }\n    } catch {\n      return { id: block.file, description: \"(file ref — could not load)\" }\n    }\n  }\n  if (block.inline) {\n    return {\n      id: String(block.inline.id ?? \"\"),\n      description: String(block.inline.description ?? \"\"),\n    }\n  }\n  if (block.ref) {\n    return { id: block.ref, description: \"(ref — not locally resolved)\" }\n  }\n  return { id: JSON.stringify(raw), description: \"(unknown ref shape)\" }\n}\n\n/**\n * Same logic for AIP-41 routine refs. Routines live at\n * `<workspace>/.routines/<id>/ROUTINE.md` by `routineSpec.pathOf` convention.\n */\nexport async function summarizeRoutineRef(\n  raw: unknown,\n  workspace: string,\n): Promise<RefSummary> {\n  if (typeof raw === \"string\") {\n    return { id: raw, description: \"(string ref — not locally resolved)\" }\n  }\n  if (typeof raw !== \"object\" || raw === null) {\n    return { id: String(raw), description: \"(unknown ref shape)\" }\n  }\n  const block = raw as { ref?: string; file?: string; inline?: Record<string, unknown> }\n  if (block.file) {\n    try {\n      const handle = await routineVerbs.resolve(\n        { file: block.file },\n        { baseDir: workspace },\n      )\n      return { id: handle.id, description: handle.description ?? \"\" }\n    } catch {\n      return { id: block.file, description: \"(file ref — could not load)\" }\n    }\n  }\n  if (block.inline) {\n    return {\n      id: String(block.inline.id ?? \"\"),\n      description: String(block.inline.description ?? \"\"),\n    }\n  }\n  if (block.ref) {\n    return { id: block.ref, description: \"(ref — not locally resolved)\" }\n  }\n  return { id: JSON.stringify(raw), description: \"(unknown ref shape)\" }\n}\n\n/**\n * Core logic, extracted for testability.\n * Throws with `{ error, message }` on `agent_not_found`.\n */\nexport async function selfInspect(\n  agentId: string,\n  workspace: string,\n): Promise<SelfInspectResult> {\n  const agentPath = join(workspace, \".agents\", agentId, \"AGENT.md\")\n\n  let handle: Awaited<ReturnType<typeof agentVerbs.load>>[\"handle\"]\n  try {\n    const result = await agentVerbs.load(agentPath)\n    handle = result.handle\n  } catch (err) {\n    const e = new Error(\n      `No AGENT.md found for agent '${agentId}' at '${agentPath}'. ` +\n        `Ensure an AGENT.md exists at <workspace>/.agents/${agentId}/AGENT.md.`,\n    )\n    ;(e as NodeJS.ErrnoException).code = \"agent_not_found\"\n    throw e\n  }\n\n  const rawTools = (handle.tools ?? []) as unknown[]\n  const rawRoutines = (handle.routines ?? []) as unknown[]\n\n  const [tools, routines] = await Promise.all([\n    Promise.all(rawTools.map((r) => summarizeToolRef(r, workspace))),\n    Promise.all(rawRoutines.map((r) => summarizeRoutineRef(r, workspace))),\n  ])\n\n  return { agentPath, tools, routines }\n}\n\n/**\n * Register the `self_inspect` MCP tool on `server`.\n *\n * The workspace path is injected at registration time; the agent only needs to\n * supply its logical `id` at call time — not a disk path. This is called from\n * `createMcpServer` whenever a workspace is provided.\n */\nexport function registerSelfInspectTool(\n  server: McpServer,\n  opts: { workspace: string },\n): void {\n  server.tool(\n    \"self_inspect\",\n    \"Return this agent's AIP-42 manifest summary (tools + routines) without requiring knowledge of disk paths. \" +\n      \"Pass the agent's logical `id` (the `id:` field in its AGENT.md frontmatter); the runtime resolves it to \" +\n      \"`<workspace>/.agents/<agentId>/AGENT.md`. Returns `{ agentPath, tools, routines }` — each item has at \" +\n      \"minimum `{ id, description }`. File refs are loaded; string/ref refs are surfaced as-is.\",\n    {\n      agentId: z\n        .string()\n        .min(1)\n        .describe(\n          \"The agent's logical id (e.g. 'writer'). Matches the `id:` field in the AGENT.md frontmatter. \" +\n            \"The runtime resolves this to `<workspace>/.agents/<agentId>/AGENT.md` — \" +\n            \"you do not need to know the absolute disk path.\",\n        ),\n    },\n    async ({ agentId }) => {\n      try {\n        const result = await selfInspect(agentId, opts.workspace)\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: JSON.stringify(result, null, 2),\n            },\n          ],\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err)\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: JSON.stringify({ error: \"agent_not_found\", message }, null, 2),\n            },\n          ],\n          isError: true,\n        }\n      }\n    },\n  )\n}\n","/**\n * toMcpTool — expose an AIP-14 TOOL contract as a callable MCP tool whose body\n * is `runTool` (resolve DRIVER → validate → execute → validate). The mirror of\n * the Mastra `resolveTool` adapter: one TOOL handle, one resolver, three call\n * surfaces (CLI, agent, MCP) with no per-surface re-coding.\n *\n * Framework-only: it takes a handle + candidate DRIVERs and never knows what\n * the tool does. The injected per-call `context` (live capabilities such as a\n * warm browser session) is baked in at registration by the composition root —\n * an MCP client supplies only the tool's declared input, never context.\n */\n\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport type { ZodRawShape, ZodType } from \"zod\"\nimport { runTool, type DriverHandle, type ResolverContext } from \"@agentproto/driver\"\nimport type { ToolContext, ToolHandle } from \"@agentproto/tool\"\n\nexport interface ToMcpToolOptions<\n  TInput,\n  TOutput,\n  TContext extends ToolContext,\n> {\n  /** The AIP-14 contract to expose. */\n  tool: ToolHandle<TInput, TOutput, TContext>\n  /** Candidate DRIVERs the resolver dispatches over. */\n  candidates: readonly DriverHandle[]\n  /**\n   * Per-call injected context (live capabilities). A value, or a factory run\n   * once per invocation (e.g. to lease a fresh session). Omit for context-free\n   * tools (`report.render`).\n   */\n  context?:\n    | TContext\n    | (() => TContext | Promise<TContext>)\n  /** Resolver routing hints (region, pinned provider, policy tags). */\n  resolverContext?: ResolverContext\n  /** Resolved secrets to inject into the DriverContext. */\n  secrets?: Record<string, string>\n  /** Override the advertised MCP tool name (default: tool id, `:`/`.`→`_`). */\n  name?: string\n}\n\n/** What `buildMcpTool` produces — registerable on any McpServer, and directly\n *  callable in tests without standing up a transport. */\nexport interface McpToolRegistration {\n  name: string\n  description: string\n  inputShape: ZodRawShape\n  handler: (args: Record<string, unknown>) => Promise<{\n    content: Array<{ type: \"text\"; text: string }>\n  }>\n}\n\n/** A ZodObject exposes a `.shape` raw-shape getter; everything else doesn't. */\nfunction asObjectShape(schema: ZodType): ZodRawShape | undefined {\n  const shape = (schema as { shape?: unknown }).shape\n  return shape && typeof shape === \"object\"\n    ? (shape as ZodRawShape)\n    : undefined\n}\n\nfunction mcpName(id: string): string {\n  return id.replace(/[-:.]/g, \"_\")\n}\n\nfunction contentText(payload: unknown): {\n  content: Array<{ type: \"text\"; text: string }>\n} {\n  return {\n    content: [{ type: \"text\", text: JSON.stringify(payload, null, 2) }],\n  }\n}\n\n/**\n * Build (but do not register) the MCP tool. When the contract's `inputSchema`\n * is an object schema, its fields become the MCP tool's parameters directly;\n * otherwise the input is taken under a single `input` parameter carrying the\n * whole schema.\n */\nexport function buildMcpTool<TInput, TOutput, TContext extends ToolContext>(\n  opts: ToMcpToolOptions<TInput, TOutput, TContext>,\n): McpToolRegistration {\n  const { tool, candidates } = opts\n  // `inputSchema` is optional (manifest-only tools declare IO via JSON Schema,\n  // not a zod schema). Guard against undefined: a zod object → its shape; a\n  // non-object zod schema → a single `input` field; no zod schema → no declared\n  // MCP params (`{}`).\n  const objectShape =\n    tool.inputSchema != null ? asObjectShape(tool.inputSchema) : undefined\n  const inputShape: ZodRawShape =\n    objectShape ?? (tool.inputSchema != null ? { input: tool.inputSchema } : {})\n\n  const resolveContext = async (): Promise<unknown> =>\n    typeof opts.context === \"function\"\n      ? await (opts.context as () => TContext | Promise<TContext>)()\n      : opts.context\n\n  return {\n    name: opts.name ? mcpName(opts.name) : mcpName(tool.id),\n    description: tool.description,\n    inputShape,\n    handler: async (args) => {\n      const input = objectShape ? args : (args.input as unknown)\n      const context = await resolveContext()\n      const output = await runTool({\n        tool,\n        candidates,\n        input,\n        context,\n        resolverContext: opts.resolverContext,\n        secrets: opts.secrets,\n      })\n      return contentText(output)\n    },\n  }\n}\n\n/**\n * Register a TOOL contract as a callable MCP tool on `server`, dispatching each\n * call through `runTool`. Returns the registration (handy for diagnostics /\n * tests). Once registered, the tool is callable from any MCP host with no\n * per-host code.\n */\nexport function toMcpTool<TInput, TOutput, TContext extends ToolContext>(\n  server: McpServer,\n  opts: ToMcpToolOptions<TInput, TOutput, TContext>,\n): McpToolRegistration {\n  const reg = buildMcpTool(opts)\n  server.tool(reg.name, reg.description, reg.inputShape, reg.handler)\n  return reg\n}\n","/**\n * @agentproto/mcp-server — exposes AIP doctype verbs as MCP tools.\n *\n * Hand a list of `DoctypeSpec` instances (one per registered AIP) and\n * optionally a workspace dir; the server registers\n * `create_<name> / load_<name> / list_<name> / update_<name> /\n * resolve_<name> / delete_<name>` for each spec, including AIP-40\n * extensions auto-loaded from `<workspace>/extensions/<slug>/EXTENSION.md`.\n *\n * Two ways to run it:\n *   1. **Embedded** — call `createMcpServer({ specs, workspace })` and\n *      attach to your own transport (stdio, websocket, …).\n *   2. **Standalone** — `runStdioServer({ specs, workspace })` wires\n *      stdio for you. Useful as a `mcp_servers.<id>` config entry on\n *      Claude Desktop / Cursor / any MCP host.\n */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\"\nimport { z } from \"zod\"\nimport { existsSync } from \"node:fs\"\nimport { readFile } from \"node:fs/promises\"\nimport { isAbsolute, join, resolve } from \"node:path\"\nimport { createVerbs, type DoctypeSpec } from \"@agentproto/manifest\"\nimport {\n  parseExtensionManifest,\n  specFromExtension,\n} from \"@agentproto/extension\"\nimport { registerSelfInspectTool } from \"./self-inspect-tool.js\"\n\n// `RegisterableSpec<TParams, THandle>` is just `DoctypeSpec` plus the\n// constraint that callers passing different generics across the array\n// must type-erase via `as unknown as DoctypeSpec<...>` at the boundary.\n// We don't try to express the heterogeneous list in TS — same trick\n// `@agentproto/driver`'s `implementations[]` uses.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnySpec = DoctypeSpec<any, any>\n\nexport interface CreateMcpServerOptions {\n  /** Doctype specs registered as MCP tools. One per AIP. */\n  specs: readonly AnySpec[]\n  /**\n   * Optional workspace dir. If provided, the server scans\n   * `<workspace>/extensions/` for `EXTENSION.md` files and registers\n   * each as a local doctype. The parent of each extension is resolved\n   * by matching the extension's `extends:` field (`aip-N`) against\n   * `specs.find(s => s.aip === N)` — so the spec list MUST include the\n   * parents the extensions reference, else loading throws.\n   */\n  workspace?: string\n  /** Server name advertised over MCP. Default `agentproto-mcp-server`. */\n  name?: string\n  /** Server version advertised over MCP. Default `0.1.0-alpha`. */\n  version?: string\n}\n\nexport interface CreateMcpServerResult {\n  /** The wired McpServer; attach a transport to start serving. */\n  server: McpServer\n  /**\n   * The list of doctype names the server registered tools for —\n   * useful for tests + diagnostics. Includes any extensions loaded\n   * from `workspace/extensions/`.\n   */\n  registered: readonly string[]\n}\n\nexport async function createMcpServer(\n  opts: CreateMcpServerOptions,\n): Promise<CreateMcpServerResult> {\n  const server = new McpServer({\n    name: opts.name ?? \"agentproto-mcp-server\",\n    version: opts.version ?? \"0.1.0-alpha\",\n  })\n\n  const allSpecs: AnySpec[] = [...opts.specs]\n\n  // Load extensions when a workspace is given.\n  if (opts.workspace) {\n    const extensions = await loadExtensions(opts.workspace, opts.specs)\n    allSpecs.push(...extensions)\n  }\n\n  // Path-anchoring: when a workspace is set, resolve all relative\n  // dir/path arguments against it. Agents pass logical paths like\n  // \"tools\" or \"tools/echo/TOOL.md\"; the server pins them to the\n  // workspace so they don't leak into process.cwd() (which is\n  // wherever the host happened to spawn the server).\n  const anchor = (p: string): string =>\n    isAbsolute(p) || !opts.workspace ? p : join(opts.workspace, p)\n\n  for (const spec of allSpecs) {\n    registerVerbs(server, spec, anchor)\n  }\n\n  // self_inspect: contextual tool injected when a workspace is provided so\n  // agents can query their own AIP-42 manifest by logical id — no disk path\n  // knowledge required.\n  if (opts.workspace) {\n    registerSelfInspectTool(server, { workspace: opts.workspace })\n  }\n\n  return {\n    server,\n    registered: allSpecs.map((s) => s.name),\n  }\n}\n\n/**\n * Wire `createMcpServer` to stdio for use as an `mcp_servers.<id>`\n * entry on Claude Desktop / Cursor / etc. Resolves once the\n * transport closes.\n */\nexport async function runStdioServer(\n  opts: CreateMcpServerOptions,\n): Promise<void> {\n  const { server } = await createMcpServer(opts)\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nexport {\n  toMcpTool,\n  buildMcpTool,\n  type ToMcpToolOptions,\n  type McpToolRegistration,\n} from \"./to-mcp-tool.js\"\nexport {\n  registerSelfInspectTool,\n  selfInspect,\n  summarizeToolRef,\n  summarizeRoutineRef,\n  type RefSummary,\n  type SelfInspectResult,\n} from \"./self-inspect-tool.js\"\n\n// ── verb registration ───────────────────────────────────────────────\n\nfunction registerVerbs(\n  server: McpServer,\n  spec: AnySpec,\n  anchor: (p: string) => string,\n): void {\n  const verbs = createVerbs(spec)\n  // Tool name uses snake_case to match MCP convention; spec.name may\n  // be kebab (driver-cli) or namespaced (acme:deal). Map all to snake.\n  const verbName = (verb: string) =>\n    `${verb}_${spec.name.replace(/[-:]/g, \"_\")}`\n  const description = (verb: string, body: string) =>\n    `${verb} the AIP-${spec.aip} ${spec.name} doctype. ${body}`\n\n  // create\n  server.tool(\n    verbName(\"create\"),\n    description(\n      \"create\",\n      \"Author a new manifest from params. Returns { path, rendered }.\",\n    ),\n    {\n      params: z\n        .record(z.string(), z.unknown())\n        .describe(`The ${spec.name} definition fields.`),\n      dir: z.string().describe(\"Workspace-relative or absolute target directory.\"),\n      body: z\n        .string()\n        .optional()\n        .describe(\"Markdown body after the frontmatter. Defaults to a stub.\"),\n      dryRun: z\n        .boolean()\n        .optional()\n        .describe(\"Render only — don't write to disk.\"),\n    },\n    async ({ params, dir, body, dryRun }) => {\n      const result = await verbs.create(params, {\n        dir: anchor(dir),\n        body,\n        dryRun,\n      })\n      return contentText({\n        path: result.path,\n        rendered: result.rendered,\n      })\n    },\n  )\n\n  // load\n  server.tool(\n    verbName(\"load\"),\n    description(\"load\", \"Read a manifest from disk. Returns the parsed handle.\"),\n    {\n      path: z.string().describe(\"Absolute or workspace-relative path to the .md file.\"),\n    },\n    async ({ path }) => {\n      const result = await verbs.load(anchor(path))\n      return contentText({ path: result.path, handle: result.handle })\n    },\n  )\n\n  // list\n  server.tool(\n    verbName(\"list\"),\n    description(\n      \"list\",\n      \"Walk a directory tree and return all manifests of this doctype.\",\n    ),\n    {\n      dir: z.string().describe(\"Directory to walk.\"),\n      skipDirs: z\n        .array(z.string())\n        .optional()\n        .describe(\"Subdir names to skip (default: node_modules, .git, dist).\"),\n    },\n    async ({ dir, skipDirs }) => {\n      const handles = await verbs.list(anchor(dir), { skipDirs })\n      return contentText({ count: handles.length, handles })\n    },\n  )\n\n  // update\n  server.tool(\n    verbName(\"update\"),\n    description(\n      \"update\",\n      \"Patch an existing manifest. The patch is shallow-merged into the existing params.\",\n    ),\n    {\n      path: z.string().describe(\"Path to the manifest to update.\"),\n      patch: z\n        .record(z.string(), z.unknown())\n        .describe(\"Partial fields to merge into the existing manifest.\"),\n      body: z.string().optional().describe(\"New body markdown (default: keep existing).\"),\n    },\n    async ({ path, patch, body }) => {\n      const result = await verbs.update(\n        anchor(path),\n        (existing: Record<string, unknown>) => ({ ...existing, ...patch }),\n        { body },\n      )\n      return contentText({ path: result.path, rendered: result.rendered })\n    },\n  )\n\n  // resolve\n  server.tool(\n    verbName(\"resolve\"),\n    description(\n      \"resolve\",\n      \"Resolve an inline | ref | file block to a fully-typed handle.\",\n    ),\n    {\n      block: z\n        .union([\n          z.object({ inline: z.record(z.string(), z.unknown()) }),\n          z.object({ ref: z.string() }),\n          z.object({ file: z.string() }),\n        ])\n        .describe(\n          'The composition block. Exactly one of: { \"inline\": {...params} } | { \"ref\": \"@scope/id\" } | { \"file\": \"relative/path.md\" }. Omitting the wrapping key causes invalid_union.',\n        ),\n      baseDir: z\n        .string()\n        .optional()\n        .describe(\"Base dir for `file:` references.\"),\n    },\n    async ({ block, baseDir }) => {\n      const handle = await verbs.resolve(block, {\n        baseDir: baseDir ? anchor(baseDir) : undefined,\n      })\n      return contentText({ handle })\n    },\n  )\n\n  // delete\n  server.tool(\n    verbName(\"delete\"),\n    description(\"delete\", \"Remove a manifest file from disk.\"),\n    {\n      path: z.string().describe(\"Path to the manifest to delete.\"),\n    },\n    async ({ path }) => {\n      const target = anchor(path)\n      await verbs.delete(target)\n      return contentText({ deleted: target })\n    },\n  )\n}\n\n// ── extension loader ────────────────────────────────────────────────\n\nasync function loadExtensions(\n  workspace: string,\n  specs: readonly AnySpec[],\n): Promise<AnySpec[]> {\n  const extDir = resolve(workspace, \"extensions\")\n  if (!existsSync(extDir)) return []\n\n  const out: AnySpec[] = []\n  const { readdir } = await import(\"node:fs/promises\")\n  type SimpleDirent = { name: string; isDirectory(): boolean }\n\n  let entries: SimpleDirent[]\n  try {\n    entries = (await readdir(extDir, {\n      withFileTypes: true,\n    })) as unknown as SimpleDirent[]\n  } catch {\n    return out\n  }\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue\n    const manifestPath = join(extDir, String(entry.name), \"EXTENSION.md\")\n    if (!existsSync(manifestPath)) continue\n\n    const source = await readFile(manifestPath, \"utf8\")\n    const parsed = parseExtensionManifest(source)\n    const ext = parsed.frontmatter\n\n    let parent: AnySpec | undefined\n    if (ext.extends && ext.extends !== \"none\") {\n      const aipMatch = ext.extends.match(/^aip-(\\d+)$/)\n      if (!aipMatch) {\n        throw new Error(\n          `mcp-server: extension '${ext.slug}' has invalid extends '${ext.extends}'`,\n        )\n      }\n      const parentAip = Number(aipMatch[1])\n      parent = specs.find((s) => s.aip === parentAip)\n      if (!parent) {\n        throw new Error(\n          `mcp-server: extension '${ext.slug}' extends aip-${parentAip}, but no spec for that AIP was registered. Pass the parent spec in opts.specs.`,\n        )\n      }\n    }\n\n    out.push(specFromExtension(ext, { parent }) as AnySpec)\n  }\n\n  return out\n}\n\n// ── tool result helpers ─────────────────────────────────────────────\n\nfunction contentText(payload: unknown): {\n  content: Array<{ type: \"text\"; text: string }>\n} {\n  return {\n    content: [\n      {\n        type: \"text\",\n        text: JSON.stringify(payload, null, 2),\n      },\n    ],\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "@agentproto/mcp-server — exposes every AIP doctype as MCP tools. Pass DoctypeSpec instances + an optional workspace dir for EXTENSION.md auto-loading; the server registers create_X / load_X / list_X / update_X / resolve_X / delete_X for each registered doctype, including AIP-40 extensions. Compose to build agent runtimes that author and edit AIP manifests over MCP.",
   "keywords": [
     "agentproto",
@@ -19,7 +19,7 @@
   "bugs": {
     "url": "https://github.com/agentproto/ts/issues"
   },
-  "license": "MIT",
+  "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",
@@ -43,13 +43,13 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3",
-    "@agentproto/agent": "0.2.0",
-    "@agentproto/define-doctype": "0.1.0",
-    "@agentproto/driver": "0.1.1",
-    "@agentproto/extension": "0.1.1",
-    "@agentproto/manifest": "0.2.0",
-    "@agentproto/routine": "0.1.1",
-    "@agentproto/tool": "0.1.1"
+    "@agentproto/agent": "0.2.1",
+    "@agentproto/define-doctype": "0.1.1",
+    "@agentproto/driver": "0.1.3",
+    "@agentproto/extension": "0.1.2",
+    "@agentproto/manifest": "0.2.1",
+    "@agentproto/routine": "0.1.2",
+    "@agentproto/tool": "0.2.1"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",