@botbotgo/kit 1.0.104

package/README.md

@@ -0,0 +1,65 @@
+# @botbotgo/kit
+
+## Introduction
+
+`@botbotgo/kit` loads `tool.yaml`, resolves tool extensions into LangChain-compatible tools, and registers them into the default `AgentContext`.
+
+## Exposed Interfaces
+
+| Export | Type | Purpose |
+| --- | --- | --- |
+| `createAgentTools` | root function | Load tools asynchronously from `tool.yaml`. |
+| `@botbotgo/kit/sdk` | subpath | SDK for building tool extensions. |
+| `ToolRegistry` | sdk export | Minimal registry for tool definitions. |
+| `createExtension` | sdk export | Create an extension package entry. |
+| `registerExtension` | sdk export | Register an extension into a runtime. |
+| `registerToolsFromManifest` | sdk export | Register tools from a manifest. |
+| `loadToolYaml` | sdk export | Load and parse `tool.yaml`. |
+| `resolveSandboxedPath` | sdk export | Resolve sandboxed filesystem paths. |
+| `validateUrl` | sdk export | Validate outbound URLs. |
+
+## Configuration
+
+The default config file is `config/tool.yaml`.
+
+```yaml
+apiVersion: botbotgo.world/v1
+kind: ToolConfig
+metadata:
+  name: agent-tool-default
+spec:
+  sandboxedPath: .
+  allowedHosts: []
+  blockedHosts: []
+  tools:
+    npm:@botbotgo/kit-builtin: {}
+```
+
+Key fields:
+
+- `spec.sandboxedPath`: filesystem root exposed to tools
+- `spec.allowedHosts`: HTTP allowlist
+- `spec.blockedHosts`: HTTP denylist
+- `spec.tools`: extension descriptors to load
+
+## Usage
+
+```bash
+npm i @botbotgo/kit
+```
+
+```ts
+import { createAgentTools } from "@botbotgo/kit";
+
+const tools = await createAgentTools("./config/tool.yaml");
+
+console.log(tools.map((tool) => tool.name));
+```
+
+Use `createAgentTools()` as the default application initializer. It matches the other async registration APIs (`createAgentModel`, `createAgentMemory`, runtime config loaders) and works cleanly with async extension loading.
+
+If you are building your own tool extension, use the SDK subpath:
+
+```ts
+import { createExtension } from "@botbotgo/kit/sdk";
+```

package/config/build/build.sh

