@corti/sdk 4.2.0 → 5.0.0-rc

package/dist/esm/api/types/index.mjs

@@ -1,3 +1,40 @@
+export * from "./AgenticAgentCardResponse.mjs";
+export * from "./AgenticAgentCardResponseCapabilities.mjs";
+export * from "./AgenticAgentCardResponseProvider.mjs";
+export * from "./AgenticAgentCardResponseSignaturesItem.mjs";
+export * from "./AgenticAgentCardResponseSkillsItem.mjs";
+export * from "./AgenticAgentCardResponseSupportedInterfacesItem.mjs";
+export * from "./AgenticAgentCardResponseSupportedInterfacesItemProtocolBinding.mjs";
+export * from "./AgenticAgentsJsonRpcResponse.mjs";
+export * from "./AgenticAgentsJsonRpcResponseError.mjs";
+export * from "./AgenticAgentsJsonRpcResponseId.mjs";
+export * from "./AgenticAgentsListResponse.mjs";
+export * from "./AgenticAgentsResponse.mjs";
+export * from "./AgenticAgentsSendMessageConfiguration.mjs";
+export * from "./AgenticAgentsSendMessageRequest.mjs";
+export * from "./AgenticAgentsSendMessageResponse.mjs";
+export * from "./AgenticAgentsStreamEventResponse.mjs";
+export * from "./AgenticConnectorsListResponse.mjs";
+export * from "./AgenticContext.mjs";
+export * from "./AgenticContextsDetailResponse.mjs";
+export * from "./AgenticContextsListResponse.mjs";
+export * from "./AgenticContextsOpenInferenceSpan.mjs";
+export * from "./AgenticContextsTraceItem.mjs";
+export * from "./AgenticContextsTraceItemTrace.mjs";
+export * from "./AgenticContextsTraceResponse.mjs";
+export * from "./AgenticFeedbackActor.mjs";
+export * from "./AgenticFeedbackIdValue.mjs";
+export * from "./AgenticFeedbackLabel.mjs";
+export * from "./AgenticFeedbackListResponse.mjs";
+export * from "./AgenticFeedbackMetadata.mjs";
+export * from "./AgenticFeedbackRating.mjs";
+export * from "./AgenticFeedbackRatingScale.mjs";
+export * from "./AgenticFeedbackResponse.mjs";
+export * from "./AgenticFeedbackTarget.mjs";
+export * from "./AgenticRegistryConnector.mjs";
+export * from "./AgenticRegistryConnectorCapabilities.mjs";
+export * from "./AgenticRegistryConnectorsListResponse.mjs";
+export * from "./AgenticRegistryIcon.mjs";
 export * from "./AgentsAgent.mjs";
 export * from "./AgentsAgentCapabilities.mjs";
 export * from "./AgentsAgentCard.mjs";
@@ -31,6 +68,8 @@ export * from "./AgentsFilePartFile.mjs";
 export * from "./AgentsFilePartKind.mjs";
 export * from "./AgentsFileWithBytes.mjs";
 export * from "./AgentsFileWithUri.mjs";
+export * from "./AgentsLabels.mjs";
+export * from "./AgentsLifecycle.mjs";
 export * from "./AgentsMcpServer.mjs";
 export * from "./AgentsMcpServerAuthorizationType.mjs";
 export * from "./AgentsMcpServerTransportType.mjs";
@@ -52,8 +91,15 @@ export * from "./AgentsTaskStatusState.mjs";
 export * from "./AgentsTextPart.mjs";
 export * from "./AgentsTextPartKind.mjs";
 export * from "./AgentsUpdateExpertReference.mjs";
+export * from "./AgentsUsageBucket.mjs";
+export * from "./AgentsUsageGranularity.mjs";
+export * from "./AgentsUsageMetrics.mjs";
+export * from "./AgentsUsageReportResponse.mjs";
+export * from "./AgentsUserIdValue.mjs";
+export * from "./AgentsVisibility.mjs";
 export * from "./AuthTokenRequestAuthorizationCode.mjs";
 export * from "./AuthTokenRequestAuthorizationPkce.mjs";
+export * from "./AuthTokenRequestBody.mjs";
 export * from "./AuthTokenRequestClientCredentials.mjs";
 export * from "./AuthTokenRequestRefresh.mjs";
 export * from "./AuthTokenRequestRopc.mjs";
