@sponsio/sdk 0.1.0-alpha.3 → 0.2.0-alpha.4

package/dist/cli/export.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExportCli = runExportCli;
+/**
+ * ``sponsio export`` — convert Sponsio-native trace dumps to OTLP JSON.
+ *
+ * Mirrors the Python ``sponsio export`` command. Input is either a
+ * single ``.json`` file (a `Trace.export()` dump) or a directory of
+ * them; output is per-source-file OTLP JSON written into ``--to``,
+ * filenames prefixed with ``--label`` so they're ready for
+ * ``sponsio eval``.
+ *
+ * Event-type coverage is intentionally narrow: this command produces
+ * tool_call spans plus a generic fallback for unknown event types.
+ * LLM spans (``llm_request`` / ``llm_response``) are emitted as a
+ * single fallback span — full OTLP gen-ai parity stays in the Python
+ * exporter.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const HELP = "sponsio export — Sponsio-native trace dumps -> OTLP JSON\n" +
+    "\n" +
+    "USAGE:\n" +
+    "  sponsio export <source> --to <dir> [options]\n" +
+    "\n" +
+    "ARGUMENTS:\n" +
+    "  <source>     Single .json file or directory of Sponsio native trace dumps\n" +
+    "\n" +
+    "OPTIONS:\n" +
+    "      --to <dir>          Output directory for OTLP-JSON files (required)\n" +
+    "      --label <l>         Filename prefix: safe | unsafe | none (default: safe)\n" +
+    "      --agent <id>        Override service.name in the OTLP output\n" +
+    "      --glob <pattern>    Only convert files matching pattern (dir mode, default: *.json)\n" +
+    "  -h, --help              Show this help\n" +
+    "\n" +
+    "EXAMPLES:\n" +
+    "  sponsio export run.json --to traces/\n" +
+    "  sponsio export /var/log/sponsio/ --to traces/ --label unsafe\n";
+const BASE_NS = 1700000000000000000n; // BigInt for exact ns math
+const STEP_NS = 1000000000n;
+function attr(key, value) {
+    if (typeof value === "boolean")
+        return { key, value: { boolValue: value } };
+    if (typeof value === "number") {
+        if (Number.isInteger(value))
+            return { key, value: { intValue: String(value) } };
+        return { key, value: { doubleValue: value } };
+    }
+    if (typeof value === "string")
+        return { key, value: { stringValue: value } };
+    return { key, value: { stringValue: String(value) } };
+}
+function spanTimeNs(ts) {
+    return BASE_NS + BigInt(ts) * STEP_NS;
+}
+function buildToolSpan(ev) {
+    const startNs = spanTimeNs(ev.ts ?? 0);
+    const endNs = startNs + 500000000n;
+    const attrs = [];
+    for (const [k, v] of Object.entries(ev.args ?? {})) {
+        attrs.push(attr(`args.${k}`, v));
+    }
+    if (ev.content !== undefined)
+        attrs.push(attr("tool.output", ev.content));
+    const span = {
+        traceId: "0".repeat(32),
+        spanId: (ev.ts ?? 0).toString(16).padStart(16, "0"),
+        name: ev.tool ?? "tool_call",
+        startTimeUnixNano: startNs.toString(),
+        endTimeUnixNano: endNs.toString(),
+        status: { code: 1 },
+    };
+    if (attrs.length)
+        span.attributes = attrs;
+    return span;
+}
+function buildFallbackSpan(ev) {
+    const startNs = spanTimeNs(ev.ts ?? 0);
+    const endNs = startNs + 500000000n;
+    const attrs = [];
+    if (ev.tool !== undefined)
+        attrs.push(attr("sponsio.tool", ev.tool));
+    if (ev.key !== undefined)
+        attrs.push(attr("sponsio.key", ev.key));
+    if (ev.contains !== undefined)
+        attrs.push(attr("sponsio.contains", ev.contains.join(",")));
+    if (ev.to !== undefined)
+        attrs.push(attr("sponsio.to", ev.to));
+    if (ev.content !== undefined)
+        attrs.push(attr("sponsio.content", ev.content));
+    const span = {
+        traceId: "0".repeat(32),
+        spanId: (ev.ts ?? 0).toString(16).padStart(16, "0"),
+        name: ev.event_type ?? "event",
+        startTimeUnixNano: startNs.toString(),
+        endTimeUnixNano: endNs.toString(),
+        status: { code: 1 },
+    };
+    if (attrs.length)
+        span.attributes = attrs;
+    return span;
+}
+function eventToSpan(ev) {
+    if (ev.event_type === "tool_call" || ev.tool)
+        return buildToolSpan(ev);
+    return buildFallbackSpan(ev);
+}
+function traceToOtlp(trace, agentId) {
+    const resolvedAgent = agentId ?? trace.metadata?.agent_id ?? trace.events[0]?.agent ?? "agent";
+    const spans = (trace.events ?? []).map(eventToSpan);
+    return {
+        resourceSpans: [
+            {
+                resource: { attributes: [attr("service.name", resolvedAgent)] },
+                scopeSpans: [{ scope: { name: "sponsio" }, spans }],
+            },
+        ],
+    };
+}
+function listSources(source, glob) {
+    const abs = (0, node_path_1.resolve)(source);
+    const st = (0, node_fs_1.statSync)(abs);
+    if (st.isFile())
+        return [abs];
+    // Trivial glob: only support ``*.ext`` form, since OTel files are conventional.
+    const m = /^\*(\.[a-z0-9]+)$/i.exec(glob);
+    const ext = m ? m[1].toLowerCase() : ".json";
+    return (0, node_fs_1.readdirSync)(abs)
+        .filter((f) => f.toLowerCase().endsWith(ext))
+        .map((f) => (0, node_path_1.join)(abs, f))
+        .sort();
+}
+async function runExportCli(argv) {
+    let source;
+    let target;
+    let label = "safe";
+    let agentId;
+    let glob = "*.json";
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "-h" || a === "--help") {
+            process.stdout.write(HELP);
+            return;
+        }
+        if (a === "--to") {
+            target = argv[++i];
+            continue;
+        }
+        if (a === "--label") {
+            const v = argv[++i];
+            if (v !== "safe" && v !== "unsafe" && v !== "none") {
+                process.stderr.write(`--label must be safe|unsafe|none (got ${v})\n`);
+                process.exit(2);
+            }
+            label = v;
+            continue;
+        }
+        if (a === "--agent") {
+            agentId = argv[++i];
+            continue;
+        }
+        if (a === "--glob") {
+            glob = argv[++i];
+            continue;
+        }
+        if (a.startsWith("-")) {
+            process.stderr.write(`unknown flag: ${a}\n${HELP}`);
+            process.exit(2);
+        }
+        if (source) {
+            process.stderr.write(`extra positional argument: ${a}\n${HELP}`);
+            process.exit(2);
+        }
+        source = a;
+    }
+    if (!source) {
+        process.stderr.write(`Error: source required\n\n${HELP}`);
+        process.exit(2);
+    }
+    if (!target) {
+        process.stderr.write(`Error: --to required\n\n${HELP}`);
+        process.exit(2);
+    }
+    if (!(0, node_fs_1.existsSync)((0, node_path_1.resolve)(source))) {
+        process.stderr.write(`Error: ${source} does not exist\n`);
+        process.exit(1);
+    }
+    (0, node_fs_1.mkdirSync)((0, node_path_1.resolve)(target), { recursive: true });
+    const sources = listSources(source, glob);
+    if (sources.length === 0) {
+        process.stderr.write(`No files matched ${glob} under ${source}\n`);
+        process.exit(0);
+    }
+    let converted = 0;
+    const skipped = [];
+    for (const src of sources) {
+        let raw;
+        try {
+            raw = JSON.parse((0, node_fs_1.readFileSync)(src, "utf-8"));
+        }
+        catch (e) {
+            skipped.push({ src, reason: `parse: ${e.message}` });
+            continue;
+        }
+        if (!Array.isArray(raw.events)) {
+            skipped.push({ src, reason: "missing events: array" });
+            continue;
+        }
+        const otlp = traceToOtlp(raw, agentId);
+        const stem = (0, node_path_1.basename)(src).replace(/\.json$/i, "");
+        const outName = label === "none" ? `${stem}.json` : `${label}_${stem}.json`;
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)((0, node_path_1.resolve)(target), outName), JSON.stringify(otlp, null, 2), "utf-8");
+        converted++;
+    }
+    process.stdout.write(`✓ exported ${converted} of ${sources.length} traces to ${target}\n`);
+    if (skipped.length) {
+        process.stderr.write(`Skipped ${skipped.length}:\n`);
+        for (const s of skipped.slice(0, 10))
+            process.stderr.write(`  ${s.src}: ${s.reason}\n`);
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/cli/export.ts"],"names":[],"mappings":"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"}

package/dist/cli/extractors/common.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared helpers for the framework-specific extractors.
+ */
+import { CallExpression, Node, ObjectLiteralExpression, PropertyAssignment } from "ts-morph";
+import type { OpenAITool } from "../types";
+/**
+ * Given a call/new-expression's first argument (which should be an
+ * object literal like ``{ name, description, parameters }``), pull
+ * out the fields we need and build an OpenAITool, or return
+ * ``undefined`` when the shape doesn't look like a tool definition.
+ */
+export declare function objectArgToTool(obj: ObjectLiteralExpression, inferredName: string | undefined, opts: {
+    nameKey?: string;
+    descriptionKey?: string;
+    /** Fields to try for the parameter schema, in priority order. */
+    schemaKeys: string[];
+}): OpenAITool | undefined;
+export declare function findProperty(obj: ObjectLiteralExpression, key: string): PropertyAssignment | undefined;
+export declare function getStringInit(prop: PropertyAssignment): string | undefined;
+/**
+ * Walk upwards from a call/new expression to find the variable name
+ * it's being assigned to — e.g. for
+ *     const lookupCustomer = tool({ ... })
+ * return ``"lookupCustomer"``.
+ */
+export declare function inferNameFromAssignment(call: CallExpression | Node): string | undefined;
+//# sourceMappingURL=common.d.ts.map