@@ -0,0 +1,182 @@
+#!/bin/bash
+
+# Build script for @botbotgo/kit
+# This script builds the package and creates a zip file for distribution
+
+set -e  # Exit on error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Get version from package.json
+VERSION=$(node -p "require('./package.json').version")
+PACKAGE_NAME=$(node -p "require('./package.json').name")
+ZIP_NAME="${PACKAGE_NAME}-${VERSION}.zip"
+BUILD_DIR="build"
+TEMP_DIR="${BUILD_DIR}/package"
+
+echo -e "${GREEN}Building ${PACKAGE_NAME} v${VERSION}...${NC}"
+
+# Clean previous builds
+echo -e "${YELLOW}Cleaning previous builds...${NC}"
+rm -rf "${BUILD_DIR}"
+rm -f "${ZIP_NAME}"
+npm run clean
+
+# Build the project
+echo -e "${YELLOW}Building TypeScript...${NC}"
+npm run build
+
+# Verify build output
+if [ ! -d "dist" ]; then
+    echo -e "${RED}Error: dist directory not found after build${NC}"
+    exit 1
+fi
+
+# Create temporary package directory
+echo -e "${YELLOW}Preparing package...${NC}"
+mkdir -p "${TEMP_DIR}"
+
+# Copy necessary files
+echo -e "${YELLOW}Copying files...${NC}"
+cp -r dist "${TEMP_DIR}/"
+cp README.md "${TEMP_DIR}/"
+cp tool.yaml "${TEMP_DIR}/" 2>/dev/null || true
+cp agent.yaml.example "${TEMP_DIR}/" 2>/dev/null || true
+mkdir -p "${TEMP_DIR}/extensions" && cp -r extensions/examples "${TEMP_DIR}/extensions/" 2>/dev/null || true
+mkdir -p "${TEMP_DIR}/scripts"
+cp scripts/dump-tools.mjs "${TEMP_DIR}/scripts/" 2>/dev/null || true
+
+# Create a modified package.json for distribution (dump:tools doesn't need to build)
+# Copy package.json first, then modify the dump:tools script
+cp package.json "${TEMP_DIR}/package.json"
+# Use node to modify the package.json
+node -e "const fs=require('fs');const p=fs.readFileSync('${TEMP_DIR}/package.json','utf8');const j=JSON.parse(p);j.scripts=j.scripts||{};j.scripts['dump:tools']='node scripts/dump-tools.mjs';fs.writeFileSync('${TEMP_DIR}/package.json',JSON.stringify(j,null,2)+'\n');"
+
+# Create package.json for installation (optional: could include install instructions)
+cat > "${TEMP_DIR}/INSTALL.md" << 'EOF'
+# Installation Instructions
+
+## Important: Extract First!
+
+**npm cannot install directly from zip files.** You must extract the zip file first.
+
+## Installation Steps
+
+### Option 1: Local Installation (Recommended)
+
+1. **Extract the zip file:**
+   ```bash
+   unzip agent-tool-0.0.1.zip
+   ```
+
+2. **Navigate to the extracted directory:**
+   ```bash
+   cd package
+   ```
+
+3. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+4. **Install peer dependencies (if needed):**
+   ```bash
+   npm install @langchain/core @modelcontextprotocol/sdk
+   ```
+
+### Option 2: Global Installation
+
+1. **Extract the zip file:**
+   ```bash
+   unzip agent-tool-0.0.1.zip
+   ```
+
+2. **Install globally from the extracted directory:**
+   ```bash
+   npm install -g ./package
+   ```
+
+   Or if you're already in the extracted `package` directory:
+   ```bash
+   npm install -g .
+   ```
+
+### Option 3: Install as Dependency in Another Project
+
+1. **Extract the zip file to a location of your choice**
+
+2. **In your project, install from the extracted path:**
+   ```bash
+   npm install /path/to/extracted/package
+   ```
+
+## Dependencies
+
+This package requires:
+- Node.js >= 18.0.0
+- Optional peer dependencies:
+  - `@langchain/core` (>=0.3.0) - for LangChain tool support
+  - `@modelcontextprotocol/sdk` (>=1.0.0) - for MCP tool support
+
+Install peer dependencies as needed:
+```bash
+npm install @langchain/core @modelcontextprotocol/sdk
+```
+
+## Usage
+
+See README.md for usage instructions and examples.
+
+## Available Scripts
+
+After installation, you can use:
+
+- `npm run dump:tools` - Dump all discovered tools to JSON (requires tool.yaml in the current directory)
+
+**Note:** Make sure you're in the extracted `package/` directory when running npm scripts.
+EOF
+
+# Create zip file
+echo -e "${YELLOW}Creating zip file: ${ZIP_NAME}...${NC}"
+cd "${BUILD_DIR}"
+zip -r "../${ZIP_NAME}" package -q
+cd ..
+
+# Clean up temporary directory
+rm -rf "${BUILD_DIR}"
+
+# Display results
+FILE_SIZE=$(du -h "${ZIP_NAME}" | cut -f1)
+echo -e "${GREEN}✓ Build complete!${NC}"
+echo -e "${GREEN}  Package: ${ZIP_NAME}${NC}"
+echo -e "${GREEN}  Size: ${FILE_SIZE}${NC}"
+echo ""
+echo -e "${YELLOW}Package contents:${NC}"
+echo "  - dist/ (compiled JavaScript)"
+echo "  - package.json"
+echo "  - README.md"
+echo "  - tool.yaml, agent.yaml.example (example config)"
+echo "  - extensions/examples/ (example scripts and reference content)"
+echo "  - scripts/ (utility scripts)"
+echo "  - INSTALL.md (installation instructions)"
+echo ""
+echo -e "${GREEN}Installation Instructions:${NC}"
+echo ""
+echo -e "${YELLOW}⚠️  IMPORTANT: npm cannot install directly from zip files!${NC}"
+echo -e "${YELLOW}   You must extract the zip file first.${NC}"
+echo ""
+echo -e "${GREEN}To install:${NC}"
+echo "  1. Extract: unzip ${ZIP_NAME}"
+echo "  2. Navigate: cd package"
+echo "  3. Install: npm install"
+echo "  4. (Optional) Install peers: npm install @langchain/core @modelcontextprotocol/sdk"
+echo ""
+echo -e "${GREEN}For global installation:${NC}"
+echo "  1. Extract: unzip ${ZIP_NAME}"
+echo "  2. Install: npm install -g ./package"
+echo ""
+echo -e "${YELLOW}See INSTALL.md in the package for detailed instructions.${NC}"

