@execlave/sdk 1.1.5 → 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rishit Mavani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -7,7 +7,7 @@ Official JavaScript/TypeScript SDK for the [Execlave](https://www.execlave.com)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![Docs](https://img.shields.io/badge/docs-execlave.com-0a84ff.svg)](https://www.execlave.com/docs)
 
-> **Framework integrations** — use the [LangChain callback handler](https://www.execlave.com/docs/integrations/langchain) for automatic tracing and policy enforcement, or see [all integrations](https://www.execlave.com/docs/integrations). [Get an API key](https://www.execlave.com/signup?utm_source=github&utm_medium=sdk&utm_campaign=js).
+> **Framework integrations** — drop-in handlers for [LangChain](https://www.execlave.com/docs/integrations/langchain), the [OpenAI Agents SDK](https://www.execlave.com/docs/integrations/openai-agents), [CrewAI](https://www.execlave.com/docs/integrations/crewai), the [OpenAI Chat Completions API](https://www.execlave.com/docs/integrations/openai-chat), and the [Model Context Protocol](https://www.execlave.com/docs/integrations/mcp), or see [all integrations](https://www.execlave.com/docs/integrations). [Get an API key](https://www.execlave.com/signup?utm_source=github&utm_medium=sdk&utm_campaign=js).
 
 ## Installation
 

package/dist/integrations/index.d.ts

@@ -13,4 +13,8 @@ export { ExeclaveTracingProcessor } from './openai-agents';
 export type { ExeclaveTracingProcessorOptions } from './openai-agents';
 export { instrumentCrew } from './crewai';
 export type { InstrumentCrewOptions } from './crewai';
+export { instrumentOpenAI } from './openai-chat';
+export type { InstrumentOpenAIOptions } from './openai-chat';
+export { instrumentMcpClient } from './mcp';
+export type { InstrumentMcpClientOptions } from './mcp';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAC5C,YAAY,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAC"}

package/dist/integrations/index.js

@@ -9,11 +9,15 @@
  *     import { ExeclaveCallbackHandler } from '@execlave/sdk/integrations/langchain';
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.instrumentCrew = exports.ExeclaveTracingProcessor = exports.ExeclaveCallbackHandler = void 0;
+exports.instrumentMcpClient = exports.instrumentOpenAI = 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; } });
+var openai_chat_1 = require("./openai-chat");
+Object.defineProperty(exports, "instrumentOpenAI", { enumerable: true, get: function () { return openai_chat_1.instrumentOpenAI; } });
+var mcp_1 = require("./mcp");
+Object.defineProperty(exports, "instrumentMcpClient", { enumerable: true, get: function () { return mcp_1.instrumentMcpClient; } });
 //# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -1 +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"}
+{"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;AAGvB,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AAGzB,6BAA4C;AAAnC,0GAAA,mBAAmB,OAAA"}

package/dist/integrations/mcp.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Model Context Protocol (MCP) client auto-instrumentation.
+ *
+ * Wrap an `@modelcontextprotocol/sdk` `Client` so every `callTool` is
+ * policy-enforced (tool allowlist) and recorded as a `tool` span.
+ *
+ * ```ts
+ * import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+ * import { Execlave } from '@execlave/sdk';
+ * import { instrumentMcpClient } from '@execlave/sdk/integrations/mcp';
+ *
+ * const exe = new Execlave({ apiKey: '...' });
+ * const mcp = new Client({ name: 'app', version: '1.0' });
+ * instrumentMcpClient(mcp, exe, { agentId: 'my-bot' });
+ *
+ * const result = await mcp.callTool({ name: 'search', arguments: { q: 'x' } });
+ * ```
+ *
+ * Idempotent. No compile-time dependency on the MCP SDK — the call
+ * surface is duck-typed.
+ */
+import type { Execlave } from '../client';
+export interface InstrumentMcpClientOptions {
+    /** Agent id registered with Execlave. Required for enforcement. */
+    agentId: string;
+    /** Run `enforcePolicy` on tool calls. Default true. */
+    enforce?: boolean;
+    sessionId?: string;
+    userId?: string;
+}
+/**
+ * Wrap `client.callTool` to enforce policies and record a tool span.
+ * Returns the same client for fluent chaining.
+ */
+export declare function instrumentMcpClient<T>(client: T, exe: Execlave, opts: InstrumentMcpClientOptions): T;
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/integrations/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAsB1C,MAAM,WAAW,0BAA0B;IACzC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,0BAA0B,GAC/B,CAAC,CA4EH"}

