@agent-os-sdk/client 0.9.24 → 0.9.26

package/package.json

@@ -1,15 +1,15 @@
 {
     "name": "@agent-os-sdk/client",
-    "version": "0.9.24",
+    "version": "0.9.26",
     "description": "Official TypeScript SDK for Agent OS platform",
     "type": "module",
-    "main": "./dist/index.js",
-    "module": "./dist/index.js",
-    "types": "./dist/index.d.ts",
+    "main": "./index.js",
+    "module": "./index.js",
+    "types": "./index.d.ts",
     "exports": {
         ".": {
-            "import": "./dist/index.js",
-            "types": "./dist/index.d.ts"
+            "import": "./index.js",
+            "types": "./index.d.ts"
         }
     },
     "scripts": {
@@ -47,7 +47,14 @@
         "vitest": "^4.0.18"
     },
     "files": [
-        "dist",
-        "src"
+        "client",
+        "errors",
+        "generated",
+        "index.d.ts",
+        "index.d.ts.map",
+        "index.js",
+        "modules",
+        "src",
+        "sse"
     ]
 }

package/src/generated/openapi.ts

@@ -7398,6 +7398,58 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/api/templates/{templateRef}/instantiate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    templateRef: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["InstantiateTemplateRequest"];
+                    "text/json": components["schemas"]["InstantiateTemplateRequest"];
+                    "application/*+json": components["schemas"]["InstantiateTemplateRequest"];
+                };
+            };
+            responses: {
+                /** @description Created */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InstantiateTemplateResponse"];
+                    };
+                };
+                /** @description Not Found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/api/tenants": {
         parameters: {
             query?: never;
@@ -10891,6 +10943,17 @@ export interface components {
             paths?: components["schemas"]["PathInfoDto"][] | null;
             warnings?: string[] | null;
         };
+        InstantiateTemplateRequest: {
+            display_name?: string | null;
+            metadata?: components["schemas"]["JsonNode"];
+        };
+        InstantiateTemplateResponse: {
+            /** Format: uuid */
+            agent_id?: string;
+            name?: string | null;
+            template_ref?: string | null;
+            template_version?: string | null;
+        };
         InviteMemberRequest: {
             /** Format: uuid */
             user_id?: string | null;
@@ -11643,12 +11706,20 @@ export interface components {
             /** Format: uuid */
             agent_id?: string;
             /** Format: uuid */
+            bundle_id?: string;
+            /** Format: uuid */
             thread_id?: string | null;
             status?: string | null;
             /** Format: date-time */
             created_at?: string;
             /** Format: date-time */
+            started_at?: string | null;
+            /** Format: date-time */
             completed_at?: string | null;
+            /** Format: int32 */
+            attempt_count?: number;
+            /** Format: int32 */
+            current_attempt_no?: number | null;
         };
         RunListResponse: {
             items?: components["schemas"]["RunListItem"][] | null;
@@ -11852,6 +11923,12 @@ export interface components {
         SupportedContractsResponse: {
             contract_ids?: string[] | null;
         };
+        TemplateCapabilityPreviewResponse: {
+            capability_ref?: string | null;
+            capability_version?: string | null;
+            execution_binding?: string | null;
+            required_credentials?: string[] | null;
+        };
         TemplateDetailResponse: {
             template_ref?: string | null;
             version?: string | null;
@@ -11861,6 +11938,9 @@ export interface components {
             category?: string | null;
             editability_mode?: string | null;
             required_capability_refs?: string[] | null;
+            required_credentials?: string[] | null;
+            topology_preview?: components["schemas"]["TemplateTopologyPreviewResponse"];
+            capabilities?: components["schemas"]["TemplateCapabilityPreviewResponse"][] | null;
             default_policy_refs?: unknown;
             default_runtime_config_refs?: unknown;
             base_agent_ir?: unknown;
@@ -11879,9 +11959,19 @@ export interface components {
             category?: string | null;
             editability_mode?: string | null;
             required_capability_refs?: string[] | null;
+            required_credentials?: string[] | null;
+            topology_preview?: components["schemas"]["TemplateTopologyPreviewResponse"];
             default_policy_refs?: unknown;
             default_runtime_config_refs?: unknown;
         };
+        TemplateTopologyPreviewResponse: {
+            /** Format: int32 */
+            node_count?: number;
+            /** Format: int32 */
+            edge_count?: number;
+            /** Format: int32 */
+            entrypoint_count?: number;
+        };
         TenantContextDto: {
             /** Format: uuid */
             id?: string;

package/src/generated/swagger.json

@@ -7700,6 +7700,64 @@
         }
       }
     },
+    "/v1/api/templates/{templateRef}/instantiate": {
+      "post": {
+        "tags": [
+          "Templates"
+        ],
+        "parameters": [
+          {
+            "name": "templateRef",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/InstantiateTemplateRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/InstantiateTemplateRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/InstantiateTemplateRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InstantiateTemplateResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/api/tenants": {
       "get": {
         "tags": [
@@ -12408,6 +12466,41 @@
         "additionalProperties": false,
         "description": "Response for POST /triggers/{id}/infer-schema"
       },
+      "InstantiateTemplateRequest": {
+        "type": "object",
+        "properties": {
+          "display_name": {
+            "type": "string",
+            "nullable": true
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/JsonNode"
+          }
+        },
+        "additionalProperties": false
+      },
+      "InstantiateTemplateResponse": {
+        "type": "object",
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "template_ref": {
+            "type": "string",
+            "nullable": true
+          },
+          "template_version": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "InviteMemberRequest": {
         "type": "object",
         "properties": {
@@ -14775,6 +14868,10 @@
             "type": "string",
             "format": "uuid"
           },
+          "bundle_id": {
+            "type": "string",
+            "format": "uuid"
+          },
           "thread_id": {
             "type": "string",
             "format": "uuid",
@@ -14788,10 +14885,24 @@
             "type": "string",
             "format": "date-time"
           },
+          "started_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
           "completed_at": {
             "type": "string",
             "format": "date-time",
             "nullable": true
+          },
+          "attempt_count": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "current_attempt_no": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -15358,6 +15469,31 @@
         },
         "additionalProperties": false
       },
+      "TemplateCapabilityPreviewResponse": {
+        "type": "object",
+        "properties": {
+          "capability_ref": {
+            "type": "string",
+            "nullable": true
+          },
+          "capability_version": {
+            "type": "string",
+            "nullable": true
+          },
+          "execution_binding": {
+            "type": "string",
+            "nullable": true
+          },
+          "required_credentials": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "TemplateDetailResponse": {
         "type": "object",
         "properties": {
@@ -15396,6 +15532,23 @@
             },
             "nullable": true
           },
+          "required_credentials": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "topology_preview": {
+            "$ref": "#/components/schemas/TemplateTopologyPreviewResponse"
+          },
+          "capabilities": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TemplateCapabilityPreviewResponse"
+            },
+            "nullable": true
+          },
           "default_policy_refs": {
             "nullable": true
           },
@@ -15461,6 +15614,16 @@
             },
             "nullable": true
           },
+          "required_credentials": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "topology_preview": {
+            "$ref": "#/components/schemas/TemplateTopologyPreviewResponse"
+          },
           "default_policy_refs": {
             "nullable": true
           },
@@ -15470,6 +15633,24 @@
         },
         "additionalProperties": false
       },
+      "TemplateTopologyPreviewResponse": {
+        "type": "object",
+        "properties": {
+          "node_count": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "edge_count": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "entrypoint_count": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "additionalProperties": false
+      },
       "TenantContextDto": {
         "type": "object",
         "properties": {

package/src/modules/runs.ts

@@ -24,6 +24,7 @@ export interface Run {
     status: RunStatus;
     thread_id?: string;
     agent_id: string;
+    bundle_id?: string;
     agent_version_id?: string;
     tenant_id: string;
     workspace_id: string;
@@ -96,6 +97,48 @@ export interface RunInspectionResponse {
     events: Array<Record<string, unknown>>;
 }
 
+export interface RunFailureRetentionItem {
+    failure_id: string;
+    failure_scope: string;
+    run_id: string;
+    attempt_id: string;
+    attempt_no: number;
+    agent_id?: string | null;
+    thread_id: string;
+    node_execution_id?: string | null;
+    operation_id?: string | null;
+    capability_ref?: string | null;
+    capability_version?: string | null;
+    execution_binding?: string | null;
+    source_kind: string;
+    ancestry_kind: string;
+    status: string;
+    error_code: string;
+    error_category: string;
+    is_retryable: boolean;
+    error_source: string;
+    provider_error_code?: string | null;
+    error_summary: string;
+    retried_from_node_execution_id?: string | null;
+    replayed_from_node_execution_id?: string | null;
+    can_retry: boolean;
+    retry_from_node_execution_id?: string | null;
+    can_replay: boolean;
+    replay_from_node_execution_id?: string | null;
+    failed_at: string;
+    created_at: string;
+}
+
+export interface RunFailureRetentionListResponse {
+    items: RunFailureRetentionItem[];
+    count: number;
+}
+
+export interface RunFailureRetentionDetailResponse {
+    failure: RunFailureRetentionItem;
+    payload?: unknown;
+}
+
 export interface RunObservabilitySummaryResponse {
     workspace_id: string;
     agent_id?: string | null;
@@ -187,6 +230,27 @@ export class RunsModule {
         });
     }
 
+    async listFailures(params?: {
+        agent_id?: string;
+        capability_ref?: string;
+        error_category?: string;
+        retryable?: boolean;
+        from?: string;
+        to?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<RunFailureRetentionListResponse>> {
+        return this.client.GET<RunFailureRetentionListResponse>("/v1/api/runs/failures", {
+            params: { query: params },
+        });
+    }
+
+    async getFailure(failureId: string): Promise<APIResponse<RunFailureRetentionDetailResponse>> {
+        return this.client.GET<RunFailureRetentionDetailResponse>("/v1/api/runs/failures/{failureId}", {
+            params: { path: { failureId } },
+        });
+    }
+
     /**
      * List runs with optional filters.
      */

package/src/modules/templates.ts

@@ -9,11 +9,23 @@ export interface AuthoringTemplateSummary {
     category: string;
     editability_mode: string;
     required_capability_refs: string[];
+    required_credentials: string[];
+    topology_preview: {
+        node_count: number;
+        edge_count: number;
+        entrypoint_count: number;
+    };
     default_policy_refs?: Record<string, unknown> | null;
     default_runtime_config_refs?: Record<string, unknown> | null;
 }
 
 export interface AuthoringTemplateDetail extends AuthoringTemplateSummary {
+    capabilities: Array<{
+        capability_ref: string;
+        capability_version: string;
+        execution_binding: string;
+        required_credentials: string[];
+    }>;
     base_agent_ir: Record<string, unknown>;
 }
 
@@ -22,6 +34,18 @@ export interface AuthoringTemplateListResponse {
     total: number;
 }
 
+export interface InstantiateAuthoringTemplateRequest {
+    display_name?: string;
+    metadata?: Record<string, unknown> | null;
+}
+
+export interface InstantiateAuthoringTemplateResponse {
+    agent_id: string;
+    name: string;
+    template_ref: string;
+    template_version: string;
+}
+
 export class TemplatesModule {
     constructor(private client: RawClient, private headers: () => Record<string, string>) {}
 
@@ -37,4 +61,15 @@ export class TemplatesModule {
             headers: this.headers(),
         });
     }
+
+    async instantiate(
+        templateRef: string,
+        body: InstantiateAuthoringTemplateRequest = {},
+    ): Promise<APIResponse<InstantiateAuthoringTemplateResponse>> {
+        return this.client.POST<InstantiateAuthoringTemplateResponse>("/v1/api/templates/{templateRef}/instantiate", {
+            params: { path: { templateRef } },
+            headers: this.headers(),
+            body,
+        });
+    }
 }