@corti/sdk 4.3.0-beta → 5.0.0

package/dist/esm/api/resources/documents/client/Client.mjs

@@ -15,12 +15,17 @@ import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCode
 import * as errors from "../../../../errors/index.mjs";
 import * as serializers from "../../../../serialization/index.mjs";
 import * as Corti from "../../../index.mjs";
+import { ClassicClient } from "../resources/classic/client/Client.mjs";
 import { SectionsClient } from "../resources/sections/client/Client.mjs";
 import { TemplatesClient } from "../resources/templates/client/Client.mjs";
 export class DocumentsClient {
     constructor(options) {
         this._options = normalizeClientOptionsWithAuth(options);
     }
+    get classic() {
+        var _a;
+        return ((_a = this._classic) !== null && _a !== void 0 ? _a : (this._classic = new ClassicClient(this._options)));
+    }
     get templates() {
         var _a;
         return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new TemplatesClient(this._options)));
@@ -30,34 +35,38 @@ export class DocumentsClient {
         return ((_a = this._sections) !== null && _a !== void 0 ? _a : (this._sections = new SectionsClient(this._options)));
     }
     /**
-     * @deprecated
+     * Guided Documents list (`GET /documents/`). For classic interaction-scoped documents, use `client.documents.classic.list`.
      *
-     * List Documents
+     * Returns a list of previously generated documents.
+     * Use query parameters to filter by template, interaction, or label.
      *
-     * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
+     * @param {Corti.GuidedDocumentsListRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.BadRequestError}
-     * @throws {@link Corti.ForbiddenError}
-     * @throws {@link Corti.InternalServerError}
-     * @throws {@link Corti.GatewayTimeoutError}
      *
      * @example
-     *     await client.documents.list("f47ac10b-58cc-4372-a567-0e02b2c3d479")
+     *     await client.documents.list()
      */
-    list(id, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__list(id, requestOptions));
+    list(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
     }
-    __list(id, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __list() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { templateId, interactionId, label } = request;
+            const _queryParams = {
+                templateId,
+                interactionId,
+                label,
+            };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "Tenant-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.tenantName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.tenantName }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, `interactions/${core.url.encodePathParam(serializers.Uuid.jsonOrThrow(id, { omitUndefined: true }))}/documents/`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, "documents/"),
                 method: "GET",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -66,7 +75,7 @@ export class DocumentsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.DocumentsListResponse.parseOrThrow(_response.body, {
+                    data: serializers.documents.list.Response.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -80,24 +89,6 @@ export class DocumentsClient {
                 switch (_response.error.statusCode) {
                     case 400:
                         throw new Corti.BadRequestError(_response.error.body, _response.rawResponse);
-                    case 403:
-                        throw new Corti.ForbiddenError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new Corti.InternalServerError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
-                    case 504:
-                        throw new Corti.GatewayTimeoutError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
                     default:
                         throw new errors.CortiError({
                             statusCode: _response.error.statusCode,
@@ -106,51 +97,46 @@ export class DocumentsClient {
                         });
                 }
             }
-            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/interactions/{id}/documents/");
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/documents/");
         });
     }
     /**
-     * @deprecated
-     *
-     * This endpoint offers different ways to generate a document. Find guides to document generation [here](/textgen/documents-standard).
+     * Generates a structured document using one of three template-supply paths: a stored template reference (optionally with runtime overrides), an ad-hoc assembly of stored sections, or a fully inline dynamic template. Exactly one of `templateRef`, `assemblyTemplate`, or `dynamicTemplate` must be provided.
+     * Context can combine different types or reference an interactionId to automatically fetch existing context to pass to the LLM. Note that discarded facts are not passed to the LLM.
+     * With the exception of the plain `templateRef` path (no overrides), every call creates a new auto-generated template aggregate that snapshots the resolved prompts as a drift-proof receipt, persisted for 30 days.
      *
-     * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
-     * @param {Corti.DocumentsCreateRequest} request
+     * @param {Corti.GuidedDocumentsGenerateRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.BadRequestError}
-     * @throws {@link Corti.ForbiddenError}
+     * @throws {@link Corti.NotFoundError}
+     * @throws {@link Corti.UnprocessableEntityError}
      * @throws {@link Corti.InternalServerError}
-     * @throws {@link Corti.GatewayTimeoutError}
      *
      * @example
-     *     await client.documents.create("f47ac10b-58cc-4372-a567-0e02b2c3d479", {
-     *         context: [{
-     *                 type: "facts",
-     *                 data: [{
-     *                         text: "text"
-     *                     }]
-     *             }],
-     *         templateKey: "templateKey",
-     *         outputLanguage: "outputLanguage"
+     *     await client.documents.generate({
+     *         outputLanguage: "outputLanguage",
+     *         templateRef: {
+     *             templateId: "templateId"
+     *         }
      *     })
      */
-    create(id, request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__create(id, request, requestOptions));
+    generate(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__generate(request, requestOptions));
     }
