@corti/sdk 2.2.0-rc.2 → 3.0.0-template-policies

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

@@ -114,7 +114,7 @@ class VersionsClient {
      * Creates a new template version. Returns raw authored values without inheritance resolution or section expansion.
      *
      * @param {string} templateID
-     * @param {Corti.documents.templates.CreateTemplateVersionRequest} request
+     * @param {Corti.documents.templates.GuidedTemplatesCreateVersionRequest} request
      * @param {VersionsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.BadRequestError}
@@ -140,7 +140,7 @@ class VersionsClient {
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: serializers.documents.templates.CreateTemplateVersionRequest.jsonOrThrow(request, {
+                body: serializers.documents.templates.GuidedTemplatesCreateVersionRequest.jsonOrThrow(request, {
                     unrecognizedObjectKeys: "strip",
                     omitUndefined: true,
                 }),
@@ -152,7 +152,7 @@ class VersionsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.ShallowTemplateVersionResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedShallowTemplateVersionResponse.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -210,7 +210,7 @@ class VersionsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.ShallowTemplateVersionResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedShallowTemplateVersionResponse.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -317,7 +317,7 @@ class VersionsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.StatusResponse.parseOrThrow(_response.body, {
+                    data: serializers.CommonStatusResponse.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,

package/dist/cjs/api/resources/documents/resources/templates/resources/versions/client/requests/GuidedTemplatesCreateVersionRequest.d.ts

@@ -0,0 +1,10 @@
+import type * as Corti from "../../../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         generation: {}
+ *     }
+ */
+export interface GuidedTemplatesCreateVersionRequest {
+    generation: Corti.GuidedTemplatesVersionGeneration;
+}

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

@@ -1 +1 @@
-export type { CreateTemplateVersionRequest } from "./CreateTemplateVersionRequest.js";
+export type { GuidedTemplatesCreateVersionRequest } from "./GuidedTemplatesCreateVersionRequest.js";

package/dist/cjs/api/resources/documents/resources/templates/resources/versions/index.d.ts

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

package/dist/cjs/api/resources/documents/resources/templates/resources/versions/index.js

@@ -15,4 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client/index.js"), exports);
-__exportStar(require("./types/index.js"), exports);

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

@@ -13,7 +13,7 @@ export declare class TemplatesClient {
     /**
      * Retrieves a list of template sections with optional filters for organization and language.
      *
-     * @param {Corti.SectionListTemplatesRequest} request
+     * @param {Corti.TemplatesSectionListRequest} request
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.UnauthorizedError}
@@ -22,12 +22,12 @@ export declare class TemplatesClient {
      * @example
      *     await client.templates.sectionList()
      */
-    sectionList(request?: Corti.SectionListTemplatesRequest, requestOptions?: TemplatesClient.RequestOptions): core.HttpResponsePromise<Corti.TemplatesSectionListResponse>;
+    sectionList(request?: Corti.TemplatesSectionListRequest, requestOptions?: TemplatesClient.RequestOptions): core.HttpResponsePromise<Corti.TemplatesSectionListResponse>;
     private __sectionList;
     /**
      * Retrieves a list of templates with optional filters for organization, language, and status.
      *
-     * @param {Corti.ListTemplatesRequest} request
+     * @param {Corti.TemplatesListRequest} request
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.UnauthorizedError}
@@ -36,7 +36,7 @@ export declare class TemplatesClient {
      * @example
      *     await client.templates.list()
      */
-    list(request?: Corti.ListTemplatesRequest, requestOptions?: TemplatesClient.RequestOptions): core.HttpResponsePromise<Corti.TemplatesListResponse>;
+    list(request?: Corti.TemplatesListRequest, requestOptions?: TemplatesClient.RequestOptions): core.HttpResponsePromise<Corti.TemplatesListResponse>;
     private __list;
     /**
      * Retrieves template by key.

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

@@ -58,7 +58,7 @@ class TemplatesClient {
     /**
      * Retrieves a list of template sections with optional filters for organization and language.
      *
-     * @param {Corti.SectionListTemplatesRequest} request
+     * @param {Corti.TemplatesSectionListRequest} request
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.UnauthorizedError}
@@ -129,7 +129,7 @@ class TemplatesClient {
     /**
      * Retrieves a list of templates with optional filters for organization, language, and status.
      *
-     * @param {Corti.ListTemplatesRequest} request
+     * @param {Corti.TemplatesListRequest} request
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.UnauthorizedError}

package/dist/cjs/api/resources/templates/client/requests/TemplatesListRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {}
+ */
+export interface TemplatesListRequest {
+    /** Filter templates by organization. */
+    org?: string | string[];
+    /** Filter templates by language. */
+    lang?: string | string[];
+    /** Filter templates by their status. */
+    status?: string | string[];
+}

package/dist/cjs/api/resources/templates/client/requests/TemplatesSectionListRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {}
+ */
+export interface TemplatesSectionListRequest {
+    /** Filter template sections by organization. */
+    org?: string | string[];
+    /** Filter template sections by language. */
+    lang?: string | string[];
+}

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

@@ -1,2 +1,2 @@
-export type { ListTemplatesRequest } from "./ListTemplatesRequest.js";
-export type { SectionListTemplatesRequest } from "./SectionListTemplatesRequest.js";
+export type { TemplatesListRequest } from "./TemplatesListRequest.js";
+export type { TemplatesSectionListRequest } from "./TemplatesSectionListRequest.js";

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

@@ -29,7 +29,7 @@ export declare class TranscriptsClient {
     list(id: Corti.Uuid, request?: Corti.TranscriptsListRequest, requestOptions?: TranscriptsClient.RequestOptions): core.HttpResponsePromise<Corti.TranscriptsListResponse>;
     private __list;
     /**
-     * Create a transcript from an audio file uploaded to the interaction via `/recordings` endpoint.<br/><Note>Each interaction may have more than one audio file and transcript associated with it. Audio files up to 60 min in total duration, or 150 MB in total size, may be used.<br/><br/>Requests will process synchronously for 25 seconds before timeout, upon which processing will continue asynchronously. In the latter scenario, a partial or empty transcript with `status=processing` will be returned with a location header that can be used to retrieve the completed transcript.<br/><br/>The client can poll the `/transcripts` endpoint (`GET /interactions/{id}/transcripts/{transcriptId}/status`) for transcript status monitoring:<br/>- `200 OK` with status `processing`, `completed`, or `failed`<br/>- `404 Not Found` if the `interactionId` or `transcriptId` are invalid<br/><br/>The completed transcript can be retrieved via the Get Transcript request (`GET /interactions/{id}/transcripts/{transcriptId}/`).</Note>
+     * Create a transcript from an audio file uploaded to the interaction via `/recordings` endpoint.<br/><Note>Each interaction may have more than one audio file and transcript associated with it. Audio files up to 60 min in total duration, or 150 MB in total size, may be used.<br/><br/>By default, requests will process synchronously for 25 seconds before timeout, upon which processing will continue asynchronously. Set the `async` parameter to true to receive the location header immediately and process the request asynchronously. Read more [here](https://docs.corti.ai/stt/transcripts).</Note>
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.TranscriptsCreateRequest} request

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

@@ -142,7 +142,7 @@ class TranscriptsClient {
         });
     }
     /**
-     * Create a transcript from an audio file uploaded to the interaction via `/recordings` endpoint.<br/><Note>Each interaction may have more than one audio file and transcript associated with it. Audio files up to 60 min in total duration, or 150 MB in total size, may be used.<br/><br/>Requests will process synchronously for 25 seconds before timeout, upon which processing will continue asynchronously. In the latter scenario, a partial or empty transcript with `status=processing` will be returned with a location header that can be used to retrieve the completed transcript.<br/><br/>The client can poll the `/transcripts` endpoint (`GET /interactions/{id}/transcripts/{transcriptId}/status`) for transcript status monitoring:<br/>- `200 OK` with status `processing`, `completed`, or `failed`<br/>- `404 Not Found` if the `interactionId` or `transcriptId` are invalid<br/><br/>The completed transcript can be retrieved via the Get Transcript request (`GET /interactions/{id}/transcripts/{transcriptId}/`).</Note>
+     * Create a transcript from an audio file uploaded to the interaction via `/recordings` endpoint.<br/><Note>Each interaction may have more than one audio file and transcript associated with it. Audio files up to 60 min in total duration, or 150 MB in total size, may be used.<br/><br/>By default, requests will process synchronously for 25 seconds before timeout, upon which processing will continue asynchronously. Set the `async` parameter to true to receive the location header immediately and process the request asynchronously. Read more [here](https://docs.corti.ai/stt/transcripts).</Note>
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.TranscriptsCreateRequest} request

package/dist/cjs/api/resources/transcripts/client/requests/TranscriptsCreateRequest.d.ts

@@ -11,7 +11,7 @@ export interface TranscriptsCreateRequest {
     recordingId: Corti.Uuid;
     /** The primary spoken language of the recording. Check https://docs.corti.ai/stt/languages for more. */
     primaryLanguage: string;
-    /** Indicates whether spoken dictation commands should be converted to punctuation (e.g., 'comma' → ','). */
+    /** If true, spoken punctuation will be converted to symbols (e.g., 'comma' → ','). */
     isDictation?: boolean;
     /** If true, each audio channel is transcribed separately. */
     isMultichannel?: boolean;
@@ -19,4 +19,6 @@ export interface TranscriptsCreateRequest {
     diarize?: boolean;
     /** An array of participants, each specifying a role and an assigned audio channel in the recording. Leave empty when shouldDiarize: true */
     participants?: Corti.TranscriptsParticipant[];
+    /** If true, the request will return immediately with a 202 status and the transcript will be processed asynchronously. Poll [Get Transcript Status](/api-reference/transcripts/get-transcript-status) to check transcript processing status - `processing`, `completed`, `failed`. */
+    async?: boolean;
 }

package/dist/cjs/api/types/CommonDocumentationEvidence.d.ts

@@ -0,0 +1,6 @@
+import type * as Corti from "../index.js";
+export interface CommonDocumentationEvidence {
+    evidenceId?: Corti.Uuid;
+    type?: string;
+    quote?: string;
+}

package/dist/cjs/api/types/CommonFactsContext.d.ts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.js";
+/**
+ * A single fact provided as input context to the model.
+ */
+export interface CommonFactsContext {
+    type: "facts";
+    fact: Corti.GuidedDocumentFactMinimal;
+}

package/dist/cjs/api/types/CommonStatusResponse.d.ts

@@ -0,0 +1,5 @@
+import type * as Corti from "../index.js";
+export interface CommonStatusResponse {
+    status: string;
+    evidence?: Corti.CommonDocumentationEvidence;
+}

package/dist/cjs/api/types/CommonTextContext.d.ts

@@ -1,7 +1,5 @@
-import type * as Corti from "../index.js";
 export interface CommonTextContext {
-    /** The type of context, always "text" in this context. */
-    type: Corti.CommonTextContextType;
+    type: "text";
     /** A text string to be used as input to the model. */
     text: string;
 }

package/dist/cjs/api/types/CommonTranscriptContext.d.ts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.js";
+/**
+ * A transcript provided as input context to the model.
+ */
+export interface CommonTranscriptContext {
+    type: "transcript";
+    transcript: Corti.GuidedDocumentTranscriptMinimal;
+}

package/dist/cjs/api/types/GuidedArrayNode.d.ts

@@ -0,0 +1,14 @@
+import type * as Corti from "../index.js";
+export interface GuidedArrayNode {
+    type: "array";
+    /** Guide the LLM in what to output for this node. Supplements the section-level instructions. */
+    description?: string;
+    /** Must be another output schema node (string, number, boolean, array, or object). */
+    items: Corti.GuidedOutputSchema;
+    /** Format string used to render each array item in the generated output. Use the `{item}` placeholder for the item value. */
+    itemFormat?: string;
+    /** Minimum number of array items to generate. */
+    minItems?: number | null;
+    /** Maximum number of array items to generate. */
+    maxItems?: number | null;
+}

package/dist/cjs/api/types/GuidedAssemblyRequest.d.ts

@@ -6,6 +6,6 @@ export interface GuidedAssemblyRequest {
     /** Name for the auto-generated template aggregate that will be persisted. */
     name: string;
     /** Template-level instructions for the assembled template. */
-    instructions?: Corti.TemplateInstructions;
+    instructions?: Corti.GuidedTemplateInstructions;
     sectionRefs: Corti.GuidedAssemblySectionRef[];
 }

package/dist/cjs/api/types/GuidedAssemblySectionRef.d.ts

@@ -6,5 +6,5 @@ export interface GuidedAssemblySectionRef {
     sectionId: string;
     /** Optional explicit section version. Defaults to the section's published version when omitted. */
     sectionVersionId?: string | null;
-    overrides?: Corti.SectionOverrides;
+    overrides?: Corti.GuidedSectionOverrides;
 }

package/dist/cjs/api/types/GuidedBoolNode.d.ts

@@ -0,0 +1,7 @@
+export interface GuidedBoolNode {
+    type: "boolean";
+    /** Guide the LLM in what to output for this node. Supplements the section-level instructions. */
+    description?: string;
+    /** If nothing is outputted, this default is used. */
+    default?: boolean | null;
+}

package/dist/cjs/api/types/GuidedDocumentContext.d.ts

@@ -1,2 +1,2 @@
 import type * as Corti from "../index.js";
-export type GuidedDocumentContext = Corti.ContextText | Corti.ContextTranscript | Corti.ContextFacts;
+export type GuidedDocumentContext = Corti.CommonTextContext | Corti.CommonTranscriptContext | Corti.CommonFactsContext;

package/dist/cjs/api/types/GuidedDocumentsCreateEphemeralResponse.d.ts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.js";
+/**
+ * Response when a document is generated but not saved (retention policy `none`).
+ */
+export interface GuidedDocumentsCreateEphemeralResponse {
+    document: Corti.GuidedEphemeralDocument;
+    usageInfo: Corti.CommonUsageInfo;
+}

package/dist/cjs/api/types/GuidedDocumentsGenerateBase.d.ts

@@ -0,0 +1,14 @@
+import type * as Corti from "../index.js";
+/**
+ * Fields shared across all guided-document request variants. `outputLanguage` is always required. Exactly one of `context` (possible to combine different context types) or `interactionId` (API auto-fetches existing facts, transcripts) must be supplied as input for the model.
+ */
+export interface GuidedDocumentsGenerateBase {
+    /** The language in which the document will be generated as a BCP 47 tag. */
+    outputLanguage: string;
+    /** Ordered list of context items the model reasons over. Each item is one of text, a transcript (with optional metadata and segments), or a single fact. Items are interleaved by timestamps where present on transcript segments; otherwise array order is preserved. */
+    context?: Corti.GuidedDocumentContext[];
+    /** When supplied, all facts and transcripts already attached to the referenced interaction are passed implicitly as input context. Facts with `isDiscarded: true` are not passed on. */
+    interactionId?: string;
+    /** Key/value labels attached to the document. Used for filtering in the LIST /documents endpoint. */
+    labels?: Corti.GuidedLabel[];
+}

package/dist/cjs/api/types/GuidedDocumentsGenerateByAssembly.d.ts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.js";
+/**
+ * Generate a document by assembling a template from existing stored sections. The resulting template aggregate is auto-saved and can be referenced in future calls. At least one of `context` or `interactionId` must be supplied as input context for the model.
+ */
+export interface GuidedDocumentsGenerateByAssembly extends Corti.GuidedDocumentsGenerateBase {
+    /** Assemble a template from existing stored sections. */
+    assemblyTemplate: Corti.GuidedAssemblyRequest;
+}

package/dist/cjs/api/types/GuidedDocumentsGenerateByDynamic.d.ts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.js";
+/**
+ * Generate a document from a fully inline template definition supplied in the request body. Sections and the wrapping template are created and immediately published as auto-generated resources. At least one of `context` or `interactionId` must be supplied as input context for the model.
+ */
+export interface GuidedDocumentsGenerateByDynamic extends Corti.GuidedDocumentsGenerateBase {
+    /** Fully inline template defined in the request body. */
+    dynamicTemplate: Corti.GuidedDynamicRequest;
+}

package/dist/cjs/api/types/GuidedDocumentsGenerateByTemplateRef.d.ts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.js";
+/**
+ * Generate a document using a stored template. Optionally supply runtime overrides to patch instructions or sections without mutating the base template. At least one of `context` or `interactionId` must be supplied as input context for the model.
+ */
+export interface GuidedDocumentsGenerateByTemplateRef extends Corti.GuidedDocumentsGenerateBase {
+    /** Reference an existing stored template, optionally with overrides. */
+    templateRef: Corti.GuidedTemplateRef;
+}

package/dist/cjs/api/types/GuidedDocumentsGenerateRequest.d.ts

@@ -0,0 +1,2 @@
+import type * as Corti from "../index.js";
+export type GuidedDocumentsGenerateRequest = Corti.GuidedDocumentsGenerateByTemplateRef | Corti.GuidedDocumentsGenerateByAssembly | Corti.GuidedDocumentsGenerateByDynamic;

package/dist/cjs/api/types/GuidedDynamicInline.d.ts

@@ -1,5 +1,5 @@
 import type * as Corti from "../index.js";
 export interface GuidedDynamicInline {
-    instructions: Corti.TemplateInstructions;
-    sections: Corti.SectionGeneration[];
+    instructions: Corti.GuidedTemplateInstructions;
+    sections: Corti.GuidedSectionGeneration[];
 }

package/dist/cjs/api/types/GuidedEphemeralDocument.d.ts

@@ -0,0 +1,17 @@
+import type * as Corti from "../index.js";
+/**
+ * A generated document that was not saved to the database.
+ */
+export interface GuidedEphemeralDocument {
+    name: string;
+    templateId: string;
+    templateVersionId: string;
+    /** The BCP 47 language tag of the generated output. */
+    language: string;
+    /** The interaction whose context was used to generate this document, if supplied. */
+    interactionId?: string | null;
+    stringDocument: Record<string, string>;
+    structuredDocument?: Record<string, unknown> | null;
+    /** Key/value labels attached to this document. */
+    labels: Corti.GuidedLabel[];
+}

package/dist/cjs/api/types/GuidedFieldDefinition.d.ts

@@ -0,0 +1,11 @@
+import type * as Corti from "../index.js";
+export interface GuidedFieldDefinition {
+    /** Use to set a key to reference. */
+    key: string;
+    /** Guide the LLM in what to output for this node. Supplements the section-level instructions. */
+    description: string;
+    /** Must be another output schema node (string, number, boolean, array, or object). */
+    value: Corti.GuidedOutputSchema;
+    /** If nothing is outputted for this field, this default value is used in the rendered output. */
+    default?: string | null;
+}

package/dist/cjs/api/types/GuidedLabel.d.ts

@@ -0,0 +1,4 @@
+export interface GuidedLabel {
+    key: string;
+    value: string;
+}

package/dist/cjs/api/types/GuidedNumberNode.d.ts

@@ -0,0 +1,13 @@
+export interface GuidedNumberNode {
+    type: "number";
+    /** Guide the LLM in what to output for this node. Supplements the section-level instructions. */
+    description?: string;
+    /** If nothing is outputted, this default is used. */
+    default?: number | null;
+    /** Can be used to guide the LLM with specific values to output. */
+    enum?: number[];
+    /** Use if a minimum value applies. */
+    minimum?: number | null;
+    /** Use if a maximum value applies. */
+    maximum?: number | null;
+}

package/dist/cjs/api/types/GuidedObjectNode.d.ts

@@ -0,0 +1,18 @@
+import type * as Corti from "../index.js";
+export interface GuidedObjectNode {
+    type: "object";
+    /** Guide the LLM in what to output for this node. Supplements the section-level instructions. */
+    description?: string;
+    /**
+     * Free-form format string that controls how an object's fields are rendered into the final text output. Operates in one of two modes determined by which placeholders appear:
+     *
+     * **Subheading mode** (default: `"{key}: {value}\n"`): triggered when the format contains both `{key}` and `{value}`. Applied per field — each field becomes a key/value line. When a field has no relevant input/output and no `default` is set, the entire key/value line for that field is omitted from the rendered output.
+     *
+     * **Object mode** (e.g. `"{name} ({age})"`): triggered when `{key}` and `{value}` are absent. Placeholders must be actual field keys defined in `fields`. Applied once for the whole object, composing all fields into a single string. When a field has no relevant input/output and no `default` is set, its placeholder is replaced with an empty string (`""`).
+     *
+     * Validation rules: format must not be empty; if either `{key}` or `{value}` appears, both must be present; in subheading mode no extra placeholders are allowed; in object mode every placeholder must match a defined field key.
+     */
+    fieldFormat?: string;
+    /** Define what fields are possible to return in the object. */
+    fields?: Corti.GuidedFieldDefinition[];
+}

package/dist/cjs/api/types/GuidedOutputSchema.d.ts

@@ -0,0 +1,2 @@
+import type * as Corti from "../index.js";
+export type GuidedOutputSchema = Corti.GuidedStringNode | Corti.GuidedNumberNode | Corti.GuidedBoolNode | Corti.GuidedObjectNode | Corti.GuidedArrayNode;

package/dist/cjs/api/types/GuidedSection.d.ts

@@ -0,0 +1,33 @@
+import type * as Corti from "../index.js";
+export interface GuidedSection {
+    /** The UUID of the section. */
+    id: string;
+    /** Reference to the section to inherit generation configuration from. Inherits from published version by default. */
+    inheritedFromId?: string | null;
+    /** True if the section was auto-generated as part of an inline section-composed POST /documents request. */
+    autoGenerated?: boolean;
+    /** Whether this section was created by the user or from the Corti standard resources. */
+    source?: Corti.GuidedSectionSource;
+    /** The name of the section. */
+    name: string;
+    /** BCP 47 languages this section has been tweaked for. Empty means no language-specific tweaks. */
+    languages: string[];
+    /** ISO 3166-1 alpha-3 country codes this section has been tweaked for. Empty means no region-specific tweaks. */
+    regions: string[];
+    /** Clinical specialties this section has been tweaked for. Empty means no specialty-specific tweaks. */
+    specialties: string[];
+    /** The description for the section. */
+    description?: string;
+    /** The labels available to use as query param filter in the LIST /sections endpoint. */
+    labels: Corti.GuidedLabel[];
+    /** The currently published version with section inheritance fully resolved. Present when a version has been published. */
+    publishedVersion?: Corti.GuidedSectionVersion;
+    /** The original timestamp when the section was created. */
+    createdAt: Date;
+    /** The original timestamp when the section was last updated. */
+    updatedAt: Date;
+    /** Present when the section has been deleted. GET by ID still returns the full resource with this field populated. */
+    deletedAt?: Date | null;
+    /** Access policies for this section. */
+    policies?: Corti.GuidedSectionPolicy[];
+}

package/dist/cjs/api/types/GuidedSectionGeneration.d.ts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.js";
+export interface GuidedSectionGeneration {
+    /** The heading of this section. Passed to the LLM. */
+    heading: string;
+    /** The prompt instructions for this section. */
+    instructions: Corti.GuidedSectionInstructions;
+    outputSchema: Corti.GuidedOutputSchema;
+}

package/dist/cjs/api/types/GuidedSectionGenerationPartial.d.ts

@@ -0,0 +1,12 @@
+import type * as Corti from "../index.js";
+/**
+ * Partial form of GuidedSectionGeneration used when inheriting from another section. Any field omitted is inherited from the referenced section.
+ */
+export interface GuidedSectionGenerationPartial {
+    /** Override the inherited section title. Passed to the LLM. */
+    heading?: string;
+    /** Override the inherited prompt instructions for this section. Any field omitted is inherited. */
+    instructions?: Corti.GuidedSectionInstructionsPartial;
+    /** Override the inherited output schema. */
+    outputSchema?: Corti.GuidedOutputSchema;
+}

package/dist/cjs/api/types/GuidedSectionInstructions.d.ts

@@ -0,0 +1,8 @@
+export interface GuidedSectionInstructions {
+    /** The content prompt instructs the model what to include for synthesis. For `documentationMode: routed_parallel` this impacts what facts to route to this section. */
+    contentPrompt: string;
+    /** The writingStyle prompt instructs the model in what tone and style to output. */
+    writingStylePrompt?: string;
+    /** Optional free-form prompt for any instructions that don't fit contentPrompt or writingStylePrompt. */
+    miscPrompt?: string;
+}

package/dist/cjs/api/types/GuidedSectionInstructionsOverride.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Partial section-instructions patch used in override and fork contexts. Each field is independent: provide only the fields you want to replace, and any field you omit is inherited from the parent's published version.
+ */
+export interface GuidedSectionInstructionsOverride {
+    /** When provided, replaces the section's content prompt. Omit to inherit from the parent. */
+    contentPrompt?: string;
+    /** When provided, replaces the section's writing style prompt. Omit to inherit from the parent. */
+    writingStylePrompt?: string;
+    /** When provided, replaces the section's misc prompt. Omit to inherit from the parent. */
+    miscPrompt?: string;
+}

package/dist/cjs/api/types/GuidedSectionInstructionsPartial.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Partial form of GuidedSectionInstructions used when inheriting from another section. Any field omitted is inherited.
+ */
+export interface GuidedSectionInstructionsPartial {
+    /** Override the inherited content prompt. */
+    contentPrompt?: string;
+    /** Override the inherited writing style prompt. */
+    writingStylePrompt?: string;
+    /** Override the inherited misc prompt. */
+    miscPrompt?: string;
+}

package/dist/cjs/api/types/GuidedSectionOverride.d.ts

@@ -5,5 +5,5 @@ import type * as Corti from "../index.js";
 export interface GuidedSectionOverride {
     /** The UUID of a section linked to the base template version. */
     sectionId: string;
-    generation?: Corti.SectionOverrides;
+    generation?: Corti.GuidedSectionOverrides;
 }

package/dist/cjs/api/types/GuidedSectionOverrides.d.ts

@@ -0,0 +1,11 @@
+import type * as Corti from "../index.js";
+/**
+ * Patches a section's content at link time without mutating the underlying section. Override semantics are per-field for instructions (any field you omit is inherited from the parent's published version) and wholesale for `outputSchema` (whatever you submit fully replaces the parent schema). The same applies when a section is forked via `inheritFromId`.
+ */
+export interface GuidedSectionOverrides {
+    /** When provided, replaces the section's heading for this call. */
+    heading?: string | null;
+    instructions?: Corti.GuidedSectionInstructionsOverride;
+    /** When provided, fully replaces the parent's output schema. */
+    outputSchema?: Corti.GuidedOutputSchema;
+}

package/dist/cjs/api/types/GuidedSectionPolicy.d.ts

@@ -0,0 +1,16 @@
+import type * as Corti from "../index.js";
+export interface GuidedSectionPolicy {
+    /** The UUID of the policy. */
+    id: string;
+    kind: Corti.GuidedTemplatePolicyKind;
+    /** Present when `kind` is `customers`. Lists the customer tenant identifiers that have access. */
+    customerIds?: string[] | null;
+    /** The UUID of the section this policy belongs to. */
+    sectionId: string;
+    /** The UUID of the user who created this policy. */
+    createdBy: string;
+    /** Timestamp when the policy was created. */
+    createdAt: Date;
+    /** Timestamp when the policy was last updated. */
+    updatedAt: Date;
+}

package/dist/cjs/api/types/GuidedSectionSource.d.ts

@@ -0,0 +1,6 @@
+/** Whether this section was created by the user or from the Corti standard resources. */
+export declare const GuidedSectionSource: {
+    readonly User: "user";
+    readonly Corti: "corti";
+};
+export type GuidedSectionSource = (typeof GuidedSectionSource)[keyof typeof GuidedSectionSource];

package/dist/cjs/api/types/GuidedSectionSource.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuidedSectionSource = void 0;
+/** Whether this section was created by the user or from the Corti standard resources. */
+exports.GuidedSectionSource = {
+    User: "user",
+    Corti: "corti",
+};

package/dist/cjs/api/types/GuidedSectionVersion.d.ts

@@ -0,0 +1,15 @@
+import type * as Corti from "../index.js";
+/**
+ * A section version. When embedded inside a Section resource (e.g. GET /sections/:id),
+ * inheritance is fully resolved. When returned directly from version endpoints
+ * (GET/LIST/POST .../versions/...), contains raw authored values without inheritance.
+ */
+export interface GuidedSectionVersion {
+    /** The UUID of the section version. */
+    id: string;
+    /** Starts at 0 and auto-increments. */
+    versionNumber: number;
+    /** Present when the section version has been deleted. */
+    deletedAt?: Date | null;
+    generation: Corti.GuidedSectionGeneration;
+}