package/dist/integrations/mcp.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Model Context Protocol (MCP) client auto-instrumentation.
+ *
+ * Wrap an `@modelcontextprotocol/sdk` `Client` so every `callTool` is
+ * policy-enforced (tool allowlist) and recorded as a `tool` span.
+ *
+ * ```ts
+ * import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+ * import { Execlave } from '@execlave/sdk';
+ * import { instrumentMcpClient } from '@execlave/sdk/integrations/mcp';
+ *
+ * const exe = new Execlave({ apiKey: '...' });
+ * const mcp = new Client({ name: 'app', version: '1.0' });
+ * instrumentMcpClient(mcp, exe, { agentId: 'my-bot' });
+ *
+ * const result = await mcp.callTool({ name: 'search', arguments: { q: 'x' } });
+ * ```
+ *
+ * Idempotent. No compile-time dependency on the MCP SDK — the call
+ * surface is duck-typed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentMcpClient = instrumentMcpClient;
+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);
+}
+/**
+ * Wrap `client.callTool` to enforce policies and record a tool span.
+ * Returns the same client for fluent chaining.
+ */
+function instrumentMcpClient(client, exe, opts) {
+    if (client === null || client === undefined) {
+        throw new Error('instrumentMcpClient: client must not be null/undefined');
+    }
+    if (!exe)
+        throw new Error('instrumentMcpClient: exe must not be null/undefined');
+    if (!opts?.agentId)
+        throw new Error('instrumentMcpClient: agentId is required');
+    const c = client;
+    if (c[MARKER])
+        return client;
+    const original = c.callTool;
+    if (typeof original !== 'function') {
+        throw new TypeError('instrumentMcpClient: client.callTool is missing or not a function');
+    }
+    const enforce = opts.enforce !== false;
+    const tree = (0, spans_1.getSpanTree)(exe);
+    const boundOriginal = original.bind(c);
+    const wrapped = async (request, ...rest) => {
+        // Both `(name, args)` and `({ name, arguments })` shapes are
+        // supported by various MCP SDK versions.
+        const { name, args } = normaliseCallToolArgs(request, rest);
+        if (enforce && name) {
+            try {
+                await exe.enforcePolicy({
+                    agentId: opts.agentId,
+                    input: safeStr(args) ?? `tool:${name}`,
+                    tools: [name],
+                });
+            }
+            catch (err) {
+                if (isEnforcementError(err))
+                    throw err;
+                // eslint-disable-next-line no-console
+                console.warn('[execlave] MCP enforcePolicy failed (non-fatal):', err);
+            }
+        }
+        const span = tree.start({
+            kind: spans_1.SPAN_KIND_TOOL,
+            name: String(name ?? 'mcp.tool'),
+            agentId: opts.agentId,
+            sessionId: opts.sessionId,
+            userId: opts.userId,
+            metadata: { mcpTool: true },
+        });
+        if (args !== undefined && args !== null) {
+            try {
+                span.setInput(args);
+            }
+            catch {
+                /* noop */
+            }
+        }
+        let result;
+        try {
+            result = await boundOriginal(request, ...rest);
+        }
+        catch (err) {
+            span.finish('error', err?.message ?? String(err), err?.name ?? 'Error');
+            throw err;
+        }
+        try {
+            const text = extractContent(result?.content);
+            if (text !== null)
+                span.setOutput(text);
+        }
+        catch {
+            /* noop */
+        }
+        span.finish(result?.isError ? 'error' : 'success');
+        return result;
+    };
+    try {
+        c.callTool = wrapped;
+        c[MARKER] = true;
+    }
+    catch {
+        /* frozen object */
+    }
+    return client;
+}
+// ----------------------------------------------------------------------
+// Helpers
+// ----------------------------------------------------------------------
+function normaliseCallToolArgs(request, rest) {
+    if (typeof request === 'string') {
+        return { name: request, args: rest[0] };
+    }
+    if (request && typeof request === 'object') {
+        const name = typeof request.name === 'string'
+            ? request.name
+            : typeof request?.params?.name === 'string'
+                ? request.params.name
+                : null;
+        const args = request.arguments !== undefined
+            ? request.arguments
+            : request?.params?.arguments;
+        return { name, args };
+    }
+    return { name: null, args: undefined };
+}
+function extractContent(content) {
+    if (!Array.isArray(content))
+        return safeStr(content);
+    const parts = [];
+    for (const item of content) {
+        const text = item?.text;
+        if (typeof text === 'string')
+            parts.push(text);
+        else {
+            const s = safeStr(item);
+            if (s)
+                parts.push(s);
+        }
+    }
+    return parts.length ? parts.join('\n').slice(0, 4000) : 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=mcp.js.map

package/dist/integrations/mcp.js.map

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

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

@@ -0,0 +1,41 @@
+/**
+ * OpenAI Chat Completions auto-instrumentation.
+ *
+ * Wrap an `openai` client so every `chat.completions.create(...)` call is
+ * governed by Execlave: the user prompt is enforced before the request
+ * leaves, and the call is recorded as an `llm` span with model + token
+ * usage metadata.
+ *
+ * ```ts
+ * import OpenAI from 'openai';
+ * import { Execlave } from '@execlave/sdk';
+ * import { instrumentOpenAI } from '@execlave/sdk/integrations/openai-chat';
+ *
+ * const exe = new Execlave({ apiKey: '...' });
+ * const openai = instrumentOpenAI(new OpenAI(), exe, { agentId: 'my-bot' });
+ *
+ * const resp = await openai.chat.completions.create({
+ *   model: 'gpt-4o-mini',
+ *   messages: [{ role: 'user', content: 'hi' }],
+ * });
+ * ```
+ *
+ * Idempotent — marker prevents double-wrapping. No compile-time
+ * dependency on the openai SDK — the call surface is duck-typed.
+ */
+import type { Execlave } from '../client';
+export interface InstrumentOpenAIOptions {
+    /** Agent id registered with Execlave. Required for enforcement. */
+    agentId: string;
+    /** Run `enforcePolicy` on the user message. Default true. */
+    enforce?: boolean;
+    sessionId?: string;
+    userId?: string;
+}
+/**
+ * Patch `client.chat.completions.create` to enforce policies and record
+ * an LLM span around every call. Returns the same client for fluent
+ * chaining.
+ */
+export declare function instrumentOpenAI<T>(client: T, exe: Execlave, opts: InstrumentOpenAIOptions): T;
+//# sourceMappingURL=openai-chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-chat.d.ts","sourceRoot":"","sources":["../../src/integrations/openai-chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAsB1C,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,uBAAuB,GAAG,CAAC,CAiF9F"}

package/dist/integrations/openai-chat.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * OpenAI Chat Completions auto-instrumentation.
+ *
+ * Wrap an `openai` client so every `chat.completions.create(...)` call is
+ * governed by Execlave: the user prompt is enforced before the request
+ * leaves, and the call is recorded as an `llm` span with model + token
+ * usage metadata.
+ *
+ * ```ts
+ * import OpenAI from 'openai';
+ * import { Execlave } from '@execlave/sdk';
+ * import { instrumentOpenAI } from '@execlave/sdk/integrations/openai-chat';
+ *
+ * const exe = new Execlave({ apiKey: '...' });
+ * const openai = instrumentOpenAI(new OpenAI(), exe, { agentId: 'my-bot' });
+ *
+ * const resp = await openai.chat.completions.create({
+ *   model: 'gpt-4o-mini',
+ *   messages: [{ role: 'user', content: 'hi' }],
+ * });
+ * ```
+ *
+ * Idempotent — marker prevents double-wrapping. No compile-time
+ * dependency on the openai SDK — the call surface is duck-typed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentOpenAI = instrumentOpenAI;
+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);
+}
+/**
+ * Patch `client.chat.completions.create` to enforce policies and record
+ * an LLM span around every call. Returns the same client for fluent
+ * chaining.
+ */
+function instrumentOpenAI(client, exe, opts) {
+    if (client === null || client === undefined) {
+        throw new Error('instrumentOpenAI: client must not be null/undefined');
+    }
+    if (!exe)
+        throw new Error('instrumentOpenAI: exe must not be null/undefined');
+    if (!opts?.agentId)
+        throw new Error('instrumentOpenAI: agentId is required');
+    const c = client;
+    const completions = c?.chat?.completions;
+    if (!completions || typeof completions.create !== 'function') {
+        throw new TypeError('instrumentOpenAI: client.chat.completions.create is missing');
+    }
+    if (completions[MARKER])
+        return client;
+    const enforce = opts.enforce !== false;
+    const tree = (0, spans_1.getSpanTree)(exe);
+    const originalCreate = completions.create.bind(completions);
+    const wrappedCreate = async (params, ...rest) => {
+        const model = params?.model;
+        const messages = params?.messages;
+        if (enforce) {
+            const userText = extractUserInput(messages) ?? 'chat.completions';
+            try {
+                await exe.enforcePolicy({ agentId: opts.agentId, input: userText });
+            }
+            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: spans_1.SPAN_KIND_LLM,
+            name: String(model ?? 'chat.completions'),
+            agentId: opts.agentId,
+            sessionId: opts.sessionId,
+            userId: opts.userId,
+            metadata: { provider: 'openai', endpoint: 'chat.completions' },
+        });
+        if (model)
+            span.setModel(String(model));
+        try {
+            span.setInput(messages);
+        }
+        catch {
+            /* noop */
+        }
+        let response;
+        try {
+            response = await originalCreate(params, ...rest);
+        }
+        catch (err) {
+            span.finish('error', err?.message ?? String(err), err?.name ?? 'Error');
+            throw err;
+        }
+        try {
+            const choices = response?.choices ?? [];
+            const message = choices[0]?.message;
+            const content = message?.content;
+            if (content !== undefined && content !== null)
+                span.setOutput(content);
+            const usage = response?.usage;
+            const p = (usage?.prompt_tokens ?? usage?.promptTokens);
+            const compl = (usage?.completion_tokens ?? usage?.completionTokens);
+            if (typeof p === 'number' && typeof compl === 'number')
+                span.setTokens(p, compl);
+            const respModel = response?.model;
+            if (typeof respModel === 'string' && respModel)
+                span.setModel(respModel);
+        }
+        catch {
+            /* swallow — instrumentation must not break the call */
+        }
+        span.finish('success');
+        return response;
+    };
+    try {
+        completions.create = wrappedCreate;
+        completions[MARKER] = true;
+    }
+    catch {
+        // Frozen object — double-wrap guard inactive but we've done what we can.
+    }
+    return client;
+}
+// ----------------------------------------------------------------------
+// Helpers
+// ----------------------------------------------------------------------
+function extractUserInput(messages) {
+    if (!Array.isArray(messages))
+        return safeStr(messages);
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg?.role !== 'user')
+            continue;
+        const content = msg?.content;
+        if (Array.isArray(content)) {
+            const parts = content
+                .map((p) => (typeof p?.text === 'string' ? p.text : null))
+                .filter((x) => !!x);
+            if (parts.length)
+                return safeStr(parts.join('\n'));
+        }
+        return safeStr(content);
+    }
+    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-chat.js.map

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

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@execlave/sdk",
-  "version": "1.1.5",
-  "description": "Official JavaScript/TypeScript SDK for the Execlave AI agent governance platform — tracing, policy enforcement, and framework auto-instrumentation for LangChain",
+  "version": "1.2.0",
+  "description": "Official JavaScript/TypeScript SDK for the Execlave AI agent governance platform — tracing, policy enforcement, and framework auto-instrumentation for LangChain, OpenAI Agents SDK, CrewAI, Model Context Protocol, and OpenAI Chat Completions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -13,10 +13,30 @@
       "types": "./dist/instrumentation/index.d.ts",
       "default": "./dist/instrumentation/index.js"
     },