package/config/build/tsconfig.dts.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": [
+      "ES2022"
+    ],
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "emitDeclarationOnly": true,
+    "outDir": "../../dist",
+    "rootDir": "../../src",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "baseUrl": "../..",
+    "paths": {}
+  },
+  "include": [
+    "../../src/**/*.ts"
+  ],
+  "exclude": [
+    "../../node_modules",
+    "../../dist",
+    "../../test",
+    "../../**/*.test.ts",
+    "../../extensions"
+  ]
+}

package/config/build/tsup.config.ts

@@ -0,0 +1,19 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: [
+    "src/index.ts",
+    "src/build.ts",
+    "src/sdk.ts",
+    "src/utils/cli/index.ts",
+  ],
+  format: ["esm", "cjs"],
+  dts: false,
+  splitting: true,
+  sourcemap: true,
+  clean: false,
+  treeshake: true,
+  target: "node18",
+  outDir: "dist",
+  external: ["langchain", "zod"],
+});

package/config/build/vitest.config.ts

@@ -0,0 +1,29 @@
+import { defineConfig } from "vitest/config";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+
+// Keep package self-references resolved to local dist build for tests.
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: "node",
+    // CI runners can be slower; avoid flaky 5s default timeouts on integration tests.
+    testTimeout: 20_000,
+    include: ["test/**/*.test.ts"],
+    coverage: {
+      provider: "v8",
+      include: ["src/**/*.ts"],
+      exclude: ["src/**/*.d.ts", "**/node_modules/**", "**/test/**"],
+    },
+  },
+  resolve: {
+    extensions: [".ts", ".js"],
+    preserveSymlinks: true,
+    alias: {
+      "@botbotgo/kit": path.join(root, "dist/index.js"),
+      "@botbotgo/kit/sdk": path.join(root, "dist/sdk.js"),
+    },
+  },
+});

package/config/tool.yaml

@@ -0,0 +1,11 @@
+apiVersion: botbotgo.world/v1
+kind: ToolConfig
+metadata:
+  name: agent-tool-default
+spec:
+  sandboxedPath: .
+  cacheDir: ~/.agent/cache
+  allowedHosts: []
+  blockedHosts: []
+  tools:
+    npm:@botbotgo/kit-builtin: {}

package/dist/agent-context.d.ts

@@ -0,0 +1,3 @@
+import { type AgentContext } from "@botbotgo/common";
+export declare function getDefaultAgentContext(): AgentContext;
+//# sourceMappingURL=agent-context.d.ts.map

package/dist/agent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAczE,wBAAgB,sBAAsB,IAAI,YAAY,CAQrD"}

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

