@corti/sdk 2.2.0-rc.1 → 2.2.0-rc.3

package/dist/esm/api/resources/documents/client/Client.d.mts

@@ -2,6 +2,8 @@ import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClie
 import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
 import * as core from "../../../../core/index.mjs";
 import * as Corti from "../../../index.mjs";
+import { SectionsClient } from "../resources/sections/client/Client.mjs";
+import { TemplatesClient } from "../resources/templates/client/Client.mjs";
 export declare namespace DocumentsClient {
     type Options = BaseClientOptions;
     interface RequestOptions extends BaseRequestOptions {
@@ -9,8 +11,14 @@ export declare namespace DocumentsClient {
 }
 export declare class DocumentsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<DocumentsClient.Options>;
+    protected _templates: TemplatesClient | undefined;
+    protected _sections: SectionsClient | undefined;
     constructor(options: DocumentsClient.Options);
+    get templates(): TemplatesClient;
+    get sections(): SectionsClient;
     /**
+     * @deprecated
+     *
      * List Documents
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
@@ -27,6 +35,8 @@ export declare class DocumentsClient {
     list(id: Corti.Uuid, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<Corti.DocumentsListResponse>;
     private __list;
     /**
+     * @deprecated
+     *
      * This endpoint offers different ways to generate a document. Find guides to document generation [here](/textgen/documents-standard).
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
@@ -53,6 +63,8 @@ export declare class DocumentsClient {
     create(id: Corti.Uuid, request: Corti.DocumentsCreateRequest, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<Corti.DocumentsGetResponse>;
     private __create;
     /**
+     * @deprecated
+     *
      * Get Document.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
@@ -70,6 +82,8 @@ export declare class DocumentsClient {
     get(id: Corti.Uuid, documentId: Corti.Uuid, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<Corti.DocumentsGetResponse>;
     private __get;
     /**
+     * @deprecated
+     *
      * @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 {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -85,6 +99,8 @@ export declare class DocumentsClient {
     delete(id: Corti.Uuid, documentId: Corti.Uuid, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     /**
+     * @deprecated
+     *
      * @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
@@ -100,4 +116,27 @@ export declare class DocumentsClient {
      */
     update(id: Corti.Uuid, documentId: Corti.Uuid, request?: Corti.DocumentsUpdateRequest, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<Corti.DocumentsGetResponse>;
     private __update;
+    /**
+     * 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.GuidedDocumentsGenerateRequest} 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"
+     *         }
+     *     })
+     */
+    generate(request: Corti.GuidedDocumentsGenerateRequest, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<Corti.GuidedDocumentsCreateEphemeralResponse>;
+    private __generate;
 }

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

@@ -15,11 +15,23 @@ 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 { 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 templates() {
+        var _a;
+        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new TemplatesClient(this._options)));
+    }
+    get sections() {
+        var _a;
+        return ((_a = this._sections) !== null && _a !== void 0 ? _a : (this._sections = new SectionsClient(this._options)));
+    }
     /**
+     * @deprecated
+     *
      * List Documents
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
@@ -98,6 +110,8 @@ export class DocumentsClient {
         });
     }
     /**
+     * @deprecated
+     *
      * This endpoint offers different ways to generate a document. Find guides to document generation [here](/textgen/documents-standard).
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
@@ -192,6 +206,8 @@ export class DocumentsClient {
         });
     }
     /**
+     * @deprecated
+     *
      * Get Document.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
@@ -271,6 +287,8 @@ export class DocumentsClient {
         });
     }
     /**
+     * @deprecated
+     *
      * @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 {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -339,6 +357,8 @@ export class DocumentsClient {
         });
     }
     /**
+     * @deprecated
+     *
      * @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
@@ -422,4 +442,89 @@ export class DocumentsClient {
             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.
+     *
+     * @param {Corti.GuidedDocumentsGenerateRequest} 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"
+     *         }
+     *     })
+     */
+    generate(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__generate(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, "documents/"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.GuidedDocumentsGenerateRequest.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.GuidedDocumentsCreateEphemeralResponse.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 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,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/documents/");
+        });
+    }
 }

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

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

