@easynet/agent-tool 1.0.0 → 1.0.2

package/dist/chunk-QVH6IQKQ.js

@@ -0,0 +1,469 @@
+import { createRuntimeFromConfig, MCP_KIND } from './chunk-Q7KPGWC6.js';
+import { enrichSpecWithCanonicalSchema } from './chunk-FR2CXERF.js';
+import { createServer } from 'http';
+
+// src/api/expose/openapi.ts
+function toolNameToSlug(name) {
+  return name.replace(/\//g, "~");
+}
+function slugToToolName(slug) {
+  return slug.replace(/~/g, "/");
+}
+function toolSchemaKey(name) {
+  return `Tool_${name.replace(/[^a-zA-Z0-9_]/g, "_")}`;
+}
+var resultSchema = {
+  type: "object",
+  properties: {
+    result: { description: "Tool return value", additionalProperties: true }
+  }
+};
+var errorSchema = {
+  type: "object",
+  properties: {
+    error: { type: "string" },
+    kind: { type: "string" },
+    details: { type: "object", additionalProperties: true }
+  }
+};
+function toolsToOpenAPISpec(registry, options = {}) {
+  const title = options.title ?? "Tool API";
+  const version = options.version ?? "1.0.0";
+  const basePath = (options.basePath ?? "").replace(/\/$/, "");
+  const specs = registry.snapshot().map(enrichSpecWithCanonicalSchema);
+  const toolNamesSchema = {
+    type: "object",
+    required: ["tools"],
+    properties: {
+      tools: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            name: { type: "string" },
+            description: { type: "string" },
+            kind: { type: "string" }
+          }
+        }
+      }
+    }
+  };
+  const invokeRequestBody = {
+    type: "object",
+    required: ["tool", "args"],
+    properties: {
+      tool: { type: "string", description: "Tool name (e.g. from GET /tools)" },
+      args: {
+        type: "object",
+        description: "Tool arguments (schema per tool; use per-tool paths for typed schema)",
+        additionalProperties: true
+      }
+    }
+  };
+  const prefix = basePath ? `${basePath}/` : "/";
+  const paths = {
+    [`${prefix}tools`]: {
+      get: {
+        summary: "List tools",
+        description: "Returns all registered tool names and descriptions.",
+        operationId: "listTools",
+        responses: {
+          "200": {
+            description: "List of tools",
+            content: {
+              "application/json": {
+                schema: toolNamesSchema
+              }
+            }
+          }
+        }
+      }
+    },
+    [`${prefix}invoke`]: {
+      post: {
+        summary: "Invoke a tool (generic)",
+        description: "Call any tool by name with body { tool, args }. For typed schemas use POST /invoke/{toolSlug}.",
+        operationId: "invokeTool",
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: invokeRequestBody
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Tool result",
+            content: { "application/json": { schema: resultSchema } }
+          },
+          "400": {
+            description: "Bad request",
+            content: { "application/json": { schema: errorSchema } }
+          }
+        }
+      }
+    }
+  };
+  const schemaEntries = [];
+  for (const s of specs) {
+    const key = toolSchemaKey(s.name);
+    schemaEntries.push([key, s.inputSchema]);
+    const slug = toolNameToSlug(s.name);
+    paths[`${prefix}invoke/${slug}`] = {
+      post: {
+        summary: s.description ?? s.name,
+        description: `Invoke tool \`${s.name}\`. Request body is the tool's arguments (JSON Schema below).`,
+        operationId: `invoke_${key}`,
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: { $ref: `#/components/schemas/${key}` }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Tool result",
+            content: { "application/json": { schema: resultSchema } }
+          },
+          "400": {
+            description: "Bad request (invalid args or tool error)",
+            content: { "application/json": { schema: errorSchema } }
+          }
+        }
+      }
+    };
+  }
+  return {
+    openapi: "3.0.3",
+    info: { title, version },
+    paths,
+    components: {
+      schemas: Object.fromEntries(schemaEntries)
+    }
+  };
+}
+
+// src/api/expose/openapiHttp.ts
+var DEFAULT_CTX = {
+  requestId: `http-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,
+  taskId: `task-${Date.now()}`,
+  permissions: [
+    "read:web",
+    "read:fs",
+    "write:fs",
+    "read:db",
+    "write:db",
+    "network",
+    "workflow",
+    "danger:destructive"
+  ]
+};
+function parseBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (chunk) => chunks.push(chunk));
+    req.on("end", () => {
+      const raw = Buffer.concat(chunks).toString("utf-8");
+      if (!raw.trim()) {
+        resolve({});
+        return;
+      }
+      try {
+        resolve(JSON.parse(raw));
+      } catch {
+        reject(new Error("Invalid JSON body"));
+      }
+    });
+    req.on("error", reject);
+  });
+}
+function sendJson(res, status, data) {
+  res.writeHead(status, { "Content-Type": "application/json" });
+  res.end(JSON.stringify(data));
+}
+function swaggerUiHtml(specUrl) {
+  const specUrlEscaped = specUrl.replace(/"/g, """);
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Tool API \u2013 Swagger UI</title>
+  <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
+</head>
+<body>
+  <div id="swagger-ui"></div>
+  <script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js" crossorigin></script>
+  <script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-standalone-preset.js" crossorigin></script>
+  <script>
+    window.onload = function() {
+      window.ui = SwaggerUIBundle({
+        url: "${specUrlEscaped}",
+        dom_id: "#swagger-ui",
+        deepLinking: true,
+        presets: [
+          SwaggerUIBundle.presets.apis,
+          SwaggerUIStandalonePreset
+        ],
+        layout: "StandaloneLayout"
+      });
+    };
+  </script>
+</body>
+</html>`;
+}
+function createOpenAPIHttpServer(runtime, options = {}) {
+  const basePath = (options.basePath ?? "").replace(/\/$/, "");
+  const ctxFactory = options.execContextFactory ?? (() => ({ ...DEFAULT_CTX }));
+  const server = createServer(async (req, res) => {
+    const url = req.url ?? "/";
+    const path = url.split("?")[0] ?? "/";
+    const norm = basePath ? path === basePath ? "" : path.replace(basePath, "") || "/" : path;
+    try {
+      if (req.method === "GET" && (norm === "/" || norm === "/swagger")) {
+        const specPath = basePath ? `${basePath}/openapi.json` : "/openapi.json";
+        const html = swaggerUiHtml(specPath);
+        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+        res.end(html);
+        return;
+      }
+      if (req.method === "GET" && (norm === "/openapi.json" || norm === "/spec")) {
+        const spec = toolsToOpenAPISpec(runtime.getRegistry(), {
+          title: "Tool API",
+          version: "1.0.0",
+          basePath: basePath || void 0
+        });
+        sendJson(res, 200, spec);
+        return;
+      }
+      if (req.method === "GET" && norm === "/tools") {
+        const { enrichSpecWithCanonicalSchema: enrichSpecWithCanonicalSchema2 } = await import('./canonicalCoreSchemas-YLHVHYJZ.js');
+        const specs = runtime.getRegistry().snapshot().map(enrichSpecWithCanonicalSchema2);
+        const tools = specs.map((s) => ({
+          name: s.name,
+          description: s.description,
+          kind: s.kind,
+          inputSchema: s.inputSchema
+        }));
+        sendJson(res, 200, { tools });
+        return;
+      }
+      if (req.method === "POST" && norm === "/invoke") {
+        const body = await parseBody(req);
+        const tool = body?.tool;
+        const args = body?.args ?? {};
+        if (typeof tool !== "string" || !tool.trim()) {
+          sendJson(res, 400, { error: "Missing or invalid 'tool' in body", kind: "BAD_REQUEST" });
+          return;
+        }
+        const ctx = ctxFactory(req);
+        const result = await runtime.invoke(
+          { tool: tool.trim(), args, purpose: "openapi" },
+          ctx
+        );
+        if (result.ok) {
+          sendJson(res, 200, { result: result.result });
+          return;
+        }
+        sendJson(res, 400, {
+          error: result.error?.message ?? "Tool failed",
+          kind: result.error?.kind,
+          details: result.error?.details
+        });
+        return;
+      }
+      if (req.method === "POST" && norm.startsWith("/invoke/") && norm.length > "/invoke/".length) {
+        const slug = norm.slice("/invoke/".length);
+        const toolName = slugToToolName(slug);
+        let args;
+        try {
+          args = await parseBody(req);
+        } catch {
+          sendJson(res, 400, { error: "Invalid JSON body", kind: "BAD_REQUEST" });
+          return;
+        }
+        const ctx = ctxFactory(req);
+        const result = await runtime.invoke(
+          { tool: toolName, args: args ?? {}, purpose: "openapi" },
+          ctx
+        );
+        if (result.ok) {
+          sendJson(res, 200, { result: result.result });
+          return;
+        }
+        sendJson(res, 400, {
+          error: result.error?.message ?? "Tool failed",
+          kind: result.error?.kind,
+          details: result.error?.details
+        });
+        return;
+      }
+      res.writeHead(404, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ error: "Not found", path: norm }));
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      sendJson(res, 500, { error: message, kind: "INTERNAL_ERROR" });
+    }
+  });
+  return server;
+}
+function listenOpenAPIHttpServer(server, options = {}) {
+  return new Promise((resolve, reject) => {
+    const port = options.port ?? 0;
+    const host = options.host ?? "localhost";
+    server.listen(port, host, () => {
+      const addr = server.address();
+      const actualPort = typeof addr === "object" && addr?.port != null ? addr.port : port;
+      resolve({ port: actualPort, host });
+    });
+    server.on("error", reject);
+  });
+}
+async function createHttpService(runtimeOrConfig, options = {}) {
+  const runtime = "invoke" in runtimeOrConfig && typeof runtimeOrConfig.invoke === "function" ? runtimeOrConfig : (await createRuntimeFromConfig(runtimeOrConfig)).runtime;
+  const server = createOpenAPIHttpServer(runtime, options);
+  const openApiSpec = toolsToOpenAPISpec(runtime.getRegistry(), {
+    title: options.title ?? "Tool API",
+    version: options.version ?? "1.0.0",
+    basePath: options.basePath
+  });
+  return {
+    server,
+    openApiSpec,
+    listen: (listenOpts) => listenOpenAPIHttpServer(server, listenOpts)
+  };
+}
+
+// src/api/expose/mcpServer.ts
+var DEFAULT_CTX2 = {
+  requestId: `mcp-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,
+  taskId: `task-${Date.now()}`,
+  permissions: [
+    "read:web",
+    "read:fs",
+    "write:fs",
+    "read:db",
+    "write:db",
+    "network",
+    "workflow",
+    "danger:destructive"
+  ]
+};
+async function createMcpServerWithTools(runtime, options) {
+  const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
+  const name = options.name ?? "agent-tool";
+  const version = options.version ?? "1.0.0";
+  const ctxFactory = options.execContextFactory ?? (() => ({ ...DEFAULT_CTX2 }));
+  const server = new McpServer({ name, version });
+  const registry = runtime.getRegistry();
+  const specs = registry.snapshot();
+  for (const spec of specs) {
+    server.registerTool(
+      spec.name,
+      {
+        description: spec.description ?? `Tool: ${spec.name}`,
+        inputSchema: spec.inputSchema,
+        _meta: spec._meta
+      },
+      async (args) => {
+        const ctx = ctxFactory();
+        const result = await runtime.invoke(
+          { tool: spec.name, args: args ?? {}, purpose: MCP_KIND },
+          ctx
+        );
+        if (result.ok) {
+          return { content: [{ type: "text", text: JSON.stringify(result.result) }] };
+        }
+        const err = result.error;
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ error: err?.message ?? "Tool failed", kind: err?.kind })
+            }
+          ],
+          isError: true
+        };
+      }
+    );
+  }
+  return { server };
+}
+async function createMCPServer(runtimeOrConfig, options = {}) {
+  const runtime = "invoke" in runtimeOrConfig && typeof runtimeOrConfig.invoke === "function" ? runtimeOrConfig : (await createRuntimeFromConfig(runtimeOrConfig)).runtime;
+  const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+  const { server } = await createMcpServerWithTools(runtime, options);
+  return {
+    server,
+    async connectStdio() {
+      const transport = new StdioServerTransport();
+      await server.connect(transport);
+    }
+  };
+}
+function createMCPStreamableHttpHandler(runtimeOrConfig, options = {}) {
+  if ("invoke" in runtimeOrConfig && typeof runtimeOrConfig.invoke === "function") {
+    const runtime = runtimeOrConfig;
+    return async function streamableHttpHandler(req, res, parsedBody) {
+      const { StreamableHTTPServerTransport } = await import('@modelcontextprotocol/sdk/server/streamableHttp.js');
+      const { server } = await createMcpServerWithTools(runtime, options);
+      const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: void 0 });
+      await server.connect(transport);
+      const onClose = () => {
+        transport.close().catch(() => {
+        });
+        server.close().catch(() => {
+        });
+        res.removeListener("close", onClose);
+        res.removeListener("finish", onClose);
+      };
+      res.once("close", onClose);
+      res.once("finish", onClose);
+      await transport.handleRequest(
+        req,
+        res,
+        parsedBody
+      );
+    };
+  }
+  return (async () => {
+    const { runtime } = await createRuntimeFromConfig(runtimeOrConfig);
+    return createMCPStreamableHttpHandler(runtime, options);
+  })();
+}
+async function createMCPServerStreamableHttp(runtimeOrConfig, options = {}) {
+  const path = options.path ?? "/mcp";
+  const host = options.host ?? "127.0.0.1";
+  const port = options.port ?? 3e3;
+  const { createMcpExpressApp } = await import('@modelcontextprotocol/sdk/server/express.js');
+  const handler = "invoke" in runtimeOrConfig && typeof runtimeOrConfig.invoke === "function" ? createMCPStreamableHttpHandler(runtimeOrConfig, options) : await createMCPStreamableHttpHandler(runtimeOrConfig, options);
+  const app = createMcpExpressApp({ host });
+  app.post(path, handler);
+  return {
+    app,
+    path,
+    async listen(listenPort, listenHost) {
+      const p = listenPort ?? port;
+      const h = listenHost ?? host;
+      return new Promise((resolve, reject) => {
+        const server = app.listen(p, h, () => {
+          const addr = server.address();
+          const actualPort = typeof addr === "object" && addr !== null && "port" in addr ? addr.port : p;
+          resolve({ url: `http://${h}:${actualPort}${path}`, port: actualPort });
+        });
+      });
+    }
+  };
+}
+async function runMCPServerOverStdio(runtime, options = {}) {
+  const result = await createMCPServer(runtime, options);
+  await result.connectStdio();
+  return result;
+}
+
+export { createHttpService, createMCPServer, createMCPServerStreamableHttp, createMCPStreamableHttpHandler, runMCPServerOverStdio };
+//# sourceMappingURL=chunk-QVH6IQKQ.js.map
+//# sourceMappingURL=chunk-QVH6IQKQ.js.map