-    __create(id, request, requestOptions) {
+    __generate(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "Tenant-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.tenantName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.tenantName }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, `interactions/${core.url.encodePathParam(serializers.Uuid.jsonOrThrow(id, { omitUndefined: true }))}/documents/`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, "documents/"),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: serializers.DocumentsCreateRequest.jsonOrThrow(request, {
+                body: serializers.GuidedDocumentsGenerateRequest.jsonOrThrow(request, {
                     unrecognizedObjectKeys: "strip",
                     omitUndefined: true,
                 }),
@@ -162,7 +148,7 @@ export class DocumentsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.DocumentsGetResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedDocumentsCreateEphemeralResponse.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -176,8 +162,10 @@ export class DocumentsClient {
                 switch (_response.error.statusCode) {
                     case 400:
                         throw new Corti.BadRequestError(_response.error.body, _response.rawResponse);
-                    case 403:
-                        throw new Corti.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Corti.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Corti.UnprocessableEntityError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Corti.InternalServerError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -186,14 +174,6 @@ export class DocumentsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
-                    case 504:
-                        throw new Corti.GatewayTimeoutError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
                     default:
                         throw new errors.CortiError({
                             statusCode: _response.error.statusCode,
@@ -202,36 +182,33 @@ export class DocumentsClient {
                         });
                 }
             }
-            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/interactions/{id}/documents/");
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/documents/");
         });
     }
     /**
-     * @deprecated
+     * Guided Documents get (`GET /documents/{documentID}`). For classic interaction-scoped documents, use `client.documents.classic.get`.
      *
-     * Get Document.
+     * Returns a previously generated document by ID, including its rendered string output
+     * and structured object.
      *
-     * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
-     * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
+     * @param {string} documentID
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
-     * @throws {@link Corti.BadRequestError}
-     * @throws {@link Corti.ForbiddenError}
-     * @throws {@link Corti.InternalServerError}
-     * @throws {@link Corti.GatewayTimeoutError}
+     * @throws {@link Corti.NotFoundError}
      *
      * @example
-     *     await client.documents.get("f47ac10b-58cc-4372-a567-0e02b2c3d479", "f47ac10b-58cc-4372-a567-0e02b2c3d479")
+     *     await client.documents.get("documentID")
      */
-    get(id, documentId, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__get(id, documentId, requestOptions));
+    get(documentID, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__get(documentID, requestOptions));
     }
-    __get(id, documentId, requestOptions) {
+    __get(documentID, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "Tenant-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.tenantName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.tenantName }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, `interactions/${core.url.encodePathParam(serializers.Uuid.jsonOrThrow(id, { omitUndefined: true }))}/documents/${core.url.encodePathParam(serializers.Uuid.jsonOrThrow(documentId, { omitUndefined: true }))}`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, `documents/${core.url.encodePathParam(documentID)}`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -243,7 +220,7 @@ export class DocumentsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.DocumentsGetResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedDocument.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -255,26 +232,8 @@ export class DocumentsClient {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
-                    case 400:
-                        throw new Corti.BadRequestError(_response.error.body, _response.rawResponse);
-                    case 403:
-                        throw new Corti.ForbiddenError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new Corti.InternalServerError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
-                    case 504:
-                        throw new Corti.GatewayTimeoutError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
+                    case 404:
+                        throw new Corti.NotFoundError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.CortiError({
                             statusCode: _response.error.statusCode,
@@ -283,34 +242,32 @@ export class DocumentsClient {
                         });
                 }
             }
-            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/interactions/{id}/documents/{documentId}");
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/documents/{documentID}");
         });
     }
     /**
-     * @deprecated
+     * Guided Documents delete (`DELETE /documents/{documentID}`). For classic interaction-scoped documents, use `client.documents.classic.delete`.
+     *
+     * Deletes the document. This cannot be undone.
      *
-     * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
-     * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
+     * @param {string} documentID
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
-     * @throws {@link Corti.ForbiddenError}
      * @throws {@link Corti.NotFoundError}
-     * @throws {@link Corti.InternalServerError}
-     * @throws {@link Corti.GatewayTimeoutError}
      *
      * @example
-     *     await client.documents.delete("f47ac10b-58cc-4372-a567-0e02b2c3d479", "f47ac10b-58cc-4372-a567-0e02b2c3d479")
+     *     await client.documents.delete("documentID")
      */
