@execlave/sdk 1.0.2 → 1.1.0

package/dist/instrumentation/spans.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Nested span primitives. Each `Span` wraps the SDK's `Trace` and
+ * carries parent/child identity through the trace metadata so the
+ * backend can reconstruct the execution tree.
+ *
+ * Concurrency model: Node.js is single-threaded, but async tasks can
+ * interleave. We expose `withSpan(span, fn)` so async framework
+ * adapters can scope the "current span" to a specific async operation
+ * without relying on AsyncLocalStorage (keeps footprint zero-dep).
+ * The default stack is process-wide; framework adapters can pass
+ * `parent` explicitly to avoid relying on the implicit stack.
+ */
+import { Trace } from '../trace';
+import type { Execlave } from '../client';
+export declare const SPAN_KIND_AGENT = "agent";
+export declare const SPAN_KIND_CHAIN = "chain";
+export declare const SPAN_KIND_LLM = "llm";
+export declare const SPAN_KIND_TOOL = "tool";
+export declare const SPAN_KIND_RETRIEVER = "retriever";
+export declare const SPAN_KIND_GUARDRAIL = "guardrail";
+export declare const SPAN_KIND_HANDOFF = "handoff";
+export type SpanKind = typeof SPAN_KIND_AGENT | typeof SPAN_KIND_CHAIN | typeof SPAN_KIND_LLM | typeof SPAN_KIND_TOOL | typeof SPAN_KIND_RETRIEVER | typeof SPAN_KIND_GUARDRAIL | typeof SPAN_KIND_HANDOFF;
+export interface StartSpanOptions {
+    kind: SpanKind;
+    name: string;
+    parent?: Span | null;
+    agentId?: string;
+    sessionId?: string;
+    userId?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class Span {
+    readonly spanId: string;
+    readonly parentSpanId: string | null;
+    readonly kind: SpanKind;
+    readonly name: string;
+    private _trace;
+    private _tree;
+    private _finished;
+    constructor(trace: Trace, opts: {
+        spanId: string;
+        parentSpanId: string | null;
+        kind: SpanKind;
+        name: string;
+        tree: SpanTree;
+    });
+    /** Internal: exposed for nested spans to inherit trace id. */
+    get _innerTrace(): Trace;
+    /** Trace id that this span's metadata is attached to. */
+    get traceId(): string;
+    setInput(value: unknown): this;
+    setOutput(value: unknown): this;
+    setModel(model: string): this;
+    setTokens(prompt: number, completion: number): this;
+    setCost(costUsd: number): this;
+    addMetadata(meta: Record<string, unknown>): this;
+    child(opts: {
+        kind: SpanKind;
+        name: string;
+    }): Span;
+    finish(status?: 'success' | 'error' | 'timeout', errorMessage?: string, errorType?: string): void;
+}
+export declare class SpanTree {
+    private _exe;
+    private _stack;
+    constructor(_exe: Execlave);
+    current(): Span | null;
+    start(opts: StartSpanOptions): Span;
+    _pop(span: Span): void;
+}
+export declare function getSpanTree(exe: Execlave): SpanTree;
+//# sourceMappingURL=spans.d.ts.map

package/dist/instrumentation/spans.d.ts.map

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

package/dist/instrumentation/spans.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Nested span primitives. Each `Span` wraps the SDK's `Trace` and
+ * carries parent/child identity through the trace metadata so the
+ * backend can reconstruct the execution tree.
+ *
+ * Concurrency model: Node.js is single-threaded, but async tasks can
+ * interleave. We expose `withSpan(span, fn)` so async framework
+ * adapters can scope the "current span" to a specific async operation
+ * without relying on AsyncLocalStorage (keeps footprint zero-dep).
+ * The default stack is process-wide; framework adapters can pass
+ * `parent` explicitly to avoid relying on the implicit stack.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpanTree = exports.Span = exports.SPAN_KIND_HANDOFF = exports.SPAN_KIND_GUARDRAIL = exports.SPAN_KIND_RETRIEVER = exports.SPAN_KIND_TOOL = exports.SPAN_KIND_LLM = exports.SPAN_KIND_CHAIN = exports.SPAN_KIND_AGENT = void 0;
+exports.getSpanTree = getSpanTree;
+const crypto_1 = require("crypto");
+exports.SPAN_KIND_AGENT = 'agent';
+exports.SPAN_KIND_CHAIN = 'chain';
+exports.SPAN_KIND_LLM = 'llm';
+exports.SPAN_KIND_TOOL = 'tool';
+exports.SPAN_KIND_RETRIEVER = 'retriever';
+exports.SPAN_KIND_GUARDRAIL = 'guardrail';
+exports.SPAN_KIND_HANDOFF = 'handoff';
+class Span {
+    constructor(trace, opts) {
+        this._finished = false;
+        this._trace = trace;
+        this.spanId = opts.spanId;
+        this.parentSpanId = opts.parentSpanId;
+        this.kind = opts.kind;
+        this.name = opts.name;
+        this._tree = opts.tree;
+        trace.addMetadata({
+            spanId: this.spanId,
+            parentSpanId: this.parentSpanId,
+            spanKind: this.kind,
+            spanName: this.name,
+        });
+    }
+    /** Internal: exposed for nested spans to inherit trace id. */
+    get _innerTrace() {
+        return this._trace;
+    }
+    /** Trace id that this span's metadata is attached to. */
+    get traceId() {
+        return this._trace.traceId;
+    }
+    setInput(value) {
+        this._trace.setInput(value);
+        return this;
+    }
+    setOutput(value) {
+        this._trace.setOutput(value);
+        return this;
+    }
+    setModel(model) {
+        this._trace.setModel(model);
+        return this;
+    }
+    setTokens(prompt, completion) {
+        this._trace.setTokens(prompt, completion);
+        return this;
+    }
+    setCost(costUsd) {
+        this._trace.setCost(costUsd);
+        return this;
+    }
+    addMetadata(meta) {
+        this._trace.addMetadata(meta);
+        return this;
+    }
+    child(opts) {
+        return this._tree.start({ ...opts, parent: this });
+    }
+    finish(status = 'success', errorMessage, errorType) {
+        if (this._finished)
+            return;
+        this._finished = true;
+        this._tree._pop(this);
+        try {
+            this._trace.finish(status, errorMessage, errorType);
+        }
+        catch {
+            // transport/buffer errors are never fatal for the host app.
+        }
+    }
+}
+exports.Span = Span;
+class SpanTree {
+    constructor(_exe) {
+        this._exe = _exe;
+        this._stack = [];
+    }
+    current() {
+        return this._stack.length > 0 ? this._stack[this._stack.length - 1] : null;
+    }
+    start(opts) {
+        const parent = opts.parent ?? this.current();
+        const parentId = parent ? parent.spanId : null;
+        const inherited = parent ? parent._innerTrace : null;
+        const trace = this._exe.startTrace({
+            traceId: inherited ? inherited.traceId : undefined,
+            agentId: opts.agentId ?? inherited?.agentId,
+            sessionId: opts.sessionId ?? inherited?.sessionId,
+            userId: opts.userId ?? inherited?.userId,
+            metadata: opts.metadata,
+        });
+        const spanId = `sp_${(0, crypto_1.randomBytes)(8).toString('hex')}`;
+        const span = new Span(trace, {
+            spanId,
+            parentSpanId: parentId,
+            kind: opts.kind,
+            name: opts.name,
+            tree: this,
+        });
+        this._stack.push(span);
+        return span;
+    }
+    _pop(span) {
+        const idx = this._stack.lastIndexOf(span);
+        if (idx >= 0)
+            this._stack.splice(idx, 1);
+    }
+}
+exports.SpanTree = SpanTree;
+const _treeCache = new WeakMap();
+function getSpanTree(exe) {
+    let tree = _treeCache.get(exe);
+    if (!tree) {
+        tree = new SpanTree(exe);
+        _treeCache.set(exe, tree);
+    }
+    return tree;
+}
+//# sourceMappingURL=spans.js.map

package/dist/instrumentation/spans.js.map

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

package/dist/integrations/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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';
+//# 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"}

package/dist/integrations/index.js

@@ -0,0 +1,15 @@
+"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.ExeclaveCallbackHandler = void 0;
+var langchain_1 = require("./langchain");
+Object.defineProperty(exports, "ExeclaveCallbackHandler", { enumerable: true, get: function () { return langchain_1.ExeclaveCallbackHandler; } });
+//# 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"}

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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"}