@botbotgo/kit 1.0.106

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

@@ -0,0 +1,74 @@
+/**
+ * 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";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export type { McpServer };
+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: McpServer;
+    /** 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":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,WAAW,CAAC;CACxC;AAWD,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,MAAM,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,kJAAkJ;AAClJ,MAAM,MAAM,wBAAwB,GAAG,CACrC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,UAAU,CAAC,EAAE,OAAO,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,6BAA6B;IAC5C,4EAA4E;IAC5E,GAAG,EAAE;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAA;KAAE,CAAC;IACzE,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,qHAAqH;IACrH,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClF;AA4DD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5B;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAAC;AAuB5B;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,gBAAgB,GACzB,wBAAwB,CAAC;AAE5B,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAsCrC,MAAM,WAAW,oCAAqC,SAAQ,gBAAgB;IAC5E,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,oCAAoC,GAC7C,OAAO,CAAC,6BAA6B,CAAC,CAAC;AAE1C,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,oCAAoC,GAC7C,OAAO,CAAC,6BAA6B,CAAC,CAAC;AAqC1C;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAI1B"}

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" (dots to ~ in path) */
+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,kGAAkG;AAClG,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,CAiBzB"}

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

@@ -0,0 +1,51 @@
+/**
+ * OpenAPI service on Express: GET / (Swagger UI), GET /openapi.json, GET /tools, POST /invoke.
+ * All invokes go through PTCRuntime.invoke(intent, ctx).
+ */
+import type { IncomingMessage } from "node:http";
+import { type Express } from "express";
+import type { PTCRuntime } from "../../core/runtime/PTCRuntime.js";
+import type { ExecContext } from "../../core/types/ToolIntent.js";
+import type { CreateRuntimeOptions } from "../runtimeFromConfig.js";
+export type OpenAPIExpressApp = Express;
+export interface OpenAPIHttpServerOptions {
+    port?: number;
+    host?: string;
+    basePath?: string;
+    execContextFactory?: (req: IncomingMessage) => ExecContext;
+}
+/**
+ * Create an Express app exposing OpenAPI routes.
+ */
+export declare function createOpenAPIHttpServer(runtime: PTCRuntime, options?: OpenAPIHttpServerOptions): OpenAPIExpressApp;
+export declare function listenOpenAPIHttpServer(app: OpenAPIExpressApp, options?: {
+    port?: number;
+    host?: string;
+}): Promise<{
+    port: number;
+    host: string;
+    httpServer: import("node:http").Server;
+}>;
+export interface HttpServiceResult {
+    /** Express app */
+    server: OpenAPIExpressApp;
+    /** OpenAPI 3.0 spec document */
+    openApiSpec: Record<string, unknown>;
+    /** Start listening */
+    listen: (options?: {
+        port?: number;
+        host?: string;
+    }) => Promise<{
+        port: number;
+        host: string;
+    }>;
+    /** Close underlying HTTP server after listen() */
+    close: () => Promise<void>;
+}
+export interface CreateHttpServiceOptions extends OpenAPIHttpServerOptions {
+    title?: string;
+    version?: string;
+}
+export declare function createHttpService(runtime: PTCRuntime, options?: CreateHttpServiceOptions): Promise<HttpServiceResult>;
+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,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAgB,EAAE,KAAK,OAAO,EAAkD,MAAM,SAAS,CAAC;AAChG,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;AAMpE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,WAAW,CAAC;CAC5D;AAoOD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAcnB;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,iBAAiB,EACtB,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,CAAC;IAAC,UAAU,EAAE,OAAO,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAWjF;AAED,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,sBAAsB;IACtB,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;IAChG,kDAAkD;IAClD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAyB,SAAQ,wBAAwB;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE9B,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/api/extension/contextRunner.d.ts

@@ -0,0 +1,10 @@
+export interface ContextRunner<T> {
+    runWith(ctx: T, fn: () => Promise<unknown>): Promise<unknown>;
+    getContext(): T;
+}
+/**
+ * Create a context runner for an extension. Handlers call getContext() to read config.
+ * Adapter calls runWith(ctx, () => handler(args)) so getContext() returns ctx.
+ */
+export declare function createContextRunner<T>(): ContextRunner<T>;
+//# sourceMappingURL=contextRunner.d.ts.map

