@execlave/sdk 1.0.2 → 1.1.2

package/dist/integrations/openai-agents.d.ts

@@ -0,0 +1,60 @@
+/**
+ * OpenAI Agents SDK auto-instrumentation.
+ *
+ * Plug into the Agents SDK tracing pipeline:
+ *
+ * ```ts
+ * import { setTraceProcessors } from '@openai/agents';
+ * import { Execlave } from '@execlave/sdk';
+ * import { ExeclaveTracingProcessor } from '@execlave/sdk/integrations/openai-agents';
+ *
+ * const exe = new Execlave({ apiKey: '...' });
+ * setTraceProcessors([new ExeclaveTracingProcessor(exe, { agentId: 'my-bot' })]);
+ * ```
+ *
+ * The processor maps each agent_span / generation_span / function_span /
+ * handoff_span / guardrail_span into an Execlave span via the shared
+ * instrumentation layer. Tool-call enforcement runs on function_span
+ * starts so tool-allowlist policies block a tool before the SDK executes
+ * it.
+ *
+ * No compile-time dependency on the OpenAI Agents SDK — span shapes are
+ * duck-typed.
+ */
+import type { Execlave } from '../client';
+export interface ExeclaveTracingProcessorOptions {
+    /** Agent id registered with Execlave. Required for enforcement. */
+    agentId: string;
+    /** Run `enforcePolicy` on tool starts. Default true. */
+    enforce?: boolean;
+    sessionId?: string;
+    userId?: string;
+}
+/**
+ * TracingProcessor implementation for the OpenAI Agents SDK that streams
+ * spans into Execlave.
+ *
+ * Implements the duck-typed methods the Agents SDK invokes: `onTraceStart`,
+ * `onTraceEnd`, `onSpanStart`, `onSpanEnd`, `shutdown`, `forceFlush`.
+ */
+export declare class ExeclaveTracingProcessor {
+    readonly name = "ExeclaveTracingProcessor";
+    private _exe;
+    private _agentId;
+    private _enforce;
+    private _sessionId?;
+    private _userId?;
+    private _tree;
+    private _spans;
+    constructor(exe: Execlave, opts: ExeclaveTracingProcessorOptions);
+    onTraceStart(_trace: unknown): void;
+    onTraceEnd(_trace: unknown): void;
+    onSpanStart(span: any): Promise<void>;
+    onSpanEnd(span: any): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+    private _enforceTool;
+    private _startSpan;
+    private _endSpan;
+}
+//# sourceMappingURL=openai-agents.d.ts.map

package/dist/integrations/openai-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-agents.d.ts","sourceRoot":"","sources":["../../src/integrations/openai-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AA4B1C,MAAM,WAAW,+BAA+B;IAC9C,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD;;;;;;GAMG;AACH,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,IAAI,8BAA8B;IAE3C,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,+BAA+B;IAchE,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAInC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAI3B,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IASpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAWnB,YAAY;YAeZ,UAAU;IAwCxB,OAAO,CAAC,QAAQ;CAmCjB"}

package/dist/integrations/openai-agents.js

