@agent-os-sdk/client 0.9.13 → 0.9.15

package/src/generated/swagger.json

@@ -114,15 +114,117 @@
         }
       }
     },
+    "/v1/api/agents/{agentId}/runtime-contexts": {
+      "get": {
+        "tags": [
+          "AgentRuntimeContexts"
+        ],
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/agents/{agentId}/runtime-contexts/{contextKey}": {
+      "get": {
+        "tags": [
+          "AgentRuntimeContexts"
+        ],
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "contextKey",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "AgentRuntimeContexts"
+        ],
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "contextKey",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpsertAgentRuntimeContextRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpsertAgentRuntimeContextRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpsertAgentRuntimeContextRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
     "/v1/api/agents": {
       "post": {
         "tags": [
           "Agents"
         ],
         "summary": "Creates a new agent in the current workspace.",
-        "description": "Creates a new agent with the specified configuration. The agent is created in draft mode\nand must have a version published before it can be used for runs.\n\n**Example Request:**\n```json\n{\n  \"name\": \"customer-support-agent\",\n  \"description\": \"Handles customer inquiries and support tickets\",\n  \"graph_spec\": { \"nodes\": [...], \"edges\": [...] }\n}\n```",
+        "description": "Creates a new agent in draft mode and seeds a minimal `agent_ir.v1`.\nThe agent must have a published artifact before it can be used for runs.\n\n**Example Request:**\n```json\n{\n  \"name\": \"customer-support-agent\"\n}\n```",
         "requestBody": {
-          "description": "The agent creation request containing name, description, and optional graph specification.",
+          "description": "The agent creation request containing the name and optional metadata.",
           "content": {
             "application/json": {
               "schema": {
@@ -405,6 +507,98 @@
         }
       }
     },
+    "/v1/api/agents/{id}/credential-bindings": {
+      "post": {
+        "tags": [
+          "Agents"
+        ],
+        "summary": "Creates or updates a credential binding for an agent alias.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The agent identifier.",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Binding payload (credential id, alias, priority).",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpsertAgentCredentialBindingRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpsertAgentCredentialBindingRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpsertAgentCredentialBindingRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UpsertAgentCredentialBindingResponse"
+                }
+              }
+            }
+          },
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UpsertAgentCredentialBindingResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "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/agents/{id}/publish": {
       "post": {
         "tags": [
@@ -495,13 +689,12 @@
         }
       }
     },
-    "/v1/api/agents/{id}/draft/graph": {
+    "/v1/api/agents/{id}/draft/ir": {
       "get": {
         "tags": [
           "Agents"
         ],
-        "summary": "Gets the draft graph specification for an agent.",
-        "description": "Returns the current draft graph JSON as saved by autosave.\nStudio should use this as source of truth, not generate graphs locally.\n\n**Response includes ETag** for subsequent PUT If-Match.",
+        "summary": "Gets the draft authoring IR (`agent_ir.v1`) for an agent.",
         "parameters": [
           {
             "name": "id",
@@ -519,7 +712,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AgentDraftResponse"
+                  "$ref": "#/components/schemas/AgentDraftIrResponse"
                 }
               }
             }
@@ -533,6 +726,9 @@
                 }
               }
             }
+          },
+          "500": {
+            "description": "Internal Server Error"
           }
         }
       },
@@ -540,8 +736,7 @@
         "tags": [
           "Agents"
         ],
-        "summary": "Updates the draft graph specification for an agent (autosave/resume).",
-        "description": "**IMPORTANT:** Draft is for UI autosave only. Publish does NOT read from draft.\nPublish continues to use `request.GraphSpec` as the canonical source.\n\nRequires `If-Match` header with ETag from previous GET/PUT.\n\n**ETag Format:**\n- Header: `\"agentId:ticks\"` (with quotes)\n- Body: `agentId:ticks` (no quotes)\n\n**Hints (in ProblemDetails.Extensions):**\n- 428: `include_if_match` - SDK should auto-fetch ETag\n- 412: `reload_and_retry` - Front should refetch and confirm\n- 400: `fix_payload` - Editor should show validation error",
+        "summary": "Updates the draft authoring IR (`agent_ir.v1`) for an agent.",
         "parameters": [
           {
             "name": "id",
@@ -557,17 +752,17 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/UpdateDraftGraphRequest"
+                "$ref": "#/components/schemas/UpdateDraftIrRequest"
               }
             },
             "text/json": {
               "schema": {
-                "$ref": "#/components/schemas/UpdateDraftGraphRequest"
+                "$ref": "#/components/schemas/UpdateDraftIrRequest"
               }
             },
             "application/*+json": {
               "schema": {
-                "$ref": "#/components/schemas/UpdateDraftGraphRequest"
+                "$ref": "#/components/schemas/UpdateDraftIrRequest"
               }
             }
           }
