> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thesys.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API Changelog

> View changelogs for each API version of C1.

<Update description="2026-03-31" label="v-20260331">
  <Info>
    Embed model versions:

    * `c1/<provider>/<model-name>/v-20260331`

      For example, `c1/anthropic/claude-sonnet-4.6/v-20260331`

    Minimum SDK version:

    * @thesysai/genui-sdk: `0.9.0`
    * @crayonai/react-ui: `0.9.16`
    * @crayonai/react-core: `0.7.7`
  </Info>

  <Warning>
    Upgrading to `v-20260331` is a **backwards incompatible** change due to a new OpenUI response format and component-level changes.
  </Warning>

  **Existing threads are not affected.** Threads started on `v-20251230` or earlier will continue to function on those versions even if you change the model. The new API version is automatically routed to `v-20251230` for old threads. OpenUI responses are only supported for new threads created with `v-20260331` or later.

  ## OpenUI Support

  C1 now supports the [OpenUI Framework](https://www.openui.com/) - upto 3x faster generations compared to the JSON implementation, with upto 66% less token consumption.

  ## New Components

  This release brings in a whole set of new components. The entire library has also ben shifted to OpenUI CSS from Crayon CSS.
  A full list of all the new components and changes will be documented soon, with guides on CSS migration and generation prompts.

  ## Custom Component Migration

  The custom component declaration, schema declaration, and passing to the API stays the same. The only change is an additional step of passing the
  component schema to the GenUI SDK. Basing the instructions off the [existing guide](/guides/custom-components), the change is as follows:

  ### `v-20260331` version onwards

  Previous version [here](/guides/custom-components). Steps 1, 2, 3 stay the same.

  `zod` moves from version `3` to version `4`, i.e. `zodToJsonSchema` is now `z.toJSONSchema`.

  ```ts src/app/api/chat/route.tsx  theme={null}
  const CUSTOM_COMPONENT_SCHEMAS = {
    FlightList: zodToJsonSchema(FlightListSchema), // [!code --]
    FlightList: z.toJSONSchema(FlightListSchema), // [!code ++]
  };
  ```

  ```ts src/app/page.tsx theme={null}
  import { C1Chat } from "@thesysai/genui-sdk";
  import { FlightList } from "./components";
  // ...

  export default function Home() {
    return (
      <C1Chat
        apiUrl="/api/chat"
        customizeC1={{
          customComponents: { FlightList, ... }, // [!code --]
          customComponents: { // [!code ++]
            FlightList: { // [!code ++]
              component: FlightList, // [!code ++]
              schema: FlightListSchema, // [!code ++]
            }, ... // [!code ++]
          }, // [!code ++]
        }}
      />
    );
  }
  ```
</Update>

<Update description="2026-01-30" label="v-20260130">
  <Info>
    Artifact model version:

    * `c1/artifact/v-20260130`

    Minimum SDK version:

    * @thesysai/genui-sdk: `0.8.3`
    * @crayonai/react-ui: `0.9.16`
  </Info>

  ## New Features

  * **Welcome Screen** - The `C1Chat` component now supports a configurable welcome screen displayed when a thread is empty. You can customize the title, description, and image to greet users when they start a new conversation. See the [`welcomeMessage` prop](/react-reference/c1-chat#props) for details.
  * **Conversation Starters** - The `C1Chat` component now supports conversation starters — clickable prompt buttons shown on the welcome screen to help users quickly begin a conversation with predefined options. Supports both `short` (pill) and `long` (list) variants. See the [`conversationStarters` prop](/react-reference/c1-chat#props) for details.
  * **Artifact Editing** - Users can now edit artifacts inline directly within the chat interface, enabling a more interactive workflow. For setup instructions, see [Editing Artifacts](/guides/artifacts/editing).
  * **Pinch Zoom in Reports** - Reports now support pinch-to-zoom functionality, making it easier to inspect details in generated reports.
  * **New Slide Templates** - Added new slide templates, giving more design options for generated slide presentations. See the full [Slide Templates (v-20260130)](/guides/artifacts/slides/slide-templates/v-20260130) reference for all available templates and parameters.
  * **PPTX Export for Slides** - Slide artifacts can now be exported as `.pptx` files, enabling seamless use in PowerPoint and other presentation tools. See the [Exporting Slides to PPTX](/guides/artifacts/pptx-export) guide for setup instructions.
  * **New Report Blocks** - Added new block types for reports, expanding the variety of content that can be generated within report artifacts.

      <table>
        <tr>
          <td style={{verticalAlign: 'top'}}>
            <Frame>
              <img src="https://mintcdn.com/thesys/IUBQ6AU_RODh0plO/api-reference/changelog-assets/v20260130/reports/visualCards.png?fit=max&auto=format&n=IUBQ6AU_RODh0plO&q=85&s=2b1a0dfa293201c4aac10078c0db4476" alt="VisualCards" width="1180" height="1276" data-path="api-reference/changelog-assets/v20260130/reports/visualCards.png" />
            </Frame>
          </td>

          <td style={{verticalAlign: 'top'}}>
            <Frame>
              <img src="https://mintcdn.com/thesys/IUBQ6AU_RODh0plO/api-reference/changelog-assets/v20260130/reports/SummaryGrid.png?fit=max&auto=format&n=IUBQ6AU_RODh0plO&q=85&s=8f74dcc3b6bcc017fa0803db891f6346" alt="SummaryGrid" width="1124" height="1004" data-path="api-reference/changelog-assets/v20260130/reports/SummaryGrid.png" />
            </Frame>
          </td>
        </tr>

        <tr>
          <td style={{verticalAlign: 'top'}}>
            <Frame>
              <img src="https://mintcdn.com/thesys/IUBQ6AU_RODh0plO/api-reference/changelog-assets/v20260130/reports/FeatureHighlight.png?fit=max&auto=format&n=IUBQ6AU_RODh0plO&q=85&s=f4321e1251340106fc5828ec4bb27a76" alt="FeatureHighlight" width="1124" height="806" data-path="api-reference/changelog-assets/v20260130/reports/FeatureHighlight.png" />
            </Frame>
          </td>

          <td style={{verticalAlign: 'top'}}>
            <Frame>
              <img src="https://mintcdn.com/thesys/IUBQ6AU_RODh0plO/api-reference/changelog-assets/v20260130/reports/Table.png?fit=max&auto=format&n=IUBQ6AU_RODh0plO&q=85&s=39d36ec3546a8ec2b571417c95d26a85" alt="Table" width="1140" height="752" data-path="api-reference/changelog-assets/v20260130/reports/Table.png" />
            </Frame>
          </td>
        </tr>

        <tr>
          <td style={{verticalAlign: 'top'}}>
            <Frame>
              <img src="https://mintcdn.com/thesys/IUBQ6AU_RODh0plO/api-reference/changelog-assets/v20260130/reports/NumberedKeyPoint.png?fit=max&auto=format&n=IUBQ6AU_RODh0plO&q=85&s=16ed2123207c651a19e4b0ccd3413209" alt="NumberedKeyPoint" width="1124" height="532" data-path="api-reference/changelog-assets/v20260130/reports/NumberedKeyPoint.png" />
            </Frame>
          </td>

          <td style={{verticalAlign: 'top'}}>
            <Frame>
              <img src="https://mintcdn.com/thesys/IUBQ6AU_RODh0plO/api-reference/changelog-assets/v20260130/reports/KeyMetrics.png?fit=max&auto=format&n=IUBQ6AU_RODh0plO&q=85&s=03771fcdaf48f8b8feddd9278c830e6d" alt="KeyMetrics" width="1180" height="452" data-path="api-reference/changelog-assets/v20260130/reports/KeyMetrics.png" />
            </Frame>
          </td>
        </tr>

        <tr>
          <td style={{verticalAlign: 'top'}}>
            <Frame>
              <img src="https://mintcdn.com/thesys/IUBQ6AU_RODh0plO/api-reference/changelog-assets/v20260130/reports/HeadlineStatement.png?fit=max&auto=format&n=IUBQ6AU_RODh0plO&q=85&s=5a3bbef7f4daf53dd52b36837cdbe3a8" alt="HeadlineStatement" width="1140" height="584" data-path="api-reference/changelog-assets/v20260130/reports/HeadlineStatement.png" />
            </Frame>
          </td>

          <td style={{verticalAlign: 'top'}}>
            <Frame>
              <img src="https://mintcdn.com/thesys/IUBQ6AU_RODh0plO/api-reference/changelog-assets/v20260130/reports/HeroMetric.png?fit=max&auto=format&n=IUBQ6AU_RODh0plO&q=85&s=91f03e5268f88502aa22c1170a90ebe6" alt="HeroMetric" width="1124" height="196" data-path="api-reference/changelog-assets/v20260130/reports/HeroMetric.png" />
            </Frame>
          </td>
        </tr>
      </table>
</Update>

<Update description="2025-12-30" label="v-20251230">
  <Info>
    Stable embed model versions:

    * `c1/anthropic/claude-sonnet-4/v-20251230`
    * `c1/openai/gpt-5.2/v-20251230`
    * `c1/openai/gpt-5/v-20251230`

    Experimental embed model versions:

    * `c1-exp/anthropic/claude-sonnet-4.5/v-20251230`
    * `c1-exp/anthropic/claude-haiku-4.5/v-20251230`

    Visualise model version:

    * `c1/anthropic/claude-sonnet-4/v-20251230`

    Artifact model version:

    * `c1/artifact/v-20251230`

    Minimum SDK version:

    * @crayonai/react-ui: `0.9.9`
    * @thesysai/genui-sdk: `0.7.15`
  </Info>

  ## New Model Support

  C1 now supports `Claude Sonnet 4.5` and `Claude Haiku 4.5` models. These are enabled via the C1 API as **experimental** models. Production use of these models is not encouraged.

  ## New Features

  * **Tray Widget Form Factor** - The `C1Chat` component now supports a new `bottom-tray` form factor for tray widget layouts. This enables a variety of use cases, including widget-based chatbot interactions and minimizable chat interfaces.
      <div className="my-4">
        <Frame>
          <img src="https://mintcdn.com/thesys/ysk53Hh614vO7owa/api-reference/changelog-assets/v20251230/bottom-tray-widget-c1-chat.png?fit=max&auto=format&n=ysk53Hh614vO7owa&q=85&s=0f7910c935a284a0061844391a66ddae" alt="Tag variants example 2" width="2264" height="1910" data-path="api-reference/changelog-assets/v20251230/bottom-tray-widget-c1-chat.png" />
        </Frame>
      </div>
  * **Mermaid Diagram Generation** - C1 now supports generating mermaid diagrams. This is **not** enabled by default. To use mermaid generation, users should enter a supporting system prompt:
    ```
    You can generate mermaid diagram code in TextContent.

    <example generations as needed>
    <further mermaid guidance instructions>
    ```
  * **Enhanced Components**
    * **Tag variants** - C1 tags now support standard color variants: `neutral`, `info`, `success`, `warning`, `danger`. These variants can be used to suppliment semantic information with colors, and can optionally be guided via system prompts.

        <div className="my-4">
          <Frame>
            <img src="https://mintcdn.com/thesys/ysk53Hh614vO7owa/api-reference/changelog-assets/v20251230/standalone-tag-variants.png?fit=max&auto=format&n=ysk53Hh614vO7owa&q=85&s=33197af9cd799773a9e6e3d59826bc88" alt="Tag variants example" width="744" height="140" data-path="api-reference/changelog-assets/v20251230/standalone-tag-variants.png" />
          </Frame>
        </div>

        <div className="my-4">
          <Frame>
            <img src="https://mintcdn.com/thesys/ysk53Hh614vO7owa/api-reference/changelog-assets/v20251230/table-tag-variants.png?fit=max&auto=format&n=ysk53Hh614vO7owa&q=85&s=dcd2175f40c6c7ba986a70964585c1d1" alt="Tag variants example 2" width="1748" height="680" data-path="api-reference/changelog-assets/v20251230/table-tag-variants.png" />
          </Frame>
        </div>

        <div className="my-4">
          <Frame>
            <img src="https://mintcdn.com/thesys/ysk53Hh614vO7owa/api-reference/changelog-assets/v20251230/carousel-tag-variants.png?fit=max&auto=format&n=ysk53Hh614vO7owa&q=85&s=cb9b6d93e2e28c8e5167d7a21fb6b96c" alt="Tag variants example 2" width="1756" height="404" data-path="api-reference/changelog-assets/v20251230/carousel-tag-variants.png" />
          </Frame>
        </div>

        <div className="my-4">
          <Frame>
            <img src="https://mintcdn.com/thesys/ysk53Hh614vO7owa/api-reference/changelog-assets/v20251230/minicard-tag-variants.png?fit=max&auto=format&n=ysk53Hh614vO7owa&q=85&s=0fad6ff8fc6e74ed0342a47660581f15" alt="Tag variants example 2" width="1754" height="870" data-path="api-reference/changelog-assets/v20251230/minicard-tag-variants.png" />
          </Frame>
        </div>

    * **Image improvements** - We improved the way images are displayed, especially in wide layouts. This ensures all images are rendered with balanced aspect ratios.

        <div className="my-4">
          <Frame>
            <img src="https://mintcdn.com/thesys/ysk53Hh614vO7owa/api-reference/changelog-assets/v20251230/image-block.png?fit=max&auto=format&n=ysk53Hh614vO7owa&q=85&s=ecc496ee425d1187b7d055202be07e88" alt="Tag variants example 2" width="1744" height="894" data-path="api-reference/changelog-assets/v20251230/image-block.png" />
          </Frame>
        </div>

    * **C1 Artifact icon generation** - We have significantly improved our icon generation process. Embed models already support this, and support has been extended to the C1 Artifact model as well.
</Update>

<Update description="2025-11-30" label="v-20251130">
  <Info>
    Model versions:

    * `c1/anthropic/claude-sonnet-4/v-20251130`
    * `c1/openai/gpt-5/v-20251130`

    Minimum SDK version:

    * @crayonai/react-ui: `0.9.6`
    * @thesysai/genui-sdk: `0.7.5`
  </Info>

  ## New Features

  * **Citations and Source Links** - C1 can now include citations and links to the original sources for the facts and data it presents. This adds credibility to the data and allows the user to verify the information.

      <div className="my-4">
        <Frame>
          <img src="https://mintcdn.com/thesys/FsG-G9ySBkmoE6gu/api-reference/changelog-assets/v20251130/citations_and_source_links.png?fit=max&auto=format&n=FsG-G9ySBkmoE6gu&q=85&s=878bc0ba9375e30a121fbd04fc10f8f1" alt="Citations and Source Links Example" width="1160" height="620" data-path="api-reference/changelog-assets/v20251130/citations_and_source_links.png" />
        </Frame>
      </div>

      <div className="my-4">
        <Frame>
          <img src="https://mintcdn.com/thesys/FsG-G9ySBkmoE6gu/api-reference/changelog-assets/v20251130/citations_and_source_links_2.png?fit=max&auto=format&n=FsG-G9ySBkmoE6gu&q=85&s=115a55676512a2593160ba12b99a7f86" alt="Citations and Source Links Example 2" width="1802" height="810" data-path="api-reference/changelog-assets/v20251130/citations_and_source_links_2.png" />
        </Frame>
      </div>

  * **Enhanced Interactivity**
    * **Action Column for Tables** - C1 can now generate a dedicated action column in tables, with buttons and actions that are specific to each row. This makes it easier than ever for users to act on data directly where they see it, from viewing details to deleting an entry.
        <div className="my-4">
          <Frame>
            <img src="https://mintcdn.com/thesys/FsG-G9ySBkmoE6gu/api-reference/changelog-assets/v20251130/table_action_column.png?fit=max&auto=format&n=FsG-G9ySBkmoE6gu&q=85&s=fca4c36c9c8046c34b2d2f1869ead923" alt="Action Column for Tables Example" width="1814" height="952" data-path="api-reference/changelog-assets/v20251130/table_action_column.png" />
          </Frame>
        </div>
    * **Expanded Support for Actions** - C1 can now attach continue conversation, custom actions and open\_url actions to Icon Buttons and List Items. This provides more design flexibility to place actions in more intuitive, contextual locations within your UI.
        <div className="my-4">
          <Frame>
            <img src="https://mintcdn.com/thesys/VDRnVlFlQYSb9SlY/api-reference/changelog-assets/v20251130/clickable_list.png?fit=max&auto=format&n=VDRnVlFlQYSb9SlY&q=85&s=c6424febf6912ae67115b2eed9d0a2e8" alt="List with Actions" width="1876" height="1032" data-path="api-reference/changelog-assets/v20251130/clickable_list.png" />
          </Frame>
        </div>
    * **Carousel Footer for Actions** - Carousel items can now have a footer for action buttons. The buttons are aligned across the bottom of the carousel item.
        <div className="my-4">
          <Frame>
            <img src="https://mintcdn.com/thesys/FsG-G9ySBkmoE6gu/api-reference/changelog-assets/v20251130/carousel_footer_for_actions.png?fit=max&auto=format&n=FsG-G9ySBkmoE6gu&q=85&s=0e285b2c6ff50717cdf0e0d2ea250788" alt="Carousel Footer for Actions Example" width="1824" height="1152" data-path="api-reference/changelog-assets/v20251130/carousel_footer_for_actions.png" />
          </Frame>
        </div>
    * **'Explore' Button** - C1 can now add an optional "explore" button next to choices in checkboxes, radio groups, and switches. This allows a user to click for more information about a specific option, perfect for complex forms or when choices require more explanation.
        <div className="my-4">
          <Frame>
            <img src="https://mintcdn.com/thesys/FsG-G9ySBkmoE6gu/api-reference/changelog-assets/v20251130/explore_button.png?fit=max&auto=format&n=FsG-G9ySBkmoE6gu&q=85&s=0af743abef859deea33f96a947733fe7" alt="Explore Button Example" width="916" height="720" data-path="api-reference/changelog-assets/v20251130/explore_button.png" />
          </Frame>
        </div>
        <Note>
          Not included by default, but can be added by using the `c1_included_components` metadata.
        </Note>
      ```ts theme={null}
        const runToolResponse = openAIClient.chat.completions.runTools({
          // ... other options
          metadata: {
            thesys: JSON.stringify({
              c1_included_components: ["ExploreButton"],
            }),
          },
        });
      ```

  * **New Chart Type: Donut Chart** - We have added Donut Chart to the library of charts in C1. This is a variant of the Pie Chart that is displayed as a donut shape.
      <div className="my-4">
        <Frame>
          <img src="https://mintcdn.com/thesys/FsG-G9ySBkmoE6gu/api-reference/changelog-assets/v20251130/donut_chart.png?fit=max&auto=format&n=FsG-G9ySBkmoE6gu&q=85&s=09a2289f0c3c7cd45f5a4b44df90dbb6" alt="Donut Chart Example" width="1760" height="768" data-path="api-reference/changelog-assets/v20251130/donut_chart.png" />
        </Frame>
      </div>

  * **New: Condensed Charts** - Perfect for dashboards and tight spaces, C1 can now generate condensed versions of Bar, Area, and Line charts. These minimalist charts are designed to convey trends and data at a glance without taking up too much screen real estate.
      <div className="my-4">
        <Frame>
          <img src="https://mintcdn.com/thesys/FsG-G9ySBkmoE6gu/api-reference/changelog-assets/v20251130/condensed_charts.png?fit=max&auto=format&n=FsG-G9ySBkmoE6gu&q=85&s=634130ebe01a749a9a959ba045b7ee3a" alt="Condensed Charts Example" width="1760" height="1130" data-path="api-reference/changelog-assets/v20251130/condensed_charts.png" />
        </Frame>
      </div>

  * **Smarter Icon Generation** : We've significantly improved our icon generation logic to be more reliable. This fix completely eliminates cases of missing icons in the UI.
</Update>

<Update description="2025-09-30" label="v-20250930">
  <Info>
    Model versions:

    * `c1/anthropic/claude-sonnet-4/v-20250930`
    * `c1/openai/gpt-5/v-20250930`

    Minimum SDK version:

    * @crayonai/react-ui: `0.8.41`
    * @thesysai/genui-sdk: `0.6.40`
  </Info>

  ## New Features

  * **Custom Actions** - We now allow C1 users to define custom actions that can be triggered from the C1 UI.
    For more details and examples, refer to [Custom Actions](/guides/custom-actions).

  * **New Components** - We have added the following new components:

    * **Single stacked bar chart** - A horizontal bar chart that represents a whole divided into proportional segments. Each segment (or “slice”) corresponds to a specific category and visually depicts its percentage contribution to the total.

      <Frame>
        <img src="https://mintcdn.com/thesys/bSSRAssuNTWrT-4Y/api-reference/changelog-assets/v20250930/single_stacked_barchart.png?fit=max&auto=format&n=bSSRAssuNTWrT-4Y&q=85&s=3f735592e3d6d439a97afe5e23b54c58" alt="Single stacked bar chart Example" width="1732" height="516" data-path="api-reference/changelog-assets/v20250930/single_stacked_barchart.png" />
      </Frame>

    * **Scatter chart** - A chart that plots data points to show the relationship between two variables. It helps identify trends, correlations, and outliers in the data.

      <Frame>
        <img src="https://mintcdn.com/thesys/bSSRAssuNTWrT-4Y/api-reference/changelog-assets/v20250930/scatter_chart.png?fit=max&auto=format&n=bSSRAssuNTWrT-4Y&q=85&s=bfa778bf1895b5fd4a082655d1a455d5" alt="Scatter chart Example" width="1658" height="838" data-path="api-reference/changelog-assets/v20250930/scatter_chart.png" />
      </Frame>

  * **Redesigned Component** - We have redesigned the Carousel, Table and Slider components to be more responsive and user-friendly.
</Update>

<Update description="2025-09-15" label="v-20250915">
  <Info>
    Model versions:

    * `c1/anthropic/claude-sonnet-4/v-20250915`
    * `c1/openai/gpt-5/v-20250915`

    Minimum SDK version:

    * @crayonai/react-ui: `0.8.31`
    * @thesysai/genui-sdk: `0.6.34`
  </Info>

  ## New Features

  * **Bring Your Own Components** - We now allow C1 users to provide their own custom React components for generation as a part of the C1 API and GenUI SDK.
    For more details and examples, refer to [Custom Components](/guides/custom-components).
  * **New Stable Models** - With `v-20250915` we are introducing GPT-5 as a stable offering.
    Older model strings for GPT-5 experimental (`c1-exp/openai/gpt-5/<version>`) will no longer be maintained, and all new features and bug fixes will now be released for the stable versions.
  * **Foldable Sections** - We updated our sections to now allow foldable sections. The C1 API decides whether to use foldable sections or not at runtime based on the content and length of the section.
      <Frame>
        <img src="https://mintcdn.com/thesys/P25YyEz6iVaBqH6D/api-reference/changelog-assets/v20250915/foldable_sections.png?fit=max&auto=format&n=P25YyEz6iVaBqH6D&q=85&s=b45901911c6f13fa44d9dbfd28cb06da" alt="Callout Example" width="1432" height="1402" data-path="api-reference/changelog-assets/v20250915/foldable_sections.png" />
      </Frame>
  * **Inline Headers** - Components now have an optional inline header, allowing for more context to be given with the response.
      <Frame>
        <img src="https://mintcdn.com/thesys/P25YyEz6iVaBqH6D/api-reference/changelog-assets/v20250915/inline_headers.png?fit=max&auto=format&n=P25YyEz6iVaBqH6D&q=85&s=69a434456bdf50eb81492433571758ad" alt="Callout Example" width="1536" height="348" data-path="api-reference/changelog-assets/v20250915/inline_headers.png" />
      </Frame>

  ## Bug Fixes / Improvements

  * Form inputs are now disabled until the assistant response is fully generated.
  * Improved component usage of `c1/anthropic/claude-sonnet-4/v-20250915` and `c1/openai/gpt-5/v-20250915`
  * Improved internal error handling of the C1 API
</Update>

<Update description="2025-08-31" label="v-20250831">
  <Info>
    Model versions:

    * `c1/anthropic/claude-sonnet-4/v-20250831`
    * `c1-exp/openai/gpt-5/v-20250831`

    Minimum SDK version:

    * @crayonai/react-ui:"0.8.27"
    * @thesysai/genui-sdk: "0.6.32"
  </Info>

  ## New Features

  * **Editable Table** - Added support for an inline multi edit component that allows changing multiple records at once.
    Not included by default, but can be added by using the `c1_included_components` metadata.
      <Frame>
        <img src="https://mintcdn.com/thesys/P21MB7gTbBhA4W6L/api-reference/changelog-assets/v20250831/editable_table.png?fit=max&auto=format&n=P21MB7gTbBhA4W6L&q=85&s=646b5232fe096699f8bee324c80e5bb4" alt="Editable Table Example" width="1674" height="890" data-path="api-reference/changelog-assets/v20250831/editable_table.png" />
      </Frame>
    ```ts {3-6} [expandable] theme={null}
    const runToolResponse = openAIClient.chat.completions.runTools({
      // ... other options
      metadata: {
        thesys: JSON.stringify({
          c1_included_components: ["EditableTable"],
        }),
      },
    });
    ```
  * **Improved List** - We refined the list component by removing unclear interactive behavior, improving
    visual clarity, and adding support for multiple types: images, icons, and numbers.
      <Frame>
        <img src="https://mintcdn.com/thesys/P21MB7gTbBhA4W6L/api-reference/changelog-assets/v20250831/lists.png?fit=max&auto=format&n=P21MB7gTbBhA4W6L&q=85&s=499d829cd318da370a8636b09aff7b38" alt="List Example" width="1084" height="1434" data-path="api-reference/changelog-assets/v20250831/lists.png" />
      </Frame>
  * **Improved Callout** - We updated the callout visually to feel more contextual and natural specifically
    within conversation-based interfaces, improving clarity and highlighting key information more effectively.
      <Frame>
        <img src="https://mintcdn.com/thesys/P21MB7gTbBhA4W6L/api-reference/changelog-assets/v20250831/callouts.png?fit=max&auto=format&n=P21MB7gTbBhA4W6L&q=85&s=1a7631930ad4e39028382d42253517ca" alt="Callout Example" width="1690" height="1036" data-path="api-reference/changelog-assets/v20250831/callouts.png" />
      </Frame>
  * **Form validations** - Generated forms can optionally have validation rules applied to them.
      <Frame>
        <img src="https://mintcdn.com/thesys/P21MB7gTbBhA4W6L/api-reference/changelog-assets/v20250831/form_validations.png?fit=max&auto=format&n=P21MB7gTbBhA4W6L&q=85&s=073f611081093ef43000d9dca31382a3" alt="Form Example" width="1636" height="1460" data-path="api-reference/changelog-assets/v20250831/form_validations.png" />
      </Frame>
  * **Improved Error Handling** - SDK now allows passing an `onError` prop to the `C1Component` to handle errors.
    ```tsx {3-5} [expandable] theme={null}
    import { C1Component } from "@thesysai/genui-sdk";
    ...
    <C1Component onError={({code: number, c1Response: string}) => {
      console.error(`Generated UI error: ${code}, ${c1Response}`);
    }} />
    ```

  ## Bug Fixes / Improvements

  * Improved carousel responsiveness to adjust for different screen sizes.

  <Warning>Deprecation Notice: From this version onwards Anthropic Sonnet 3.5 and Sonnet 3.7 will not be supported since Anthropic has announced EOL for these models and actively suggests using Sonnet 4 instead.</Warning>
</Update>

<Update description="2025-08-15" label="v-20250815">
  ***

  <Info>
    Model versions:

    * `c1/anthropic/claude-sonnet-4/v-20250815`
    * `c1/anthropic/claude-3.7-sonnet/v-20250815`
    * `c1/anthropic/claude-3.5-sonnet/v-20250815`
  </Info>

  ## UI

  * Added support for advance layouting options
      <Frame>
        <img src="https://mintcdn.com/thesys/C1mGp0p_ygBsZ7UI/api-reference/changelog-assets/layout-update.png?fit=max&auto=format&n=C1mGp0p_ygBsZ7UI&q=85&s=99c085e4f0bb3e21f1ae84e5c2e69597" alt="Layout Example" width="1609" height="551" data-path="api-reference/changelog-assets/layout-update.png" />
      </Frame>
  * Added new mini-card component
      <Frame>
        <img src="https://mintcdn.com/thesys/C1mGp0p_ygBsZ7UI/api-reference/changelog-assets/mini-cards-update.png?fit=max&auto=format&n=C1mGp0p_ygBsZ7UI&q=85&s=439534c28f39400605d7d26e505e7d38" alt="Mini-card Example" width="1609" height="748" data-path="api-reference/changelog-assets/mini-cards-update.png" />
      </Frame>
  * Advanced layouting options can be disabled by using metadata. Pass `c1_excluded_components` in the metadata to exclude the component. This might be useful
    if you are building a copilot or width-constrained agent.
    ```ts focus={3-7} theme={null}
    const runToolResponse = openAIClient.chat.completions.runTools({
      // ... other options
      metadata: {
        thesys: JSON.stringify({
          c1_excluded_components: ["Layout"],
        }),
      },
    });
    ```
  * Added optional description for switch, radio and checkbox components - this is helpful for explaining each option to the user before they make a choice.
      <img src="https://mintcdn.com/thesys/C1mGp0p_ygBsZ7UI/api-reference/changelog-assets/option-description-update.png?fit=max&auto=format&n=C1mGp0p_ygBsZ7UI&q=85&s=004dccf19474048d82148cf071619198" alt="Options Description Example" width="1300" height="852" data-path="api-reference/changelog-assets/option-description-update.png" />

  ## Bug Fixes / Improvements

  * Fixed a bug where carousels appeared visually cluttered.

  ***
</Update>

<Update description="2025-07-09" label="v-20250709">
  ***

  <Info>
    Model versions:

    * `c1/anthropic/claude-3.5-sonnet/v-20250709`
  </Info>

  * Added new 'Section' and 'Horizontal Stacked Bar Chart' components
  * Updated graph schema to significantly reduce token usage
  * Various fixes:
    * Improved KaTeX rendering in markdown
    * Fixed chart issues with negative and very large numbers
    * Corrected Y-axis label display in charts
    * Fixed datepicker value saving and submission

  ***
</Update>