@@ -63,19 +109,58 @@ export * from "./CodesGeneralReadResponse.mjs";
 export * from "./CodesGeneralReadResponseAlternativesItem.mjs";
 export * from "./CodesGeneralReadResponseEvidencesItem.mjs";
 export * from "./CodesGeneralResponse.mjs";
+export * from "./CommonA2AConnector.mjs";
+export * from "./CommonA2AConnectorCreate.mjs";
+export * from "./CommonAgentConnector.mjs";
+export * from "./CommonAgentConnectorCreate.mjs";
+export * from "./CommonAgentIdValue.mjs";
 export * from "./CommonAiContext.mjs";
+export * from "./CommonArtifactIdValue.mjs";
+export * from "./CommonArtifactResponse.mjs";
 export * from "./CommonCodingSystemEnum.mjs";
+export * from "./CommonConnectorAuth.mjs";
+export * from "./CommonConnectorAuthType.mjs";
+export * from "./CommonConnectorCreateRequest.mjs";
+export * from "./CommonConnectorIdValue.mjs";
+export * from "./CommonConnectorResponse.mjs";
+export * from "./CommonConnectorType.mjs";
+export * from "./CommonContextIdValue.mjs";
 export * from "./CommonDocumentationEvidence.mjs";
 export * from "./CommonDocumentIdContext.mjs";
 export * from "./CommonDocumentIdContextType.mjs";
+export * from "./CommonErrorResponse.mjs";
+export * from "./CommonErrorResponseError.mjs";
+export * from "./CommonErrorResponseErrorDetails.mjs";
+export * from "./CommonErrorResponseErrorDetailsValidationErrorsItem.mjs";
 export * from "./CommonFactsContext.mjs";
+export * from "./CommonMcpConnector.mjs";
+export * from "./CommonMcpConnectorCreate.mjs";
+export * from "./CommonMessage.mjs";
+export * from "./CommonMessageIdValue.mjs";
+export * from "./CommonNextPageToken.mjs";
+export * from "./CommonPart.mjs";
+export * from "./CommonRegistryConnectorCreate.mjs";
+export * from "./CommonRegistryConnectorProvisioned.mjs";
+export * from "./CommonRole.mjs";
+export * from "./CommonSchemaConnector.mjs";
+export * from "./CommonSchemaConnectorCreate.mjs";
+export * from "./CommonSchemaConnectorCreateTransition.mjs";
+export * from "./CommonSchemaConnectorTransition.mjs";
 export * from "./CommonSortingDirectionEnum.mjs";
 export * from "./CommonSourceEnum.mjs";
 export * from "./CommonStatusResponse.mjs";
+export * from "./CommonTaskIdValue.mjs";
+export * from "./CommonTaskListResponse.mjs";
+export * from "./CommonTaskMetadata.mjs";
+export * from "./CommonTaskResponse.mjs";
+export * from "./CommonTaskState.mjs";
+export * from "./CommonTaskStatus.mjs";
 export * from "./CommonTextContext.mjs";
+export * from "./CommonTotalSize.mjs";
 export * from "./CommonTranscriptContext.mjs";
 export * from "./CommonTranscriptRequest.mjs";
 export * from "./CommonTranscriptResponse.mjs";
+export * from "./CommonUsage.mjs";
 export * from "./CommonUsageInfo.mjs";
 export * from "./DocumentsContext.mjs";
 export * from "./DocumentsContextWithFacts.mjs";
@@ -116,8 +201,10 @@ export * from "./GuidedArrayNode.mjs";
 export * from "./GuidedAssemblyRequest.mjs";
 export * from "./GuidedAssemblySectionRef.mjs";
 export * from "./GuidedBoolNode.mjs";
+export * from "./GuidedDocument.mjs";
 export * from "./GuidedDocumentContext.mjs";
 export * from "./GuidedDocumentFactMinimal.mjs";
+export * from "./GuidedDocumentSection.mjs";
 export * from "./GuidedDocumentsCreateEphemeralResponse.mjs";
 export * from "./GuidedDocumentsGenerateBase.mjs";
 export * from "./GuidedDocumentsGenerateByAssembly.mjs";

package/dist/esm/core/headers.d.mts

@@ -1,2 +1,5 @@
-export declare function mergeHeaders(...headersArray: (Record<string, unknown> | null | undefined)[]): Record<string, unknown>;
+/** Patch: X-Corti-Analytics - renamed generated merge; public mergeHeaders is the custom wrap */
+export declare function mergeHeadersOriginal(...headersArray: (Record<string, unknown> | null | undefined)[]): Record<string, unknown>;
 export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, unknown> | null | undefined)[]): Record<string, unknown>;
