@easynet/agent-tool 1.0.86 → 1.0.87

package/dist/chunk-WUMLZERG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/registry/ToolRegistry.ts"],"names":[],"mappings":"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","file":"chunk-WUMLZERG.js","sourcesContent":["import type { Capability, ToolKind, ToolSpec } from \"../types/ToolSpec.js\";\nimport { normalizeToolName } from \"../types/ToolSpec.js\";\n\n/**\n * Search query for tools.\n */\nexport interface ToolSearchQuery {\n  /** Text search in name/description/tags */\n  text?: string;\n  /** Filter by tool kind */\n  kind?: ToolKind;\n  /** Filter by required capabilities */\n  capabilities?: Capability[];\n  /** Filter by tags */\n  tags?: string[];\n}\n\n/**\n * Tool Registry: manages tool registration, lookup, and search.\n * Supports both static registration and dynamic discovery via adapters.\n */\nexport class ToolRegistry {\n  private readonly tools = new Map<string, ToolSpec>();\n  private readonly tagIndex = new Map<string, Set<string>>(); // tag → tool names\n  private readonly kindIndex = new Map<ToolKind, Set<string>>(); // kind → tool names\n\n  /**\n   * Register a single tool spec.\n   * Overwrites if same name already exists.\n   */\n  register(spec: ToolSpec): void {\n    this.validateSpec(spec);\n    const name = normalizeToolName(spec.name);\n    const normalized = { ...spec, name };\n    this.tools.set(name, normalized);\n    this.indexTool(normalized);\n  }\n\n  /**\n   * Register multiple tool specs at once.\n   */\n  bulkRegister(specs: ToolSpec[]): void {\n    for (const spec of specs) {\n      this.register(spec);\n    }\n  }\n\n  /**\n   * Unregister a tool by name.\n   */\n  unregister(name: string): boolean {\n    const key = normalizeToolName(name);\n    const spec = this.tools.get(key);\n    if (!spec) return false;\n    this.tools.delete(key);\n    this.deindexTool(spec);\n    return true;\n  }\n\n  /**\n   * Get a tool spec by name (name is normalized before lookup).\n   */\n  get(name: string): ToolSpec | undefined {\n    return this.tools.get(normalizeToolName(name));\n  }\n\n  /**\n   * Check if a tool exists (name is normalized before lookup).\n   */\n  has(name: string): boolean {\n    return this.tools.has(normalizeToolName(name));\n  }\n\n  /**\n   * Search tools by query.\n   */\n  search(query: ToolSearchQuery): ToolSpec[] {\n    let candidates: ToolSpec[];\n\n    // Start with kind filter if specified (uses index)\n    if (query.kind) {\n      const names = this.kindIndex.get(query.kind);\n      if (!names || names.size === 0) return [];\n      candidates = [...names]\n        .map((n) => this.tools.get(n))\n        .filter((s): s is ToolSpec => s !== undefined);\n    } else {\n      candidates = [...this.tools.values()];\n    }\n\n    // Filter by tags (uses index for initial candidates if no kind filter)\n    if (query.tags && query.tags.length > 0) {\n      candidates = candidates.filter((spec) =>\n        query.tags!.some((tag) => spec.tags?.includes(tag)),\n      );\n    }\n\n    // Filter by capabilities\n    if (query.capabilities && query.capabilities.length > 0) {\n      candidates = candidates.filter((spec) =>\n        query.capabilities!.every((cap) => spec.capabilities.includes(cap)),\n      );\n    }\n\n    // Filter by text (name, description, tags)\n    if (query.text) {\n      const lower = query.text.toLowerCase();\n      candidates = candidates.filter(\n        (spec) =>\n          spec.name.toLowerCase().includes(lower) ||\n          spec.description?.toLowerCase().includes(lower) ||\n          spec.tags?.some((t) => t.toLowerCase().includes(lower)),\n      );\n    }\n\n    return candidates;\n  }\n\n  /**\n   * List all registered tool names.\n   */\n  list(): string[] {\n    return [...this.tools.keys()];\n  }\n\n  /**\n   * Get count of registered tools.\n   */\n  get size(): number {\n    return this.tools.size;\n  }\n\n  /**\n   * Export a snapshot of all registered tools (for debugging/routing).\n   */\n  snapshot(): ToolSpec[] {\n    return [...this.tools.values()];\n  }\n\n  /**\n   * Clear all registered tools.\n   */\n  clear(): void {\n    this.tools.clear();\n    this.tagIndex.clear();\n    this.kindIndex.clear();\n  }\n\n  private validateSpec(spec: ToolSpec): void {\n    if (!spec.name) throw new Error(\"ToolSpec.name is required\");\n    if (!spec.version) throw new Error(\"ToolSpec.version is required\");\n    if (!spec.kind) throw new Error(\"ToolSpec.kind is required\");\n    if (!spec.inputSchema) throw new Error(\"ToolSpec.inputSchema is required\");\n    if (!spec.outputSchema) throw new Error(\"ToolSpec.outputSchema is required\");\n    if (!spec.capabilities) throw new Error(\"ToolSpec.capabilities is required\");\n  }\n\n  private indexTool(spec: ToolSpec): void {\n    // Kind index\n    let kindSet = this.kindIndex.get(spec.kind);\n    if (!kindSet) {\n      kindSet = new Set();\n      this.kindIndex.set(spec.kind, kindSet);\n    }\n    kindSet.add(spec.name);\n\n    // Tag index\n    if (spec.tags) {\n      for (const tag of spec.tags) {\n        let tagSet = this.tagIndex.get(tag);\n        if (!tagSet) {\n          tagSet = new Set();\n          this.tagIndex.set(tag, tagSet);\n        }\n        tagSet.add(spec.name);\n      }\n    }\n  }\n\n  private deindexTool(spec: ToolSpec): void {\n    this.kindIndex.get(spec.kind)?.delete(spec.name);\n    if (spec.tags) {\n      for (const tag of spec.tags) {\n        this.tagIndex.get(tag)?.delete(spec.name);\n      }\n    }\n  }\n}\n"]}

package/dist/chunk-XPGHS4W7.cjs

@@ -1,73 +0,0 @@
-'use strict';
-
-var pRetry = require('p-retry');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var pRetry__default = /*#__PURE__*/_interopDefault(pRetry);
-
-// src/core/runtime/Retry.ts
-var NON_RETRYABLE_ERRORS = /* @__PURE__ */ new Set([
-  "TOOL_NOT_FOUND",
-  "INPUT_SCHEMA_INVALID",
-  "POLICY_DENIED",
-  "HITL_DENIED",
-  "OUTPUT_SCHEMA_INVALID",
-  "PATH_OUTSIDE_SANDBOX",
-  "FILE_TOO_LARGE",
-  "HTTP_DISALLOWED_HOST",
-  "HTTP_TOO_LARGE",
-  "EXEC_INVALID",
-  "EXEC_SPAWN_ERROR",
-  "DUCKDUCKGO_INVALID"
-]);
-function isRetryable(error) {
-  if (error instanceof Error) {
-    const kind = error.kind;
-    if (kind && NON_RETRYABLE_ERRORS.has(kind)) return false;
-  }
-  return true;
-}
-async function withRetry(fn, options = {}) {
-  const {
-    maxRetries = 2,
-    baseDelayMs = 1e3,
-    maxDelayMs = 1e4,
-    jitter = 0.1,
-    shouldRetry,
-    onRetry
-  } = options;
-  if (maxRetries <= 0) {
-    return fn();
-  }
-  const pRetryOptions = {
-    retries: maxRetries,
-    minTimeout: baseDelayMs,
-    maxTimeout: maxDelayMs,
-    randomize: true,
-    factor: 2,
-    onFailedAttempt: (error) => {
-      if (jitter > 0 && error.retriesLeft > 0) ;
-      if (shouldRetry && !shouldRetry(error)) {
-        throw error;
-      }
-      if (!isRetryable(error)) {
-        throw error;
-      }
-      onRetry?.(error, maxRetries - error.retriesLeft);
-    }
-  };
-  return pRetry__default.default(fn, pRetryOptions);
-}
-function createTaggedError(kind, message, details) {
-  const error = new Error(message);
-  error.kind = kind;
-  error.details = details;
-  return error;
-}
-
-exports.createTaggedError = createTaggedError;
-exports.isRetryable = isRetryable;
-exports.withRetry = withRetry;
-//# sourceMappingURL=chunk-XPGHS4W7.cjs.map
-//# sourceMappingURL=chunk-XPGHS4W7.cjs.map

