@agent-os-sdk/client 0.9.22 → 0.9.24

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": [
@@ -1290,6 +1419,76 @@
             "description": "Service Unavailable"
           }
         }
+      },
+      "post": {
+        "tags": [
+          "Agents"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PublishPreviewRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PublishPreviewRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/PublishPreviewRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PublishPreviewResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service Unavailable"
+          }
+        }
       }
     },
     "/v1/api/agents/{id}/draft/ir": {
@@ -10348,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": {
@@ -13203,6 +13537,54 @@
         },
         "additionalProperties": false
       },
+      "PublishPreviewDraftDiff": {
+        "type": "object",
+        "properties": {
+          "added_node_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "removed_node_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "modified_node_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "added_capability_refs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "removed_capability_refs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "binding_keys_impacted": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "PublishPreviewIssue": {
         "type": "object",
         "properties": {
@@ -13233,6 +13615,15 @@
         },
         "additionalProperties": false
       },
+      "PublishPreviewRequest": {
+        "type": "object",
+        "properties": {
+          "ir_json": {
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "PublishPreviewResponse": {
         "type": "object",
         "properties": {
@@ -13264,6 +13655,9 @@
             },
             "nullable": true
           },
+          "draft_diff": {
+            "$ref": "#/components/schemas/PublishPreviewDraftDiff"
+          },
           "blockers": {
             "type": "array",
             "items": {
@@ -13466,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": {

package/src/modules/agents.ts

@@ -84,6 +84,15 @@ export interface PublishPreviewBindingItem {
     credential_type_refs: string[];
 }
 
+export interface PublishPreviewDraftDiff {
+    added_node_ids: string[];
+    removed_node_ids: string[];
+    modified_node_ids: string[];
+    added_capability_refs: string[];
+    removed_capability_refs: string[];
+    binding_keys_impacted: string[];
+}
+
 export interface PublishPreviewResponse {
     agent_id: string;
     draft_ir_revision: string;
@@ -91,10 +100,54 @@ export interface PublishPreviewResponse {
     validation_result: PublishPreviewValidationResult;
     capabilities: PublishPreviewCapabilityItem[];
     bindings: PublishPreviewBindingItem[];
+    draft_diff: PublishPreviewDraftDiff;
     blockers: PublishPreviewIssue[];
     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;
@@ -350,7 +403,18 @@ export class AgentsModule {
         });
     }
 
-    async getPublishPreview(agentId: string): Promise<APIResponse<PublishPreviewResponse>> {
+    async getPublishPreview(
+        agentId: string,
+        irJson?: Record<string, unknown>
+    ): Promise<APIResponse<PublishPreviewResponse>> {
+        if (irJson) {
+            return this.client.POST<PublishPreviewResponse>("/v1/api/agents/{id}/publish-preview", {
+                params: { path: { id: agentId } },
+                body: { ir_json: irJson } as any,
+                headers: this.headers(),
+            });
+        }
+
         return this.client.GET<PublishPreviewResponse>("/v1/api/agents/{id}/publish-preview", {
             params: { path: { id: agentId } },
             headers: this.headers(),
@@ -439,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 ========================
 
     /**