@corti/sdk 4.2.0 → 5.0.0-rc

package/README.md

@@ -18,6 +18,7 @@ The Corti JavaScript library provides convenient access to the Corti APIs from J
 - [Pagination](#pagination)
 - [Advanced](#advanced)
   - [Additional Headers](#additional-headers)
+  - [Analytics](#analytics)
   - [Additional Query String Parameters](#additional-query-string-parameters)
   - [Retries](#retries)
   - [Timeouts](#timeouts)
@@ -688,6 +689,57 @@ const response = await client.interactions.create(..., {
 });
 ```
 
+### Analytics
+
+The SDK sends metadata about itself (`sdk_version`, `sdk_type`) with every request via the `X-Corti-Analytics` header (REST) or the `x-corti-analytics` query parameter (WebSocket). You can extend this payload with your own fields on the client constructor, and overlay extra fields on individual REST calls or WebSocket connections.
+
+> **Reserved keys**: `sdk_version` and `sdk_type` are always set by the SDK and cannot be overridden at any level.
+
+#### Client-level
+
+Pass `analytics` when constructing the client. The payload is sent with every request.
+
+```typescript
+import { CortiClient } from "@corti/sdk";
+
+const client = new CortiClient({
+    ...
+    analytics: { integration: "epic-hyperspace", workflow: "ambient-scribe" },
+});
+
+// Every REST call includes: X-Corti-Analytics: {"sdk_version":"...","sdk_type":"corti-sdk-javascript","integration":"epic-hyperspace","workflow":"ambient-scribe"}
+await client.interactions.list();
+```
+
+#### Per-request (HTTP)
+
+For a single REST call, pass an `x-corti-analytics` header in `requestOptions.headers`. The value is a JSON string. Per-request fields are merged with the client-level context — they extend rather than replace it.
+
+```typescript
+await client.documents.generate({ ... }, {
+    headers: {
+        "x-corti-analytics": JSON.stringify({ document_type: "progress-note" }),
+    },
+});
+// X-Corti-Analytics includes: {"sdk_version":"...","sdk_type":"corti-sdk-javascript","integration":"epic-hyperspace","workflow":"ambient-scribe","document_type":"progress-note"}
+```
+
+#### Per-connection (WebSocket)
+
+Browsers cannot set custom headers on the WebSocket handshake, so pass `x-corti-analytics` in `queryParams`. Per-connection fields are merged with the client-level context.
+
+```typescript
+const socket = await client.stream.connect({
+    id: interactionId,
+    queryParams: {
+        "x-corti-analytics": JSON.stringify({ visit_type: "inpatient" }),
+    },
+});
+// Handshake query includes: x-corti-analytics={"sdk_version":"...","sdk_type":"corti-sdk-javascript","integration":"epic-hyperspace","workflow":"ambient-scribe","visit_type":"inpatient"}
+```
+
+> **Note**: This value is in the query string and may appear in access logs — avoid personally identifiable information.
+
 ### Additional Query String Parameters
 
 If you would like to send additional query string parameters as part of the request, use the `queryParams` request option.

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@corti/sdk",
-        "X-Fern-SDK-Version": "4.2.0",
-        "User-Agent": "@corti/sdk/4.2.0",
+        "X-Fern-SDK-Version": "5.0.0-rc",
+        "User-Agent": "@corti/sdk/5.0.0-rc",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "Tenant-Name": options === null || options === void 0 ? void 0 : options.tenantName,

package/dist/cjs/Client.d.ts

@@ -1,3 +1,4 @@
+import { AgenticClient } from "./api/resources/agentic/client/Client.js";
 import { AgentsClient } from "./api/resources/agents/client/Client.js";
 import { AuthClient } from "./api/resources/auth/client/Client.js";
 import { CodesClient } from "./api/resources/codes/client/Client.js";
@@ -24,24 +25,26 @@ export declare class CortiClient {
     protected _recordings: RecordingsClient | undefined;
     protected _transcripts: TranscriptsClient | undefined;
     protected _facts: FactsClient | undefined;
-    protected _documents: DocumentsClient | undefined;
     protected _templates: TemplatesClient | undefined;
     protected _codes: CodesClient | undefined;
+    protected _documents: DocumentsClient | undefined;
     protected _languages: LanguagesClient | undefined;
     protected _agents: AgentsClient | undefined;
     protected _stream: StreamClient | undefined;
     protected _transcribe: TranscribeClient | undefined;
+    protected _agentic: AgenticClient | undefined;
     constructor(options: CortiClient.Options);
     get auth(): AuthClient;
     get interactions(): InteractionsClient;
     get recordings(): RecordingsClient;
     get transcripts(): TranscriptsClient;
     get facts(): FactsClient;
-    get documents(): DocumentsClient;
     get templates(): TemplatesClient;
     get codes(): CodesClient;
+    get documents(): DocumentsClient;
     get languages(): LanguagesClient;
     get agents(): AgentsClient;
     get stream(): StreamClient;
     get transcribe(): TranscribeClient;
+    get agentic(): AgenticClient;
 }

package/dist/cjs/Client.js

@@ -2,18 +2,19 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CortiClient = void 0;
-const Client_js_1 = require("./api/resources/agents/client/Client.js");
-const Client_js_2 = require("./api/resources/auth/client/Client.js");
-const Client_js_3 = require("./api/resources/codes/client/Client.js");
-const Client_js_4 = require("./api/resources/documents/client/Client.js");
-const Client_js_5 = require("./api/resources/facts/client/Client.js");
-const Client_js_6 = require("./api/resources/interactions/client/Client.js");
-const Client_js_7 = require("./api/resources/languages/client/Client.js");
-const Client_js_8 = require("./api/resources/recordings/client/Client.js");
-const Client_js_9 = require("./api/resources/stream/client/Client.js");
-const Client_js_10 = require("./api/resources/templates/client/Client.js");
-const Client_js_11 = require("./api/resources/transcribe/client/Client.js");
-const Client_js_12 = require("./api/resources/transcripts/client/Client.js");
+const Client_js_1 = require("./api/resources/agentic/client/Client.js");
+const Client_js_2 = require("./api/resources/agents/client/Client.js");
+const Client_js_3 = require("./api/resources/auth/client/Client.js");
+const Client_js_4 = require("./api/resources/codes/client/Client.js");
+const Client_js_5 = require("./api/resources/documents/client/Client.js");
+const Client_js_6 = require("./api/resources/facts/client/Client.js");
+const Client_js_7 = require("./api/resources/interactions/client/Client.js");
+const Client_js_8 = require("./api/resources/languages/client/Client.js");
+const Client_js_9 = require("./api/resources/recordings/client/Client.js");
+const Client_js_10 = require("./api/resources/stream/client/Client.js");
+const Client_js_11 = require("./api/resources/templates/client/Client.js");
+const Client_js_12 = require("./api/resources/transcribe/client/Client.js");
+const Client_js_13 = require("./api/resources/transcripts/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 class CortiClient {
     constructor(options) {
@@ -21,51 +22,55 @@ class CortiClient {
     }
     get auth() {
         var _a;
-        return ((_a = this._auth) !== null && _a !== void 0 ? _a : (this._auth = new Client_js_2.AuthClient(this._options)));
+        return ((_a = this._auth) !== null && _a !== void 0 ? _a : (this._auth = new Client_js_3.AuthClient(this._options)));
     }
     get interactions() {
         var _a;
-        return ((_a = this._interactions) !== null && _a !== void 0 ? _a : (this._interactions = new Client_js_6.InteractionsClient(this._options)));
+        return ((_a = this._interactions) !== null && _a !== void 0 ? _a : (this._interactions = new Client_js_7.InteractionsClient(this._options)));
     }
     get recordings() {
         var _a;
-        return ((_a = this._recordings) !== null && _a !== void 0 ? _a : (this._recordings = new Client_js_8.RecordingsClient(this._options)));
+        return ((_a = this._recordings) !== null && _a !== void 0 ? _a : (this._recordings = new Client_js_9.RecordingsClient(this._options)));
     }
     get transcripts() {
         var _a;
-        return ((_a = this._transcripts) !== null && _a !== void 0 ? _a : (this._transcripts = new Client_js_12.TranscriptsClient(this._options)));
+        return ((_a = this._transcripts) !== null && _a !== void 0 ? _a : (this._transcripts = new Client_js_13.TranscriptsClient(this._options)));
     }
     get facts() {
         var _a;
-        return ((_a = this._facts) !== null && _a !== void 0 ? _a : (this._facts = new Client_js_5.FactsClient(this._options)));
-    }
-    get documents() {
-        var _a;
-        return ((_a = this._documents) !== null && _a !== void 0 ? _a : (this._documents = new Client_js_4.DocumentsClient(this._options)));
+        return ((_a = this._facts) !== null && _a !== void 0 ? _a : (this._facts = new Client_js_6.FactsClient(this._options)));
     }
     get templates() {
         var _a;
-        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new Client_js_10.TemplatesClient(this._options)));
+        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new Client_js_11.TemplatesClient(this._options)));
     }
     get codes() {
         var _a;
-        return ((_a = this._codes) !== null && _a !== void 0 ? _a : (this._codes = new Client_js_3.CodesClient(this._options)));
+        return ((_a = this._codes) !== null && _a !== void 0 ? _a : (this._codes = new Client_js_4.CodesClient(this._options)));
+    }
+    get documents() {
+        var _a;
+        return ((_a = this._documents) !== null && _a !== void 0 ? _a : (this._documents = new Client_js_5.DocumentsClient(this._options)));
     }
     get languages() {
         var _a;
-        return ((_a = this._languages) !== null && _a !== void 0 ? _a : (this._languages = new Client_js_7.LanguagesClient(this._options)));
+        return ((_a = this._languages) !== null && _a !== void 0 ? _a : (this._languages = new Client_js_8.LanguagesClient(this._options)));
     }
     get agents() {
         var _a;
-        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_js_1.AgentsClient(this._options)));
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_js_2.AgentsClient(this._options)));
     }
     get stream() {
         var _a;
-        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new Client_js_9.StreamClient(this._options)));
+        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new Client_js_10.StreamClient(this._options)));
     }
     get transcribe() {
         var _a;
-        return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new Client_js_11.TranscribeClient(this._options)));
+        return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new Client_js_12.TranscribeClient(this._options)));
+    }
+    get agentic() {
+        var _a;
+        return ((_a = this._agentic) !== null && _a !== void 0 ? _a : (this._agentic = new Client_js_1.AgenticClient(this._options)));
     }
 }
 exports.CortiClient = CortiClient;

package/dist/cjs/api/errors/ConflictError.d.ts

@@ -1,6 +1,5 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
-import type * as Corti from "../index.js";
 export declare class ConflictError extends errors.CortiError {
-    constructor(body: Corti.ErrorResponse, rawResponse?: core.RawResponse);
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/cjs/api/errors/NotImplementedError.d.ts

@@ -0,0 +1,6 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as Corti from "../index.js";
+export declare class NotImplementedError extends errors.CortiError {
+    constructor(body: Corti.CommonErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/errors/NotImplementedError.js

@@ -0,0 +1,54 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotImplementedError = void 0;
+const errors = __importStar(require("../../errors/index.js"));
+class NotImplementedError extends errors.CortiError {
+    constructor(body, rawResponse) {
+        super({
+            message: "NotImplementedError",
+            statusCode: 501,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}
+exports.NotImplementedError = NotImplementedError;

package/dist/cjs/api/errors/index.d.ts

@@ -5,5 +5,6 @@ export * from "./ForbiddenError.js";
 export * from "./GatewayTimeoutError.js";
 export * from "./InternalServerError.js";
 export * from "./NotFoundError.js";
+export * from "./NotImplementedError.js";
 export * from "./UnauthorizedError.js";
 export * from "./UnprocessableEntityError.js";

package/dist/cjs/api/errors/index.js

@@ -21,5 +21,6 @@ __exportStar(require("./ForbiddenError.js"), exports);
 __exportStar(require("./GatewayTimeoutError.js"), exports);
 __exportStar(require("./InternalServerError.js"), exports);
 __exportStar(require("./NotFoundError.js"), exports);
+__exportStar(require("./NotImplementedError.js"), exports);
 __exportStar(require("./UnauthorizedError.js"), exports);
 __exportStar(require("./UnprocessableEntityError.js"), exports);

package/dist/cjs/api/resources/agentic/client/Client.d.ts

@@ -0,0 +1,18 @@
+import type { BaseClientOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import { AgentsClient } from "../resources/agents/client/Client.js";
+import { ContextsClient } from "../resources/contexts/client/Client.js";
+import { RegistryClient } from "../resources/registry/client/Client.js";
+export declare namespace AgenticClient {
+    type Options = BaseClientOptions;
+}
+export declare class AgenticClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AgenticClient.Options>;
+    protected _agents: AgentsClient | undefined;
+    protected _contexts: ContextsClient | undefined;
+    protected _registry: RegistryClient | undefined;
+    constructor(options: AgenticClient.Options);
+    get agents(): AgentsClient;
+    get contexts(): ContextsClient;
+    get registry(): RegistryClient;
+}

package/dist/cjs/api/resources/agentic/client/Client.js

@@ -0,0 +1,26 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticClient = void 0;
+const BaseClient_js_1 = require("../../../../BaseClient.js");
+const Client_js_1 = require("../resources/agents/client/Client.js");
+const Client_js_2 = require("../resources/contexts/client/Client.js");
+const Client_js_3 = require("../resources/registry/client/Client.js");
+class AgenticClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    get agents() {
+        var _a;
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_js_1.AgentsClient(this._options)));
+    }
+    get contexts() {
+        var _a;
+        return ((_a = this._contexts) !== null && _a !== void 0 ? _a : (this._contexts = new Client_js_2.ContextsClient(this._options)));
+    }
+    get registry() {
+        var _a;
+        return ((_a = this._registry) !== null && _a !== void 0 ? _a : (this._registry = new Client_js_3.RegistryClient(this._options)));
+    }
+}
+exports.AgenticClient = AgenticClient;

package/dist/cjs/api/resources/agentic/client/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/api/resources/agentic/client/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/agentic/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+export * from "./resources/index.js";

package/dist/cjs/api/resources/agentic/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client/index.js"), exports);
+__exportStar(require("./resources/index.js"), exports);