+/** Patch: X-Corti-Analytics - public mergeHeaders is the custom wrap that reuses mergeHeadersOriginal */
+export { mergeHeaders } from "../custom/overrides/headers.mjs";

package/dist/esm/core/headers.mjs

@@ -1,4 +1,5 @@
-export function mergeHeaders(...headersArray) {
+/** Patch: X-Corti-Analytics - renamed generated merge; public mergeHeaders is the custom wrap */
+export function mergeHeadersOriginal(...headersArray) {
     const result = {};
     for (const [key, value] of headersArray
         .filter((headers) => headers != null)
@@ -25,3 +26,5 @@ export function mergeOnlyDefinedHeaders(...headersArray) {
     }
     return result;
 }
+/** Patch: X-Corti-Analytics - public mergeHeaders is the custom wrap that reuses mergeHeadersOriginal */
+export { mergeHeaders } from "../custom/overrides/headers.mjs";

package/dist/esm/core/index.d.mts

@@ -6,6 +6,7 @@ export * as logging from "./logging/index.mjs";
 export * from "./pagination/index.mjs";
 export * from "./runtime/index.mjs";
 export * as serialization from "./schemas/index.mjs";
+export * from "./stream/index.mjs";
 export * as url from "./url/index.mjs";
 export * from "./utils/index.mjs";
 export * from "./websocket/index.mjs";

package/dist/esm/core/index.mjs

@@ -6,6 +6,7 @@ export * as logging from "./logging/index.mjs";
 export * from "./pagination/index.mjs";
 export * from "./runtime/index.mjs";
 export * as serialization from "./schemas/index.mjs";
+export * from "./stream/index.mjs";
 export * as url from "./url/index.mjs";
 export * from "./utils/index.mjs";
 export * from "./websocket/index.mjs";

package/dist/esm/core/stream/Stream.d.mts

@@ -0,0 +1,56 @@
+export declare namespace Stream {
+    interface Args {
+        /**
+         * The HTTP response stream to read from.
+         */
+        stream: ReadableStream;
+        /**
+         * The event shape to use for parsing the stream data.
+         */
+        eventShape: JsonEvent | SseEvent;
+        /**
+         * An abort signal to stop the stream.
+         */
+        signal?: AbortSignal;
+    }
+    interface JsonEvent {
+        type: "json";
+        messageTerminator: string;
+    }
+    interface SseEvent {
+        type: "sse";
+        streamTerminator?: string;
+        eventDiscriminator?: string;
+    }
+}
+export declare class Stream<T> implements AsyncIterable<T> {
+    private stream;
+    private parse;
+    /**
+     * The prefix to use for each message. For example,
+     * for SSE, the prefix is "data: ".
+     */
+    private prefix;
+    private messageTerminator;
+    private streamTerminator;
+    private eventDiscriminator;
+    private controller;
+    private decoder;
+    constructor({ stream, parse, eventShape, signal }: Stream.Args & {
+        parse: (val: unknown) => Promise<T>;
+    });
+    private iterMessages;
+    private iterDataMessages;
+    private iterSseEvents;
+    /**
+     * Parses and returns a single SSE event, or returns null if the event is a stream terminator.
+     */
+    private dispatchSseEvent;
+    private injectDiscriminator;
+    [Symbol.asyncIterator](): AsyncIterator<T, void, unknown>;
+    private decodeChunk;
+}
+/**
+ * Browser polyfill for ReadableStream
+ */
+export declare function readableStreamAsyncIterable<T>(stream: any): AsyncIterableIterator<T>;

package/dist/esm/core/stream/Stream.mjs

@@ -0,0 +1,262 @@
+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]); }
+};
+import { fromJson } from "../json.mjs";
+import { RUNTIME } from "../runtime/index.mjs";
+const DATA_PREFIX = "data:";
+const EVENT_PREFIX = "event:";
+export 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(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(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 (RUNTIME.type === "node" && typeof chunk !== "undefined") {
+            decoded += Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        }
+        return decoded;
+    }
+}
+/**
+ * Browser polyfill for ReadableStream
+ */
+// biome-ignore lint/suspicious/noExplicitAny: allow explicit any
+export 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/esm/core/stream/index.d.mts

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

package/dist/esm/core/stream/index.mjs

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

package/dist/esm/custom/CortiClient.d.mts

