@easynet/agent-tool 1.0.0 → 1.0.2

package/README.md

@@ -1,103 +1,120 @@
-# Agent Tool
+# @easynet/agent-tool
+
+Agent tool runtime: unified registration, policy, budget, and observability. Multiple tool sources; expose as LangChain tools, MCP service, or OpenAPI HTTP.
+
+## Capabilities
+
+| Category | Name | Description |
+|----------|------|-------------|
+| **Tool sources** | `@tool` functions | Annotated tool functions in TS/JS |
+| | SKILL | Skills described in SKILL.md |
+| | n8n workflows | Workflow nodes as tools |
+| | MCP service | Remote tools via MCP protocol |
+| | LangChain directory | LangChain-format tool directory |
+| **Runtime** | PTCRuntime | Tool invocation execution |
+| | Policy engine | Pre-execution policy checks |
+| | Schema validation | Input/output validation |
+| | Budget | Call quotas and limits |
+| | Retry | Automatic retry for retryable errors |
+| | Evidence | Call logging and audit |
+| **Exposure** | LangChain tools | For createReactAgent / AgentExecutor |
+| | MCP service (stdio) | For Cursor / Claude etc. MCP clients |
+| | MCP service (Streamable HTTP) | HTTP + SSE, MCP Streamable HTTP (stateless) |
+| | OpenAPI HTTP (GET /tools, POST /invoke) | REST API for any HTTP client |
+
+## Install
 
-**自动把你任意的 function 和 SKILL，转换为 tool，链接到任何 LLM model 和 agent。**
-
----
-
-## 支持什么
-
-| 来源 | 写法 |
-|------|------|
-| **任意函数** | 添加 `@tool` annotation 秒变 MCP tool |
-| **SKILL** | 全面支持 [SKILL](docs/AGENT_SKILLS_SPEC.md)，不再依赖 Claude，支持任意 LLM |
-| **mcp.json** | 桥接其他 MCP |
-
----
-
-## 快速启动
+```bash
+npm i @easynet/agent-tool
+```
 
-1. **安装**（Node 18+）
+## Usage
 
-   ```bash
-   npm install @easynet/agent-tool
-   ```
+### 1. CLI
 
-2. **编译**：在项目目录执行，输出到 `dist/`
+```bash
+# List tools from current project config
+npx agent-tool ls
 
-   ```bash
-   agent-tool build
-   ```
+# Show tool details
+npx agent-tool describe <scope/name>
 
-3. **发布**（可选）：进 `dist/` 发布为自己的 npm 包
+# Run a tool locally
+npx agent-tool run <scope/name> '<{"key":"value"}>'
 
-   ```bash
-   cd dist && npm publish
-   ```
+# MCP standalone package: init → build → serve
+npx agent-tool init
+npx agent-tool build --path . --out dist
+npx agent-tool serve --path dist
+```
 
-4. **运行**：进 `dist/` 后按正常 `npm start` 启动 MCP
+### 2. Configure tool.yaml
 
-   ```bash
-   cd dist && npm install && npm start
-   ```
+Place `tool.yaml` at project root to list tools (used by `createAgentTools` and `agent-tool ls`):
 
-5. **安装自己的包**：发布后可在任意项目 `npm install <你的包名>` 安装使用。
+```yaml
+tools:
+  - npm:@easynet/agent-tool-builtin#fs.readText
+  - npm:@easynet/agent-tool-builtin#fs.writeText
+  # ...
+```
 
-用 Cursor / Claude 等 MCP 客户端连 `mcp.json` 即可。
+### 3. Programmatic: LangChain tools
 
----
+```ts
+import { createAgentTools } from "@easynet/agent-tool/api";
 
-## 代码示例
+const tools = createAgentTools({ configFilePath: "tool.yaml", coreTools: {} });
+// Use with createReactAgent / AgentExecutor
+```
 
-**@tool（TypeScript）**
+### 4. Programmatic: MCP service (stdio)
 
 ```ts
-/**
- * 两数相加。
- * @tool
- */
-export async function add(a: number, b: number): Promise<number> {
-  return a + b;
-}
+import { createMCPServer, createRuntimeFromConfigSync } from "@easynet/agent-tool/api";
+
+const { runtime } = createRuntimeFromConfigSync({ coreTools: {} });
+const server = createMCPServer(runtime);
+// runMCPServerOverStdio(server) or attach to stdio
 ```
 
