@corti/sdk 2.2.0-rc.2 → 3.0.0

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

@@ -78,7 +78,7 @@ export 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}
@@ -104,7 +104,7 @@ export 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,
                 }),
@@ -116,7 +116,7 @@ export class VersionsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.ShallowTemplateVersionResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedShallowTemplateVersionResponse.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -174,7 +174,7 @@ export class VersionsClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.ShallowTemplateVersionResponse.parseOrThrow(_response.body, {
+                    data: serializers.GuidedShallowTemplateVersionResponse.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -281,7 +281,7 @@ export 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/esm/api/resources/documents/resources/templates/resources/versions/client/requests/GuidedTemplatesCreateVersionRequest.d.mts

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

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

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

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

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

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

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

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

@@ -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/esm/api/resources/templates/client/Client.mjs

@@ -22,7 +22,7 @@ export 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}
@@ -93,7 +93,7 @@ export 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/esm/api/resources/templates/client/requests/TemplatesListRequest.d.mts

@@ -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/esm/api/resources/templates/client/requests/TemplatesSectionListRequest.d.mts

@@ -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/esm/api/resources/templates/client/requests/index.d.mts

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

package/dist/esm/api/types/CommonDocumentationEvidence.d.mts

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

package/dist/esm/api/types/CommonFactsContext.d.mts

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

package/dist/esm/api/types/CommonStatusResponse.d.mts

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

package/dist/esm/api/types/CommonTextContext.d.mts

@@ -1,7 +1,5 @@
-import type * as Corti from "../index.mjs";
 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/esm/api/types/CommonTranscriptContext.d.mts

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

package/dist/esm/api/types/GuidedArrayNode.d.mts

@@ -0,0 +1,13 @@
+import type * as Corti from "../index.mjs";
+export interface GuidedArrayNode {
+    type: "array";
+    /** Can be used to prompt the LLM with more guidance in addition to the section.instructions */
+    description?: string;
+    items: Corti.GuidedOutputSchema;
+    /** Controls how each array item is rendered in the generated output. Use `bullet` (default), `numbered`, or `plain`, or provide a custom format string containing the `{item}` placeholder. */
+    itemFormat?: string;
+    /** Minimum number of array items to generate. */
+    minItems?: number | null;
+    /** Maximum number of array items to generate. */
+    maxItems?: number | null;
+}

package/dist/esm/api/types/GuidedAssemblyRequest.d.mts

@@ -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/esm/api/types/GuidedAssemblySectionRef.d.mts

@@ -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/esm/api/types/GuidedBoolNode.d.mts

@@ -0,0 +1,7 @@
+export interface GuidedBoolNode {
+    type: "boolean";
+    /** Can be used to prompt the LLM with more guidance in addition to the section.instructions */
+    description?: string;
+    /** The default to output if nothing to output. */
+    default?: boolean | null;
+}

package/dist/esm/api/types/GuidedDocumentContext.d.mts

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

package/dist/esm/api/types/GuidedDocumentsCreateEphemeralResponse.d.mts

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

package/dist/esm/api/types/GuidedDocumentsGenerateBase.d.mts

@@ -0,0 +1,12 @@
+import type * as Corti from "../index.mjs";
+/**
+ * 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;
+}

package/dist/esm/api/types/GuidedDocumentsGenerateByAssembly.d.mts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.mjs";
+/**
+ * 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/esm/api/types/GuidedDocumentsGenerateByDynamic.d.mts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.mjs";
+/**
+ * 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/esm/api/types/GuidedDocumentsGenerateByTemplateRef.d.mts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.mjs";
+/**
+ * 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/esm/api/types/GuidedDocumentsGenerateRequest.d.mts

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

package/dist/esm/api/types/GuidedDynamicInline.d.mts

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

package/dist/esm/api/types/GuidedEphemeralDocument.d.mts

@@ -0,0 +1,12 @@
+/**
+ * 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;
+    stringDocument: Record<string, string>;
+    structuredDocument?: Record<string, unknown> | null;
+}

package/dist/esm/api/types/GuidedFieldDefinition.d.mts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.mjs";
+export interface GuidedFieldDefinition {
+    /** Use to set a key to reference. */
+    key: string;
+    /** Can be used to prompt the LLM with more guidance in addition to the section.instructions */
+    description: string;
+    value: Corti.GuidedOutputSchema;
+}

package/dist/esm/api/types/GuidedLabel.d.mts

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

package/dist/esm/api/types/GuidedNumberNode.d.mts

