// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

import { APIResource } from '../../core/resource';
import * as AgentsAPI from '../agents/agents';
import * as MessagesAPI from './messages';
import {
  CompactionRequest,
  CompactionResponse,
  MessageCompactParams,
  MessageCreateParams,
  MessageListParams,
  MessageStreamParams,
  MessageStreamResponse,
  Messages,
} from './messages';
import { APIPromise } from '../../core/api-promise';
import { RequestOptions } from '../../internal/request-options';
import { path } from '../../internal/utils/path';

export class Conversations extends APIResource {
  messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);

  /**
   * Create a new conversation for an agent.
   */
  create(params: ConversationCreateParams, options?: RequestOptions): APIPromise<Conversation> {
    const { agent_id, ...body } = params;
    return this._client.post('/v1/conversations/', { query: { agent_id }, body, ...options });
  }

  /**
   * Retrieve a specific conversation.
   */
  retrieve(conversationID: string, options?: RequestOptions): APIPromise<Conversation> {
    return this._client.get(path`/v1/conversations/${conversationID}`, options);
  }

  /**
   * Update a conversation.
   */
  update(
    conversationID: string,
    body: ConversationUpdateParams,
    options?: RequestOptions,
  ): APIPromise<Conversation> {
    return this._client.patch(path`/v1/conversations/${conversationID}`, { body, ...options });
  }

  /**
   * List all conversations for an agent (or all conversations if agent_id not
   * provided).
   */
  list(
    query: ConversationListParams | null | undefined = {},
    options?: RequestOptions,
  ): APIPromise<ConversationListResponse> {
    return this._client.get('/v1/conversations/', { query, ...options });
  }

  /**
   * Delete a conversation.
   *
   * The conversation will no longer appear in list operations.
   */
  delete(conversationID: string, options?: RequestOptions): APIPromise<unknown> {
    return this._client.delete(path`/v1/conversations/${conversationID}`, options);
  }

  /**
   * Cancel runs associated with a conversation.
   *
   * Note: To cancel active runs, Redis is required.
   *
   * **Agent-direct mode**: Pass conversation_id="default" with agent_id query
   * parameter to cancel runs for the agent's default conversation.
   *
   * **Deprecated**: Passing an agent ID as conversation_id still works but will be
   * removed.
   */
  cancel(
    conversationID: string,
    params: ConversationCancelParams | null | undefined = {},
    options?: RequestOptions,
  ): APIPromise<ConversationCancelResponse> {
    const { agent_id } = params ?? {};
    return this._client.post(path`/v1/conversations/${conversationID}/cancel`, {
      query: { agent_id },
      ...options,
    });
  }

  /**
   * Fork an existing conversation.
   *
   * Creates a new conversation that shares the same in-context messages as the
   * source conversation, but with a newly compiled system message reflecting the
   * latest memory block values. The forked conversation belongs to the same agent as
   * the source.
   *
   * If message_id is provided, only source in-context messages up to and including
   * that message are included in the fork.
   *
   * **Agent-direct mode**: Pass conversation_id="default" with agent_id query
   * parameter to fork the agent's default (agent-direct) message history into a new
   * conversation.
   *
   * **Deprecated**: Passing an agent ID as conversation_id still works but will be
   * removed.
   */
  fork(
    conversationID: string,
    params: ConversationForkParams | null | undefined = {},
    options?: RequestOptions,
  ): APIPromise<Conversation> {
    const { agent_id, hidden, message_id } = params ?? {};
    return this._client.post(path`/v1/conversations/${conversationID}/fork`, {
      query: { agent_id, hidden, message_id },
      ...options,
    });
  }

  /**
   * Manually trigger system prompt recompilation for a conversation.
   */
  recompile(
    conversationID: string,
    params: ConversationRecompileParams | null | undefined = {},
    options?: RequestOptions,
  ): APIPromise<string> {
    const { dry_run, ...body } = params ?? {};
    return this._client.post(path`/v1/conversations/${conversationID}/recompile`, {
      query: { dry_run },
      body,
      ...options,
    });
  }
}

/**
 * Represents a conversation on an agent for concurrent messaging.
 */
export interface Conversation {
  /**
   * The unique identifier of the conversation.
   */
  id: string;

  /**
   * The ID of the agent this conversation belongs to.
   */
  agent_id: string;

  /**
   * Whether the conversation is archived.
   */
  archived?: boolean;

  /**
   * Timestamp of when the conversation was archived.
   */
  archived_at?: string | null;

  /**
   * The context window limit for this conversation (overrides agent's context
   * window).
   */
  context_window_limit?: number | null;

  /**
   * The timestamp when the object was created.
   */
  created_at?: string | null;

  /**
   * The id of the user that made this object.
   */
  created_by_id?: string | null;

  /**
   * A generated description of the conversation used for search and bootstrap
   * context.
   */
  description?: string | null;

