@agent-os-sdk/client 0.4.2 → 0.4.4

package/src/generated/swagger.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.4",
   "info": {
-    "title": "AgentOs.Api, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null",
+    "title": "AgentOs.Api",
     "version": "1.0"
   },
   "paths": {
@@ -42,7 +42,7 @@
         "tags": [
           "AgentPortability"
         ],
-        "summary": "Export an agent with all its versions.",
+        "summary": "Export an agent with all its bundles.",
         "parameters": [
           {
             "name": "id",
@@ -67,33 +67,32 @@
           "AgentPortability"
         ],
         "summary": "Import an agent bundle.",
-        "description": "Imports an agent bundle into the current tenant/workspace.\nThe agent and all versions are created with new IDs to avoid conflicts.\n\n**Security:**\n- Tenant and workspace are resolved from the authenticated context\n- Original IDs from the bundle are replaced with new GUIDs",
+        "description": "Imports an agent bundle into the current tenant/workspace.\nThe agent and all bundles are created with new IDs to avoid conflicts.\n\n**Security:**\n- Tenant and workspace are resolved from the authenticated context\n- Original IDs from the bundle are replaced with new GUIDs\n- LiveBundleId is preserved via ID mapping",
         "requestBody": {
-          "description": "The agent bundle to import.",
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/AgentBundle"
+                "$ref": "#/components/schemas/AgentExportBundle"
               }
             },
             "text/json": {
               "schema": {
-                "$ref": "#/components/schemas/AgentBundle"
+                "$ref": "#/components/schemas/AgentExportBundle"
               }
             },
             "application/*+json": {
               "schema": {
-                "$ref": "#/components/schemas/AgentBundle"
+                "$ref": "#/components/schemas/AgentExportBundle"
               }
             }
           }
         },
         "responses": {
           "201": {
-            "description": "Agent imported successfully."
+            "description": "Created"
           },
           "400": {
-            "description": "Invalid bundle format.",
+            "description": "Bad Request",
             "content": {
               "application/json": {
                 "schema": {
@@ -103,7 +102,7 @@
             }
           },
           "401": {
-            "description": "Authentication required or missing workspace context.",
+            "description": "Unauthorized",
             "content": {
               "application/json": {
                 "schema": {
@@ -406,130 +405,16 @@
         }
       }
     },
-    "/v1/api/agents/{id}/graph": {
-      "get": {
+    "/v1/api/agents/{id}/publish": {
+      "post": {
         "tags": [
           "Agents"
         ],
-        "summary": "Gets a Mermaid diagram representation of the agent's graph.",
-        "description": "Returns the agent's workflow as a Mermaid diagram string that can be rendered\nin any Mermaid-compatible viewer. Uses the currently live version of the agent.\n\n**Example Response:**\n```json\n{\n  \"mermaid\": \"graph TD\\n    START --> LLM --> END\",\n  \"agent_id\": \"...\",\n  \"live_version_id\": \"...\"\n}\n```",
+        "summary": "Publishes a new version (bundle) of the agent.",
         "parameters": [
           {
             "name": "id",
             "in": "path",
-            "description": "The unique identifier (GUID) of the agent.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Returns the Mermaid graph representation."
-          },
-          "401": {
-            "description": "Authentication required.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Agent not found or not accessible.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/api/agents/{agentId}/versions/{versionId}/manifest": {
-      "get": {
-        "tags": [
-          "AgentVersionManifest"
-        ],
-        "summary": "Get artifact manifest for a version.",
-        "parameters": [
-          {
-            "name": "agentId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "versionId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/agents/{agentId}/versions/{versionId}/graph/mermaid": {
-      "get": {
-        "tags": [
-          "AgentVersionManifest"
-        ],
-        "summary": "Get Mermaid diagram for graph.",
-        "parameters": [
-          {
-            "name": "agentId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "versionId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/agents/{agentId}/versions": {
-      "post": {
-        "tags": [
-          "AgentVersions"
-        ],
-        "summary": "Creates a new version for an agent.",
-        "description": "Creates an immutable snapshot of the agent's configuration. The new version\ncan optionally be marked as the live version immediately.\n\n**Example Request:**\n```json\n{\n  \"version_tag\": \"v1.2.0\",\n  \"graph_spec\": { \"nodes\": [...], \"edges\": [...] },\n  \"set_live\": true\n}\n```",
-        "parameters": [
-          {
-            "name": "agentId",
-            "in": "path",
-            "description": "The unique identifier of the parent agent.",
             "required": true,
             "schema": {
               "type": "string",
@@ -538,51 +423,37 @@
           }
         ],
         "requestBody": {
-          "description": "The version creation request with graph specification.",
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/CreateAgentVersionRequest"
+                "$ref": "#/components/schemas/PublishAgentRequest"
               }
             },
             "text/json": {
               "schema": {
-                "$ref": "#/components/schemas/CreateAgentVersionRequest"
+                "$ref": "#/components/schemas/PublishAgentRequest"
               }
             },
             "application/*+json": {
               "schema": {
-                "$ref": "#/components/schemas/CreateAgentVersionRequest"
+                "$ref": "#/components/schemas/PublishAgentRequest"
               }
             }
           }
         },
         "responses": {
-          "201": {
-            "description": "Version created successfully."
-          },
-          "400": {
-            "description": "Invalid request body or validation error.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
-          },
-          "401": {
-            "description": "Authentication required.",
+          "200": {
+            "description": "OK",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
+                  "$ref": "#/components/schemas/BundleResponse"
                 }
               }
             }
           },
           "404": {
-            "description": "Parent agent not found.",
+            "description": "Not Found",
             "content": {
               "application/json": {
                 "schema": {
@@ -590,33 +461,9 @@
                 }
               }
             }
-          }
-        }
-      },
-      "get": {
-        "tags": [
-          "AgentVersions"
-        ],
-        "summary": "Lists all versions for an agent.",
-        "description": "Returns all versions of the specified agent, ordered by creation date (newest first).\nThe response includes which version is currently set as \"live\".",
-        "parameters": [
-          {
-            "name": "agentId",
-            "in": "path",
-            "description": "The unique identifier of the agent.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Returns the list of versions."
           },
-          "401": {
-            "description": "Authentication required.",
+          "400": {
+            "description": "Bad Request",
             "content": {
               "application/json": {
                 "schema": {
@@ -624,110 +471,9 @@
                 }
               }
             }
-          }
-        }
-      }
-    },
-    "/v1/api/agents/{agentId}/versions/{versionId}": {
-      "get": {
-        "tags": [
-          "AgentVersions"
-        ],
-        "summary": "Retrieves a specific version by its identifier.",
-        "description": "Returns the full details of a specific agent version, including its\ngraph specification and all configuration settings.",
-        "parameters": [
-          {
-            "name": "agentId",
-            "in": "path",
-            "description": "The unique identifier of the parent agent.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "versionId",
-            "in": "path",
-            "description": "The unique identifier of the version to retrieve.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Returns the version details."
           },
           "401": {
-            "description": "Authentication required.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Version not found.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
-          }
-        }
-      },
-      "patch": {
-        "tags": [
-          "AgentVersions"
-        ],
-        "summary": "Updates are not allowed - versions are immutable.",
-        "description": "Agent versions are immutable by design. This endpoint always returns a 409 Conflict\nto enforce this invariant. To change an agent's behavior, create a new version instead.\n\n**Why immutability?**\n- Reproducibility: Every run can be traced to an exact version\n- Auditability: Version history provides a complete changelog\n- Rollback: Easy to revert to any previous version",
-        "parameters": [
-          {
-            "name": "agentId",
-            "in": "path",
-            "description": "The unique identifier of the parent agent.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "versionId",
-            "in": "path",
-            "description": "The unique identifier of the version.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "requestBody": {
-          "description": "The update request (ignored - updates not allowed).",
-          "content": {
-            "application/json": {
-              "schema": { }
-            },
-            "text/json": {
-              "schema": { }
-            },
-            "application/*+json": {
-              "schema": { }
-            }
-          }
-        },
-        "responses": {
-          "409": {
-            "description": "Versions are immutable. Create a new version instead.",
+            "description": "Unauthorized",
             "content": {
               "application/json": {
                 "schema": {
@@ -739,56 +485,28 @@
         }
       }
     },
-    "/v1/api/agents/{agentId}/versions/{versionId}/bundle": {
+    "/v1/api/agents/{id}/graph": {
       "get": {
         "tags": [
-          "AgentVersions"
+          "Agents"
         ],
-        "summary": "Gets the full execution bundle for a version including resolved graph_spec.",
-        "description": "Returns the complete graph specification and metadata for a version.\nThe graph_spec is fully resolved - no need to fetch artifacts separately.\n\n**Caching:** Uses strong ETag based on artifact_hash for efficient caching.\nInclude `If-None-Match` header to get 304 Not Modified when content unchanged.\n\n**Example Response:**\n```json\n{\n  \"version\": { \"id\": \"...\", \"version_tag\": \"v1.2.0\", ... },\n  \"graph_spec\": { \"nodes\": [...], \"edges\": [...] },\n  \"artifact_hash\": \"a1b2c3...\",\n  \"format\": \"langgraph_json_v1\",\n  \"resolved_at\": \"2024-01-01T12:00:00Z\"\n}\n```",
+        "summary": "Gets a Mermaid diagram representation of the agent's graph.",
+        "description": "Returns the agent's workflow as a Mermaid diagram string that can be rendered\nin any Mermaid-compatible viewer. Uses the currently live version of the agent.\n\n**Example Response:**\n```json\n{\n  \"mermaid\": \"graph TD\\n    START --> LLM --> END\",\n  \"agent_id\": \"...\",\n  \"live_version_id\": \"...\"\n}\n```",
         "parameters": [
           {
-            "name": "agentId",
-            "in": "path",
-            "description": "The unique identifier of the parent agent.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "versionId",
+            "name": "id",
             "in": "path",
-            "description": "The unique identifier of the version to retrieve.",
+            "description": "The unique identifier (GUID) of the agent.",
             "required": true,
             "schema": {
               "type": "string",
               "format": "uuid"
             }
-          },
-          {
-            "name": "If-None-Match",
-            "in": "header",
-            "description": "Optional ETag for cache validation (304 support).",
-            "schema": {
-              "type": "string"
-            }
           }
         ],
         "responses": {
           "200": {
-            "description": "Returns the full bundle.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AgentVersionBundleResponse"
-                }
-              }
-            }
-          },
-          "304": {
-            "description": "Content not modified (ETag matched)."
+            "description": "Returns the Mermaid graph representation."
           },
           "401": {
             "description": "Authentication required.",
@@ -801,7 +519,7 @@
             }
           },
           "404": {
-            "description": "Agent or version not found.",
+            "description": "Agent not found or not accessible.",
             "content": {
               "application/json": {
                 "schema": {
@@ -1216,6 +934,50 @@
           "Builder"
         ],
         "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.",
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "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",
@@ -1245,7 +1007,40 @@
               }
             }
           }
-        },
+        },
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/agents/{agentId}/bundles/{bundleId}/manifest": {
+      "get": {
+        "tags": [
+          "BundleManifest"
+        ],
+        "summary": "Get artifact manifest for a bundle.",
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "bundleId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
         "responses": {
           "200": {
             "description": "OK"
@@ -1253,12 +1048,12 @@
         }
       }
     },
-    "/v1/api/builder/{agentId}/chat/sync": {
-      "post": {
+    "/v1/api/agents/{agentId}/bundles/{bundleId}/graph/mermaid": {
+      "get": {
         "tags": [
-          "Builder"
+          "BundleManifest"
         ],
-        "summary": "Synchronous version of builder chat (for testing).",
+        "summary": "Get Mermaid diagram for graph.",
         "parameters": [
           {
             "name": "agentId",
@@ -1268,27 +1063,17 @@
               "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"
-              }
+          },
+          {
+            "name": "bundleId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
             }
           }
-        },
+        ],
         "responses": {
           "200": {
             "description": "OK"
@@ -1301,19 +1086,29 @@
         "tags": [
           "Catalog"
         ],
-        "summary": "Get the Node Catalog (v1).",
+        "summary": "Get the Node Types Catalog.",
         "parameters": [
           {
             "name": "version",
             "in": "query",
+            "description": "API version (default: 1)",
             "schema": {
-              "type": "string"
+              "type": "integer",
+              "format": "int32",
+              "default": 1
             }
           }
         ],
         "responses": {
           "200": {
-            "description": "OK"
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NodeCatalogResponse"
+                }
+              }
+            }
           }
         }
       }
@@ -1323,19 +1118,61 @@
         "tags": [
           "Catalog"
         ],
-        "summary": "Get the Trigger Templates Catalog (v1).",
+        "summary": "Get the Trigger Templates Catalog.",
         "parameters": [
           {
             "name": "version",
             "in": "query",
+            "description": "API version (default: 1)",
             "schema": {
-              "type": "string"
+              "type": "integer",
+              "format": "int32",
+              "default": 1
             }
           }
         ],
         "responses": {
           "200": {
-            "description": "OK"
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TriggerTemplatesCatalogResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/catalog/presets": {
+      "get": {
+        "tags": [
+          "Catalog"
+        ],
+        "summary": "Get the Node Presets Catalog.",
+        "parameters": [
+          {
+            "name": "version",
+            "in": "query",
+            "description": "API version (default: 1)",
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "default": 1
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NodePresetsCatalogResponse"
+                }
+              }
+            }
           }
         }
       }
@@ -1672,6 +1509,39 @@
       }
     },
     "/v1/api/credentials/{id}": {
+      "get": {
+        "tags": [
+          "Credentials"
+        ],
+        "summary": "Gets a single credential by ID.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The credential ID.",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns the credential."
+          },
+          "404": {
+            "description": "Credential not found.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      },
       "patch": {
         "tags": [
           "Credentials"
@@ -3659,19 +3529,184 @@
         }
       }
     },
-    "/v1/api/prompts/{name}/latest": {
+    "/v1/api/prompts/{name}/latest": {
+      "get": {
+        "tags": [
+          "Prompts"
+        ],
+        "summary": "Get the latest (live) version of a prompt.",
+        "parameters": [
+          {
+            "name": "name",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/prompts/{id}/live": {
+      "post": {
+        "tags": [
+          "Prompts"
+        ],
+        "summary": "Set which version is live.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SetLiveVersionRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SetLiveVersionRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/SetLiveVersionRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/prompts/{name}/playground": {
+      "post": {
+        "tags": [
+          "Prompts"
+        ],
+        "summary": "Playground - Render a prompt template with variables.",
+        "parameters": [
+          {
+            "name": "name",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PlaygroundRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PlaygroundRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/PlaygroundRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/roles": {
+      "get": {
+        "tags": [
+          "Roles"
+        ],
+        "summary": "List all roles available in the tenant.",
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "Roles"
+        ],
+        "summary": "Create a new custom role.",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateRoleRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateRoleRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateRoleRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/roles/permissions": {
+      "get": {
+        "tags": [
+          "Roles"
+        ],
+        "summary": "List all available system permissions.",
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/roles/{id}": {
       "get": {
         "tags": [
-          "Prompts"
+          "Roles"
         ],
-        "summary": "Get the latest (live) version of a prompt.",
+        "summary": "Get a specific role by ID.",
         "parameters": [
           {
-            "name": "name",
+            "name": "id",
             "in": "path",
             "required": true,
             "schema": {
-              "type": "string"
+              "type": "string",
+              "format": "uuid"
             }
           }
         ],
@@ -3680,14 +3715,12 @@
             "description": "OK"
           }
         }
-      }
-    },
-    "/v1/api/prompts/{id}/live": {
-      "post": {
+      },
+      "put": {
         "tags": [
-          "Prompts"
+          "Roles"
         ],
-        "summary": "Set which version is live.",
+        "summary": "Update an existing custom role.\nSystem roles cannot be updated.",
         "parameters": [
           {
             "name": "id",
@@ -3703,17 +3736,17 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/SetLiveVersionRequest"
+                "$ref": "#/components/schemas/UpdateRoleRequest"
               }
             },
             "text/json": {
               "schema": {
-                "$ref": "#/components/schemas/SetLiveVersionRequest"
+                "$ref": "#/components/schemas/UpdateRoleRequest"
               }
             },
             "application/*+json": {
               "schema": {
-                "$ref": "#/components/schemas/SetLiveVersionRequest"
+                "$ref": "#/components/schemas/UpdateRoleRequest"
               }
             }
           }
@@ -3723,43 +3756,36 @@
             "description": "OK"
           }
         }
-      }
-    },
-    "/v1/api/prompts/{name}/playground": {
-      "post": {
+      },
+      "delete": {
         "tags": [
-          "Prompts"
+          "Roles"
         ],
-        "summary": "Playground - Render a prompt template with variables.",
+        "summary": "Delete a custom role.\nSystem roles cannot be deleted.\nRoles assigned to members cannot be deleted.",
         "parameters": [
           {
-            "name": "name",
+            "name": "id",
             "in": "path",
             "required": true,
             "schema": {
-              "type": "string"
+              "type": "string",
+              "format": "uuid"
             }
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/PlaygroundRequest"
-              }
-            },
-            "text/json": {
-              "schema": {
-                "$ref": "#/components/schemas/PlaygroundRequest"
-              }
-            },
-            "application/*+json": {
-              "schema": {
-                "$ref": "#/components/schemas/PlaygroundRequest"
-              }
-            }
+        "responses": {
+          "200": {
+            "description": "OK"
           }
-        },
+        }
+      }
+    },
+    "/v1/api/roles/seed-defaults": {
+      "post": {
+        "tags": [
+          "Roles"
+        ],
+        "summary": "SEED DEFAULT PERMISSIONS (Temporary/Admin Helper)",
         "responses": {
           "200": {
             "description": "OK"
@@ -4024,7 +4050,7 @@
         "tags": [
           "Runs"
         ],
-        "summary": "Wave 1.0: Get run events for polling-based replay.\nReturns events after a specific sequence number for incremental polling.",
+        "summary": ".0: Get run events for polling-based replay.\nReturns events after a specific sequence number for incremental polling.",
         "description": "This is the recommended endpoint for SDK/UI event consumption.\nEvents are ordered by sequence number (ascending) and limited to prevent\nlarge responses. Use `next_after_seq` for pagination.\n\n**Security:** Only returns events for runs in the caller's workspace.",
         "parameters": [
           {
@@ -4256,7 +4282,7 @@
         "tags": [
           "Runs"
         ],
-        "summary": "Wave 5.2: Stream run events via SSE (Server-Sent Events).\nUses robust internal polling (Cinema V1.2) to ensure strict ordering and reliability.\nCloses connection when run is terminal and all events are delivered.",
+        "summary": ".2: Stream run events via SSE (Server-Sent Events).\nUses robust internal polling (Cinema V1.2) to ensure strict ordering and reliability.\nCloses connection when run is terminal and all events are delivered.",
         "parameters": [
           {
             "name": "runId",
@@ -6431,22 +6457,11 @@
         }
       }
     },
-    "/v1/api/tenants/{tenantId}/workspaces": {
+    "/v1/api/workspaces": {
       "get": {
         "tags": [
           "Workspaces"
         ],
-        "parameters": [
-          {
-            "name": "tenantId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
         "responses": {
           "200": {
             "description": "OK"
@@ -6457,17 +6472,6 @@
         "tags": [
           "Workspaces"
         ],
-        "parameters": [
-          {
-            "name": "tenantId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
         "requestBody": {
           "content": {
             "application/json": {
@@ -6494,21 +6498,12 @@
         }
       }
     },
-    "/v1/api/tenants/{tenantId}/workspaces/{id}": {
+    "/v1/api/workspaces/{id}": {
       "get": {
         "tags": [
           "Workspaces"
         ],
         "parameters": [
-          {
-            "name": "tenantId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "id",
             "in": "path",
@@ -6530,15 +6525,6 @@
           "Workspaces"
         ],
         "parameters": [
-          {
-            "name": "tenantId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "id",
             "in": "path",
@@ -6579,15 +6565,6 @@
           "Workspaces"
         ],
         "parameters": [
-          {
-            "name": "tenantId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "id",
             "in": "path",
@@ -6727,60 +6704,13 @@
         },
         "additionalProperties": false
       },
-      "AgentBundle": {
-        "type": "object",
-        "properties": {
-          "schema_version": {
-            "type": "string",
-            "nullable": true
-          },
-          "exported_at": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "agent": {
-            "$ref": "#/components/schemas/AgentBundleAgent"
-          },
-          "versions": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/AgentBundleVersion"
-            },
-            "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
-      "AgentBundleAgent": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "name": {
-            "type": "string",
-            "nullable": true
-          },
-          "live_version_id": {
-            "type": "string",
-            "format": "uuid",
-            "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
-      "AgentBundleVersion": {
+      "AgentBundleItem": {
         "type": "object",
         "properties": {
           "id": {
             "type": "string",
             "format": "uuid"
           },
-          "version_tag": {
-            "type": "string",
-            "nullable": true
-          },
           "artifact_uri": {
             "type": "string",
             "nullable": true
@@ -6793,6 +6723,10 @@
             "type": "string",
             "nullable": true
           },
+          "content_hash": {
+            "type": "string",
+            "nullable": true
+          },
           "created_at": {
             "type": "string",
             "format": "date-time"
@@ -6800,48 +6734,45 @@
         },
         "additionalProperties": false
       },
-      "AgentVersionBundleResponse": {
+      "AgentExportAgent": {
         "type": "object",
         "properties": {
-          "version": {
-            "$ref": "#/components/schemas/AgentVersionMetadata"
-          },
-          "graph_spec": {
-            "nullable": true
-          },
-          "artifact_hash": {
+          "id": {
             "type": "string",
-            "nullable": true
+            "format": "uuid"
           },
-          "format": {
+          "name": {
             "type": "string",
             "nullable": true
           },
-          "resolved_at": {
+          "live_bundle_id": {
             "type": "string",
-            "format": "date-time"
+            "format": "uuid",
+            "nullable": true
           }
         },
         "additionalProperties": false
       },
-      "AgentVersionMetadata": {
+      "AgentExportBundle": {
         "type": "object",
         "properties": {
-          "id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "agent_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "version_tag": {
+          "schema_version": {
             "type": "string",
             "nullable": true
           },
-          "created_at": {
+          "exported_at": {
             "type": "string",
             "format": "date-time"
+          },
+          "agent": {
+            "$ref": "#/components/schemas/AgentExportAgent"
+          },
+          "bundles": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AgentBundleItem"
+            },
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -6927,13 +6858,7 @@
           },
           "agent_id": {
             "type": "string",
-            "format": "uuid",
-            "nullable": true
-          },
-          "agent_version_id": {
-            "type": "string",
-            "format": "uuid",
-            "nullable": true
+            "format": "uuid"
           },
           "inputs": {
             "type": "array",
@@ -6979,69 +6904,90 @@
             "type": "string",
             "nullable": true
           },
-          "current_graph_spec": {
-            "nullable": true
-          },
           "thread_id": {
             "type": "string",
             "nullable": true
           },
-          "catalog_versions": {
-            "$ref": "#/components/schemas/CatalogVersionsDto"
-          },
-          "catalog_ref": {
+          "base_graph_etag": {
             "type": "string",
             "nullable": true
           }
         },
         "additionalProperties": false,
-        "description": "Request DTO for builder chat."
+        "description": "KERNEL P0: Request DTO for builder chat.\nContains ONLY intention fields. No graph_spec, no catalogs."
       },
-      "CancelRequest": {
+      "BundleResponse": {
         "type": "object",
         "properties": {
-          "reason": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "tenant_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "artifact_uri": {
+            "type": "string",
+            "nullable": true
+          },
+          "artifact_hash": {
+            "type": "string",
+            "nullable": true
+          },
+          "format": {
+            "type": "string",
+            "nullable": true
+          },
+          "content_hash": {
+            "type": "string",
+            "nullable": true
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "label": {
             "type": "string",
             "nullable": true
           }
         },
         "additionalProperties": false
       },
-      "CancelRunResponse": {
+      "CancelRequest": {
         "type": "object",
         "properties": {
-          "run_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "status": {
+          "reason": {
             "type": "string",
             "nullable": true
-          },
-          "was_cancelled": {
-            "type": "boolean"
           }
         },
         "additionalProperties": false
       },
-      "CatalogVersionsDto": {
+      "CancelRunResponse": {
         "type": "object",
         "properties": {
-          "nodes": {
+          "run_id": {
             "type": "string",
-            "nullable": true
+            "format": "uuid"
           },
-          "tools": {
+          "status": {
             "type": "string",
             "nullable": true
           },
-          "triggers": {
-            "type": "string",
-            "nullable": true
+          "was_cancelled": {
+            "type": "boolean"
           }
         },
-        "additionalProperties": false,
-        "description": "Catalog versions for world snapshot."
+        "additionalProperties": false
       },
       "Channel": {
         "enum": [
@@ -7210,27 +7156,6 @@
         },
         "additionalProperties": false
       },
-      "CreateAgentVersionRequest": {
-        "type": "object",
-        "properties": {
-          "tenant_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "workspace_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "version_tag": {
-            "type": "string",
-            "nullable": true
-          },
-          "graph_spec": {
-            "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
       "CreateCheckpointRequest": {
         "type": "object",
         "properties": {
@@ -7315,7 +7240,7 @@
             "type": "string",
             "nullable": true
           },
-          "agent_version_id": {
+          "bundle_id": {
             "type": "string",
             "format": "uuid",
             "nullable": true
@@ -7360,7 +7285,7 @@
             "type": "string",
             "format": "uuid"
           },
-          "agent_version_id": {
+          "bundle_id": {
             "type": "string",
             "format": "uuid",
             "nullable": true
@@ -7450,6 +7375,23 @@
         },
         "additionalProperties": false
       },
+      "CreateRoleRequest": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "permissions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "CreateRunRequest": {
         "type": "object",
         "properties": {
@@ -7466,11 +7408,6 @@
             "format": "uuid",
             "nullable": true
           },
-          "agent_version_id": {
-            "type": "string",
-            "format": "uuid",
-            "nullable": true
-          },
           "thread": {
             "$ref": "#/components/schemas/ThreadRequest"
           },
@@ -7484,6 +7421,11 @@
           "webhook_url": {
             "type": "string",
             "nullable": true
+          },
+          "bundle_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -7590,6 +7532,13 @@
           "name": {
             "type": "string",
             "nullable": true
+          },
+          "trigger_type": {
+            "type": "string",
+            "nullable": true
+          },
+          "config": {
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -7816,7 +7765,12 @@
         "properties": {
           "user_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "nullable": true
+          },
+          "email": {
+            "type": "string",
+            "nullable": true
           },
           "role_id": {
             "type": "string",
@@ -7853,6 +7807,121 @@
         },
         "additionalProperties": false
       },
+      "NodeCatalogResponse": {
+        "required": [
+          "nodes",
+          "version"
+        ],
+        "type": "object",
+        "properties": {
+          "version": {
+            "type": "string",
+            "nullable": true
+          },
+          "nodes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/NodeTypeDto"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "NodePresetDto": {
+        "required": [
+          "base_node_slug",
+          "preset_slug",
+          "title"
+        ],
+        "type": "object",
+        "properties": {
+          "preset_slug": {
+            "type": "string",
+            "nullable": true
+          },
+          "base_node_slug": {
+            "type": "string",
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "default_config": {
+            "nullable": true
+          },
+          "locked_fields": {
+            "nullable": true
+          },
+          "ui_variant": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "NodePresetsCatalogResponse": {
+        "required": [
+          "presets",
+          "version"
+        ],
+        "type": "object",
+        "properties": {
+          "version": {
+            "type": "string",
+            "nullable": true
+          },
+          "presets": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/NodePresetDto"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "NodeTypeDto": {
+        "required": [
+          "category",
+          "id",
+          "title"
+        ],
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "category": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "ports": {
+            "nullable": true
+          },
+          "config_schema": {
+            "nullable": true
+          },
+          "default_config": {
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "PlaygroundRequest": {
         "type": "object",
         "properties": {
@@ -7884,11 +7953,6 @@
             "type": "string",
             "format": "uuid"
           },
-          "agent_version_id": {
-            "type": "string",
-            "format": "uuid",
-            "nullable": true
-          },
           "input": {
             "nullable": true
           },
@@ -7980,6 +8044,22 @@
         },
         "additionalProperties": { }
       },
+      "PublishAgentRequest": {
+        "type": "object",
+        "properties": {
+          "version_label": {
+            "type": "string",
+            "nullable": true
+          },
+          "graph_spec": {
+            "nullable": true
+          },
+          "set_as_live": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      },
       "ReplayRequest": {
         "type": "object",
         "properties": {
@@ -8028,11 +8108,6 @@
         "properties": {
           "input": {
             "nullable": true
-          },
-          "agent_version_id": {
-            "type": "string",
-            "format": "uuid",
-            "nullable": true
           }
         },
         "additionalProperties": false
@@ -8138,7 +8213,7 @@
             "type": "string",
             "format": "uuid"
           },
-          "agent_version_id": {
+          "bundle_id": {
             "type": "string",
             "format": "uuid"
           },
@@ -8495,11 +8570,6 @@
             "format": "uuid",
             "nullable": true
           },
-          "agent_version_id": {
-            "type": "string",
-            "format": "uuid",
-            "nullable": true
-          },
           "thread": {
             "$ref": "#/components/schemas/ThreadRequest"
           },
@@ -8570,6 +8640,16 @@
             "format": "uuid",
             "nullable": true
           },
+          "external_conversation_id": {
+            "type": "string",
+            "description": "Filter by external conversation ID (exact match).",
+            "nullable": true
+          },
+          "channel": {
+            "type": "string",
+            "description": "Filter by channel (Http, Whatsapp, Chatwoot, etc).",
+            "nullable": true
+          },
           "agent_id": {
             "type": "string",
             "format": "uuid",
@@ -8622,6 +8702,63 @@
         },
         "additionalProperties": false
       },
+      "TriggerTemplateDto": {
+        "required": [
+          "kind",
+          "name",
+          "slug"
+        ],
+        "type": "object",
+        "properties": {
+          "slug": {
+            "type": "string",
+            "nullable": true
+          },
+          "kind": {
+            "type": "string",
+            "nullable": true
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "run_input_schema": {
+            "nullable": true
+          },
+          "example_payload": {
+            "nullable": true
+          },
+          "config_schema": {
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "TriggerTemplatesCatalogResponse": {
+        "required": [
+          "templates",
+          "version"
+        ],
+        "type": "object",
+        "properties": {
+          "version": {
+            "type": "string",
+            "nullable": true
+          },
+          "templates": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TriggerTemplateDto"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "UpdateAgentRequest": {
         "type": "object",
         "properties": {
@@ -8629,7 +8766,7 @@
             "type": "string",
             "nullable": true
           },
-          "live_version_id": {
+          "live_bundle_id": {
             "type": "string",
             "format": "uuid",
             "nullable": true
@@ -8696,6 +8833,23 @@
         },
         "additionalProperties": false
       },
+      "UpdateRoleRequest": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "permissions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "UpdateTenantRequest": {
         "type": "object",
         "properties": {
@@ -8989,11 +9143,6 @@
             "format": "uuid",
             "nullable": true
           },
-          "agent_version_id": {
-            "type": "string",
-            "format": "uuid",
-            "nullable": true
-          },
           "thread": {
             "$ref": "#/components/schemas/ThreadRequest"
           },
@@ -9049,12 +9198,6 @@
     {
       "name": "Agents"
     },
-    {
-      "name": "AgentVersionManifest"
-    },
-    {
-      "name": "AgentVersions"
-    },
     {
       "name": "ApiTokens"
     },
@@ -9067,6 +9210,9 @@
     {
       "name": "Builder"
     },
+    {
+      "name": "BundleManifest"
+    },
     {
       "name": "Catalog"
     },
@@ -9112,6 +9258,9 @@
     {
       "name": "Prompts"
     },
+    {
+      "name": "Roles"
+    },
     {
       "name": "Runs"
     },