package/dist/api/extension/contextRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextRunner.d.ts","sourceRoot":"","sources":["../../../src/api/extension/contextRunner.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,UAAU,IAAI,CAAC,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAczD"}

package/dist/api/extension/createExtension.d.ts

@@ -0,0 +1,38 @@
+import type { ToolAdapter } from "../../core/types/ToolSpec.js";
+import type { ToolRegistry } from "../../core/registry/ToolRegistry.js";
+import type { ExtensionToolContext } from "./support/types.js";
+/** Pass import.meta so the framework derives packagePath (extension entry does not need path/fileURLToPath). */
+export interface ImportMetaLike {
+    url: string;
+}
+/** Options when config is built from userConfig (buildConfig). */
+export interface CreateExtensionOptionsWithBuild<TConfig, TUserConfig> {
+    packagePath?: string;
+    importMeta?: ImportMetaLike;
+    kind?: string;
+    buildConfig: (userConfig: TUserConfig) => TConfig;
+}
+/** Options when config is per-tool only (each tool's tool.yaml). */
+export interface CreateExtensionOptionsDefaultOnly {
+    packagePath?: string;
+    importMeta?: ImportMetaLike;
+    kind?: string;
+}
+/** Register opts when using per-tool config only: filter tools by name. */
+export interface RegisterOptionsDefaultOnly {
+    only?: string[];
+    namePrefixes?: string[];
+}
+export type CreateExtensionOptions<TConfig, TUserConfig> = CreateExtensionOptionsWithBuild<TConfig, TUserConfig> | (CreateExtensionOptionsDefaultOnly & {
+    buildConfig?: never;
+});
+export interface CreateExtensionResult<TConfig, TUserConfig> {
+    register(registry: ToolRegistry, userConfigOrOpts: TUserConfig, options?: {
+        only?: string[];
+        namePrefixes?: string[];
+    }): ToolAdapter;
+    getContext(): ExtensionToolContext<TConfig>;
+    runWith<T>(ctx: ExtensionToolContext<TConfig>, fn: () => Promise<T>): Promise<T>;
+}
+export declare function createExtension<TConfig = Record<string, unknown>, TUserConfig = RegisterOptionsDefaultOnly>(options: CreateExtensionOptions<TConfig, TUserConfig>): CreateExtensionResult<TConfig, TUserConfig>;
+//# sourceMappingURL=createExtension.d.ts.map

package/dist/api/extension/createExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExtension.d.ts","sourceRoot":"","sources":["../../../src/api/extension/createExtension.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,gHAAgH;AAChH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,kEAAkE;AAClE,MAAM,WAAW,+BAA+B,CAAC,OAAO,EAAE,WAAW;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,OAAO,CAAC;CACnD;AAED,oEAAoE;AACpE,MAAM,WAAW,iCAAiC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,CAAC,OAAO,EAAE,WAAW,IACnD,+BAA+B,CAAC,OAAO,EAAE,WAAW,CAAC,GACrD,CAAC,iCAAiC,GAAG;IAAE,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAElE,MAAM,WAAW,qBAAqB,CAAC,OAAO,EAAE,WAAW;IACzD,QAAQ,CACN,QAAQ,EAAE,YAAY,EACtB,gBAAgB,EAAE,WAAW,EAC7B,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACrD,WAAW,CAAC;IACf,UAAU,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClF;AAYD,wBAAgB,eAAe,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,0BAA0B,EACzG,OAAO,EAAE,sBAAsB,CAAC,OAAO,EAAE,WAAW,CAAC,GACpD,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,CA4B7C"}

package/dist/api/extension/dynamicImportAdapter.d.ts

