@execlave/sdk 1.0.2 → 1.1.2

package/dist/integrations/crewai.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * CrewAI auto-instrumentation.
+ *
+ * Usage:
+ *
+ * ```ts
+ * import { Crew } from 'crewai';
+ * import { Execlave } from '@execlave/sdk';
+ * import { instrumentCrew } from '@execlave/sdk/integrations/crewai';
+ *
+ * const exe = new Execlave({ apiKey: '...' });
+ * const crew = new Crew({ agents: [...], tasks: [...] });
+ * instrumentCrew(crew, exe, { agentId: 'my-crew' });
+ * await crew.kickoff();
+ * ```
+ *
+ * Implementation: CrewAI exposes `stepCallback` and `taskCallback` hooks
+ * on `Agent` and `Crew` objects. We chain our callbacks in front of any
+ * existing user callbacks so attaching the instrumentation never
+ * overrides user-supplied hooks.
+ *
+ * Idempotent — `_execlaveInstrumented` marker prevents double-wrapping.
+ *
+ * Note: CrewAI's first-class JS implementation is still emerging; this
+ * helper duck-types the callback shape so it works with both the
+ * official package and community ports. No compile-time dependency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentCrew = instrumentCrew;
+const errors_1 = require("../errors");
+const spans_1 = require("../instrumentation/spans");
+const MARKER = '_execlaveInstrumented';
+function isEnforcementError(err) {
+    return (err instanceof errors_1.PolicyBlockedError ||
+        err instanceof errors_1.PolicyDeniedError ||
+        err instanceof errors_1.ApprovalTimeoutError ||
+        err instanceof errors_1.EnforcementUnavailableError ||
+        err instanceof errors_1.AgentPausedError);
+}
+/**
+ * Attach Execlave instrumentation to a CrewAI `Crew` instance.
+ *
+ * Idempotent: calling twice on the same crew is a no-op. Returns the
+ * same crew for fluent chaining.
+ */
+function instrumentCrew(crew, exe, opts) {
+    if (crew === null || crew === undefined) {
+        throw new Error('instrumentCrew: crew must not be null/undefined');
+    }
+    if (!exe)
+        throw new Error('instrumentCrew: exe must not be null/undefined');
+    if (!opts?.agentId)
+        throw new Error('instrumentCrew: agentId is required');
+    const c = crew;
+    if (c[MARKER])
+        return crew;
+    const tree = (0, spans_1.getSpanTree)(exe);
+    const stepCallback = async (step) => {
+        try {
+            await recordStep(tree, exe, step, opts);
+        }
+        catch (err) {
+            if (isEnforcementError(err))
+                throw err;
+            // eslint-disable-next-line no-console
+            console.warn('[execlave] crewai stepCallback failed:', err);
+        }
+    };
+    const taskCallback = (taskOutput) => {
+        try {
+            recordTask(tree, taskOutput, opts);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn('[execlave] crewai taskCallback failed:', err);
+        }
+    };
+    // Chain rather than replace — preserve user-supplied callbacks.
+    chainCallback(c, 'stepCallback', stepCallback);
+    chainCallback(c, 'step_callback', stepCallback);
+    chainCallback(c, 'taskCallback', taskCallback);
+    chainCallback(c, 'task_callback', taskCallback);
+    // Crew also exposes a list of Agent objects each with their own
+    // stepCallback. Instrument them too so tool calls from sub-agents
+    // are captured.
+    const agents = (c.agents ?? []);
+    for (const inner of agents) {
+        chainCallback(inner, 'stepCallback', stepCallback);
+        chainCallback(inner, 'step_callback', stepCallback);
+    }
+    try {
+        c[MARKER] = true;
+    }
+    catch {
+        /* frozen object — double-wrap guard inactive */
+    }
+    return crew;
+}
+// ----------------------------------------------------------------------
+// Internal: chaining + recording
+// ----------------------------------------------------------------------
+function chainCallback(obj, attr, newCb) {
+    if (!obj || typeof obj !== 'object')
+        return;
+    const existing = obj[attr];
+    if (existing === undefined || existing === null) {
+        try {
+            obj[attr] = newCb;
+        }
+        catch {
+            /* noop */
+        }
+        return;
+    }
+    const chained = async (payload) => {
+        try {
+            await newCb(payload);
+        }
+        catch (err) {
+            if (isEnforcementError(err))
+                throw err;
+            // eslint-disable-next-line no-console
+            console.warn(`[execlave] ${attr} failed:`, err);
+        }
+        try {
+            await existing(payload);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn(`[execlave] user-provided ${attr} raised:`, err);
+        }
+    };
+    try {
+        obj[attr] = chained;
+    }
+    catch {
+        /* noop */
+    }
+}
+async function recordStep(tree, exe, step, opts) {
+    // CrewAI step shapes vary across versions; attribute-detect rather than
+    // rely on a particular structure.
+    const tool = step?.tool ?? step?.toolName ?? null;
+    const toolInput = step?.toolInput ?? step?.tool_input ?? step?.input ?? null;
+    const isTool = Boolean(tool);
+    const kind = isTool ? spans_1.SPAN_KIND_TOOL : spans_1.SPAN_KIND_AGENT;
+    const name = isTool ? String(tool) : 'step';
+    if (isTool && opts.enforce !== false) {
+        try {
+            await exe.enforcePolicy({
+                agentId: opts.agentId,
+                input: toolInput !== null && toolInput !== undefined ? safeStr(toolInput) : `tool:${tool}`,
+                tools: [String(tool)],
+            });
+        }
+        catch (err) {
+            if (isEnforcementError(err))
+                throw err;
+            // eslint-disable-next-line no-console
+            console.warn('[execlave] enforcePolicy failed (non-fatal):', err);
+        }
+    }
+    const span = tree.start({
+        kind,
+        name,
+        agentId: opts.agentId,
+        sessionId: opts.sessionId,
+        userId: opts.userId,
+        metadata: { crewaiStep: true },
+    });
+    if (toolInput !== null && toolInput !== undefined) {
+        try {
+            span.setInput(toolInput);
+        }
+        catch {
+            /* noop */
+        }
+    }
+    const output = step?.output ?? step?.result ?? null;
+    if (output !== null && output !== undefined) {
+        try {
+            span.setOutput(output);
+        }
+        catch {
+            /* noop */
+        }
+    }
+    span.finish('success');
+}
+function recordTask(tree, taskOutput, opts) {
+    const description = taskOutput?.description ??
+        taskOutput?.task ??
+        taskOutput?.name ??
+        'task';
+    const span = tree.start({
+        kind: spans_1.SPAN_KIND_AGENT,
+        name: String(description).slice(0, 80),
+        agentId: opts.agentId,
+        sessionId: opts.sessionId,
+        userId: opts.userId,
+        metadata: { crewaiTask: true },
+    });
+    const raw = taskOutput?.raw ?? taskOutput?.output ?? taskOutput?.result ?? null;
+    if (raw !== null && raw !== undefined) {
+        try {
+            span.setOutput(raw);
+        }
+        catch {
+            /* noop */
+        }
+    }
+    span.finish('success');
+}
+function safeStr(value, limit = 4000) {
+    try {
+        const s = typeof value === 'string' ? value : JSON.stringify(value);
+        return s.slice(0, limit);
+    }
+    catch {
+        return String(value).slice(0, limit);
+    }
+}
+//# sourceMappingURL=crewai.js.map

