@soat/sdk 0.15.12 → 0.15.13

package/dist/index.d.mts

@@ -803,35 +803,80 @@ type SubmitToolOutputsRequest = {
     output: unknown;
   }>;
 };
+/**
+ * Result of an agent generation. Mirrors the server's `GenerationResult`. When `status` is `completed` the model output is under `output`; when it is `requires_action` the pending client tool calls are under `required_action`.
+ *
+ */
 type AgentGenerationResponse = {
   /**
    * Public ID of the generation
    */
-  id?: string;
+  id: string;
   /**
-   * Generation status
+   * Public ID of the trace for this generation
    */
-  status?: 'completed' | 'requires_action';
+  trace_id: string;
   /**
-   * Final text output (when completed)
+   * Generation status
    */
-  text?: string | null;
+  status: 'completed' | 'requires_action';
   /**
-   * Structured object matching the agent's `output_schema` (when completed and `output_schema` is set)
+   * Model output (present when `status` is `completed`).
    */
-  object?: {
-    [key: string]: unknown;
+  output?: {
+    /**
+     * Model that produced the output
+     */
+    model: string;
+    /**
+     * Final text output
+     */
+    content: string;
+    /**
+     * Reason the model stopped generating
+     */
+    finish_reason: string;
+    /**
+     * Full AI SDK response messages (tool calls, tool results, final text)
+     */
+    response_messages?: Array<{
+      [key: string]: unknown;
+    }> | null;
+    /**
+     * Structured object matching the agent's `output_schema` (when `output_schema` is set)
+     */
+    object?: {
+      [key: string]: unknown;
+    } | null;
   } | null;
   /**
-   * Pending tool calls (when requires_action)
+   * Pending action the caller must satisfy (present when `status` is `requires_action`).
    */
-  tool_calls?: Array<{
-    tool_call_id?: string;
-    tool_name?: string;
-    args?: {
-      [key: string]: unknown;
-    };
-  }> | null;
+  required_action?: {
+    /**
+     * The kind of action required
+     */
+    type: 'submit_tool_outputs';
+    /**
+     * Pending tool calls to execute and submit outputs for
+     */
+    tool_calls: Array<{
+      /**
+       * Tool call ID
+       */
+      id?: string;
+      /**
+       * Name of the tool to invoke
+       */
+      tool_name?: string;
+      /**
+       * Arguments for the tool call
+       */
+      args?: {
+        [key: string]: unknown;
+      };
+    }>;
+  } | null;
 };
 type ProviderPrice = {
   /**
@@ -5354,6 +5399,14 @@ type ListAgentsData = {
      * Project public ID to filter by
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/agents';
 };
@@ -5372,7 +5425,12 @@ type ListAgentsResponses = {
   /**
    * List of agents
    */
-  200: Array<Agent>;
+  200: {
+    data: Array<Agent>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListAgentsResponse = ListAgentsResponses[keyof ListAgentsResponses];
 type CreateAgentData = {
@@ -5648,15 +5706,20 @@ type ListAiProvidersResponses = {
   /**
    * List of AI providers
    */
-  200: Array<{
-    id?: string;
-    name?: string;
-    provider?: 'openai' | 'anthropic' | 'google' | 'xai' | 'groq' | 'ollama' | 'azure' | 'bedrock' | 'gateway' | 'custom';
-    default_model?: string;
-    project_id?: string;
-    created_at?: Date;
-    updated_at?: Date;
-  }>;
+  200: {
+    data: Array<{
+      id?: string;
+      name?: string;
+      provider?: 'openai' | 'anthropic' | 'google' | 'xai' | 'groq' | 'ollama' | 'azure' | 'bedrock' | 'gateway' | 'custom';
+      default_model?: string;
+      project_id?: string;
+      created_at?: Date;
+      updated_at?: Date;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListAiProvidersResponse = ListAiProvidersResponses[keyof ListAiProvidersResponses];
 type CreateAiProviderData = {
@@ -5935,7 +5998,16 @@ type UpdateAiProviderPricesResponse = UpdateAiProviderPricesResponses[keyof Upda
 type ListApiKeysData = {
   body?: never;
   path?: never;
-  query?: never;
+  query?: {
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
+  };
   url: '/api/v1/api-keys';
 };
 type ListApiKeysErrors = {
@@ -5948,7 +6020,12 @@ type ListApiKeysResponses = {
   /**
    * List of API keys
    */
-  200: Array<ApiKeyRecord>;
+  200: {
+    data: Array<ApiKeyRecord>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListApiKeysResponse = ListApiKeysResponses[keyof ListApiKeysResponses];
 type CreateApiKeyData = {
@@ -6119,10 +6196,22 @@ type ListApprovalsData = {
      * Return only items expiring at or before this timestamp
      */
     expires_before?: Date;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/approvals';
 };
 type ListApprovalsErrors = {
+  /**
+   * Invalid `status` or `origin` filter value
+   */
+  400: unknown;
   /**
    * Unauthorized
    */
@@ -6140,7 +6229,12 @@ type ListApprovalsResponses = {
   /**
    * List of approval items
    */
-  200: Array<ApprovalItem>;
+  200: {
+    data: Array<ApprovalItem>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListApprovalsResponse = ListApprovalsResponses[keyof ListApprovalsResponses];
 type GetApprovalData = {
@@ -6376,6 +6470,14 @@ type ListChatsData = {
      * Project public ID to filter by
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/chats';
 };
@@ -6394,7 +6496,12 @@ type ListChatsResponses = {
   /**
    * List of chats
    */
-  200: Array<Chat>;
+  200: {
+    data: Array<Chat>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListChatsResponse = ListChatsResponses[keyof ListChatsResponses];
 type CreateChatData = {
@@ -7988,6 +8095,14 @@ type ListExceptionsData = {
      * Filter by how the exception was filed
      */
     kind?: 'run_failed' | 'guardrail_tripwire' | 'approval_expired' | 'manual';
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/exceptions';
 };
@@ -8009,7 +8124,12 @@ type ListExceptionsResponses = {
   /**
    * List of exception items
    */
-  200: Array<ExceptionItem>;
+  200: {
+    data: Array<ExceptionItem>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListExceptionsResponse = ListExceptionsResponses[keyof ListExceptionsResponses];
 type GetExceptionData = {
@@ -8726,6 +8846,14 @@ type ListFormationsData = {
      * Project ID (required if not using project key auth)
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/formations';
 };
@@ -8743,7 +8871,12 @@ type ListFormationsResponses = {
   /**
    * List of formations
    */
-  200: Array<Formation>;
+  200: {
+    data: Array<Formation>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListFormationsResponse = ListFormationsResponses[keyof ListFormationsResponses];
 type CreateFormationData = {
@@ -8915,7 +9048,16 @@ type ListFormationEventsData = {
   path: {
     formation_id: string;
   };
-  query?: never;
+  query?: {
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
+  };
   url: '/api/v1/formations/{formation_id}/events';
 };
 type ListFormationEventsErrors = {
@@ -8936,7 +9078,12 @@ type ListFormationEventsResponses = {
   /**
    * List of operations
    */
-  200: Array<FormationOperation>;
+  200: {
+    data: Array<FormationOperation>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListFormationEventsResponse = ListFormationEventsResponses[keyof ListFormationEventsResponses];
 type ListGenerationsData = {
@@ -9066,6 +9213,14 @@ type ListGuardrailsData = {
      * Project public ID to filter by
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/guardrails';
 };
@@ -9084,7 +9239,12 @@ type ListGuardrailsResponses = {
   /**
    * List of guardrails
    */
-  200: Array<Guardrail>;
+  200: {
+    data: Array<Guardrail>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListGuardrailsResponse = ListGuardrailsResponses[keyof ListGuardrailsResponses];
 type CreateGuardrailData = {
@@ -9329,7 +9489,12 @@ type ListIngestionRulesResponses = {
   /**
    * List of ingestion rules
    */
-  200: Array<IngestionRule>;
+  200: {
+    data: Array<IngestionRule>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListIngestionRulesResponse = ListIngestionRulesResponses[keyof ListIngestionRulesResponses];
 type CreateIngestionRuleData = {
@@ -9616,6 +9781,14 @@ type ListMemoriesData = {
      *
      */
     tags?: Array<string>;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/memories';
 };
@@ -9637,7 +9810,12 @@ type ListMemoriesResponses = {
   /**
    * List of memories
    */
-  200: Array<Memory>;
+  200: {
+    data: Array<Memory>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListMemoriesResponse = ListMemoriesResponses[keyof ListMemoriesResponses];
 type CreateMemoryData = {
@@ -9808,6 +9986,14 @@ type ListMemoryEntriesData = {
      * Memory container to list entries from (mem_...)
      */
     memory_id: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/memory-entries';
 };
@@ -9833,7 +10019,12 @@ type ListMemoryEntriesResponses = {
   /**
    * List of memory entries
    */
-  200: Array<MemoryEntry>;
+  200: {
+    data: Array<MemoryEntry>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListMemoryEntriesResponse = ListMemoryEntriesResponses[keyof ListMemoryEntriesResponses];
 type CreateMemoryEntryData = {
@@ -10028,6 +10219,14 @@ type ListOrchestrationsData = {
      * Filter by project public ID
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/orchestrations';
 };
@@ -10045,7 +10244,12 @@ type ListOrchestrationsResponses = {
   /**
    * List of orchestrations
    */
-  200: Array<Orchestration>;
+  200: {
+    data: Array<Orchestration>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListOrchestrationsResponse = ListOrchestrationsResponses[keyof ListOrchestrationsResponses];
 type CreateOrchestrationData = {
@@ -10225,6 +10429,14 @@ type ListOrchestrationRunsData = {
      * Filter by orchestration public ID (orch_...)
      */
     orchestration_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/orchestration-runs';
 };
@@ -10242,7 +10454,12 @@ type ListOrchestrationRunsResponses = {
   /**
    * List of runs
    */
-  200: Array<OrchestrationRun>;
+  200: {
+    data: Array<OrchestrationRun>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListOrchestrationRunsResponse = ListOrchestrationRunsResponses[keyof ListOrchestrationRunsResponses];
 type StartOrchestrationRunData = {
@@ -10428,6 +10645,14 @@ type ListPoliciesData = {
      * Return only policies attached to this user (user_...)
      */
     user_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/policies';
 };
@@ -10445,7 +10670,12 @@ type ListPoliciesResponses = {
   /**
    * List of policies
    */
-  200: Array<PolicyRecord>;
+  200: {
+    data: Array<PolicyRecord>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListPoliciesResponse = ListPoliciesResponses[keyof ListPoliciesResponses];
 type CreatePolicyData = {
@@ -10588,7 +10818,16 @@ type UpdatePolicyResponse = UpdatePolicyResponses[keyof UpdatePolicyResponses];
 type ListProjectsData = {
   body?: never;
   path?: never;
-  query?: never;
+  query?: {
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
+  };
   url: '/api/v1/projects';
 };
 type ListProjectsErrors = {
@@ -10601,7 +10840,12 @@ type ListProjectsResponses = {
   /**
    * List of projects
    */
-  200: Array<ProjectRecord>;
+  200: {
+    data: Array<ProjectRecord>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListProjectsResponse = ListProjectsResponses[keyof ListProjectsResponses];
 type CreateProjectData = {
@@ -10834,6 +11078,14 @@ type ListQuotasData = {
      * Project ID (required if not using project key auth)
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/quotas';
 };
@@ -10855,7 +11107,12 @@ type ListQuotasResponses = {
   /**
    * List of quotas
    */
-  200: Array<Quota>;
+  200: {
+    data: Array<Quota>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListQuotasResponse = ListQuotasResponses[keyof ListQuotasResponses];
 type CreateQuotaData = {
@@ -11068,17 +11325,22 @@ type ListSecretsResponses = {
   /**
    * List of secrets
    */
-  200: Array<{
-    id?: string;
-    name?: string;
-    /**
-     * Whether an encrypted value is stored for this secret
-     */
-    has_value?: boolean;
-    project_id?: string;
-    created_at?: Date;
-    updated_at?: Date;
-  }>;
+  200: {
+    data: Array<{
+      id?: string;
+      name?: string;
+      /**
+       * Whether an encrypted value is stored for this secret
+       */
+      has_value?: boolean;
+      project_id?: string;
+      created_at?: Date;
+      updated_at?: Date;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListSecretsResponse = ListSecretsResponses[keyof ListSecretsResponses];
 type CreateSecretData = {
@@ -11677,6 +11939,14 @@ type ListTasksData = {
     state?: string;
     status?: 'open' | 'closed';
     assignee?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/tasks';
 };
@@ -11694,7 +11964,12 @@ type ListTasksResponses = {
   /**
    * A list of tasks
    */
-  200: Array<Task>;
+  200: {
+    data: Array<Task>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListTasksResponse = ListTasksResponses[keyof ListTasksResponses];
 type CreateTaskData = {
@@ -11893,6 +12168,14 @@ type ListToolsData = {
      * Project public ID to filter by
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/tools';
 };
@@ -11912,7 +12195,10 @@ type ListToolsResponses = {
    * List of tools
    */
   200: {
-    data?: Array<Tool>;
+    data: Array<Tool>;
+    total: number;
+    limit: number;
+    offset: number;
   };
 };
 type ListToolsResponse = ListToolsResponses[keyof ListToolsResponses];
@@ -12200,6 +12486,14 @@ type ListTriggersData = {
     project_id?: string;
     type?: 'manual' | 'webhook' | 'schedule';
     target_type?: 'orchestration' | 'agent' | 'tool';
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/triggers';
 };
@@ -12217,7 +12511,12 @@ type ListTriggersResponses = {
   /**
    * A list of triggers
    */
-  200: Array<Trigger>;
+  200: {
+    data: Array<Trigger>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListTriggersResponse = ListTriggersResponses[keyof ListTriggersResponses];
 type CreateTriggerData = {
@@ -12617,6 +12916,14 @@ type ListUsageThresholdsData = {
      * Filter by project public ID
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/usage/thresholds';
 };
@@ -12636,7 +12943,10 @@ type ListUsageThresholdsResponses = {
    * The usage thresholds
    */
   200: {
-    data?: Array<UsageThreshold>;
+    data: Array<UsageThreshold>;
+    total: number;
+    limit: number;
+    offset: number;
   };
 };
 type ListUsageThresholdsResponse = ListUsageThresholdsResponses[keyof ListUsageThresholdsResponses];
@@ -12811,7 +13121,16 @@ type GetCurrentUserResponse = GetCurrentUserResponses[keyof GetCurrentUserRespon
 type ListUsersData = {
   body?: never;
   path?: never;
-  query?: never;
+  query?: {
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
+  };
   url: '/api/v1/users';
 };
 type ListUsersErrors = {
@@ -12825,7 +13144,12 @@ type ListUsersResponses = {
   /**
    * List of users returned successfully
    */
-  200: Array<UserRecord>;
+  200: {
+    data: Array<UserRecord>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListUsersResponse = ListUsersResponses[keyof ListUsersResponses];
 type CreateUserData = {
@@ -13011,6 +13335,14 @@ type ListWebhooksData = {
   path?: never;
   query?: {
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/webhooks';
 };
@@ -13028,7 +13360,12 @@ type ListWebhooksResponses = {
   /**
    * A list of webhooks
    */
-  200: Array<Webhook>;
+  200: {
+    data: Array<Webhook>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListWebhooksResponse = ListWebhooksResponses[keyof ListWebhooksResponses];
 type CreateWebhookData = {
@@ -13275,6 +13612,14 @@ type ListWorkflowsData = {
   path?: never;
   query?: {
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/workflows';
 };
@@ -13292,7 +13637,12 @@ type ListWorkflowsResponses = {
   /**
    * A list of workflows
    */
-  200: Array<Workflow>;
+  200: {
+    data: Array<Workflow>;
+    total: number;
+    limit: number;
+    offset: number;
+  };
 };
 type ListWorkflowsResponse = ListWorkflowsResponses[keyof ListWorkflowsResponses];
 type CreateWorkflowData = {