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

package/dist/api/agent-tools.d.ts

@@ -170,15 +170,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;
@@ -190,11 +193,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 = {
@@ -213,7 +225,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 */
@@ -229,7 +241,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;
@@ -247,6 +259,7 @@ export type KnowledgeSourcesConfig = {
     similarity_function?: string;
     post_processing?: boolean;
 };
+export type AgentVersionStatus = "draft" | "published" | "deprecated";
 export type ListAgentResponse = {
     id: string;
     name: string;
@@ -257,6 +270,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;
@@ -272,6 +288,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";
@@ -299,6 +319,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;
@@ -315,13 +336,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 = {
@@ -361,7 +390,7 @@ export type ListMultiAgentsResponse = {
     visibility_level: VisibilityLevelEnum;
     has_multiagent_tool: boolean;
 };
-export type KnowledgeSourceDetails = {
+export type KnowledgeSourceDetailsResponse = {
     id: string;
     slug: string;
     name: string;
@@ -369,139 +398,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;
@@ -519,12 +512,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;
@@ -544,6 +540,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 */
@@ -553,6 +553,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;
@@ -563,13 +701,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 */
@@ -595,7 +945,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;
@@ -605,11 +955,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[];
@@ -843,24 +1217,12 @@ export declare function listAgentsUsingToolsV1ToolkitsToolkitIdToolsAgentsPost({
     authorization: string;
     listAgentsUsingToolsRequest: ListAgentsUsingToolsRequest;
 }, opts?: Oazapfts.RequestOpts): Promise<AgentUsingToolsResponse[]>;
-/**
- * Assign Tools
- */
-export declare 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): Promise<unknown>;
 /**
  * List Tools
  */
-export declare function listToolsV1AgentsAgentIdToolsGet({ agentId, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+export declare function listToolsV1AgentsAgentIdToolsGet({ agentId, versionNumber, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
     agentId: string;
+    versionNumber?: number | null;
     isPublic?: boolean;
     xAccountId?: string | null;
     xUsername?: string | null;
@@ -868,24 +1230,13 @@ export declare function listToolsV1AgentsAgentIdToolsGet({ agentId, isPublic, xA
     xUserFullName?: string | null;
     authorization: string;
 }, opts?: Oazapfts.RequestOpts): Promise<AgentToolsResponse>;
-/**
- * Delete Tools
- */
-export declare 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): Promise<unknown>;
 /**
  * List Tools By Agent For Schema
  */
-export declare function listToolsByAgentForSchemaV1AgentsAgentIdToolsSchemaSchemaGet({ agentId, schema, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+export declare 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;
@@ -937,9 +1288,9 @@ export declare function createAgentV1AgentsPost({ isPublic, xAccountId, xUsernam
     newAgentRequest: NewAgentRequest;
 }, opts?: Oazapfts.RequestOpts): Promise<CreatedResponse>;
 /**
- * Search Agents
+ * Search Agents By Ids
  */
-export declare function searchAgentsV1AgentsSearchPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, searchAgentsRequest }: {
+export declare function searchAgentsByIdsV1AgentsSearchPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, searchAgentsRequest }: {
     xAccountId?: string | null;
     xUsername?: string | null;
     xUserId?: string | null;
@@ -1009,15 +1360,16 @@ export declare function listMultiAgentsV1AgentsMultiAgentsGet({ name, slug, visi
 /**
  * Get Agent
  */
-export declare function getAgentV1AgentsAgentIdGet({ agentId, details, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+export declare 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;
     xUserFullName?: string | null;
     authorization: string;
-}, opts?: Oazapfts.RequestOpts): Promise<AgentModel>;
+}, opts?: Oazapfts.RequestOpts): Promise<FindByIdAgentResponse>;
 /**
  * Update Agent
  */
@@ -1134,6 +1486,67 @@ export declare function migrateAgentAvatarByIdV1AgentsAgentIdMigrateAvatarPost({
     xUserFullName?: string | null;
     authorization: string;
 }, opts?: Oazapfts.RequestOpts): Promise<unknown>;
+/**
+ * Create Version
+ */
+export declare 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): Promise<CreateVersionResponse>;
+/**
+ * List Versions Of Agent Core
+ */
+export declare 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): Promise<ListAgentVersionResponse[]>;
+/**
+ * Delete Version
+ */
+export declare 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): Promise<unknown>;
+/**
+ * Patch Version Recommended
+ */
+export declare 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): Promise<AgentVersionResponse>;
+/**
+ * Fork Agent Version
+ */
+export declare 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): Promise<ForkedAgentCoreAndVersionResponse>;
 /**
  * List Agents
  */
@@ -1149,22 +1562,60 @@ export declare function listAgentsV2AgentsGet({ name, slug, visibility, size, pa
     xUserFullName?: string | null;
     authorization: string;
 }, opts?: Oazapfts.RequestOpts): Promise<ListAgentResponseV2[]>;
+/**
+ * Create Agent
+ */
+export declare 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): Promise<CreatedResponse>;
 /**
  * Search Agents
  */
-export declare function searchAgentsV2AgentsSearchPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, searchAgentsRequest }: {
+export declare 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): Promise<ListAgentResponseV2[]>;
+/**
+ * Update Agent
+ */
+export declare 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): Promise<unknown>;
+/**
+ * Find By Agent Core Id
+ */
+export declare 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): Promise<AgentCoreWithSingleVersionResponse>;
 /**
  * List Agents
  */
 export declare function listAgentsV3AgentsGet({ filters, isPublic, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
-    filters: ListAgentRequestV3;
+    filters: ListAgentRequestV4;
     isPublic?: boolean;
     xAccountId?: string | null;
     xUsername?: string | null;
@@ -1172,6 +1623,18 @@ export declare function listAgentsV3AgentsGet({ filters, isPublic, xAccountId, x
     xUserFullName?: string | null;
     authorization: string;
 }, opts?: Oazapfts.RequestOpts): Promise<PaginatedResponseAgentResponseV3>;
+/**
+ * List Agent Core with all versions
+ */
+export declare 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): Promise<PaginatedResponseListAgentCoreResponse>;
 /**
  * Internal List Toolkits By Ids
  */