@botbotgo/kit 1.0.104

package/dist/chunk-IVL4TBFB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/registry/ToolRegistry.ts","../src/core/runtime/Retry.ts","../src/security/sandbox.ts"],"names":[],"mappings":"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","file":"chunk-IVL4TBFB.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","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","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/chunk-JW4EMVTE.cjs

@@ -0,0 +1,553 @@
+'use strict';
+
+var path = require('path');
+var fs = require('fs');
+var ts2 = require('typescript');
+var promises = require('fs/promises');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var path__namespace = /*#__PURE__*/_interopNamespace(path);
+var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
+var ts2__namespace = /*#__PURE__*/_interopNamespace(ts2);
+
+// src/tools/function/scanner.ts
+async function findDirsContainingFile(rootPath, fileName) {
+  const found = [];
+  await collectDirsWithFile(rootPath, fileName, found);
+  return found;
+}
+async function collectDirsWithFile(dir, fileName, acc) {
+  let entries;
+  try {
+    const e = await promises.readdir(dir, { withFileTypes: true });
+    entries = e.map((x) => ({
+      name: x.name,
+      isDirectory: x.isDirectory(),
+      isFile: x.isFile()
+    }));
+  } catch {
+    return;
+  }
+  if (entries.some((x) => x.isFile && x.name === fileName)) acc.push(dir);
+  for (const entry of entries) {
+    if (!entry.isDirectory || entry.name === "node_modules" || entry.name.startsWith(".")) continue;
+    await collectDirsWithFile(path.join(dir, entry.name), fileName, acc);
+  }
+}
+function pathToToolName(sourcePath, programName) {
+  const normalized = sourcePath.replace(/\\/g, "/").replace(/\.(ts|tsx|js|mjs|json)$/i, "");
+  const segments = normalized.split("/").filter(Boolean);
+  return segments.length === 0 ? programName : `${segments.join(".")}.${programName}`;
+}
+function buildOutputSchemaFromReturnType(node, typeChecker, onWarn) {
+  const sig = typeChecker.getSignatureFromDeclaration(node);
+  if (!sig) {
+    onWarn?.("Could not get signature for return type, using object");
+    return { type: "object", additionalProperties: true };
+  }
+  let returnType = typeChecker.getReturnTypeOfSignature(sig);
+  if (returnType.getSymbol?.()?.getName() === "Promise") {
+    const typeArgs = returnType.typeArguments;
+    if (typeArgs?.[0]) returnType = typeArgs[0];
+  }
+  const schema = typeToJsonSchema(returnType, typeChecker, onWarn);
+  const hasProps = typeof schema === "object" && schema.type === "object" && Object.keys(schema.properties ?? {}).length > 0;
+  return hasProps ? schema : { type: "object", additionalProperties: true };
+}
+function buildInputSchemaFromParams(node, typeChecker, onWarn) {
+  const properties = {};
+  const required = [];
+  if (!node.parameters.length) {
+    return { schema: { type: "object", properties: {} }, required: [] };
+  }
+  for (const param of node.parameters) {
+    const name = param.name.getText();
+    if (name.startsWith("_") && name.length <= 2) continue;
+    const sym = param.symbol;
+    const paramType = sym ? typeChecker.getTypeOfSymbolAtLocation(sym, param) : typeChecker.getTypeAtLocation(param);
+    const isOptional = !!param.questionToken || param.initializer !== void 0;
+    const propSchema = typeToJsonSchema(paramType, typeChecker, onWarn);
+    properties[name] = propSchema;
+    if (!isOptional) required.push(name);
+  }
+  const paramNames = Object.keys(properties);
+  if (paramNames.length === 1) {
+    const soleName = paramNames[0];
+    const inner = properties[soleName];
+    if (inner && typeof inner === "object" && inner.type === "object" && inner.properties && typeof inner.properties === "object") {
+      return {
+        schema: {
+          type: "object",
+          properties: inner.properties,
+          ...Array.isArray(inner.required) && inner.required.length > 0 ? { required: inner.required } : {},
+          ...inner.additionalProperties !== void 0 ? { additionalProperties: inner.additionalProperties } : {}
+        },
+        required: inner.required ?? []
+      };
+    }
+  }
+  return {
+    schema: {
+      type: "object",
+      properties,
+      ...required.length > 0 ? { required } : {}
+    },
+    required
+  };
+}
+function typeToJsonSchema(type, typeChecker, onWarn) {
+  const flags = type.flags;
+  if (flags & ts2__namespace.TypeFlags.String) return { type: "string" };
+  if (flags & ts2__namespace.TypeFlags.Number) return { type: "number" };
+  if (flags & ts2__namespace.TypeFlags.Boolean) return { type: "boolean" };
+  if (flags & ts2__namespace.TypeFlags.BooleanLiteral) return { type: "boolean" };
+  if (flags & ts2__namespace.TypeFlags.Null) return { type: "null" };
+  if (flags & ts2__namespace.TypeFlags.Undefined || flags & ts2__namespace.TypeFlags.Void) return {};
+  if (flags & ts2__namespace.TypeFlags.Any || flags & ts2__namespace.TypeFlags.Unknown) {
+    onWarn?.(`Unsupported type: any/unknown, using empty schema`);
+    return {};
+  }
+  if (type.isUnion?.()) {
+    const union = type;
+    const types = union.types;
+    const withoutUndef = types.filter(
+      (t) => !(t.flags & ts2__namespace.TypeFlags.Undefined) && !(t.flags & ts2__namespace.TypeFlags.Void)
+    );
+    if (withoutUndef.length === 1) return typeToJsonSchema(withoutUndef[0], typeChecker, onWarn);
+    if (withoutUndef.length === 0) return {};
+    const stringEnumValues = [];
+    let allStringLiterals = true;
+    for (const t of withoutUndef) {
+      if (t.flags & ts2__namespace.TypeFlags.StringLiteral) {
+        const lit = t;
+        if (typeof lit.value === "string") stringEnumValues.push(lit.value);
+      } else {
+        allStringLiterals = false;
+        break;
+      }
+    }
+    if (allStringLiterals && stringEnumValues.length > 0) {
+      return { type: "string", enum: [...new Set(stringEnumValues)] };
+    }
+    let allBooleanLiterals = true;
+    for (const t of withoutUndef) {
+      if (!(t.flags & ts2__namespace.TypeFlags.BooleanLiteral)) {
+        allBooleanLiterals = false;
+        break;
+      }
+    }
+    if (allBooleanLiterals) return { type: "boolean" };
+  }
+  if (flags & ts2__namespace.TypeFlags.StringLiteral) {
+    const lit = type;
+    if (typeof lit.value === "string") {
+      return { type: "string", enum: [lit.value] };
+    }
+    return { type: "string" };
+  }
+  if (typeChecker.isArrayType(type)) {
+    const typeRef = type;
+    const typeArgs = typeRef.typeArguments;
+    const itemType = typeArgs?.[0];
+    const items = itemType ? typeToJsonSchema(itemType, typeChecker, onWarn) : {};
+    return { type: "array", items: Object.keys(items).length ? items : {} };
+  }
+  const str = typeChecker.typeToString(type);
+  if (str === "string") return { type: "string" };
+  if (str === "number") return { type: "number" };
+  if (str === "boolean") return { type: "boolean" };
+  if (str.endsWith("[]")) {
+    const inner = str.slice(0, -2).trim();
+    const itemType = inner === "string" ? { type: "string" } : inner === "number" ? { type: "number" } : {};
+    return { type: "array", items: itemType };
+  }
+  if (type.getProperties && type.getProperties().length >= 0) {
+    const props = type.getProperties();
+    const properties = {};
+    const required = [];
+    for (const p of props) {
+      const decl = p.valueDeclaration;
+      const propType = decl ? typeChecker.getTypeAtLocation(decl) : typeChecker.getTypeOfSymbolAtLocation(p, p.valueDeclaration);
+      const optional = decl && ts2__namespace.isPropertySignature(decl) ? !!decl.questionToken : false;
+      properties[p.name] = typeToJsonSchema(propType, typeChecker, onWarn);
+      if (!optional) required.push(p.name);
+    }
+    return { type: "object", properties, ...required.length ? { required } : {} };
+  }
+  onWarn?.(`Unsupported type: ${str}, using object`);
+  return { type: "object" };
+}
+
+// src/tools/function/types.ts
+var FUNCTION_KIND = "function";
+
+// src/core/types/ToolSpec.ts
+function normalizeToolName(name) {
+  if (typeof name !== "string" || !name) return name;
+  return name.replace(/[^a-zA-Z0-9]/g, ".").replace(/\.+/g, ".");
+}
+var DEFAULT_INPUT_SCHEMA = {
+  type: "object",
+  additionalProperties: true
+};
+var DEFAULT_OUTPUT_SCHEMA = {
+  type: "object",
+  additionalProperties: true
+};
+function createToolSpec(opts) {
+  const sideEffect = opts.sideEffect ?? "none";
+  const name = normalizeToolName(opts.name);
+  return {
+    name,
+    version: opts.version ?? "1.0.0",
+    kind: opts.kind,
+    description: opts.description,
+    tags: opts.tags,
+    inputSchema: opts.inputSchema ?? DEFAULT_INPUT_SCHEMA,
+    outputSchema: opts.outputSchema ?? DEFAULT_OUTPUT_SCHEMA,
+    capabilities: opts.capabilities,
+    costHints: opts.costHints,
+    _meta: { hitl: { sideEffect } }
+  };
+}
+
+// src/tools/skill/types.ts
+var SKILL_KIND = "skill";
+var SKILL_DIR_NAME = "skill";
+
+// src/tools/n8n/types.ts
+var N8N_KIND = "n8n";
+
+// src/tools/mcp/mcpSpecToToolSpec.ts
+var DEFAULT_OUTPUT = { type: "object", additionalProperties: true };
+function mcpSpecToToolSpec(spec, projectPath) {
+  const base = {
+    name: spec.name,
+    version: "1.0.0",
+    kind: spec.kind,
+    description: spec.description,
+    inputSchema: spec.inputSchema ?? DEFAULT_OUTPUT,
+    outputSchema: "outputSchema" in spec && spec.outputSchema ? spec.outputSchema : DEFAULT_OUTPUT_SCHEMA,
+    capabilities: [],
+    _meta: spec._meta,
+    ...spec.kind === N8N_KIND && "webhookUrl" in spec && spec.webhookUrl ? { endpoint: spec.webhookUrl } : {}
+  };
+  if (spec.kind === FUNCTION_KIND && "sourcePath" in spec && "exportName" in spec) {
+    base._meta = {
+      ...base._meta,
+      sourcePath: spec.sourcePath,
+      exportName: spec.exportName,
+      ...projectPath && { projectPath }
+    };
+  }
+  if (spec.kind === SKILL_KIND && "sourcePath" in spec && projectPath) {
+    base._meta = { ...base._meta, sourcePath: spec.sourcePath, projectPath };
+  }
+  if (spec.kind === N8N_KIND && "sourcePath" in spec && projectPath) {
+    base._meta = { ...base._meta, sourcePath: spec.sourcePath, projectPath };
+  }
+  return base;
+}
+
+// src/tools/function/scanner.ts
+var TOOL_TAG = "@tool";
+var EFFECT_VALUES = ["none", "local_write", "external_write", "destructive"];
+function scanForTools(options) {
+  const projectPath = path__namespace.resolve(options.projectPath);
+  const tsconfigPath = options.tsconfigPath ?? path__namespace.join(projectPath, "tsconfig.json");
+  const include = options.include ?? ["**/*.ts"];
+  const errors = [];
+  const warnings = [];
+  const config = loadParsedCommandLine({
+    projectPath,
+    tsconfigPath,
+    include,
+    errors});
+  if (!config) return { specs: [], errors, warnings };
+  const program = ts2__namespace.createProgram(config.fileNames, config.options);
+  const typeChecker = program.getTypeChecker();
+  const specs = [];
+  const configFileSet = new Set(config.fileNames.map((f) => path__namespace.resolve(f)));
+  collectToolSpecsFromProgram({
+    program,
+    typeChecker,
+    projectPath,
+    warnings,
+    configFileSet,
+    specs
+  });
+  return { specs, errors, warnings };
+}
+function loadParsedCommandLine(input) {
+  let configPathResolved = path__namespace.resolve(input.projectPath, input.tsconfigPath);
+  if (!fs__namespace.existsSync(configPathResolved)) {
+    configPathResolved = path__namespace.join(input.projectPath, "tsconfig.json");
+  }
+  if (!fs__namespace.existsSync(configPathResolved)) {
+    return {
+      options: {
+        target: ts2__namespace.ScriptTarget.ES2022,
+        module: ts2__namespace.ModuleKind.ESNext,
+        moduleResolution: ts2__namespace.ModuleResolutionKind.NodeNext,
+        strict: true,
+        skipLibCheck: true,
+        noEmit: true
+      },
+      fileNames: resolveGlob(input.projectPath, input.include),
+      errors: []
+    };
+  }
+  const configFile = ts2__namespace.readConfigFile(configPathResolved, ts2__namespace.sys.readFile);
+  if (configFile.error) {
+    input.errors.push({ file: configPathResolved, message: String(configFile.error.messageText) });
+    return null;
+  }
+  const parsed = ts2__namespace.parseJsonConfigFileContent(
+    configFile.config,
+    ts2__namespace.sys,
+    path__namespace.dirname(configPathResolved)
+  );
+  if (parsed.errors.length === 0) return parsed;
+  for (const e of parsed.errors) {
+    input.errors.push({ file: e.file?.fileName ?? "tsconfig", message: String(e.messageText) });
+  }
+  return null;
+}
+function collectToolSpecsFromProgram(input) {
+  for (const sourceFile of input.program.getSourceFiles()) {
+    const fileName = sourceFile.fileName;
+    if (fileName.includes("node_modules") || fileName.endsWith(".d.ts")) continue;
+    if (!input.configFileSet.has(path__namespace.resolve(fileName))) continue;
+    ts2__namespace.forEachChild(sourceFile, (node) => {
+      const spec = toFunctionToolSpec({
+        node,
+        fileName,
+        projectPath: input.projectPath,
+        typeChecker: input.typeChecker,
+        warnings: input.warnings
+      });
+      if (spec) input.specs.push(spec);
+    });
+  }
+}
+function toFunctionToolSpec(input) {
+  const decl = getExportedFunctionDeclaration(input.node);
+  if (!decl || !decl.name) return null;
+  const host = getJSDocHost(decl.func);
+  if (!hasToolTag(host)) return null;
+  const jsDoc = getJSDocComments(host);
+  const description = getDescription(jsDoc);
+  if (!description) {
+    input.warnings.push({
+      file: input.fileName,
+      message: `Tool ${decl.name}: missing description, using humanized name`
+    });
+  }
+  const sideEffect = getEffect(host);
+  const onWarn = (msg) => input.warnings.push({ file: input.fileName, message: `${decl.name}: ${msg}` });
+  const { schema } = buildInputSchemaFromParams(decl.func, input.typeChecker, onWarn);
+  const outputSchema = buildOutputSchemaFromReturnType(decl.func, input.typeChecker, onWarn);
+  const sourcePath = path__namespace.relative(input.projectPath, input.fileName) || path__namespace.basename(input.fileName);
+  const toolName = pathToToolName(sourcePath, decl.name);
+  return {
+    kind: FUNCTION_KIND,
+    name: toolName,
+    description: description || humanize(decl.name),
+    inputSchema: normalizeInputSchema(schema),
+    outputSchema,
+    _meta: { hitl: { sideEffect } },
+    sourcePath,
+    exportName: decl.name
+  };
+}
+function normalizeInputSchema(schema) {
+  return Object.keys(schema.properties ?? {}).length > 0 ? schema : { type: "object", properties: {} };
+}
+function resolveGlob(projectPath, patterns) {
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  const add = (f) => {
+    const abs = path__namespace.resolve(f);
+    if (f.endsWith(".ts") && !f.endsWith(".d.ts") && !seen.has(abs)) {
+      seen.add(abs);
+      result.push(abs);
+    }
+  };
+  for (const p of patterns) {
+    const full = path__namespace.join(projectPath, p);
+    if (full.includes("*")) {
+      const baseDir = full.replace(/\*\*\/.*$/, "").replace(/\*.*$/, "").replace(/\/?$/, "") || ".";
+      const dir = path__namespace.resolve(projectPath, baseDir);
+      if (fs__namespace.existsSync(dir)) walk(dir, add);
+    } else {
+      const resolved = path__namespace.resolve(projectPath, full);
+      if (fs__namespace.existsSync(resolved)) {
+        if (fs__namespace.statSync(resolved).isFile()) add(resolved);
+        else walk(resolved, add);
+      }
+    }
+  }
+  if (result.length > 0) return result;
+  const srcDir = path__namespace.join(projectPath, "src");
+  if (fs__namespace.existsSync(srcDir)) return walkCollect(srcDir);
+  return [];
+}
+function walkCollect(dir) {
+  const out = [];
+  walk(dir, (fullPath) => {
+    if (fullPath.endsWith(".ts") && !fullPath.endsWith(".d.ts")) out.push(path__namespace.resolve(fullPath));
+  });
+  return out;
+}
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "generated", "dist"]);
+function walk(dir, visit) {
+  try {
+    const entries = fs__namespace.readdirSync(dir, { withFileTypes: true });
+    for (const e of entries) {
+      const full = path__namespace.join(dir, e.name);
+      if (e.isDirectory() && !SKIP_DIRS.has(e.name)) walk(full, visit);
+      else if (e.isFile()) visit(full);
+    }
+  } catch {
+  }
+}
+function getExportedFunctionDeclaration(node, _sourceFile) {
+  if (ts2__namespace.isFunctionDeclaration(node) && node.name) {
+    const exported = (ts2__namespace.getModifiers(node) ?? []).some((m) => m.kind === ts2__namespace.SyntaxKind.ExportKeyword);
+    if (exported) return { func: node, name: node.name.getText() };
+    return null;
+  }
+  if (ts2__namespace.isVariableStatement(node)) {
+    const exported = (ts2__namespace.getModifiers(node) ?? []).some((m) => m.kind === ts2__namespace.SyntaxKind.ExportKeyword);
+    if (!exported) return null;
+    for (const decl of node.declarationList.declarations) {
+      let init = decl.initializer;
+      while (init && (ts2__namespace.isParenthesizedExpression(init) || ts2__namespace.isAsExpression(init)))
+        init = init.expression;
+      if (init && ts2__namespace.isArrowFunction(init)) {
+        const name = decl.name.getText();
+        return { func: init, name };
+      }
+      if (init && ts2__namespace.isFunctionExpression(init)) {
+        const name = decl.name.getText();
+        return { func: init, name };
+      }
+    }
+  }
+  return null;
+}
+function getJSDocHost(node) {
+  const parent = node.parent;
+  if (ts2__namespace.isVariableDeclaration(parent)) {
+    const gp = parent.parent;
+    if (ts2__namespace.isVariableDeclarationList(gp) && gp.parent && ts2__namespace.isVariableStatement(gp.parent)) return gp.parent;
+  }
+  return node;
+}
+function getJSDocComments(host) {
+  const all = ts2__namespace.getJSDocCommentsAndTags(host);
+  return all.filter((t) => ts2__namespace.isJSDoc(t));
+}
+function hasToolTag(host) {
+  const tags = ts2__namespace.getJSDocTags(host);
+  for (const tag of tags) {
+    const name = tag.tagName?.getText() ?? "";
+    if (name === "tool") return true;
+  }
+  const all = ts2__namespace.getJSDocCommentsAndTags(host);
+  for (const t of all) {
+    if (ts2__namespace.isJSDoc(t)) {
+      const full = t.getFullText();
+      if (full.includes(TOOL_TAG)) return true;
+    }
+  }
+  return false;
+}
+function getDescription(jsDocs) {
+  for (const doc of jsDocs) {
+    const comment = doc.comment;
+    if (typeof comment === "string") {
+      const first = comment.split(/\n/)[0]?.trim() ?? "";
+      if (first && !first.startsWith("@")) return first;
+    }
+    if (Array.isArray(comment)) {
+      const first = comment[0];
+      if (first && typeof first === "object" && "text" in first) {
+        const t = first.text.trim();
+        if (t && !t.startsWith("@")) return t;
+      }
+    }
+    const full = doc.getFullText();
+    const match = full.match(/\*\s*@tool\s+(.+?)(?=\n|$|\*\/)/s);
+    if (match?.[1]) return match[1].trim();
+  }
+  return "";
+}
+function getEffect(host) {
+  const tags = ts2__namespace.getJSDocTags(host);
+  for (const tag of tags) {
+    const name = tag.tagName?.getText() ?? "";
+    if (name === "effect") {
+      const comment = tag.comment;
+      const v = (typeof comment === "string" ? comment : "").trim().toLowerCase();
+      if (EFFECT_VALUES.includes(v)) return v;
+    }
+  }
+  const all = ts2__namespace.getJSDocCommentsAndTags(host);
+  for (const t of all) {
+    if (ts2__namespace.isJSDoc(t)) {
+      const full = t.getFullText();
+      const match = full.match(/\*\s*@effect\s+(\w+)/);
+      if (match && EFFECT_VALUES.includes(match[1])) return match[1];
+    }
+  }
+  return "none";
+}
+function humanize(name) {
+  return name.replace(/([A-Z])/g, " $1").replace(/^./, (s) => s.toUpperCase()).trim();
+}
+function scan(projectPath, options = {}) {
+  const root = path__namespace.resolve(projectPath);
+  const result = scanForTools({
+    projectPath: root,
+    include: options.include ?? ["**/*.ts"],
+    tsconfigPath: options.tsconfigPath
+  });
+  const specs = result.specs.map((s) => mcpSpecToToolSpec(s, root));
+  return Promise.resolve({
+    specs,
+    errors: result.errors,
+    warnings: result.warnings
+  });
+}
+
+exports.FUNCTION_KIND = FUNCTION_KIND;
+exports.N8N_KIND = N8N_KIND;
+exports.SKILL_DIR_NAME = SKILL_DIR_NAME;
+exports.SKILL_KIND = SKILL_KIND;
+exports.createToolSpec = createToolSpec;
+exports.findDirsContainingFile = findDirsContainingFile;
+exports.mcpSpecToToolSpec = mcpSpecToToolSpec;
+exports.normalizeToolName = normalizeToolName;
+exports.pathToToolName = pathToToolName;
+exports.scan = scan;
+exports.scanForTools = scanForTools;
+//# sourceMappingURL=chunk-JW4EMVTE.cjs.map
+//# sourceMappingURL=chunk-JW4EMVTE.cjs.map