package/dist/integrations/crewai.js.map

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

package/dist/integrations/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Framework adapters for @execlave/sdk.
+ *
+ * Each integration is intentionally not re-exported from the SDK root
+ * so installing `@execlave/sdk` does not pull framework peerDeps.
+ * Import directly:
+ *
+ *     import { ExeclaveCallbackHandler } from '@execlave/sdk/integrations/langchain';
+ */
+export { ExeclaveCallbackHandler } from './langchain';
+export type { ExeclaveCallbackHandlerOptions } from './langchain';
+export { ExeclaveTracingProcessor } from './openai-agents';
+export type { ExeclaveTracingProcessorOptions } from './openai-agents';
+export { instrumentCrew } from './crewai';
+export type { InstrumentCrewOptions } from './crewai';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC"}

package/dist/integrations/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Framework adapters for @execlave/sdk.
+ *
+ * Each integration is intentionally not re-exported from the SDK root
+ * so installing `@execlave/sdk` does not pull framework peerDeps.
+ * Import directly:
+ *
+ *     import { ExeclaveCallbackHandler } from '@execlave/sdk/integrations/langchain';
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentCrew = exports.ExeclaveTracingProcessor = exports.ExeclaveCallbackHandler = void 0;
+var langchain_1 = require("./langchain");
+Object.defineProperty(exports, "ExeclaveCallbackHandler", { enumerable: true, get: function () { return langchain_1.ExeclaveCallbackHandler; } });
+var openai_agents_1 = require("./openai-agents");
+Object.defineProperty(exports, "ExeclaveTracingProcessor", { enumerable: true, get: function () { return openai_agents_1.ExeclaveTracingProcessor; } });
+var crewai_1 = require("./crewai");
+Object.defineProperty(exports, "instrumentCrew", { enumerable: true, get: function () { return crewai_1.instrumentCrew; } });
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,yCAAsD;AAA7C,oHAAA,uBAAuB,OAAA;AAGhC,iDAA2D;AAAlD,yHAAA,wBAAwB,OAAA;AAGjC,mCAA0C;AAAjC,wGAAA,cAAc,OAAA"}

