@agent-os-sdk/client 0.9.23 → 0.9.25

package/src/generated/swagger.json

@@ -1238,6 +1238,135 @@
         }
       }
     },
+    "/v1/api/agents/{id}/publishes": {
+      "get": {
+        "tags": [
+          "Agents"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentPublishHistoryResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/agents/{id}/rollback": {
+      "post": {
+        "tags": [
+          "Agents"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RollbackAgentRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RollbackAgentRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/RollbackAgentRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentRollbackResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Conflict",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/api/agents/{id}/publish-preview": {
       "get": {
         "tags": [
@@ -10418,6 +10547,141 @@
         },
         "additionalProperties": false
       },
+      "AgentPublishHistoryChangeSummary": {
+        "type": "object",
+        "properties": {
+          "added_capability_refs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "removed_capability_refs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "AgentPublishHistoryItem": {
+        "type": "object",
+        "properties": {
+          "release_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "bundle_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "previous_bundle_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          },
+          "graph_version": {
+            "type": "string",
+            "nullable": true
+          },
+          "runtime_package_hash": {
+            "type": "string",
+            "nullable": true
+          },
+          "content_hash": {
+            "type": "string",
+            "nullable": true
+          },
+          "action": {
+            "type": "string",
+            "nullable": true
+          },
+          "activated": {
+            "type": "boolean"
+          },
+          "is_live": {
+            "type": "boolean"
+          },
+          "status": {
+            "type": "string",
+            "nullable": true
+          },
+          "actor": {
+            "type": "string",
+            "nullable": true
+          },
+          "published_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "reason": {
+            "type": "string",
+            "nullable": true
+          },
+          "label": {
+            "type": "string",
+            "nullable": true
+          },
+          "summary": {
+            "type": "string",
+            "nullable": true
+          },
+          "change_summary": {
+            "$ref": "#/components/schemas/AgentPublishHistoryChangeSummary"
+          }
+        },
+        "additionalProperties": false
+      },
+      "AgentPublishHistoryResponse": {
+        "type": "object",
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "live_bundle_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AgentPublishHistoryItem"
+            },
+            "nullable": true
+          },
+          "count": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "additionalProperties": false
+      },
+      "AgentRollbackResponse": {
+        "type": "object",
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "live_bundle_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "rollback_release": {
+            "$ref": "#/components/schemas/AgentPublishHistoryItem"
+          }
+        },
+        "additionalProperties": false
+      },
       "ApiHint": {
         "type": "object",
         "properties": {
@@ -13596,6 +13860,20 @@
         },
         "additionalProperties": false
       },
+      "RollbackAgentRequest": {
+        "type": "object",
+        "properties": {
+          "target_bundle_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "reason": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "RollbackImprovementCaseRequest": {
         "type": "object",
         "properties": {
@@ -14497,6 +14775,10 @@
             "type": "string",
             "format": "uuid"
           },
+          "bundle_id": {
+            "type": "string",
+            "format": "uuid"
+          },
           "thread_id": {
             "type": "string",
             "format": "uuid",
@@ -14510,10 +14792,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

package/src/modules/agents.ts

@@ -105,6 +105,49 @@ export interface PublishPreviewResponse {
     warnings: PublishPreviewIssue[];
 }
 
+export interface AgentPublishHistoryChangeSummary {
+    added_capability_refs: string[];
+    removed_capability_refs: string[];
+}
+
+export interface AgentPublishHistoryItem {
+    release_id: string;
+    agent_id: string;
+    bundle_id: string;
+    previous_bundle_id?: string | null;
+    graph_version?: string | null;
+    runtime_package_hash: string;
+    content_hash: string;
+    action: "publish" | "rollback";
+    activated: boolean;
+    is_live: boolean;
+    status: "live" | "historical";
+    actor: string;
+    published_at: string;
+    reason?: string | null;
+    label?: string | null;
+    summary: string;
+    change_summary: AgentPublishHistoryChangeSummary;
+}
+
+export interface AgentPublishHistoryResponse {
+    agent_id: string;
+    live_bundle_id?: string | null;
+    items: AgentPublishHistoryItem[];
+    count: number;
+}
+
+export interface RollbackAgentRequest {
+    target_bundle_id: string;
+    reason?: string;
+}
+
+export interface AgentRollbackResponse {
+    agent_id: string;
+    live_bundle_id: string;
+    rollback_release: AgentPublishHistoryItem;
+}
+
 export interface AgentDraftIrResponse {
     id: string;
     name: string;
@@ -460,6 +503,24 @@ export class AgentsModule {
         });
     }
 
+    async listPublishes(agentId: string): Promise<APIResponse<AgentPublishHistoryResponse>> {
+        return this.client.GET<AgentPublishHistoryResponse>("/v1/api/agents/{id}/publishes", {
+            params: { path: { id: agentId } },
+            headers: this.headers(),
+        });
+    }
+
+    async rollback(
+        agentId: string,
+        body: RollbackAgentRequest
+    ): Promise<APIResponse<AgentRollbackResponse>> {
+        return this.client.POST<AgentRollbackResponse>("/v1/api/agents/{id}/rollback", {
+            params: { path: { id: agentId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+
     // ======================== Bundles ========================
 
     /**

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.
      */