@wix/auto_sdk_rich-content_ricos-conversations 1.0.2 → 1.0.4

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,150 @@ 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;
 }
 /**
- * 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,6 +2379,263 @@ interface ImageBorder {
      */
     color?: string | null;
 }
+/** 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;
+    /**
+     * Unique identifier for this conversation session.
+     * @format GUID
+     */
+    conversationId?: string | null;
+}
+/**
+ * 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 continuing an existing conversation with streaming response delivery */
 interface ContinueConversationStreamedRequest {
     /** The conversation context including the current document state and message history. */
@@ -2676,6 +2678,8 @@ interface CreateRicosConversationResponse {
     progress?: ProgressOptions[];
     /** List of suggestion entries produced during processing */
     suggestions?: SuggestionOptions[];
+    /** Theme */
+    theme?: ThemeOptions;
 }
 /** Request message for listing RichContent document suggestions */
 interface ListConversationSuggestionsRequest {