@corti/sdk 4.2.0 → 5.0.0-rc

package/dist/cjs/core/stream/Stream.js

@@ -0,0 +1,267 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncDelegator = (this && this.__asyncDelegator) || function (o) {
+    var i, p;
+    return i = {}, verb("next"), verb("throw", function (e) { throw e; }), verb("return"), i[Symbol.iterator] = function () { return this; }, i;
+    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v; } : f; }
+};
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Stream = void 0;
+exports.readableStreamAsyncIterable = readableStreamAsyncIterable;
+const json_js_1 = require("../json.js");
+const index_js_1 = require("../runtime/index.js");
+const DATA_PREFIX = "data:";
+const EVENT_PREFIX = "event:";
+class Stream {
+    constructor({ stream, parse, eventShape, signal }) {
+        this.controller = new AbortController();
+        this.stream = stream;
+        this.parse = parse;
+        if (eventShape.type === "sse") {
+            this.prefix = DATA_PREFIX;
+            this.messageTerminator = "\n";
+            this.streamTerminator = eventShape.streamTerminator;
+            this.eventDiscriminator = eventShape.eventDiscriminator;
+        }
+        else {
+            this.messageTerminator = eventShape.messageTerminator;
+        }
+        signal === null || signal === void 0 ? void 0 : signal.addEventListener("abort", () => this.controller.abort());
+        // Initialize shared TextDecoder
+        if (typeof TextDecoder !== "undefined") {
+            this.decoder = new TextDecoder("utf-8");
+        }
+    }
+    iterMessages() {
+        return __asyncGenerator(this, arguments, function* iterMessages_1() {
+            if (this.eventDiscriminator != null) {
+                yield __await(yield* __asyncDelegator(__asyncValues(this.iterSseEvents())));
+            }
+            else {
+                yield __await(yield* __asyncDelegator(__asyncValues(this.iterDataMessages())));
+            }
+        });
+    }
+    iterDataMessages() {
+        return __asyncGenerator(this, arguments, function* iterDataMessages_1() {
+            var _a, e_1, _b, _c;
+            const stream = readableStreamAsyncIterable(this.stream);
+            let buf = "";
+            let prefixSeen = false;
+            try {
+                for (var _d = true, stream_1 = __asyncValues(stream), stream_1_1; stream_1_1 = yield __await(stream_1.next()), _a = stream_1_1.done, !_a; _d = true) {
+                    _c = stream_1_1.value;
+                    _d = false;
+                    const chunk = _c;
+                    buf += this.decodeChunk(chunk);
+                    let terminatorIndex;
+                    while ((terminatorIndex = buf.indexOf(this.messageTerminator)) >= 0) {
+                        let line = buf.slice(0, terminatorIndex);
+                        buf = buf.slice(terminatorIndex + this.messageTerminator.length);
+                        if (!line.trim()) {
+                            continue;
+                        }
+                        if (!prefixSeen && this.prefix != null) {
+                            const prefixIndex = line.indexOf(this.prefix);
+                            if (prefixIndex === -1) {
+                                continue;
+                            }
+                            prefixSeen = true;
+                            line = line.slice(prefixIndex + this.prefix.length);
+                        }
+                        if (this.streamTerminator != null && line.includes(this.streamTerminator)) {
+                            return yield __await(void 0);
+                        }
+                        const message = yield __await(this.parse((0, json_js_1.fromJson)(line)));
+                        yield yield __await(message);
+                        prefixSeen = false;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = stream_1.return)) yield __await(_b.call(stream_1));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        });
+    }
+    iterSseEvents() {
+        return __asyncGenerator(this, arguments, function* iterSseEvents_1() {
+            var _a, e_2, _b, _c;
+            const stream = readableStreamAsyncIterable(this.stream);
+            let buf = "";
+            let eventType;
+            let dataValue;
+            try {
+                for (var _d = true, stream_2 = __asyncValues(stream), stream_2_1; stream_2_1 = yield __await(stream_2.next()), _a = stream_2_1.done, !_a; _d = true) {
+                    _c = stream_2_1.value;
+                    _d = false;
+                    const chunk = _c;
+                    buf += this.decodeChunk(chunk);
+                    let terminatorIndex;
+                    while ((terminatorIndex = buf.indexOf("\n")) >= 0) {
+                        const line = buf.slice(0, terminatorIndex).replace(/\r$/, "");
+                        buf = buf.slice(terminatorIndex + 1);
+                        if (!line.trim()) {
+                            if (dataValue != null) {
+                                const message = yield __await(this.dispatchSseEvent(dataValue, eventType));
+                                if (message == null) {
+                                    return yield __await(void 0);
+                                }
+                                yield yield __await(message);
+                            }
+                            eventType = undefined;
+                            dataValue = undefined;
+                            continue;
+                        }
+                        if (line.startsWith(EVENT_PREFIX)) {
+                            eventType = line.slice(EVENT_PREFIX.length).trim();
+                        }
+                        else if (line.startsWith(DATA_PREFIX)) {
+                            const val = line.slice(DATA_PREFIX.length).trim();
+                            dataValue = dataValue != null ? `${dataValue}\n${val}` : val;
+                        }
+                    }
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = stream_2.return)) yield __await(_b.call(stream_2));
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+            if (dataValue != null) {
+                const message = yield __await(this.dispatchSseEvent(dataValue, eventType));
+                if (message != null) {
+                    yield yield __await(message);
+                }
+            }
+        });
+    }
+    /**
+     * Parses and returns a single SSE event, or returns null if the event is a stream terminator.
+     */
+    dispatchSseEvent(dataValue, eventType) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.streamTerminator != null && dataValue.includes(this.streamTerminator)) {
+                return null;
+            }
+            return this.parse(this.injectDiscriminator((0, json_js_1.fromJson)(dataValue), eventType));
+        });
+    }
+    injectDiscriminator(parsed, eventType) {
+        if (this.eventDiscriminator == null || eventType == null) {
+            return parsed;
+        }
+        if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return parsed;
+        }
+        const obj = parsed;
+        if (this.eventDiscriminator in obj) {
+            return parsed;
+        }
+        return Object.assign({ [this.eventDiscriminator]: eventType }, obj);
+    }
+    [Symbol.asyncIterator]() {
+        return __asyncGenerator(this, arguments, function* _a() {
+            var _b, e_3, _c, _d;
+            try {
+                for (var _e = true, _f = __asyncValues(this.iterMessages()), _g; _g = yield __await(_f.next()), _b = _g.done, !_b; _e = true) {
+                    _d = _g.value;
+                    _e = false;
+                    const message = _d;
+                    yield yield __await(message);
+                }
+            }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (!_e && !_b && (_c = _f.return)) yield __await(_c.call(_f));
+                }
+                finally { if (e_3) throw e_3.error; }
+            }
+        });
+    }
+    decodeChunk(chunk) {
+        let decoded = "";
+        // If TextDecoder is available, use the streaming decoder instance
+        if (this.decoder != null) {
+            decoded += this.decoder.decode(chunk, { stream: true });
+        }
+        // Buffer is present in Node.js environment
+        else if (index_js_1.RUNTIME.type === "node" && typeof chunk !== "undefined") {
+            decoded += Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        }
+        return decoded;
+    }
+}
+exports.Stream = Stream;
+/**
+ * Browser polyfill for ReadableStream
+ */
+// biome-ignore lint/suspicious/noExplicitAny: allow explicit any
+function readableStreamAsyncIterable(stream) {
+    if (stream[Symbol.asyncIterator]) {
+        return stream;
+    }
+    const reader = stream.getReader();
+    return {
+        next() {
+            return __awaiter(this, void 0, void 0, function* () {
+                try {
+                    const result = yield reader.read();
+                    if (result === null || result === void 0 ? void 0 : result.done) {
+                        reader.releaseLock();
+                    } // release lock when stream becomes closed
+                    return result;
+                }
+                catch (e) {
+                    reader.releaseLock(); // release lock when stream becomes errored
+                    throw e;
+                }
+            });
+        },
+        return() {
+            return __awaiter(this, void 0, void 0, function* () {
+                const cancelPromise = reader.cancel();
+                reader.releaseLock();
+                yield cancelPromise;
+                return { done: true, value: undefined };
+            });
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+}

package/dist/cjs/core/stream/index.d.ts

@@ -0,0 +1 @@
+export { Stream } from "./Stream.js";

package/dist/cjs/core/stream/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Stream = void 0;
+var Stream_js_1 = require("./Stream.js");
+Object.defineProperty(exports, "Stream", { enumerable: true, get: function () { return Stream_js_1.Stream; } });

package/dist/cjs/custom/CortiClient.d.ts

@@ -1,5 +1,6 @@
 import { CortiClient as BaseCortiClient } from "../Client.js";
 import type * as environments from "../environments.js";
+import { CustomAgentic } from "./agentic/CustomAgentic.js";
 import { CustomAgents } from "./agents/CustomAgents.js";
 import { CortiAuth } from "./auth/CortiAuth.js";
 import { CustomStream } from "./stream/CustomStream.js";
@@ -7,6 +8,11 @@ import { CustomTranscribe } from "./transcribe/CustomTranscribe.js";
 import { type Environment } from "./utils/environment.js";
 type OptionsBase = Omit<BaseCortiClient.Options, "clientId" | "clientSecret" | "token" | "environment" | "tenantName" | "baseUrl"> & {
     withCredentials?: boolean;
+    /**
+     * Additional call-site metadata merged into the X-Corti-Analytics payload.
+     * `sdk_version` and `sdk_type` are reserved and always set by the SDK.
+     */
+    analytics?: Record<string, string>;
     /**
      * When true, encodes the client's auth headers as WebSocket subprotocol pairs instead of
      * HTTP headers on every WebSocket connection. Useful when connecting through a gateway
@@ -42,12 +48,16 @@ export declare class CortiClient extends BaseCortiClient {
     protected _stream: CustomStream | undefined;
     protected _transcribe: CustomTranscribe | undefined;
     protected _agents: CustomAgents | undefined;
+    protected _agentic: CustomAgentic | undefined;
     private readonly _encodeHeadersAsWsProtocols;
+    private readonly _analytics;
     constructor(options: CortiClient.Options);
     get auth(): CortiAuth;
     get stream(): CustomStream;
     get transcribe(): CustomTranscribe;
+    /** @deprecated Migrate to the Agentic API v2. See https://docs.corti.ai/agentic/guides/migrate-v1-to-v2 */
     get agents(): CustomAgents;
+    get agentic(): CustomAgentic;
     /**
      * Returns the full set of URLs the client is configured to use.
      *

package/dist/cjs/custom/CortiClient.js

@@ -44,11 +44,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CortiClient = void 0;
 const Client_js_1 = require("../Client.js");
+const headers_js_1 = require("../core/headers.js");
 const core = __importStar(require("../core/index.js"));
+const CustomAgentic_js_1 = require("./agentic/CustomAgentic.js");
 const CustomAgents_js_1 = require("./agents/CustomAgents.js");
 const CortiAuth_js_1 = require("./auth/CortiAuth.js");
 const CustomStream_js_1 = require("./stream/CustomStream.js");
 const CustomTranscribe_js_1 = require("./transcribe/CustomTranscribe.js");
+const analytics_js_1 = require("./utils/analytics.js");
 const authToBaseOptions_js_1 = require("./utils/authToBaseOptions.js");
 const environment_js_1 = require("./utils/environment.js");
 const resolveClientOptions_js_1 = require("./utils/resolveClientOptions.js");
@@ -57,7 +60,9 @@ class CortiClient extends Client_js_1.CortiClient {
     constructor(options) {
         const opts = options;
         const ctx = (0, resolveClientOptions_js_1.resolveClientOptions)(options);
-        const restOptions = Object.assign(Object.assign(Object.assign({}, opts), { tenantName: ctx.tenantName, environment: (0, environment_js_1.getEnvironment)(ctx.environment) }), (ctx.initialTokenResponse != null ? { initialTokenResponse: ctx.initialTokenResponse } : {}));
+        const restOptions = Object.assign(Object.assign(Object.assign({}, opts), { headers: (0, headers_js_1.mergeHeaders)(options.headers, {
+                [analytics_js_1.X_CORTI_ANALYTICS]: options.analytics,
+            }), tenantName: ctx.tenantName, environment: (0, environment_js_1.getEnvironment)(ctx.environment) }), (ctx.initialTokenResponse != null ? { initialTokenResponse: ctx.initialTokenResponse } : {}));
         super((0, authToBaseOptions_js_1.authToBaseOptions)(opts.auth, restOptions));
         /**
          * Returns the full set of URLs the client is configured to use.
@@ -103,6 +108,7 @@ class CortiClient extends Client_js_1.CortiClient {
         });
         (0, withCredentialsConfig_js_1.setDefaultWithCredentials)(options.withCredentials);
         this._encodeHeadersAsWsProtocols = options.encodeHeadersAsWsProtocols;
+        this._analytics = options.analytics;
     }
     get auth() {
         var _a;
@@ -110,15 +116,20 @@ class CortiClient extends Client_js_1.CortiClient {
     }
     get stream() {
         var _a;
-        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new CustomStream_js_1.CustomStream(Object.assign(Object.assign({}, this._options), { encodeHeadersAsWsProtocols: this._encodeHeadersAsWsProtocols }))));
+        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new CustomStream_js_1.CustomStream(Object.assign(Object.assign({}, this._options), { encodeHeadersAsWsProtocols: this._encodeHeadersAsWsProtocols, analytics: this._analytics }))));
     }
     get transcribe() {
         var _a;
-        return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new CustomTranscribe_js_1.CustomTranscribe(Object.assign(Object.assign({}, this._options), { encodeHeadersAsWsProtocols: this._encodeHeadersAsWsProtocols }))));
+        return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new CustomTranscribe_js_1.CustomTranscribe(Object.assign(Object.assign({}, this._options), { encodeHeadersAsWsProtocols: this._encodeHeadersAsWsProtocols, analytics: this._analytics }))));
     }
+    /** @deprecated Migrate to the Agentic API v2. See https://docs.corti.ai/agentic/guides/migrate-v1-to-v2 */
     get agents() {
         var _a;
         return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new CustomAgents_js_1.CustomAgents(this._options)));
     }
+    get agentic() {
+        var _a;
+        return ((_a = this._agentic) !== null && _a !== void 0 ? _a : (this._agentic = new CustomAgentic_js_1.CustomAgentic(this._options)));
+    }
 }
 exports.CortiClient = CortiClient;