@@ -0,0 +1,35 @@
+/**
+ * Exposes all tools from a ToolRegistry + PTCRuntime as LangChain tools
+ * for local agent use (e.g. with createReactAgent, AgentExecutor).
+ *
+ * For most users, use createAgentTools() from @botbotgo/kit, which loads from tool.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 buildModelToolNames;
+    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;AAE5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AA0DlE,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;IAQzE,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,mBAAmB;CAmB5B"}

package/dist/api/createAgentTools.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Standalone tool creation functions. Each function:
+ *  - Uses the embedded config/tool.yaml as the default base.
+ *  - If a configFilePath is provided, merges it on top of the default.
+ *  - If no options are provided at all, behaves as if only the embedded default is used.
+ *
+ * Public module API uses createAgentTools() in register-tools.ts.
+ * This file keeps internal builders for LangChain / MCP / OpenAPI outputs.
+ */
+import type { CreateRuntimeOptions } from "./runtimeFromConfig.js";
+import { type MCPServerOptions, type McpServer } from "./expose/mcpServer.js";
+import { type OpenAPIExpressApp, type OpenAPIHttpServerOptions } from "./expose/openapiHttp.js";
+import type { StructuredToolInterface } from "@langchain/core/tools";
+export interface CreateAgentToolsOptions extends CreateRuntimeOptions {
+    /** Path to an override tool.yaml; its values are merged on top of the embedded default config/tool.yaml */
+    configFilePath?: string;
+}
+/**
+ * Internal: create LangChain tools from config/runtime.
+ *
+ * - No argument → uses embedded default config/tool.yaml.
+ * - options.configFilePath → merged on top of embedded default.
+ * - All other CreateAgentToolsOptions (coreTools, etc.) are applied as programmatic overrides.
+ *
+ * @example
+ * Internal helper consumed by createAgentTools().
+ */
+export declare function createLangChainAgentTools(options?: CreateAgentToolsOptions | string): StructuredToolInterface[];
+export declare function createLangChainAgentToolsAsync(options?: CreateAgentToolsOptions | string): Promise<StructuredToolInterface[]>;
+/**
+ * Internal: create an MCP server from tool config.
+ *
+ * - No argument → uses embedded default config/tool.yaml.
+ * - options.configFilePath → merged on top of embedded default.
+ * - options.mcp → passed to the MCP server (name, version, execContextFactory).
+ *
+ * @example
+ * Internal helper consumed by createAgentTools() expose flows.
+ */
+export declare function createMcpServer(options?: (CreateAgentToolsOptions & MCPServerOptions) | string): Promise<McpServer>;
+/**
+ * Internal: create an OpenAPI / Swagger HTTP server from tool config.
+ *
+ * - No argument → uses embedded default config/tool.yaml.
+ * - options.configFilePath → merged on top of embedded default.
+ * - options.port, host, basePath → passed to the HTTP server; tool.yaml openapi: section provides defaults.
+ *
+ * @example
+ * Internal helper consumed by createAgentTools() expose flows.
+ */
+export declare function createOpenAPIServer(options?: (CreateAgentToolsOptions & OpenAPIHttpServerOptions) | string): Promise<OpenAPIExpressApp>;
+//# 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;;;;;;;;GAQG;AAcH,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EAAmB,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAOrE,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,2GAA2G;IAC3G,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAoRD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM,GACzC,uBAAuB,EAAE,CAa3B;AAED,wBAAsB,8BAA8B,CAClD,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM,GACzC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAsBpC;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,CAAC,uBAAuB,GAAG,gBAAgB,CAAC,GAAG,MAAM,GAC9D,OAAO,CAAC,SAAS,CAAC,CAWpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,CAAC,uBAAuB,GAAG,wBAAwB,CAAC,GAAG,MAAM,GACtE,OAAO,CAAC,iBAAiB,CAAC,CAW5B"}

package/dist/api/expose/extension-init/index.d.ts

@@ -0,0 +1,3 @@
+export { initExtension } from "./initExtension.js";
+export type { InitExtensionOptions } from "./initExtension.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/expose/extension-init/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/extension-init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/api/expose/extension-init/initExtension.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Scaffold a new agent-tool extension: folder, src, hello-world tool, generate-manifest, index, package.json.
+ * Use: agent-tool init <extension name> → then cd <name> && npm install && npm run build.
+ */
+export interface InitExtensionOptions {
+    /** Extension name (folder name to create). */
+    extensionName: string;
+    /** Parent directory (default: process.cwd()). */
+    parentDir?: string;
+    /** npm package scope (e.g. "wallee" → package name @wallee/<name>). Optional. */
+    scope?: string;
+}
+/**
+ * Create extension scaffold at parentDir/extensionName.
+ * Returns target path and list of created files.
+ */
+export declare function initExtension(options: InitExtensionOptions): Promise<{
+    targetPath: string;
+    filesCreated: string[];
+}>;
+//# sourceMappingURL=initExtension.d.ts.map

