@stack-spot/portal-network 0.197.0 → 0.198.0-beta.1

package/src/api/agent-tools.ts

@@ -33,6 +33,7 @@ export type HttpValidationError = {
     detail?: ValidationError[];
 };
 export type VisibilityLevelEnum = "account" | "personal" | "shared" | "workspace" | "favorite";
+export type ToolkitType = "mcp" | "web_request";
 export type CustomToolkitSimpleResponse = {
     id: string;
     name: string;
@@ -40,6 +41,7 @@ export type CustomToolkitSimpleResponse = {
     avatar?: string | null;
     visibility_level: VisibilityLevelEnum;
     creator_name: string | null;
+    toolkit_type?: ToolkitType | null;
 };
 export type ToolkitRequest = {
     /** Toolkit name (up to 150 characters, required) */
@@ -51,6 +53,20 @@ export type ToolkitRequest = {
     /** Visibility level (default 'PERSONAL') */
     visibility_level?: VisibilityLevelEnum;
 };
+export type ToolkitMcpRequest = {
+    /** Toolkit name (up to 150 characters, required) */
+    name: string;
+    /** Toolkit description (up to 1024 characters, optional) */
+    description?: string | null;
+    /** Toolkit avatar (text base64, optional) */
+    avatar?: string | null;
+    /** Visibility level (default 'PERSONAL') */
+    visibility_level?: VisibilityLevelEnum;
+    url: string;
+    toolkit_type: ToolkitType;
+    /** List of secret IDs (optional) */
+    secrets?: string[] | null;
+};
 export type CreatedResponse = {
     id: string;
 };
@@ -76,10 +92,12 @@ export type CustomToolkitResponse = {
     avatar?: string | null;
     visibility_level: VisibilityLevelEnum;
     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 ToolkitUpdateRequest = {
     /** Toolkit name (up to 150 characters, optional) */
@@ -95,6 +113,22 @@ export type ToolkitUpdateRequest = {
     /** List of secret IDs (optional) */
     secrets?: string[] | null;
 };
+export type ToolkitMcpUpdateRequest = {
+    /** Toolkit name (up to 150 characters, optional) */
+    name?: string | null;
+    /** Toolkit description (up to 1024 characters, optional) */
+    description?: string | null;
+    /** Toolkit avatar (text base64, optional) */
+    avatar?: string | null;
+    /** Visibility level (optional) */
+    visibility_level?: VisibilityLevelEnum | null;
+    /** IAM secret ID (optional) */
+    secret_id?: string | null;
+    /** List of secret IDs (optional) */
+    secrets?: string[] | null;
+    /** MCP Server URL */
+    url?: string | null;
+};
 export type ToolkitForkRequest = {
     /** Toolkit name (up to 150 characters, required) */
     name: string;
@@ -104,148 +138,7 @@ export type ToolkitForkRequest = {
     avatar?: string | null;
 };
 export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
-export type Reference = {
-    $ref: string;
-    summary?: string | null;
-    description?: string | null;
-    [key: string]: any;
-};
-export type DataType = "null" | "string" | "number" | "integer" | "boolean" | "array" | "object";
-export type Discriminator = {
-    propertyName: string;
-    mapping?: {
-        [key: string]: string;
-    } | null;
-    [key: string]: any;
-};
-export type Xml = {
-    name?: string | null;
-    "namespace"?: string | null;
-    prefix?: string | null;
-    attribute?: boolean;
-    wrapped?: boolean;
-    [key: string]: any;
-};
-export type ExternalDocumentation = {
-    description?: string | null;
-    url: string;
-    [key: string]: any;
-};
-export type Schema = {
-    allOf?: (Reference | Schema)[] | null;
-    anyOf?: (Reference | Schema)[] | null;
-    oneOf?: (Reference | Schema)[] | null;
-    not?: Reference | Schema | null;
-    "if"?: Reference | Schema | null;
-    then?: Reference | Schema | null;
-    "else"?: Reference | Schema | null;
-    dependentSchemas?: {
-        [key: string]: Reference | Schema;
-    } | null;
-    prefixItems?: (Reference | Schema)[] | null;
-    items?: Reference | Schema | null;
-    contains?: Reference | Schema | null;
-    properties?: {
-        [key: string]: Reference | Schema;
-    } | null;
-    patternProperties?: {
-        [key: string]: Reference | Schema;
-    } | null;
-    additionalProperties?: Reference | Schema | boolean | null;
-    propertyNames?: Reference | Schema | null;
-    unevaluatedItems?: Reference | Schema | null;
-    unevaluatedProperties?: Reference | Schema | null;
-    "type"?: DataType | DataType[] | null;
-    "enum"?: any[] | null;
-    "const"?: any | null;
-    multipleOf?: number | null;
-    maximum?: number | null;
-    exclusiveMaximum?: number | null;
-    minimum?: number | null;
-    exclusiveMinimum?: number | null;
-    maxLength?: number | null;
-    minLength?: number | null;
-    pattern?: string | null;
-    maxItems?: number | null;
-    minItems?: number | null;
-    uniqueItems?: boolean | null;
-    maxContains?: number | null;
-    minContains?: number | null;
-    maxProperties?: number | null;
-    minProperties?: number | null;
-    required?: string[] | null;
-    dependentRequired?: {
-        [key: string]: string[];
-    } | null;
-    format?: string | null;
-    contentEncoding?: string | null;
-    contentMediaType?: string | null;
-    contentSchema?: Reference | Schema | null;
-    title?: string | null;
-    description?: string | null;
-    "default"?: any | null;
-    deprecated?: boolean | null;
-    readOnly?: boolean | null;
-    writeOnly?: boolean | null;
-    discriminator?: Discriminator | null;
-    xml?: Xml | null;
-    externalDocs?: ExternalDocumentation | null;
-    [key: string]: any;
-};
-export type Header = {
-    description?: string | null;
-    required?: boolean;
-    deprecated?: boolean;
-    style?: string | null;
-    explode?: boolean | null;
-    schema?: Reference | Schema | null;
-    content?: {
-        [key: string]: MediaType;
-    } | null;
-    [key: string]: any;
-};
-export type Encoding = {
-    contentType?: string | null;
-    headers?: {
-        [key: string]: Header | Reference;
-    } | null;
-    style?: string | null;
-    explode?: boolean | null;
-    allowReserved?: boolean;
-    [key: string]: any;
-};
-export type MediaType = {
-    schema?: Reference | Schema | null;
-    encoding?: {
-        [key: string]: Encoding;
-    } | null;
-    [key: string]: any;
-};
-export type ParameterLocation = "query" | "header" | "path" | "cookie";
-export type Parameter = {
-    description?: string | null;
-    required?: boolean;
-    deprecated?: boolean;
-    style?: string | null;
-    explode?: boolean | null;
-    schema?: Reference | Schema | null;
-    content?: {
-        [key: string]: MediaType;
-    } | null;
-    name: string;
-    "in": ParameterLocation;
-    allowEmptyValue?: boolean;
-    allowReserved?: boolean;
-    [key: string]: any;
-};
-export type RequestBody = {
-    description?: string | null;
-    content: {
-        [key: string]: MediaType;
-    };
-    required?: boolean;
-    [key: string]: any;
-};
+export type JsonValue = any;
 export type CustomToolRequest = {
     /** Tool name (up to 256 characters, required) */
     name: string;
@@ -256,9 +149,9 @@ export type CustomToolRequest = {
     /** Endpoint URL (required, must use https schema) */
     url: string;
     /** Dict of parameters (optional) */
-    parameters?: Parameter[] | null;
+    parameters?: JsonValue[] | null;
     /** Dict of request body (optional) */
-    request_body?: RequestBody | null;
+    request_body?: JsonValue | null;
     /** Response transformation (optional) */
     response_transformation?: string | null;
 };
@@ -290,10 +183,23 @@ export type AssignToolsToAgentRequest = {
     builtin_tool_ids?: string[] | null;
     custom_tools?: AssignCustomToolsAgentRequest[] | null;
     sub_agents_ids?: string[] | null;
+    mcp_toolkit_ids?: string[] | null;
+};
+export type ToolkitMcpResponse = {
+    id?: string | null;
+    name?: string | null;
+    description?: string | null;
+    avatar?: string | null;
+    visibility_level?: string | null;
+    secret_id?: string | null;
+    secrets?: string[] | null;
+    url?: string | null;
+    toolkit_type?: ToolkitType | null;
 };
 export type AgentToolsResponse = {
     builtin_toolkits?: BuiltinToolkitResponse[];
     custom_toolkits?: CustomToolkitResponse[];
+    mcp_toolkits?: ToolkitMcpResponse[];
 };
 export type SchemaEnum = "OPENAI";
 export type FunctionParameter = {
@@ -323,6 +229,8 @@ export type Function = {
     strict: boolean;
 };
 export type OpenAiTool = {
+    /** Unique identifier for the tool */
+    id?: string | null;
     /** The type of the tool; must be 'function' */
     "type": "function";
     /** The function associated with this tool */
@@ -370,6 +278,7 @@ export type KnowledgeSourcesConfigRequest = {
     sealed?: boolean | null;
 };
 export type AgentMode = "autonomous" | "plan_approval" | "plan_and_critical_approval";
+export type AgentMemory = "vector" | "buffer";
 export type NewAgentRequest = {
     /** LLM model name */
     model_name?: string | null;
@@ -393,6 +302,7 @@ export type NewAgentRequest = {
     builtin_tools_ids?: string[];
     /** Custom tools to assign to the agent */
     custom_tools?: AssignCustomToolsAgentRequest[] | null;
+    mcp_toolkit_ids?: string[] | null;
     sub_agents_ids?: string[] | null;
     detail_mode?: boolean;
     structured_output?: string | null;
@@ -401,6 +311,8 @@ export type NewAgentRequest = {
     } | null;
     /** Agent mode */
     mode?: AgentMode;
+    /** Agent memory */
+    memory?: AgentMemory;
     /** Available models for this particular agent */
     available_models_ids?: string[];
 };
@@ -512,10 +424,30 @@ export type CustomToolkitDto = {
     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 ToolkitMcpdto = {
+    secrets: SecretDto[] | null;
+    name: string;
+    description?: string | null;
+    avatar?: string | null;
+    visibility_level?: VisibilityLevelEnum;
+    id?: string | null;
+    url?: string | null;
+    tools?: any[] | 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;
@@ -559,6 +491,7 @@ export type AgentModel = {
     updated_by?: string | null;
     updated_at?: string | null;
     available_llm_models?: AgentLlmModelDto[];
+    memory?: AgentMemory;
 };
 export type UpdateAgentRequest = {
     use_only?: boolean | null;
@@ -585,6 +518,7 @@ export type UpdateAgentRequest = {
     sub_agents_ids?: string[];
     /** 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?: {
@@ -594,6 +528,8 @@ export type UpdateAgentRequest = {
     mode?: AgentMode | null;
     /** Available models for this particular agent */
     available_models_ids?: string[];
+    /** Agent memory */
+    memory?: AgentMemory;
 };
 export type ForkAgentRequest = {
     /** Agent slug to fork */
@@ -680,6 +616,34 @@ export type ToolkitForkResponse = {
     /** List of toolkit IDs that failed to fork */
     error_ids: string[];
 };
+export type PaginatedResponseCustomToolkitSimpleResponse = {
+    total_pages: number;
+    items: CustomToolkitSimpleResponse[];
+};
+export type ParametersModel = {
+    properties: {
+        [key: string]: {
+            [key: string]: any;
+        };
+    };
+    required?: string[] | null;
+    "type": string;
+    additionalProperties: boolean;
+};
+export type FunctionModel = {
+    name: string;
+    description: string;
+    parameters: ParametersModel;
+    strict?: boolean;
+};
+export type FunctionItem = {
+    "type": string;
+    "function": FunctionModel;
+};
+export type FunctionsResponse = {
+    last_update: string;
+    tools: FunctionItem[];
+};
 /**
  * Health Check
  */
@@ -774,13 +738,13 @@ export function listToolkitsV1ToolkitsGet({ visibility, xAccountId, xUsername, x
 /**
  * Create Toolkit
  */
-export function createToolkitV1ToolkitsPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, toolkitRequest }: {
+export function createToolkitV1ToolkitsPost({ xAccountId, xUsername, xUserId, xUserFullName, authorization, body }: {
     xAccountId?: string | null;
     xUsername?: string | null;
     xUserId?: string | null;
     xUserFullName?: string | null;
     authorization: string;
-    toolkitRequest: ToolkitRequest;
+    body: ToolkitRequest | ToolkitMcpRequest;
 }, opts?: Oazapfts.RequestOpts) {
     return oazapfts.ok(oazapfts.fetchJson<{
         status: 201;
@@ -793,7 +757,7 @@ export function createToolkitV1ToolkitsPost({ xAccountId, xUsername, xUserId, xU
     }>("/v1/toolkits", oazapfts.json({
         ...opts,
         method: "POST",
-        body: toolkitRequest,
+        body,
         headers: oazapfts.mergeHeaders(opts?.headers, {
             "x-account-id": xAccountId,
             "x-username": xUsername,
@@ -836,14 +800,14 @@ export function getToolkitV1ToolkitsToolkitIdGet({ toolkitId, xAccountId, xUsern
 /**
  * Update Toolkit
  */
-export function updateToolkitV1ToolkitsToolkitIdPatch({ toolkitId, xAccountId, xUsername, xUserId, xUserFullName, authorization, toolkitUpdateRequest }: {
+export function updateToolkitV1ToolkitsToolkitIdPatch({ toolkitId, xAccountId, xUsername, xUserId, xUserFullName, authorization, body }: {
     toolkitId: string;
     xAccountId?: string | null;
     xUsername?: string | null;
     xUserId?: string | null;
     xUserFullName?: string | null;
     authorization: string;
-    toolkitUpdateRequest: ToolkitUpdateRequest;
+    body: ToolkitUpdateRequest | ToolkitMcpUpdateRequest;
 }, opts?: Oazapfts.RequestOpts) {
     return oazapfts.ok(oazapfts.fetchJson<{
         status: 204;
@@ -855,7 +819,7 @@ export function updateToolkitV1ToolkitsToolkitIdPatch({ toolkitId, xAccountId, x
     }>(`/v1/toolkits/${encodeURIComponent(toolkitId)}`, oazapfts.json({
         ...opts,
         method: "PATCH",
-        body: toolkitUpdateRequest,
+        body,
         headers: oazapfts.mergeHeaders(opts?.headers, {
             "x-account-id": xAccountId,
             "x-username": xUsername,
@@ -2180,3 +2144,75 @@ export function internalForkToolkitsByIdsV1SpotToolkitsForkPost({ xAccountId, xU
         })
     })));
 }
+/**
+ * List Toolkits
+ */
+export function listToolkitsV2ToolkitsGet({ name, visibilityList, size, page, order, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+    name?: string | null;
+    visibilityList?: VisibilityLevelEnum[];
+    size?: number;
+    page?: number;
+    order?: OrderEnum | 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: PaginatedResponseCustomToolkitSimpleResponse;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v2/toolkits${QS.query(QS.explode({
+        name,
+        visibility_list: visibilityList,
+        size,
+        page,
+        order
+    }))}`, {
+        ...opts,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    }));
+}
+/**
+ * List Mcp Tools
+ */
+export function listMcpToolsV1McpToolsToolkitIdGet({ toolkitId, cacheControl, xAccountId, xUsername, xUserId, xUserFullName, authorization }: {
+    toolkitId: string;
+    cacheControl?: string | 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: FunctionsResponse;
+    } | {
+        status: 404;
+    } | {
+        status: 422;
+        data: HttpValidationError;
+    }>(`/v1/mcp-tools/${encodeURIComponent(toolkitId)}`, {
+        ...opts,
+        headers: oazapfts.mergeHeaders(opts?.headers, {
+            "cache-control": cacheControl,
+            "x-account-id": xAccountId,
+            "x-username": xUsername,
+            "x-user-id": xUserId,
+            "x-user-full-name": xUserFullName,
+            authorization
+        })
+    }));
+}