package/dist/chunk-QVH6IQKQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api/expose/openapi.ts","../src/api/expose/openapiHttp.ts","../src/api/expose/mcpServer.ts"],"names":["enrichSpecWithCanonicalSchema","DEFAULT_CTX"],"mappings":"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","file":"chunk-QVH6IQKQ.js","sourcesContent":["/**\n * Expose tools as OpenAPI (Swagger) spec and optional HTTP server.\n * Same tools can be used via LangChain, MCP, or REST.\n */\n\nimport type { ToolRegistry } from \"../../core/registry/ToolRegistry.js\";\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport { enrichSpecWithCanonicalSchema } from \"../../tools/util/canonicalCoreSchemas.js\";\n\nexport interface OpenAPISpecOptions {\n  /** API title (default: \"Tool API\") */\n  title?: string;\n  /** API version (default: \"1.0.0\") */\n  version?: string;\n  /** Base path for the API (default: \"\") */\n  basePath?: string;\n}\n\n/** Tool name to URL path segment: \"core/fs.readText\" -> \"core~fs.readText\" */\nexport function toolNameToSlug(name: string): string {\n  return name.replace(/\\//g, \"~\");\n}\n\n/** URL path segment back to tool name: \"core~fs.readText\" -> \"core/fs.readText\" */\nexport function slugToToolName(slug: string): string {\n  return slug.replace(/~/g, \"/\");\n}\n\n/** Safe schema key for components: \"core/fs.readText\" -> \"Tool_core_fs_readText\" */\nfunction toolSchemaKey(name: string): string {\n  return `Tool_${name.replace(/[^a-zA-Z0-9_]/g, \"_\")}`;\n}\n\nconst resultSchema = {\n  type: \"object\" as const,\n  properties: {\n    result: { description: \"Tool return value\", additionalProperties: true },\n  },\n};\nconst errorSchema = {\n  type: \"object\" as const,\n  properties: {\n    error: { type: \"string\" },\n    kind: { type: \"string\" },\n    details: { type: \"object\", additionalProperties: true },\n  },\n};\n\n/**\n * Build OpenAPI 3.0 document from the tool registry.\n * GET /tools, POST /invoke (generic), and one POST /invoke/{toolSlug} per tool with that tool's input schema.\n */\nexport function toolsToOpenAPISpec(\n  registry: ToolRegistry,\n  options: OpenAPISpecOptions = {}\n): Record<string, unknown> {\n  const title = options.title ?? \"Tool API\";\n  const version = options.version ?? \"1.0.0\";\n  const basePath = (options.basePath ?? \"\").replace(/\\/$/, \"\");\n  const specs = registry.snapshot().map(enrichSpecWithCanonicalSchema);\n\n  const toolNamesSchema = {\n    type: \"object\",\n    required: [\"tools\"],\n    properties: {\n      tools: {\n        type: \"array\",\n        items: {\n          type: \"object\",\n          properties: {\n            name: { type: \"string\" },\n            description: { type: \"string\" },\n            kind: { type: \"string\" },\n          },\n        },\n      },\n    },\n  };\n\n  const invokeRequestBody = {\n    type: \"object\",\n    required: [\"tool\", \"args\"],\n    properties: {\n      tool: { type: \"string\", description: \"Tool name (e.g. from GET /tools)\" },\n      args: {\n        type: \"object\",\n        description: \"Tool arguments (schema per tool; use per-tool paths for typed schema)\",\n        additionalProperties: true,\n      },\n    },\n  };\n\n  const prefix = basePath ? `${basePath}/` : \"/\";\n  const paths: Record<string, unknown> = {\n    [`${prefix}tools`]: {\n      get: {\n        summary: \"List tools\",\n        description: \"Returns all registered tool names and descriptions.\",\n        operationId: \"listTools\",\n        responses: {\n          \"200\": {\n            description: \"List of tools\",\n            content: {\n              \"application/json\": {\n                schema: toolNamesSchema,\n              },\n            },\n          },\n        },\n      },\n    },\n    [`${prefix}invoke`]: {\n      post: {\n        summary: \"Invoke a tool (generic)\",\n        description: \"Call any tool by name with body { tool, args }. For typed schemas use POST /invoke/{toolSlug}.\",\n        operationId: \"invokeTool\",\n        requestBody: {\n          required: true,\n          content: {\n            \"application/json\": {\n              schema: invokeRequestBody,\n            },\n          },\n        },\n        responses: {\n          \"200\": {\n            description: \"Tool result\",\n            content: { \"application/json\": { schema: resultSchema } },\n          },\n          \"400\": {\n            description: \"Bad request\",\n            content: { \"application/json\": { schema: errorSchema } },\n          },\n        },\n      },\n    },\n  };\n\n  const schemaEntries: [string, object][] = [];\n  for (const s of specs) {\n    const key = toolSchemaKey(s.name);\n    schemaEntries.push([key, s.inputSchema as object]);\n    const slug = toolNameToSlug(s.name);\n    paths[`${prefix}invoke/${slug}`] = {\n      post: {\n        summary: s.description ?? s.name,\n        description: `Invoke tool \\`${s.name}\\`. Request body is the tool's arguments (JSON Schema below).`,\n        operationId: `invoke_${key}`,\n        requestBody: {\n          required: true,\n          content: {\n            \"application/json\": {\n              schema: { $ref: `#/components/schemas/${key}` },\n            },\n          },\n        },\n        responses: {\n          \"200\": {\n            description: \"Tool result\",\n            content: { \"application/json\": { schema: resultSchema } },\n          },\n          \"400\": {\n            description: \"Bad request (invalid args or tool error)\",\n            content: { \"application/json\": { schema: errorSchema } },\n          },\n        },\n      },\n    };\n  }\n\n  return {\n    openapi: \"3.0.3\",\n    info: { title, version },\n    paths,\n    components: {\n      schemas: Object.fromEntries(schemaEntries),\n    },\n  };\n}\n","/**\n * HTTP server that exposes tools via OpenAPI (Swagger): GET / (Swagger UI), GET /openapi.json, GET /tools, POST /invoke.\n * All invokes go through PTCRuntime.invoke(intent, ctx). Uses Node's built-in http.\n */\n\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { CreateRuntimeOptions } from \"../runtimeFromConfig.js\";\nimport { createRuntimeFromConfig } from \"../runtimeFromConfig.js\";\nimport { toolsToOpenAPISpec, slugToToolName } from \"./openapi.js\";\n\nexport interface OpenAPIHttpServerOptions {\n  /** Port (default: 0 = let OS choose) */\n  port?: number;\n  /** Host (default: \"localhost\") */\n  host?: string;\n  /** Base path for routes (default: \"\") */\n  basePath?: string;\n  /** Build ExecContext for each request (default: minimal ctx) */\n  execContextFactory?: (req: IncomingMessage) => ExecContext;\n}\n\nconst DEFAULT_CTX: ExecContext = {\n  requestId: `http-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n  taskId: `task-${Date.now()}`,\n  permissions: [\n    \"read:web\", \"read:fs\", \"write:fs\", \"read:db\", \"write:db\",\n    \"network\", \"workflow\", \"danger:destructive\",\n  ],\n};\n\nfunction parseBody(req: IncomingMessage): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk) => chunks.push(chunk));\n    req.on(\"end\", () => {\n      const raw = Buffer.concat(chunks).toString(\"utf-8\");\n      if (!raw.trim()) {\n        resolve({});\n        return;\n      }\n      try {\n        resolve(JSON.parse(raw) as unknown);\n      } catch {\n        reject(new Error(\"Invalid JSON body\"));\n      }\n    });\n    req.on(\"error\", reject);\n  });\n}\n\nfunction sendJson(res: ServerResponse, status: number, data: unknown): void {\n  res.writeHead(status, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(data));\n}\n\n/** Build HTML for Swagger UI (CDN) pointing at the given spec URL. */\nfunction swaggerUiHtml(specUrl: string): string {\n  const specUrlEscaped = specUrl.replace(/\"/g, \"&quot;\");\n  return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>Tool API – Swagger UI</title>\n  <link rel=\"stylesheet\" href=\"https://unpkg.com/swagger-ui-dist@5/swagger-ui.css\">\n</head>\n<body>\n  <div id=\"swagger-ui\"></div>\n  <script src=\"https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js\" crossorigin></script>\n  <script src=\"https://unpkg.com/swagger-ui-dist@5/swagger-ui-standalone-preset.js\" crossorigin></script>\n  <script>\n    window.onload = function() {\n      window.ui = SwaggerUIBundle({\n        url: \"${specUrlEscaped}\",\n        dom_id: \"#swagger-ui\",\n        deepLinking: true,\n        presets: [\n          SwaggerUIBundle.presets.apis,\n          SwaggerUIStandalonePreset\n        ],\n        layout: \"StandaloneLayout\"\n      });\n    };\n  </script>\n</body>\n</html>`;\n}\n\n/**\n * Create an HTTP server that exposes tools via OpenAPI-style routes.\n * - GET / or GET /swagger: Swagger UI (interactive docs)\n * - GET /openapi.json (or basePath/openapi.json): OpenAPI 3.0 spec\n * - GET /tools: list tools\n * - POST /invoke: body { tool, args } -> { result } or { error }\n */\nexport function createOpenAPIHttpServer(\n  runtime: PTCRuntime,\n  options: OpenAPIHttpServerOptions = {}\n): import(\"node:http\").Server {\n  const basePath = (options.basePath ?? \"\").replace(/\\/$/, \"\");\n  const ctxFactory = options.execContextFactory ?? (() => ({ ...DEFAULT_CTX }));\n\n  const server = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n    const url = req.url ?? \"/\";\n    const path = url.split(\"?\")[0] ?? \"/\";\n    const norm = basePath ? (path === basePath ? \"\" : path.replace(basePath, \"\") || \"/\") : path;\n\n    try {\n      if (req.method === \"GET\" && (norm === \"/\" || norm === \"/swagger\")) {\n        const specPath = basePath ? `${basePath}/openapi.json` : \"/openapi.json\";\n        const html = swaggerUiHtml(specPath);\n        res.writeHead(200, { \"Content-Type\": \"text/html; charset=utf-8\" });\n        res.end(html);\n        return;\n      }\n\n      if (req.method === \"GET\" && (norm === \"/openapi.json\" || norm === \"/spec\")) {\n        const spec = toolsToOpenAPISpec(runtime.getRegistry(), {\n          title: \"Tool API\",\n          version: \"1.0.0\",\n          basePath: basePath || undefined,\n        });\n        sendJson(res, 200, spec);\n        return;\n      }\n\n      if (req.method === \"GET\" && norm === \"/tools\") {\n        const { enrichSpecWithCanonicalSchema } = await import(\"../../tools/util/canonicalCoreSchemas.js\");\n        const specs = runtime.getRegistry().snapshot().map(enrichSpecWithCanonicalSchema);\n        const tools = specs.map((s) => ({\n          name: s.name,\n          description: s.description,\n          kind: s.kind,\n          inputSchema: s.inputSchema,\n        }));\n        sendJson(res, 200, { tools });\n        return;\n      }\n\n      if (req.method === \"POST\" && norm === \"/invoke\") {\n        const body = (await parseBody(req)) as { tool?: string; args?: unknown };\n        const tool = body?.tool;\n        const args = body?.args ?? {};\n        if (typeof tool !== \"string\" || !tool.trim()) {\n          sendJson(res, 400, { error: \"Missing or invalid 'tool' in body\", kind: \"BAD_REQUEST\" });\n          return;\n        }\n        const ctx = ctxFactory(req);\n        const result = await runtime.invoke(\n          { tool: tool.trim(), args, purpose: \"openapi\" },\n          ctx\n        );\n        if (result.ok) {\n          sendJson(res, 200, { result: result.result });\n          return;\n        }\n        sendJson(res, 400, {\n          error: result.error?.message ?? \"Tool failed\",\n          kind: result.error?.kind,\n          details: result.error?.details,\n        });\n        return;\n      }\n\n      if (req.method === \"POST\" && norm.startsWith(\"/invoke/\") && norm.length > \"/invoke/\".length) {\n        const slug = norm.slice(\"/invoke/\".length);\n        const toolName = slugToToolName(slug);\n        let args: unknown;\n        try {\n          args = await parseBody(req);\n        } catch {\n          sendJson(res, 400, { error: \"Invalid JSON body\", kind: \"BAD_REQUEST\" });\n          return;\n        }\n        const ctx = ctxFactory(req);\n        const result = await runtime.invoke(\n          { tool: toolName, args: args ?? {}, purpose: \"openapi\" },\n          ctx\n        );\n        if (result.ok) {\n          sendJson(res, 200, { result: result.result });\n          return;\n        }\n        sendJson(res, 400, {\n          error: result.error?.message ?? \"Tool failed\",\n          kind: result.error?.kind,\n          details: result.error?.details,\n        });\n        return;\n      }\n\n      res.writeHead(404, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ error: \"Not found\", path: norm }));\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      sendJson(res, 500, { error: message, kind: \"INTERNAL_ERROR\" });\n    }\n  });\n\n  return server;\n}\n\n/**\n * Start the OpenAPI HTTP server on the given port/host.\n * Call after createOpenAPIHttpServer if you did not pass port in options.\n */\nexport function listenOpenAPIHttpServer(\n  server: import(\"node:http\").Server,\n  options: { port?: number; host?: string } = {}\n): Promise<{ port: number; host: string }> {\n  return new Promise((resolve, reject) => {\n    const port = options.port ?? 0;\n    const host = options.host ?? \"localhost\";\n    server.listen(port, host, () => {\n      const addr = server.address();\n      const actualPort = typeof addr === \"object\" && addr?.port != null ? addr.port : port;\n      resolve({ port: actualPort, host });\n    });\n    server.on(\"error\", reject);\n  });\n}\n\nexport interface HttpServiceResult {\n  /** Node HTTP server (call .close() when done) */\n  server: import(\"node:http\").Server;\n  /** OpenAPI 3.0 spec document (for Swagger UI etc.) */\n  openApiSpec: Record<string, unknown>;\n  /** Start listening; returns { port, host } */\n  listen: (options?: { port?: number; host?: string }) => Promise<{ port: number; host: string }>;\n}\n\nexport interface CreateHttpServiceOptions extends OpenAPIHttpServerOptions {\n  /** API title for OpenAPI spec (default: \"Tool API\") */\n  title?: string;\n  /** API version for OpenAPI spec (default: \"1.0.0\") */\n  version?: string;\n}\n\n/**\n * Create HTTP service that exposes tools via OpenAPI (Swagger).\n * Returns server, OpenAPI spec, and a listen() helper.\n */\nexport function createHttpService(\n  runtime: PTCRuntime,\n  options?: CreateHttpServiceOptions\n): Promise<HttpServiceResult>;\n\n/**\n * Create HTTP service from config (async: loads tools from projectPath when set).\n */\nexport function createHttpService(\n  config: CreateRuntimeOptions,\n  options?: CreateHttpServiceOptions\n): Promise<HttpServiceResult>;\n\nexport async function createHttpService(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: CreateHttpServiceOptions = {}\n): Promise<HttpServiceResult> {\n  const runtime: PTCRuntime =\n    \"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\"\n      ? (runtimeOrConfig as PTCRuntime)\n      : (await createRuntimeFromConfig(runtimeOrConfig as CreateRuntimeOptions)).runtime;\n  const server = createOpenAPIHttpServer(runtime, options);\n  const openApiSpec = toolsToOpenAPISpec(runtime.getRegistry(), {\n    title: options.title ?? \"Tool API\",\n    version: options.version ?? \"1.0.0\",\n    basePath: options.basePath,\n  });\n  return {\n    server,\n    openApiSpec,\n    listen: (listenOpts) => listenOpenAPIHttpServer(server, listenOpts),\n  };\n}\n","/**\n * Expose tools as an MCP server (stdio or Streamable HTTP). All invokes go through PTCRuntime.invoke(intent, ctx).\n * Requires @modelcontextprotocol/sdk.\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { CreateRuntimeOptions } from \"../runtimeFromConfig.js\";\nimport { createRuntimeFromConfig } from \"../runtimeFromConfig.js\";\nimport { MCP_KIND } from \"../../tools/mcp/types.js\";\n\nexport interface MCPServerOptions {\n  /** Server name (default: \"agent-tool\") */\n  name?: string;\n  /** Server version (default: \"1.0.0\") */\n  version?: string;\n  /** Build ExecContext for each tool call (default: minimal ctx) */\n  execContextFactory?: () => ExecContext;\n}\n\nconst DEFAULT_CTX: ExecContext = {\n  requestId: `mcp-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n  taskId: `task-${Date.now()}`,\n  permissions: [\n    \"read:web\", \"read:fs\", \"write:fs\", \"read:db\", \"write:db\",\n    \"network\", \"workflow\", \"danger:destructive\",\n  ],\n};\n\nexport interface MCPServerResult {\n  /** The MCP server instance */\n  server: { connect(transport: unknown): Promise<void>; close?(): Promise<void> };\n  /** Call this to start listening on stdio (for in-process MCP service) */\n  connectStdio: () => Promise<void>;\n}\n\n/** Request handler for Streamable HTTP: (req, res, parsedBody?) => Promise<void>. Use with Express app.post(path, handler) and express.json(). */\nexport type MCPStreamableHttpHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n  parsedBody?: unknown\n) => Promise<void>;\n\nexport interface MCPServerStreamableHttpResult {\n  /** Express app with POST /mcp (or path) wired to Streamable HTTP handler */\n  app: { post: (path: string, handler: MCPStreamableHttpHandler) => void };\n  /** Path mounted (e.g. \"/mcp\") */\n  path: string;\n  /** Start HTTP server; returns when listening. Use createMCPStreamableHttpHandler + your own server if you prefer. */\n  listen: (port?: number, host?: string) => Promise<{ url: string; port: number }>;\n}\n\n/**\n * Create a configured McpServer with all tools from the given runtime (no transport connected).\n * Used by createMCPServer (stdio) and createMCPStreamableHttpHandler (Streamable HTTP).\n */\nasync function createMcpServerWithTools(\n  runtime: PTCRuntime,\n  options: MCPServerOptions\n): Promise<{ server: InstanceType<Awaited<typeof import(\"@modelcontextprotocol/sdk/server/mcp.js\")>[\"McpServer\"]> }> {\n  const { McpServer } = await import(\"@modelcontextprotocol/sdk/server/mcp.js\");\n  const name = options.name ?? \"agent-tool\";\n  const version = options.version ?? \"1.0.0\";\n  const ctxFactory = options.execContextFactory ?? (() => ({ ...DEFAULT_CTX }));\n\n  const server = new McpServer({ name, version });\n  const registry = runtime.getRegistry();\n  const specs = registry.snapshot();\n\n  for (const spec of specs) {\n    server.registerTool(\n      spec.name,\n      {\n        description: spec.description ?? `Tool: ${spec.name}`,\n        inputSchema: spec.inputSchema,\n        _meta: spec._meta,\n      } as Parameters<typeof server.registerTool>[1],\n      async (args: unknown) => {\n        const ctx = ctxFactory();\n        const result = await runtime.invoke(\n          { tool: spec.name, args: args ?? {}, purpose: MCP_KIND },\n          ctx\n        );\n        if (result.ok) {\n          return { content: [{ type: \"text\", text: JSON.stringify(result.result) }] };\n        }\n        const err = result.error;\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify({ error: err?.message ?? \"Tool failed\", kind: err?.kind }),\n            },\n          ],\n          isError: true,\n        };\n      }\n    );\n  }\n  return { server };\n}\n\n/**\n * Create an MCP server that serves all tools from the given PTCRuntime.\n * Register tools with the server; then call connectStdio() to listen on stdio (for Cursor/Claude).\n */\nexport function createMCPServer(\n  runtime: PTCRuntime,\n  options?: MCPServerOptions\n): Promise<MCPServerResult>;\n\n/**\n * Create an MCP server from config (async: loads tools from projectPath when set).\n */\nexport function createMCPServer(\n  config: CreateRuntimeOptions,\n  options?: MCPServerOptions\n): Promise<MCPServerResult>;\n\nexport async function createMCPServer(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: MCPServerOptions = {}\n): Promise<MCPServerResult> {\n  const runtime: PTCRuntime =\n    \"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\"\n      ? (runtimeOrConfig as PTCRuntime)\n      : (await createRuntimeFromConfig(runtimeOrConfig as CreateRuntimeOptions)).runtime;\n  const { StdioServerTransport } = await import(\"@modelcontextprotocol/sdk/server/stdio.js\");\n\n  const { server } = await createMcpServerWithTools(runtime, options);\n\n  return {\n    server,\n    async connectStdio() {\n      const transport = new StdioServerTransport();\n      await server.connect(transport);\n    },\n  };\n}\n\n/**\n * Create a request handler for MCP Streamable HTTP (stateless). Use with Express: app.use(express.json()); app.post(\"/mcp\", handler).\n * Each request gets a new server and transport; supports SSE and direct HTTP responses per MCP Streamable HTTP spec.\n */\nexport function createMCPStreamableHttpHandler(\n  runtime: PTCRuntime,\n  options?: MCPServerOptions\n): MCPStreamableHttpHandler;\n\nexport function createMCPStreamableHttpHandler(\n  config: CreateRuntimeOptions,\n  options?: MCPServerOptions\n): Promise<MCPStreamableHttpHandler>;\n\nexport function createMCPStreamableHttpHandler(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: MCPServerOptions = {}\n): MCPStreamableHttpHandler | Promise<MCPStreamableHttpHandler> {\n  if (\"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\") {\n    const runtime = runtimeOrConfig as PTCRuntime;\n    return async function streamableHttpHandler(\n      req: IncomingMessage,\n      res: ServerResponse,\n      parsedBody?: unknown\n    ): Promise<void> {\n      const { StreamableHTTPServerTransport } = await import(\"@modelcontextprotocol/sdk/server/streamableHttp.js\");\n      const { server } = await createMcpServerWithTools(runtime, options);\n      const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });\n      await server.connect(transport);\n      const onClose = (): void => {\n        transport.close().catch(() => {});\n        server.close().catch(() => {});\n        res.removeListener(\"close\", onClose);\n        res.removeListener(\"finish\", onClose);\n      };\n      res.once(\"close\", onClose);\n      res.once(\"finish\", onClose);\n      await transport.handleRequest(\n      req as IncomingMessage & { auth?: import(\"@modelcontextprotocol/sdk/server/auth/types.js\").AuthInfo },\n      res,\n      parsedBody\n    );\n    };\n  }\n  return (async (): Promise<MCPStreamableHttpHandler> => {\n    const { runtime } = await createRuntimeFromConfig(runtimeOrConfig as CreateRuntimeOptions);\n    return createMCPStreamableHttpHandler(runtime, options) as MCPStreamableHttpHandler;\n  })();\n}\n\nexport interface CreateMCPServerStreamableHttpOptions extends MCPServerOptions {\n  /** Path for MCP endpoint (default: \"/mcp\") */\n  path?: string;\n  /** Host to bind (default: \"127.0.0.1\") */\n  host?: string;\n  /** Port (default: 3000) */\n  port?: number;\n}\n\n/**\n * Create an Express app with MCP Streamable HTTP handler mounted at path. Requires @modelcontextprotocol/sdk (which uses express).\n * Returns app and listen(port?, host?) to start the HTTP server.\n */\nexport function createMCPServerStreamableHttp(\n  runtime: PTCRuntime,\n  options?: CreateMCPServerStreamableHttpOptions\n): Promise<MCPServerStreamableHttpResult>;\n\nexport function createMCPServerStreamableHttp(\n  config: CreateRuntimeOptions,\n  options?: CreateMCPServerStreamableHttpOptions\n): Promise<MCPServerStreamableHttpResult>;\n\nexport async function createMCPServerStreamableHttp(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: CreateMCPServerStreamableHttpOptions = {}\n): Promise<MCPServerStreamableHttpResult> {\n  const path = options.path ?? \"/mcp\";\n  const host = options.host ?? \"127.0.0.1\";\n  const port = options.port ?? 3000;\n  const { createMcpExpressApp } = await import(\"@modelcontextprotocol/sdk/server/express.js\");\n  const handler =\n    \"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\"\n      ? createMCPStreamableHttpHandler(runtimeOrConfig as PTCRuntime, options)\n      : await createMCPStreamableHttpHandler(runtimeOrConfig as CreateRuntimeOptions, options);\n  const app = createMcpExpressApp({ host });\n  app.post(path, handler);\n\n  return {\n    app,\n    path,\n    async listen(listenPort?: number, listenHost?: string): Promise<{ url: string; port: number }> {\n      const p = listenPort ?? port;\n      const h = listenHost ?? host;\n      return new Promise((resolve, reject) => {\n        const server = (app as {\n          listen: (port: number, host: string, cb?: () => void) => import(\"node:http\").Server;\n        }).listen(p, h, () => {\n          const addr = server.address();\n          const actualPort =\n            typeof addr === \"object\" && addr !== null && \"port\" in addr ? addr.port : p;\n          resolve({ url: `http://${h}:${actualPort}${path}`, port: actualPort });\n        });\n      });\n    },\n  };\n}\n\n/**\n * Run MCP server over stdio using the given runtime.\n * Call this when your process should act as an MCP server (e.g. for Cursor/Claude to connect).\n */\nexport async function runMCPServerOverStdio(\n  runtime: PTCRuntime,\n  options: MCPServerOptions = {}\n): Promise<MCPServerResult> {\n  const result = await createMCPServer(runtime, options);\n  await result.connectStdio();\n  return result;\n}\n"]}