package/dist/chunk-XPGHS4W7.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/runtime/Retry.ts"],"names":["pRetry"],"mappings":";;;;;;;;;AAuBA,IAAM,oBAAA,uBAA2B,GAAA,CAAI;AAAA,EACnC,gBAAA;AAAA,EACA,sBAAA;AAAA,EACA,eAAA;AAAA,EACA,aAAA;AAAA,EACA,uBAAA;AAAA,EACA,sBAAA;AAAA,EACA,gBAAA;AAAA,EACA,sBAAA;AAAA,EACA,gBAAA;AAAA,EACA,cAAA;AAAA,EACA,kBAAA;AAAA,EACA;AACF,CAAC,CAAA;AAKM,SAAS,YAAY,KAAA,EAAyB;AACnD,EAAA,IAAI,iBAAiB,KAAA,EAAO;AAC1B,IAAA,MAAM,OAAQ,KAAA,CAAoC,IAAA;AAClD,IAAA,IAAI,IAAA,IAAQ,oBAAA,CAAqB,GAAA,CAAI,IAAI,GAAG,OAAO,KAAA;AAAA,EACrD;AACA,EAAA,OAAO,IAAA;AACT;AAKA,eAAsB,SAAA,CACpB,EAAA,EACA,OAAA,GAAwB,EAAC,EACb;AACZ,EAAA,MAAM;AAAA,IACJ,UAAA,GAAa,CAAA;AAAA,IACb,WAAA,GAAc,GAAA;AAAA,IACd,UAAA,GAAa,GAAA;AAAA,IACb,MAAA,GAAS,GAAA;AAAA,IACT,WAAA;AAAA,IACA;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,IAAI,cAAc,CAAA,EAAG;AACnB,IAAA,OAAO,EAAA,EAAG;AAAA,EACZ;AAEA,EAAA,MAAM,aAAA,GAA+B;AAAA,IACnC,OAAA,EAAS,UAAA;AAAA,IACT,UAAA,EAAY,WAAA;AAAA,IACZ,UAAA,EAAY,UAAA;AAAA,IACZ,SAAA,EAAW,IAAA;AAAA,IACX,MAAA,EAAQ,CAAA;AAAA,IACR,eAAA,EAAiB,CAAC,KAAA,KAAU;AAE1B,MAAA,IAAI,MAAA,GAAS,CAAA,IAAK,KAAA,CAAM,WAAA,GAAc,CAAA,EAAG;AAMzC,MAAA,IAAI,WAAA,IAAe,CAAC,WAAA,CAAY,KAAK,CAAA,EAAG;AACtC,QAAA,MAAM,KAAA;AAAA,MACR;AAEA,MAAA,IAAI,CAAC,WAAA,CAAY,KAAK,CAAA,EAAG;AACvB,QAAA,MAAM,KAAA;AAAA,MACR;AAEA,MAAA,OAAA,GAAU,KAAA,EAAO,UAAA,GAAa,KAAA,CAAM,WAAW,CAAA;AAAA,IACjD;AAAA,GACF;AAEA,EAAA,OAAOA,uBAAA,CAAO,IAAI,aAAa,CAAA;AACjC;AAKO,SAAS,iBAAA,CACd,IAAA,EACA,OAAA,EACA,OAAA,EAC6C;AAC7C,EAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA;AAI/B,EAAA,KAAA,CAAM,IAAA,GAAO,IAAA;AACb,EAAA,KAAA,CAAM,OAAA,GAAU,OAAA;AAChB,EAAA,OAAO,KAAA;AACT","file":"chunk-XPGHS4W7.cjs","sourcesContent":["import pRetry, { type Options as PRetryOptions } from \"p-retry\";\n\n/**\n * Retry configuration.\n */\nexport interface RetryOptions {\n  /** Maximum number of retries (default: 2) */\n  maxRetries?: number;\n  /** Base delay in ms for exponential backoff (default: 1000) */\n  baseDelayMs?: number;\n  /** Maximum delay in ms (default: 10000) */\n  maxDelayMs?: number;\n  /** Jitter factor 0-1 (default: 0.1) */\n  jitter?: number;\n  /** Error filter: return true to retry, false to abort */\n  shouldRetry?: (error: Error) => boolean;\n  /** Callback on each retry attempt */\n  onRetry?: (error: Error, attempt: number) => void;\n}\n\n/**\n * Default errors that should NOT be retried (deterministic failures).\n */\nconst NON_RETRYABLE_ERRORS = new Set([\n  \"TOOL_NOT_FOUND\",\n  \"INPUT_SCHEMA_INVALID\",\n  \"POLICY_DENIED\",\n  \"HITL_DENIED\",\n  \"OUTPUT_SCHEMA_INVALID\",\n  \"PATH_OUTSIDE_SANDBOX\",\n  \"FILE_TOO_LARGE\",\n  \"HTTP_DISALLOWED_HOST\",\n  \"HTTP_TOO_LARGE\",\n  \"EXEC_INVALID\",\n  \"EXEC_SPAWN_ERROR\",\n  \"DUCKDUCKGO_INVALID\",\n]);\n\n/**\n * Determine if an error is retryable.\n */\nexport function isRetryable(error: unknown): boolean {\n  if (error instanceof Error) {\n    const kind = (error as Error & { kind?: string }).kind;\n    if (kind && NON_RETRYABLE_ERRORS.has(kind)) return false;\n  }\n  return true;\n}\n\n/**\n * Execute a function with retry logic using exponential backoff.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  options: RetryOptions = {},\n): Promise<T> {\n  const {\n    maxRetries = 2,\n    baseDelayMs = 1000,\n    maxDelayMs = 10_000,\n    jitter = 0.1,\n    shouldRetry,\n    onRetry,\n  } = options;\n\n  if (maxRetries <= 0) {\n    return fn();\n  }\n\n  const pRetryOptions: PRetryOptions = {\n    retries: maxRetries,\n    minTimeout: baseDelayMs,\n    maxTimeout: maxDelayMs,\n    randomize: true,\n    factor: 2,\n    onFailedAttempt: (error) => {\n      // Apply jitter\n      if (jitter > 0 && error.retriesLeft > 0) {\n        // jitterMs calculated but p-retry handles backoff internally\n        void (Math.random() * jitter * baseDelayMs);\n      }\n\n      // Check if should retry\n      if (shouldRetry && !shouldRetry(error)) {\n        throw error; // Abort retry\n      }\n\n      if (!isRetryable(error)) {\n        throw error; // Non-retryable error kind\n      }\n\n      onRetry?.(error, maxRetries - error.retriesLeft);\n    },\n  };\n\n  return pRetry(fn, pRetryOptions);\n}\n\n/**\n * Create a tagged error with a kind field for retry classification.\n */\nexport function createTaggedError(\n  kind: string,\n  message: string,\n  details?: unknown,\n): Error & { kind: string; details?: unknown } {\n  const error = new Error(message) as Error & {\n    kind: string;\n    details?: unknown;\n  };\n  error.kind = kind;\n  error.details = details;\n  return error;\n}\n"]}

package/dist/chunk-ZDSZHEQU.cjs

@@ -1,52 +0,0 @@
-'use strict';
-
-var chunkXPGHS4W7_cjs = require('./chunk-XPGHS4W7.cjs');
-var path = require('path');
-var promises = require('fs/promises');
-
-var sandboxValidationEnabled = false;
-function setSandboxValidationEnabled(enabled) {
-  sandboxValidationEnabled = enabled;
-}
-async function resolveSandboxedPath(inputPath, sandboxRoot) {
-  let normalizedRoot;
-  try {
-    normalizedRoot = await promises.realpath(path.resolve(sandboxRoot));
-  } catch {
-    normalizedRoot = path.normalize(path.resolve(sandboxRoot));
-  }
-  const resolved = path.resolve(normalizedRoot, inputPath);
-  let real;
-  try {
-    await promises.access(resolved);
-    real = await promises.realpath(resolved);
-  } catch {
-    const parentDir = path.dirname(resolved);
-    let realParent;
-    try {
-      await promises.access(parentDir);
-      realParent = await promises.realpath(parentDir);
-    } catch {
-      realParent = path.normalize(parentDir);
-    }
-    real = path.resolve(realParent, path.basename(resolved));
-  }
-  if (sandboxValidationEnabled && !isWithinRoot(real, normalizedRoot)) {
-    throw chunkXPGHS4W7_cjs.createTaggedError(
-      "PATH_OUTSIDE_SANDBOX",
-      `Path "${inputPath}" resolves to "${real}" which is outside sandbox "${normalizedRoot}"`,
-      { inputPath, resolvedPath: real, sandboxRoot: normalizedRoot }
-    );
-  }
-  return real;
-}
-function isWithinRoot(path$1, root) {
-  const normalizedPath = path.normalize(path$1);
-  const normalizedRoot = path.normalize(root);
-  return normalizedPath === normalizedRoot || normalizedPath.startsWith(normalizedRoot + "/");
-}
-
-exports.resolveSandboxedPath = resolveSandboxedPath;
-exports.setSandboxValidationEnabled = setSandboxValidationEnabled;
-//# sourceMappingURL=chunk-ZDSZHEQU.cjs.map
-//# sourceMappingURL=chunk-ZDSZHEQU.cjs.map