package/dist/cjs/custom/agentic/CustomAgentic.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Custom Agentic client (src/api/resources/agentic/client/Client.ts).
+ *
+ * Extends the auto-generated AgenticClient so nested agents uses CustomAgenticAgents.
+ */
+import { AgenticClient } from "../../api/resources/agentic/client/Client.js";
+import { CustomAgenticAgents } from "./CustomAgenticAgents.js";
+export declare class CustomAgentic extends AgenticClient {
+    protected _agents: CustomAgenticAgents | undefined;
+    get agents(): CustomAgenticAgents;
+}

package/dist/cjs/custom/agentic/CustomAgentic.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Custom Agentic client (src/api/resources/agentic/client/Client.ts).
+ *
+ * Extends the auto-generated AgenticClient so nested agents uses CustomAgenticAgents.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomAgentic = void 0;
+const Client_js_1 = require("../../api/resources/agentic/client/Client.js");
+const CustomAgenticAgents_js_1 = require("./CustomAgenticAgents.js");
+class CustomAgentic extends Client_js_1.AgenticClient {
+    get agents() {
+        var _a;
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new CustomAgenticAgents_js_1.CustomAgenticAgents(this._options)));
+    }
+}
+exports.CustomAgentic = CustomAgentic;

package/dist/cjs/custom/agentic/CustomAgenticAgents.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Custom Agents client under client.agentic.agents.
+ *
+ * Extends the auto-generated AgentsClient with helper methods.
+ */
+import type * as Corti from "../../api/index.js";
+import { AgentsClient } from "../../api/resources/agentic/resources/agents/client/Client.js";
+export declare class CustomAgenticAgents extends AgentsClient {
+    /**
+     * Returns the URL for the agent card JSON file.
+     *
+     * @param {Corti.CommonAgentIdValue} agentId - The ID of the agent
+     * @returns {Promise<URL>} A Promise that resolves to the URL for the agent card
+     *
+     * @example
+     *     const url = await client.agentic.agents.getCardUrl("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
+     */
+    getCardUrl: (agentId: Corti.CommonAgentIdValue) => Promise<URL>;
+}