-    delete(id, documentId, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__delete(id, documentId, requestOptions));
+    delete(documentID, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(documentID, requestOptions));
     }
-    __delete(id, documentId, requestOptions) {
+    __delete(documentID, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "Tenant-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.tenantName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.tenantName }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, `interactions/${core.url.encodePathParam(serializers.Uuid.jsonOrThrow(id, { omitUndefined: true }))}/documents/${core.url.encodePathParam(serializers.Uuid.jsonOrThrow(documentId, { omitUndefined: true }))}`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, `documents/${core.url.encodePathParam(documentID)}`),
                 method: "DELETE",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -325,26 +282,8 @@ export class DocumentsClient {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
-                    case 403:
-                        throw new Corti.ForbiddenError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Corti.NotFoundError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new Corti.InternalServerError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
-                    case 504:
-                        throw new Corti.GatewayTimeoutError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
                     default:
                         throw new errors.CortiError({
                             statusCode: _response.error.statusCode,
@@ -353,132 +292,41 @@ export class DocumentsClient {
                         });
                 }
             }
-            return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/interactions/{id}/documents/{documentId}");
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/documents/{documentID}");
         });
     }
     /**
-     * @deprecated
+     * Guided Documents update (`PATCH /documents/{documentID}`). For classic interaction-scoped documents, use `client.documents.classic.update`.
      *
-     * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
-     * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
-     * @param {Corti.DocumentsUpdateRequest} request
-     * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link Corti.BadRequestError}
-     * @throws {@link Corti.ForbiddenError}
-     * @throws {@link Corti.InternalServerError}
-     * @throws {@link Corti.GatewayTimeoutError}
-     *
-     * @example
-     *     await client.documents.update("f47ac10b-58cc-4372-a567-0e02b2c3d479", "f47ac10b-58cc-4372-a567-0e02b2c3d479")
-     */
-    update(id, documentId, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__update(id, documentId, request, requestOptions));
-    }
-    __update(id_1, documentId_1) {
-        return __awaiter(this, arguments, void 0, function* (id, documentId, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "Tenant-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.tenantName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.tenantName }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield core.fetcher({
-                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, `interactions/${core.url.encodePathParam(serializers.Uuid.jsonOrThrow(id, { omitUndefined: true }))}/documents/${core.url.encodePathParam(serializers.Uuid.jsonOrThrow(documentId, { omitUndefined: true }))}`),
-                method: "PATCH",
-                headers: _headers,
-                contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: serializers.DocumentsUpdateRequest.jsonOrThrow(request, {
-                    unrecognizedObjectKeys: "strip",
-                    omitUndefined: true,
-                }),
-                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
-                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            if (_response.ok) {
-                return {
-                    data: serializers.DocumentsGetResponse.parseOrThrow(_response.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }),
-                    rawResponse: _response.rawResponse,
-                };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 400:
-                        throw new Corti.BadRequestError(_response.error.body, _response.rawResponse);
-                    case 403:
-                        throw new Corti.ForbiddenError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new Corti.InternalServerError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
-                    case 504:
-                        throw new Corti.GatewayTimeoutError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
-                    default:
-                        throw new errors.CortiError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
-            }
-            return handleNonStatusCodeError(_response.error, _response.rawResponse, "PATCH", "/interactions/{id}/documents/{documentId}");
-        });
-    }
-    /**
-     * Generates a structured document using one of three template-supply paths: a stored template reference (optionally with runtime overrides), an ad-hoc assembly of stored sections, or a fully inline dynamic template. Exactly one of `templateRef`, `assemblyTemplate`, or `dynamicTemplate` must be provided.
-     * Context can combine different types or reference an interactionId to automatically fetch existing context to pass to the LLM. Note that discarded facts are not passed to the LLM.
-     * With the exception of the plain `templateRef` path (no overrides), every call creates a new auto-generated template aggregate that snapshots the resolved prompts as a drift-proof receipt, persisted for 30 days.
+     * Updates the document's `name`, `labels`, or rendered output (`stringDocument` / `structuredDocument`).
+     * Use this to persist edits made to a previously generated document.
      *
-     * @param {Corti.GuidedDocumentsGenerateRequest} request
+     * @param {string} documentID
+     * @param {Corti.GuidedDocumentsUpdateRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.BadRequestError}
      * @throws {@link Corti.NotFoundError}
-     * @throws {@link Corti.UnprocessableEntityError}
-     * @throws {@link Corti.InternalServerError}
      *
      * @example
-     *     await client.documents.generate({
-     *         outputLanguage: "outputLanguage",
-     *         templateRef: {
-     *             templateId: "templateId"
-     *         }
-     *     })
+     *     await client.documents.update("documentID")
      */