-→ 生成的 MCP 工具：  
-- 名：`example.add`（文件 `src/tools/example.ts` 时为 `src.tools.example.add`）  
-- 描述：两数相加  
-- 入参：`a` (number)、`b` (number)
+### 5. Programmatic: MCP service (Streamable HTTP)
 
-工具名由路径+函数名决定，如 `src/tools/math.ts` 的 `add` → `src.tools.math.add`。
+```ts
+import { createMCPStreamableHttpHandler, createMCPServerStreamableHttp, createRuntimeFromConfigSync } from "@easynet/agent-tool/api";
 
-**SKILL**
+const { runtime } = createRuntimeFromConfigSync({ coreTools: {} });
 
-目录内放 `SKILL.md`（YAML 头：name、description）和可选的 `handler.js`。详见 [AGENT_SKILLS_SPEC](docs/AGENT_SKILLS_SPEC.md)。
+// Option A: handler only, mount on your HTTP server (use express.json() for body)
+const handler = createMCPStreamableHttpHandler(runtime);
+// app.use(express.json()); app.post("/mcp", handler);
 
-**示例与扩展**
+// Option B: get Express app and start
+const { app, path, listen } = await createMCPServerStreamableHttp(runtime, { path: "/mcp", port: 3000 });
+const { url } = await listen(3000);
+// Client: POST http://127.0.0.1:3000/mcp (MCP Streamable HTTP: SSE + direct response)
+```
 
-- 示例脚本与参考内容：`extensions/examples/`（ReAct 股票报告脚本、instruction-only skill、MCP 配置）。
-- 示例工具扩展（core 风格）：`extensions/example-tools/`（Yahoo Finance quote + chart；FS/HTTP 用 builtin-tools）。
+### 6. Programmatic: OpenAPI HTTP
 
-**运行 Agent（CLI 一条命令）**
+```ts
+import { createOpenAPIServer, createRuntimeFromConfigSync } from "@easynet/agent-tool/api";
 
-```bash
-# 需配置 OPENAI_API_KEY；MCP 模式需项目根或 MCP_CONFIG_PATH 下有 mcp.json
-agent-tool run "你的任务"                  # 默认 local（builtin + example 工具）
-agent-tool run "你的任务" --mode mcp       # MCP 模式（mcp.json 里的工具）
-agent-tool run "任务" -c agent.yaml        # 用 YAML 指定要加载的 tool 名字
-agent-tool run "任务" --mode mcp --report out.html
+const { runtime } = createRuntimeFromConfigSync({ coreTools: {} });
+const { app } = createOpenAPIServer(runtime, { basePath: "/api" });
+// Express-compatible app: GET /api/tools, POST /api/invoke
 ```
 
-- `run`：执行 ReAct agent，第一个参数为任务，`--mode local|mcp` 选工具来源，`--config` / `-c` 指定 agent YAML，`--report` 指定报告路径。
-- **Agent YAML**：在 `agent.yaml` 里写 `mode` 和要加载的 **tool 名字**，framework 自动按名加载。示例见 `agent.yaml.example`：
-  - `tools: [core/fs.readText, core/fs.listDir, example/finance.yahoo.quote]` 只加载列出的工具；
-  - 支持 npm 描述符：`npm:@scope/package#toolPath`，如 `npm:@easynet/agent-tool-builtin-tools#fs.readText` → `core/fs.readText`；
-  - 或 `tools: { builtin: [fs, http], example: true }` 按组加载。
-- `serve`：启动生成的 MCP 服务（stdio，用于测试）：`agent-tool serve` 或 `agent-tool serve -p ./dist`。
-- 股票示例：`npm run agent:stock AAPL`（需先 `npm run build`）。
+## Entrypoints
 