@@ -578,7 +773,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AgentDraftResponseApiEnvelope"
+                  "$ref": "#/components/schemas/AgentDraftIrResponseApiEnvelope"
                 }
               }
             }
@@ -622,6 +817,12 @@
                 }
               }
             }
+          },
+          "500": {
+            "description": "Internal Server Error"
+          },
+          "503": {
+            "description": "Service Unavailable"
           }
         }
       }
@@ -1199,13 +1400,12 @@
         }
       }
     },
-    "/v1/api/builder/{agentId}/chat": {
-      "post": {
+    "/v1/api/agents/{agentId}/bundles/{bundleId}/manifest": {
+      "get": {
         "tags": [
-          "Builder"
+          "BundleManifest"
         ],
-        "summary": "Chat with the Meta-Agent to modify an agent's graph.\nReturns SSE stream: message, graph_update, done events.",
-        "description": "KERNEL: Frontend sends intention only. CP loads everything from DB.\nSECURITY: X-Workspace-Id header is MANDATORY for workspace isolation.",
+        "summary": "Get artifact manifest for a bundle.",
         "parameters": [
           {
             "name": "agentId",
@@ -1215,43 +1415,9 @@
               "type": "string",
               "format": "uuid"
             }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BuilderChatRequest"
-              }
-            },
-            "text/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BuilderChatRequest"
-              }
-            },
-            "application/*+json": {
-              "schema": {
-                "$ref": "#/components/schemas/BuilderChatRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/builder/{agentId}/chat/sync": {
-      "post": {
-        "tags": [
-          "Builder"
-        ],
-        "summary": "Synchronous version of builder chat (for testing).",
-        "parameters": [
+          },
           {
-            "name": "agentId",
+            "name": "bundleId",
             "in": "path",
             "required": true,
             "schema": {
@@ -1260,25 +1426,6 @@
             }
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BuilderChatRequest"
-              }
-            },
-            "text/json": {
-              "schema": {
-                "$ref": "#/components/schemas/BuilderChatRequest"
-              }
-            },
-            "application/*+json": {
-              "schema": {
-                "$ref": "#/components/schemas/BuilderChatRequest"
-              }
-            }
-          }
-        },
         "responses": {
           "200": {
             "description": "OK"
@@ -1286,12 +1433,12 @@
         }
       }
     },
-    "/v1/api/agents/{agentId}/bundles/{bundleId}/manifest": {
+    "/v1/api/agents/{agentId}/bundles/{bundleId}/graph/mermaid": {
       "get": {
         "tags": [
           "BundleManifest"
         ],
-        "summary": "Get artifact manifest for a bundle.",
+        "summary": "Get Mermaid diagram for graph.",
         "parameters": [
           {
             "name": "agentId",
@@ -1319,52 +1466,19 @@
         }
       }
     },
-    "/v1/api/agents/{agentId}/bundles/{bundleId}/graph/mermaid": {
+    "/v1/api/catalog/nodes": {
       "get": {
         "tags": [
-          "BundleManifest"
+          "Catalog"
         ],
-        "summary": "Get Mermaid diagram for graph.",
         "parameters": [
           {
-            "name": "agentId",
-            "in": "path",
-            "required": true,
+            "name": "version",
+            "in": "query",
             "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "bundleId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/catalog/nodes": {
-      "get": {
-        "tags": [
-          "Catalog"
-        ],
-        "parameters": [
-          {
-            "name": "version",
-            "in": "query",
-            "schema": {
-              "type": "integer",
-              "format": "int32",
-              "default": 1
+              "type": "integer",
+              "format": "int32",
+              "default": 1
             }
           }
         ],
@@ -1686,6 +1800,139 @@
         }
       }
     },
+    "/v1/api/contracts/supported": {
+      "get": {
+        "tags": [
+          "Contracts"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SupportedContractsResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal Server Error"
+          },
+          "503": {
+            "description": "Service Unavailable"
+          }
+        }
+      }
+    },
+    "/v1/api/contracts/validate": {
+      "post": {
+        "tags": [
+          "Contracts"
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ValidateContractRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ValidateContractRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/ValidateContractRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ValidateContractResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal Server Error"
+          },
+          "503": {
+            "description": "Service Unavailable"
+          }
+        }
+      }
+    },
+    "/v1/api/contracts/compile/runtime-package": {
+      "post": {
+        "tags": [
+          "Contracts"
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CompileRuntimePackageRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CompileRuntimePackageRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/CompileRuntimePackageRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CompileRuntimePackageResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal Server Error"
+          },
+          "503": {
+            "description": "Service Unavailable"
+          }
+        }
+      }
+    },
     "/v1/api/credentials": {
       "get": {
         "tags": [
@@ -3198,362 +3445,10 @@
           {
             "name": "fileId",
             "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/FileDetail"
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Not Found",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "Files"
-        ],
-        "summary": "Soft delete a file.",
-        "parameters": [
-          {
-            "name": "workspaceId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "fileId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "204": {
-            "description": "No Content"
-          },
-          "404": {
-            "description": "Not Found",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/api/observability/frontend-log": {
-      "post": {
-        "tags": [
-          "FrontendObservability"
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/FrontendLogIngestRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/graphs/validate": {
-      "post": {
-        "tags": [
-          "Graphs"
-        ],
-        "summary": "Validate graph structure without compiling.",
-        "description": "Does NOT require LLM credentials - only validates nodes/edges structure.\nReturns Mermaid diagram if valid, or detailed errors if invalid.\nUse this endpoint for real-time graph builder validation.",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ValidateGraphRequest"
-              }
-            },
-            "text/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ValidateGraphRequest"
-              }
-            },
-            "application/*+json": {
-              "schema": {
-                "$ref": "#/components/schemas/ValidateGraphRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OK",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ValidateGraphResponse"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Bad Request",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Internal Server Error"
-          },
-          "503": {
-            "description": "Service Unavailable"
-          }
-        }
-      }
-    },
-    "/v1/api/graphs/introspect": {
-      "post": {
-        "tags": [
-          "Graphs"
-        ],
-        "summary": "Introspect a graph_spec with credentials and return its Mermaid diagram.",
-        "description": "Requires LLM credentials for compilation.\nUse this endpoint when you need the actual LangGraph compiled structure.",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/IntrospectGraphRequest"
-              }
-            },
-            "text/json": {
-              "schema": {
-                "$ref": "#/components/schemas/IntrospectGraphRequest"
-              }
-            },
-            "application/*+json": {
-              "schema": {
-                "$ref": "#/components/schemas/IntrospectGraphRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/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",
+            "required": true,
             "schema": {
-              "type": "integer",
-              "format": "int32",
-              "default": 50
+              "type": "string",
+              "format": "uuid"
             }
           }
         ],
@@ -3563,13 +3458,13 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/RevisionListResponseApiEnvelope"
+                  "$ref": "#/components/schemas/FileDetail"
                 }
               }
             }
           },
-          "400": {
-            "description": "Bad Request",
+          "404": {
+            "description": "Not Found",
             "content": {
               "application/json": {
                 "schema": {
@@ -3579,17 +3474,15 @@
             }
           }
         }
-      }
-    },
-    "/v1/api/graph/{agentId}/revisions/{revision}": {
-      "get": {
+      },
+      "delete": {
         "tags": [
-          "GraphSpec"
+          "Files"
         ],
-        "summary": "Get a specific revision with full graph spec.",
+        "summary": "Soft delete a file.",
         "parameters": [
           {
-            "name": "agentId",
+            "name": "workspaceId",
             "in": "path",
             "required": true,
             "schema": {
@@ -3598,24 +3491,18 @@
             }
           },
           {
-            "name": "revision",
+            "name": "fileId",
             "in": "path",
             "required": true,
             "schema": {
-              "type": "string"
+              "type": "string",
+              "format": "uuid"
             }
           }
         ],
         "responses": {
-          "200": {
-            "description": "OK",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/RevisionDetailResponseApiEnvelope"
-                }
-              }
-            }
+          "204": {
+            "description": "No Content"
           },
           "404": {
             "description": "Not Found",
@@ -3630,6 +3517,27 @@
         }
       }
     },
+    "/v1/api/observability/frontend-log": {
+      "post": {
+        "tags": [
+          "FrontendObservability"
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/FrontendLogIngestRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
     "/v1/api/me": {
       "get": {
         "tags": [
@@ -4030,38 +3938,6 @@
         }
       }
     },
-    "/v1/api/playground/dry-run": {
-      "post": {
-        "tags": [
-          "Playground"
-        ],
-        "summary": "Dry run - compile and validate only, no execution.",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/DryRunRequest"
-              }
-            },
-            "text/json": {
-              "schema": {
-                "$ref": "#/components/schemas/DryRunRequest"
-              }
-            },
-            "application/*+json": {
-              "schema": {
-                "$ref": "#/components/schemas/DryRunRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
     "/v1/api/prompts": {
       "post": {
         "tags": [
@@ -7373,7 +7249,7 @@
           "VectorStores"
         ],
         "summary": "Creates a new vector store for semantic document search.",
-        "description": "Creates a vector store with the specified embedding configuration.\nThe store is ready to accept file attachments immediately after creation.\n\n**Default Configuration:**\n- Provider: `openai`\n- Model: `text-embedding-3-small`\n- Dimension: `1536`",
+        "description": "Creates a vector store with the specified embedding configuration.\nThe store is ready to accept file attachments immediately after creation.\n\n**Default Configuration:**\n- Provider: `google_ai`\n- Model: `gemini-embedding-001`\n- Dimension: `1536`",
         "requestBody": {
           "description": "Vector store configuration.",
           "content": {
@@ -7874,6 +7750,19 @@
         }
       }
     },
+    "/v1/api/workspaces/events/stream": {
+      "get": {
+        "tags": [
+          "WorkspaceEvents"
+        ],
+        "summary": "Stream workspace events via SSE.\nWorkspace is resolved from X-Workspace-Id header (standard auth flow).",
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
     "/v1/api/workspaces": {
       "get": {
         "tags": [
@@ -8209,7 +8098,7 @@
         },
         "additionalProperties": false
       },
-      "AgentDraftResponse": {
+      "AgentDraftIrResponse": {
         "type": "object",
         "properties": {
           "id": {
@@ -8220,7 +8109,7 @@
             "type": "string",
             "nullable": true
           },
-          "draft_graph_revision": {
+          "draft_ir_revision": {
             "type": "string",
             "nullable": true
           },
@@ -8237,15 +8126,18 @@
           "e_tag": {
             "type": "string",
             "nullable": true
+          },
+          "ir_json": {
+            "nullable": true
           }
         },
         "additionalProperties": false
       },
-      "AgentDraftResponseApiEnvelope": {
+      "AgentDraftIrResponseApiEnvelope": {
         "type": "object",
         "properties": {
           "data": {
-            "$ref": "#/components/schemas/AgentDraftResponse"
+            "$ref": "#/components/schemas/AgentDraftIrResponse"
           },
           "hints": {
             "type": "array",
@@ -8495,32 +8387,6 @@
         },
         "additionalProperties": false
       },
-      "BuilderChatRequest": {
-        "type": "object",
-        "properties": {
-          "message": {
-            "type": "string",
-            "nullable": true
-          },
-          "thread_id": {
-            "type": "string",
-            "nullable": true
-          },
-          "history": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/ChatHistoryMessage"
-            },
-            "nullable": true
-          },
-          "base_graph_etag": {
-            "type": "string",
-            "nullable": true
-          }
-        },
-        "additionalProperties": false,
-        "description": "KERNEL P0: Request DTO for builder chat.\nContains ONLY intention fields. No graph_spec, no catalogs."
-      },
       "BundleResponse": {
         "type": "object",
         "properties": {
@@ -8621,20 +8487,6 @@
         "type": "integer",
         "format": "int32"
       },
-      "ChatHistoryMessage": {
-        "type": "object",
-        "properties": {
-          "role": {
-            "type": "string",
-            "nullable": true
-          },
-          "content": {
-            "type": "string",
-            "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
       "CheckpointDetail": {
         "type": "object",
         "properties": {
@@ -8660,6 +8512,7 @@
           },
           "parent_checkpoint_id": {
             "type": "string",
+            "format": "uuid",
             "nullable": true
           },
           "has_state_snapshot": {
@@ -8756,6 +8609,7 @@
           },
           "parent_checkpoint_id": {
             "type": "string",
+            "format": "uuid",
             "nullable": true
           },
           "created_at": {
@@ -8772,85 +8626,35 @@
         },
         "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": {
+      "CompileRuntimePackageRequest": {
         "type": "object",
         "properties": {
-          "status": {
-            "type": "string",
-            "description": "Explicit status: committed, no_change, conflict",
+          "ir_spec": { },
+          "capability_registry_spec": { },
+          "policy_refs": {
             "nullable": true
           },
-          "agent_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "revision": {
-            "type": "string",
+          "runtime_config_refs": {
             "nullable": true
           },
-          "current_revision": {
+          "package_id": {
             "type": "string",
-            "description": "Only present in conflict response (409 body).",
             "nullable": true
           },
-          "canonical_spec": {
+          "metadata": {
             "nullable": true
           },
-          "committed_at": {
+          "compiled_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": {
+      "CompileRuntimePackageResponse": {
         "type": "object",
         "properties": {
-          "data": {
-            "$ref": "#/components/schemas/CommitGraphSpecResponse"
-          },
-          "hints": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/ApiHint"
-            },
-            "nullable": true
-          }
+          "package_spec": { }
         },
         "additionalProperties": false
       },
@@ -8894,6 +8698,7 @@
           },
           "parent_checkpoint_id": {
             "type": "string",
+            "format": "uuid",
             "nullable": true
           }
         },
@@ -9169,6 +8974,11 @@
             "type": "string",
             "format": "uuid",
             "nullable": true
+          },
+          "correlation_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -9306,10 +9116,6 @@
             "type": "string",
             "nullable": true
           },
-          "embedding_provider": {
-            "type": "string",
-            "nullable": true
-          },
           "embedding_model": {
             "type": "string",
             "nullable": true
@@ -9514,19 +9320,6 @@
         },
         "additionalProperties": false
       },
-      "DryRunRequest": {
-        "type": "object",
-        "properties": {
-          "agent_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "graph_spec": {
-            "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
       "EnsureMembershipRequest": {
         "type": "object",
         "properties": {
@@ -9749,54 +9542,6 @@
         },
         "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": {
@@ -9832,40 +9577,14 @@
           },
           "warnings": {
             "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "nullable": true
-          }
-        },
-        "additionalProperties": false,
-        "description": "Response for POST /triggers/{id}/infer-schema"
-      },
-      "IntrospectGraphRequest": {
-        "type": "object",
-        "properties": {
-          "graph_spec": {
-            "type": "object",
-            "additionalProperties": { },
-            "nullable": true
-          },
-          "credentials": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "additionalProperties": { }
-            },
-            "nullable": true
-          },
-          "catalog_versions": {
-            "type": "object",
-            "additionalProperties": {
+            "items": {
               "type": "string"
             },
             "nullable": true
           }
         },
-        "additionalProperties": false
+        "additionalProperties": false,
+        "description": "Response for POST /triggers/{id}/infer-schema"
       },
       "InviteMemberRequest": {
         "type": "object",
@@ -10399,9 +10118,6 @@
             "type": "string",
             "nullable": true
           },
-          "graph_spec": {
-            "nullable": true
-          },
           "set_as_live": {
             "type": "boolean"
           },
@@ -10551,117 +10267,6 @@
         },
         "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
-      },
       "RoleContextDto": {
         "type": "object",
         "properties": {
@@ -10799,6 +10404,19 @@
           "payload": {
             "nullable": true
           },
+          "operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "parent_operation_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          },
+          "root_operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
           "truncated": {
             "type": "boolean"
           }
@@ -11123,6 +10741,19 @@
         },
         "additionalProperties": false
       },
+      "SupportedContractsResponse": {
+        "type": "object",
+        "properties": {
+          "contract_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "TenantContextDto": {
         "type": "object",
         "properties": {
@@ -11634,10 +11265,10 @@
         },
         "additionalProperties": false
       },
-      "UpdateDraftGraphRequest": {
+      "UpdateDraftIrRequest": {
         "type": "object",
         "properties": {
-          "graphJson": {
+          "ir_json": {
             "nullable": true
           }
         },
@@ -11729,6 +11360,67 @@
         },
         "additionalProperties": false
       },
+      "UpsertAgentCredentialBindingRequest": {
+        "type": "object",
+        "properties": {
+          "credential_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "alias": {
+            "type": "string",
+            "nullable": true
+          },
+          "priority": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "additionalProperties": false
+      },
+      "UpsertAgentCredentialBindingResponse": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "updated": {
+            "type": "boolean"
+          },
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "credential_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "alias": {
+            "type": "string",
+            "nullable": true
+          },
+          "priority": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "additionalProperties": false
+      },
+      "UpsertAgentRuntimeContextRequest": {
+        "type": "object",
+        "properties": {
+          "content": {
+            "type": "string",
+            "nullable": true
+          },
+          "source": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "UserContextResponse": {
         "type": "object",
         "properties": {
@@ -11759,55 +11451,38 @@
         },
         "additionalProperties": false
       },
-      "ValidateGraphRequest": {
+      "ValidateContractRequest": {
         "type": "object",
         "properties": {
-          "graph_spec": {
-            "type": "object",
-            "additionalProperties": { },
+          "contract_id": {
+            "type": "string",
             "nullable": true
           },
-          "catalog_versions": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "string"
-            },
-            "nullable": true
-          }
+          "spec": { }
         },
         "additionalProperties": false
       },
-      "ValidateGraphResponse": {
+      "ValidateContractResponse": {
         "type": "object",
         "properties": {
-          "valid": {
-            "type": "boolean"
-          },
-          "mermaid": {
+          "contract_id": {
             "type": "string",
             "nullable": true
           },
-          "nodes": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "nullable": true
+          "valid": {
+            "type": "boolean"
           },
-          "edges": {
+          "errors": {
             "type": "array",
             "items": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
+              "$ref": "#/components/schemas/ValidationIssueDto"
             },
             "nullable": true
           },
-          "errors": {
+          "warnings": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/ValidationError"
+              "$ref": "#/components/schemas/ValidationIssueDto"
             },
             "nullable": true
           }
@@ -11839,34 +11514,7 @@
         },
         "additionalProperties": false
       },
-      "ValidationError": {
-        "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,
-        "description": "Validation error from graph validation.\nAligned with Data Plane validator output (RFC 6901 JSON Pointer paths)."
-      },
-      "ValidationMessage": {
+      "ValidationIssueDto": {
         "type": "object",
         "properties": {
           "code": {
@@ -11881,10 +11529,6 @@
             "type": "string",
             "nullable": true
           },
-          "node_id": {
-            "type": "string",
-            "nullable": true
-          },
           "severity": {
             "type": "string",
             "nullable": true
@@ -11892,23 +11536,6 @@
         },
         "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": {
@@ -12173,6 +11800,9 @@
     {
       "name": "AgentPortability"
     },
+    {
+      "name": "AgentRuntimeContexts"
+    },
     {
       "name": "Agents"
     },
@@ -12188,9 +11818,6 @@
     {
       "name": "AuthBootstrap"
     },
-    {
-      "name": "Builder"
-    },
     {
       "name": "BundleManifest"
     },
@@ -12200,6 +11827,9 @@
     {
       "name": "Checkpoints"
     },
+    {
+      "name": "Contracts"
+    },
     {
       "name": "Credentials"
     },
@@ -12218,12 +11848,6 @@
     {
       "name": "FrontendObservability"
     },
-    {
-      "name": "Graphs"
-    },
-    {
-      "name": "GraphSpec"
-    },
     {
       "name": "Me"
     },
@@ -12269,6 +11893,9 @@
     {
       "name": "VectorStores"
     },
+    {
+      "name": "WorkspaceEvents"
+    },
     {
       "name": "Workspaces"
     },