@@ -0,0 +1,13 @@
+export interface GuidedNumberNode {
+    type: "number";
+    /** Can be used to prompt the LLM with more guidance in addition to the section.instructions */
+    description?: string;
+    /** The default to output if nothing to output. */
+    default?: number | null;
+    /** Can be used to prompt the LLM for specifically allowed numeric 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/esm/api/types/GuidedObjectNode.d.mts

@@ -0,0 +1,18 @@
+import type * as Corti from "../index.mjs";
+export interface GuidedObjectNode {
+    type: "object";
+    /** Can be used to prompt the LLM with more guidance in addition to the section.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. Fields that render to null are skipped.
+     *
+     * **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. Fields rendering to null become 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/esm/api/types/GuidedOutputSchema.d.mts

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

package/dist/esm/api/types/GuidedSection.d.mts

@@ -0,0 +1,33 @@
+import type * as Corti from "../index.mjs";
+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/esm/api/types/GuidedSectionGeneration.d.mts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.mjs";
+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/esm/api/types/GuidedSectionGenerationPartial.d.mts

@@ -0,0 +1,12 @@
+import type * as Corti from "../index.mjs";
+/**
+ * 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/esm/api/types/GuidedSectionInstructions.d.mts

@@ -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/esm/api/types/GuidedSectionInstructionsOverride.d.mts

@@ -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/esm/api/types/GuidedSectionInstructionsPartial.d.mts

@@ -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/esm/api/types/GuidedSectionOverride.d.mts

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

package/dist/esm/api/types/GuidedSectionOverrides.d.mts

@@ -0,0 +1,11 @@
+import type * as Corti from "../index.mjs";
+/**
+ * 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/esm/api/types/GuidedSectionPolicy.d.mts

@@ -0,0 +1,16 @@
+import type * as Corti from "../index.mjs";
+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/esm/api/types/GuidedSectionSource.d.mts

@@ -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/esm/api/types/GuidedSectionSource.mjs

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Whether this section was created by the user or from the Corti standard resources. */
+export const GuidedSectionSource = {
+    User: "user",
+    Corti: "corti",
+};

package/dist/esm/api/types/GuidedSectionVersion.d.mts

@@ -0,0 +1,15 @@
+import type * as Corti from "../index.mjs";
+/**
+ * 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;
+}

package/dist/esm/api/types/GuidedSectionsCreateBase.d.mts

@@ -0,0 +1,19 @@
+import type * as Corti from "../index.mjs";
+export interface GuidedSectionsCreateBase {
+    /** A human-readable identifier for this section. Not passed to the LLM. */
+    name: string;
+    /** A description for this section. Not passed to the LLM. */
+    description?: string;
+    /** BCP 47 language tags this section has been tweaked for. */
+    languages?: string[];
+    /** ISO 3166-1 alpha-3 country codes this section has been tweaked for. */
+    regions?: string[];
+    /** Clinical specialties this section has been tweaked for. */
+    specialties?: string[];
+    /** Labels work as query param filter in the LIST /sections endpoint. */
+    labels?: Corti.GuidedLabel[];
+    /** Defaults to true when omitted. Set this to false if you do not want the section to automatically show up in LIST /sections. */
+    publish?: boolean;
+    /** Access policies to apply to the section on creation. */
+    policies?: Corti.GuidedSectionsCreatePolicyRequest[];
+}

package/dist/esm/api/types/GuidedSectionsCreateFromInheritanceRequest.d.mts

@@ -0,0 +1,9 @@
+import type * as Corti from "../index.mjs";
+/**
+ * Creates a section that inherits from another section. Any fields omitted in `generation` are inherited from the referenced section's published version; any fields provided override the inherited values.
+ */
+export interface GuidedSectionsCreateFromInheritanceRequest extends Corti.GuidedSectionsCreateBase {
+    /** Reference to the section to inherit generation configuration from. Inherits from the published version of the referenced section. */
+    inheritFromId: string;
+    generation?: Corti.GuidedSectionGenerationPartial;
+}

package/dist/esm/api/types/GuidedSectionsCreateFromScratchRequest.d.mts

@@ -0,0 +1,7 @@
+import type * as Corti from "../index.mjs";
+/**
+ * Creates a section from scratch with an explicit generation configuration. All required fields on `generation` apply.
+ */
+export interface GuidedSectionsCreateFromScratchRequest extends Corti.GuidedSectionsCreateBase {
+    generation: Corti.GuidedSectionGeneration;
+}

package/dist/esm/api/types/GuidedSectionsCreatePolicyRequest.d.mts

@@ -0,0 +1,6 @@
+import type * as Corti from "../index.mjs";
+export interface GuidedSectionsCreatePolicyRequest {
+    kind: Corti.GuidedTemplatePolicyKind;
+    /** Required when `kind` is `customers`. List of customer tenant identifiers that should have access. */
+    customerIds?: string[] | null;
+}

package/dist/esm/api/types/GuidedSectionsCreateRequest.d.mts

@@ -0,0 +1,2 @@
+import type * as Corti from "../index.mjs";
+export type GuidedSectionsCreateRequest = Corti.GuidedSectionsCreateFromScratchRequest | Corti.GuidedSectionsCreateFromInheritanceRequest;

package/dist/esm/api/types/GuidedShallowTemplateGeneration.d.mts

@@ -0,0 +1,9 @@
+import type * as Corti from "../index.mjs";
+/**
+ * Template generation with section references (not fully resolved). Use the resolved GuidedTemplateGeneration for hydrated section data.
+ */
+export interface GuidedShallowTemplateGeneration {
+    instructions: Corti.GuidedTemplateInstructions;
+    /** Section references linked to this version (not fully resolved). */
+    sections: Corti.GuidedTemplateVersionSectionRef[];
+}