-**MCP 模式**：`agent-tool run "任务" --mode mcp`。Framework 读取当前目录或 `MCP_CONFIG_PATH` 下的 `mcp.json`，按配置用 stdio 启动 MCP server 并连接，将 MCP 工具转为 LangChain 工具供 agent 使用。
+| Entry | Purpose |
+|-------|---------|
+| `@easynet/agent-tool` | Core types, Runtime, Registry, discovery, MCP client, extensions |
+| `@easynet/agent-tool/api` | createAgentTools, createMCPServer, createMCPStreamableHttpHandler, createMCPServerStreamableHttp, createOpenAPIServer, createRuntimeFromConfig |
+| `@easynet/agent-tool/core` | PTCRuntime, PolicyEngine, SchemaValidator, ToolSpec, etc. |
+| `@easynet/agent-tool/runtime` | Same as core runtime subpath |
 
-- **用法**：`npm run agent -- --mode mcp "任务" [report.html]`。mcp.json 由用户配置（command、args、cwd），指向你要用的 MCP server。
-- **mcp.json**：`scripts/mcp.json` 为 Cursor 格式示例；裸配置见 `scripts/mcp-agent-tool.json`。将 `command`/`args` 改为你的 MCP 启动命令即可。
-- 环境变量：`AGENT_MODE`、`MCP_CONFIG_PATH`、`AGENT_TASK`、`AGENT_SYSTEM`、`OPENAI_API_KEY` 等。
+## Requirements
 
-**Release (npmjs.org)**：Publish runs when you **push to branch `master`**, or manually: open **Actions** → select **Release** → **Run workflow**. Add **NPM_TOKEN** (npm Automation or Publish token for @easynet) in repo **Settings → Secrets and variables → Actions**.
+- Node.js >= 18
+- For LangChain: install `langchain`, `@langchain/core`, `zod`. For MCP: install `@modelcontextprotocol/sdk` (see package peerDependencies).

package/dist/api/adapters/LangChainToolsHub.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Exposes all tools from a ToolRegistry + PTCRuntime as LangChain tools
+ * for local agent use (e.g. with createReactAgent, AgentExecutor).
+ *
+ * For most users, use createAgentTools() which loads from tools.yaml and returns
+ * StructuredTool[]. Use LangChainToolsHub when you need a custom runtime or ctxFactory.
+ *
+ * Use: new LangChainToolsHub(runtime, ctxFactory).getLangChainTools()
+ */
+import { type StructuredToolInterface } from "@langchain/core/tools";
+import type { PTCRuntime } from "../../core/runtime/PTCRuntime.js";
+import type { ExecContext } from "../../core/types/ToolIntent.js";
+export type ExecContextFactory = () => ExecContext;
+/**
+ * Hub that wraps PTCRuntime and exposes every registered tool as a LangChain
+ * StructuredTool (DynamicStructuredTool), so local agents (LangChain AgentExecutor,
+ * createReactAgent, etc.) can use the same tools as MCP and OpenAPI.
+ */
+export declare class LangChainToolsHub {
+    private readonly runtime;
+    private readonly ctxFactory;
+    constructor(runtime: PTCRuntime, ctxFactory?: ExecContextFactory);
+    /**
+     * Returns all registered tools as LangChain StructuredTool[].
+     * Each tool invokes the runtime through the full pipeline (policy, HITL, etc.).
+     */
+    getLangChainTools(): StructuredToolInterface[];
+    /**
+     * Returns LangChain tools for a subset of tools (by name or query).
+     */
+    getLangChainToolsForNames(toolNames: string[]): StructuredToolInterface[];
+    private specToLangChainTool;
+}
+//# sourceMappingURL=LangChainToolsHub.d.ts.map

package/dist/api/adapters/LangChainToolsHub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LangChainToolsHub.d.ts","sourceRoot":"","sources":["../../../src/api/adapters/LangChainToolsHub.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAyB,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAIlE,MAAM,MAAM,kBAAkB,GAAG,MAAM,WAAW,CAAC;AAiBnD;;;;GAIG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,OAAO,EAAE,UAAU,EACnB,UAAU,GAAE,kBAAwC;IAGvE;;;OAGG;IACH,iBAAiB,IAAI,uBAAuB,EAAE;IAO9C;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,uBAAuB,EAAE;IAOzE,OAAO,CAAC,mBAAmB;CAgC5B"}