package/dist/cjs/custom/agentic/CustomAgenticAgents.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Custom Agents client under client.agentic.agents.
+ *
+ * Extends the auto-generated AgentsClient with helper methods.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomAgenticAgents = void 0;
+const Client_js_1 = require("../../api/resources/agentic/resources/agents/client/Client.js");
+const core = __importStar(require("../../core/index.js"));
+class CustomAgenticAgents extends Client_js_1.AgentsClient {
+    constructor() {
+        super(...arguments);
+        /**
+         * Returns the URL for the agent card JSON file.
+         *
+         * @param {Corti.CommonAgentIdValue} agentId - The ID of the agent
+         * @returns {Promise<URL>} A Promise that resolves to the URL for the agent card
+         *
+         * @example
+         *     const url = await client.agentic.agents.getCardUrl("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
+         */
+        this.getCardUrl = (agentId) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const base = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment)).base;
+            return new URL(core.url.join(base, `agentic/agents/${core.url.encodePathParam(agentId)}/.well-known/agent-card.json`));
+        });
+    }
+}
+exports.CustomAgenticAgents = CustomAgenticAgents;

package/dist/cjs/custom/agents/CustomAgents.d.ts

@@ -3,9 +3,10 @@
  *
  * It extends the auto-generated Agents class and adds custom helper methods.
  *
