@stack-spot/portal-network 1.0.0-dev.1768422812092 → 1.0.0-dev.1768423147036

package/src/api/agent-tools.ts

@@ -175,15 +175,18 @@ export type AgentUsingToolsResponse = {
     name: string;
     avatar?: string | null;
 };
-export type AssignCustomToolsAgentRequest = {
-    toolkit_id: string;
-    tools_ids: string[];
+export type Function = {
+    name: string;
+    description: string;
+    parameters: {
+        [key: string]: any;
+    };
+    strict?: boolean;
 };
-export type AssignToolsToAgentRequest = {
-    builtin_tool_ids?: string[] | null;
-    custom_tools?: AssignCustomToolsAgentRequest[] | null;
-    sub_agents_ids?: string[] | null;
-    mcp_toolkit_ids?: string[] | null;
+export type McpToolFunction = {
+    "type"?: string | null;
+    "function"?: Function | null;
+    id?: string | null;
 };
 export type ToolkitMcpResponse = {
     id?: string | null;
@@ -195,11 +198,20 @@ export type ToolkitMcpResponse = {
     secrets?: string[] | null;
     url?: string | null;
     toolkit_type?: ToolkitType | null;
+    tools?: McpToolFunction[] | null;
+};
+export type MultiAgentToolkitResponse = {
+    id: string;
+    agent_version_number: number | null;
+    avatar: string | null;
+    name: string;
+    description: string;
 };
 export type AgentToolsResponse = {
     builtin_toolkits?: BuiltinToolkitResponse[];
     custom_toolkits?: CustomToolkitResponse[];
     mcp_toolkits?: ToolkitMcpResponse[];
+    multi_agent_toolkits?: MultiAgentToolkitResponse[];
 };
 export type SchemaEnum = "OPENAI";
 export type FunctionParameter = {
@@ -218,7 +230,7 @@ export type FunctionParameter = {
     /** Allow arbitrary data of specific typed */
     additionalProperties?: boolean;
 };
-export type Function = {
+export type Function2 = {
     /** The name of the function */
     name: string;
     /** A description of what the function does */
@@ -234,7 +246,7 @@ export type OpenAiTool = {
     /** The type of the tool; must be 'function' */
     "type": "function";
     /** The function associated with this tool */
-    "function": Function;
+    "function": Function2;
 };
 export type ExecuteAgentToolRequest = {
     arguments?: string | null;
@@ -252,6 +264,7 @@ export type KnowledgeSourcesConfig = {
     similarity_function?: string;
     post_processing?: boolean;
 };
+export type AgentVersionStatus = "draft" | "published" | "deprecated";
 export type ListAgentResponse = {
     id: string;
     name: string;
@@ -262,6 +275,9 @@ export type ListAgentResponse = {
     avatar: string | null;
     suggested_prompts: string[] | null;
     knowledge_sources_config: KnowledgeSourcesConfig;
+    version_number: number;
+    status: AgentVersionStatus;
+    is_recommended: boolean;
     has_multiagent_tool?: boolean;
     "type"?: string;
     system_prompt?: string;
@@ -277,6 +293,10 @@ export type KnowledgeSourcesConfigRequest = {
     knowledge_sources?: string[] | null;
     sealed?: boolean | null;
 };
+export type AssignCustomToolsAgentRequest = {
+    toolkit_id: string;
+    tools_ids: string[];
+};
 export type AgentMode = "autonomous" | "plan_approval" | "plan_and_critical_approval";
 export type AgentMemory = "vector" | "buffer";
 export type PlannerType = "simple" | "tool_oriented";
@@ -304,6 +324,7 @@ export type NewAgentRequest = {
     /** Custom tools to assign to the agent */
     custom_tools?: AssignCustomToolsAgentRequest[] | null;
     mcp_toolkit_ids?: string[] | null;
+    /** Multi-agents assignment to the agent */
     sub_agents_ids?: string[] | null;
     detail_mode?: boolean;
     structured_output?: string | null;
@@ -320,13 +341,21 @@ export type NewAgentRequest = {
     planner_type?: PlannerType | null;
     /** Maximum number of LLM interactions allowed for the agent when using simple planner */
     max_llm_interactions?: number | null;
+    /** LLM planner model name */
+    planner_model_name?: string | null;
+    /** LLM planner model id */
+    planner_model_id?: string | null;
 };
 export type SearchAgentsRequest = {
     /** Agent ids to filter for */
     ids: string[];
 };
+export type AssignMultiAgentVersionRequest = {
+    agent_core_id: string;
+    version_number?: number | null;
+};
 export type WorkspaceForkRequest = {
-    agent_ids: string[];
+    agents: AssignMultiAgentVersionRequest[];
     member_id: string;
 };
 export type AgentItemFork = {
@@ -366,7 +395,7 @@ export type ListMultiAgentsResponse = {
     visibility_level: VisibilityLevelEnum;
     has_multiagent_tool: boolean;
 };
-export type KnowledgeSourceDetails = {
+export type KnowledgeSourceDetailsResponse = {
     id: string;
     slug: string;
     name: string;
@@ -374,139 +403,103 @@ export type KnowledgeSourceDetails = {
     "type": string;
     creator?: string | null;
     "default": boolean;
-    visibility_level: VisibilityLevelEnum;
+    visibility_level: string;
     model_name: string;
     username?: string | null;
 };
-export type KnowledgeSourceConfigModel = {
-    similarity_function: SimilarityFunctionEnum;
+export type KnowledgeSourcesConfigResponse = {
+    knowledge_sources: string[];
     max_number_of_kos: number;
     relevancy_threshold: number;
+    similarity_function: string;
     post_processing: boolean;
-    knowledge_sources: string[];
-    knowledge_sources_details: KnowledgeSourceDetails[];
     sealed: boolean;
+    knowledge_sources_details?: KnowledgeSourceDetailsResponse[] | null;
     created_by?: string | null;
     created_at?: string | null;
     updated_by?: string | null;
     updated_at?: string | null;
 };
-export type BuiltinToolDto = {
-    id: string;
-    name: string;
-    description: string;
-    toolkit_id: string;
+export type LlmSettingsResponse = {
+    property_key: string;
+    property_value: string;
+    property_type: string;
 };
-export type BuiltinToolkitDto = {
-    id: string;
-    name: string;
-    description: string;
-    image_url: string;
-    tools: BuiltinToolDto[];
-};
-export type CustomToolkitToolDto = {
-    id: string;
-    name: string;
-    description: string;
-    method: string;
-    url: string;
-    parameters?: {
-        [key: string]: any;
-    }[] | null;
-    request_body?: {
-        [key: string]: any;
-    } | null;
-    response_transformation?: string | null;
-    creator_name?: string | null;
-};
-export type CustomToolkitDto = {
-    id: string;
-    name: string;
-    description: string | null;
-    avatar: string | null;
-    tools: CustomToolkitToolDto[];
-    secrets: string[] | null;
-    visibility_level: VisibilityLevelEnum;
-    creator_name: string;
-    is_usable_by_others: boolean;
-    url: string | null;
-    toolkit_type: ToolkitType | null;
-};
-export type SecretScope = "ACCOUNT" | "SCOPED" | "SPOT" | "USER" | "UNKNOWN";
-export type SecretDto = {
-    id: string;
-    scope?: SecretScope | null;
-};
-export type Function2 = {
-    name: string;
-    description: string;
-    parameters: {
-        [key: string]: any;
-    };
-    strict?: boolean;
-};
-export type ToolkitMcpdto = {
-    secrets: SecretDto[] | null;
-    name: string;
-    description?: string | null;
-    avatar?: string | null;
-    visibility_level?: VisibilityLevelEnum;
-    id?: string | null;
-    url?: string | null;
-    tools?: Function2[] | null;
-    /** Toolkit type */
-    toolkit_type?: ToolkitType | null;
-};
-export type AgentToolsDto = {
-    builtin_toolkits?: BuiltinToolkitDto[];
-    custom_toolkits?: CustomToolkitDto[];
-    mcp_toolkits?: ToolkitMcpdto[];
-};
-export type LlmSettingsModel = {
-    property_key?: string | null;
-    property_value?: string | null;
-    property_type?: string | null;
-    agent_id: string;
-    created_by?: string | null;
-    created_at?: string | null;
-    updated_by?: string | null;
-    updated_at?: string | null;
-};
-export type AgentLlmModelDto = {
+export type AgentLlmModelResponse = {
     model_id: string;
     model_name: string;
-    is_default?: boolean;
+    is_default: boolean;
 };
-export type AgentModel = {
+export type FindByIdAgentResponse = {
+    /** Agent core ID */
     id: string;
+    /** Agent name */
     name: string;
+    /** Agent unique slug */
     slug: string;
+    /** Agent description */
     description?: string | null;
-    system_prompt: string;
-    visibility_level: string;
+    /** Agent avatar image URL */
     avatar?: string | null;
+    /** Agent visibility level */
+    visibility_level: string;
+    /** Agent type */
     "type": string;
-    conversation_starter?: string[] | null;
+    /** Whether agent is use-only (hides implementation) */
     use_only: boolean;
+    /** Whether agent is internal */
+    is_internal: boolean;
+    /** Whether detail mode is enabled */
     detail_mode: boolean;
+    /** Agent execution mode */
     mode: AgentMode;
-    structured_output?: {
-        [key: string]: any;
-    } | null;
+    /** Agent memory type */
+    memory: AgentMemory;
+    /** Version status */
+    status: AgentVersionStatus;
+    /** Version number */
+    version_number: number;
+    /** Whether this is the recommended version */
+    is_recommended: boolean;
+    /** Whether this is the latest version */
+    is_latest: boolean;
+    /** System prompt for the agent */
+    system_prompt?: string | null;
+    /** Default LLM model ID */
     model_id?: string | null;
+    /** Default LLM model name */
     model_name?: string | null;
-    knowledge_sources_config?: KnowledgeSourceConfigModel | null;
-    toolkits?: AgentToolsDto | null;
-    settings?: LlmSettingsModel[];
-    is_sub_agent?: boolean | null;
+    /** Original agent ID if forked */
+    origin_fork_id?: string | null;
+    /** Suggested conversation starters */
+    conversation_starter?: string[] | null;
+    /** JSON schema for structured output */
+    structured_output?: string | null;
+    /** Base version ID for version history */
+    base_version_id?: string | null;
+    planner_type?: PlannerType | null;
+    /** Maximum number of LLM interactions */
+    max_llm_interactions?: number | null;
+    /** Default LLM planner model ID */
+    planner_model_id?: string | null;
+    /** Default LLM planner model name */
+    planner_model_name?: string | null;
+    /** Knowledge sources configuration with details */
+    knowledge_sources_config?: KnowledgeSourcesConfigResponse | null;
+    /** Agent toolkits (builtin and custom) */
+    toolkits?: AgentToolsResponse;
+    /** LLM settings */
+    settings?: LlmSettingsResponse[];
+    /** Available LLM models for this agent */
+    available_llm_models?: AgentLlmModelResponse[];
+    /** Creator username */
     created_by?: string | null;
+    /** Creation timestamp */
     created_at?: string | null;
+    /** Last updater username */
     updated_by?: string | null;
+    /** Last update timestamp */
     updated_at?: string | null;
-    available_llm_models?: AgentLlmModelDto[];
-    memory?: AgentMemory;
-    planner_type?: PlannerType | null;
-    max_llm_interactions?: number | null;
 };
 export type UpdateAgentRequest = {
     use_only?: boolean | null;
@@ -524,12 +517,15 @@ export type UpdateAgentRequest = {
     avatar?: string | null;
     /** Agent suggested prompt */
     suggested_prompts?: string[];
+    /** agent status */
+    status?: AgentVersionStatus | null;
     /** System prompt */
     system_prompt?: string | null;
     /** Agent type */
     "type"?: AgentType | null;
     knowledge_sources_config?: KnowledgeSourcesConfigRequest | null;
     builtin_tools_ids?: string[];
+    /** Multi-agents assignment to the agent */
     sub_agents_ids?: string[];
     /** Custom tools to assign to the agent */
     custom_tools?: AssignCustomToolsAgentRequest[] | null;
@@ -549,6 +545,10 @@ export type UpdateAgentRequest = {
     planner_type?: PlannerType;
     /** Maximum number of LLM interactions allowed for the agent when using simple planner */
     max_llm_interactions?: number | null;
+    /** LLM planner model name */
+    planner_model_name?: string | null;
+    /** LLM planner model id */
+    planner_model_id?: string | null;
 };
 export type ForkAgentRequest = {
     /** Agent slug to fork */
@@ -558,6 +558,144 @@ export type ForkAgentRequest = {
 export type PublishAgentRequest = {
     use_only?: boolean;
     is_public?: boolean;
+    version_number?: number | null;
+};
+export type CreateVersionRequest = {
+    /** The version number to use as base for the new version. If not provided, uses latest version */
+    base_version_number?: number | null;
+};
+export type AgentVersionResponse = {
+    /** Agent version unique identifier */
+    id: string;
+    /** Reference to parent agent core */
+    agent_core_id: string;
+    /** Whether detail mode is enabled for responses */
+    detail_mode: boolean;
+    /** Whether version is internal-only */
+    is_internal: boolean;
+    /** Agent execution mode (autonomous, orchestrator, etc.) */
+    mode: AgentMode;
+    /** Memory type used by the agent */
+    memory: string;
+    /** Version status (draft, published, archived) */
+    status: AgentVersionStatus;
+    /** Sequential version number */
+    version_number: number;
+    /** Whether this is the recommended version for use */
+    is_recommended: boolean;
+    /** Whether this is the most recent version */
+    is_latest: boolean;
+    /** Base version ID used for creating this version */
+    base_version_id?: string | null;
+    /** Original agent version ID if this is a fork */
+    origin_fork_id?: string | null;
+    /** System prompt for the agent version */
+    system_prompt?: string | null;
+    /** LLM model ID used by this version */
+    model_id?: string | null;
+    /** LLM model name used by this version */
+    model_name?: string | null;
+    /** Suggested conversation starters */
+    conversation_starter?: string[] | null;
+    /** JSON schema for structured output format */
+    structured_output?: string | null;
+    planner_type?: PlannerType | null;
+    max_llm_interactions?: number | null;
+    /** Default LLM planner model ID */
+    planner_model_id?: string | null;
+    /** Default LLM planner model name */
+    planner_model_name?: string | null;
+    /** Knowledge sources configuration for RAG capabilities */
+    knowledge_sources_config?: KnowledgeSourcesConfig | null;
+    /** List of tools (builtin) assigned to this version */
+    toolkits?: AgentToolsResponse;
+    /** LLM-specific settings for this version */
+    settings?: LlmSettingsResponse[];
+    /** Available LLM models for this version */
+    llm_models?: AgentLlmModelResponse[];
+    /** Username of version creator */
+    created_by?: string | null;
+    /** Version creation timestamp */
+    created_at?: string | null;
+    /** Username of last updater */
+    updated_by?: string | null;
+    /** Last update timestamp */
+    updated_at?: string | null;
+};
+export type CreateVersionResponse = {
+    /** Agent core unique identifier */
+    id: string;
+    /** Agent name */
+    name: string;
+    /** Agent unique slug */
+    slug: string;
+    /** Agent description */
+    description?: string | null;
+    /** Agent avatar image URL */
+    avatar?: string | null;
+    /** Agent visibility level (personal, shared, account) */
+    visibility_level: string;
+    /** The newly created agent version details */
+    version: AgentVersionResponse;
+    /** Username of agent creator */
+    created_by?: string | null;
+    /** Agent creation timestamp */
+    created_at?: string | null;
+    /** Username of last updater */
+    updated_by?: string | null;
+    /** Last update timestamp */
+    updated_at?: string | null;
+};
+export type ListAgentVersionResponse = {
+    id: string;
+    version_number: number;
+    status: AgentVersionStatus;
+    is_recommended: boolean;
+};
+export type ForkedAgentCoreAndVersionResponse = {
+    /** Agent core unique identifier */
+    id: string;
+    /** Agent name */
+    name: string;
+    /** Agent unique slug */
+    slug: string;
+    /** Agent description */
+    description: string;
+    /** Agent avatar image URL */
+    avatar?: string | null;
+    /** Agent visibility level (personal, shared, account) */
+    visibility_level: string;
+    /** The newly created agent version details */
+    version: AgentVersionResponse;
+    /** Username of agent creator */
+    created_by?: string | null;
+    /** Agent creation timestamp */
+    created_at?: string | null;
+    /** Username of last updater */
+    updated_by?: string | null;
+    /** Last update timestamp */
+    updated_at?: string | null;
+};
+export type KnowledgeSourceDetailsResponse2 = {
+    id: string;
+    slug: string;
+    name: string;
+    description: string;
+    "type": string;
+    creator?: string | null;
+    "default": boolean;
+    visibility_level: VisibilityLevelEnum;
+    model_name: string;
+    username?: string | null;
+};
+export type KnowledgeSourcesConfigResponse2 = {
+    knowledge_sources: string[];
+    max_number_of_kos?: number;
+    relevancy_threshold?: number;
+    similarity_function?: SimilarityFunctionEnum;
+    post_processing?: boolean;
+    knowledge_sources_details?: KnowledgeSourceDetailsResponse2[];
+    sealed: boolean;
 };
 export type ListAgentResponseV2 = {
     id: string;
@@ -568,13 +706,225 @@ export type ListAgentResponseV2 = {
     visibility_level: string;
     avatar: string | null;
     conversation_starter: string[] | null;
-    knowledge_sources_config: KnowledgeSourcesConfig;
+    knowledge_sources_config: KnowledgeSourcesConfigResponse2;
     "type"?: string;
     system_prompt?: string;
     creator_name?: string;
+    version_number: number;
+    status: AgentVersionStatus;
+    is_recommended: boolean;
+};
+export type NewAgentRequestV2 = {
+    /** LLM model name */
+    model_name?: string | null;
+    /** LLM model id */
+    model_id?: string | null;
+    /** Agent name */
+    name: string;
+    /** Agent unique slug */
+    slug: string;
+    /** Agent description */
+    description?: string | null;
+    /** Agent avatar image */
+    avatar?: string | null;
+    /** Agent suggested prompt */
+    suggested_prompts?: string[];
+    /** System prompt */
+    system_prompt?: string | null;
+    /** Agent type */
+    "type": AgentType;
+    knowledge_sources_config?: KnowledgeSourcesConfigRequest | null;
+    builtin_tools_ids?: string[];
+    /** Custom tools to assign to the agent */
+    custom_tools?: AssignCustomToolsAgentRequest[] | null;
+    /** Multi-agents assignment to the agent */
+    sub_agents_ids?: AssignMultiAgentVersionRequest[] | null;
+    mcp_toolkit_ids?: string[] | null;
+    detail_mode?: boolean;
+    structured_output?: string | null;
+    llm_settings?: {
+        [key: string]: any;
+    } | null;
+    /** Agent mode */
+    mode?: AgentMode;
+    /** Agent memory */
+    memory?: AgentMemory;
+    /** Available models for this particular agent */
+    available_models_ids?: string[];
+    /** Agent planner type */
+    planner_type?: PlannerType | null;
+    /** Maximum number of LLM interactions allowed for the agent when using simple planner */
+    max_llm_interactions?: number | null;
+    /** LLM planner model name */
+    planner_model_name?: string | null;
+    /** LLM planner model id */
+    planner_model_id?: string | null;
+};
+export type SearchAgentVersionRequest = {
+    agent_core_id: string;
+    version_number?: number | null;
+};
+export type SearchAgentsRequestV2 = {
+    agents: SearchAgentVersionRequest[];
+};
+export type UpdateAgentRequestV2 = {
+    use_only?: boolean | null;
+    /** LLM model name */
+    model_name?: string | null;
+    /** LLM model id */
+    model_id?: string | null;
+    /** Agent name */
+    name?: string | null;
+    /** Agent unique slug */
+    slug?: string | null;
+    /** agent status */
+    status?: AgentVersionStatus | null;
+    /** Agent description */
+    description?: string | null;
+    /** Agent avatar image */
+    avatar?: string | null;
+    /** Agent suggested prompt */
+    suggested_prompts?: string[];
+    /** System prompt */
+    system_prompt?: string | null;
+    /** Agent type */
+    "type"?: AgentType | null;
+    knowledge_sources_config?: KnowledgeSourcesConfigRequest | null;
+    builtin_tools_ids?: string[];
+    /** Multi-agents assignment to the agent */
+    sub_agents_ids?: AssignMultiAgentVersionRequest[];
+    /** Custom tools to assign to the agent */
+    custom_tools?: AssignCustomToolsAgentRequest[] | null;
+    mcp_toolkit_ids?: string[] | null;
+    detail_mode?: boolean | null;
+    structured_output?: string | null;
+    llm_settings?: {
+        [key: string]: any;
+    } | null;
+    /** Agent mode */
+    mode?: AgentMode | null;
+    /** Available models for this particular agent */
+    available_models_ids?: string[];
+    /** Agent memory */
+    memory?: AgentMemory;
+    /** Agent planner type */
+    planner_type?: PlannerType;
+    /** Maximum number of LLM interactions allowed for the agent when using simple planner */
+    max_llm_interactions?: number | null;
+    /** LLM planner model name */
+    planner_model_name?: string | null;
+    /** LLM planner model id */
+    planner_model_id?: string | null;
+};
+export type CustomToolkitResponse2 = {
+    id: string;
+    name: string;
+    description?: string | null;
+    avatar?: string | null;
+    visibility_level: string;
+    creator_name: string | null;
+    toolkit_type?: ToolkitType | null;
+    tools: CustomToolkitToolResponse[];
+    secret_id?: string | null;
+    secrets?: string[] | null;
+    is_usable_by_others: boolean;
+    url?: string | null;
+};
+export type AgentToolsResponse2 = {
+    builtin_toolkits?: BuiltinToolkitResponse[];
+    custom_toolkits?: CustomToolkitResponse2[];
+    mcp_toolkits?: ToolkitMcpResponse[];
+    multi_agent_toolkits?: MultiAgentToolkitResponse[];
+};
+export type AgentVersionResponse2 = {
+    /** System prompt for the agent version */
+    system_prompt: string;
+    /** Whether detail mode is enabled for responses */
+    detail_mode: boolean;
+    /** Whether version is internal-only */
+    is_internal: boolean;
+    /** Agent execution mode (autonomous, orchestrator, etc.) */
+    mode: AgentMode;
+    /** Memory type used by the agent */
+    memory: string;
+    /** Version status (draft, published, archived) */
+    status: AgentVersionStatus;
+    /** Sequential version number */
+    version_number: number;
+    /** Whether this is the recommended version for use */
+    is_recommended: boolean;
+    /** Whether this is the most recent version */
+    is_latest: boolean;
+    /** Base version ID used for creating this version */
+    base_version_id?: string | null;
+    /** Original agent version ID if this is a fork */
+    origin_fork_id?: string | null;
+    /** LLM model ID used by this version */
+    model_id?: string | null;
+    /** LLM model name used by this version */
+    model_name?: string | null;
+    /** Suggested conversation starters */
+    conversation_starter?: string[] | null;
+    /** JSON schema for structured output format */
+    structured_output?: string | null;
+    planner_type?: PlannerType | null;
+    /** Maximum number of LLM interactions */
+    max_llm_interactions?: number | null;
+    /** Default LLM planner model ID */
+    planner_model_id?: string | null;
+    /** Default LLM planner model name */
+    planner_model_name?: string | null;
+    /** Knowledge sources configuration for RAG capabilities */
+    knowledge_sources_config?: KnowledgeSourcesConfigResponse2 | null;
+    /** List of tools (builtin) assigned to this version */
+    toolkits?: AgentToolsResponse2;
+    /** LLM-specific settings for this version */
+    settings?: LlmSettingsResponse[];
+    /** Available LLM models for this version */
+    available_llm_models?: AgentLlmModelResponse[];
+    /** Username of version creator */
+    created_by?: string | null;
+    /** Version creation timestamp */
+    created_at?: string | null;
+    /** Username of last updater */
+    updated_by?: string | null;
+    /** Last update timestamp */
+    updated_at?: string | null;
+};
+export type AgentCoreWithSingleVersionResponse = {
+    /** Agent core unique identifier (ULID format) */
+    id: string;
+    /** Agent display name */
+    name: string;
+    /** Agent unique slug for URL-friendly identification */
+    slug: string;
+    /** Agent core type */
+    "type": string;
+    /** Whether agent is use-only (hides implementation) */
+    use_only: boolean;
+    /** Detailed description of the agent's purpose and capabilities */
+    description?: string | null;
+    /** URL or path to agent's avatar image */
+    avatar?: string | null;
+    /** Agent visibility level (PERSONAL, WORKSPACE, ORGANIZATION, PUBLIC) */
+    visibility_level: string;
+    /** Specific or recommend version associated with this agent core */
+    version: AgentVersionResponse2;
+    /** Whether the current user has marked this agent as favorite */
+    is_favorite?: boolean;
+    /** Whether this agent was recently used by the current user */
+    is_recently_used?: boolean;
+    /** Username or identifier of the user who created this agent */
+    created_by?: string | null;
+    /** Timestamp when the agent was created (ISO 8601 format) */
+    created_at?: string | null;
+    /** Username or identifier of the user who last updated this agent */
+    updated_by?: string | null;
+    /** Timestamp of the last update (ISO 8601 format) */
+    updated_at?: string | null;
 };
 export type OrderEnum = "a-to-z" | "z-to-a" | "oldest-first" | "newest-first";
-export type ListAgentRequestV3 = {
+export type ListAgentRequestV4 = {
     /** Agent name to filter the list */
     name?: string | null;
     /** Agent slug to filter the list */
@@ -600,7 +950,7 @@ export type AgentResponseV3 = {
     slug: string;
     created_by: string | null;
     created_at: string | null;
-    visibility_level: string;
+    visibility_level: AgentVisibilityLevelEnum | VisibilityLevelEnum;
     avatar: string | null;
     suggested_prompts: string[] | null;
     knowledge_sources_config: KnowledgeSourcesConfigResponseV3;
@@ -610,11 +960,35 @@ export type AgentResponseV3 = {
     creator_name?: string;
     is_favorite?: boolean;
     is_recently_used?: boolean;
+    version_number: number;
+    status: AgentVersionStatus;
+    is_recommended: boolean;
 };
 export type PaginatedResponseAgentResponseV3 = {
     total_pages: number;
     items: AgentResponseV3[];
 };
+export type ListAgentVersionResponse2 = {
+    version_number: number;
+    status: AgentVersionStatus;
+    is_recommended: boolean;
+};
+export type ListAgentCoreResponse = {
+    id: string;
+    name: string;
+    slug: string;
+    visibility_level: string;
+    avatar: string | null;
+    created_by: string | null;
+    created_at: string | null;
+    is_favorite?: boolean;
+    is_recently_used?: boolean;
+    version: ListAgentVersionResponse2;
+};
+export type PaginatedResponseListAgentCoreResponse = {
+    total_pages: number;
+    items: ListAgentCoreResponse[];
+};
 export type InternalListToolkitsRequest = {
     /** List of toolkit IDs to retrieve */
     toolkit_ids: string[];
@@ -1164,46 +1538,12 @@ export function listAgentsUsingToolsV1ToolkitsToolkitIdToolsAgentsPost({ toolkit
         })
     })));
 }
-/**
- * Assign Tools
- */
-export function assignToolsV1AgentsAgentIdToolsPost({ agentId, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization, assignToolsToAgentRequest }: {
-    agentId: string;
-    isPublic?: boolean;
-    xAccountId?: string | null;
-    xUsername?: string | null;
-    xUserId?: string | null;
-    xUserFullName?: string | null;
-    authorization: string;
-    assignToolsToAgentRequest: AssignToolsToAgentRequest;
-}, opts?: Oazapfts.RequestOpts) {
-    return oazapfts.ok(oazapfts.fetchJson<{
-        status: 204;
-    } | {
-        status: 404;
-    } | {
-        status: 422;
-        data: HttpValidationError;
-    }>(`/v1/agents/${encodeURIComponent(agentId)}/tools${QS.query(QS.explode({
-        is_public: isPublic
-    }))}`, oazapfts.json({
-        ...opts,
-        method: "POST",
-        body: assignToolsToAgentRequest,
-        headers: oazapfts.mergeHeaders(opts?.headers, {
-            "x-account-id": xAccountId,
-            "x-username": xUsername,
-            "x-user-id": xUserId,
-            "x-user-full-name": xUserFullName,
-            authorization
-        })
-    })));
-}
 /**
  * List Tools
  */
-export function listToolsV1AgentsAgentIdToolsGet({ agentId, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+export function listToolsV1AgentsAgentIdToolsGet({ agentId, versionNumber, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
     agentId: string;
+    versionNumber?: number | null;
     isPublic?: boolean;
     xAccountId?: string | null;
     xUsername?: string | null;
@@ -1220,6 +1560,7 @@ export function listToolsV1AgentsAgentIdToolsGet({ agentId, isPublic, xAccountId
         status: 422;
         data: HttpValidationError;
     }>(`/v1/agents/${encodeURIComponent(agentId)}/tools${QS.query(QS.explode({
+        version_number: versionNumber,
         is_public: isPublic
     }))}`, {
         ...opts,
@@ -1232,45 +1573,13 @@ export function listToolsV1AgentsAgentIdToolsGet({ agentId, isPublic, xAccountId
         })
     }));
 }
-/**
- * Delete Tools
- */
-export function deleteToolsV1AgentsAgentIdToolsDelete({ agentId, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
-    agentId: string;
-    isPublic?: boolean;
-    xAccountId?: string | null;
-    xUsername?: string | null;
-    xUserId?: string | null;
-    xUserFullName?: string | null;
-    authorization: string;
-}, opts?: Oazapfts.RequestOpts) {
-    return oazapfts.ok(oazapfts.fetchJson<{
-        status: 204;
-    } | {
-        status: 404;
-    } | {
-        status: 422;
-        data: HttpValidationError;
-    }>(`/v1/agents/${encodeURIComponent(agentId)}/tools${QS.query(QS.explode({
-        is_public: isPublic
-    }))}`, {
-        ...opts,
-        method: "DELETE",
-        headers: oazapfts.mergeHeaders(opts?.headers, {
-            "x-account-id": xAccountId,
-            "x-username": xUsername,
-            "x-user-id": xUserId,
-            "x-user-full-name": xUserFullName,
-            authorization
-        })
-    }));
-}
 /**
  * List Tools By Agent For Schema
  */
-export function listToolsByAgentForSchemaV1AgentsAgentIdToolsSchemaSchemaGet({ agentId, schema, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+export function listToolsByAgentForSchemaV1AgentsAgentIdToolsSchemaSchemaGet({ agentId, schema, versionNumber, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
     agentId: string;
     schema: SchemaEnum;
+    versionNumber?: number | null;
     isPublic?: boolean;
     xAccountId?: string | null;
     xUsername?: string | null;
@@ -1289,6 +1598,7 @@ export function listToolsByAgentForSchemaV1AgentsAgentIdToolsSchemaSchemaGet({ a
         status: 422;
         data: HttpValidationError;
     }>(`/v1/agents/${encodeURIComponent(agentId)}/tools/schema/${encodeURIComponent(schema)}${QS.query(QS.explode({
+        version_number: versionNumber,
         is_public: isPublic
     }))}`, {
         ...opts,
@@ -1415,9 +1725,9 @@ export function createAgentV1AgentsPost({ isPublic, xAccountId, xUsername, xUser
     })));
 }
 /**
- * Search Agents
+ * Search Agents By Ids
  */
-export function searchAgentsV1AgentsSearchPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, searchAgentsRequest }: {
+export function searchAgentsByIdsV1AgentsSearchPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, searchAgentsRequest }: {
     xAccountId?: string | null;
     xUsername?: string | null;
     xUserId?: string | null;
@@ -1616,9 +1926,10 @@ export function listMultiAgentsV1AgentsMultiAgentsGet({ name, slug, visibility,
 /**
  * Get Agent
  */
-export function getAgentV1AgentsAgentIdGet({ agentId, details, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+export function getAgentV1AgentsAgentIdGet({ agentId, details, versionNumber, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
     agentId: string;
     details?: boolean;
+    versionNumber?: number | null;
     xAccountId?: string | null;
     xUsername?: string | null;
     xUserId?: string | null;
@@ -1627,14 +1938,15 @@ export function getAgentV1AgentsAgentIdGet({ agentId, details, xAccountId, xUser
 }, opts?: Oazapfts.RequestOpts) {
     return oazapfts.ok(oazapfts.fetchJson<{
         status: 200;
-        data: AgentModel;
+        data: FindByIdAgentResponse;
     } | {
         status: 404;
     } | {
         status: 422;
         data: HttpValidationError;
     }>(`/v1/agents/${encodeURIComponent(agentId)}${QS.query(QS.explode({
-        details
+        details,
+        version_number: versionNumber
     }))}`, {
         ...opts,
         headers: oazapfts.mergeHeaders(opts?.headers, {
@@ -1962,6 +2274,172 @@ export function migrateAgentAvatarByIdV1AgentsAgentIdMigrateAvatarPost({ agentId
         })
     }));
 }
+/**
+ * Create Version
+ */
+export function createVersionV1AgentsAgentCoreIdVersionsPost({ agentCoreId, xAccountId, xUsername, xUserId, xUserFullName, authorization, createVersionRequest }: {
+    agentCoreId: string;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+    createVersionRequest: CreateVersionRequest;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 200;
+        data: CreateVersionResponse;
+    } | {
+        status: 201;
+        data: CreateVersionResponse;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v1/agents/${encodeURIComponent(agentCoreId)}/versions`, oazapfts.json({
+        ...opts,
+        method: "POST",
+        body: createVersionRequest,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    })));
+}
+/**
+ * List Versions Of Agent Core
+ */
+export function listVersionsOfAgentCoreV1AgentsAgentCoreIdVersionsGet({ agentCoreId, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+    agentCoreId: string;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 200;
+        data: ListAgentVersionResponse[];
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v1/agents/${encodeURIComponent(agentCoreId)}/versions`, {
+        ...opts,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    }));
+}
+/**
+ * Delete Version
+ */
+export function deleteVersionV1AgentsAgentCoreIdVersionsVersionNumberDelete({ agentCoreId, versionNumber, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+    agentCoreId: string;
+    versionNumber: number;
+    isPublic?: boolean;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 204;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v1/agents/${encodeURIComponent(agentCoreId)}/versions/${encodeURIComponent(versionNumber)}${QS.query(QS.explode({
+        is_public: isPublic
+    }))}`, {
+        ...opts,
+        method: "DELETE",
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    }));
+}
+/**
+ * Patch Version Recommended
+ */
+export function patchVersionRecommendedV1AgentsAgentCoreIdVersionsVersionNumberPatch({ agentCoreId, versionNumber, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+    agentCoreId: string;
+    versionNumber: number;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 200;
+        data: AgentVersionResponse;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v1/agents/${encodeURIComponent(agentCoreId)}/versions/${encodeURIComponent(versionNumber)}`, {
+        ...opts,
+        method: "PATCH",
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    }));
+}
+/**
+ * Fork Agent Version
+ */
+export function forkAgentVersionV1AgentsAgentCoreIdVersionsVersionNumberForkPost({ agentCoreId, versionNumber, xAccountId, xUsername, xUserId, xUserFullName, authorization, forkAgentRequest }: {
+    agentCoreId: string;
+    versionNumber: number;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+    forkAgentRequest: ForkAgentRequest;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 201;
+        data: ForkedAgentCoreAndVersionResponse;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v1/agents/${encodeURIComponent(agentCoreId)}/versions/${encodeURIComponent(versionNumber)}/fork`, oazapfts.json({
+        ...opts,
+        method: "POST",
+        body: forkAgentRequest,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    })));
+}
 /**
  * List Agents
  */
@@ -2002,16 +2480,51 @@ export function listAgentsV2AgentsGet({ name, slug, visibility, size, page, xAcc
         })
     }));
 }
+/**
+ * Create Agent
+ */
+export function createAgentV2AgentsPost({ isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization, newAgentRequestV2 }: {
+    isPublic?: boolean;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+    newAgentRequestV2: NewAgentRequestV2;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 201;
+        data: CreatedResponse;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v2/agents${QS.query(QS.explode({
+        is_public: isPublic
+    }))}`, oazapfts.json({
+        ...opts,
+        method: "POST",
+        body: newAgentRequestV2,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    })));
+}
 /**
  * Search Agents
  */
-export function searchAgentsV2AgentsSearchPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, searchAgentsRequest }: {
+export function searchAgentsV2AgentsSearchPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, searchAgentsRequestV2 }: {
     xAccountId?: string | null;
     xUsername?: string | null;
     xUserId?: string | null;
     xUserFullName?: string | null;
     authorization: string;
-    searchAgentsRequest: SearchAgentsRequest;
+    searchAgentsRequestV2: SearchAgentsRequestV2;
 }, opts?: Oazapfts.RequestOpts) {
     return oazapfts.ok(oazapfts.fetchJson<{
         status: 200;
@@ -2024,7 +2537,42 @@ export function searchAgentsV2AgentsSearchPost({ xAccountId, xUsername, xUserId,
     }>("/v2/agents/search", oazapfts.json({
         ...opts,
         method: "POST",
-        body: searchAgentsRequest,
+        body: searchAgentsRequestV2,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    })));
+}
+/**
+ * Update Agent
+ */
+export function updateAgentV2AgentsAgentIdPatch({ agentId, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization, updateAgentRequestV2 }: {
+    agentId: string;
+    isPublic?: boolean;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+    updateAgentRequestV2: UpdateAgentRequestV2;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 204;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v2/agents/${encodeURIComponent(agentId)}${QS.query(QS.explode({
+        is_public: isPublic
+    }))}`, oazapfts.json({
+        ...opts,
+        method: "PATCH",
+        body: updateAgentRequestV2,
         headers: oazapfts.mergeHeaders(opts?.headers, {
             "x-account-id": xAccountId,
             "x-username": xUsername,
@@ -2034,11 +2582,46 @@ export function searchAgentsV2AgentsSearchPost({ xAccountId, xUsername, xUserId,
         })
     })));
 }
+/**
+ * Find By Agent Core Id
+ */
+export function findByAgentCoreIdV2AgentsAgentCoreIdGet({ agentCoreId, versionNumber, returnAllVersions, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+    agentCoreId: string;
+    versionNumber?: number | null;
+    returnAllVersions?: boolean | null;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 200;
+        data: AgentCoreWithSingleVersionResponse;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v2/agents/${encodeURIComponent(agentCoreId)}${QS.query(QS.explode({
+        version_number: versionNumber,
+        return_all_versions: returnAllVersions
+    }))}`, {
+        ...opts,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    }));
+}
 /**
  * List Agents
  */
 export function listAgentsV3AgentsGet({ filters, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
-    filters: ListAgentRequestV3;
+    filters: ListAgentRequestV4;
     isPublic?: boolean;
     xAccountId?: string | null;
     xUsername?: string | null;
@@ -2068,6 +2651,40 @@ export function listAgentsV3AgentsGet({ filters, isPublic, xAccountId, xUsername
         })
     }));
 }
+/**
+ * List Agent Core with all versions
+ */
+export function listAgentsV4AgentsGet({ filters, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+    filters: ListAgentRequestV4;
+    isPublic?: boolean;
+    xAccountId?: string | null;
+    xUsername?: string | null;
+    xUserId?: string | null;
+    xUserFullName?: string | null;
+    authorization: string;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 200;
+        data: PaginatedResponseListAgentCoreResponse;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v4/agents${QS.query(QS.explode({
+        filters,
+        is_public: isPublic
+    }))}`, {
+        ...opts,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    }));
+}
 /**
  * Internal List Toolkits By Ids
  */