@@ -1,5 +1,6 @@
 import { CortiClient as BaseCortiClient } from "../Client.mjs";
 import type * as environments from "../environments.mjs";
+import { CustomAgentic } from "./agentic/CustomAgentic.mjs";
 import { CustomAgents } from "./agents/CustomAgents.mjs";
 import { CortiAuth } from "./auth/CortiAuth.mjs";
 import { CustomStream } from "./stream/CustomStream.mjs";
@@ -7,6 +8,11 @@ import { CustomTranscribe } from "./transcribe/CustomTranscribe.mjs";
 import { type Environment } from "./utils/environment.mjs";
 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/esm/custom/CortiClient.mjs

@@ -8,11 +8,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { CortiClient as BaseCortiClient } from "../Client.mjs";
+import { mergeHeaders } from "../core/headers.mjs";
 import * as core from "../core/index.mjs";
+import { CustomAgentic } from "./agentic/CustomAgentic.mjs";
 import { CustomAgents } from "./agents/CustomAgents.mjs";
 import { CortiAuth } from "./auth/CortiAuth.mjs";
 import { CustomStream } from "./stream/CustomStream.mjs";
 import { CustomTranscribe } from "./transcribe/CustomTranscribe.mjs";
+import { X_CORTI_ANALYTICS } from "./utils/analytics.mjs";
 import { authToBaseOptions } from "./utils/authToBaseOptions.mjs";
 import { getEnvironment } from "./utils/environment.mjs";
 import { resolveClientOptions } from "./utils/resolveClientOptions.mjs";
@@ -21,7 +24,9 @@ export class CortiClient extends BaseCortiClient {
     constructor(options) {
         const opts = options;
         const ctx = resolveClientOptions(options);
-        const restOptions = Object.assign(Object.assign(Object.assign({}, opts), { tenantName: ctx.tenantName, environment: getEnvironment(ctx.environment) }), (ctx.initialTokenResponse != null ? { initialTokenResponse: ctx.initialTokenResponse } : {}));
+        const restOptions = Object.assign(Object.assign(Object.assign({}, opts), { headers: mergeHeaders(options.headers, {
+                [X_CORTI_ANALYTICS]: options.analytics,
+            }), tenantName: ctx.tenantName, environment: getEnvironment(ctx.environment) }), (ctx.initialTokenResponse != null ? { initialTokenResponse: ctx.initialTokenResponse } : {}));
         super(authToBaseOptions(opts.auth, restOptions));
         /**
          * Returns the full set of URLs the client is configured to use.
@@ -67,6 +72,7 @@ export class CortiClient extends BaseCortiClient {
         });
         setDefaultWithCredentials(options.withCredentials);
         this._encodeHeadersAsWsProtocols = options.encodeHeadersAsWsProtocols;
+        this._analytics = options.analytics;
     }
     get auth() {
         var _a;
@@ -74,14 +80,19 @@ export class CortiClient extends BaseCortiClient {
     }
     get stream() {
         var _a;
-        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new CustomStream(Object.assign(Object.assign({}, this._options), { encodeHeadersAsWsProtocols: this._encodeHeadersAsWsProtocols }))));
+        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new 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(Object.assign(Object.assign({}, this._options), { encodeHeadersAsWsProtocols: this._encodeHeadersAsWsProtocols }))));
+        return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new 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(this._options)));
     }
+    get agentic() {
+        var _a;
+        return ((_a = this._agentic) !== null && _a !== void 0 ? _a : (this._agentic = new CustomAgentic(this._options)));
+    }
 }

package/dist/esm/custom/agentic/CustomAgentic.d.mts

@@ -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.mjs";
+import { CustomAgenticAgents } from "./CustomAgenticAgents.mjs";
+export declare class CustomAgentic extends AgenticClient {
+    protected _agents: CustomAgenticAgents | undefined;
+    get agents(): CustomAgenticAgents;
+}

package/dist/esm/custom/agentic/CustomAgentic.mjs

@@ -0,0 +1,13 @@
+/**
+ * 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.mjs";
+import { CustomAgenticAgents } from "./CustomAgenticAgents.mjs";
+export class CustomAgentic extends AgenticClient {
+    get agents() {
+        var _a;
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new CustomAgenticAgents(this._options)));
+    }
+}

package/dist/esm/custom/agentic/CustomAgenticAgents.d.mts

@@ -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.mjs";
+import { AgentsClient } from "../../api/resources/agentic/resources/agents/client/Client.mjs";
+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>;
+}