package/dist/api/createAgentTools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Create LangChain tools from config (sync or async). Uses PTCRuntime + registry
+ * and exposes tools via LangChainToolsHub. All invokes go through PTC Intent.
+ */
+import type { CreateRuntimeOptions } from "./runtimeFromConfig.js";
+import type { StructuredToolInterface } from "@langchain/core/tools";
+export interface CreateAgentToolsOptions extends CreateRuntimeOptions {
+    /** Path to tool.yaml; when set, only tools listed there are returned; sandboxedPath from it is used as sandboxRoot */
+    configFilePath?: string;
+    /** Project path for async loading (use createLangChainToolsAsync) */
+    projectPath?: string;
+}
+/**
+ * Create LangChain tools synchronously. When configFilePath is set, returns only
+ * tools listed in that file (and that exist in the registry). If tool.yaml has
+ * sandboxedPath, fs tools can only access that directory.
+ */
+export declare function createAgentTools(options?: CreateAgentToolsOptions | string): StructuredToolInterface[];
+/**
+ * Create LangChain tools asynchronously. Use when projectPath is set to load
+ * tools from the project before building the tool list.
+ */
+export declare function createLangChainToolsAsync(options?: CreateAgentToolsOptions): Promise<StructuredToolInterface[]>;
+//# sourceMappingURL=createAgentTools.d.ts.map

package/dist/api/createAgentTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAgentTools.d.ts","sourceRoot":"","sources":["../../src/api/createAgentTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,sHAAsH;IACtH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAcD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM,GACzC,uBAAuB,EAAE,CAkB3B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAgBpC"}

package/dist/api/expose/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Expose the same tools in multiple ways: LangChain, HTTP (OpenAPI), MCP server.
+ *
+ * - LangChain: createAgentTools() / LangChainToolsHub (already in llm/)
+ * - HTTP: createHttpService(runtime) -> { server, openApiSpec, listen() }
+ * - MCP: createMCPServer(runtime) -> { server, connectStdio() }
+ */
+export { toolsToOpenAPISpec } from "./openapi.js";
+export type { OpenAPISpecOptions } from "./openapi.js";
+export { createHttpService, createOpenAPIHttpServer, listenOpenAPIHttpServer, } from "./openapiHttp.js";
+export type { CreateHttpServiceOptions, HttpServiceResult, OpenAPIHttpServerOptions, } from "./openapiHttp.js";
+export { createMCPServer, runMCPServerOverStdio, createMCPStreamableHttpHandler, createMCPServerStreamableHttp, } from "./mcpServer.js";
+export type { MCPServerOptions, MCPServerResult, MCPStreamableHttpHandler, MCPServerStreamableHttpResult, CreateMCPServerStreamableHttpOptions, } from "./mcpServer.js";
+export { initProject, buildMcpPackage, buildFunctionToTool, runMcpServer, runGeneratedMCP } from "./mcp-build/index.js";
+export type { InitOptions, BuildOptions, RunOptions, ScanOptions, BuildResult, SideEffect, MCPToolSpec, FunctionToolSpec, SkillToolSpec, N8nToolSpec, } from "./mcp-build/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/expose/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/expose/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,wBAAwB,EACxB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,oCAAoC,GACrC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxH,YAAY,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,sBAAsB,CAAC"}

package/dist/api/expose/mcp-build/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/mcp-build/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uHAAuH;IACvH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAqCtF;AAED,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,wBAAkB,CAAC"}

package/dist/{codegen → api/expose/mcp-build}/generator.d.ts

@@ -1,11 +1,11 @@
 /**
  * Generate MCP server entrypoint, tool-specs.json, invokers for function/skill/n8n.
- * Templates are loaded from ./templates/ (shipped next to this module or in dist/templates).
+ * Accepts unified ToolSpec[] (reads _meta.sourcePath/exportName, endpoint for codegen).
  */