package/dist/integrations/langchain.d.ts

@@ -0,0 +1,90 @@
+/**
+ * LangChain JS auto-instrumentation.
+ *
+ * Usage:
+ *
+ * ```ts
+ * import { Execlave } from '@execlave/sdk';
+ * import { ExeclaveCallbackHandler } from '@execlave/sdk/integrations/langchain';
+ *
+ * const exe = new Execlave({ apiKey: '...' });
+ * const handler = new ExeclaveCallbackHandler(exe, { agentId: 'my-bot' });
+ * await chain.invoke({ q }, { callbacks: [handler] });
+ * ```
+ *
+ * Uses LangChain's `BaseCallbackHandler` (soft-imported so
+ * `@execlave/sdk` has no compile-time dependency on langchain).
+ * Consumers must install `@langchain/core` >= 0.3 themselves.
+ *
+ * Only TypeScript types are duck-typed here; at runtime the handler
+ * implements the method names LangChain expects.
+ */
+import type { Execlave } from '../client';
+export interface ExeclaveCallbackHandlerOptions {
+    /** Agent id registered with Execlave. Required for enforcement. */
+    agentId: string;
+    /** Run `enforcePolicy` on chain/tool starts. Default true. */
+    enforce?: boolean;
+    sessionId?: string;
+    userId?: string;
+}
+/**
+ * LangChain callback handler that streams into Execlave.
+ *
+ * This class does not `extends BaseCallbackHandler` at compile time —
+ * we duck-type the interface so the SDK package does not require
+ * `@langchain/core` to be installed. When registered with
+ * `config.callbacks`, LangChain invokes matching methods by name.
+ */
+export declare class ExeclaveCallbackHandler {
+    readonly name = "ExeclaveCallbackHandler";
+    readonly raiseError = true;
+    readonly awaitHandlers = true;
+    private _exe;
+    private _agentId;
+    private _enforce;
+    private _sessionId?;
+    private _userId?;
+    private _tree;
+    private _spans;
+    constructor(exe: Execlave, opts: ExeclaveCallbackHandlerOptions);
+    private _open;
+    private _close;
+    private _enforceCall;
+    handleChainStart(chain: {
+        name?: string;
+        id?: string[];
+    } | undefined, inputs: Record<string, unknown>, runId: string, parentRunId?: string): Promise<void>;
+    handleChainEnd(outputs: unknown, runId: string): Promise<void>;
+    handleChainError(error: Error, runId: string): Promise<void>;
+    handleLLMStart(llm: {
+        name?: string;
+        id?: string[];
+    } | undefined, prompts: string[], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>): Promise<void>;
+    handleChatModelStart(llm: {
+        name?: string;
+        id?: string[];
+    } | undefined, messages: unknown[], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>): Promise<void>;
+    handleLLMEnd(output: any, runId: string): Promise<void>;
+    handleLLMError(error: Error, runId: string): Promise<void>;
+    handleToolStart(tool: {
+        name?: string;
+        id?: string[];
+    } | undefined, input: string, runId: string, parentRunId?: string): Promise<void>;
+    handleToolEnd(output: unknown, runId: string): Promise<void>;
+    handleToolError(error: Error, runId: string): Promise<void>;
+    handleAgentAction(action: {
+        tool?: string;
+        toolInput?: unknown;
+    }, runId: string, parentRunId?: string): Promise<void>;
+    handleAgentEnd(action: {
+        returnValues?: unknown;
+        log?: unknown;
+    }, runId: string): Promise<void>;
+    handleRetrieverStart(retriever: {
+        name?: string;
+    } | undefined, query: string, runId: string, parentRunId?: string): Promise<void>;
+    handleRetrieverEnd(documents: any[], runId: string): Promise<void>;
+    handleRetrieverError(error: Error, runId: string): Promise<void>;
+}
+//# sourceMappingURL=langchain.d.ts.map