package/dist/{chunk-3YLVPZRJ.cjs → chunk-SOFUWEZ6.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-// src/types/ToolSpec.ts
+// src/core/types/ToolSpec.ts
 var DEFAULT_INPUT_SCHEMA = {
   type: "object",
   additionalProperties: true
@@ -28,5 +28,5 @@ function createToolSpec(opts) {
 exports.DEFAULT_INPUT_SCHEMA = DEFAULT_INPUT_SCHEMA;
 exports.DEFAULT_OUTPUT_SCHEMA = DEFAULT_OUTPUT_SCHEMA;
 exports.createToolSpec = createToolSpec;
-//# sourceMappingURL=chunk-3YLVPZRJ.cjs.map
-//# sourceMappingURL=chunk-3YLVPZRJ.cjs.map
+//# sourceMappingURL=chunk-SOFUWEZ6.cjs.map
+//# sourceMappingURL=chunk-SOFUWEZ6.cjs.map

package/dist/chunk-SOFUWEZ6.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/types/ToolSpec.ts"],"names":[],"mappings":";;;AAmFO,IAAM,oBAAA,GAA+B;AAAA,EAC1C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AAGO,IAAM,qBAAA,GAAgC;AAAA,EAC3C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AA2BO,SAAS,eAAe,IAAA,EAAuC;AACpE,EAAA,MAAM,UAAA,GAAa,KAAK,UAAA,IAAc,MAAA;AACtC,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,OAAA,EAAS,KAAK,OAAA,IAAW,OAAA;AAAA,IACzB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,aAAa,IAAA,CAAK,WAAA;AAAA,IAClB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,WAAA,EAAa,KAAK,WAAA,IAAe,oBAAA;AAAA,IACjC,YAAA,EAAc,KAAK,YAAA,IAAgB,qBAAA;AAAA,IACnC,cAAc,IAAA,CAAK,YAAA;AAAA,IACnB,WAAW,IAAA,CAAK,SAAA;AAAA,IAChB,KAAA,EAAO,EAAE,IAAA,EAAM,EAAE,YAAW;AAAE,GAChC;AACF","file":"chunk-SOFUWEZ6.cjs","sourcesContent":["/**\n * Unified tool kinds supported by the tools package.\n */\nexport type ToolKind = \"mcp\" | \"langchain\" | \"n8n\" | \"comfyui\" | \"skill\" | \"function\" | \"core\" | \"example\";\n\n/**\n * Capability declarations for tools.\n * Used by PolicyEngine for permission gating.\n */\nexport type Capability =\n  | \"read:web\"\n  | \"read:fs\"\n  | \"write:fs\"\n  | \"read:db\"\n  | \"write:db\"\n  | \"network\"\n  | \"gpu\"\n  | \"workflow\"\n  | \"danger:destructive\"\n  | \"exec\";\n\n/**\n * HITL (Human-in-the-Loop) side-effect classification.\n * Used to gate execution: external_write / destructive require human approval when onApprovalRequired is set.\n */\nexport type HitlSideEffect = \"none\" | \"local_write\" | \"external_write\" | \"destructive\";\n\n/**\n * Cost hints for tools, used by Budget and routing.\n */\nexport interface CostHints {\n  latencyMsP50?: number;\n  latencyMsP95?: number;\n  isAsync?: boolean;\n}\n\n/**\n * Unified tool specification.\n * All tool types (MCP, LangChain, n8n, SKILL) are described by this interface.\n *\n * Safety: each tool declares capabilities (permission gating) and _meta.hitl.sideEffect\n * (HITL approval for external_write/destructive). Caller uses these to decide handling.\n */\nexport interface ToolSpec {\n  /** Globally unique name, recommended format: namespace/name */\n  name: string;\n  /** Semver version */\n  version: string;\n  /** Tool kind determines which adapter handles execution */\n  kind: ToolKind;\n\n  description?: string;\n  tags?: string[];\n\n  /** JSON Schema for input validation */\n  inputSchema: object;\n  /** JSON Schema for output validation */\n  outputSchema: object;\n\n  /** Required capabilities for this tool (safety: PolicyEngine gates by ExecContext.permissions) */\n  capabilities: Capability[];\n  costHints?: CostHints;\n\n  /** HITL and adapter-specific metadata. Adapters may use _meta.sourcePath, _meta.exportName, _meta.projectPath (function), etc. */\n  _meta?: {\n    hitl?: { sideEffect?: HitlSideEffect };\n    /** Function kind: path to source file relative to projectPath */\n    sourcePath?: string;\n    /** Function kind: export name of the handler */\n    exportName?: string;\n    /** Function/skill kind: project root for resolving sourcePath */\n    projectPath?: string;\n  };\n\n  /** Adapter-specific: endpoint URL (MCP/n8n) */\n  endpoint?: string;\n  /** Adapter-specific: resource identifier (workflowId, promptId, etc.) */\n  resourceId?: string;\n  /** Adapter-specific: implementation reference (LangChain Tool instance, skill handler) */\n  impl?: unknown;\n}\n\n/** Default permissive input schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_INPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/** Default permissive output schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_OUTPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/**\n * Minimal options to build a ToolSpec. Use with @effect in JSDoc for HITL sideEffect.\n * Framework fills _meta.hitl.sideEffect from the sideEffect parameter (matches @effect annotation).\n * inputSchema/outputSchema are optional: when omitted, permissive defaults are used (framework supports auto-derived schema at build time in scan/mcp-build).\n */\nexport interface CreateToolSpecOptions {\n  name: string;\n  version?: string;\n  kind: ToolKind;\n  description?: string;\n  tags?: string[];\n  /** Optional: when omitted, DEFAULT_INPUT_SCHEMA is used. Codegen can derive from handler params. */\n  inputSchema?: object;\n  /** Optional: when omitted, DEFAULT_OUTPUT_SCHEMA is used. Codegen can derive from handler return type. */\n  outputSchema?: object;\n  capabilities: Capability[];\n  costHints?: CostHints;\n  /** HITL: from @effect annotation (none | local_write | external_write | destructive). Default \"none\". */\n  sideEffect?: HitlSideEffect;\n}\n\n/**\n * Build a ToolSpec from minimal options. Use @effect in handler JSDoc as annotation; pass same value as sideEffect.\n * When inputSchema/outputSchema are omitted, permissive defaults are used (schema can be auto-derived at build time).\n */\nexport function createToolSpec(opts: CreateToolSpecOptions): ToolSpec {\n  const sideEffect = opts.sideEffect ?? \"none\";\n  return {\n    name: opts.name,\n    version: opts.version ?? \"1.0.0\",\n    kind: opts.kind,\n    description: opts.description,\n    tags: opts.tags,\n    inputSchema: opts.inputSchema ?? DEFAULT_INPUT_SCHEMA,\n    outputSchema: opts.outputSchema ?? DEFAULT_OUTPUT_SCHEMA,\n    capabilities: opts.capabilities,\n    costHints: opts.costHints,\n    _meta: { hitl: { sideEffect } },\n  };\n}\n\n/**\n * Unified adapter interface.\n * Each tool kind has its own invoke path; PTCRuntime looks up adapter by spec.kind and calls adapter.invoke(spec, args, ctx).\n * Implementations: core/example (extensions), mcp (MCPClientAdapter); function/skill/n8n/langchain in-process adapters TBD (see tools/README and ToolTypeHandler).\n */\nexport interface ToolAdapter {\n  kind: ToolKind;\n  /** Optional: supports dynamic tool discovery */\n  listTools?(): Promise<ToolSpec[]>;\n  /** Execute the tool with validated args */\n  invoke(\n    spec: ToolSpec,\n    args: unknown,\n    ctx: import(\"./ToolIntent.js\").ExecContext,\n  ): Promise<{ result: unknown; raw?: unknown }>;\n}\n"]}