@@ -0,0 +1,25 @@
+import type { ToolAdapter, ToolSpec } from "../../core/types/ToolSpec.js";
+import type { ExecContext } from "../../core/types/ToolIntent.js";
+import type { Evidence } from "../../core/types/ToolResult.js";
+export interface ExtensionToolResult {
+    result: unknown;
+    evidence: Evidence[];
+}
+export interface DynamicImportAdapterOptions<TContext> {
+    kind: string;
+    packageRoot: string;
+    /**
+     * Build context from execCtx, spec, and merged request args.
+     * Framework merges defaultArgs (tool.yaml) with request args; implementor can merge into ctx.config
+     * so handlers read resolved config from context instead of re-resolving in each handler.
+     */
+    getExtensionContext: (execCtx: ExecContext, spec: ToolSpec, mergedArgs?: Record<string, unknown>) => TContext;
+    contextRunner: {
+        runWith(ctx: TContext, fn: () => Promise<ExtensionToolResult>): Promise<ExtensionToolResult>;
+    };
+}
+/**
+ * Create an adapter that loads handlers by spec._meta.sourcePath and exportName, then runs with extension context.
+ */
+export declare function createDynamicImportAdapter<TContext>(options: DynamicImportAdapterOptions<TContext>): ToolAdapter;
+//# sourceMappingURL=dynamicImportAdapter.d.ts.map

package/dist/api/extension/dynamicImportAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicImportAdapter.d.ts","sourceRoot":"","sources":["../../../src/api/extension/dynamicImportAdapter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAuB/D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B,CAAC,QAAQ;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,QAAQ,CAAC;IAC9G,aAAa,EAAE;QAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;KAAE,CAAC;CACjH;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EACjD,OAAO,EAAE,2BAA2B,CAAC,QAAQ,CAAC,GAC7C,WAAW,CA4Cb"}

package/dist/api/extension/generateExtensionManifest.d.ts

@@ -0,0 +1,29 @@
+export interface GenerateExtensionManifestOptions {
+    /** Project root (default: process.cwd()). */
+    projectRoot?: string;
+    /** Output directory for manifest and copied tool.yaml (default: projectRoot/dist). */
+    outDir?: string;
+    /** Manifest kind (default: "core"). */
+    kind?: string;
+    /** Include globs for TS files (default: all .ts). */
+    include?: string[];
+    /** Path to tsconfig (default: projectRoot/tsconfig.json). */
+    tsconfigPath?: string;
+    /** Subdirs to recursively copy *.tool.yaml and *.example.yaml from (e.g. ["src"]). */
+    copyToolYamlDirs?: string[];
+}
+/**
+ * Scan project for @tool, write core-tools-manifest.json and recursively copy *.tool.yaml and *.example.yaml to outDir.
+ * Returns the written manifest path and number of tools.
+ */
+export declare function generateExtensionManifest(projectRoot?: string, options?: GenerateExtensionManifestOptions): {
+    manifestPath: string;
+    toolsCount: number;
+    toolYamlCopied: number;
+};
+/**
+ * Build step for extensions: scan src folder and subfolders, emit manifest, copy tool.yaml.
+ * Call from extension's build script (e.g. tsx generate-manifest.ts).
+ */
+export declare function generateManifest(projectRoot?: string, options?: Omit<GenerateExtensionManifestOptions, "projectRoot">): void;
+//# sourceMappingURL=generateExtensionManifest.d.ts.map

package/dist/api/extension/generateExtensionManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateExtensionManifest.d.ts","sourceRoot":"","sources":["../../../src/api/extension/generateExtensionManifest.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gCAAgC;IAC/C,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAmBD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,GAAE,MAAsB,EACnC,OAAO,GAAE,gCAAqC,GAC7C;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAuDtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,GAAE,MAAsB,EACnC,OAAO,GAAE,IAAI,CAAC,gCAAgC,EAAE,aAAa,CAAM,GAClE,IAAI,CAQN"}

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