- * All the patches marked with `// Patch: ...` comments.
+ * @deprecated Migrate to the Agentic API v2. See https://docs.corti.ai/agentic/guides/migrate-v1-to-v2
  */
 import { AgentsClient } from "../../api/resources/agents/client/Client.js";
+/** @deprecated Migrate to the Agentic API v2. See https://docs.corti.ai/agentic/guides/migrate-v1-to-v2 */
 export declare class CustomAgents extends AgentsClient {
     /**
      * Returns the URL for the agent card JSON file.
@@ -13,8 +14,10 @@ export declare class CustomAgents extends AgentsClient {
      * @param {string} agentId - The ID of the agent
      * @returns {Promise<URL>} A Promise that resolves to the URL for the agent card
      *
+     * @deprecated Migrate to the Agentic API v2. See https://docs.corti.ai/agentic/guides/migrate-v1-to-v2
+     *
      * @example
-     *     const url = await client.agents.getAgentCardUrl("agent-123");
+     *     const url = await client.agents.getCardUrl("agent-123");
      */
     getCardUrl: (agentId: string) => Promise<URL>;
 }

package/dist/cjs/custom/agents/CustomAgents.js

@@ -4,7 +4,7 @@
  *
  * It extends the auto-generated Agents class and adds custom helper methods.
  *
