@easynet/agent-tool 1.0.103 → 1.0.105

package/README.md

@@ -4,41 +4,19 @@
 
 `@easynet/agent-tool` loads `tool.yaml`, resolves tool extensions into LangChain-compatible tools, and registers them into the default `AgentContext`.
 
-## Exposed SDK
+## Exposed Interfaces
 
 | Export | Type | Purpose |
 | --- | --- | --- |
-| `createAgentTools` | root function | Loads tools asynchronously from config. Preferred initializer for application bootstrap. |
-| `@easynet/agent-tool/sdk` | subpath | SDK entry for building custom tool extensions. |
-| `ToolRegistry` | sdk export | Registry used to register tool definitions. |
-| `createExtension` | sdk export | Creates an extension package entry. |
-| `registerExtension` | sdk export | Registers an extension into the runtime. |
-| `registerToolsFromManifest` | sdk export | Registers tools from a generated manifest. |
-| `loadToolYaml` | sdk export | Loads and parses `tool.yaml`. |
-| `resolveSandboxedPath` | sdk export | Resolves paths under sandbox constraints. |
-| `validateUrl` | sdk export | Validates outbound URLs for HTTP tools. |
-
-## Usage
-
-```bash
-npm i @easynet/agent-tool
-```
-
-```ts
-import { createAgentTools } from "@easynet/agent-tool";
-
-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`, `createAgentSkills`) and works cleanly with async extension loading.
-
-If you are building your own tool extension, use the SDK subpath:
-
-```ts
-import { createExtension } from "@easynet/agent-tool/sdk";
-```
+| `createAgentTools` | root function | Load tools asynchronously from `tool.yaml`. |
+| `@easynet/agent-tool/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
 
@@ -59,9 +37,29 @@ spec:
 
 Key fields:
 
-- `spec.sandboxedPath`: filesystem root accessible to tools
+- `spec.sandboxedPath`: filesystem root exposed to tools
 - `spec.allowedHosts`: HTTP allowlist
 - `spec.blockedHosts`: HTTP denylist
-- `spec.tools`: extensions to load
+- `spec.tools`: extension descriptors to load
 
-`npm:@easynet/agent-tool-buildin: {}` loads the built-in tool extension package.
+## Usage
+
+```bash
+npm i @easynet/agent-tool
+```
+
+```ts
+import { createAgentTools } from "@easynet/agent-tool";
+
+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 "@easynet/agent-tool/sdk";
+```

package/config/build/build.sh

@@ -0,0 +1,182 @@
+#!/bin/bash
+
+# Build script for @easynet/agent-tool
+# 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: {
+      "@easynet/agent-tool": path.join(root, "dist/index.js"),
+      "@easynet/agent-tool/sdk": path.join(root, "dist/sdk.js"),
+    },
+  },
+});

package/config/tool.yaml

@@ -4,6 +4,7 @@ metadata:
   name: agent-tool-default
 spec:
   sandboxedPath: .
+  cacheDir: ~/.agent/cache
   allowedHosts: []
   blockedHosts: []
   tools:

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

@@ -29,6 +29,7 @@ export declare class LangChainToolsHub {
      * 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

@@ -1 +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;IAOzE,OAAO,CAAC,mBAAmB;CAmB5B"}
+{"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/expose/openapiHttp.d.ts.map

@@ -1 +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;AA2HD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAkHnB;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"}
+{"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/createExtension.d.ts

@@ -1,6 +1,6 @@
 import type { ToolAdapter } from "../../core/types/ToolSpec.js";
 import type { ToolRegistry } from "../../core/registry/ToolRegistry.js";
-import type { ExtensionToolContext } from "./types.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;

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

@@ -1 +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,YAAY,CAAC;AAEvD,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"}
+{"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/index.d.ts

@@ -10,7 +10,7 @@ export { generateExtensionManifest, generateManifest, } from "./generateExtensio
 export type { GenerateExtensionManifestOptions } from "./generateExtensionManifest.js";
 export { createDynamicImportAdapter } from "./dynamicImportAdapter.js";
 export type { DynamicImportAdapterOptions, ExtensionToolResult, } from "./dynamicImportAdapter.js";
-export type { ExtensionToolContext, ExtensionToolHandler, } from "./types.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";
@@ -18,6 +18,6 @@ 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 "./groupPrefix.js";
-export type { GroupPrefixOptions, ResolvedOnlyNamePrefixes, } from "./groupPrefix.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

@@ -1 +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,YAAY,CAAC;AACpB,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,kBAAkB,CAAC;AACxD,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}
+{"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/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/{types.d.ts → support/types.d.ts}

@@ -2,9 +2,9 @@
  * 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";
+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;

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/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

@@ -1,69 +1,6 @@
-/**
- * Create PTCRuntime + ToolRegistry from config (sync or async).
- * Registers extension adapters when coreTools options are provided.
- * Agent-tool does NOT depend on any specific extension. When configFilePath (tool.yaml)
- * lists npm:@scope/pkg, that package is loaded from cache or node_modules. The framework
- * calls the package's default export contract: register(registry, options) -> ToolAdapter.
- * Extensions implement this contract (e.g. via createExtension from this package).
- *
- * Npm: we always register npm extensions with a concrete version in the registry (never "latest").
- * When the descriptor omits version or uses @latest, we resolve to the actual latest from the
- * registry (resolveLatestVersionFromRegistry) and use that version for the registry prefix.
- */
-import { ToolRegistry } from "../core/registry/ToolRegistry.js";
-import { PTCRuntime } from "../core/runtime/PTCRuntime.js";
 import { parseNpmDescriptor } from "./runtimeFromConfig.helpers.js";
-/**
- * Default package names tried when loading an extension from node_modules (no tool.yaml).
- * Empty by default so agent-tool does not depend on any specific extension package.
- * Extensions are loaded only via tool.yaml (npm: entries) or when explicitly configured.
- */
-export declare const DEFAULT_EXTENSION_PACKAGES: string[];
-/** Config passed to extension's register(registry, options). */
-export interface CoreToolsUserConfig {
-    sandboxRoot?: string;
-    /** Whether to enforce sandbox boundary checks in fs path resolution. Default: false. */
-    enableSandboxValidation?: boolean;
-    /** Allowed hosts (e.g. ["*"] or ["api.github.com"]). Merged with tool.yaml. */
-    allowedHosts?: string[];
-    /** Block these hosts even if allowed. Merged with tool.yaml. */
-    blockedHosts?: string[];
-    /** CIDR ranges to block for HTTP (SSRF). Overrides extension default when set. */
-    blockedCidrs?: string[];
-    /** Per-tool config overrides. Keys: short name ("fs.listDir"), package-scoped ("npm.easynet.agent.tool.buildin::fs.listDir", survives version bumps), or full registry name. Use package-scoped or full when different packages share the same short name. */
-    toolOverrides?: Record<string, Record<string, unknown>>;
-    /** Package-level defaults. Key = package prefix (e.g. "npm.easynet.agent.tool.buildin"); value = key-value merged into ctx.config for every tool in that package. */
-    packageDefaults?: Record<string, Record<string, unknown>>;
-    /** Shared services injected into extension tool context config (e.g. modelHub). */
-    services?: Record<string, unknown>;
-}
-/** Config for example-tools extension when present. */
-export interface ExampleToolsUserConfig {
-    allowedHosts?: string[];
-}
-export interface CreateRuntimeOptions {
-    /** Path to tool.yaml (optional; used by createAgentTools to select/filter tool list) */
-    configFilePath?: string;
-    /** Project path for async tool loading (optional; reserved for future use) */
-    projectPath?: string;
-    /** Sandbox / core tools config; when set, core adapter is registered */
-    coreTools?: CoreToolsUserConfig;
-    /** Example tools config; when set, example adapter is registered */
-    exampleTools?: ExampleToolsUserConfig;
-    /** When set, step messages are written here (e.g. for --verbose CLI). */
-    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;
-};
+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[];

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

@@ -1 +1 @@
-{"version":3,"file":"runtimeFromConfig.d.ts","sourceRoot":"","sources":["../../src/api/runtimeFromConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAgB3D,OAAO,EAML,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AAIxC;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,EAAO,CAAC;AAEvD,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8PAA8P;IAC9P,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,qKAAqK;IACrK,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,oEAAoE;IACpE,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,yEAAyE;IACzE,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;AA4CzH,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"}
+{"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.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"}

package/dist/build.cjs

@@ -1,22 +1,22 @@
 'use strict';
 
-var chunkXUIGSBWG_cjs = require('./chunk-XUIGSBWG.cjs');
-require('./chunk-VLV5F6HX.cjs');
+var chunkYAIP4AYQ_cjs = require('./chunk-YAIP4AYQ.cjs');
+require('./chunk-45MCEW2Y.cjs');
 var chunkJW4EMVTE_cjs = require('./chunk-JW4EMVTE.cjs');
 
 
 
 Object.defineProperty(exports, "buildMCPPackage", {
   enumerable: true,
-  get: function () { return chunkXUIGSBWG_cjs.buildMCPPackage; }
+  get: function () { return chunkYAIP4AYQ_cjs.buildMCPPackage; }
 });
 Object.defineProperty(exports, "initProject", {
   enumerable: true,
-  get: function () { return chunkXUIGSBWG_cjs.initProject; }
+  get: function () { return chunkYAIP4AYQ_cjs.initProject; }
 });
 Object.defineProperty(exports, "runMCPServer", {
   enumerable: true,
-  get: function () { return chunkXUIGSBWG_cjs.runMCPServer; }
+  get: function () { return chunkYAIP4AYQ_cjs.runMCPServer; }
 });
 Object.defineProperty(exports, "scan", {
   enumerable: true,

package/dist/build.js

@@ -1,5 +1,5 @@
-export { buildMCPPackage, initProject, runMCPServer } from './chunk-34SG3EMW.js';
-import './chunk-POUTZDWB.js';
+export { buildMCPPackage, initProject, runMCPServer } from './chunk-WNWMAS7C.js';
+import './chunk-2Y6T67HJ.js';
 export { scan, scanForTools } from './chunk-BDUSB6GT.js';
 //# sourceMappingURL=build.js.map
 //# sourceMappingURL=build.js.map