@@ -0,0 +1,23 @@
+/**
+ * Generic extension primitives: context runner, dynamic-import adapter, manifest registration.
+ * Used by extension packages (e.g. @botbotgo/kit-builtin) that are "just a normal extension".
+ */
+export { createContextRunner } from "./contextRunner.js";
+export type { ContextRunner } from "./contextRunner.js";
+export { createExtension } from "./createExtension.js";
+export type { CreateExtensionOptions, CreateExtensionResult, ImportMetaLike, RegisterOptionsDefaultOnly, } from "./createExtension.js";
+export { generateExtensionManifest, generateManifest, } from "./generateExtensionManifest.js";
+export type { GenerateExtensionManifestOptions } from "./generateExtensionManifest.js";
+export { createDynamicImportAdapter } from "./dynamicImportAdapter.js";
+export type { DynamicImportAdapterOptions, ExtensionToolResult, } from "./dynamicImportAdapter.js";
+export type { ExtensionToolContext, ExtensionToolHandler, } from "./support/types.js";
+export { loadToolYaml } from "./loadToolYaml.js";
+export { registerToolsFromManifest, loadExtensionManifest, } from "./registerFromManifest.js";
+export { registerExtension } from "./registerExtension.js";
+export type { RegisterExtensionOptions } from "./registerExtension.js";
+export type { ExtensionManifestEntry, LoadedExtensionManifest, RegisterFromManifestOptions, } from "./registerFromManifest.js";
+export { resolveExtensionPackageRoot } from "./resolvePackageRoot.js";
+export { overrideWithConfig } from "./overrideWithConfig.js";
+export { getGroupNamePrefixes } from "./support/groupPrefix.js";
+export type { GroupPrefixOptions, ResolvedOnlyNamePrefixes, } from "./support/groupPrefix.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/extension/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/api/extension/loadToolYaml.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Load tool.yaml for a given tool. Path: packageRoot / dirname(sourcePath) / basename(sourcePath).tool.yaml
+ * Returns default args (and config) for the tool, or undefined if file missing or no matching entry.
+ * If tool.defaults exists (same level as tool.list), it is merged first; list item fields override.
+ */
+export declare function loadToolYaml(packageRoot: string, sourcePath: string): Record<string, unknown> | undefined;
+//# sourceMappingURL=loadToolYaml.d.ts.map

package/dist/api/extension/loadToolYaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadToolYaml.d.ts","sourceRoot":"","sources":["../../../src/api/extension/loadToolYaml.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAiCrC"}

package/dist/api/extension/overrideWithConfig.d.ts

@@ -0,0 +1,2 @@
+export { overrideWithConfig } from "../../utils/overrideWithConfig.js";
+//# sourceMappingURL=overrideWithConfig.d.ts.map

package/dist/api/extension/overrideWithConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrideWithConfig.d.ts","sourceRoot":"","sources":["../../../src/api/extension/overrideWithConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/api/extension/registerExtension.d.ts

@@ -0,0 +1,32 @@
+/**
+ * One-shot: load pre-built manifest from package, register all specs, create adapter.
+ * Framework does NOT scan source for @tool; it reads manifest (e.g. core-tools-manifest.json)
+ * produced by the extension's build. Extension passes packagePath, config, getContextRunner.
+ */
+import type { ToolAdapter } from "../../core/types/ToolSpec.js";
+import type { ToolRegistry } from "../../core/registry/ToolRegistry.js";
+import type { ExecContext } from "../../core/types/ToolIntent.js";
+import type { ContextRunner } from "./contextRunner.js";
+export interface RegisterExtensionOptions<TContext> {
+    /** Package root (e.g. __dirname of extension's entry). Manifest is read from here. */
+    packagePath: string;
+    /** Tool kind; if omitted, uses manifest.kind or "extension". */
+    kind?: string;
+    /** Optional default config; merged with each tool's tool.yaml (spec._meta.defaultArgs). Context config = { ...config, ...toolDefaultArgs }. */
+    config?: unknown;
+    /** Returns the context runner (extension's createContextRunner()). */
+    getContextRunner: () => ContextRunner<TContext>;
+    /** Filter: only register these tool names. */
+    only?: string[];
+    /** Filter: only register tools whose name starts with one of these prefixes. */
+    namePrefixes?: string[];
+}
+export declare function deriveConfigPrefixCandidates(prefixWithVersion: string): string[];
+/**
+ * Load manifest from package (pre-built JSON; no @tool scanning). Register all specs, create and return adapter.
+ */
+export declare function registerExtension<TContext extends {
+    execCtx: ExecContext;
+    config: unknown;
+}>(registry: ToolRegistry, options: RegisterExtensionOptions<TContext>): ToolAdapter;
+//# sourceMappingURL=registerExtension.d.ts.map

package/dist/api/extension/registerExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerExtension.d.ts","sourceRoot":"","sources":["../../../src/api/extension/registerExtension.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,MAAM,WAAW,wBAAwB,CAAC,QAAQ;IAChD,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+IAA+I;IAC/I,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAgB,4BAA4B,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,CAUhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAC1F,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAC1C,WAAW,CA8Db"}