  /**
   * The IDs of in-context messages for the conversation. Null means this field was
   * not retrieved/hydrated for this response.
   */
  in_context_message_ids?: Array<string> | null;

  /**
   * Timestamp of the most recent message request sent to this conversation.
   */
  last_message_at?: string | null;

  /**
   * The id of the user that made this object.
   */
  last_updated_by_id?: string | null;

  /**
   * The model handle for this conversation (overrides agent's model). Format:
   * provider/model-name.
   */
  model?: string | null;

  /**
   * The model settings for this conversation (overrides agent's model settings).
   */
  model_settings?:
    | AgentsAPI.OpenAIModelSettings
    | Conversation.SgLangModelSettings
    | AgentsAPI.AnthropicModelSettings
    | AgentsAPI.GoogleAIModelSettings
    | AgentsAPI.GoogleVertexModelSettings
    | AgentsAPI.AzureModelSettings
    | AgentsAPI.XaiModelSettings
    | Conversation.MoonshotModelSettings
    | Conversation.ZaiModelSettings
    | Conversation.MoonshotCodingModelSettings
    | AgentsAPI.GroqModelSettings
    | AgentsAPI.DeepseekModelSettings
    | AgentsAPI.TogetherModelSettings
    | AgentsAPI.BedrockModelSettings
    | Conversation.BasetenModelSettings
    | Conversation.OpenRouterModelSettings
    | Conversation.ChatGptoAuthModelSettings
    | null;

  /**
   * A summary of the conversation.
   */
  summary?: string | null;

  /**
   * The timestamp when the object was last updated.
   */
  updated_at?: string | null;
}

