@agent-os-sdk/client 0.5.2 → 0.5.3

package/src/generated/swagger.json

@@ -3315,6 +3315,256 @@
         }
       }
     },
+    "/v1/api/graph/commit": {
+      "post": {
+        "tags": [
+          "GraphSpec"
+        ],
+        "summary": "Commit GraphSpec — atomic, idempotent, validated.",
+        "description": "**Flow:**\n1. Validate spec_version (reject unsupported)\n2. Verify agent exists in workspace\n3. Check optimistic concurrency (expected_revision)\n4. Call DataPlane to validate/normalize\n5. Canonicalize JSON for deterministic hashing\n6. Idempotence: if revision unchanged, return no_change\n7. Persist with atomic check\n8. Return canonical spec + new revision\n\n**Status Codes:**\n- 200: Success (includes no_change case)\n- 400: Missing workspace\n- 404: Agent not found\n- 409: Revision mismatch (concurrent edit)\n- 422: Validation failed / unsupported spec version\n- 502: DataPlane unreachable",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CommitGraphSpecRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CommitGraphSpecRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/CommitGraphSpecRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommitGraphSpecResponseApiEnvelope"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Conflict",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Unprocessable Content",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "502": {
+            "description": "Bad Gateway",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/graph/{agentId}": {
+      "get": {
+        "tags": [
+          "GraphSpec"
+        ],
+        "summary": "Get current graph spec with revision.",
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetGraphSpecResponseApiEnvelope"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal Server Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/graph/{agentId}/revisions": {
+      "get": {
+        "tags": [
+          "GraphSpec"
+        ],
+        "summary": "List revision history for an agent (metadata only, not full spec).",
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "default": 50
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionListResponseApiEnvelope"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/graph/{agentId}/revisions/{revision}": {
+      "get": {
+        "tags": [
+          "GraphSpec"
+        ],
+        "summary": "Get a specific revision with full graph spec.",
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "revision",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionDetailResponseApiEnvelope"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/api/knowledge/datasets": {
       "get": {
         "tags": [
@@ -6380,8 +6630,25 @@
           }
         },
         "responses": {
-          "200": {
-            "description": "OK"
+          "201": {
+            "description": "Created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TriggerSecretResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
           }
         }
       },
@@ -6529,17 +6796,44 @@
         ],
         "responses": {
           "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/triggers/invoke/{triggerId}": {
-      "post": {
-        "tags": [
-          "Triggers"
-        ],
-        "summary": "Invoke a trigger to start an agent run.\nSECURITY: Requires HMAC-SHA256 signature over raw request body.\nSignature format: X-Signature: sha256=[64_lowercase_hex]\nPayload: X-Timestamp + \".\" + raw_request_body",
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TriggerSecretResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/triggers/invoke/{triggerId}": {
+      "post": {
+        "tags": [
+          "Triggers"
+        ],
+        "summary": "Invoke a trigger to start an agent run.\nSECURITY: Requires HMAC-SHA256 signature over raw request body.\nSignature format: X-Signature: sha256=[64_lowercase_hex]\nPayload: X-Timestamp + \".\" + raw_request_body",
         "parameters": [
           {
             "name": "triggerId",
@@ -7991,6 +8285,88 @@
         },
         "additionalProperties": false
       },
+      "CommitGraphSpecRequest": {
+        "type": "object",
+        "properties": {
+          "spec_version": {
+            "type": "string",
+            "nullable": true
+          },
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "graph_spec": { },
+          "expected_revision": {
+            "type": "string",
+            "nullable": true
+          },
+          "source": {
+            "type": "string",
+            "description": "Source of the commit: ui.dragdrop, ui.json, meta_builder, system",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "CommitGraphSpecResponse": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "type": "string",
+            "description": "Explicit status: committed, no_change, conflict",
+            "nullable": true
+          },
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "revision": {
+            "type": "string",
+            "nullable": true
+          },
+          "current_revision": {
+            "type": "string",
+            "description": "Only present in conflict response (409 body).",
+            "nullable": true
+          },
+          "canonical_spec": {
+            "nullable": true
+          },
+          "committed_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ValidationMessage"
+            },
+            "nullable": true
+          },
+          "validation": {
+            "$ref": "#/components/schemas/ValidationResult"
+          }
+        },
+        "additionalProperties": false
+      },
+      "CommitGraphSpecResponseApiEnvelope": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/CommitGraphSpecResponse"
+          },
+          "hints": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ApiHint"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "ConfirmUploadRequest": {
         "type": "object",
         "properties": {
@@ -8666,6 +9042,54 @@
         },
         "additionalProperties": false
       },
+      "GetGraphSpecResponse": {
+        "type": "object",
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "revision": {
+            "type": "string",
+            "nullable": true
+          },
+          "canonical_spec": {
+            "nullable": true
+          },
+          "committed_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ValidationMessage"
+            },
+            "nullable": true
+          },
+          "validation": {
+            "$ref": "#/components/schemas/ValidationResult"
+          }
+        },
+        "additionalProperties": false
+      },
+      "GetGraphSpecResponseApiEnvelope": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/GetGraphSpecResponse"
+          },
+          "hints": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ApiHint"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "GrantAccessRequest": {
         "type": "object",
         "properties": {
@@ -9140,6 +9564,117 @@
         },
         "additionalProperties": false
       },
+      "RevisionDetailResponse": {
+        "type": "object",
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "revision": {
+            "type": "string",
+            "nullable": true
+          },
+          "graph_spec": { },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "source": {
+            "type": "string",
+            "nullable": true
+          },
+          "actor_user_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ValidationMessage"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "RevisionDetailResponseApiEnvelope": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/RevisionDetailResponse"
+          },
+          "hints": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ApiHint"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "RevisionListItem": {
+        "type": "object",
+        "properties": {
+          "revision": {
+            "type": "string",
+            "nullable": true
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "source": {
+            "type": "string",
+            "nullable": true
+          },
+          "actor_user_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "RevisionListResponse": {
+        "type": "object",
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "total": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RevisionListItem"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "RevisionListResponseApiEnvelope": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/RevisionListResponse"
+          },
+          "hints": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ApiHint"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "RunDetailResponse": {
         "type": "object",
         "properties": {
@@ -9431,6 +9966,36 @@
         },
         "additionalProperties": false
       },
+      "SigningContract": {
+        "type": "object",
+        "properties": {
+          "algorithm": {
+            "type": "string",
+            "nullable": true
+          },
+          "signature_header": {
+            "type": "string",
+            "nullable": true
+          },
+          "timestamp_header": {
+            "type": "string",
+            "nullable": true
+          },
+          "timestamp_format": {
+            "type": "string",
+            "nullable": true
+          },
+          "string_to_sign": {
+            "type": "string",
+            "nullable": true
+          },
+          "signature_format": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "SpanData": {
         "type": "object",
         "properties": {
@@ -9663,6 +10228,86 @@
         },
         "additionalProperties": false
       },
+      "TriggerRequestContract": {
+        "type": "object",
+        "properties": {
+          "method": {
+            "type": "string",
+            "nullable": true
+          },
+          "invoke_url": {
+            "type": "string",
+            "nullable": true
+          },
+          "headers": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "signing": {
+            "$ref": "#/components/schemas/SigningContract"
+          },
+          "body_schema_json": {
+            "type": "string",
+            "nullable": true
+          },
+          "example_payload_json": {
+            "type": "string",
+            "nullable": true
+          },
+          "curl_example": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "TriggerSecretResponse": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "trigger_type": {
+            "type": "string",
+            "nullable": true
+          },
+          "secret_key": {
+            "type": "string",
+            "nullable": true
+          },
+          "invoke_url": {
+            "type": "string",
+            "nullable": true
+          },
+          "request_contract": {
+            "$ref": "#/components/schemas/TriggerRequestContract"
+          },
+          "is_active": {
+            "type": "boolean"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "additionalProperties": false
+      },
       "TriggerTemplateDto": {
         "required": [
           "kind",
@@ -9984,6 +10629,49 @@
         "additionalProperties": false,
         "description": "Validation error from graph validation.\nAligned with Data Plane validator output (RFC 6901 JSON Pointer paths)."
       },
+      "ValidationMessage": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "nullable": true
+          },
+          "message": {
+            "type": "string",
+            "nullable": true
+          },
+          "path": {
+            "type": "string",
+            "nullable": true
+          },
+          "node_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "severity": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "ValidationResult": {
+        "type": "object",
+        "properties": {
+          "valid": {
+            "type": "boolean"
+          },
+          "errors": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ValidationMessage"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Validation result block returned in all commit responses."
+      },
       "VectorQueryRequest": {
         "type": "object",
         "properties": {
@@ -10232,6 +10920,9 @@
     {
       "name": "Graphs"
     },
+    {
+      "name": "GraphSpec"
+    },
     {
       "name": "Knowledge"
     },