package/dist/api/extension/registerFromManifest.d.ts

@@ -0,0 +1,43 @@
+import type { ToolSpec, HitlSideEffect } from "../../core/types/ToolSpec.js";
+import type { ToolRegistry } from "../../core/registry/ToolRegistry.js";
+/** Manifest entry shape (convention: extension build emits this, e.g. from @tool scan). */
+export interface ExtensionManifestEntry {
+    /** Tool name (e.g. "exec.runCommand"). Legacy manifests may have coreName instead. */
+    name?: string;
+    /** @deprecated Use name instead. Legacy: e.g. "core/src.exec.runCommand". */
+    coreName?: string;
+    description: string;
+    inputSchema: object;
+    outputSchema: object;
+    sourcePath: string;
+    exportName: string;
+    sideEffect: HitlSideEffect;
+}
+/** Loaded manifest: entries + optional kind from manifest file. */
+export interface LoadedExtensionManifest {
+    kind?: string;
+    entries: ExtensionManifestEntry[];
+}
+export interface RegisterFromManifestOptions {
+    /** Path to manifest JSON (or directory containing core-tools-manifest.json). */
+    manifestPathOrDir: string;
+    /** Tool kind; if omitted, uses manifest.kind or "extension". */
+    kind?: string;
+    /** Filter: only register these tool names. */
+    only?: string[];
+    /** Filter: only register tools whose name starts with one of these prefixes. */
+    namePrefixes?: string[];
+    /** Extension package root (e.g. dist); when set, loads <base>.tool.yaml per tool and sets defaultArgs in _meta. */
+    packageRoot?: string;
+}
+/**
+ * Load manifest from path. Supports array or { kind?, tools: ExtensionManifestEntry[] }.
+ * Returns entries + optional kind so framework can use dynamic kind from manifest.
+ */
+export declare function loadExtensionManifest(manifestPathOrDir: string): LoadedExtensionManifest;
+/**
+ * Register tools from a manifest with the registry. Returns the list of registered specs.
+ * Extension packages call this from their register (or equivalent) with their package root.
+ */
+export declare function registerToolsFromManifest(registry: ToolRegistry, options: RegisterFromManifestOptions): ToolSpec[];
+//# sourceMappingURL=registerFromManifest.d.ts.map

package/dist/api/extension/registerFromManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerFromManifest.d.ts","sourceRoot":"","sources":["../../../src/api/extension/registerFromManifest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGxE,2FAA2F;AAC3F,MAAM,WAAW,sBAAsB;IACrC,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mHAAmH;IACnH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,iBAAiB,EAAE,MAAM,GAAG,uBAAuB,CAgBxF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,2BAA2B,GACnC,QAAQ,EAAE,CA4CZ"}

package/dist/api/extension/resolvePackageRoot.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveExtensionPackageRoot(metaUrlOrPath: string): string;
+//# sourceMappingURL=resolvePackageRoot.d.ts.map

package/dist/api/extension/resolvePackageRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePackageRoot.d.ts","sourceRoot":"","sources":["../../../src/api/extension/resolvePackageRoot.ts"],"names":[],"mappings":"AAQA,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMzE"}

package/dist/api/extension/support/groupPrefix.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Convert "groups" + "only" options and a group→prefix map into only/namePrefixes for registerToolsFromManifest.
+ * Extensions define their own group names and prefixes (e.g. fs -> "core/fs.").
+ */
+export interface GroupPrefixOptions {
+    /** Only register tools in these groups (e.g. ["fs", "http"]). */
+    groups?: string[];
+    /** Only register these tool names. Takes precedence over groups. */
+    only?: string[];
+    /** Map group name -> name prefix (e.g. { fs: "core/fs.", http: "core/http." }). */
+    groupPrefixMap: Record<string, string>;
+}
+export interface ResolvedOnlyNamePrefixes {
+    only?: string[];
+    namePrefixes?: string[];
+}
+/**
+ * Resolve groups/only + groupPrefixMap to only and namePrefixes for registerToolsFromManifest.
+ */
+export declare function getGroupNamePrefixes(options: GroupPrefixOptions): ResolvedOnlyNamePrefixes;
+//# sourceMappingURL=groupPrefix.d.ts.map