export namespace Conversation {
  /**
   * SGLang model configuration (OpenAI-compatible runtime with SGLang-specific
   * parsing).
   */
  export interface SgLangModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'sglang';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: SgLangModelSettings.Reasoning;

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * SGLang tool call parser name (for example 'glm47', 'qwen25', or 'hermes').
     */
    tool_call_parser?: string | null;
  }

  export namespace SgLangModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort to use when generating text reasoning models
       */
      reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }

  /**
   * Moonshot/Kimi model configuration (OpenAI-compatible).
   */
  export interface MoonshotModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
   */
  export interface ZaiModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'zai';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    thinking?: ZaiModelSettings.Thinking;
  }

  export namespace ZaiModelSettings {
    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    export interface Thinking {
      /**
       * If False, preserved thinking is used (recommended for agents).
       */
      clear_thinking?: boolean;

      /**
       * Whether thinking is enabled or disabled.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Kimi Code model configuration (Anthropic-compatible).
   */
  export interface MoonshotCodingModelSettings {
    /**
     * Effort level for supported Anthropic models (controls token spending). 'xhigh'
     * and 'max' are available on Opus 4.6+. Not setting this gives similar performance
     * to 'high'.
     */
    effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;

    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot_coding';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for the model.
     */
    thinking?: MoonshotCodingModelSettings.Thinking;

    /**
     * Soft control for how verbose model output should be, used for GPT-5 models.
     */
    verbosity?: 'low' | 'medium' | 'high' | null;
  }

  export namespace MoonshotCodingModelSettings {
    /**
     * The thinking configuration for the model.
     */
    export interface Thinking {
      /**
       * The maximum number of tokens the model can use for extended thinking.
       */
      budget_tokens?: number;

      /**
       * The type of thinking to use.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Baseten model configuration (OpenAI-compatible).
   */
  export interface BasetenModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'baseten';

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * OpenRouter model configuration (OpenAI-compatible).
   */
  export interface OpenRouterModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'openrouter';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * ChatGPT OAuth model configuration (uses ChatGPT backend API).
   */
  export interface ChatGptoAuthModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'chatgpt_oauth';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: ChatGptoAuthModelSettings.Reasoning;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  export namespace ChatGptoAuthModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort level for GPT-5.x and o-series models.
       */
      reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }
}

/**
 * Request model for creating a new conversation.
 */
export interface CreateConversation {
  /**
   * The context window limit for this conversation (overrides agent's context
   * window).
   */
  context_window_limit?: number | null;

  /**
   * A generated description of the conversation used for search and bootstrap
   * context.
   */
  description?: string | null;

  /**
   * Whether the new conversation should be hidden from listings.
   */
  hidden?: boolean;

  /**
   * The model handle for this conversation (overrides agent's model). Format:
   * provider/model-name.
   */
  model?: string | null;

  /**
   * The model settings for this conversation (overrides agent's model settings).
   */
  model_settings?:
    | AgentsAPI.OpenAIModelSettings
    | CreateConversation.SgLangModelSettings
    | AgentsAPI.AnthropicModelSettings
    | AgentsAPI.GoogleAIModelSettings
    | AgentsAPI.GoogleVertexModelSettings
    | AgentsAPI.AzureModelSettings
    | AgentsAPI.XaiModelSettings
    | CreateConversation.MoonshotModelSettings
    | CreateConversation.ZaiModelSettings
    | CreateConversation.MoonshotCodingModelSettings
    | AgentsAPI.GroqModelSettings
    | AgentsAPI.DeepseekModelSettings
    | AgentsAPI.TogetherModelSettings
    | AgentsAPI.BedrockModelSettings
    | CreateConversation.BasetenModelSettings
    | CreateConversation.OpenRouterModelSettings
    | CreateConversation.ChatGptoAuthModelSettings
    | null;

  /**
   * A summary of the conversation.
   */
  summary?: string | null;
}

export namespace CreateConversation {
  /**
   * SGLang model configuration (OpenAI-compatible runtime with SGLang-specific
   * parsing).
   */
  export interface SgLangModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'sglang';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: SgLangModelSettings.Reasoning;

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * SGLang tool call parser name (for example 'glm47', 'qwen25', or 'hermes').
     */
    tool_call_parser?: string | null;
  }

  export namespace SgLangModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort to use when generating text reasoning models
       */
      reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }

  /**
   * Moonshot/Kimi model configuration (OpenAI-compatible).
   */
  export interface MoonshotModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
   */
  export interface ZaiModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'zai';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    thinking?: ZaiModelSettings.Thinking;
  }

  export namespace ZaiModelSettings {
    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    export interface Thinking {
      /**
       * If False, preserved thinking is used (recommended for agents).
       */
      clear_thinking?: boolean;

      /**
       * Whether thinking is enabled or disabled.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Kimi Code model configuration (Anthropic-compatible).
   */
  export interface MoonshotCodingModelSettings {
    /**
     * Effort level for supported Anthropic models (controls token spending). 'xhigh'
     * and 'max' are available on Opus 4.6+. Not setting this gives similar performance
     * to 'high'.
     */
    effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;

    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot_coding';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for the model.
     */
    thinking?: MoonshotCodingModelSettings.Thinking;

    /**
     * Soft control for how verbose model output should be, used for GPT-5 models.
     */
    verbosity?: 'low' | 'medium' | 'high' | null;
  }

  export namespace MoonshotCodingModelSettings {
    /**
     * The thinking configuration for the model.
     */
    export interface Thinking {
      /**
       * The maximum number of tokens the model can use for extended thinking.
       */
      budget_tokens?: number;

      /**
       * The type of thinking to use.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Baseten model configuration (OpenAI-compatible).
   */
  export interface BasetenModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'baseten';

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * OpenRouter model configuration (OpenAI-compatible).
   */
  export interface OpenRouterModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'openrouter';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * ChatGPT OAuth model configuration (uses ChatGPT backend API).
   */
  export interface ChatGptoAuthModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'chatgpt_oauth';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: ChatGptoAuthModelSettings.Reasoning;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  export namespace ChatGptoAuthModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort level for GPT-5.x and o-series models.
       */
      reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }
}

/**
 * Request model for updating a conversation.
 */
export interface UpdateConversation {
  /**
   * Whether the conversation is archived.
   */
  archived?: boolean | null;

  /**
   * The context window limit for this conversation (overrides agent's context
   * window).
   */
  context_window_limit?: number | null;

  /**
   * A generated description of the conversation used for search and bootstrap
   * context.
   */
  description?: string | null;

  /**
   * Timestamp of the most recent message request sent to this conversation.
   */
  last_message_at?: string | null;

  /**
   * The model handle for this conversation (overrides agent's model). Format:
   * provider/model-name.
   */
  model?: string | null;

  /**
   * The model settings for this conversation (overrides agent's model settings).
   */
  model_settings?:
    | AgentsAPI.OpenAIModelSettings
    | UpdateConversation.SgLangModelSettings
    | AgentsAPI.AnthropicModelSettings
    | AgentsAPI.GoogleAIModelSettings
    | AgentsAPI.GoogleVertexModelSettings
    | AgentsAPI.AzureModelSettings
    | AgentsAPI.XaiModelSettings
    | UpdateConversation.MoonshotModelSettings
    | UpdateConversation.ZaiModelSettings
    | UpdateConversation.MoonshotCodingModelSettings
    | AgentsAPI.GroqModelSettings
    | AgentsAPI.DeepseekModelSettings
    | AgentsAPI.TogetherModelSettings
    | AgentsAPI.BedrockModelSettings
    | UpdateConversation.BasetenModelSettings
    | UpdateConversation.OpenRouterModelSettings
    | UpdateConversation.ChatGptoAuthModelSettings
    | null;

  /**
   * A summary of the conversation.
   */
  summary?: string | null;
}

export namespace UpdateConversation {
  /**
   * SGLang model configuration (OpenAI-compatible runtime with SGLang-specific
   * parsing).
   */
  export interface SgLangModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'sglang';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: SgLangModelSettings.Reasoning;

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * SGLang tool call parser name (for example 'glm47', 'qwen25', or 'hermes').
     */
    tool_call_parser?: string | null;
  }

  export namespace SgLangModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort to use when generating text reasoning models
       */
      reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }

  /**
   * Moonshot/Kimi model configuration (OpenAI-compatible).
   */
  export interface MoonshotModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
   */
  export interface ZaiModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'zai';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    thinking?: ZaiModelSettings.Thinking;
  }

  export namespace ZaiModelSettings {
    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    export interface Thinking {
      /**
       * If False, preserved thinking is used (recommended for agents).
       */
      clear_thinking?: boolean;

      /**
       * Whether thinking is enabled or disabled.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Kimi Code model configuration (Anthropic-compatible).
   */
  export interface MoonshotCodingModelSettings {
    /**
     * Effort level for supported Anthropic models (controls token spending). 'xhigh'
     * and 'max' are available on Opus 4.6+. Not setting this gives similar performance
     * to 'high'.
     */
    effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;

    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot_coding';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for the model.
     */
    thinking?: MoonshotCodingModelSettings.Thinking;

    /**
     * Soft control for how verbose model output should be, used for GPT-5 models.
     */
    verbosity?: 'low' | 'medium' | 'high' | null;
  }

  export namespace MoonshotCodingModelSettings {
    /**
     * The thinking configuration for the model.
     */
    export interface Thinking {
      /**
       * The maximum number of tokens the model can use for extended thinking.
       */
      budget_tokens?: number;

      /**
       * The type of thinking to use.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Baseten model configuration (OpenAI-compatible).
   */
  export interface BasetenModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'baseten';

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * OpenRouter model configuration (OpenAI-compatible).
   */
  export interface OpenRouterModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'openrouter';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * ChatGPT OAuth model configuration (uses ChatGPT backend API).
   */
  export interface ChatGptoAuthModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'chatgpt_oauth';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: ChatGptoAuthModelSettings.Reasoning;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  export namespace ChatGptoAuthModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort level for GPT-5.x and o-series models.
       */
      reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }
}

export type ConversationListResponse = Array<Conversation>;

export type ConversationDeleteResponse = unknown;

export type ConversationCancelResponse = { [key: string]: unknown };

export type ConversationRecompileResponse = string;

export interface ConversationCreateParams {
  /**
   * Query param: The agent ID to create a conversation for
   */
  agent_id: string;

  /**
   * Body param: The context window limit for this conversation (overrides agent's
   * context window).
   */
  context_window_limit?: number | null;

  /**
   * Body param: A generated description of the conversation used for search and
   * bootstrap context.
   */
  description?: string | null;

  /**
   * Body param: Whether the new conversation should be hidden from listings.
   */
  hidden?: boolean;

  /**
   * Body param: The model handle for this conversation (overrides agent's model).
   * Format: provider/model-name.
   */
  model?: string | null;

  /**
   * Body param: The model settings for this conversation (overrides agent's model
   * settings).
   */
  model_settings?:
    | AgentsAPI.OpenAIModelSettings
    | ConversationCreateParams.SgLangModelSettings
    | AgentsAPI.AnthropicModelSettings
    | AgentsAPI.GoogleAIModelSettings
    | AgentsAPI.GoogleVertexModelSettings
    | AgentsAPI.AzureModelSettings
    | AgentsAPI.XaiModelSettings
    | ConversationCreateParams.MoonshotModelSettings
    | ConversationCreateParams.ZaiModelSettings
    | ConversationCreateParams.MoonshotCodingModelSettings
    | AgentsAPI.GroqModelSettings
    | AgentsAPI.DeepseekModelSettings
    | AgentsAPI.TogetherModelSettings
    | AgentsAPI.BedrockModelSettings
    | ConversationCreateParams.BasetenModelSettings
    | ConversationCreateParams.OpenRouterModelSettings
    | ConversationCreateParams.ChatGptoAuthModelSettings
    | null;

  /**
   * Body param: A summary of the conversation.
   */
  summary?: string | null;
}

export namespace ConversationCreateParams {
  /**
   * SGLang model configuration (OpenAI-compatible runtime with SGLang-specific
   * parsing).
   */
  export interface SgLangModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'sglang';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: SgLangModelSettings.Reasoning;

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * SGLang tool call parser name (for example 'glm47', 'qwen25', or 'hermes').
     */
    tool_call_parser?: string | null;
  }

  export namespace SgLangModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort to use when generating text reasoning models
       */
      reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }

  /**
   * Moonshot/Kimi model configuration (OpenAI-compatible).
   */
  export interface MoonshotModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
   */
  export interface ZaiModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'zai';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    thinking?: ZaiModelSettings.Thinking;
  }

  export namespace ZaiModelSettings {
    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    export interface Thinking {
      /**
       * If False, preserved thinking is used (recommended for agents).
       */
      clear_thinking?: boolean;

      /**
       * Whether thinking is enabled or disabled.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Kimi Code model configuration (Anthropic-compatible).
   */
  export interface MoonshotCodingModelSettings {
    /**
     * Effort level for supported Anthropic models (controls token spending). 'xhigh'
     * and 'max' are available on Opus 4.6+. Not setting this gives similar performance
     * to 'high'.
     */
    effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;

    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot_coding';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for the model.
     */
    thinking?: MoonshotCodingModelSettings.Thinking;

    /**
     * Soft control for how verbose model output should be, used for GPT-5 models.
     */
    verbosity?: 'low' | 'medium' | 'high' | null;
  }

  export namespace MoonshotCodingModelSettings {
    /**
     * The thinking configuration for the model.
     */
    export interface Thinking {
      /**
       * The maximum number of tokens the model can use for extended thinking.
       */
      budget_tokens?: number;

      /**
       * The type of thinking to use.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Baseten model configuration (OpenAI-compatible).
   */
  export interface BasetenModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'baseten';

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * OpenRouter model configuration (OpenAI-compatible).
   */
  export interface OpenRouterModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'openrouter';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * ChatGPT OAuth model configuration (uses ChatGPT backend API).
   */
  export interface ChatGptoAuthModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'chatgpt_oauth';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: ChatGptoAuthModelSettings.Reasoning;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  export namespace ChatGptoAuthModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort level for GPT-5.x and o-series models.
       */
      reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }
}

export interface ConversationUpdateParams {
  /**
   * Whether the conversation is archived.
   */
  archived?: boolean | null;

  /**
   * The context window limit for this conversation (overrides agent's context
   * window).
   */
  context_window_limit?: number | null;

  /**
   * A generated description of the conversation used for search and bootstrap
   * context.
   */
  description?: string | null;

  /**
   * Timestamp of the most recent message request sent to this conversation.
   */
  last_message_at?: string | null;

  /**
   * The model handle for this conversation (overrides agent's model). Format:
   * provider/model-name.
   */
  model?: string | null;

  /**
   * The model settings for this conversation (overrides agent's model settings).
   */
  model_settings?:
    | AgentsAPI.OpenAIModelSettings
    | ConversationUpdateParams.SgLangModelSettings
    | AgentsAPI.AnthropicModelSettings
    | AgentsAPI.GoogleAIModelSettings
    | AgentsAPI.GoogleVertexModelSettings
    | AgentsAPI.AzureModelSettings
    | AgentsAPI.XaiModelSettings
    | ConversationUpdateParams.MoonshotModelSettings
    | ConversationUpdateParams.ZaiModelSettings
    | ConversationUpdateParams.MoonshotCodingModelSettings
    | AgentsAPI.GroqModelSettings
    | AgentsAPI.DeepseekModelSettings
    | AgentsAPI.TogetherModelSettings
    | AgentsAPI.BedrockModelSettings
    | ConversationUpdateParams.BasetenModelSettings
    | ConversationUpdateParams.OpenRouterModelSettings
    | ConversationUpdateParams.ChatGptoAuthModelSettings
    | null;

  /**
   * A summary of the conversation.
   */
  summary?: string | null;
}

export namespace ConversationUpdateParams {
  /**
   * SGLang model configuration (OpenAI-compatible runtime with SGLang-specific
   * parsing).
   */
  export interface SgLangModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'sglang';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: SgLangModelSettings.Reasoning;

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * SGLang tool call parser name (for example 'glm47', 'qwen25', or 'hermes').
     */
    tool_call_parser?: string | null;
  }

  export namespace SgLangModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort to use when generating text reasoning models
       */
      reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }

  /**
   * Moonshot/Kimi model configuration (OpenAI-compatible).
   */
  export interface MoonshotModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
   */
  export interface ZaiModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'zai';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    thinking?: ZaiModelSettings.Thinking;
  }

  export namespace ZaiModelSettings {
    /**
     * The thinking configuration for GLM-4.5+ models.
     */
    export interface Thinking {
      /**
       * If False, preserved thinking is used (recommended for agents).
       */
      clear_thinking?: boolean;

      /**
       * Whether thinking is enabled or disabled.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Kimi Code model configuration (Anthropic-compatible).
   */
  export interface MoonshotCodingModelSettings {
    /**
     * Effort level for supported Anthropic models (controls token spending). 'xhigh'
     * and 'max' are available on Opus 4.6+. Not setting this gives similar performance
     * to 'high'.
     */
    effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;

    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'moonshot_coding';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
     * match JSON schemas.
     */
    strict?: boolean;

    /**
     * The temperature of the model.
     */
    temperature?: number;

    /**
     * The thinking configuration for the model.
     */
    thinking?: MoonshotCodingModelSettings.Thinking;

    /**
     * Soft control for how verbose model output should be, used for GPT-5 models.
     */
    verbosity?: 'low' | 'medium' | 'high' | null;
  }

  export namespace MoonshotCodingModelSettings {
    /**
     * The thinking configuration for the model.
     */
    export interface Thinking {
      /**
       * The maximum number of tokens the model can use for extended thinking.
       */
      budget_tokens?: number;

      /**
       * The type of thinking to use.
       */
      type?: 'enabled' | 'disabled';
    }
  }

  /**
   * Baseten model configuration (OpenAI-compatible).
   */
  export interface BasetenModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'baseten';

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * OpenRouter model configuration (OpenAI-compatible).
   */
  export interface OpenRouterModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'openrouter';

    /**
     * The response format for the model.
     */
    response_format?:
      | AgentsAPI.TextResponseFormat
      | AgentsAPI.JsonSchemaResponseFormat
      | AgentsAPI.JsonObjectResponseFormat
      | null;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  /**
   * ChatGPT OAuth model configuration (uses ChatGPT backend API).
   */
  export interface ChatGptoAuthModelSettings {
    /**
     * The maximum number of tokens the model can generate.
     */
    max_output_tokens?: number;

    /**
     * Whether to enable parallel tool calling.
     */
    parallel_tool_calls?: boolean;

    /**
     * The type of the provider.
     */
    provider_type?: 'chatgpt_oauth';

    /**
     * The reasoning configuration for the model.
     */
    reasoning?: ChatGptoAuthModelSettings.Reasoning;

    /**
     * The temperature of the model.
     */
    temperature?: number;
  }

  export namespace ChatGptoAuthModelSettings {
    /**
     * The reasoning configuration for the model.
     */
    export interface Reasoning {
      /**
       * The reasoning effort level for GPT-5.x and o-series models.
       */
      reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
    }
  }
}

export interface ConversationListParams {
  /**
   * Cursor for pagination (conv ID). Returns results relative to this ID in the
   * specified sort order. Expected format: 'conv-<uuid4>'
   */
  after?: string | null;

  /**
   * The agent ID to list conversations for (optional - returns all conversations if
   * not provided)
   */
  agent_id?: string | null;

  /**
   * Whether to return unarchived conversations only, archived conversations only, or
   * all conversations
   */
  archive_status?: 'unarchived' | 'archived' | 'all';

  /**
   * Maximum number of conversations to return
   */
  limit?: number;

  /**
   * Sort order for conversations. 'asc' for oldest first, 'desc' for newest first
   */
  order?: 'asc' | 'desc';

  /**
   * Field to sort by
   */
  order_by?: 'created_at' | 'last_run_completion' | 'last_message_at';

  /**
   * Search for text within conversation summaries
   */
  summary_search?: string | null;
}

export interface ConversationCancelParams {
  /**
   * Agent ID for agent-direct mode with 'default' conversation
   */
  agent_id?: string | null;
}

export interface ConversationForkParams {
  /**
   * Agent ID for agent-direct mode with 'default' conversation
   */
  agent_id?: string | null;

  /**
   * Whether the forked conversation should be hidden from listings
   */
  hidden?: boolean;

  /**
   * The ID of the message in the format 'message-<uuid4>'
   */
  message_id?: string | null;
}

export interface ConversationRecompileParams {
  /**
   * Query param: If True, do not persist changes; still returns the compiled system
   * prompt.
   */
  dry_run?: boolean;

  /**
   * Body param: Agent ID for agent-direct mode with 'default' conversation. Use with
   * conversation_id='default' in the URL path.
   */
  agent_id?: string | null;

  /**
   * Body param: Configuration for conversation compaction / summarization.
   *
   * Per-model settings (temperature, max tokens, etc.) are derived from the default
   * configuration for that handle.
   */
  compaction_settings?: ConversationRecompileParams.CompactionSettings | null;
}

export namespace ConversationRecompileParams {
  /**
   * Configuration for conversation compaction / summarization.
   *
   * Per-model settings (temperature, max tokens, etc.) are derived from the default
   * configuration for that handle.
   */
  export interface CompactionSettings {
    /**
     * The maximum length of the summary in characters. If none, no clipping is
     * performed.
     */
    clip_chars?: number | null;

    /**
     * The type of summarization technique use.
     */
    mode?: 'all' | 'sliding_window' | 'self_compact_all' | 'self_compact_sliding_window';

    /**
     * Model handle to use for sliding_window/all summarization (format:
     * provider/model-name). If None, uses lightweight provider-specific defaults.
     */
    model?: string | null;

    /**
     * Optional model settings used to override defaults for the summarizer model.
     */
    model_settings?:
      | AgentsAPI.OpenAIModelSettings
      | CompactionSettings.SgLangModelSettings
      | AgentsAPI.AnthropicModelSettings
      | AgentsAPI.GoogleAIModelSettings
      | AgentsAPI.GoogleVertexModelSettings
      | AgentsAPI.AzureModelSettings
      | AgentsAPI.XaiModelSettings
      | CompactionSettings.MoonshotModelSettings
      | CompactionSettings.ZaiModelSettings
      | CompactionSettings.MoonshotCodingModelSettings
      | AgentsAPI.GroqModelSettings
      | AgentsAPI.DeepseekModelSettings
      | AgentsAPI.TogetherModelSettings
      | AgentsAPI.BedrockModelSettings
      | CompactionSettings.BasetenModelSettings
      | CompactionSettings.OpenRouterModelSettings
      | CompactionSettings.ChatGptoAuthModelSettings
      | null;

    /**
     * The prompt to use for summarization. If None, uses mode-specific default.
     */
    prompt?: string | null;

    /**
     * Whether to include an acknowledgement post-prompt (helps prevent non-summary
     * outputs).
     */
    prompt_acknowledgement?: boolean;

    /**
     * The percentage of the context window to keep post-summarization (only used in
     * sliding window modes).
     */
    sliding_window_percentage?: number;
  }

  export namespace CompactionSettings {
    /**
     * SGLang model configuration (OpenAI-compatible runtime with SGLang-specific
     * parsing).
     */
    export interface SgLangModelSettings {
      /**
       * The maximum number of tokens the model can generate.
       */
      max_output_tokens?: number;

      /**
       * Whether to enable parallel tool calling.
       */
      parallel_tool_calls?: boolean;

      /**
       * The type of the provider.
       */
      provider_type?: 'sglang';

      /**
       * The reasoning configuration for the model.
       */
      reasoning?: SgLangModelSettings.Reasoning;

      /**
       * The response format for the model.
       */
      response_format?:
        | AgentsAPI.TextResponseFormat
        | AgentsAPI.JsonSchemaResponseFormat
        | AgentsAPI.JsonObjectResponseFormat
        | null;

      /**
       * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
       * match JSON schemas.
       */
      strict?: boolean;

      /**
       * The temperature of the model.
       */
      temperature?: number;

      /**
       * SGLang tool call parser name (for example 'glm47', 'qwen25', or 'hermes').
       */
      tool_call_parser?: string | null;
    }

    export namespace SgLangModelSettings {
      /**
       * The reasoning configuration for the model.
       */
      export interface Reasoning {
        /**
         * The reasoning effort to use when generating text reasoning models
         */
        reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
      }
    }

    /**
     * Moonshot/Kimi model configuration (OpenAI-compatible).
     */
    export interface MoonshotModelSettings {
      /**
       * The maximum number of tokens the model can generate.
       */
      max_output_tokens?: number;

      /**
       * Whether to enable parallel tool calling.
       */
      parallel_tool_calls?: boolean;

      /**
       * The type of the provider.
       */
      provider_type?: 'moonshot';

      /**
       * The response format for the model.
       */
      response_format?:
        | AgentsAPI.TextResponseFormat
        | AgentsAPI.JsonSchemaResponseFormat
        | AgentsAPI.JsonObjectResponseFormat
        | null;

      /**
       * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
       * match JSON schemas.
       */
      strict?: boolean;

      /**
       * The temperature of the model.
       */
      temperature?: number;
    }

    /**
     * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
     */
    export interface ZaiModelSettings {
      /**
       * The maximum number of tokens the model can generate.
       */
      max_output_tokens?: number;

      /**
       * Whether to enable parallel tool calling.
       */
      parallel_tool_calls?: boolean;

      /**
       * The type of the provider.
       */
      provider_type?: 'zai';

      /**
       * The response format for the model.
       */
      response_format?:
        | AgentsAPI.TextResponseFormat
        | AgentsAPI.JsonSchemaResponseFormat
        | AgentsAPI.JsonObjectResponseFormat
        | null;

      /**
       * The temperature of the model.
       */
      temperature?: number;

      /**
       * The thinking configuration for GLM-4.5+ models.
       */
      thinking?: ZaiModelSettings.Thinking;
    }

    export namespace ZaiModelSettings {
      /**
       * The thinking configuration for GLM-4.5+ models.
       */
      export interface Thinking {
        /**
         * If False, preserved thinking is used (recommended for agents).
         */
        clear_thinking?: boolean;

        /**
         * Whether thinking is enabled or disabled.
         */
        type?: 'enabled' | 'disabled';
      }
    }

    /**
     * Kimi Code model configuration (Anthropic-compatible).
     */
    export interface MoonshotCodingModelSettings {
      /**
       * Effort level for supported Anthropic models (controls token spending). 'xhigh'
       * and 'max' are available on Opus 4.6+. Not setting this gives similar performance
       * to 'high'.
       */
      effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;

      /**
       * The maximum number of tokens the model can generate.
       */
      max_output_tokens?: number;

      /**
       * Whether to enable parallel tool calling.
       */
      parallel_tool_calls?: boolean;

      /**
       * The type of the provider.
       */
      provider_type?: 'moonshot_coding';

      /**
       * The response format for the model.
       */
      response_format?:
        | AgentsAPI.TextResponseFormat
        | AgentsAPI.JsonSchemaResponseFormat
        | AgentsAPI.JsonObjectResponseFormat
        | null;

      /**
       * Enable strict mode for tool calling. When true, tool outputs are guaranteed to
       * match JSON schemas.
       */
      strict?: boolean;

      /**
       * The temperature of the model.
       */
      temperature?: number;

      /**
       * The thinking configuration for the model.
       */
      thinking?: MoonshotCodingModelSettings.Thinking;

      /**
       * Soft control for how verbose model output should be, used for GPT-5 models.
       */
      verbosity?: 'low' | 'medium' | 'high' | null;
    }

    export namespace MoonshotCodingModelSettings {
      /**
       * The thinking configuration for the model.
       */
      export interface Thinking {
        /**
         * The maximum number of tokens the model can use for extended thinking.
         */
        budget_tokens?: number;

        /**
         * The type of thinking to use.
         */
        type?: 'enabled' | 'disabled';
      }
    }

    /**
     * Baseten model configuration (OpenAI-compatible).
     */
    export interface BasetenModelSettings {
      /**
       * The maximum number of tokens the model can generate.
       */
      max_output_tokens?: number;

      /**
       * Whether to enable parallel tool calling.
       */
      parallel_tool_calls?: boolean;

      /**
       * The type of the provider.
       */
      provider_type?: 'baseten';

      /**
       * The temperature of the model.
       */
      temperature?: number;
    }

    /**
     * OpenRouter model configuration (OpenAI-compatible).
     */
    export interface OpenRouterModelSettings {
      /**
       * The maximum number of tokens the model can generate.
       */
      max_output_tokens?: number;

      /**
       * Whether to enable parallel tool calling.
       */
      parallel_tool_calls?: boolean;

      /**
       * The type of the provider.
       */
      provider_type?: 'openrouter';

      /**
       * The response format for the model.
       */
      response_format?:
        | AgentsAPI.TextResponseFormat
        | AgentsAPI.JsonSchemaResponseFormat
        | AgentsAPI.JsonObjectResponseFormat
        | null;

      /**
       * The temperature of the model.
       */
      temperature?: number;
    }

    /**
     * ChatGPT OAuth model configuration (uses ChatGPT backend API).
     */
    export interface ChatGptoAuthModelSettings {
      /**
       * The maximum number of tokens the model can generate.
       */
      max_output_tokens?: number;

      /**
       * Whether to enable parallel tool calling.
       */
      parallel_tool_calls?: boolean;

      /**
       * The type of the provider.
       */
      provider_type?: 'chatgpt_oauth';

      /**
       * The reasoning configuration for the model.
       */
      reasoning?: ChatGptoAuthModelSettings.Reasoning;

      /**
       * The temperature of the model.
       */
      temperature?: number;
    }

    export namespace ChatGptoAuthModelSettings {
      /**
       * The reasoning configuration for the model.
       */
      export interface Reasoning {
        /**
         * The reasoning effort level for GPT-5.x and o-series models.
         */
        reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
      }
    }
  }
}

Conversations.Messages = Messages;

export declare namespace Conversations {
  export {
    type Conversation as Conversation,
    type CreateConversation as CreateConversation,
    type UpdateConversation as UpdateConversation,
    type ConversationListResponse as ConversationListResponse,
    type ConversationDeleteResponse as ConversationDeleteResponse,
    type ConversationCancelResponse as ConversationCancelResponse,
    type ConversationRecompileResponse as ConversationRecompileResponse,
    type ConversationCreateParams as ConversationCreateParams,
    type ConversationUpdateParams as ConversationUpdateParams,
    type ConversationListParams as ConversationListParams,
    type ConversationCancelParams as ConversationCancelParams,
    type ConversationForkParams as ConversationForkParams,
    type ConversationRecompileParams as ConversationRecompileParams,
  };

  export {
    Messages as Messages,
    type CompactionRequest as CompactionRequest,
    type CompactionResponse as CompactionResponse,
    type MessageStreamResponse as MessageStreamResponse,
    type MessageCreateParams as MessageCreateParams,
    type MessageListParams as MessageListParams,
    type MessageCompactParams as MessageCompactParams,
    type MessageStreamParams as MessageStreamParams,
  };
}