@wix/auto_sdk_rich-content_ricos-conversations 1.0.3 → 1.0.5

package/build/cjs/index.d.ts

@@ -25,6 +25,8 @@ interface RicosConversation extends RicosConversationUserMessageOneOf {
      * @maxSize 100
      */
     tools?: Tool[];
+    /** Current Ricos theme */
+    theme?: Theme;
 }
 /** @oneof */
 interface RicosConversationUserMessageOneOf {
@@ -1947,407 +1949,152 @@ interface TemplateSearchConfiguration {
      */
     knowledgeBaseIds?: string[];
 }
-/** Request message for prompting the AI assistant with streaming response delivery */
-interface CreateConversationStreamedRequest {
+/**
+ * Theme represents the complete visual styling configuration for a ricos document.
+ * It encapsulates all theme elements including colors, fonts, and component styling.
+ */
+interface Theme {
     /**
-     * The conversation context including the current document state and message history.
-     * Same as the non-streamed version, but the response will be delivered incrementally
-     * through multiple response chunks rather than a single complete response.
+     * Palette of colors used in the theme
+     * Limited to 6 colors in eight-value hexadecimal format (e.g., #FF0099AA)
+     * @format COLOR_HEX
+     * @maxSize 6
      */
-    ricosConversation?: RicosConversation;
+    colorPalette?: string[];
     /**
-     * Flag to control whether this conversation should be persisted for future continuation.
-     * When true, the conversation will be stored and can be continued using the continue endpoint.
-     * When false, the conversation will not be persisted .
+     * Background configuration for the page
+     * Can be either a solid color or an image with various styling options
      */
-    persist?: boolean;
+    background?: V1Background;
     /**
-     * Invocation id
-     * @format GUID
+     * Typography settings for various text elements
+     * Includes styling for headings and paragraphs
      */
-    invocationId?: string | null;
-}
-/** Streaming response message containing individual chunks of the AI's response */
-interface ConversationResponse {
-    /** A single chunk of the AI's response stream. */
-    chunk?: RicosConversationChunk;
+    typography?: Typography;
     /**
-     * Unique identifier for this conversation session.
-     * @format GUID
+     * Button styling configuration
+     * Defines how buttons appear, including their hover states
      */
-    conversationId?: string | null;
+    button?: Button;
+    /**
+     * Image styling configuration
+     * Defines how images appear, including borders
+     */
+    image?: V1Image;
+    /** Page setup configuration for layout and spacing */
+    pageSetup?: PageSetup;
 }
 /**
- * Represents a single chunk in a Ricos AI conversation flow
- * Used for streaming responses where the AI assistant delivers content incrementally
+ * Background defines the styling for a page's background.
+ * Supports either color or image backgrounds with configuration options for each.
  */
-interface RicosConversationChunk extends RicosConversationChunkTypeDataOneOf {
-    /** Options for explanation chunks that provide textual context */
-    explainOptions?: ExplainOption;
-    /** Options for insertion chunks that specify where content should be added */
-    insertOptions?: InsertOptions;
-    /** Options for replacement chunks that specify content range to replace */
-    replaceOptions?: ReplaceOptions;
-    /** Options for node chunks that contain rich content nodes */
-    nodeOptions?: NodeOptions;
-    /** Options for node text chunks that contain text with decorations */
-    nodeTextOptions?: NodeTextOptions;
-    /** Options to notify about existing tool use */
-    toolUseOptions?: ToolUseOptions;
-    /** Patch options */
-    patchOptions?: PatchOptions;
-    /** Progress options */
-    progressOptions?: ProgressOptions;
-    /** Summary options */
-    summaryOptions?: SummaryOptions;
-    /** Suggestion options */
-    suggestionOptions?: SuggestionOptions;
-    /** Theme options */
-    themeOptions?: ThemeOptions;
-    /** The type of chunk that determines its behavior and purpose */
-    type?: ChunkTypeWithLiterals;
+interface V1Background extends V1BackgroundBackgroundTypeOptionsOneOf {
+    /** Settings for color backgrounds, available when type = COLOR */
+    colorOptions?: ColorOptions;
+    /** Settings for image backgrounds, available when type = IMAGE */
+    imageOptions?: ImageOptions;
+    /** Background type determines whether this is a color or image background */
+    type?: BackgroundBackgroundTypeWithLiterals;
 }
 /** @oneof */
-interface RicosConversationChunkTypeDataOneOf {
-    /** Options for explanation chunks that provide textual context */
-    explainOptions?: ExplainOption;
-    /** Options for insertion chunks that specify where content should be added */
-    insertOptions?: InsertOptions;
-    /** Options for replacement chunks that specify content range to replace */
-    replaceOptions?: ReplaceOptions;
-    /** Options for node chunks that contain rich content nodes */
-    nodeOptions?: NodeOptions;
-    /** Options for node text chunks that contain text with decorations */
-    nodeTextOptions?: NodeTextOptions;
-    /** Options to notify about existing tool use */
-    toolUseOptions?: ToolUseOptions;
-    /** Patch options */
-    patchOptions?: PatchOptions;
-    /** Progress options */
-    progressOptions?: ProgressOptions;
-    /** Summary options */
-    summaryOptions?: SummaryOptions;
-    /** Suggestion options */
-    suggestionOptions?: SuggestionOptions;
-    /** Theme options */
-    themeOptions?: ThemeOptions;
-}
-/** Defines the type of operation this chunk represents in the conversation flow */
-declare enum ChunkType {
-    /** Unspecified chunk type */
-    CHUNK_TYPE_UNKNOWN = "CHUNK_TYPE_UNKNOWN",
-    /** Explanation chunk containing descriptive text about changes being made */
-    EXPLAIN = "EXPLAIN",
-    /** Insert operation chunk that adds content after a specified reference point */
-    INSERT = "INSERT",
-    /** Replace operation chunk that substitutes content within a specified range */
-    REPLACE = "REPLACE",
-    /** Node chunk that represents a rich content node (images, headings, etc.) */
-    NODE = "NODE",
-    /** Node text chunk that represents text content within a node with optional decorations */
-    NODE_TEXT = "NODE_TEXT",
-    /** Marker indicating the end of an insert operation range */
-    INSERT_END = "INSERT_END",
-    /** Marker indicating the end of a replace operation range */
-    REPLACE_END = "REPLACE_END",
-    /** Tool use notification chunk indicating that a tool has been used */
-    TOOL_USE = "TOOL_USE",
-    /** Patch chunk type */
-    PATCH = "PATCH",
-    /** Progress chunk type */
-    PROGRESS = "PROGRESS",
-    /** Summary chunk type */
-    SUMMARY = "SUMMARY",
-    /** Suggestion chunk type */
-    SUGGESTION = "SUGGESTION",
-    /** Theme chunk type */
-    THEME = "THEME"
+interface V1BackgroundBackgroundTypeOptionsOneOf {
+    /** Settings for color backgrounds, available when type = COLOR */
+    colorOptions?: ColorOptions;
+    /** Settings for image backgrounds, available when type = IMAGE */
+    imageOptions?: ImageOptions;
 }
-/** @enumType */
-type ChunkTypeWithLiterals = ChunkType | 'CHUNK_TYPE_UNKNOWN' | 'EXPLAIN' | 'INSERT' | 'REPLACE' | 'NODE' | 'NODE_TEXT' | 'INSERT_END' | 'REPLACE_END' | 'TOOL_USE' | 'PATCH' | 'PROGRESS' | 'SUMMARY' | 'SUGGESTION' | 'THEME';
-/** Options for explanation chunks that provide context about AI operations */
-interface ExplainOption {
+/**
+ * ColorSwatch defines a color or gradient that can be used for styling elements.
+ * Supports either solid colors or gradients with configuration options for each.
+ */
+interface ColorSwatch extends ColorSwatchColorTypeOptionsOneOf {
     /**
-     * The explanatory text content describing what changes are being made
-     * @maxLength 100000
+     * Solid color value, available when type = COLOR
+     * @format COLOR_HEX
      */
-    text?: string;
+    colorOptions?: string | null;
+    /** Gradient configuration, available when type = GRADIENT */
+    gradientOptions?: V1Gradient;
+    /** Type determines whether this is a solid color or gradient */
+    type?: ColorSwatchTypeWithLiterals;
 }
-/** Options for insert operation chunks that specify insertion behavior */
-interface InsertOptions {
+/** @oneof */
+interface ColorSwatchColorTypeOptionsOneOf {
     /**
-     * The ID of the chunk after which new content will be inserted
-     * @maxLength 100
+     * Solid color value, available when type = COLOR
+     * @format COLOR_HEX
      */
-    after?: string;
+    colorOptions?: string | null;
+    /** Gradient configuration, available when type = GRADIENT */
+    gradientOptions?: V1Gradient;
 }
-/** Options for replace operation chunks that specify replacement range */
-interface ReplaceOptions {
+/** ColorSwatchType determines what kind of color styling is being used. */
+declare enum ColorSwatchType {
+    /** Default value when color swatch type is not specified */
+    UNKNOWN_COLOR_SWATCH_TYPE = "UNKNOWN_COLOR_SWATCH_TYPE",
+    /** Color swatch is a solid color */
+    COLOR = "COLOR",
+    /** Color swatch is a gradient */
+    GRADIENT = "GRADIENT"
+}
+/** @enumType */
+type ColorSwatchTypeWithLiterals = ColorSwatchType | 'UNKNOWN_COLOR_SWATCH_TYPE' | 'COLOR' | 'GRADIENT';
+/**
+ * Gradient defines a color gradient configuration.
+ * Supports both linear and radial gradients with multiple color stops.
+ */
+interface V1Gradient extends V1GradientGradientTypeOptionsOneOf {
     /**
-     * The starting chunk ID of the range to be replaced (inclusive)
-     * @maxLength 100
+     * Angle in degrees for linear gradients (0-360)
+     * @max 360
      */
-    from?: string;
+    linearOptions?: number | null;
+    /** Center point for radial gradients */
+    radialOptions?: Center;
+    /** Type determines whether this is a linear or radial gradient */
+    type?: GradientTypeWithLiterals;
     /**
-     * The ending chunk ID of the range to be replaced (inclusive)
-     * @maxLength 100
+     * Color stops that define the gradient colors and positions
+     * @maxSize 10
      */
-    to?: string;
-}
-/** Options for node chunks that contain rich content elements */
-interface NodeOptions {
+    stops?: GradientStop[];
     /**
-     * The parent node ID for hierarchical content structure (null for root level)
-     * @maxLength 100
+     * Global opacity of the gradients (0.0 to 1.0)
+     * @max 1
      */
-    parent?: string | null;
-    /** The rich content node to be inserted or manipulated (images, headings, paragraphs, etc.) */
-    node?: Node;
-    /** Indication that node is still loading and should treated as such */
-    pending?: boolean;
+    opacity?: number | null;
 }
-/** Options for node text chunks that contain formatted text content */
-interface NodeTextOptions {
+/** @oneof */
+interface V1GradientGradientTypeOptionsOneOf {
     /**
-     * The parent node ID to which this text content belongs
-     * @maxLength 100
+     * Angle in degrees for linear gradients (0-360)
+     * @max 360
      */
-    parent?: string;
+    linearOptions?: number | null;
+    /** Center point for radial gradients */
+    radialOptions?: Center;
+}
+/** GradientType determines what kind of gradient is being used. */
+declare enum GradientType {
+    /** Default value when gradient type is not specified */
+    UNKNOWN_GRADIENT_TYPE = "UNKNOWN_GRADIENT_TYPE",
+    /** Linear gradient that transitions colors along a straight line */
+    LINEAR = "LINEAR",
+    /** Radial gradient that transitions colors outward from a center point */
+    RADIAL = "RADIAL"
+}
+/** @enumType */
+type GradientTypeWithLiterals = GradientType | 'UNKNOWN_GRADIENT_TYPE' | 'LINEAR' | 'RADIAL';
+/**
+ * GradientStop defines a color position within a gradient.
+ * Each stop has a color, opacity, and position value.
+ */
+interface GradientStop {
     /**
-     * The plain text content to be added to the node
-     * @maxLength 100000
+     * Color in eight-value hexadecimal format (e.g., #FF0099AA)
+     * @format COLOR_HEX
      */
-    text?: string;
-    /**
-     * Text decorations applied to this content (bold, italic, links, etc.)
-     * @maxSize 15
-     */
-    decorations?: Decoration[];
-}
-interface ToolUseOptions {
-    /**
-     * The name of the tool that was used in the conversation
-     * @maxLength 100
-     */
-    toolName?: string;
-    /** The parameters used when invoking the tool */
-    parameters?: Record<string, any> | null;
-}
-interface DebugOptions {
-    /**
-     * Raw text received from LLM
-     * @maxLength 100
-     */
-    text?: string;
-}
-interface MetadataOptions {
-    microcentsSpent?: string | null;
-    inputTokens?: number | null;
-    outputTokens?: number | null;
-    cacheCreationInputTokens?: number | null;
-    cacheReadInputTokens?: number | null;
-}
-interface PatchOptions {
-    /** The rich content node to be patched. Most likely this node was in the pending state */
-    node?: Node;
-}
-interface ProgressOptions {
-    /**
-     * The text content describing current progress or ongoing work
-     * @maxLength 100000
-     */
-    text?: string;
-}
-interface SummaryOptions {
-    /**
-     * The text content providing a summary of completed work or results
-     * @maxLength 100000
-     */
-    text?: string;
-}
-interface SuggestionOptions {
-    /**
-     * The starting node ID of the region for suggestion (inclusive, optional if no specific region)
-     * @maxLength 100
-     */
-    from?: string | null;
-    /**
-     * The ending node ID of the region for suggestion (inclusive, optional if no specific region)
-     * @maxLength 100
-     */
-    to?: string | null;
-    /** The type of action to perform: either replace existing content or insert new content */
-    action?: SuggestionActionWithLiterals;
-    /**
-     * Specific, actionable prompt describing the improvement to be made
-     * @maxLength 1000
-     */
-    prompt?: string;
-    /**
-     * Brief summary of the prompt in a few words
-     * @maxLength 200
-     */
-    summary?: string;
-}
-/** Defines the type of suggestion action */
-declare enum SuggestionAction {
-    /** Unspecified action type */
-    SUGGESTION_ACTION_UNKNOWN = "SUGGESTION_ACTION_UNKNOWN",
-    /** Replace the content in the specified range */
-    REPLACE = "REPLACE",
-    /** Insert new content after the specified range */
-    INSERT = "INSERT"
-}
-/** @enumType */
-type SuggestionActionWithLiterals = SuggestionAction | 'SUGGESTION_ACTION_UNKNOWN' | 'REPLACE' | 'INSERT';
-interface ThemeOptions {
-    /** Generated theme */
-    theme?: Theme;
-}
-/**
- * Theme represents the complete visual styling configuration for a ricos document.
- * It encapsulates all theme elements including colors, fonts, and component styling.
- */
-interface Theme {
-    /**
-     * Palette of colors used in the theme
-     * Limited to 6 colors in eight-value hexadecimal format (e.g., #FF0099AA)
-     * @format COLOR_HEX
-     * @maxSize 6
-     */
-    colorPalette?: string[];
-    /**
-     * Background configuration for the page
-     * Can be either a solid color or an image with various styling options
-     */
-    background?: V1Background;
-    /**
-     * Typography settings for various text elements
-     * Includes styling for headings and paragraphs
-     */
-    typography?: Typography;
-    /**
-     * Button styling configuration
-     * Defines how buttons appear, including their hover states
-     */
-    button?: Button;
-    /**
-     * Image styling configuration
-     * Defines how images appear, including borders
-     */
-    image?: V1Image;
-}
-/**
- * Background defines the styling for a page's background.
- * Supports either color or image backgrounds with configuration options for each.
- */
-interface V1Background extends V1BackgroundBackgroundTypeOptionsOneOf {
-    /** Settings for color backgrounds, available when type = COLOR */
-    colorOptions?: ColorOptions;
-    /** Settings for image backgrounds, available when type = IMAGE */
-    imageOptions?: ImageOptions;
-    /** Background type determines whether this is a color or image background */
-    type?: BackgroundBackgroundTypeWithLiterals;
-}
-/** @oneof */
-interface V1BackgroundBackgroundTypeOptionsOneOf {
-    /** Settings for color backgrounds, available when type = COLOR */
-    colorOptions?: ColorOptions;
-    /** Settings for image backgrounds, available when type = IMAGE */
-    imageOptions?: ImageOptions;
-}
-/**
- * ColorSwatch defines a color or gradient that can be used for styling elements.
- * Supports either solid colors or gradients with configuration options for each.
- */
-interface ColorSwatch extends ColorSwatchColorTypeOptionsOneOf {
-    /**
-     * Solid color value, available when type = COLOR
-     * @format COLOR_HEX
-     */
-    colorOptions?: string | null;
-    /** Gradient configuration, available when type = GRADIENT */
-    gradientOptions?: V1Gradient;
-    /** Type determines whether this is a solid color or gradient */
-    type?: ColorSwatchTypeWithLiterals;
-}
-/** @oneof */
-interface ColorSwatchColorTypeOptionsOneOf {
-    /**
-     * Solid color value, available when type = COLOR
-     * @format COLOR_HEX
-     */
-    colorOptions?: string | null;
-    /** Gradient configuration, available when type = GRADIENT */
-    gradientOptions?: V1Gradient;
-}
-/** ColorSwatchType determines what kind of color styling is being used. */
-declare enum ColorSwatchType {
-    /** Default value when color swatch type is not specified */
-    UNKNOWN_COLOR_SWATCH_TYPE = "UNKNOWN_COLOR_SWATCH_TYPE",
-    /** Color swatch is a solid color */
-    COLOR = "COLOR",
-    /** Color swatch is a gradient */
-    GRADIENT = "GRADIENT"
-}
-/** @enumType */
-type ColorSwatchTypeWithLiterals = ColorSwatchType | 'UNKNOWN_COLOR_SWATCH_TYPE' | 'COLOR' | 'GRADIENT';
-/**
- * Gradient defines a color gradient configuration.
- * Supports both linear and radial gradients with multiple color stops.
- */
-interface V1Gradient extends V1GradientGradientTypeOptionsOneOf {
-    /**
-     * Angle in degrees for linear gradients (0-360)
-     * @max 360
-     */
-    linearOptions?: number | null;
-    /** Center point for radial gradients */
-    radialOptions?: Center;
-    /** Type determines whether this is a linear or radial gradient */
-    type?: GradientTypeWithLiterals;
-    /**
-     * Color stops that define the gradient colors and positions
-     * @maxSize 10
-     */
-    stops?: GradientStop[];
-    /**
-     * Global opacity of the gradients (0.0 to 1.0)
-     * @max 1
-     */
-    opacity?: number | null;
-}
-/** @oneof */
-interface V1GradientGradientTypeOptionsOneOf {
-    /**
-     * Angle in degrees for linear gradients (0-360)
-     * @max 360
-     */
-    linearOptions?: number | null;
-    /** Center point for radial gradients */
-    radialOptions?: Center;
-}
-/** GradientType determines what kind of gradient is being used. */
-declare enum GradientType {
-    /** Default value when gradient type is not specified */
-    UNKNOWN_GRADIENT_TYPE = "UNKNOWN_GRADIENT_TYPE",
-    /** Linear gradient that transitions colors along a straight line */
-    LINEAR = "LINEAR",
-    /** Radial gradient that transitions colors outward from a center point */
-    RADIAL = "RADIAL"
-}
-/** @enumType */
-type GradientTypeWithLiterals = GradientType | 'UNKNOWN_GRADIENT_TYPE' | 'LINEAR' | 'RADIAL';
-/**
- * GradientStop defines a color position within a gradient.
- * Each stop has a color, opacity, and position value.
- */
-interface GradientStop {
-    /**
-     * Color in eight-value hexadecimal format (e.g., #FF0099AA)
-     * @format COLOR_HEX
-     */
-    color?: string | null;
+    color?: string | null;
     /**
      * Opacity of the color at this stop (0.0 to 1.0)
      * Deprecated, opacity is an alpha part of the color field
@@ -2634,21 +2381,308 @@ interface ImageBorder {
      */
     color?: string | null;
 }
-/** Request message for continuing an existing conversation with streaming response delivery */
-interface ContinueConversationStreamedRequest {
-    /** The conversation context including the current document state and message history. */
+/**
+ * PageSetup defines the layout configuration for pages.
+ * Includes settings for horizontal padding and vertical padding to control page spacing.
+ */
+interface PageSetup {
+    /** Horizontal padding configuration that determines the horizontal spacing of page content */
+    horizontalPadding?: HorizontalPaddingTypeWithLiterals;
+    /** Vertical padding configuration that controls spacing above and below content */
+    verticalPadding?: VerticalPaddingTypeWithLiterals;
+}
+/**
+ * Type defines the preset horizontal padding options for page content.
+ * Each option provides different amounts of horizontal spacing for content layout.
+ */
+declare enum HorizontalPaddingType {
+    /** Default value when horizontal padding is not specified */
+    UNKNOWN_HORIZONTAL_PADDING = "UNKNOWN_HORIZONTAL_PADDING",
+    /** No horizontal padding - content extends to page edges */
+    NONE = "NONE",
+    /** Small horizontal padding - minimal left/right spacing, results in wide content area */
+    SMALL = "SMALL",
+    /** Medium horizontal padding - standard left/right spacing, results in balanced content width */
+    MEDIUM = "MEDIUM",
+    /** Large horizontal padding - generous left/right spacing, results in narrow content area */
+    LARGE = "LARGE"
+}
+/** @enumType */
+type HorizontalPaddingTypeWithLiterals = HorizontalPaddingType | 'UNKNOWN_HORIZONTAL_PADDING' | 'NONE' | 'SMALL' | 'MEDIUM' | 'LARGE';
+/**
+ * Type defines the preset vertical padding options for page content.
+ * Each option provides different amounts of spacing around content.
+ */
+declare enum VerticalPaddingType {
+    /** Default value when vertical padding is not specified */
+    UNKNOWN_VERTICAL_PADDING = "UNKNOWN_VERTICAL_PADDING",
+    /** No vertical padding - content extends to page edges */
+    NONE = "NONE",
+    /** Small vertical padding - minimal spacing around content */
+    SMALL = "SMALL",
+    /** Medium vertical padding - standard spacing around content */
+    MEDIUM = "MEDIUM",
+    /** Large vertical padding - generous spacing around content */
+    LARGE = "LARGE"
+}
+/** @enumType */
+type VerticalPaddingTypeWithLiterals = VerticalPaddingType | 'UNKNOWN_VERTICAL_PADDING' | 'NONE' | 'SMALL' | 'MEDIUM' | 'LARGE';
+/** Request message for prompting the AI assistant with streaming response delivery */
+interface CreateConversationStreamedRequest {
+    /**
+     * The conversation context including the current document state and message history.
+     * Same as the non-streamed version, but the response will be delivered incrementally
+     * through multiple response chunks rather than a single complete response.
+     */
     ricosConversation?: RicosConversation;
+    /**
+     * Flag to control whether this conversation should be persisted for future continuation.
+     * When true, the conversation will be stored and can be continued using the continue endpoint.
+     * When false, the conversation will not be persisted .
+     */
+    persist?: boolean;
+    /**
+     * Invocation id
+     * @format GUID
+     */
+    invocationId?: string | null;
+}
+/** Streaming response message containing individual chunks of the AI's response */
+interface ConversationResponse {
+    /** A single chunk of the AI's response stream. */
+    chunk?: RicosConversationChunk;
+}
+/**
+ * Represents a single chunk in a Ricos AI conversation flow
+ * Used for streaming responses where the AI assistant delivers content incrementally
+ */
+interface RicosConversationChunk extends RicosConversationChunkTypeDataOneOf {
+    /** Options for explanation chunks that provide textual context */
+    explainOptions?: ExplainOption;
+    /** Options for insertion chunks that specify where content should be added */
+    insertOptions?: InsertOptions;
+    /** Options for replacement chunks that specify content range to replace */
+    replaceOptions?: ReplaceOptions;
+    /** Options for node chunks that contain rich content nodes */
+    nodeOptions?: NodeOptions;
+    /** Options for node text chunks that contain text with decorations */
+    nodeTextOptions?: NodeTextOptions;
+    /** Options to notify about existing tool use */
+    toolUseOptions?: ToolUseOptions;
+    /** Patch options */
+    patchOptions?: PatchOptions;
+    /** Progress options */
+    progressOptions?: ProgressOptions;
+    /** Summary options */
+    summaryOptions?: SummaryOptions;
+    /** Suggestion options */
+    suggestionOptions?: SuggestionOptions;
+    /** Theme options */
+    themeOptions?: ThemeOptions;
+    /** The type of chunk that determines its behavior and purpose */
+    type?: ChunkTypeWithLiterals;
+}
+/** @oneof */
+interface RicosConversationChunkTypeDataOneOf {
+    /** Options for explanation chunks that provide textual context */
+    explainOptions?: ExplainOption;
+    /** Options for insertion chunks that specify where content should be added */
+    insertOptions?: InsertOptions;
+    /** Options for replacement chunks that specify content range to replace */
+    replaceOptions?: ReplaceOptions;
+    /** Options for node chunks that contain rich content nodes */
+    nodeOptions?: NodeOptions;
+    /** Options for node text chunks that contain text with decorations */
+    nodeTextOptions?: NodeTextOptions;
+    /** Options to notify about existing tool use */
+    toolUseOptions?: ToolUseOptions;
+    /** Patch options */
+    patchOptions?: PatchOptions;
+    /** Progress options */
+    progressOptions?: ProgressOptions;
+    /** Summary options */
+    summaryOptions?: SummaryOptions;
+    /** Suggestion options */
+    suggestionOptions?: SuggestionOptions;
+    /** Theme options */
+    themeOptions?: ThemeOptions;
+}
+/** Defines the type of operation this chunk represents in the conversation flow */
+declare enum ChunkType {
+    /** Unspecified chunk type */
+    CHUNK_TYPE_UNKNOWN = "CHUNK_TYPE_UNKNOWN",
+    /** Explanation chunk containing descriptive text about changes being made */
+    EXPLAIN = "EXPLAIN",
+    /** Insert operation chunk that adds content after a specified reference point */
+    INSERT = "INSERT",
+    /** Replace operation chunk that substitutes content within a specified range */
+    REPLACE = "REPLACE",
+    /** Node chunk that represents a rich content node (images, headings, etc.) */
+    NODE = "NODE",
+    /** Node text chunk that represents text content within a node with optional decorations */
+    NODE_TEXT = "NODE_TEXT",
+    /** Marker indicating the end of an insert operation range */
+    INSERT_END = "INSERT_END",
+    /** Marker indicating the end of a replace operation range */
+    REPLACE_END = "REPLACE_END",
+    /** Tool use notification chunk indicating that a tool has been used */
+    TOOL_USE = "TOOL_USE",
+    /** Patch chunk type */
+    PATCH = "PATCH",
+    /** Progress chunk type */
+    PROGRESS = "PROGRESS",
+    /** Summary chunk type */
+    SUMMARY = "SUMMARY",
+    /** Suggestion chunk type */
+    SUGGESTION = "SUGGESTION",
+    /** Theme chunk type */
+    THEME = "THEME"
+}
+/** @enumType */
+type ChunkTypeWithLiterals = ChunkType | 'CHUNK_TYPE_UNKNOWN' | 'EXPLAIN' | 'INSERT' | 'REPLACE' | 'NODE' | 'NODE_TEXT' | 'INSERT_END' | 'REPLACE_END' | 'TOOL_USE' | 'PATCH' | 'PROGRESS' | 'SUMMARY' | 'SUGGESTION' | 'THEME';
+/** Options for explanation chunks that provide context about AI operations */
+interface ExplainOption {
+    /**
+     * The explanatory text content describing what changes are being made
+     * @maxLength 100000
+     */
+    text?: string;
+}
+/** Options for insert operation chunks that specify insertion behavior */
+interface InsertOptions {
+    /**
+     * The ID of the chunk after which new content will be inserted
+     * @maxLength 100
+     */
+    after?: string;
+}
+/** Options for replace operation chunks that specify replacement range */
+interface ReplaceOptions {
+    /**
+     * The starting chunk ID of the range to be replaced (inclusive)
+     * @maxLength 100
+     */
+    from?: string;
+    /**
+     * The ending chunk ID of the range to be replaced (inclusive)
+     * @maxLength 100
+     */
+    to?: string;
+}
+/** Options for node chunks that contain rich content elements */
+interface NodeOptions {
+    /**
+     * The parent node ID for hierarchical content structure (null for root level)
+     * @maxLength 100
+     */
+    parent?: string | null;
+    /** The rich content node to be inserted or manipulated (images, headings, paragraphs, etc.) */
+    node?: Node;
+    /** Indication that node is still loading and should treated as such */
+    pending?: boolean;
+}
+/** Options for node text chunks that contain formatted text content */
+interface NodeTextOptions {
+    /**
+     * The parent node ID to which this text content belongs
+     * @maxLength 100
+     */
+    parent?: string;
+    /**
+     * The plain text content to be added to the node
+     * @maxLength 100000
+     */
+    text?: string;
+    /**
+     * Text decorations applied to this content (bold, italic, links, etc.)
+     * @maxSize 15
+     */
+    decorations?: Decoration[];
+}
+interface ToolUseOptions {
+    /**
+     * The name of the tool that was used in the conversation
+     * @maxLength 100
+     */
+    toolName?: string;
+    /** The parameters used when invoking the tool */
+    parameters?: Record<string, any> | null;
+}
+interface DebugOptions {
+    /**
+     * Raw text received from LLM
+     * @maxLength 100
+     */
+    text?: string;
+}
+interface MetadataOptions {
+    microcentsSpent?: string | null;
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    cacheCreationInputTokens?: number | null;
+    cacheReadInputTokens?: number | null;
+}
+interface PatchOptions {
+    /** The rich content node to be patched. Most likely this node was in the pending state */
+    node?: Node;
+}
+interface ProgressOptions {
+    /**
+     * The text content describing current progress or ongoing work
+     * @maxLength 100000
+     */
+    text?: string;
+}
+interface SummaryOptions {
+    /**
+     * The text content providing a summary of completed work or results
+     * @maxLength 100000
+     */
+    text?: string;
+}
+interface SuggestionOptions {
+    /**
+     * The starting node ID of the region for suggestion (inclusive, optional if no specific region)
+     * @maxLength 100
+     */
+    from?: string | null;
+    /**
+     * The ending node ID of the region for suggestion (inclusive, optional if no specific region)
+     * @maxLength 100
+     */
+    to?: string | null;
+    /** The type of action to perform: either replace existing content or insert new content */
+    action?: SuggestionActionWithLiterals;
+    /**
+     * Specific, actionable prompt describing the improvement to be made
+     * @maxLength 1000
+     */
+    prompt?: string;
+    /**
+     * Brief summary of the prompt in a few words
+     * @maxLength 200
+     */
+    summary?: string;
+}
+/** Defines the type of suggestion action */
+declare enum SuggestionAction {
+    /** Unspecified action type */
+    SUGGESTION_ACTION_UNKNOWN = "SUGGESTION_ACTION_UNKNOWN",
+    /** Replace the content in the specified range */
+    REPLACE = "REPLACE",
+    /** Insert new content after the specified range */
+    INSERT = "INSERT"
+}
+/** @enumType */
+type SuggestionActionWithLiterals = SuggestionAction | 'SUGGESTION_ACTION_UNKNOWN' | 'REPLACE' | 'INSERT';
+interface ThemeOptions {
+    /** Generated theme */
+    theme?: Theme;
 }
 /** Request message for creating a new conversation with non-streamed response */
 interface CreateRicosConversationRequest {
     /** The conversation context including the current document state and message history */
     ricosConversation?: RicosConversation;
-    /**
-     * Flag to control whether this conversation should be persisted for future continuation
-     * When true, the conversation will be stored and can be continued using the continue endpoint
-     * When false, the conversation will not be persisted
-     */
-    persist?: boolean;
     /**
      * Invocation id
      * @format GUID
@@ -2905,19 +2939,9 @@ interface CreateConversationStreamedOptions {
      */
     invocationId?: string | null;
 }
-interface ContinueConversationStreamedOptions {
-    /** The conversation context including the current document state and message history. */
-    ricosConversation?: RicosConversation;
-}
 interface CreateRicosConversationOptions {
     /** The conversation context including the current document state and message history */
     ricosConversation?: RicosConversation;
-    /**
-     * Flag to control whether this conversation should be persisted for future continuation
-     * When true, the conversation will be stored and can be continued using the continue endpoint
-     * When false, the conversation will not be persisted
-     */
-    persist?: boolean;
     /**
      * Invocation id
      * @format GUID
@@ -2932,4 +2956,4 @@ interface ListConversationSuggestionsOptions {
     suggestions?: Suggestion[];
 }
 
-export { Action, type ActionEvent, type ActionWithLiterals, Alignment, type AlignmentWithLiterals, type AnchorData, type AppEmbedData, type AppEmbedDataAppDataOneOf, AppType, type AppTypeWithLiterals, AspectRatio, type AspectRatioWithLiterals, type AudioData, type Background, type BackgroundBackgroundOneOf, BackgroundBackgroundType, type BackgroundBackgroundTypeWithLiterals, type BackgroundImage, BackgroundType, type BackgroundTypeWithLiterals, type BlockquoteData, type BookingData, type Border, type BorderColors, type BulletedListData, type Button, type ButtonBorder, type ButtonData, ButtonDataType, type ButtonDataTypeWithLiterals, ButtonSize, type ButtonSizeWithLiterals, type ButtonStyles, type CaptionData, type CardStyles, type CellStyle, type Center, ChunkType, type ChunkTypeWithLiterals, type CodeBlockData, type CollapsibleListData, type ColorData, type ColorOptions, type ColorSwatch, type ColorSwatchColorTypeOptionsOneOf, ColorSwatchType, type ColorSwatchTypeWithLiterals, type Colors, type ContinueConversationStreamedOptions, type ContinueConversationStreamedRequest, type ConversationResponse, type CreateConversationStreamedOptions, type CreateConversationStreamedRequest, type CreateRicosConversationOptions, type CreateRicosConversationRequest, type CreateRicosConversationResponse, Crop, type CropWithLiterals, type DebugOptions, type Decoration, type DecorationDataOneOf, DecorationType, type DecorationTypeWithLiterals, type Design, type Dimensions, Direction, type DirectionWithLiterals, type DividerData, DividerDataAlignment, type DividerDataAlignmentWithLiterals, type DocumentStyle, type DomainEvent, type DomainEventBodyOneOf, type EmbedData, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventData, type ExplainOption, type File, type FileData, type FileSource, type FileSourceDataOneOf, type FontSizeData, FontType, type FontTypeWithLiterals, type GIF, type GIFData, GIFType, type GIFTypeWithLiterals, type GalleryData, type GalleryOptions, type GalleryOptionsLayout, type Gradient, type GradientStop, GradientType, type GradientTypeWithLiterals, type HTMLData, type HTMLDataDataOneOf, type HeadingData, type Height, type Hover, type IdentificationData, type IdentificationDataIdOneOf, type Image, type ImageBorder, type ImageData, type ImageDataStyles, type ImageOptions, ImageOptionsImagePosition, type ImageOptionsImagePositionWithLiterals, ImagePosition, type ImagePositionWithLiterals, ImageScaling, type ImageScalingWithLiterals, type ImageStyles, InitialExpandedItems, type InitialExpandedItemsWithLiterals, type InsertOptions, type Item, type ItemDataOneOf, type ItemStyle, Layout, type LayoutCellData, type LayoutData, LayoutType, type LayoutTypeWithLiterals, type LayoutWithLiterals, LineStyle, type LineStyleWithLiterals, type Link, type LinkData, type LinkDataOneOf, type LinkPreviewData, type LinkPreviewDataStyles, type ListConversationSuggestionsOptions, type ListConversationSuggestionsRequest, type ListConversationSuggestionsResponse, type ListValue, type MapData, type MapSettings, MapType, type MapTypeWithLiterals, type Media, type MentionData, type MessageEnvelope, type Metadata, type MetadataOptions, Name, type NameWithLiterals, type Node, type NodeDataOneOf, type NodeOptions, type NodeStyle, type NodeTextOptions, NodeType, type NodeTypeWithLiterals, NullValue, type NullValueWithLiterals, type Oembed, type Option, type OptionDesign, type OptionLayout, type OrderedListData, Orientation, type OrientationWithLiterals, type PDFSettings, type ParagraphData, type PatchOptions, type Permissions, Placement, type PlacementWithLiterals, type PlaybackOptions, type PluginContainerData, PluginContainerDataAlignment, type PluginContainerDataAlignmentWithLiterals, type PluginContainerDataWidth, type PluginContainerDataWidthDataOneOf, type Poll, type PollData, type PollDataLayout, type PollDesign, type PollLayout, PollLayoutDirection, type PollLayoutDirectionWithLiterals, PollLayoutType, type PollLayoutTypeWithLiterals, Position, type PositionWithLiterals, PositionsPosition, type PositionsPositionWithLiterals, type PricingData, type ProgressOptions, type PromptConfiguration, type RangeDetails, type Rel, type ReplaceOptions, Resizing, type ResizingWithLiterals, ResponsivenessBehaviour, type ResponsivenessBehaviourWithLiterals, type RestoreInfo, type RibbonStyles, type RichContent, type RicosConversation, type RicosConversationChunk, type RicosConversationChunkTypeDataOneOf, type RicosConversationUserMessageOneOf, Scaling, type ScalingWithLiterals, type Settings, Source, type SourceWithLiterals, type Spoiler, type SpoilerData, type Styles, type StylesBorder, StylesPosition, type StylesPositionWithLiterals, type Suggestion, SuggestionAction, type SuggestionActionWithLiterals, type SuggestionOptions, type SuggestionPositionDetailsOneOf, type SummaryOptions, type TableCellData, type TableData, Target, type TargetWithLiterals, type TemplateSearchConfiguration, TextAlignment, type TextAlignmentWithLiterals, type TextData, type TextNodeStyle, type TextStyle, type Theme, type ThemeOptions, type Thumbnails, ThumbnailsAlignment, type ThumbnailsAlignmentWithLiterals, type Tool, type ToolConfigurationOneOf, type ToolUseOptions, Type, type TypeWithLiterals, type Typography, type TypographyTextStyle, type V1Background, type V1BackgroundBackgroundTypeOptionsOneOf, type V1Gradient, type V1GradientGradientTypeOptionsOneOf, type V1Image, VerticalAlignment, VerticalAlignmentAlignment, type VerticalAlignmentAlignmentWithLiterals, type VerticalAlignmentWithLiterals, type Video, type VideoData, ViewMode, type ViewModeWithLiterals, ViewRole, type ViewRoleWithLiterals, VoteRole, type VoteRoleWithLiterals, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, Width, WidthType, type WidthTypeWithLiterals, type WidthWithLiterals };
+export { Action, type ActionEvent, type ActionWithLiterals, Alignment, type AlignmentWithLiterals, type AnchorData, type AppEmbedData, type AppEmbedDataAppDataOneOf, AppType, type AppTypeWithLiterals, AspectRatio, type AspectRatioWithLiterals, type AudioData, type Background, type BackgroundBackgroundOneOf, BackgroundBackgroundType, type BackgroundBackgroundTypeWithLiterals, type BackgroundImage, BackgroundType, type BackgroundTypeWithLiterals, type BlockquoteData, type BookingData, type Border, type BorderColors, type BulletedListData, type Button, type ButtonBorder, type ButtonData, ButtonDataType, type ButtonDataTypeWithLiterals, ButtonSize, type ButtonSizeWithLiterals, type ButtonStyles, type CaptionData, type CardStyles, type CellStyle, type Center, ChunkType, type ChunkTypeWithLiterals, type CodeBlockData, type CollapsibleListData, type ColorData, type ColorOptions, type ColorSwatch, type ColorSwatchColorTypeOptionsOneOf, ColorSwatchType, type ColorSwatchTypeWithLiterals, type Colors, type ConversationResponse, type CreateConversationStreamedOptions, type CreateConversationStreamedRequest, type CreateRicosConversationOptions, type CreateRicosConversationRequest, type CreateRicosConversationResponse, Crop, type CropWithLiterals, type DebugOptions, type Decoration, type DecorationDataOneOf, DecorationType, type DecorationTypeWithLiterals, type Design, type Dimensions, Direction, type DirectionWithLiterals, type DividerData, DividerDataAlignment, type DividerDataAlignmentWithLiterals, type DocumentStyle, type DomainEvent, type DomainEventBodyOneOf, type EmbedData, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventData, type ExplainOption, type File, type FileData, type FileSource, type FileSourceDataOneOf, type FontSizeData, FontType, type FontTypeWithLiterals, type GIF, type GIFData, GIFType, type GIFTypeWithLiterals, type GalleryData, type GalleryOptions, type GalleryOptionsLayout, type Gradient, type GradientStop, GradientType, type GradientTypeWithLiterals, type HTMLData, type HTMLDataDataOneOf, type HeadingData, type Height, HorizontalPaddingType, type HorizontalPaddingTypeWithLiterals, type Hover, type IdentificationData, type IdentificationDataIdOneOf, type Image, type ImageBorder, type ImageData, type ImageDataStyles, type ImageOptions, ImageOptionsImagePosition, type ImageOptionsImagePositionWithLiterals, ImagePosition, type ImagePositionWithLiterals, ImageScaling, type ImageScalingWithLiterals, type ImageStyles, InitialExpandedItems, type InitialExpandedItemsWithLiterals, type InsertOptions, type Item, type ItemDataOneOf, type ItemStyle, Layout, type LayoutCellData, type LayoutData, LayoutType, type LayoutTypeWithLiterals, type LayoutWithLiterals, LineStyle, type LineStyleWithLiterals, type Link, type LinkData, type LinkDataOneOf, type LinkPreviewData, type LinkPreviewDataStyles, type ListConversationSuggestionsOptions, type ListConversationSuggestionsRequest, type ListConversationSuggestionsResponse, type ListValue, type MapData, type MapSettings, MapType, type MapTypeWithLiterals, type Media, type MentionData, type MessageEnvelope, type Metadata, type MetadataOptions, Name, type NameWithLiterals, type Node, type NodeDataOneOf, type NodeOptions, type NodeStyle, type NodeTextOptions, NodeType, type NodeTypeWithLiterals, NullValue, type NullValueWithLiterals, type Oembed, type Option, type OptionDesign, type OptionLayout, type OrderedListData, Orientation, type OrientationWithLiterals, type PDFSettings, type PageSetup, type ParagraphData, type PatchOptions, type Permissions, Placement, type PlacementWithLiterals, type PlaybackOptions, type PluginContainerData, PluginContainerDataAlignment, type PluginContainerDataAlignmentWithLiterals, type PluginContainerDataWidth, type PluginContainerDataWidthDataOneOf, type Poll, type PollData, type PollDataLayout, type PollDesign, type PollLayout, PollLayoutDirection, type PollLayoutDirectionWithLiterals, PollLayoutType, type PollLayoutTypeWithLiterals, Position, type PositionWithLiterals, PositionsPosition, type PositionsPositionWithLiterals, type PricingData, type ProgressOptions, type PromptConfiguration, type RangeDetails, type Rel, type ReplaceOptions, Resizing, type ResizingWithLiterals, ResponsivenessBehaviour, type ResponsivenessBehaviourWithLiterals, type RestoreInfo, type RibbonStyles, type RichContent, type RicosConversation, type RicosConversationChunk, type RicosConversationChunkTypeDataOneOf, type RicosConversationUserMessageOneOf, Scaling, type ScalingWithLiterals, type Settings, Source, type SourceWithLiterals, type Spoiler, type SpoilerData, type Styles, type StylesBorder, StylesPosition, type StylesPositionWithLiterals, type Suggestion, SuggestionAction, type SuggestionActionWithLiterals, type SuggestionOptions, type SuggestionPositionDetailsOneOf, type SummaryOptions, type TableCellData, type TableData, Target, type TargetWithLiterals, type TemplateSearchConfiguration, TextAlignment, type TextAlignmentWithLiterals, type TextData, type TextNodeStyle, type TextStyle, type Theme, type ThemeOptions, type Thumbnails, ThumbnailsAlignment, type ThumbnailsAlignmentWithLiterals, type Tool, type ToolConfigurationOneOf, type ToolUseOptions, Type, type TypeWithLiterals, type Typography, type TypographyTextStyle, type V1Background, type V1BackgroundBackgroundTypeOptionsOneOf, type V1Gradient, type V1GradientGradientTypeOptionsOneOf, type V1Image, VerticalAlignment, VerticalAlignmentAlignment, type VerticalAlignmentAlignmentWithLiterals, type VerticalAlignmentWithLiterals, VerticalPaddingType, type VerticalPaddingTypeWithLiterals, type Video, type VideoData, ViewMode, type ViewModeWithLiterals, ViewRole, type ViewRoleWithLiterals, VoteRole, type VoteRoleWithLiterals, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, Width, WidthType, type WidthTypeWithLiterals, type WidthWithLiterals };