package/dist/api/extension/support/groupPrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupPrefix.d.ts","sourceRoot":"","sources":["../../../../src/api/extension/support/groupPrefix.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,mFAAmF;IACnF,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,wBAAwB,CAW1F"}

package/dist/api/extension/support/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generic extension types: context shape, handler signature.
+ * ExtensionToolResult lives in dynamicImportAdapter (same shape).
+ */
+import type { ExecContext } from "../../../core/types/ToolIntent.js";
+import type { ExtensionToolResult } from "../dynamicImportAdapter.js";
+export type { ExtensionToolResult } from "../dynamicImportAdapter.js";
+/** Generic extension context: execCtx + config. Config type is extension-specific. */
+export interface ExtensionToolContext<TConfig = unknown> {
+    execCtx: ExecContext;
+    config: TConfig;
+}
+/** Generic extension handler signature (args only; context via getContext()). */
+export type ExtensionToolHandler = (args: any) => Promise<ExtensionToolResult>;
+//# sourceMappingURL=types.d.ts.map

package/dist/api/extension/support/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/api/extension/support/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,sFAAsF;AACtF,MAAM,WAAW,oBAAoB,CAAC,OAAO,GAAG,OAAO;IACrD,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/api/register-tools.d.ts

@@ -0,0 +1,17 @@
+import { type CreateAgentToolsOptions } from "./createAgentTools.js";
+import type { StructuredToolInterface } from "@langchain/core/tools";
+export interface CreateAgentToolsModuleOptions extends CreateAgentToolsOptions {
+}
+/**
+ * Preferred async tool initializer for application bootstrap.
+ *
+ * Sets:
+ *  - AgentContextTokens.Tools → StructuredToolInterface[]
+ *
+ * @example
+ * ```ts
+ * await createAgentTools("config/tool.yaml");
+ * ```
+ */
+export declare function createAgentTools(configPathOrOptions?: string | CreateAgentToolsModuleOptions): Promise<StructuredToolInterface[]>;
+//# sourceMappingURL=register-tools.d.ts.map

package/dist/api/register-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-tools.d.ts","sourceRoot":"","sources":["../../src/api/register-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE,MAAM,WAAW,6BAA8B,SAAQ,uBAAuB;CAAG;AAEjF;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,mBAAmB,CAAC,EAAE,MAAM,GAAG,6BAA6B,GAC3D,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAQpC"}

package/dist/api/resolveAgentSkillRoots.d.ts

@@ -0,0 +1,7 @@
+export interface ResolveAgentSkillRootsOptions {
+    configFilePath: string;
+    skillPath?: string;
+}
+export declare function resolveAgentSkillRoots(options: ResolveAgentSkillRootsOptions): string[];
+export declare const resolveAgentSkillRootsFromToolConfig: typeof resolveAgentSkillRoots;
+//# sourceMappingURL=resolveAgentSkillRoots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAgentSkillRoots.d.ts","sourceRoot":"","sources":["../../src/api/resolveAgentSkillRoots.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,6BAA6B;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiFD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,MAAM,EAAE,CAUvF;AAED,eAAO,MAAM,oCAAoC,+BAAyB,CAAC"}

package/dist/api/runtimeFromConfig.d.ts

@@ -0,0 +1,20 @@
+import { parseNpmDescriptor } from "./runtimeFromConfig.helpers.js";
+import { type CreateRuntimeOptions, type CreateRuntimeResult, type LoadedExtension } from "./runtimeFromConfig.types.js";
+export { DEFAULT_EXTENSION_PACKAGES, type CoreToolsUserConfig, type ExampleToolsUserConfig, type CreateRuntimeOptions, type CreateRuntimeResult, type LoadedExtension, } from "./runtimeFromConfig.types.js";
+export { parseNpmDescriptor };
+/** Load all extensions for npm: entries in tool.yaml (sync). Same package at different versions each get one entry. */
+export declare function loadAllExtensionsFromToolYamlSync(configFilePath: string, stepLog?: (message: string) => void): LoadedExtension[];
+/**
+ * Create runtime and registry synchronously. Registers core/example adapters
+ * only when coreTools/exampleTools are provided (opt-in). If extension packages
+ * are not installed, those adapters are skipped (runtime still works with empty/minimal tools).
+ */
+export declare function createRuntimeFromConfigSync(options?: CreateRuntimeOptions): CreateRuntimeResult;
+/**
+ * Create runtime and registry asynchronously. When configFilePath (tool.yaml) lists npm: packages:
+ * 1. Try loading from project node_modules (sync, fast).
+ * 2. If not found, dynamically load from cache: fetch via npm pack into cache, then dynamic import (works for ESM).
+ * 3. Otherwise fall back to sync path (DEFAULT_EXTENSION_PACKAGES, sync cache).
+ */
+export declare function createRuntimeFromConfig(options?: CreateRuntimeOptions): Promise<CreateRuntimeResult>;
+//# sourceMappingURL=runtimeFromConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeFromConfig.d.ts","sourceRoot":"","sources":["../../src/api/runtimeFromConfig.ts"],"names":[],"mappings":"AA0BA,OAAO,EAML,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAErB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,8BAA8B,CAAC;AAgDtC,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAuH9B,uHAAuH;AACvH,wBAAgB,iCAAiC,CAC/C,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,eAAe,EAAE,CAmBnB;AAsID;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CAwDnG;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAgD9B"}