package/dist/api/expose/extension-init/initExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initExtension.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/extension-init/initExtension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8KD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuBzD"}

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

@@ -0,0 +1,16 @@
+/**
+ * Expose the same tools in multiple ways: LangChain, HTTP (OpenAPI), MCP server.
+ *
+ * - LangChain: await createAgentTools() / LangChainToolsHub
+ * - 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, OpenAPIExpressApp, 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, runMCPServer } 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,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,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClF,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

@@ -0,0 +1,21 @@
+/**
+ * MCP build: scan project for @tool, SKILL, n8n; generate MCP entrypoint and npm package.
+ */
+import type { BuildResult } from "./types.js";
+export interface BuildOptions {
+    /** Project root (folder to scan; default: cwd). */
+    projectPath?: string;
+    /** Output directory for generated files (default: projectPath/dist). */
+    outDir?: string;
+    /** Glob patterns for TS files (default: ["**\/*.ts"]). Used for @tool (TypeScript) scanning only. */
+    include?: string[];
+    /** Path to tsconfig.json (default: projectPath/tsconfig.json). Used for @tool scanning only. */
+    tsconfigPath?: string;
+    /** Include n8n (workflow.json) tools. Default false: we do not start or install n8n-local; set true if you use n8n. */
+    includeN8n?: boolean;
+}
+/**
+ * Scan project for all tools (@tool, SKILL, n8n); generate MCP server + tool-specs + invokers (npm package).
+ */
+export declare function buildMCPPackage(options?: BuildOptions): Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

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"}

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

@@ -0,0 +1,15 @@
+/**
+ * Generate MCP server entrypoint, tool-specs.json, invokers for function/skill/n8n.
+ * Accepts unified ToolSpec[] (reads _meta.sourcePath/exportName, endpoint for codegen).
+ */
+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: ToolSpec[];
+    outDir: string;
+    projectPath: string;
+}): Promise<{
+    entryPath: string;
+    mcpJsonPath: string;
+}>;
+//# sourceMappingURL=generator.d.ts.map

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;AA+FhE,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 } from "./build.js";
+export type { BuildOptions } from "./build.js";
+export { runMCPServer } 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,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,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

@@ -0,0 +1,17 @@
+/**
+ * Scaffold a new MCP tool project: @tool TS, SKILL sample, tsconfig, README.
+ * Use: init → build → run.
+ */
+export interface InitOptions {
+    /** Target directory to create project (default: cwd). */
+    targetPath?: string;
+}
+/**
+ * Create project template at targetPath. Writes tsconfig, src/tools/example.ts,
+ * skills/hello-skill (SKILL.md + handler.js), and README.
+ */
+export declare function initProject(options?: InitOptions): Promise<{
+    targetPath: string;
+    filesCreated: string[];
+}>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1,17 @@
+/**
+ * Run step: start the generated MCP server (stdio) for testing. Spawns entrypoint via npx tsx.
+ */
+import { spawn } from "node:child_process";
+export interface RunOptions {
+    /** Directory containing generated mcp-server (default: cwd or cwd/dist). */
+    path?: string;
+}
+/**
+ * Start the MCP server from the given directory.
+ * Expects mcp-server.ts and tool-specs.json there; runs via npx tsx mcp-server.ts.
+ * Returns a child process; caller should handle stdin/stdout and cleanup.
+ */
+export declare function runMCPServer(options?: RunOptions): Promise<{
+    process: ReturnType<typeof spawn>;
+}>;
+//# sourceMappingURL=run.d.ts.map

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"}

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"}