package/dist/cli/extractors/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/cli/extractors/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,IAAI,EACJ,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,uBAAuB,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE;IACJ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,GACA,UAAU,GAAG,SAAS,CAiDxB;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,uBAAuB,EAC5B,GAAG,EAAE,MAAM,GACV,kBAAkB,GAAG,SAAS,CAOhC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAO1E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,cAAc,GAAG,IAAI,GAC1B,MAAM,GAAG,SAAS,CAcpB"}

package/dist/cli/extractors/common.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Shared helpers for the framework-specific extractors.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectArgToTool = objectArgToTool;
+exports.findProperty = findProperty;
+exports.getStringInit = getStringInit;
+exports.inferNameFromAssignment = inferNameFromAssignment;
+const ts_morph_1 = require("ts-morph");
+const zod_1 = require("../zod");
+/**
+ * Given a call/new-expression's first argument (which should be an
+ * object literal like ``{ name, description, parameters }``), pull
+ * out the fields we need and build an OpenAITool, or return
+ * ``undefined`` when the shape doesn't look like a tool definition.
+ */
+function objectArgToTool(obj, inferredName, opts) {
+    const nameKey = opts.nameKey ?? "name";
+    const descKey = opts.descriptionKey ?? "description";
+    const nameNode = findProperty(obj, nameKey);
+    const descNode = findProperty(obj, descKey);
+    let name = nameNode
+        ? getStringInit(nameNode)
+        : inferredName;
+    if (!name)
+        return undefined;
+    const description = descNode ? getStringInit(descNode) ?? "" : "";
+    let schema = { type: "object", properties: {} };
+    for (const key of opts.schemaKeys) {
+        const prop = findProperty(obj, key);
+        if (!prop)
+            continue;
+        const init = prop.getInitializer();
+        if (!init)
+            continue;
+        // ``parameters: z.object({...})`` → full schema.  We call the
+        // object-literal converter directly so we pick up the
+        // ``required`` list, which ``zodExprToJsonSchema`` drops because
+        // its return type is a *property* (no ``required`` field).
+        if (ts_morph_1.Node.isCallExpression(init)) {
+            const firstArg = init.getArguments()[0];
+            if (firstArg && ts_morph_1.Node.isObjectLiteralExpression(firstArg)) {
+                schema = (0, zod_1.objectLiteralToJsonSchema)(firstArg);
+                break;
+            }
+            // Fall back to the property-level converter; we still get
+            // ``properties`` when the schema happens to be an object.
+            const derived = (0, zod_1.zodExprToJsonSchema)(init);
+            if (derived.type === "object" && derived.properties) {
+                schema = { type: "object", properties: derived.properties };
+                break;
+            }
+        }
+        // ``parameters: { a: z.string() }`` — plain object literal
+        if (ts_morph_1.Node.isObjectLiteralExpression(init)) {
+            schema = (0, zod_1.objectLiteralToJsonSchema)(init);
+            break;
+        }
+    }
+    return {
+        type: "function",
+        function: { name, description, parameters: schema },
+    };
+}
+function findProperty(obj, key) {
+    for (const p of obj.getProperties()) {
+        if (!ts_morph_1.Node.isPropertyAssignment(p))
+            continue;
+        const n = p.getName().replace(/^['"`]|['"`]$/g, "");
+        if (n === key)
+            return p;
+    }
+    return undefined;
+}
+function getStringInit(prop) {
+    const init = prop.getInitializer();
+    if (!init)
+        return undefined;
+    if (ts_morph_1.Node.isStringLiteral(init) || ts_morph_1.Node.isNoSubstitutionTemplateLiteral(init)) {
+        return init.getLiteralText();
+    }
+    return undefined;
+}
+/**
+ * Walk upwards from a call/new expression to find the variable name
+ * it's being assigned to — e.g. for
+ *     const lookupCustomer = tool({ ... })
+ * return ``"lookupCustomer"``.
+ */
+function inferNameFromAssignment(call) {
+    let cur = call.getParent();
+    while (cur) {
+        if (ts_morph_1.Node.isVariableDeclaration(cur)) {
+            const id = cur.getNameNode();
+            if (ts_morph_1.Node.isIdentifier(id))
+                return id.getText();
+            return undefined;
+        }
+        if (ts_morph_1.Node.isPropertyAssignment(cur)) {
+            return cur.getName().replace(/^['"`]|['"`]$/g, "");
+        }
+        cur = cur.getParent();
+    }
+    return undefined;
+}
+//# sourceMappingURL=common.js.map

package/dist/cli/extractors/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/cli/extractors/common.ts"],"names":[],"mappings":"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"}

package/dist/cli/extractors/generic.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Generic / framework-agnostic tool extractor.
+ *
+ * Catches the long-tail of homegrown agent toolkits and lesser-known
+ * libraries that follow the same conventions as Vercel AI / LangChain
+ * but use a slightly different name.  This deliberately runs *after*
+ * the framework-specific extractors so that the more-specific ones
+ * win (their provenance is more useful: ``"vercel_ai"`` vs
+ * ``"generic"``).
+ *
+ * Two patterns are recognised:
+ *
+ * 1. **Decorator** — ``@tool`` / ``@createTool`` / ``@defineTool`` /
+ *    ``@registerTool`` applied to a function declaration or class
+ *    method.  Function name → tool name, leading JSDoc → description,
+ *    first object-literal argument to the decorator (if any) carries
+ *    the schema / overrides.
+ *
+ * 2. **Call expression** — ``createTool({...})``, ``defineTool({...})``,
+ *    ``makeTool({...})``, ``registerTool({...})``, ``tool({...})``
+ *    — anything that *looks* like a tool factory.  The ``tool``
+ *    identifier overlaps with Vercel AI; the dedupe layer in
+ *    ``index.ts`` (keyed on name + file + line) silently discards
+ *    the duplicate.
+ *
+ * The fallback is conservative: an object literal must carry at
+ * least two of ``{name, description, schema/parameters/inputSchema}``
+ * before we treat it as a tool, otherwise an unrelated function call
+ * like ``tool({ id: 5 })`` would emit garbage entries.
+ */
+import { SourceFile } from "ts-morph";
+import type { OpenAITool, ToolProvenance } from "../types";
+export declare function extractGenericTools(sourceFile: SourceFile): {
+    tool: OpenAITool;
+    provenance: ToolProvenance;
+}[];
+//# sourceMappingURL=generic.d.ts.map

package/dist/cli/extractors/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../../src/cli/extractors/generic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAML,UAAU,EACX,MAAM,UAAU,CAAC;AAMlB,OAAO,KAAK,EAAc,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA0JvE,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,cAAc,CAAA;CAAE,EAAE,CAKpD"}

package/dist/cli/extractors/generic.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * Generic / framework-agnostic tool extractor.
+ *
+ * Catches the long-tail of homegrown agent toolkits and lesser-known
+ * libraries that follow the same conventions as Vercel AI / LangChain
+ * but use a slightly different name.  This deliberately runs *after*
+ * the framework-specific extractors so that the more-specific ones
+ * win (their provenance is more useful: ``"vercel_ai"`` vs
+ * ``"generic"``).
+ *
+ * Two patterns are recognised:
+ *
+ * 1. **Decorator** — ``@tool`` / ``@createTool`` / ``@defineTool`` /
+ *    ``@registerTool`` applied to a function declaration or class
+ *    method.  Function name → tool name, leading JSDoc → description,
+ *    first object-literal argument to the decorator (if any) carries
+ *    the schema / overrides.
+ *
+ * 2. **Call expression** — ``createTool({...})``, ``defineTool({...})``,
+ *    ``makeTool({...})``, ``registerTool({...})``, ``tool({...})``
+ *    — anything that *looks* like a tool factory.  The ``tool``
+ *    identifier overlaps with Vercel AI; the dedupe layer in
+ *    ``index.ts`` (keyed on name + file + line) silently discards
+ *    the duplicate.
+ *
+ * The fallback is conservative: an object literal must carry at
+ * least two of ``{name, description, schema/parameters/inputSchema}``
+ * before we treat it as a tool, otherwise an unrelated function call
+ * like ``tool({ id: 5 })`` would emit garbage entries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractGenericTools = extractGenericTools;
+const ts_morph_1 = require("ts-morph");
+const common_1 = require("./common");
+/** Identifier names that look like a tool factory. */
+const FACTORY_NAMES = new Set([
+    "tool",
+    "createTool",
+    "defineTool",
+    "makeTool",
+    "registerTool",
+    "buildTool",
+    "Tool",
+    "FunctionTool",
+]);
+/** Decorator names treated as a tool registration marker. */
+const DECORATOR_NAMES = FACTORY_NAMES;
+/** Required-fields heuristic: the object literal must carry at least
+ *  two of these keys.  Without this guard a benign call like
+ *  ``tool({ id: 5 })`` would produce a bogus tool entry. */
+const TOOL_SHAPE_KEYS = [
+    "name",
+    "description",
+    "parameters",
+    "schema",
+    "inputSchema",
+];
+function looksLikeToolObject(obj) {
+    let hits = 0;
+    for (const key of TOOL_SHAPE_KEYS) {
+        if ((0, common_1.findProperty)(obj, key))
+            hits += 1;
+        if (hits >= 2)
+            return true;
+    }
+    return false;
+}
+function jsdocDescription(node) {
+    // ``getJsDocs`` exists on most declaration nodes — guarded so we
+    // can call it from the union type without a ts-morph cast.
+    const getter = node.getJsDocs;
+    if (typeof getter !== "function")
+        return "";
+    const docs = getter.call(node);
+    if (!Array.isArray(docs) || docs.length === 0)
+        return "";
+    const text = docs[0].getDescription?.() ?? "";
+    return text.trim();
+}
+/** Extract via ``createTool({...})`` / ``tool({...})`` / ``new FunctionTool({...})`` / etc. */
+function extractCallExpressions(sourceFile) {
+    const found = [];
+    sourceFile.forEachDescendant((node) => {
+        if (!ts_morph_1.Node.isCallExpression(node) && !ts_morph_1.Node.isNewExpression(node))
+            return;
+        const callee = node.getExpression();
+        let calleeName;
+        if (ts_morph_1.Node.isIdentifier(callee))
+            calleeName = callee.getText();
+        // Member access like ``Sponsio.tool({...})`` — use the property
+        // segment so dotted exports still get picked up.
+        else if (ts_morph_1.Node.isPropertyAccessExpression(callee))
+            calleeName = callee.getName();
+        if (!calleeName || !FACTORY_NAMES.has(calleeName))
+            return;
+        const arg = node.getArguments()[0];
+        if (!arg || !ts_morph_1.Node.isObjectLiteralExpression(arg))
+            return;
+        if (!looksLikeToolObject(arg))
+            return;
+        const name = (0, common_1.inferNameFromAssignment)(node);
+        const tool = (0, common_1.objectArgToTool)(arg, name, {
+            schemaKeys: ["parameters", "schema", "inputSchema"],
+        });
+        if (!tool)
+            return;
+        found.push({
+            tool,
+            provenance: {
+                filepath: sourceFile.getFilePath(),
+                line: node.getStartLineNumber(),
+                extractor: "generic",
+            },
+        });
+    });
+    return found;
+}
+/** Extract via ``@tool`` / ``@createTool`` decorators. */
+function extractDecorators(sourceFile) {
+    const found = [];
+    sourceFile.forEachDescendant((node) => {
+        if (!ts_morph_1.Node.isDecorator(node))
+            return;
+        const dec = node;
+        // Resolve the decorator identifier: ``@tool`` or ``@tool({...})``
+        let decName;
+        const exprText = dec.getExpression();
+        if (ts_morph_1.Node.isIdentifier(exprText))
+            decName = exprText.getText();
+        else if (ts_morph_1.Node.isCallExpression(exprText)) {
+            const inner = exprText.getExpression();
+            if (ts_morph_1.Node.isIdentifier(inner))
+                decName = inner.getText();
+        }
+        if (!decName || !DECORATOR_NAMES.has(decName))
+            return;
+        const target = dec.getParent();
+        if (!ts_morph_1.Node.isFunctionDeclaration(target) &&
+            !ts_morph_1.Node.isMethodDeclaration(target)) {
+            return;
+        }
+        const fn = target;
+        const name = fn.getName();
+        if (!name)
+            return;
+        // Description: first try the decorator's config object (if it's
+        // a call), then fall back to a JSDoc comment on the function.
+        let description = "";
+        let schema = { type: "object", properties: {} };
+        if (ts_morph_1.Node.isCallExpression(exprText)) {
+            const cfg = exprText.getArguments()[0];
+            if (cfg && ts_morph_1.Node.isObjectLiteralExpression(cfg)) {
+                const built = (0, common_1.objectArgToTool)(cfg, name, {
+                    schemaKeys: ["parameters", "schema", "inputSchema"],
+                });
+                if (built) {
+                    description = built.function.description;
+                    schema = built.function.parameters;
+                }
+            }
+        }
+        if (!description)
+            description = jsdocDescription(fn);
+        found.push({
+            tool: {
+                type: "function",
+                function: { name, description, parameters: schema },
+            },
+            provenance: {
+                filepath: sourceFile.getFilePath(),
+                line: fn.getStartLineNumber(),
+                extractor: "generic_decorator",
+            },
+        });
+    });
+    return found;
+}
+function extractGenericTools(sourceFile) {
+    return [
+        ...extractCallExpressions(sourceFile),
+        ...extractDecorators(sourceFile),
+    ];
+}
+//# sourceMappingURL=generic.js.map

package/dist/cli/extractors/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../../src/cli/extractors/generic.ts"],"names":[],"mappings":"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"}

package/dist/cli/extractors/langchain.d.ts

@@ -0,0 +1,18 @@
+/**
+ * LangChain.js tool extractor.
+ *
+ * Matches:
+ *
+ *   new DynamicStructuredTool({ name, description, schema, func })
+ *   new DynamicTool({ name, description, func })
+ *   tool(fn, { name, description, schema })       — LangGraph.js v0.2+
+ *
+ * The ``schema`` field is a Zod object we convert via ``zod.ts``.
+ */
+import { SourceFile } from "ts-morph";
+import type { OpenAITool, ToolProvenance } from "../types";
+export declare function extractLangChainTools(sourceFile: SourceFile): {
+    tool: OpenAITool;
+    provenance: ToolProvenance;
+}[];
+//# sourceMappingURL=langchain.d.ts.map

package/dist/cli/extractors/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../../src/cli/extractors/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAQ,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAQ3D,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,UAAU,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,cAAc,CAAA;CAAE,EAAE,CAgEpD"}