package/dist/api/runtimeFromConfig.helpers.d.ts

@@ -0,0 +1,12 @@
+import type { ToolAdapter, ToolKind } from "../core/types/ToolSpec.js";
+import type { ToolRegistry } from "../core/registry/ToolRegistry.js";
+export declare function getProjectRequire(): NodeRequire | null;
+export declare function findNearestPackageJson(startDir: string): string | null;
+export declare function getInstalledPackageVersion(packageName: string): string | null;
+export declare function createLocalDirectoryAdapter(kind: ToolKind): ToolAdapter;
+export declare function createPrefixingRegistry(registry: ToolRegistry, prefix: string): ToolRegistry;
+export declare function parseNpmDescriptor(entry: string): {
+    packageName: string;
+    version: string;
+} | null;
+//# sourceMappingURL=runtimeFromConfig.helpers.d.ts.map

package/dist/api/runtimeFromConfig.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeFromConfig.helpers.d.ts","sourceRoot":"","sources":["../../src/api/runtimeFromConfig.helpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAY,MAAM,2BAA2B,CAAC;AAEjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAIrE,wBAAgB,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAKtD;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAStE;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe7E;AAoBD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAwFvE;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,GACb,YAAY,CAoCd;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQjG"}

package/dist/api/runtimeFromConfig.types.d.ts

@@ -0,0 +1,37 @@
+import type { ToolRegistry } from "../core/registry/ToolRegistry.js";
+import type { PTCRuntime } from "../core/runtime/PTCRuntime.js";
+export declare const DEFAULT_EXTENSION_PACKAGES: string[];
+export interface CoreToolsUserConfig {
+    sandboxRoot?: string;
+    enableSandboxValidation?: boolean;
+    allowedHosts?: string[];
+    blockedHosts?: string[];
+    blockedCidrs?: string[];
+    toolOverrides?: Record<string, Record<string, unknown>>;
+    packageDefaults?: Record<string, Record<string, unknown>>;
+    services?: Record<string, unknown>;
+}
+export interface ExampleToolsUserConfig {
+    allowedHosts?: string[];
+}
+export interface CreateRuntimeOptions {
+    configFilePath?: string;
+    projectPath?: string;
+    coreTools?: CoreToolsUserConfig;
+    exampleTools?: ExampleToolsUserConfig;
+    stepLog?: (message: string) => void;
+}
+export interface CreateRuntimeResult {
+    runtime: PTCRuntime;
+    registry: ToolRegistry;
+}
+type RegisterFn = (r: ToolRegistry, c: CoreToolsUserConfig) => unknown;
+export type LoadedExtension = {
+    register: RegisterFn;
+    descriptor: string;
+    resolvedVersion: string;
+    packageRoot: string;
+};
+export type RuntimeRegisterFn = RegisterFn;
+export {};
+//# sourceMappingURL=runtimeFromConfig.types.d.ts.map

package/dist/api/runtimeFromConfig.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeFromConfig.types.d.ts","sourceRoot":"","sources":["../../src/api/runtimeFromConfig.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,eAAO,MAAM,0BAA0B,EAAE,MAAM,EAAO,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,KAAK,UAAU,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AACzH,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC"}