@@ -0,0 +1,247 @@
+"use strict";
+/**
+ * OpenAI Agents SDK auto-instrumentation.
+ *
+ * Plug into the Agents SDK tracing pipeline:
+ *
+ * ```ts
+ * import { setTraceProcessors } from '@openai/agents';
+ * import { Execlave } from '@execlave/sdk';
+ * import { ExeclaveTracingProcessor } from '@execlave/sdk/integrations/openai-agents';
+ *
+ * const exe = new Execlave({ apiKey: '...' });
+ * setTraceProcessors([new ExeclaveTracingProcessor(exe, { agentId: 'my-bot' })]);
+ * ```
+ *
+ * The processor maps each agent_span / generation_span / function_span /
+ * handoff_span / guardrail_span into an Execlave span via the shared
+ * instrumentation layer. Tool-call enforcement runs on function_span
+ * starts so tool-allowlist policies block a tool before the SDK executes
+ * it.
+ *
+ * No compile-time dependency on the OpenAI Agents SDK — span shapes are
+ * duck-typed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExeclaveTracingProcessor = 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);
+}
+// Mapping from Agents-SDK span-data class names to Execlave span kinds.
+// Keyed on `span.spanData.constructor.name` to stay version-tolerant.
+const KIND_MAP = {
+    AgentSpanData: spans_1.SPAN_KIND_AGENT,
+    GenerationSpanData: spans_1.SPAN_KIND_LLM,
+    ResponseSpanData: spans_1.SPAN_KIND_LLM,
+    FunctionSpanData: spans_1.SPAN_KIND_TOOL,
+    HandoffSpanData: spans_1.SPAN_KIND_HANDOFF,
+    GuardrailSpanData: spans_1.SPAN_KIND_GUARDRAIL,
+    CustomSpanData: spans_1.SPAN_KIND_AGENT,
+};
+/**
+ * TracingProcessor implementation for the OpenAI Agents SDK that streams
+ * spans into Execlave.
+ *
+ * Implements the duck-typed methods the Agents SDK invokes: `onTraceStart`,
+ * `onTraceEnd`, `onSpanStart`, `onSpanEnd`, `shutdown`, `forceFlush`.
+ */
+class ExeclaveTracingProcessor {
+    constructor(exe, opts) {
+        this.name = 'ExeclaveTracingProcessor';
+        this._spans = new Map();
+        if (!exe)
+            throw new Error('ExeclaveTracingProcessor requires an Execlave client');
+        if (!opts?.agentId)
+            throw new Error('ExeclaveTracingProcessor 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);
+    }
+    // --------------------------------------------------------------
+    // TracingProcessor interface
+    // --------------------------------------------------------------
+    onTraceStart(_trace) {
+        /* no-op */
+    }
+    onTraceEnd(_trace) {
+        /* no-op */
+    }
+    async onSpanStart(span) {
+        try {
+            await this._startSpan(span);
+        }
+        catch (err) {
+            if (isEnforcementError(err))
+                throw err;
+            // eslint-disable-next-line no-console
+            console.warn('[execlave] onSpanStart failed (non-fatal):', err);
+        }
+    }
+    onSpanEnd(span) {
+        try {
+            this._endSpan(span);
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn('[execlave] onSpanEnd failed (non-fatal):', err);
+        }
+    }
+    async shutdown() {
+        try {
+            await this._exe.flush();
+        }
+        catch {
+            /* noop */
+        }
+    }
+    async forceFlush() {
+        try {
+            await this._exe.flush();
+        }
+        catch {
+            /* noop */
+        }
+    }
+    // --------------------------------------------------------------
+    // Internals
+    // --------------------------------------------------------------
+    async _enforceTool(toolName, args) {
+        if (!this._enforce)
+            return;
+        try {
+            await this._exe.enforcePolicy({
+                agentId: this._agentId,
+                input: safeStr(args) ?? `tool:${toolName}`,
+                tools: [toolName],
+            });
+        }
+        catch (err) {
+            if (isEnforcementError(err))
+                throw err;
+            // eslint-disable-next-line no-console
+            console.warn('[execlave] enforcePolicy failed (non-fatal):', err);
+        }
+    }
+    async _startSpan(span) {
+        const spanId = getAttr(span, 'spanId') ?? getAttr(span, 'id');
+        if (!spanId)
+            return;
+        const parentId = getAttr(span, 'parentId');
+        const spanData = getAttr(span, 'spanData');
+        const dataClass = spanData ? spanData.constructor?.name ?? '' : '';
+        const kind = (KIND_MAP[dataClass] ?? spans_1.SPAN_KIND_AGENT);
+        const name = spanName(spanData) ?? kind;
+        // Tool-call enforcement happens before we open the span so a block
+        // aborts the SDK run without producing an orphaned span.
+        if (kind === spans_1.SPAN_KIND_TOOL) {
+            const args = getAttr(spanData, 'input') ?? getAttr(spanData, 'arguments');
+            await this._enforceTool(name, args);
+        }
+        const parent = parentId ? this._spans.get(String(parentId)) : null;
+        const ourSpan = this._tree.start({
+            kind,
+            name,
+            parent,
+            agentId: this._agentId,
+            sessionId: this._sessionId,
+            userId: this._userId,
+            metadata: { openaiAgentsSpanId: String(spanId) },
+        });
+        const input = getAttr(spanData, 'input');
+        if (input !== undefined && input !== null) {
+            try {
+                ourSpan.setInput(input);
+            }
+            catch {
+                /* noop */
+            }
+        }
+        const model = getAttr(spanData, 'model');
+        if (typeof model === 'string' && model)
+            ourSpan.setModel(model);
+        this._spans.set(String(spanId), ourSpan);
+    }
+    _endSpan(span) {
+        const spanId = getAttr(span, 'spanId') ?? getAttr(span, 'id');
+        if (!spanId)
+            return;
+        const ourSpan = this._spans.get(String(spanId));
+        if (!ourSpan)
+            return;
+        this._spans.delete(String(spanId));
+        const spanData = getAttr(span, 'spanData');
+        const output = getAttr(spanData, 'output');
+        if (output !== undefined && output !== null) {
+            try {
+                ourSpan.setOutput(output);
+            }
+            catch {
+                /* noop */
+            }
+        }
+        const usage = getAttr(spanData, 'usage');
+        if (usage && typeof usage === 'object') {
+            const p = (usage.prompt_tokens ?? usage.input_tokens ?? usage.promptTokens ?? usage.inputTokens);
+            const c = (usage.completion_tokens ?? usage.output_tokens ?? usage.completionTokens ?? usage.outputTokens);
+            if (typeof p === 'number' && typeof c === 'number')
+                ourSpan.setTokens(p, c);
+        }
+        const error = getAttr(span, 'error');
+        if (error) {
+            const msg = error.message ?? safeStr(error) ?? 'error';
+            const type = error.name ?? 'Error';
+            ourSpan.finish('error', msg, type);
+        }
+        else {
+            ourSpan.finish('success');
+        }
+    }
+}
+exports.ExeclaveTracingProcessor = ExeclaveTracingProcessor;
+// ----------------------------------------------------------------------
+// Defensive getters — span-data shape varies across SDK versions.
+// ----------------------------------------------------------------------
+function getAttr(obj, name) {
+    if (obj === null || obj === undefined)
+        return undefined;
+    // Try snake_case fallback (Python parity).
+    const snake = name.replace(/([A-Z])/g, '_$1').toLowerCase();
+    if (typeof obj === 'object') {
+        if (name in obj && obj[name] !== undefined)
+            return obj[name];
+        if (snake in obj && obj[snake] !== undefined)
+            return obj[snake];
+    }
+    return undefined;
+}
+function spanName(spanData) {
+    if (!spanData)
+        return null;
+    for (const attr of ['name', 'toolName', 'tool_name', 'functionName', 'function_name', 'agentName', 'agent_name', 'model']) {
+        const v = getAttr(spanData, attr);
+        if (typeof v === 'string' && v)
+            return v;
+    }
+    return null;
+}
+function safeStr(value, limit = 4000) {
+    if (value === null || value === undefined)
+        return null;
+    try {
+        const s = typeof value === 'string' ? value : JSON.stringify(value);
+        return s.slice(0, limit);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=openai-agents.js.map

package/dist/integrations/openai-agents.js.map

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

package/dist/trace.d.ts

@@ -13,8 +13,12 @@ export declare class Trace {
     readonly agentId: string | undefined;
     readonly sessionId: string | undefined;
     readonly userId: string | undefined;
+    readonly environment: string | undefined;
+    readonly parentTraceId: string | undefined;
+    readonly spanType: string | undefined;
     private _owner;
     private _metadata;
+    private _tags;
     private _input;
     private _output;
     private _modelName;
@@ -33,6 +37,10 @@ export declare class Trace {
         sessionId?: string;
         userId?: string;
         metadata?: Record<string, unknown>;
+        tags?: string[];
+        environment?: string;
+        parentTraceId?: string;
+        spanType?: string;
     });
     /** Set the input data for this trace. Chainable. */
     setInput(data: unknown): this;
@@ -40,8 +48,17 @@ export declare class Trace {
     setOutput(data: unknown): this;
     /** Set the model name used. Chainable. */
     setModel(modelName: string): this;
-    /** Set token counts. Chainable. */
-    setTokens(prompt: number, completion: number): this;
+    /** Set token counts. Chainable.
+     *
+     * Accepts positional `(prompt, completion)` or an options object with
+     * either JS-style `{ prompt, completion }` or Python-SDK-style `{ input, output }` keys.
+     */
+    setTokens(promptOrOpts: number | {
+        prompt?: number;
+        completion?: number;
+        input?: number;
+        output?: number;
+    }, completion?: number): this;
     /** Set estimated cost in USD. Chainable. */
     setCost(costUsd: number): this;
     /** Merge additional metadata. Chainable. */
@@ -56,6 +73,8 @@ export declare class Trace {
      * @param errorType - Error class/type name
      */
     finish(status?: TraceStatus, errorMessage?: string, errorType?: string): void;
+    /** Add tags. Chainable. */
+    addTags(tags: string[]): this;
     private _toPayload;
 }
 export {};

package/dist/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAIzD,UAAU,WAAW;IACnB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3C;AAED,qBAAa,KAAK;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,SAAS,CAAS;gBAGxB,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE;QACJ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B;IAWR,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK7B,qDAAqD;IACrD,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK9B,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKjC,mCAAmC;IACnC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAMnD,4CAA4C;IAC5C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,4CAA4C;IAC5C,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKhD,6DAA6D;IAC7D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK7B;;;;;;OAMG;IACH,MAAM,CACJ,MAAM,GAAE,WAAuB,EAC/B,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAWP,OAAO,CAAC,UAAU;CA2BnB"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAIzD,UAAU,WAAW;IACnB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3C;AAED,qBAAa,KAAK;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEtC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,SAAS,CAAS;gBAGxB,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE;QACJ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACd;IAeR,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK7B,qDAAqD;IACrD,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK9B,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKjC;;;;OAIG;IACH,SAAS,CACP,YAAY,EAAE,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAChG,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAWP,4CAA4C;IAC5C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,4CAA4C;IAC5C,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKhD,6DAA6D;IAC7D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK7B;;;;;;OAMG;IACH,MAAM,CACJ,MAAM,GAAE,WAAuB,EAC/B,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAWP,2BAA2B;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAS7B,OAAO,CAAC,UAAU;CA+BnB"}

package/dist/trace.js

@@ -19,7 +19,11 @@ class Trace {
         this.agentId = opts.agentId;
         this.sessionId = opts.sessionId;
         this.userId = opts.userId;
+        this.environment = opts.environment;
+        this.parentTraceId = opts.parentTraceId;
+        this.spanType = opts.spanType;
         this._metadata = opts.metadata ?? {};
+        this._tags = opts.tags && opts.tags.length > 0 ? [...opts.tags] : undefined;
         this._startMs = Date.now();
     }
     /** Set the input data for this trace. Chainable. */
@@ -37,10 +41,20 @@ class Trace {
         this._modelName = modelName;
         return this;
     }
-    /** Set token counts. Chainable. */
-    setTokens(prompt, completion) {
-        this._promptTokens = prompt;
-        this._completionTokens = completion;
+    /** Set token counts. Chainable.
+     *
+     * Accepts positional `(prompt, completion)` or an options object with
+     * either JS-style `{ prompt, completion }` or Python-SDK-style `{ input, output }` keys.
+     */
+    setTokens(promptOrOpts, completion) {
+        if (typeof promptOrOpts === 'number') {
+            this._promptTokens = promptOrOpts;
+            this._completionTokens = completion ?? 0;
+        }
+        else if (promptOrOpts && typeof promptOrOpts === 'object') {
+            this._promptTokens = promptOrOpts.prompt ?? promptOrOpts.input ?? 0;
+            this._completionTokens = promptOrOpts.completion ?? promptOrOpts.output ?? 0;
+        }
         return this;
     }
     /** Set estimated cost in USD. Chainable. */
@@ -74,6 +88,18 @@ class Trace {
         this._errorType = errorType;
         this._owner._bufferTrace(this._toPayload());
     }
+    /** Add tags. Chainable. */
+    addTags(tags) {
+        if (!tags || tags.length === 0)
+            return this;
+        if (!this._tags)
+            this._tags = [];
+        for (const tag of tags) {
+            if (!this._tags.includes(tag))
+                this._tags.push(tag);
+        }
+        return this;
+    }
     _toPayload() {
         const durationMs = this._durationOverride ?? (Date.now() - this._startMs);
         const totalTokens = this._promptTokens !== undefined && this._completionTokens !== undefined
@@ -96,7 +122,11 @@ class Trace {
             completionTokens: this._completionTokens,
             totalTokens,
             costUsd: this._cost,
+            environment: this.environment,
+            tags: this._tags && this._tags.length > 0 ? this._tags : undefined,
             metadata: Object.keys(this._metadata).length > 0 ? this._metadata : undefined,
+            parentTraceId: this.parentTraceId,
+            spanType: this.spanType,
         };
     }
 }

package/dist/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mCAAqC;AASrC,MAAa,KAAK;IAyBhB,YACE,KAAkB,EAClB,OAUI,EAAE;QAzBA,WAAM,GAAY,SAAS,CAAC;QAC5B,YAAO,GAAY,SAAS,CAAC;QAK7B,YAAO,GAAgB,SAAS,CAAC;QAKjC,cAAS,GAAG,KAAK,CAAC;QAgBxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,IAAA,oBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,oDAAoD;IACpD,QAAQ,CAAC,IAAa;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qDAAqD;IACrD,SAAS,CAAC,IAAa;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0CAA0C;IAC1C,QAAQ,CAAC,SAAiB;QACxB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,SAAS,CACP,YAAgG,EAChG,UAAmB;QAEnB,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;YAClC,IAAI,CAAC,iBAAiB,GAAG,UAAU,IAAI,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC5D,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,MAAM,IAAI,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC;YACpE,IAAI,CAAC,iBAAiB,GAAG,YAAY,CAAC,UAAU,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,OAAO,CAAC,OAAe;QACrB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,WAAW,CAAC,IAA6B;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6DAA6D;IAC7D,WAAW,CAAC,EAAU;QACpB,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CACJ,SAAsB,SAAS,EAC/B,YAAqB,EACrB,SAAkB;QAElB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,2BAA2B;IAC3B,OAAO,CAAC,IAAc;QACpB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,UAAU;QAChB,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1E,MAAM,WAAW,GACf,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS;YACtE,CAAC,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,iBAAiB;YAC7C,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;YAChD,UAAU;YACV,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;YACxC,WAAW;YACX,OAAO,EAAE,IAAI,CAAC,KAAK;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YAClE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAC7E,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF;AA1KD,sBA0KC"}

package/dist/types.d.ts

@@ -77,6 +77,14 @@ export interface TraceOptions {
     agentId?: string;
     /** Additional metadata. */
     metadata?: Record<string, unknown>;
+    /** Free-form tags for filtering / grouping. */
+    tags?: string[];
+    /** Override the environment for this single trace. Defaults to client environment. */
+    environment?: Environment;
+    /** Parent trace ID — links this trace as a child of another (multi-step / agent-to-agent). */
+    parentTraceId?: string;
+    /** Span type (e.g. 'llm', 'tool', 'retrieval'). */
+    spanType?: string;
 }
 export interface DeployPromptOptions {
     promptTemplate: string;
@@ -131,6 +139,8 @@ export interface TracePayload {
     environment?: string;
     tags?: string[];
     metadata?: Record<string, unknown>;
+    parentTraceId?: string;
+    spanType?: string;
 }
 export interface EnforcePolicyOptions {
     /** Internal UUID of the agent. */

package/dist/types.d.ts.map

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

package/package.json

@@ -1,9 +1,24 @@
 {
   "name": "@execlave/sdk",
-  "version": "1.0.2",
-  "description": "Official JavaScript/TypeScript SDK for the Execlave AI agent governance platform",
+  "version": "1.1.2",
+  "description": "Official JavaScript/TypeScript SDK for the Execlave AI agent governance platform — tracing, policy enforcement, and framework auto-instrumentation for LangChain",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./instrumentation": {
+      "types": "./dist/instrumentation/index.d.ts",
+      "default": "./dist/instrumentation/index.js"
+    },
+    "./integrations/langchain": {
+      "types": "./dist/integrations/langchain.d.ts",
+      "default": "./dist/integrations/langchain.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "dist"
   ],
@@ -22,32 +37,47 @@
     "governance",
     "compliance",
     "policy",
+    "policy-enforcement",
     "security",
     "monitoring",
     "anomaly-detection",
     "real-time",
+    "real-time-enforcement",
     "self-hosted",
     "open-source",
     "privacy",
     "data-protection",
     "AI-ops",
     "AI-guardrails",
+    "guardrails",
     "observability",
     "tracing",
-    "llm"
+    "llm",
+    "agents",
+    "ai-agents",
+    "agent-governance",
+    "ai-safety",
+    "ai-compliance",
+    "audit",
+    "langchain",
+    "openai-agents"
   ],
   "license": "MIT",
   "author": "Execlave <support@execlave.com>",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/rishitmavani/execlave.git",
-    "directory": "sdk-js"
+    "url": "git+https://github.com/execlave-ai/execlave-js-sdk.git",
+    "directory": "."
+  },
+  "bugs": {
+    "url": "https://github.com/execlave-ai/execlave-js-sdk/issues"
   },
   "homepage": "https://www.execlave.com/docs/sdk-reference",
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
+    "@langchain/core": ">=0.3.0 <0.4.0",
     "@opentelemetry/api": ">=1.4.0",
     "@opentelemetry/exporter-trace-otlp-http": ">=0.41.0",
     "@opentelemetry/resources": ">=1.15.0",
@@ -55,6 +85,9 @@
     "socket.io-client": "^4.0.0"
   },
   "peerDependenciesMeta": {
+    "@langchain/core": {
+      "optional": true
+    },
     "@opentelemetry/api": {
       "optional": true
     },