package/dist/integrations/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AA4B1C,MAAM,WAAW,8BAA8B;IAC7C,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAElC,QAAQ,CAAC,IAAI,6BAA6B;IAC1C,QAAQ,CAAC,UAAU,QAAQ;IAC3B,QAAQ,CAAC,aAAa,QAAQ;IAE9B,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,MAAM,CAA2B;gBAE7B,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,8BAA8B;IAc/D,OAAO,CAAC,KAAK;IAuBb,OAAO,CAAC,MAAM;YAoBA,YAAY;IAkBpB,gBAAgB,CACpB,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,EACnD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IASV,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,cAAc,CAClB,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,EACjD,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAQV,oBAAoB,CACxB,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,EACjD,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAQV,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvD,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,eAAe,CACnB,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,EAClD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAMV,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D,iBAAiB,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrH,cAAc,CAAC,MAAM,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/F,oBAAoB,CACxB,SAAS,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,EACxC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAKV,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAalE,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvE"}

package/dist/integrations/langchain.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * LangChain JS auto-instrumentation.
+ *
+ * Usage:
+ *
+ * ```ts
+ * import { Execlave } from '@execlave/sdk';
+ * import { ExeclaveCallbackHandler } from '@execlave/sdk/integrations/langchain';
+ *
+ * const exe = new Execlave({ apiKey: '...' });
+ * const handler = new ExeclaveCallbackHandler(exe, { agentId: 'my-bot' });
+ * await chain.invoke({ q }, { callbacks: [handler] });
+ * ```
+ *
+ * Uses LangChain's `BaseCallbackHandler` (soft-imported so
+ * `@execlave/sdk` has no compile-time dependency on langchain).
+ * Consumers must install `@langchain/core` >= 0.3 themselves.
+ *
+ * Only TypeScript types are duck-typed here; at runtime the handler
+ * implements the method names LangChain expects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExeclaveCallbackHandler = void 0;
+const errors_1 = require("../errors");
+const spans_1 = require("../instrumentation/spans");
+function isEnforcementError(err) {
+    return (err instanceof errors_1.PolicyBlockedError ||
+        err instanceof errors_1.PolicyDeniedError ||
+        err instanceof errors_1.ApprovalTimeoutError ||
+        err instanceof errors_1.EnforcementUnavailableError ||
+        err instanceof errors_1.AgentPausedError);
+}
+/**
+ * LangChain callback handler that streams into Execlave.
+ *
+ * This class does not `extends BaseCallbackHandler` at compile time —
+ * we duck-type the interface so the SDK package does not require
+ * `@langchain/core` to be installed. When registered with
+ * `config.callbacks`, LangChain invokes matching methods by name.
+ */
+class ExeclaveCallbackHandler {
+    constructor(exe, opts) {
+        // LangChain inspects these. `name` is used for trace metadata.
+        this.name = 'ExeclaveCallbackHandler';
+        this.raiseError = true;
+        this.awaitHandlers = true;
+        this._spans = new Map();
+        if (!exe)
+            throw new Error('ExeclaveCallbackHandler requires an Execlave client');
+        if (!opts?.agentId)
+            throw new Error('ExeclaveCallbackHandler requires agentId');
+        this._exe = exe;
+        this._agentId = opts.agentId;
+        this._enforce = opts.enforce !== false;
+        this._sessionId = opts.sessionId;
+        this._userId = opts.userId;
+        this._tree = (0, spans_1.getSpanTree)(exe);
+    }
+    // --------------------------------------------------------------
+    // Helpers
+    // --------------------------------------------------------------
+    _open(runId, parentRunId, kind, name, input, metadata) {
+        const parent = parentRunId ? this._spans.get(parentRunId) : null;
+        const span = this._tree.start({
+            kind,
+            name,
+            parent,
+            agentId: this._agentId,
+            sessionId: this._sessionId,
+            userId: this._userId,
+            metadata,
+        });
+        if (input !== undefined)
+            span.setInput(input);
+        this._spans.set(runId, span);
+        return span;
+    }
+    _close(runId, output, status = 'success', errorMessage, errorType) {
+        const span = this._spans.get(runId);
+        if (!span)
+            return;
+        this._spans.delete(runId);
+        if (output !== undefined) {
+            try {
+                span.setOutput(output);
+            }
+            catch {
+                /* noop */
+            }
+        }
+        span.finish(status, errorMessage, errorType);
+    }
+    async _enforceCall(input, tools) {
+        if (!this._enforce)
+            return;
+        try {
+            await this._exe.enforcePolicy({
+                agentId: this._agentId,
+                input,
+                tools,
+            });
+        }
+        catch (err) {
+            if (isEnforcementError(err))
+                throw err;
+            // eslint-disable-next-line no-console
+            console.warn('[execlave] enforcePolicy failed (non-fatal):', err);
+        }
+    }
+    // --------------------------------------------------------------
+    // Chain callbacks
+    // --------------------------------------------------------------
+    async handleChainStart(chain, inputs, runId, parentRunId) {
+        const name = chain?.name ?? chain?.id?.[chain.id.length - 1] ?? 'chain';
+        if (!parentRunId) {
+            const inputText = extractInputText(inputs);
+            if (inputText)
+                await this._enforceCall(inputText);
+        }
+        this._open(runId, parentRunId, spans_1.SPAN_KIND_CHAIN, name, inputs);
+    }
+    async handleChainEnd(outputs, runId) {
+        this._close(runId, outputs, 'success');
+    }
+    async handleChainError(error, runId) {
+        this._close(runId, undefined, 'error', error?.message, error?.name);
+    }
+    // --------------------------------------------------------------
+    // LLM callbacks
+    // --------------------------------------------------------------
+    async handleLLMStart(llm, prompts, runId, parentRunId, extraParams) {
+        const name = llm?.name ?? llm?.id?.[llm.id.length - 1] ?? 'llm';
+        const span = this._open(runId, parentRunId, spans_1.SPAN_KIND_LLM, name, prompts);
+        const invocation = (extraParams?.invocation_params ?? {});
+        const model = (invocation.model ?? invocation.model_name);
+        if (model)
+            span.setModel(model);
+    }
+    async handleChatModelStart(llm, messages, runId, parentRunId, extraParams) {
+        const name = llm?.name ?? llm?.id?.[llm.id.length - 1] ?? 'chat_model';
+        const span = this._open(runId, parentRunId, spans_1.SPAN_KIND_LLM, name, messages);
+        const invocation = (extraParams?.invocation_params ?? {});
+        const model = (invocation.model ?? invocation.model_name);
+        if (model)
+            span.setModel(model);
+    }
+    async handleLLMEnd(output, runId) {
+        const span = this._spans.get(runId);
+        if (span) {
+            const usage = output?.llmOutput?.tokenUsage ?? output?.llmOutput?.usage;
+            if (usage) {
+                const p = usage.promptTokens ?? usage.prompt_tokens ?? usage.input_tokens;
+                const c = usage.completionTokens ?? usage.completion_tokens ?? usage.output_tokens;
+                if (typeof p === 'number' && typeof c === 'number')
+                    span.setTokens(p, c);
+            }
+            const texts = [];
+            for (const batch of output?.generations ?? []) {
+                for (const gen of batch ?? []) {
+                    if (typeof gen.text === 'string')
+                        texts.push(gen.text);
+                    else if (gen.message?.content)
+                        texts.push(String(gen.message.content));
+                }
+            }
+            if (texts.length)
+                span.setOutput(texts.length === 1 ? texts[0] : texts);
+        }
+        this._close(runId, undefined, 'success');
+    }
+    async handleLLMError(error, runId) {
+        this._close(runId, undefined, 'error', error?.message, error?.name);
+    }
+    // --------------------------------------------------------------
+    // Tool callbacks
+    // --------------------------------------------------------------
+    async handleToolStart(tool, input, runId, parentRunId) {
+        const toolName = tool?.name ?? tool?.id?.[tool.id.length - 1] ?? 'tool';
+        await this._enforceCall(input ?? `tool:${toolName}`, [toolName]);
+        this._open(runId, parentRunId, spans_1.SPAN_KIND_TOOL, toolName, input, { toolName });
+    }
+    async handleToolEnd(output, runId) {
+        this._close(runId, output, 'success');
+    }
+    async handleToolError(error, runId) {
+        this._close(runId, undefined, 'error', error?.message, error?.name);
+    }
+    // --------------------------------------------------------------
+    // Agent callbacks
+    // --------------------------------------------------------------
+    async handleAgentAction(action, runId, parentRunId) {
+        this._open(runId, parentRunId, spans_1.SPAN_KIND_AGENT, String(action?.tool ?? 'agent_action'), action?.toolInput, { agentAction: String(action?.tool ?? 'agent_action') });
+    }
+    async handleAgentEnd(action, runId) {
+        this._close(runId, action?.returnValues ?? action?.log, 'success');
+    }
+    // --------------------------------------------------------------
+    // Retriever callbacks
+    // --------------------------------------------------------------
+    async handleRetrieverStart(retriever, query, runId, parentRunId) {
+        const name = retriever?.name ?? 'retriever';
+        this._open(runId, parentRunId, spans_1.SPAN_KIND_RETRIEVER, name, query);
+    }
+    async handleRetrieverEnd(documents, runId) {
+        const span = this._spans.get(runId);
+        if (span && Array.isArray(documents)) {
+            span.addMetadata({
+                retrievedDocs: documents.map((d) => ({
+                    id: d?.metadata?.id ?? d?.metadata?.source,
+                    length: typeof d?.pageContent === 'string' ? d.pageContent.length : 0,
+                })),
+            });
+        }
+        this._close(runId, undefined, 'success');
+    }
+    async handleRetrieverError(error, runId) {
+        this._close(runId, undefined, 'error', error?.message, error?.name);
+    }
+}
+exports.ExeclaveCallbackHandler = ExeclaveCallbackHandler;
+// ------------------------------------------------------------------
+// Helpers
+// ------------------------------------------------------------------
+function extractInputText(inputs) {
+    if (!inputs || typeof inputs !== 'object')
+        return null;
+    for (const key of ['input', 'question', 'query', 'q', 'prompt', 'text']) {
+        const v = inputs[key];
+        if (typeof v === 'string' && v)
+            return v;
+    }
+    const parts = [];
+    for (const v of Object.values(inputs)) {
+        if (typeof v === 'string')
+            parts.push(v);
+    }
+    return parts.length ? parts.join(' ') : null;
+}
+//# sourceMappingURL=langchain.js.map

package/dist/integrations/langchain.js.map

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