- * All the patches marked with `// Patch: ...` comments.
+ * @deprecated Migrate to the Agentic API v2. See https://docs.corti.ai/agentic/guides/migrate-v1-to-v2
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -52,6 +52,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CustomAgents = void 0;
 const Client_js_1 = require("../../api/resources/agents/client/Client.js");
 const core = __importStar(require("../../core/index.js"));
+/** @deprecated Migrate to the Agentic API v2. See https://docs.corti.ai/agentic/guides/migrate-v1-to-v2 */
 class CustomAgents extends Client_js_1.AgentsClient {
     constructor() {
         super(...arguments);
@@ -61,8 +62,10 @@ class CustomAgents extends Client_js_1.AgentsClient {
          * @param {string} agentId - The ID of the agent
          * @returns {Promise<URL>} A Promise that resolves to the URL for the agent card
          *
+         * @deprecated Migrate to the Agentic API v2. See https://docs.corti.ai/agentic/guides/migrate-v1-to-v2
+         *
          * @example
-         *     const url = await client.agents.getAgentCardUrl("agent-123");
+         *     const url = await client.agents.getCardUrl("agent-123");
          */
         this.getCardUrl = (agentId) => __awaiter(this, void 0, void 0, function* () {
             const encodedAgentId = encodeURIComponent(agentId);

package/dist/cjs/custom/overrides/headers.d.ts

@@ -0,0 +1 @@
+export declare function mergeHeaders(...headersArray: (Record<string, unknown> | null | undefined)[]): Record<string, unknown>;

package/dist/cjs/custom/overrides/headers.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeHeaders = mergeHeaders;
+const headers_js_1 = require("../../core/headers.js");
+const analytics_js_1 = require("../utils/analytics.js");
+function mergeHeaders(...headersArray) {
+    const rest = [];
+    let analytics;
+    for (const headers of headersArray) {
+        if (!headers) {
+            continue;
+        }
+        const cleaned = {};
+        for (const [key, value] of Object.entries(headers)) {
+            if (key.toLowerCase() !== analytics_js_1.X_CORTI_ANALYTICS) {
+                cleaned[key] = value;
+                continue;
+            }
+            const parsed = (0, analytics_js_1.parseAnalytics)(value);
+            if (parsed) {
+                Object.assign((analytics !== null && analytics !== void 0 ? analytics : (analytics = {})), parsed);
+            }
+        }
+        rest.push(cleaned);
+    }
+    return (0, headers_js_1.mergeHeadersOriginal)(...rest, (0, analytics_js_1.withAnalytics)(analytics));
+}

package/dist/cjs/custom/stream/CustomStream.d.ts

@@ -19,8 +19,10 @@ export type CustomStreamConnectArgs = {
 } & Partial<Omit<StreamClient.ConnectArgs, "id" | "tenantName" | "token">>;
 export declare class CustomStream extends StreamClient {
     private readonly _encodeHeadersAsWsProtocols;
+    private readonly _analytics;
     constructor(options: StreamClient.Options & {
         encodeHeadersAsWsProtocols?: boolean;
+        analytics?: Record<string, string>;
     });
     connect(args: CustomStreamConnectArgs): Promise<CustomStreamSocket>;
     /**

package/dist/cjs/custom/stream/CustomStream.js

@@ -58,6 +58,7 @@ const Corti = __importStar(require("../../api/index.js"));
 const Client_js_1 = require("../../api/resources/stream/client/Client.js");
 const core = __importStar(require("../../core/index.js"));
 const events_js_1 = require("../../core/websocket/events.js");
+const analytics_js_1 = require("../utils/analytics.js");
 const encodeHeadersAsWsProtocols_js_1 = require("../utils/encodeHeadersAsWsProtocols.js");
 const CustomStreamSocket_js_1 = require("./CustomStreamSocket.js");
 const parseStreamResponseType_js_1 = require("./parseStreamResponseType.js");
@@ -70,13 +71,14 @@ class CustomStream extends Client_js_1.StreamClient {
     constructor(options) {
         super(options);
         this._encodeHeadersAsWsProtocols = options.encodeHeadersAsWsProtocols;
+        this._analytics = options.analytics;
     }
     connect(args) {
         const _super = Object.create(null, {
             connect: { get: () => super.connect }
         });
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h;
+            var _a, _b, _c, _d, _e, _f, _g;
             const { configuration, awaitConfiguration = true, proxy } = args, rest = __rest(args, ["configuration", "awaitConfiguration", "proxy"]);
             const useProxyPath = proxy || this._encodeHeadersAsWsProtocols;
             const protocols = yield (0, encodeHeadersAsWsProtocols_js_1.getWsProtocols)(Object.assign(Object.assign({}, this._options), { encodeHeadersAsWsProtocols: this._encodeHeadersAsWsProtocols }), proxy === null || proxy === void 0 ? void 0 : proxy.protocols);
@@ -84,11 +86,11 @@ class CustomStream extends Client_js_1.StreamClient {
                 ? new core.ReconnectingWebSocket({
                     url: (_a = proxy === null || proxy === void 0 ? void 0 : proxy.url) !== null && _a !== void 0 ? _a : core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)).wss, `/interactions/${core.url.encodePathParam(rest.id)}/streams`),
                     protocols,
-                    queryParameters: (_c = proxy === null || proxy === void 0 ? void 0 : proxy.queryParameters) !== null && _c !== void 0 ? _c : {},
-                    headers: (_d = rest.headers) !== null && _d !== void 0 ? _d : {},
-                    options: { debug: (_e = rest.debug) !== null && _e !== void 0 ? _e : false, maxRetries: (_f = rest.reconnectAttempts) !== null && _f !== void 0 ? _f : 30 },
+                    queryParameters: (0, analytics_js_1.withAnalytics)(this._analytics, proxy === null || proxy === void 0 ? void 0 : proxy.queryParameters),
+                    headers: (_c = rest.headers) !== null && _c !== void 0 ? _c : {},
+                    options: { debug: (_d = rest.debug) !== null && _d !== void 0 ? _d : false, maxRetries: (_e = rest.reconnectAttempts) !== null && _e !== void 0 ? _e : 30 },
                 })
-                : (yield _super.connect.call(this, Object.assign(Object.assign({}, rest), { token: ((_h = (yield ((_g = this._options.authProvider) === null || _g === void 0 ? void 0 : _g.getAuthRequest()))) === null || _h === void 0 ? void 0 : _h.headers.Authorization) || "", tenantName: yield core.Supplier.get(this._options.tenantName) }))).socket;
+                : (yield _super.connect.call(this, Object.assign(Object.assign({}, rest), { token: ((_g = (yield ((_f = this._options.authProvider) === null || _f === void 0 ? void 0 : _f.getAuthRequest()))) === null || _g === void 0 ? void 0 : _g.headers.Authorization) || "", tenantName: yield core.Supplier.get(this._options.tenantName), queryParams: (0, analytics_js_1.withAnalytics)(this._analytics, rest.queryParams) }))).socket;
             const ws = new CustomStreamSocket_js_1.CustomStreamSocket({ socket });
             if (!configuration) {
                 return ws;

package/dist/cjs/custom/transcribe/CustomTranscribe.d.ts

@@ -18,8 +18,10 @@ export type CustomTranscribeConnectArgs = {
 } & Partial<Omit<TranscribeClient.ConnectArgs, "tenantName" | "token">>;
 export declare class CustomTranscribe extends TranscribeClient {
     private readonly _encodeHeadersAsWsProtocols;
+    private readonly _analytics;
     constructor(options: TranscribeClient.Options & {
         encodeHeadersAsWsProtocols?: boolean;
+        analytics?: Record<string, string>;
     });
     connect(args?: CustomTranscribeConnectArgs): Promise<CustomTranscribeSocket>;
     /**