+    "./integrations": {
+      "types": "./dist/integrations/index.d.ts",
+      "default": "./dist/integrations/index.js"
+    },
     "./integrations/langchain": {
       "types": "./dist/integrations/langchain.d.ts",
       "default": "./dist/integrations/langchain.js"
     },
+    "./integrations/openai-agents": {
+      "types": "./dist/integrations/openai-agents.d.ts",
+      "default": "./dist/integrations/openai-agents.js"
+    },
+    "./integrations/crewai": {
+      "types": "./dist/integrations/crewai.d.ts",
+      "default": "./dist/integrations/crewai.js"
+    },
+    "./integrations/openai-chat": {
+      "types": "./dist/integrations/openai-chat.d.ts",
+      "default": "./dist/integrations/openai-chat.js"
+    },
+    "./integrations/mcp": {
+      "types": "./dist/integrations/mcp.d.ts",
+      "default": "./dist/integrations/mcp.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -60,10 +80,14 @@
     "ai-compliance",
     "audit",
     "langchain",
-    "openai-agents"
+    "openai-agents",
+    "crewai",
+    "mcp",
+    "model-context-protocol",
+    "openai"
   ],
   "license": "MIT",
-  "author": "Execlave <support@execlave.com>",
+  "author": "Rishit Mavani <support@execlave.com>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/execlave-ai/execlave-js-sdk.git",
@@ -105,12 +129,14 @@
     }
   },
   "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.213.0",
     "@opentelemetry/resources": "^2.6.0",
     "@opentelemetry/sdk-trace-base": "^2.6.0",
     "@types/jest": "^29.5.0",
     "jest": "^29.7.0",
+    "openai": "^4.103.0",
     "rimraf": "^5.0.0",
     "ts-jest": "^29.1.0",
     "typescript": "^5.3.0"