package/dist/chunk-ZDSZHEQU.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/security/sandbox.ts"],"names":["realpath","resolve","normalize","access","dirname","basename","createTaggedError","path"],"mappings":";;;;;;AAIA,IAAI,wBAAA,GAA2B,KAAA;AAExB,SAAS,4BAA4B,OAAA,EAAwB;AAClE,EAAA,wBAAA,GAA2B,OAAA;AAC7B;AASA,eAAsB,oBAAA,CACpB,WACA,WAAA,EACiB;AAGjB,EAAA,IAAI,cAAA;AACJ,EAAA,IAAI;AACF,IAAA,cAAA,GAAiB,MAAMA,iBAAA,CAASC,YAAA,CAAQ,WAAW,CAAC,CAAA;AAAA,EACtD,CAAA,CAAA,MAAQ;AACN,IAAA,cAAA,GAAiBC,cAAA,CAAUD,YAAA,CAAQ,WAAW,CAAC,CAAA;AAAA,EACjD;AAGA,EAAA,MAAM,QAAA,GAAWA,YAAA,CAAQ,cAAA,EAAgB,SAAS,CAAA;AAElD,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI;AAEF,IAAA,MAAME,gBAAO,QAAQ,CAAA;AACrB,IAAA,IAAA,GAAO,MAAMH,kBAAS,QAAQ,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AAEN,IAAA,MAAM,SAAA,GAAYI,aAAQ,QAAQ,CAAA;AAClC,IAAA,IAAI,UAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAMD,gBAAO,SAAS,CAAA;AACtB,MAAA,UAAA,GAAa,MAAMH,kBAAS,SAAS,CAAA;AAAA,IACvC,CAAA,CAAA,MAAQ;AAGN,MAAA,UAAA,GAAaE,eAAU,SAAS,CAAA;AAAA,IAClC;AACA,IAAA,IAAA,GAAOD,YAAA,CAAQ,UAAA,EAAYI,aAAA,CAAS,QAAQ,CAAC,CAAA;AAAA,EAC/C;AAEA,EAAA,IAAI,wBAAA,IAA4B,CAAC,YAAA,CAAa,IAAA,EAAM,cAAc,CAAA,EAAG;AACnE,IAAA,MAAMC,mCAAA;AAAA,MACJ,sBAAA;AAAA,MACA,CAAA,MAAA,EAAS,SAAS,CAAA,eAAA,EAAkB,IAAI,+BAA+B,cAAc,CAAA,CAAA,CAAA;AAAA,MACrF,EAAE,SAAA,EAAW,YAAA,EAAc,IAAA,EAAM,aAAa,cAAA;AAAe,KAC/D;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,YAAA,CAAaC,QAAc,IAAA,EAAuB;AACzD,EAAA,MAAM,cAAA,GAAiBL,eAAUK,MAAI,CAAA;AACrC,EAAA,MAAM,cAAA,GAAiBL,eAAU,IAAI,CAAA;AACrC,EAAA,OAAO,cAAA,KAAmB,cAAA,IAAkB,cAAA,CAAe,UAAA,CAAW,iBAAiB,GAAG,CAAA;AAC5F","file":"chunk-ZDSZHEQU.cjs","sourcesContent":["import { resolve, normalize, dirname, basename } from \"node:path\";\nimport { realpath, access } from \"node:fs/promises\";\nimport { createTaggedError } from \"../core/runtime/Retry.js\";\n\nlet sandboxValidationEnabled = false;\n\nexport function setSandboxValidationEnabled(enabled: boolean): void {\n  sandboxValidationEnabled = enabled;\n}\n\n/**\n * Resolve an input path to an absolute path within the sandbox.\n * Throws PATH_OUTSIDE_SANDBOX if the resolved path escapes the sandbox root.\n *\n * For existing files: uses realpath to resolve symlinks.\n * For non-existing files (write targets): resolves the parent directory.\n */\nexport async function resolveSandboxedPath(\n  inputPath: string,\n  sandboxRoot: string,\n): Promise<string> {\n  // Resolve the sandbox root itself with realpath to handle platform symlinks\n  // (e.g. macOS /var -> /private/var)\n  let normalizedRoot: string;\n  try {\n    normalizedRoot = await realpath(resolve(sandboxRoot));\n  } catch {\n    normalizedRoot = normalize(resolve(sandboxRoot));\n  }\n\n  // Resolve against sandbox root\n  const resolved = resolve(normalizedRoot, inputPath);\n\n  let real: string;\n  try {\n    // Try to resolve symlinks for existing paths\n    await access(resolved);\n    real = await realpath(resolved);\n  } catch {\n    // Path does not exist — resolve parent to check containment\n    const parentDir = dirname(resolved);\n    let realParent: string;\n    try {\n      await access(parentDir);\n      realParent = await realpath(parentDir);\n    } catch {\n      // Parent also doesn't exist — use normalized resolved path\n      // (will fail at actual FS operation if truly invalid)\n      realParent = normalize(parentDir);\n    }\n    real = resolve(realParent, basename(resolved));\n  }\n\n  if (sandboxValidationEnabled && !isWithinRoot(real, normalizedRoot)) {\n    throw createTaggedError(\n      \"PATH_OUTSIDE_SANDBOX\",\n      `Path \"${inputPath}\" resolves to \"${real}\" which is outside sandbox \"${normalizedRoot}\"`,\n      { inputPath, resolvedPath: real, sandboxRoot: normalizedRoot },\n    );\n  }\n\n  return real;\n}\n\nfunction isWithinRoot(path: string, root: string): boolean {\n  const normalizedPath = normalize(path);\n  const normalizedRoot = normalize(root);\n  return normalizedPath === normalizedRoot || normalizedPath.startsWith(normalizedRoot + \"/\");\n}\n"]}

package/dist/config/index.d.ts

@@ -1,12 +0,0 @@
-import { type ToolYamlShape } from "../tools/util/toolConfig.js";
-export { normalizeAgentToolConfigRef } from "./ref.js";
-export type { AgentToolConfigRef } from "./ref.js";
-export interface LoadToolConfigOptions {
-    configPath?: string;
-}
-export interface CreateToolConfigOptions extends LoadToolConfigOptions {
-    overrides?: Partial<ToolYamlShape>;
-}
-export declare function loadToolRuntimeConfig(options?: LoadToolConfigOptions): ToolYamlShape;
-export declare function createToolConfig(options?: CreateToolConfigOptions): ToolYamlShape;
-//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACpC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,qBAA0B,GAAG,aAAa,CAGxF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,aAAa,CAIrF"}

package/dist/config/ref.d.ts

@@ -1,9 +0,0 @@
-/** Agent-level reference to tool config files by environment. */
-export interface AgentToolConfigRef {
-    ref?: string;
-    development?: string;
-    production?: string;
-}
-/** Normalize unknown value to AgentToolConfigRef. */
-export declare function normalizeAgentToolConfigRef(raw: unknown): Partial<AgentToolConfigRef>;
-//# sourceMappingURL=ref.d.ts.map

package/dist/config/ref.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/config/ref.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAUrF"}

package/dist/core/index.cjs

@@ -1,20 +0,0 @@
-'use strict';
-
-var chunkQEJF3KDV_cjs = require('../chunk-QEJF3KDV.cjs');
-
-
-
-Object.defineProperty(exports, "DEFAULT_INPUT_SCHEMA", {
-  enumerable: true,
-  get: function () { return chunkQEJF3KDV_cjs.DEFAULT_INPUT_SCHEMA; }
-});
-Object.defineProperty(exports, "DEFAULT_OUTPUT_SCHEMA", {
-  enumerable: true,
-  get: function () { return chunkQEJF3KDV_cjs.DEFAULT_OUTPUT_SCHEMA; }
-});
-Object.defineProperty(exports, "createToolSpec", {
-  enumerable: true,
-  get: function () { return chunkQEJF3KDV_cjs.createToolSpec; }
-});
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/core/index.cjs.map

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

package/dist/core/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Core types and createToolSpec only.
- * Use this entry point from extensions to avoid circular dependency with the main index.
- */
-export type { ToolKind, Capability, HitlSideEffect, CostHints, ToolSpec, CreateToolSpecOptions, } from "./types/ToolSpec.js";
-export { createToolSpec, DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, } from "./types/ToolSpec.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,SAAS,EACT,QAAQ,EACR,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/core/index.js

@@ -1,3 +0,0 @@
-export { DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, createToolSpec } from '../chunk-ODEHUAR4.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

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

package/dist/core/runtime.cjs

@@ -1,26 +0,0 @@
-'use strict';
-
-var chunkPYCCJF7C_cjs = require('../chunk-PYCCJF7C.cjs');
-var chunkXPGHS4W7_cjs = require('../chunk-XPGHS4W7.cjs');
-require('../chunk-QEJF3KDV.cjs');
-
-
-
-Object.defineProperty(exports, "ToolRegistry", {
-  enumerable: true,
-  get: function () { return chunkPYCCJF7C_cjs.ToolRegistry; }
-});
-Object.defineProperty(exports, "createTaggedError", {
-  enumerable: true,
-  get: function () { return chunkXPGHS4W7_cjs.createTaggedError; }
-});
-Object.defineProperty(exports, "isRetryable", {
-  enumerable: true,
-  get: function () { return chunkXPGHS4W7_cjs.isRetryable; }
-});
-Object.defineProperty(exports, "withRetry", {
-  enumerable: true,
-  get: function () { return chunkXPGHS4W7_cjs.withRetry; }
-});
-//# sourceMappingURL=runtime.cjs.map
-//# sourceMappingURL=runtime.cjs.map

package/dist/core/runtime.cjs.map

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

package/dist/core/runtime.d.ts

@@ -1,12 +0,0 @@
-/**
- * Runtime subpath export for extensions (e.g. @easynet/agent-tool-builtin-tools).
- * Re-exports createTaggedError, ToolRegistry, ToolSpec, ExecContext, Evidence, etc.
- */
-export { createTaggedError, withRetry, isRetryable } from "./runtime/Retry.js";
-export type { RetryOptions } from "./runtime/Retry.js";
-export { ToolRegistry } from "./registry/ToolRegistry.js";
-export type { ToolSearchQuery } from "./registry/ToolRegistry.js";
-export type { ToolSpec, ToolAdapter, ToolKind, Capability } from "./types/ToolSpec.js";
-export type { ExecContext, ToolIntent, BudgetConfig } from "./types/ToolIntent.js";
-export type { Evidence, ToolError, ToolResult } from "./types/ToolResult.js";
-//# sourceMappingURL=runtime.d.ts.map

package/dist/core/runtime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/runtime.js