-    generate(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__generate(request, requestOptions));
+    update(documentID, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(documentID, request, requestOptions));
     }
-    __generate(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __update(documentID_1) {
+        return __awaiter(this, arguments, void 0, function* (documentID, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "Tenant-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.tenantName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.tenantName }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, "documents/"),
-                method: "POST",
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment)).base, `documents/${core.url.encodePathParam(documentID)}`),
+                method: "PATCH",
                 headers: _headers,
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: serializers.GuidedDocumentsGenerateRequest.jsonOrThrow(request, {
+                body: serializers.GuidedDocumentsUpdateRequest.jsonOrThrow(request, {
                     unrecognizedObjectKeys: "strip",
                     omitUndefined: true,
                 }),
@@ -490,7 +338,7 @@ export class DocumentsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.GuidedDocumentsCreateEphemeralResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedDocument.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -506,16 +354,6 @@ export class DocumentsClient {
                         throw new Corti.BadRequestError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Corti.NotFoundError(_response.error.body, _response.rawResponse);
-                    case 422:
-                        throw new Corti.UnprocessableEntityError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new Corti.InternalServerError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
                     default:
                         throw new errors.CortiError({
                             statusCode: _response.error.statusCode,
@@ -524,7 +362,7 @@ export class DocumentsClient {
                         });
                 }
             }
-            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/documents/");
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "PATCH", "/documents/{documentID}");
         });
     }
 }

package/dist/esm/api/resources/documents/client/requests/GuidedDocumentsListRequest.d.mts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {}
+ */
+export interface GuidedDocumentsListRequest {
+    /** Filter documents by template UUID. */
+    templateId?: string;
+    /** Filter documents by interaction UUID. */
+    interactionId?: string;
+    /** Filter documents by label in `key:value` format. Repeatable; matches documents that have any of the given labels. */
+    label?: string | string[];
+}

package/dist/esm/api/resources/documents/client/requests/GuidedDocumentsUpdateRequest.d.mts

@@ -0,0 +1,12 @@
+import type * as Corti from "../../../../index.mjs";
+/**
+ * @example
+ *     {}
+ */
+export interface GuidedDocumentsUpdateRequest {
+    name?: string;
+    stringDocument?: Record<string, string>;
+    structuredDocument?: Record<string, unknown>;
+    /** Replace the document's labels. Omit to leave labels unchanged; pass `[]` to clear all labels. */
+    labels?: Corti.GuidedLabel[];
+}

package/dist/esm/api/resources/documents/client/requests/index.d.mts

@@ -1 +1,2 @@
-export type { DocumentsUpdateRequest } from "./DocumentsUpdateRequest.mjs";
+export type { GuidedDocumentsListRequest } from "./GuidedDocumentsListRequest.mjs";
+export type { GuidedDocumentsUpdateRequest } from "./GuidedDocumentsUpdateRequest.mjs";