package/dist/esm/api/resources/documents/index.mjs

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

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

@@ -0,0 +1,4 @@
+export * from "./sections/client/requests/index.mjs";
+export * as sections from "./sections/index.mjs";
+export * from "./templates/client/requests/index.mjs";
+export * as templates from "./templates/index.mjs";

package/dist/esm/api/resources/documents/resources/index.mjs

@@ -0,0 +1,4 @@
+export * from "./sections/client/requests/index.mjs";
+export * as sections from "./sections/index.mjs";
+export * from "./templates/client/requests/index.mjs";
+export * as templates from "./templates/index.mjs";

package/dist/esm/api/resources/documents/resources/sections/client/Client.d.mts

@@ -0,0 +1,93 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.mjs";
+import * as core from "../../../../../../core/index.mjs";
+import * as Corti from "../../../../../index.mjs";
+import { VersionsClient } from "../resources/versions/client/Client.mjs";
+export declare namespace SectionsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class SectionsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<SectionsClient.Options>;
+    protected _versions: VersionsClient | undefined;
+    constructor(options: SectionsClient.Options);
+    get versions(): VersionsClient;
+    /**
+     * @param {Corti.documents.GuidedSectionsListRequest} request
+     * @param {SectionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.documents.sections.list()
+     */
+    list(request?: Corti.documents.GuidedSectionsListRequest, requestOptions?: SectionsClient.RequestOptions): core.HttpResponsePromise<Corti.GuidedSection[]>;
+    private __list;
+    /**
+     * Creates a new section with an initial version. When `publish` is true (default),
+     * the response includes the published version with full inheritance resolution applied
+     * (section inheritance chain walked to fill missing fields).
+     *
+     * @param {Corti.GuidedSectionsCreateRequest} request
+     * @param {SectionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     *
+     * @example
+     *     await client.documents.sections.create({
+     *         name: "name",
+     *         generation: {
+     *             heading: "heading",
+     *             instructions: {
+     *                 contentPrompt: "contentPrompt"
+     *             },
+     *             outputSchema: {
+     *                 type: "string"
+     *             }
+     *         }
+     *     })
+     */
+    create(request: Corti.GuidedSectionsCreateRequest, requestOptions?: SectionsClient.RequestOptions): core.HttpResponsePromise<Corti.GuidedSection>;
+    private __create;
+    /**
+     * Returns the section with its published version fully resolved (inheritance chain walked
+     * to fill missing fields). To see raw authored values without inheritance, use
+     * GET /documents/sections/{sectionID}/versions/{versionID}.
+     *
+     * @param {string} sectionID
+     * @param {SectionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.documents.sections.get("sectionID")
+     */
+    get(sectionID: string, requestOptions?: SectionsClient.RequestOptions): core.HttpResponsePromise<Corti.GuidedSection>;
+    private __get;
+    /**
+     * Deletes a section and its versions. Returns 409 if other sections inherit from this section.
+     *
+     * @param {string} sectionID
+     * @param {SectionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.NotFoundError}
+     * @throws {@link Corti.ConflictError}
+     *
+     * @example
+     *     await client.documents.sections.delete("sectionID")
+     */
+    delete(sectionID: string, requestOptions?: SectionsClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __delete;
+    /**
+     * @param {string} sectionID
+     * @param {Corti.documents.GuidedSectionsUpdateRequest} request
+     * @param {SectionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.documents.sections.update("sectionID")
+     */
+    update(sectionID: string, request?: Corti.documents.GuidedSectionsUpdateRequest, requestOptions?: SectionsClient.RequestOptions): core.HttpResponsePromise<Corti.GuidedSection>;
+    private __update;
+}