@corti/sdk 4.2.0 → 5.0.0-rc

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

@@ -51,49 +51,58 @@ const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatu
 const errors = __importStar(require("../../../../errors/index.js"));
 const serializers = __importStar(require("../../../../serialization/index.js"));
 const Corti = __importStar(require("../../../index.js"));
-const Client_js_1 = require("../resources/sections/client/Client.js");
-const Client_js_2 = require("../resources/templates/client/Client.js");
+const Client_js_1 = require("../resources/classic/client/Client.js");
+const Client_js_2 = require("../resources/sections/client/Client.js");
+const Client_js_3 = require("../resources/templates/client/Client.js");
 class DocumentsClient {
     constructor(options) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
+    get classic() {
+        var _a;
+        return ((_a = this._classic) !== null && _a !== void 0 ? _a : (this._classic = new Client_js_1.ClassicClient(this._options)));
+    }
     get templates() {
         var _a;
-        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new Client_js_2.TemplatesClient(this._options)));
+        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new Client_js_3.TemplatesClient(this._options)));
     }
     get sections() {
         var _a;
-        return ((_a = this._sections) !== null && _a !== void 0 ? _a : (this._sections = new Client_js_1.SectionsClient(this._options)));
+        return ((_a = this._sections) !== null && _a !== void 0 ? _a : (this._sections = new Client_js_2.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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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,
@@ -102,7 +111,7 @@ 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,
@@ -116,24 +125,6 @@ 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,
@@ -142,51 +133,46 @@ class DocumentsClient {
                         });
                 }
             }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/interactions/{id}/documents/");
+            return (0, handleNonStatusCodeError_js_1.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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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,
                 }),
@@ -198,7 +184,7 @@ class DocumentsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.DocumentsGetResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedDocumentsCreateEphemeralResponse.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -212,8 +198,10 @@ 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",
@@ -222,14 +210,6 @@ 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,
@@ -238,36 +218,33 @@ class DocumentsClient {
                         });
                 }
             }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/interactions/{id}/documents/");
+            return (0, handleNonStatusCodeError_js_1.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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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,
@@ -279,7 +256,7 @@ class DocumentsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.DocumentsGetResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedDocument.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -291,26 +268,8 @@ 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,
@@ -319,34 +278,32 @@ class DocumentsClient {
                         });
                 }
             }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/interactions/{id}/documents/{documentId}");
+            return (0, handleNonStatusCodeError_js_1.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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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,
@@ -361,26 +318,8 @@ 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,
@@ -389,132 +328,41 @@ class DocumentsClient {
                         });
                 }
             }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/interactions/{id}/documents/{documentId}");
+            return (0, handleNonStatusCodeError_js_1.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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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 (0, handleNonStatusCodeError_js_1.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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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,
                 }),
@@ -526,7 +374,7 @@ class DocumentsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.GuidedDocumentsCreateEphemeralResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedDocument.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -542,16 +390,6 @@ 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,
@@ -560,7 +398,7 @@ class DocumentsClient {
                         });
                 }
             }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/documents/");
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/documents/{documentID}");
         });
     }
 }

package/dist/cjs/api/resources/documents/client/requests/GuidedDocumentsListRequest.d.ts

@@ -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/cjs/api/resources/documents/client/requests/GuidedDocumentsListRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/documents/client/requests/GuidedDocumentsUpdateRequest.d.ts

@@ -0,0 +1,12 @@
+import type * as Corti from "../../../../index.js";
+/**
+ * @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/cjs/api/resources/documents/client/requests/GuidedDocumentsUpdateRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/documents/client/requests/index.d.ts

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