-import type { MCPToolSpec } from "./types.js";
+import type { ToolSpec } from "../../../core/types/ToolSpec.js";
 /** Write generated files into outDir. projectPath is the folder containing source. */
 export declare function generate(options: {
-    specs: MCPToolSpec[];
+    specs: ToolSpec[];
     outDir: string;
     projectPath: string;
 }): Promise<{

package/dist/api/expose/mcp-build/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/mcp-build/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AA4FhE,sFAAsF;AACtF,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACtC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA2FtD"}

package/dist/api/expose/mcp-build/index.d.ts

@@ -0,0 +1,8 @@
+export { initProject } from "./init.js";
+export type { InitOptions } from "./init.js";
+export { buildMcpPackage, buildFunctionToTool } from "./build.js";
+export type { BuildOptions } from "./build.js";
+export { runMcpServer, runGeneratedMCP } from "./run.js";
+export type { RunOptions } from "./run.js";
+export type { SideEffect, MCPToolSpec, FunctionToolSpec, SkillToolSpec, N8nToolSpec, ScanOptions, BuildResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/expose/mcp-build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/mcp-build/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/api/expose/mcp-build/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/mcp-build/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqFD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoBpH"}

package/dist/api/expose/mcp-build/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/mcp-build/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAI3C,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAA;CAAE,CAAC,CAkC3G;AAED,oCAAoC;AACpC,eAAO,MAAM,eAAe,qBAAe,CAAC"}

package/dist/api/expose/mcp-build/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Types for MCP build: re-export scan types and add build-specific options/result.
+ */
+export type { SideEffect, MCPToolSpec, FunctionToolSpec, SkillToolSpec, N8nToolSpec, } from "../../../tools/discoveryFactory.js";
+/** Options for scanning a folder for @tool functions (used by MCP build). */
+export interface ScanOptions {
+    /** Project root (folder containing tsconfig or source). */
+    projectPath: string;
+    /** Glob or path pattern for TS files (default: "src/**\/*.ts"). */
+    include?: string[];
+    /** Path to tsconfig.json (default: projectPath/tsconfig.json). */
+    tsconfigPath?: string;
+}
+/** Result of a full build (scan + generate). */
+export interface BuildResult {
+    /** Path to the generated output directory. */
+    outDir: string;
+    /** Number of tools discovered. */
+    toolCount: number;
+    /** Path to generated mcp-server entry (e.g. mcp-server.js or mcp-server.ts). */
+    entryPath: string;
+    /** Path to generated mcp.json (command/args to run the server). */
+    mcpJsonPath: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/expose/mcp-build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/mcp-build/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,oCAAoC,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/api/expose/mcpServer.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Expose tools as an MCP server (stdio or Streamable HTTP). All invokes go through PTCRuntime.invoke(intent, ctx).
+ * Requires @modelcontextprotocol/sdk.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { PTCRuntime } from "../../core/runtime/PTCRuntime.js";
+import type { ExecContext } from "../../core/types/ToolIntent.js";
+import type { CreateRuntimeOptions } from "../runtimeFromConfig.js";
+export interface MCPServerOptions {
+    /** Server name (default: "agent-tool") */
+    name?: string;
+    /** Server version (default: "1.0.0") */
+    version?: string;
+    /** Build ExecContext for each tool call (default: minimal ctx) */
+    execContextFactory?: () => ExecContext;
+}
+export interface MCPServerResult {
+    /** The MCP server instance */
+    server: {
+        connect(transport: unknown): Promise<void>;
+        close?(): Promise<void>;
+    };
+    /** Call this to start listening on stdio (for in-process MCP service) */
+    connectStdio: () => Promise<void>;
+}
+/** Request handler for Streamable HTTP: (req, res, parsedBody?) => Promise<void>. Use with Express app.post(path, handler) and express.json(). */
+export type MCPStreamableHttpHandler = (req: IncomingMessage, res: ServerResponse, parsedBody?: unknown) => Promise<void>;
+export interface MCPServerStreamableHttpResult {
+    /** Express app with POST /mcp (or path) wired to Streamable HTTP handler */
+    app: {
+        post: (path: string, handler: MCPStreamableHttpHandler) => void;
+    };
+    /** Path mounted (e.g. "/mcp") */
+    path: string;
+    /** Start HTTP server; returns when listening. Use createMCPStreamableHttpHandler + your own server if you prefer. */
+    listen: (port?: number, host?: string) => Promise<{
+        url: string;
+        port: number;
+    }>;
+}
+/**
+ * Create an MCP server that serves all tools from the given PTCRuntime.
+ * Register tools with the server; then call connectStdio() to listen on stdio (for Cursor/Claude).
+ */
+export declare function createMCPServer(runtime: PTCRuntime, options?: MCPServerOptions): Promise<MCPServerResult>;
+/**
+ * Create an MCP server from config (async: loads tools from projectPath when set).
+ */
+export declare function createMCPServer(config: CreateRuntimeOptions, options?: MCPServerOptions): Promise<MCPServerResult>;
+/**
+ * Create a request handler for MCP Streamable HTTP (stateless). Use with Express: app.use(express.json()); app.post("/mcp", handler).
+ * Each request gets a new server and transport; supports SSE and direct HTTP responses per MCP Streamable HTTP spec.
+ */
+export declare function createMCPStreamableHttpHandler(runtime: PTCRuntime, options?: MCPServerOptions): MCPStreamableHttpHandler;
+export declare function createMCPStreamableHttpHandler(config: CreateRuntimeOptions, options?: MCPServerOptions): Promise<MCPStreamableHttpHandler>;
+export interface CreateMCPServerStreamableHttpOptions extends MCPServerOptions {
+    /** Path for MCP endpoint (default: "/mcp") */
+    path?: string;
+    /** Host to bind (default: "127.0.0.1") */
+    host?: string;
+    /** Port (default: 3000) */
+    port?: number;
+}
+/**
+ * Create an Express app with MCP Streamable HTTP handler mounted at path. Requires @modelcontextprotocol/sdk (which uses express).
+ * Returns app and listen(port?, host?) to start the HTTP server.
+ */
+export declare function createMCPServerStreamableHttp(runtime: PTCRuntime, options?: CreateMCPServerStreamableHttpOptions): Promise<MCPServerStreamableHttpResult>;
+export declare function createMCPServerStreamableHttp(config: CreateRuntimeOptions, options?: CreateMCPServerStreamableHttpOptions): Promise<MCPServerStreamableHttpResult>;
+/**
+ * Run MCP server over stdio using the given runtime.
+ * Call this when your process should act as an MCP server (e.g. for Cursor/Claude to connect).
+ */
+export declare function runMCPServerOverStdio(runtime: PTCRuntime, options?: MCPServerOptions): Promise<MCPServerResult>;
+//# sourceMappingURL=mcpServer.d.ts.map

package/dist/api/expose/mcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../../src/api/expose/mcpServer.ts"],"names":[],"mappings":"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"}

package/dist/api/expose/openapi.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Expose tools as OpenAPI (Swagger) spec and optional HTTP server.
+ * Same tools can be used via LangChain, MCP, or REST.
+ */
+import type { ToolRegistry } from "../../core/registry/ToolRegistry.js";
+export interface OpenAPISpecOptions {
+    /** API title (default: "Tool API") */
+    title?: string;
+    /** API version (default: "1.0.0") */
+    version?: string;
+    /** Base path for the API (default: "") */
+    basePath?: string;
+}
+/** Tool name to URL path segment: "core/fs.readText" -> "core~fs.readText" */
+export declare function toolNameToSlug(name: string): string;
+/** URL path segment back to tool name: "core~fs.readText" -> "core/fs.readText" */
+export declare function slugToToolName(slug: string): string;
+/**
+ * Build OpenAPI 3.0 document from the tool registry.
+ * GET /tools, POST /invoke (generic), and one POST /invoke/{toolSlug} per tool with that tool's input schema.
+ */
+export declare function toolsToOpenAPISpec(registry: ToolRegistry, options?: OpenAPISpecOptions): Record<string, unknown>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/api/expose/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/api/expose/openapi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAIxE,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAsBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2HzB"}

package/dist/api/expose/openapiHttp.d.ts

@@ -0,0 +1,67 @@
+/**
+ * HTTP server that exposes tools via OpenAPI (Swagger): GET / (Swagger UI), GET /openapi.json, GET /tools, POST /invoke.
+ * All invokes go through PTCRuntime.invoke(intent, ctx). Uses Node's built-in http.
+ */
+import { type IncomingMessage } from "node:http";
+import type { PTCRuntime } from "../../core/runtime/PTCRuntime.js";
+import type { ExecContext } from "../../core/types/ToolIntent.js";
+import type { CreateRuntimeOptions } from "../runtimeFromConfig.js";
+export interface OpenAPIHttpServerOptions {
+    /** Port (default: 0 = let OS choose) */
+    port?: number;
+    /** Host (default: "localhost") */
+    host?: string;
+    /** Base path for routes (default: "") */
+    basePath?: string;
+    /** Build ExecContext for each request (default: minimal ctx) */
+    execContextFactory?: (req: IncomingMessage) => ExecContext;
+}
+/**
+ * Create an HTTP server that exposes tools via OpenAPI-style routes.
+ * - GET / or GET /swagger: Swagger UI (interactive docs)
+ * - GET /openapi.json (or basePath/openapi.json): OpenAPI 3.0 spec
+ * - GET /tools: list tools
+ * - POST /invoke: body { tool, args } -> { result } or { error }
+ */
+export declare function createOpenAPIHttpServer(runtime: PTCRuntime, options?: OpenAPIHttpServerOptions): import("node:http").Server;
+/**
+ * Start the OpenAPI HTTP server on the given port/host.
+ * Call after createOpenAPIHttpServer if you did not pass port in options.
+ */
+export declare function listenOpenAPIHttpServer(server: import("node:http").Server, options?: {
+    port?: number;
+    host?: string;
+}): Promise<{
+    port: number;
+    host: string;
+}>;
+export interface HttpServiceResult {
+    /** Node HTTP server (call .close() when done) */
+    server: import("node:http").Server;
+    /** OpenAPI 3.0 spec document (for Swagger UI etc.) */
+    openApiSpec: Record<string, unknown>;
+    /** Start listening; returns { port, host } */
+    listen: (options?: {
+        port?: number;
+        host?: string;
+    }) => Promise<{
+        port: number;
+        host: string;
+    }>;
+}
+export interface CreateHttpServiceOptions extends OpenAPIHttpServerOptions {
+    /** API title for OpenAPI spec (default: "Tool API") */
+    title?: string;
+    /** API version for OpenAPI spec (default: "1.0.0") */
+    version?: string;
+}
+/**
+ * Create HTTP service that exposes tools via OpenAPI (Swagger).
+ * Returns server, OpenAPI spec, and a listen() helper.
+ */
+export declare function createHttpService(runtime: PTCRuntime, options?: CreateHttpServiceOptions): Promise<HttpServiceResult>;
+/**
+ * Create HTTP service from config (async: loads tools from projectPath when set).
+ */
+export declare function createHttpService(config: CreateRuntimeOptions, options?: CreateHttpServiceOptions): Promise<HttpServiceResult>;
+//# sourceMappingURL=openapiHttp.d.ts.map

package/dist/api/expose/openapiHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapiHttp.d.ts","sourceRoot":"","sources":["../../../src/api/expose/openapiHttp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,eAAe,EAAuB,MAAM,WAAW,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIpE,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,WAAW,CAAC;CAC5D;AAqED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,wBAA6B,GACrC,OAAO,WAAW,EAAE,MAAM,CAsG5B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,WAAW,EAAE,MAAM,EAClC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAWzC;AAED,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,MAAM,EAAE,OAAO,WAAW,EAAE,MAAM,CAAC;IACnC,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,8CAA8C;IAC9C,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjG;AAED,MAAM,WAAW,wBAAyB,SAAQ,wBAAwB;IACxE,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE9B;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/api/main.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+var chunkBZOKPJMP_cjs = require('../chunk-BZOKPJMP.cjs');
+var chunkMGEQPAHV_cjs = require('../chunk-MGEQPAHV.cjs');
+var chunkFA2ZEICE_cjs = require('../chunk-FA2ZEICE.cjs');
+require('../chunk-ZNJBRLKN.cjs');
+require('../chunk-6F5JHLZ7.cjs');
+
+
+
+Object.defineProperty(exports, "createAgentTools", {
+  enumerable: true,
+  get: function () { return chunkBZOKPJMP_cjs.createAgentTools; }
+});
+Object.defineProperty(exports, "createLangChainToolsAsync", {
+  enumerable: true,
+  get: function () { return chunkBZOKPJMP_cjs.createLangChainToolsAsync; }
+});
+Object.defineProperty(exports, "createHttpService", {
+  enumerable: true,
+  get: function () { return chunkMGEQPAHV_cjs.createHttpService; }
+});
+Object.defineProperty(exports, "createMCPServer", {
+  enumerable: true,
+  get: function () { return chunkMGEQPAHV_cjs.createMCPServer; }
+});
+Object.defineProperty(exports, "createMCPServerStreamableHttp", {
+  enumerable: true,
+  get: function () { return chunkMGEQPAHV_cjs.createMCPServerStreamableHttp; }
+});
+Object.defineProperty(exports, "createMCPStreamableHttpHandler", {
+  enumerable: true,
+  get: function () { return chunkMGEQPAHV_cjs.createMCPStreamableHttpHandler; }
+});
+Object.defineProperty(exports, "createOpenAPIServer", {
+  enumerable: true,
+  get: function () { return chunkMGEQPAHV_cjs.createHttpService; }
+});
+Object.defineProperty(exports, "runMCPServerOverStdio", {
+  enumerable: true,
+  get: function () { return chunkMGEQPAHV_cjs.runMCPServerOverStdio; }
+});
+Object.defineProperty(exports, "PTCRuntime", {
+  enumerable: true,
+  get: function () { return chunkFA2ZEICE_cjs.PTCRuntime; }
+});
+Object.defineProperty(exports, "createRuntimeFromConfig", {
+  enumerable: true,
+  get: function () { return chunkFA2ZEICE_cjs.createRuntimeFromConfig; }
+});
+Object.defineProperty(exports, "createRuntimeFromConfigSync", {
+  enumerable: true,
+  get: function () { return chunkFA2ZEICE_cjs.createRuntimeFromConfigSync; }
+});
+//# sourceMappingURL=main.cjs.map
+//# sourceMappingURL=main.cjs.map

package/dist/api/main.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"main.cjs"}

package/dist/api/main.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Public API: three create functions (config-driven) + runtime.
+ *
+ * 1. createLangChainTools(config?) → LangChain tools (createReactAgent / AgentExecutor)
+ * 2. createMCPServer(runtime | config, options?) → MCP server (stdio, Cursor / Claude)
+ * 3. createOpenAPIServer(runtime | config, options?) → HTTP + OpenAPI/Swagger (GET /tools, POST /invoke)
+ *
+ * All tool invokes go through PTC Intent (runtime.invoke(intent, ctx)) for policy, budget, observability.
+ * Use createRuntimeFromConfig(config) when you need the runtime for multiple servers.
+ */
+export { createAgentTools, createLangChainToolsAsync } from "./createAgentTools.js";
+export type { CreateAgentToolsOptions } from "./createAgentTools.js";
+export { createHttpService } from "./expose/openapiHttp.js";
+export type { CreateHttpServiceOptions, HttpServiceResult, OpenAPIHttpServerOptions, } from "./expose/openapiHttp.js";
+/** Alias: OpenAPI server with Swagger support */
+export { createHttpService as createOpenAPIServer } from "./expose/openapiHttp.js";
+export { createMCPServer, runMCPServerOverStdio, createMCPStreamableHttpHandler, createMCPServerStreamableHttp, } from "./expose/mcpServer.js";
+export type { MCPServerOptions, MCPServerResult, MCPStreamableHttpHandler, MCPServerStreamableHttpResult, CreateMCPServerStreamableHttpOptions, } from "./expose/mcpServer.js";
+export { createRuntimeFromConfig, createRuntimeFromConfigSync } from "./runtimeFromConfig.js";
+export type { CreateRuntimeOptions, CreateRuntimeResult } from "./runtimeFromConfig.js";
+export { PTCRuntime } from "../core/runtime/PTCRuntime.js";
+export type { PTCRuntimeConfig } from "../core/runtime/PTCRuntime.js";
+//# sourceMappingURL=main.d.ts.map

package/dist/api/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/api/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACpF,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EACV,wBAAwB,EACxB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,iDAAiD;AACjD,OAAO,EAAE,iBAAiB,IAAI,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,oCAAoC,GACrC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC9F,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC"}