@@ -1,5 +0,0 @@
-export { ToolRegistry } from '../chunk-WUMLZERG.js';
-export { createTaggedError, isRetryable, withRetry } from '../chunk-RZTTO5MQ.js';
-import '../chunk-ODEHUAR4.js';
-//# sourceMappingURL=runtime.js.map
-//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

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

package/dist/extension.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/api/extension/contextRunner.ts","../src/api/extension/dynamicImportAdapter.ts","../src/api/extension/resolvePackageRoot.ts","../src/api/extension/registerExtension.ts","../src/api/extension/createExtension.ts","../src/api/extension/generateExtensionManifest.ts","../src/api/extension/groupPrefix.ts"],"names":["AsyncLocalStorage","path","pathToFileURL","fileURLToPath","existsSync","loadExtensionManifest","registerToolsFromManifest","readdirSync","copyFileSync","scanForTools","writeFileSync"],"mappings":"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","file":"extension.cjs","sourcesContent":["/**\n * Generic context injection for extension tools (e.g. builtin).\n * Any extension that needs to inject config (sandbox, allowedHosts, etc.) into handlers uses this.\n */\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport interface ContextRunner<T> {\n  runWith(ctx: T, fn: () => Promise<unknown>): Promise<unknown>;\n  getContext(): T;\n}\n\n/**\n * Create a context runner for an extension. Handlers call getContext() to read config.\n * Adapter calls runWith(ctx, () => handler(args)) so getContext() returns ctx.\n */\nexport function createContextRunner<T>(): ContextRunner<T> {\n  const storage = new AsyncLocalStorage<T>();\n  return {\n    runWith(ctx: T, fn: () => Promise<unknown>): Promise<unknown> {\n      return storage.run(ctx, fn);\n    },\n    getContext(): T {\n      const ctx = storage.getStore();\n      if (ctx === undefined) {\n        throw new Error(\"Extension context not set; invoke only through the extension adapter.\");\n      }\n      return ctx;\n    },\n  };\n}\n","/**\n * Generic adapter for extensions that discover tools via manifest and load handlers by dynamic import.\n * Any extension (builtin, etc.) that uses @tool scan → manifest and runs handlers with injected context uses this.\n */\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { ToolAdapter, ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { Evidence } from \"../../core/types/ToolResult.js\";\n\n/** If spec.inputSchema wraps params in \"args\", return args.args for the handler; else return args. */\nfunction unwrapArgsForHandler(spec: ToolSpec, args: unknown): unknown {\n  if (args == null || typeof args !== \"object\" || Array.isArray(args)) return args;\n  const s = spec.inputSchema as Record<string, unknown>;\n  if (s?.type !== \"object\" || !s.properties || typeof s.properties !== \"object\") return args;\n  const props = s.properties as Record<string, unknown>;\n  const argsProp = props.args;\n  if (\n    argsProp != null &&\n    typeof argsProp === \"object\" &&\n    (argsProp as Record<string, unknown>).type === \"object\" &&\n    (argsProp as Record<string, unknown>).properties != null\n  ) {\n    const obj = args as Record<string, unknown>;\n    if (Object.keys(obj).length === 1 && \"args\" in obj && typeof obj.args === \"object\" && obj.args !== null) {\n      return obj.args;\n    }\n  }\n  return args;\n}\n\nexport interface ExtensionToolResult {\n  result: unknown;\n  evidence: Evidence[];\n}\n\nexport interface DynamicImportAdapterOptions<TContext> {\n  kind: string;\n  packageRoot: string;\n  /**\n   * Build context from execCtx, spec, and merged request args.\n   * Framework merges defaultArgs (tool.yaml) with request args; implementor can merge into ctx.config\n   * so handlers read resolved config from context instead of re-resolving in each handler.\n   */\n  getExtensionContext: (execCtx: ExecContext, spec: ToolSpec, mergedArgs?: Record<string, unknown>) => TContext;\n  contextRunner: { runWith(ctx: TContext, fn: () => Promise<ExtensionToolResult>): Promise<ExtensionToolResult> };\n}\n\n/**\n * Create an adapter that loads handlers by spec._meta.sourcePath and exportName, then runs with extension context.\n */\nexport function createDynamicImportAdapter<TContext>(\n  options: DynamicImportAdapterOptions<TContext>,\n): ToolAdapter {\n  const { kind, packageRoot, getExtensionContext, contextRunner } = options;\n  return {\n    kind: kind as ToolAdapter[\"kind\"],\n    async invoke(\n      spec: ToolSpec,\n      args: unknown,\n      execCtx: ExecContext,\n    ): Promise<{ result: unknown; raw?: unknown }> {\n      const meta = spec._meta as {\n        sourcePath?: string;\n        exportName?: string;\n        defaultArgs?: Record<string, unknown>;\n        packageRoot?: string;\n      } | undefined;\n      const sourcePath = meta?.sourcePath;\n      const exportName = meta?.exportName;\n      if (!sourcePath || !exportName) {\n        throw new Error(`Extension tool ${spec.name} missing _meta.sourcePath or _meta.exportName`);\n      }\n      const defaultArgs = meta?.defaultArgs ?? {};\n      const mergedArgs =\n        Object.keys(defaultArgs).length === 0\n          ? (args as Record<string, unknown>)\n          : { ...defaultArgs, ...(args as Record<string, unknown>) };\n      const handlerArgs = unwrapArgsForHandler(spec, mergedArgs);\n      const resolvedPackageRoot = meta?.packageRoot ?? packageRoot;\n      const modulePath = path.join(resolvedPackageRoot, `${sourcePath}.js`);\n      const mod = await import(pathToFileURL(modulePath).href);\n      const handler = mod[exportName];\n      if (typeof handler !== \"function\") {\n        throw new Error(\n          `Extension tool ${spec.name}: export \"${exportName}\" from ${sourcePath} is not a function`,\n        );\n      }\n      const ctx = getExtensionContext(execCtx, spec, mergedArgs as Record<string, unknown>);\n      const output = await contextRunner.runWith(ctx, () => handler(handlerArgs));\n      // Return full envelope so pipeline output validation (outputSchema: { result, evidence }) passes.\n      return {\n        result: { result: output.result, evidence: output.evidence },\n        raw: { evidence: output.evidence },\n      };\n    },\n  };\n}\n","/**\n * Resolve extension package root for dynamic import (dist when built, else dir).\n * Accepts import.meta.url (file:) or a directory path (e.g. __dirname).\n */\nimport path from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\n\nexport function resolveExtensionPackageRoot(metaUrlOrPath: string): string {\n  const dir = metaUrlOrPath.startsWith(\"file:\")\n    ? path.dirname(fileURLToPath(metaUrlOrPath))\n    : path.resolve(metaUrlOrPath);\n  const dist = path.join(dir, \"dist\");\n  return existsSync(dist) ? dist : dir;\n}\n","/**\n * One-shot: load pre-built manifest from package, register all specs, create adapter.\n * Framework does NOT scan source for @tool; it reads manifest (e.g. core-tools-manifest.json)\n * produced by the extension's build. Extension passes packagePath, config, getContextRunner.\n */\nimport type { ToolAdapter } from \"../../core/types/ToolSpec.js\";\nimport type { ToolRegistry } from \"../../core/registry/ToolRegistry.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { ContextRunner } from \"./contextRunner.js\";\nimport { createDynamicImportAdapter } from \"./dynamicImportAdapter.js\";\nimport type { ExtensionToolResult } from \"./dynamicImportAdapter.js\";\nimport { registerToolsFromManifest, loadExtensionManifest } from \"./registerFromManifest.js\";\nimport { resolveExtensionPackageRoot } from \"./resolvePackageRoot.js\";\n\nexport interface RegisterExtensionOptions<TContext> {\n  /** Package root (e.g. __dirname of extension's entry). Manifest is read from here. */\n  packagePath: string;\n  /** Tool kind; if omitted, uses manifest.kind or \"extension\". */\n  kind?: string;\n  /** Optional default config; merged with each tool's tool.yaml (spec._meta.defaultArgs). Context config = { ...config, ...toolDefaultArgs }. */\n  config?: unknown;\n  /** Returns the context runner (extension's createContextRunner()). */\n  getContextRunner: () => ContextRunner<TContext>;\n  /** Filter: only register these tool names. */\n  only?: string[];\n  /** Filter: only register tools whose name starts with one of these prefixes. */\n  namePrefixes?: string[];\n}\n\n/**\n * Load manifest from package (pre-built JSON; no @tool scanning). Register all specs, create and return adapter.\n */\nexport function registerExtension<TContext extends { execCtx: ExecContext; config: unknown }>(\n  registry: ToolRegistry,\n  options: RegisterExtensionOptions<TContext>,\n): ToolAdapter {\n  const { packagePath, kind: kindOpt, config, getContextRunner, only, namePrefixes } = options;\n  const packageRoot = resolveExtensionPackageRoot(packagePath);\n  const contextRunner = getContextRunner();\n  const loaded = loadExtensionManifest(packagePath);\n  const kind = kindOpt ?? loaded.kind ?? \"extension\";\n\n  registerToolsFromManifest(registry, {\n    manifestPathOrDir: packagePath,\n    kind,\n    only,\n    namePrefixes,\n    packageRoot,\n  });\n\n  const adapter = createDynamicImportAdapter<TContext>({\n    kind,\n    packageRoot,\n    getExtensionContext: (\n      execCtx: ExecContext,\n      spec: import(\"../../core/types/ToolSpec.js\").ToolSpec,\n      mergedArgs?: Record<string, unknown>,\n    ) => {\n      const defaultArgs = (spec._meta as { defaultArgs?: Record<string, unknown> } | undefined)?.defaultArgs ?? {};\n      const baseConfig = (config !== undefined ? (config as Record<string, unknown>) : {}) as Record<string, unknown>;\n      const toolOverrides = baseConfig?.toolOverrides as Record<string, Record<string, unknown>> | undefined;\n      const shortName = (spec._meta as { shortName?: string } | undefined)?.shortName ?? spec.name;\n      // Derive package-scoped key (no version): e.g. \"npm.easynet.agent.tool.buildin::fs.listDir\" so config survives package version bumps\n      const prefixWithVersion =\n        shortName && spec.name.endsWith(shortName) && spec.name.length > shortName.length\n          ? spec.name.slice(0, spec.name.length - shortName.length - 1)\n          : \"\";\n      const parts = prefixWithVersion ? prefixWithVersion.split(\".\") : [];\n      const packageScopedKey =\n        parts.length > 1 ? `${parts.slice(0, -1).join(\".\")}::${shortName}` : \"\";\n      const perTool = (toolOverrides?.[spec.name] ??\n        (packageScopedKey ? toolOverrides?.[packageScopedKey] : undefined) ??\n        toolOverrides?.[shortName] ??\n        {}) as Record<string, unknown>;\n      const packagePrefix = parts.length > 1 ? parts.slice(0, -1).join(\".\") : \"\";\n      const packageDefaults = baseConfig?.packageDefaults as Record<string, Record<string, unknown>> | undefined;\n      const packageDefaultsForPkg =\n        (packagePrefix && packageDefaults?.[packagePrefix]) ??\n        (prefixWithVersion && packageDefaults?.[prefixWithVersion]) ??\n        {};\n      const baseWithoutOverrides = { ...baseConfig };\n      delete (baseWithoutOverrides as Record<string, unknown>).toolOverrides;\n      delete (baseWithoutOverrides as Record<string, unknown>).packageDefaults;\n      const resolvedConfig = {\n        ...defaultArgs,\n        ...baseWithoutOverrides,\n        ...packageDefaultsForPkg,\n        ...perTool,\n        ...(mergedArgs ?? {}),\n      } as TContext[\"config\"];\n      return { execCtx, config: resolvedConfig } as TContext;\n    },\n    contextRunner: {\n      runWith(ctx: TContext, fn: () => Promise<ExtensionToolResult>) {\n        return contextRunner.runWith(ctx, fn) as Promise<ExtensionToolResult>;\n      },\n    },\n  });\n  return adapter;\n}\n","/**\n * One-shot extension bootstrap: context runner + register + getContext/runWith.\n * Config can be extension-level (buildConfig) or per-tool only (defaultConfig in opts, merged with tool.yaml).\n */\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { ToolAdapter } from \"../../core/types/ToolSpec.js\";\nimport type { ToolRegistry } from \"../../core/registry/ToolRegistry.js\";\nimport { createContextRunner } from \"./contextRunner.js\";\nimport { registerExtension } from \"./registerExtension.js\";\nimport type { ExtensionToolContext } from \"./types.js\";\n\n/** Pass import.meta so the framework derives packagePath (extension entry does not need path/fileURLToPath). */\nexport interface ImportMetaLike {\n  url: string;\n}\n\n/** Options when config is built from userConfig (buildConfig). */\nexport interface CreateExtensionOptionsWithBuild<TConfig, TUserConfig> {\n  packagePath?: string;\n  importMeta?: ImportMetaLike;\n  kind?: string;\n  buildConfig: (userConfig: TUserConfig) => TConfig;\n}\n\n/** Options when config is per-tool only (each tool's tool.yaml). */\nexport interface CreateExtensionOptionsDefaultOnly {\n  packagePath?: string;\n  importMeta?: ImportMetaLike;\n  kind?: string;\n}\n\n/** Register opts when using per-tool config only: filter tools by name. */\nexport interface RegisterOptionsDefaultOnly {\n  only?: string[];\n  namePrefixes?: string[];\n}\n\nexport type CreateExtensionOptions<TConfig, TUserConfig> =\n  | CreateExtensionOptionsWithBuild<TConfig, TUserConfig>\n  | (CreateExtensionOptionsDefaultOnly & { buildConfig?: never });\n\nexport interface CreateExtensionResult<TConfig, TUserConfig> {\n  register(\n    registry: ToolRegistry,\n    userConfigOrOpts: TUserConfig,\n    options?: { only?: string[]; namePrefixes?: string[] },\n  ): ToolAdapter;\n  getContext(): ExtensionToolContext<TConfig>;\n  runWith<T>(ctx: ExtensionToolContext<TConfig>, fn: () => Promise<T>): Promise<T>;\n}\n\n/**\n * Create an extension. With buildConfig: register(registry, userConfig, opts?).\n * Without buildConfig: register(registry, opts?) where opts = { only?, namePrefixes? }; config comes only from each tool's tool.yaml.\n */\nfunction resolvePackagePath(options: { packagePath?: string; importMeta?: ImportMetaLike }): string {\n  if (options.packagePath != null && options.packagePath !== \"\") return options.packagePath;\n  if (options.importMeta?.url) return path.dirname(fileURLToPath(options.importMeta.url));\n  throw new Error(\"createExtension: provide packagePath or importMeta\");\n}\n\nexport function createExtension<TConfig = Record<string, unknown>, TUserConfig = RegisterOptionsDefaultOnly>(\n  options: CreateExtensionOptions<TConfig, TUserConfig>,\n): CreateExtensionResult<TConfig, TUserConfig> {\n  const packagePath = resolvePackagePath(options);\n  const kind = options.kind;\n  const buildConfig = \"buildConfig\" in options ? options.buildConfig : undefined;\n  type Ctx = ExtensionToolContext<TConfig>;\n  const contextRunner = createContextRunner<Ctx>();\n\n  return {\n    register(registry, userConfigOrOpts, opts) {\n      const config = buildConfig\n        ? (buildConfig as (u: TUserConfig) => TConfig)(userConfigOrOpts as TUserConfig)\n        : (userConfigOrOpts as Record<string, unknown> | undefined);\n      return registerExtension(registry, {\n        packagePath,\n        kind,\n        config,\n        getContextRunner: () => contextRunner,\n        only: opts?.only ?? (userConfigOrOpts as RegisterOptionsDefaultOnly | undefined)?.only,\n        namePrefixes: opts?.namePrefixes ?? (userConfigOrOpts as RegisterOptionsDefaultOnly | undefined)?.namePrefixes,\n      });\n    },\n    getContext(): ExtensionToolContext<TConfig> {\n      return contextRunner.getContext() as ExtensionToolContext<TConfig>;\n    },\n    runWith<T>(ctx: ExtensionToolContext<TConfig>, fn: () => Promise<T>): Promise<T> {\n      return contextRunner.runWith(ctx, fn) as Promise<T>;\n    },\n  };\n}\n","/**\n * Build step: scan project for @tool, emit extension manifest (core-tools-manifest.json) and copy *.tool.yaml / *.example.yaml.\n * Extensions run this at build time; agent-tool reads the manifest when the extension's register is called.\n */\nimport { writeFileSync, mkdirSync, existsSync, readdirSync, copyFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { scanForTools } from \"../../tools/function/scanner.js\";\nimport type { ExtensionManifestEntry } from \"./registerFromManifest.js\";\nimport type { HitlSideEffect } from \"../../core/types/ToolSpec.js\";\n\nexport interface GenerateExtensionManifestOptions {\n  /** Project root (default: process.cwd()). */\n  projectRoot?: string;\n  /** Output directory for manifest and copied tool.yaml (default: projectRoot/dist). */\n  outDir?: string;\n  /** Manifest kind (default: \"core\"). */\n  kind?: string;\n  /** Include globs for TS files (default: all .ts). */\n  include?: string[];\n  /** Path to tsconfig (default: projectRoot/tsconfig.json). */\n  tsconfigPath?: string;\n  /** Subdirs to recursively copy *.tool.yaml and *.example.yaml from (e.g. [\"src\"]). */\n  copyToolYamlDirs?: string[];\n}\n\nfunction copyToolYamlRecursive(srcDir: string, destDir: string): number {\n  if (!existsSync(srcDir)) return 0;\n  let copied = 0;\n  for (const e of readdirSync(srcDir, { withFileTypes: true })) {\n    const srcPath = path.join(srcDir, e.name);\n    const destPath = path.join(destDir, e.name);\n    if (e.isFile() && (e.name.endsWith(\".tool.yaml\") || e.name.endsWith(\".example.yaml\"))) {\n      if (!existsSync(destDir)) mkdirSync(destDir, { recursive: true });\n      copyFileSync(srcPath, destPath);\n      copied++;\n    } else if (e.isDirectory()) {\n      copied += copyToolYamlRecursive(srcPath, destPath);\n    }\n  }\n  return copied;\n}\n\n/**\n * Scan project for @tool, write core-tools-manifest.json and recursively copy *.tool.yaml and *.example.yaml to outDir.\n * Returns the written manifest path and number of tools.\n */\nexport function generateExtensionManifest(\n  projectRoot: string = process.cwd(),\n  options: GenerateExtensionManifestOptions = {},\n): { manifestPath: string; toolsCount: number; toolYamlCopied: number } {\n  const root = path.resolve(projectRoot);\n  const outDir = path.resolve(options.outDir ?? path.join(root, \"dist\"));\n  const kind = options.kind ?? \"core\";\n\n  const { specs, errors } = scanForTools({\n    projectPath: root,\n    include: options.include ?? [\"**/*.ts\"],\n    tsconfigPath: options.tsconfigPath,\n  });\n\n  if (errors.length > 0) {\n    console.warn(\"generateExtensionManifest: scan errors\", errors);\n  }\n\n  const entries: ExtensionManifestEntry[] = specs.map((spec) => {\n    const sourcePathNoExt = (spec.sourcePath ?? \"\").replace(/\\.(ts|tsx)$/i, \"\");\n    const pathBasedName = sourcePathNoExt.replace(/^src\\//, \"\").replace(/\\//g, \".\");\n    const name = spec.exportName ?? pathBasedName;\n    const sideEffect: HitlSideEffect =\n      (spec._meta?.hitl?.sideEffect as HitlSideEffect) ?? \"none\";\n    return {\n      name,\n      description: spec.description ?? sourcePathNoExt,\n      inputSchema: spec.inputSchema ?? { type: \"object\", additionalProperties: true },\n      outputSchema: spec.outputSchema ?? { type: \"object\", additionalProperties: true },\n      sourcePath: sourcePathNoExt,\n      exportName: spec.exportName ?? \"\",\n      sideEffect,\n    };\n  });\n\n  if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });\n  const manifestPath = path.join(outDir, \"core-tools-manifest.json\");\n  writeFileSync(\n    manifestPath,\n    JSON.stringify({ kind, tools: entries }, null, 2),\n    \"utf-8\",\n  );\n\n  let toolYamlCopied = 0;\n  const copyDirs = options.copyToolYamlDirs;\n  if (copyDirs?.length) {\n    for (const d of copyDirs) {\n      const srcDir = path.join(root, d);\n      const destDir = path.join(outDir, d);\n      try {\n        toolYamlCopied += copyToolYamlRecursive(srcDir, destDir);\n      } catch {\n        // ignore\n      }\n    }\n  }\n\n  return { manifestPath, toolsCount: entries.length, toolYamlCopied };\n}\n\n/**\n * Build step for extensions: scan src folder and subfolders, emit manifest, copy tool.yaml.\n * Call from extension's build script (e.g. tsx generate-manifest.ts).\n */\nexport function generateManifest(\n  projectRoot: string = process.cwd(),\n  options: Omit<GenerateExtensionManifestOptions, \"projectRoot\"> = {},\n): void {\n  const { manifestPath, toolsCount, toolYamlCopied } = generateExtensionManifest(projectRoot, {\n    include: [\"src/**/*.ts\"],\n    copyToolYamlDirs: [\"src\"],\n    ...options,\n  });\n  console.log(`Wrote ${toolsCount} tools to ${path.relative(projectRoot, manifestPath)}`);\n  if (toolYamlCopied > 0) console.log(`Copied ${toolYamlCopied} .tool.yaml/.example.yaml file(s) to dist`);\n}\n","/**\n * Convert \"groups\" + \"only\" options and a group→prefix map into only/namePrefixes for registerToolsFromManifest.\n * Extensions define their own group names and prefixes (e.g. fs -> \"core/fs.\").\n */\nexport interface GroupPrefixOptions {\n  /** Only register tools in these groups (e.g. [\"fs\", \"http\"]). */\n  groups?: string[];\n  /** Only register these tool names. Takes precedence over groups. */\n  only?: string[];\n  /** Map group name -> name prefix (e.g. { fs: \"core/fs.\", http: \"core/http.\" }). */\n  groupPrefixMap: Record<string, string>;\n}\n\nexport interface ResolvedOnlyNamePrefixes {\n  only?: string[];\n  namePrefixes?: string[];\n}\n\n/**\n * Resolve groups/only + groupPrefixMap to only and namePrefixes for registerToolsFromManifest.\n */\nexport function getGroupNamePrefixes(options: GroupPrefixOptions): ResolvedOnlyNamePrefixes {\n  const { groups, only, groupPrefixMap } = options;\n  const onlySet = only?.length ? new Set(only) : null;\n  const namePrefixes =\n    !onlySet && groups?.length\n      ? (groups.map((g) => groupPrefixMap[g]).filter((x): x is string => x != null) as string[])\n      : undefined;\n  return {\n    ...(onlySet ? { only: Array.from(onlySet) } : {}),\n    ...(namePrefixes?.length ? { namePrefixes } : {}),\n  };\n}\n"]}

package/dist/extension.d.ts

@@ -1,6 +0,0 @@
-/**
- * Extension authoring subpath export.
- */
-export { createExtension, generateManifest, generateExtensionManifest, registerExtension, registerToolsFromManifest, loadExtensionManifest, loadToolYaml, resolveExtensionPackageRoot, overrideWithConfig, getGroupNamePrefixes, createDynamicImportAdapter, createContextRunner, } from "./api/extension/index.js";
-export type { CreateExtensionOptions, CreateExtensionResult, GenerateExtensionManifestOptions, RegisterExtensionOptions, RegisterFromManifestOptions, ExtensionManifestEntry, LoadedExtensionManifest, ExtensionToolContext, ExtensionToolHandler, DynamicImportAdapterOptions, ExtensionToolResult, ContextRunner, GroupPrefixOptions, ResolvedOnlyNamePrefixes, ImportMetaLike, RegisterOptionsDefaultOnly, } from "./api/extension/index.js";
-//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,YAAY,EACZ,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,gCAAgC,EAChC,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC"}

package/dist/extension.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/api/extension/contextRunner.ts","../src/api/extension/dynamicImportAdapter.ts","../src/api/extension/resolvePackageRoot.ts","../src/api/extension/registerExtension.ts","../src/api/extension/createExtension.ts","../src/api/extension/generateExtensionManifest.ts","../src/api/extension/groupPrefix.ts"],"names":["path","fileURLToPath","existsSync"],"mappings":"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","file":"extension.js","sourcesContent":["/**\n * Generic context injection for extension tools (e.g. builtin).\n * Any extension that needs to inject config (sandbox, allowedHosts, etc.) into handlers uses this.\n */\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport interface ContextRunner<T> {\n  runWith(ctx: T, fn: () => Promise<unknown>): Promise<unknown>;\n  getContext(): T;\n}\n\n/**\n * Create a context runner for an extension. Handlers call getContext() to read config.\n * Adapter calls runWith(ctx, () => handler(args)) so getContext() returns ctx.\n */\nexport function createContextRunner<T>(): ContextRunner<T> {\n  const storage = new AsyncLocalStorage<T>();\n  return {\n    runWith(ctx: T, fn: () => Promise<unknown>): Promise<unknown> {\n      return storage.run(ctx, fn);\n    },\n    getContext(): T {\n      const ctx = storage.getStore();\n      if (ctx === undefined) {\n        throw new Error(\"Extension context not set; invoke only through the extension adapter.\");\n      }\n      return ctx;\n    },\n  };\n}\n","/**\n * Generic adapter for extensions that discover tools via manifest and load handlers by dynamic import.\n * Any extension (builtin, etc.) that uses @tool scan → manifest and runs handlers with injected context uses this.\n */\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { ToolAdapter, ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { Evidence } from \"../../core/types/ToolResult.js\";\n\n/** If spec.inputSchema wraps params in \"args\", return args.args for the handler; else return args. */\nfunction unwrapArgsForHandler(spec: ToolSpec, args: unknown): unknown {\n  if (args == null || typeof args !== \"object\" || Array.isArray(args)) return args;\n  const s = spec.inputSchema as Record<string, unknown>;\n  if (s?.type !== \"object\" || !s.properties || typeof s.properties !== \"object\") return args;\n  const props = s.properties as Record<string, unknown>;\n  const argsProp = props.args;\n  if (\n    argsProp != null &&\n    typeof argsProp === \"object\" &&\n    (argsProp as Record<string, unknown>).type === \"object\" &&\n    (argsProp as Record<string, unknown>).properties != null\n  ) {\n    const obj = args as Record<string, unknown>;\n    if (Object.keys(obj).length === 1 && \"args\" in obj && typeof obj.args === \"object\" && obj.args !== null) {\n      return obj.args;\n    }\n  }\n  return args;\n}\n\nexport interface ExtensionToolResult {\n  result: unknown;\n  evidence: Evidence[];\n}\n\nexport interface DynamicImportAdapterOptions<TContext> {\n  kind: string;\n  packageRoot: string;\n  /**\n   * Build context from execCtx, spec, and merged request args.\n   * Framework merges defaultArgs (tool.yaml) with request args; implementor can merge into ctx.config\n   * so handlers read resolved config from context instead of re-resolving in each handler.\n   */\n  getExtensionContext: (execCtx: ExecContext, spec: ToolSpec, mergedArgs?: Record<string, unknown>) => TContext;\n  contextRunner: { runWith(ctx: TContext, fn: () => Promise<ExtensionToolResult>): Promise<ExtensionToolResult> };\n}\n\n/**\n * Create an adapter that loads handlers by spec._meta.sourcePath and exportName, then runs with extension context.\n */\nexport function createDynamicImportAdapter<TContext>(\n  options: DynamicImportAdapterOptions<TContext>,\n): ToolAdapter {\n  const { kind, packageRoot, getExtensionContext, contextRunner } = options;\n  return {\n    kind: kind as ToolAdapter[\"kind\"],\n    async invoke(\n      spec: ToolSpec,\n      args: unknown,\n      execCtx: ExecContext,\n    ): Promise<{ result: unknown; raw?: unknown }> {\n      const meta = spec._meta as {\n        sourcePath?: string;\n        exportName?: string;\n        defaultArgs?: Record<string, unknown>;\n        packageRoot?: string;\n      } | undefined;\n      const sourcePath = meta?.sourcePath;\n      const exportName = meta?.exportName;\n      if (!sourcePath || !exportName) {\n        throw new Error(`Extension tool ${spec.name} missing _meta.sourcePath or _meta.exportName`);\n      }\n      const defaultArgs = meta?.defaultArgs ?? {};\n      const mergedArgs =\n        Object.keys(defaultArgs).length === 0\n          ? (args as Record<string, unknown>)\n          : { ...defaultArgs, ...(args as Record<string, unknown>) };\n      const handlerArgs = unwrapArgsForHandler(spec, mergedArgs);\n      const resolvedPackageRoot = meta?.packageRoot ?? packageRoot;\n      const modulePath = path.join(resolvedPackageRoot, `${sourcePath}.js`);\n      const mod = await import(pathToFileURL(modulePath).href);\n      const handler = mod[exportName];\n      if (typeof handler !== \"function\") {\n        throw new Error(\n          `Extension tool ${spec.name}: export \"${exportName}\" from ${sourcePath} is not a function`,\n        );\n      }\n      const ctx = getExtensionContext(execCtx, spec, mergedArgs as Record<string, unknown>);\n      const output = await contextRunner.runWith(ctx, () => handler(handlerArgs));\n      // Return full envelope so pipeline output validation (outputSchema: { result, evidence }) passes.\n      return {\n        result: { result: output.result, evidence: output.evidence },\n        raw: { evidence: output.evidence },\n      };\n    },\n  };\n}\n","/**\n * Resolve extension package root for dynamic import (dist when built, else dir).\n * Accepts import.meta.url (file:) or a directory path (e.g. __dirname).\n */\nimport path from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\n\nexport function resolveExtensionPackageRoot(metaUrlOrPath: string): string {\n  const dir = metaUrlOrPath.startsWith(\"file:\")\n    ? path.dirname(fileURLToPath(metaUrlOrPath))\n    : path.resolve(metaUrlOrPath);\n  const dist = path.join(dir, \"dist\");\n  return existsSync(dist) ? dist : dir;\n}\n","/**\n * One-shot: load pre-built manifest from package, register all specs, create adapter.\n * Framework does NOT scan source for @tool; it reads manifest (e.g. core-tools-manifest.json)\n * produced by the extension's build. Extension passes packagePath, config, getContextRunner.\n */\nimport type { ToolAdapter } from \"../../core/types/ToolSpec.js\";\nimport type { ToolRegistry } from \"../../core/registry/ToolRegistry.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { ContextRunner } from \"./contextRunner.js\";\nimport { createDynamicImportAdapter } from \"./dynamicImportAdapter.js\";\nimport type { ExtensionToolResult } from \"./dynamicImportAdapter.js\";\nimport { registerToolsFromManifest, loadExtensionManifest } from \"./registerFromManifest.js\";\nimport { resolveExtensionPackageRoot } from \"./resolvePackageRoot.js\";\n\nexport interface RegisterExtensionOptions<TContext> {\n  /** Package root (e.g. __dirname of extension's entry). Manifest is read from here. */\n  packagePath: string;\n  /** Tool kind; if omitted, uses manifest.kind or \"extension\". */\n  kind?: string;\n  /** Optional default config; merged with each tool's tool.yaml (spec._meta.defaultArgs). Context config = { ...config, ...toolDefaultArgs }. */\n  config?: unknown;\n  /** Returns the context runner (extension's createContextRunner()). */\n  getContextRunner: () => ContextRunner<TContext>;\n  /** Filter: only register these tool names. */\n  only?: string[];\n  /** Filter: only register tools whose name starts with one of these prefixes. */\n  namePrefixes?: string[];\n}\n\n/**\n * Load manifest from package (pre-built JSON; no @tool scanning). Register all specs, create and return adapter.\n */\nexport function registerExtension<TContext extends { execCtx: ExecContext; config: unknown }>(\n  registry: ToolRegistry,\n  options: RegisterExtensionOptions<TContext>,\n): ToolAdapter {\n  const { packagePath, kind: kindOpt, config, getContextRunner, only, namePrefixes } = options;\n  const packageRoot = resolveExtensionPackageRoot(packagePath);\n  const contextRunner = getContextRunner();\n  const loaded = loadExtensionManifest(packagePath);\n  const kind = kindOpt ?? loaded.kind ?? \"extension\";\n\n  registerToolsFromManifest(registry, {\n    manifestPathOrDir: packagePath,\n    kind,\n    only,\n    namePrefixes,\n    packageRoot,\n  });\n\n  const adapter = createDynamicImportAdapter<TContext>({\n    kind,\n    packageRoot,\n    getExtensionContext: (\n      execCtx: ExecContext,\n      spec: import(\"../../core/types/ToolSpec.js\").ToolSpec,\n      mergedArgs?: Record<string, unknown>,\n    ) => {\n      const defaultArgs = (spec._meta as { defaultArgs?: Record<string, unknown> } | undefined)?.defaultArgs ?? {};\n      const baseConfig = (config !== undefined ? (config as Record<string, unknown>) : {}) as Record<string, unknown>;\n      const toolOverrides = baseConfig?.toolOverrides as Record<string, Record<string, unknown>> | undefined;\n      const shortName = (spec._meta as { shortName?: string } | undefined)?.shortName ?? spec.name;\n      // Derive package-scoped key (no version): e.g. \"npm.easynet.agent.tool.buildin::fs.listDir\" so config survives package version bumps\n      const prefixWithVersion =\n        shortName && spec.name.endsWith(shortName) && spec.name.length > shortName.length\n          ? spec.name.slice(0, spec.name.length - shortName.length - 1)\n          : \"\";\n      const parts = prefixWithVersion ? prefixWithVersion.split(\".\") : [];\n      const packageScopedKey =\n        parts.length > 1 ? `${parts.slice(0, -1).join(\".\")}::${shortName}` : \"\";\n      const perTool = (toolOverrides?.[spec.name] ??\n        (packageScopedKey ? toolOverrides?.[packageScopedKey] : undefined) ??\n        toolOverrides?.[shortName] ??\n        {}) as Record<string, unknown>;\n      const packagePrefix = parts.length > 1 ? parts.slice(0, -1).join(\".\") : \"\";\n      const packageDefaults = baseConfig?.packageDefaults as Record<string, Record<string, unknown>> | undefined;\n      const packageDefaultsForPkg =\n        (packagePrefix && packageDefaults?.[packagePrefix]) ??\n        (prefixWithVersion && packageDefaults?.[prefixWithVersion]) ??\n        {};\n      const baseWithoutOverrides = { ...baseConfig };\n      delete (baseWithoutOverrides as Record<string, unknown>).toolOverrides;\n      delete (baseWithoutOverrides as Record<string, unknown>).packageDefaults;\n      const resolvedConfig = {\n        ...defaultArgs,\n        ...baseWithoutOverrides,\n        ...packageDefaultsForPkg,\n        ...perTool,\n        ...(mergedArgs ?? {}),\n      } as TContext[\"config\"];\n      return { execCtx, config: resolvedConfig } as TContext;\n    },\n    contextRunner: {\n      runWith(ctx: TContext, fn: () => Promise<ExtensionToolResult>) {\n        return contextRunner.runWith(ctx, fn) as Promise<ExtensionToolResult>;\n      },\n    },\n  });\n  return adapter;\n}\n","/**\n * One-shot extension bootstrap: context runner + register + getContext/runWith.\n * Config can be extension-level (buildConfig) or per-tool only (defaultConfig in opts, merged with tool.yaml).\n */\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { ToolAdapter } from \"../../core/types/ToolSpec.js\";\nimport type { ToolRegistry } from \"../../core/registry/ToolRegistry.js\";\nimport { createContextRunner } from \"./contextRunner.js\";\nimport { registerExtension } from \"./registerExtension.js\";\nimport type { ExtensionToolContext } from \"./types.js\";\n\n/** Pass import.meta so the framework derives packagePath (extension entry does not need path/fileURLToPath). */\nexport interface ImportMetaLike {\n  url: string;\n}\n\n/** Options when config is built from userConfig (buildConfig). */\nexport interface CreateExtensionOptionsWithBuild<TConfig, TUserConfig> {\n  packagePath?: string;\n  importMeta?: ImportMetaLike;\n  kind?: string;\n  buildConfig: (userConfig: TUserConfig) => TConfig;\n}\n\n/** Options when config is per-tool only (each tool's tool.yaml). */\nexport interface CreateExtensionOptionsDefaultOnly {\n  packagePath?: string;\n  importMeta?: ImportMetaLike;\n  kind?: string;\n}\n\n/** Register opts when using per-tool config only: filter tools by name. */\nexport interface RegisterOptionsDefaultOnly {\n  only?: string[];\n  namePrefixes?: string[];\n}\n\nexport type CreateExtensionOptions<TConfig, TUserConfig> =\n  | CreateExtensionOptionsWithBuild<TConfig, TUserConfig>\n  | (CreateExtensionOptionsDefaultOnly & { buildConfig?: never });\n\nexport interface CreateExtensionResult<TConfig, TUserConfig> {\n  register(\n    registry: ToolRegistry,\n    userConfigOrOpts: TUserConfig,\n    options?: { only?: string[]; namePrefixes?: string[] },\n  ): ToolAdapter;\n  getContext(): ExtensionToolContext<TConfig>;\n  runWith<T>(ctx: ExtensionToolContext<TConfig>, fn: () => Promise<T>): Promise<T>;\n}\n\n/**\n * Create an extension. With buildConfig: register(registry, userConfig, opts?).\n * Without buildConfig: register(registry, opts?) where opts = { only?, namePrefixes? }; config comes only from each tool's tool.yaml.\n */\nfunction resolvePackagePath(options: { packagePath?: string; importMeta?: ImportMetaLike }): string {\n  if (options.packagePath != null && options.packagePath !== \"\") return options.packagePath;\n  if (options.importMeta?.url) return path.dirname(fileURLToPath(options.importMeta.url));\n  throw new Error(\"createExtension: provide packagePath or importMeta\");\n}\n\nexport function createExtension<TConfig = Record<string, unknown>, TUserConfig = RegisterOptionsDefaultOnly>(\n  options: CreateExtensionOptions<TConfig, TUserConfig>,\n): CreateExtensionResult<TConfig, TUserConfig> {\n  const packagePath = resolvePackagePath(options);\n  const kind = options.kind;\n  const buildConfig = \"buildConfig\" in options ? options.buildConfig : undefined;\n  type Ctx = ExtensionToolContext<TConfig>;\n  const contextRunner = createContextRunner<Ctx>();\n\n  return {\n    register(registry, userConfigOrOpts, opts) {\n      const config = buildConfig\n        ? (buildConfig as (u: TUserConfig) => TConfig)(userConfigOrOpts as TUserConfig)\n        : (userConfigOrOpts as Record<string, unknown> | undefined);\n      return registerExtension(registry, {\n        packagePath,\n        kind,\n        config,\n        getContextRunner: () => contextRunner,\n        only: opts?.only ?? (userConfigOrOpts as RegisterOptionsDefaultOnly | undefined)?.only,\n        namePrefixes: opts?.namePrefixes ?? (userConfigOrOpts as RegisterOptionsDefaultOnly | undefined)?.namePrefixes,\n      });\n    },\n    getContext(): ExtensionToolContext<TConfig> {\n      return contextRunner.getContext() as ExtensionToolContext<TConfig>;\n    },\n    runWith<T>(ctx: ExtensionToolContext<TConfig>, fn: () => Promise<T>): Promise<T> {\n      return contextRunner.runWith(ctx, fn) as Promise<T>;\n    },\n  };\n}\n","/**\n * Build step: scan project for @tool, emit extension manifest (core-tools-manifest.json) and copy *.tool.yaml / *.example.yaml.\n * Extensions run this at build time; agent-tool reads the manifest when the extension's register is called.\n */\nimport { writeFileSync, mkdirSync, existsSync, readdirSync, copyFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { scanForTools } from \"../../tools/function/scanner.js\";\nimport type { ExtensionManifestEntry } from \"./registerFromManifest.js\";\nimport type { HitlSideEffect } from \"../../core/types/ToolSpec.js\";\n\nexport interface GenerateExtensionManifestOptions {\n  /** Project root (default: process.cwd()). */\n  projectRoot?: string;\n  /** Output directory for manifest and copied tool.yaml (default: projectRoot/dist). */\n  outDir?: string;\n  /** Manifest kind (default: \"core\"). */\n  kind?: string;\n  /** Include globs for TS files (default: all .ts). */\n  include?: string[];\n  /** Path to tsconfig (default: projectRoot/tsconfig.json). */\n  tsconfigPath?: string;\n  /** Subdirs to recursively copy *.tool.yaml and *.example.yaml from (e.g. [\"src\"]). */\n  copyToolYamlDirs?: string[];\n}\n\nfunction copyToolYamlRecursive(srcDir: string, destDir: string): number {\n  if (!existsSync(srcDir)) return 0;\n  let copied = 0;\n  for (const e of readdirSync(srcDir, { withFileTypes: true })) {\n    const srcPath = path.join(srcDir, e.name);\n    const destPath = path.join(destDir, e.name);\n    if (e.isFile() && (e.name.endsWith(\".tool.yaml\") || e.name.endsWith(\".example.yaml\"))) {\n      if (!existsSync(destDir)) mkdirSync(destDir, { recursive: true });\n      copyFileSync(srcPath, destPath);\n      copied++;\n    } else if (e.isDirectory()) {\n      copied += copyToolYamlRecursive(srcPath, destPath);\n    }\n  }\n  return copied;\n}\n\n/**\n * Scan project for @tool, write core-tools-manifest.json and recursively copy *.tool.yaml and *.example.yaml to outDir.\n * Returns the written manifest path and number of tools.\n */\nexport function generateExtensionManifest(\n  projectRoot: string = process.cwd(),\n  options: GenerateExtensionManifestOptions = {},\n): { manifestPath: string; toolsCount: number; toolYamlCopied: number } {\n  const root = path.resolve(projectRoot);\n  const outDir = path.resolve(options.outDir ?? path.join(root, \"dist\"));\n  const kind = options.kind ?? \"core\";\n\n  const { specs, errors } = scanForTools({\n    projectPath: root,\n    include: options.include ?? [\"**/*.ts\"],\n    tsconfigPath: options.tsconfigPath,\n  });\n\n  if (errors.length > 0) {\n    console.warn(\"generateExtensionManifest: scan errors\", errors);\n  }\n\n  const entries: ExtensionManifestEntry[] = specs.map((spec) => {\n    const sourcePathNoExt = (spec.sourcePath ?? \"\").replace(/\\.(ts|tsx)$/i, \"\");\n    const pathBasedName = sourcePathNoExt.replace(/^src\\//, \"\").replace(/\\//g, \".\");\n    const name = spec.exportName ?? pathBasedName;\n    const sideEffect: HitlSideEffect =\n      (spec._meta?.hitl?.sideEffect as HitlSideEffect) ?? \"none\";\n    return {\n      name,\n      description: spec.description ?? sourcePathNoExt,\n      inputSchema: spec.inputSchema ?? { type: \"object\", additionalProperties: true },\n      outputSchema: spec.outputSchema ?? { type: \"object\", additionalProperties: true },\n      sourcePath: sourcePathNoExt,\n      exportName: spec.exportName ?? \"\",\n      sideEffect,\n    };\n  });\n\n  if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });\n  const manifestPath = path.join(outDir, \"core-tools-manifest.json\");\n  writeFileSync(\n    manifestPath,\n    JSON.stringify({ kind, tools: entries }, null, 2),\n    \"utf-8\",\n  );\n\n  let toolYamlCopied = 0;\n  const copyDirs = options.copyToolYamlDirs;\n  if (copyDirs?.length) {\n    for (const d of copyDirs) {\n      const srcDir = path.join(root, d);\n      const destDir = path.join(outDir, d);\n      try {\n        toolYamlCopied += copyToolYamlRecursive(srcDir, destDir);\n      } catch {\n        // ignore\n      }\n    }\n  }\n\n  return { manifestPath, toolsCount: entries.length, toolYamlCopied };\n}\n\n/**\n * Build step for extensions: scan src folder and subfolders, emit manifest, copy tool.yaml.\n * Call from extension's build script (e.g. tsx generate-manifest.ts).\n */\nexport function generateManifest(\n  projectRoot: string = process.cwd(),\n  options: Omit<GenerateExtensionManifestOptions, \"projectRoot\"> = {},\n): void {\n  const { manifestPath, toolsCount, toolYamlCopied } = generateExtensionManifest(projectRoot, {\n    include: [\"src/**/*.ts\"],\n    copyToolYamlDirs: [\"src\"],\n    ...options,\n  });\n  console.log(`Wrote ${toolsCount} tools to ${path.relative(projectRoot, manifestPath)}`);\n  if (toolYamlCopied > 0) console.log(`Copied ${toolYamlCopied} .tool.yaml/.example.yaml file(s) to dist`);\n}\n","/**\n * Convert \"groups\" + \"only\" options and a group→prefix map into only/namePrefixes for registerToolsFromManifest.\n * Extensions define their own group names and prefixes (e.g. fs -> \"core/fs.\").\n */\nexport interface GroupPrefixOptions {\n  /** Only register tools in these groups (e.g. [\"fs\", \"http\"]). */\n  groups?: string[];\n  /** Only register these tool names. Takes precedence over groups. */\n  only?: string[];\n  /** Map group name -> name prefix (e.g. { fs: \"core/fs.\", http: \"core/http.\" }). */\n  groupPrefixMap: Record<string, string>;\n}\n\nexport interface ResolvedOnlyNamePrefixes {\n  only?: string[];\n  namePrefixes?: string[];\n}\n\n/**\n * Resolve groups/only + groupPrefixMap to only and namePrefixes for registerToolsFromManifest.\n */\nexport function getGroupNamePrefixes(options: GroupPrefixOptions): ResolvedOnlyNamePrefixes {\n  const { groups, only, groupPrefixMap } = options;\n  const onlySet = only?.length ? new Set(only) : null;\n  const namePrefixes =\n    !onlySet && groups?.length\n      ? (groups.map((g) => groupPrefixMap[g]).filter((x): x is string => x != null) as string[])\n      : undefined;\n  return {\n    ...(onlySet ? { only: Array.from(onlySet) } : {}),\n    ...(namePrefixes?.length ? { namePrefixes } : {}),\n  };\n}\n"]}