@agent-os-sdk/client 0.9.2 → 0.9.3

package/src/generated/swagger.json

@@ -677,14 +677,23 @@
         "tags": [
           "ApiTokens"
         ],
-        "summary": "Lists all API tokens for the current workspace.",
-        "description": "Returns token metadata without secrets. Token secrets are only\navailable at creation time and cannot be retrieved later.",
+        "summary": "Lists all API tokens for the current workspace.\nRequires `tokens:read` permission.",
         "responses": {
           "200": {
-            "description": "Returns the list of tokens."
+            "description": "OK"
           },
           "400": {
-            "description": "Workspace ID header is required.",
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
             "content": {
               "application/json": {
                 "schema": {
@@ -699,7 +708,7 @@
         "tags": [
           "ApiTokens"
         ],
-        "summary": "Create a new API token.\nThe token secret is only returned once on creation.",
+        "summary": "Create a new API token.\nRequires `tokens:write` permission.\nToken scopes cannot exceed the creator's own permissions (scope ceiling).\nThe token secret is only returned once on creation.",
         "requestBody": {
           "content": {
             "application/json": {
@@ -719,9 +728,49 @@
             }
           }
         },
+        "responses": {
+          "201": {
+            "description": "Created"
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/tokens/available-scopes": {
+      "get": {
+        "tags": [
+          "ApiTokens"
+        ],
+        "summary": "Lists all available scopes that can be assigned to an API token.\nScopes are sourced from the canonical Permissions registry.",
         "responses": {
           "200": {
-            "description": "OK"
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ScopeListResponse"
+                }
+              }
+            }
           }
         }
       }
@@ -731,7 +780,7 @@
         "tags": [
           "ApiTokens"
         ],
-        "summary": "Revoke an API token immediately.",
+        "summary": "Revoke an API token immediately.\nRequires `tokens:delete` permission.",
         "parameters": [
           {
             "name": "id",
@@ -746,6 +795,26 @@
         "responses": {
           "200": {
             "description": "OK"
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
           }
         }
       }
@@ -755,13 +824,11 @@
         "tags": [
           "ApiTokens"
         ],
-        "summary": "Rotate an API token - revokes current and issues a new one.\nThe new token secret is only returned once.",
-        "description": "Rotation is useful for security hygiene (periodic credential rotation)\nor when a token may have been compromised. The new token inherits\nthe same scopes and expiration policy as the original.",
+        "summary": "Rotate an API token - revokes current and issues a new one.\nRequires `tokens:write` permission.\nThe new token secret is only returned once.",
         "parameters": [
           {
             "name": "id",
             "in": "path",
-            "description": "Token ID to rotate.",
             "required": true,
             "schema": {
               "type": "string",
@@ -771,10 +838,20 @@
         ],
         "responses": {
           "200": {
-            "description": "Token rotated successfully, new secret returned."
+            "description": "OK"
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
           },
           "404": {
-            "description": "Token not found or already revoked.",
+            "description": "Not Found",
             "content": {
               "application/json": {
                 "schema": {
@@ -1069,6 +1146,56 @@
         }
       }
     },
+    "/v1/api/auth/bootstrap": {
+      "post": {
+        "tags": [
+          "AuthBootstrap"
+        ],
+        "summary": "Bootstrap the authenticated user with a default tenant, workspace, and roles.\nIdempotent: returns existing resources if already provisioned.",
+        "responses": {
+          "200": {
+            "description": "User already bootstrapped — returns existing membership.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BootstrapResponse"
+                }
+              }
+            }
+          },
+          "201": {
+            "description": "First bootstrap — created tenant, workspace, roles, and membership.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BootstrapResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Missing or invalid JWT.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "PATs cannot trigger bootstrap.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/api/builder/{agentId}/chat": {
       "post": {
         "tags": [
@@ -1608,9 +1735,8 @@
           "Credentials"
         ],
         "summary": "Creates a new credential.",
-        "description": "Creates a new encrypted credential for storing API keys or secrets.\nThe credential is encrypted at rest using workspace-specific keys.",
         "requestBody": {
-          "description": "The credential configuration.",
+          "description": "Credential creation details.",
           "content": {
             "application/json": {
               "schema": {
@@ -1631,31 +1757,11 @@
         },
         "responses": {
           "201": {
-            "description": "Credential created successfully.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/CredentialCreatedResponse"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Invalid request (missing TypeId or WorkspaceId).",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
-          },
-          "401": {
-            "description": "Authentication required.",
+            "description": "Created",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
+                  "$ref": "#/components/schemas/CredentialResponse"
                 }
               }
             }
@@ -1679,6 +1785,15 @@
               "type": "string",
               "format": "uuid"
             }
+          },
+          {
+            "name": "includeValues",
+            "in": "query",
+            "description": "Whether to include the decrypted secret values.",
+            "schema": {
+              "type": "boolean",
+              "default": false
+            }
           }
         ],
         "responses": {
@@ -1713,7 +1828,7 @@
           {
             "name": "id",
             "in": "path",
-            "description": "The credential ID.",
+            "description": "Credential ID.",
             "required": true,
             "schema": {
               "type": "string",
@@ -1722,7 +1837,7 @@
           }
         ],
         "requestBody": {
-          "description": "The update payload.",
+          "description": "Update details.",
           "content": {
             "application/json": {
               "schema": {
@@ -1743,25 +1858,38 @@
         },
         "responses": {
           "200": {
-            "description": "Credential updated successfully.",
+            "description": "OK",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CredentialUpdatedResponse"
+                  "$ref": "#/components/schemas/CredentialResponse"
                 }
               }
             }
-          },
-          "404": {
-            "description": "Credential not found.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Credentials"
+        ],
+        "summary": "Deletes a credential.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Credential ID.",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
             }
           }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          }
         }
       }
     },
@@ -1770,12 +1898,12 @@
         "tags": [
           "Credentials"
         ],
-        "summary": "Grants access to a credential for a workspace.",
+        "summary": "Grants credential access to a workspace.",
         "parameters": [
           {
             "name": "id",
             "in": "path",
-            "description": "The credential ID.",
+            "description": "Credential ID.",
             "required": true,
             "schema": {
               "type": "string",
@@ -1784,7 +1912,7 @@
           }
         ],
         "requestBody": {
-          "description": "The grant configuration.",
+          "description": "Grant details.",
           "content": {
             "application/json": {
               "schema": {
@@ -1805,24 +1933,7 @@
         },
         "responses": {
           "200": {
-            "description": "Access granted successfully.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/CredentialAccessGrantedResponse"
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Credential not found.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ProblemDetails"
-                }
-              }
-            }
+            "description": "OK"
           }
         }
       }
@@ -1832,12 +1943,12 @@
         "tags": [
           "Credentials"
         ],
-        "summary": "Revokes access to a credential.",
+        "summary": "Revokes credential access from a workspace.\nRevokes credential access from a workspace.",
         "parameters": [
           {
             "name": "accessId",
             "in": "path",
-            "description": "The access grant ID to revoke.",
+            "description": "Access Record ID to revoke.",
             "required": true,
             "schema": {
               "type": "string",
@@ -1846,11 +1957,44 @@
           }
         ],
         "responses": {
-          "204": {
-            "description": "Access revoked successfully."
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/credentials/{id}/models": {
+      "get": {
+        "tags": [
+          "Credentials"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
           },
           "404": {
-            "description": "Access grant not found.",
+            "description": "Not Found",
             "content": {
               "application/json": {
                 "schema": {
@@ -3261,6 +3405,27 @@
         }
       }
     },
+    "/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": [
@@ -3713,22 +3878,12 @@
         }
       }
     },
-    "/v1/api/mcp/tools": {
+    "/v1/api/me": {
       "get": {
         "tags": [
-          "Mcp"
-        ],
-        "summary": "List available tools from ToolDefinition registry.",
-        "parameters": [
-          {
-            "name": "agentId",
-            "in": "query",
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
+          "Me"
         ],
+        "summary": "Get current user identity, tenant and workspace context (lightweight, backward compatible).",
         "responses": {
           "200": {
             "description": "OK"
@@ -3736,116 +3891,34 @@
         }
       }
     },
-    "/v1/api/mcp/tools/{name}": {
+    "/v1/api/me/context": {
       "get": {
         "tags": [
-          "Mcp"
-        ],
-        "summary": "Get a specific tool definition.",
-        "parameters": [
-          {
-            "name": "name",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/mcp/resources": {
-      "get": {
-        "tags": [
-          "Mcp"
-        ],
-        "summary": "List resources (files, vector stores) available to an agent.",
-        "parameters": [
-          {
-            "name": "agentId",
-            "in": "query",
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
+          "Me"
         ],
+        "summary": "Get full user context: all tenants, workspaces, roles, and permissions.\nThis is the canonical endpoint for populating frontend layouts.",
+        "description": "Returns every membership the user has, with nested tenant, role (including\ncanonical permission arrays), and accessible workspaces per membership.\n            \n**Admin visibility:** Members with wildcard (\"*\") permission\nsee all workspaces in the tenant. Regular members see only their assigned workspaces.",
         "responses": {
           "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/mcp/tools/call": {
-      "post": {
-        "tags": [
-          "Mcp"
-        ],
-        "summary": "Call a tool (experimental - routes to appropriate handler).",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ToolCallRequest"
-              }
-            },
-            "text/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ToolCallRequest"
-              }
-            },
-            "application/*+json": {
-              "schema": {
-                "$ref": "#/components/schemas/ToolCallRequest"
+            "description": "Full user context with all memberships.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UserContextResponse"
+                }
               }
             }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/mcp/resources/read": {
-      "get": {
-        "tags": [
-          "Mcp"
-        ],
-        "summary": "Read a resource by URI.",
-        "parameters": [
-          {
-            "name": "uri",
-            "in": "query",
-            "schema": {
-              "type": "string"
+          },
+          "401": {
+            "description": "Missing or invalid JWT.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
             }
           }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/me": {
-      "get": {
-        "tags": [
-          "Me"
-        ],
-        "summary": "Get current user identity, tenant and workspace context.",
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
         }
       }
     },
@@ -4591,7 +4664,7 @@
         "tags": [
           "Roles"
         ],
-        "summary": "Create a new custom role.",
+        "summary": "Create a new custom role.\nPermissions are validated against the canonical Permissions registry.",
         "requestBody": {
           "content": {
             "application/json": {
@@ -4723,7 +4796,7 @@
         "tags": [
           "Roles"
         ],
-        "summary": "SEED DEFAULT PERMISSIONS (Temporary/Admin Helper)",
+        "summary": "Seed default permissions for all roles in the tenant.\nUses canonical templates from Permissions constants.",
         "responses": {
           "200": {
             "description": "OK"
@@ -4926,12 +4999,12 @@
         "tags": [
           "Runs"
         ],
-        "summary": "Get run events for timeline display (paged, without SSE).\nAggregates checkpoints, tool calls, and state changes for UI replay.",
+        "summary": "Get canonical run events from SSOT ledger (polling).",
         "parameters": [
           {
             "name": "runId",
             "in": "path",
-            "description": "The unique ID of the run.",
+            "description": "Run ID.",
             "required": true,
             "schema": {
               "type": "string",
@@ -4939,23 +5012,33 @@
             }
           },
           {
-            "name": "limit",
+            "name": "attemptId",
+            "in": "query",
+            "description": "Attempt ID (required).",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "afterSeq",
             "in": "query",
-            "description": "Max events to return.",
+            "description": "Return events with seq greater than this value.",
             "schema": {
               "type": "integer",
-              "format": "int32",
-              "default": 50
+              "format": "int64",
+              "default": 0
             }
           },
           {
-            "name": "offset",
+            "name": "limit",
             "in": "query",
-            "description": "Pagination offset.",
+            "description": "Max events to return (1..500).",
             "schema": {
               "type": "integer",
               "format": "int32",
-              "default": 0
+              "default": 100
             }
           }
         ],
@@ -4965,7 +5048,17 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/RunEventsResponse"
+                  "$ref": "#/components/schemas/RunEventsPollResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
                 }
               }
             }
@@ -4988,13 +5081,12 @@
         "tags": [
           "Runs"
         ],
-        "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.",
+        "summary": "Stream canonical run events via SSE using SSOT ledger ordering.",
         "parameters": [
           {
             "name": "runId",
             "in": "path",
-            "description": "The unique ID of the run.",
+            "description": "Run ID.",
             "required": true,
             "schema": {
               "type": "string",
@@ -5002,33 +5094,38 @@
             }
           },
           {
-            "name": "afterSeq",
+            "name": "attemptId",
             "in": "query",
-            "description": "Return events with seq greater than this value (default: 0 = all).",
+            "description": "Attempt ID (required).",
+            "required": true,
             "schema": {
-              "type": "integer",
-              "format": "int64",
-              "default": 0
+              "type": "string",
+              "format": "uuid"
             }
           },
           {
-            "name": "limit",
+            "name": "afterSeq",
             "in": "query",
-            "description": "Max events to return (default: 100, max: 500).",
+            "description": "Start after this sequence number.",
             "schema": {
               "type": "integer",
-              "format": "int32",
-              "default": 100
+              "format": "int64",
+              "default": 0
             }
           }
         ],
         "responses": {
-          "200": {
-            "description": "OK",
+          "400": {
+            "description": "Bad Request",
             "content": {
+              "text/event-stream": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/RunEventsPollResponse"
+                  "$ref": "#/components/schemas/ProblemDetails"
                 }
               }
             }
@@ -5036,6 +5133,11 @@
           "404": {
             "description": "Not Found",
             "content": {
+              "text/event-stream": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ProblemDetails"
@@ -5156,98 +5258,6 @@
         }
       }
     },
-    "/v1/api/runs/{runId}/join": {
-      "get": {
-        "tags": [
-          "Runs"
-        ],
-        "summary": "Joins an active run and returns its updates via SSE.",
-        "parameters": [
-          {
-            "name": "runId",
-            "in": "path",
-            "description": "The run ID to join.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/runs/stream": {
-      "post": {
-        "tags": [
-          "Runs"
-        ],
-        "summary": "Creates a run and streams real-time updates via Server-Sent Events (SSE).",
-        "description": "This is the recommended endpoint for interactive applications. It creates\na run and maintains an open SSE connection to stream events in real-time.\n\n**SSE Events:**\n- `start`: Run created and queued\n- `update`: Run status changed\n- `complete`: Run finished successfully (includes output)\n- `error`: Run failed or was canceled (includes error details)\n\n**Example Event Stream:**\n```\nevent: start\ndata: {\"run_id\": \"...\", \"status\": \"queued\"}\n\nevent: update\ndata: {\"run_id\": \"...\", \"status\": \"running\"}\n\nevent: complete\ndata: {\"run_id\": \"...\", \"status\": \"completed\", \"output\": {...}}\n```",
-        "requestBody": {
-          "description": "The run request with agent ID and input.",
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/StreamRunRequest"
-              }
-            },
-            "text/json": {
-              "schema": {
-                "$ref": "#/components/schemas/StreamRunRequest"
-              }
-            },
-            "application/*+json": {
-              "schema": {
-                "$ref": "#/components/schemas/StreamRunRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/runs/{runId}/stream": {
-      "get": {
-        "tags": [
-          "Runs"
-        ],
-        "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",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "after",
-            "in": "query",
-            "schema": {
-              "type": "integer",
-              "format": "int64",
-              "default": 0
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
     "/v1/api/runs/{runId}/rerun": {
       "post": {
         "tags": [
@@ -5985,6 +5995,24 @@
               "type": "string",
               "format": "uuid"
             }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "default": 100
+            }
+          },
+          {
+            "name": "offset",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "default": 0
+            }
           }
         ],
         "responses": {
@@ -7108,15 +7136,366 @@
         }
       }
     },
-    "/v1/api/quotas": {
+    "/v1/api/triggers/{triggerId}/contract": {
       "get": {
         "tags": [
-          "Usage"
+          "Triggers"
         ],
-        "summary": "Get current quota status.",
+        "summary": "Get the full input contract for a trigger.\nReturns schemas and mapping spec for transformation configuration.",
         "parameters": [
           {
-            "name": "workspaceId",
+            "name": "triggerId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TriggerInputContractResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/triggers/{triggerId}/test-mapping": {
+      "post": {
+        "tags": [
+          "Triggers"
+        ],
+        "summary": "Preview payload transformation using the trigger's input mapping.\nReturns the transformed graph_input without executing a run.",
+        "parameters": [
+          {
+            "name": "triggerId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TestMappingRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TestMappingRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/TestMappingRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestMappingResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/triggers/{triggerId}/infer-schema": {
+      "post": {
+        "tags": [
+          "Triggers"
+        ],
+        "summary": "Infer JSON Schema from a sample payload.\nReturns the inferred schema and flattened paths for UI consumption.",
+        "parameters": [
+          {
+            "name": "triggerId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/InferSchemaRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/InferSchemaRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/InferSchemaRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InferSchemaResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "413": {
+            "description": "Content Too Large",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/triggers/{triggerId}/input-mapping": {
+      "put": {
+        "tags": [
+          "Triggers"
+        ],
+        "summary": "Save or update the input mapping override for a trigger.",
+        "parameters": [
+          {
+            "name": "triggerId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SaveMappingRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SaveMappingRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/SaveMappingRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SaveMappingResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Unprocessable Content",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/triggers/{triggerId}/preview-input-mapping": {
+      "post": {
+        "tags": [
+          "Triggers"
+        ],
+        "summary": "Preview payload transformation without persisting.\nThis is the \"product magic\" - users trust mapping when they see the transform.",
+        "parameters": [
+          {
+            "name": "triggerId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PreviewMappingRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PreviewMappingRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/PreviewMappingRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PreviewMappingResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "413": {
+            "description": "Content Too Large",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/api/quotas": {
+      "get": {
+        "tags": [
+          "Usage"
+        ],
+        "summary": "Get current quota status.",
+        "parameters": [
+          {
+            "name": "workspaceId",
             "in": "query",
             "schema": {
               "type": "string",
@@ -8254,6 +8633,50 @@
         },
         "additionalProperties": false
       },
+      "BootstrapResponse": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "type": "string",
+            "description": "\"existing\" if already bootstrapped, \"created\" if newly provisioned.",
+            "nullable": true
+          },
+          "tenant_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "tenant_name": {
+            "type": "string",
+            "nullable": true
+          },
+          "tenant_slug": {
+            "type": "string",
+            "nullable": true
+          },
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          },
+          "workspace_name": {
+            "type": "string",
+            "nullable": true
+          },
+          "workspace_slug": {
+            "type": "string",
+            "nullable": true
+          },
+          "member_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "role_name": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "BuilderChatRequest": {
         "type": "object",
         "properties": {
@@ -8629,6 +9052,9 @@
           "name": {
             "type": "string",
             "nullable": true
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/JsonNode"
           }
         },
         "additionalProperties": false
@@ -8917,6 +9343,19 @@
             "type": "string",
             "format": "uuid",
             "nullable": true
+          },
+          "thread_key": {
+            "type": "string",
+            "nullable": true
+          },
+          "event_key": {
+            "type": "string",
+            "nullable": true
+          },
+          "rerun_of_run_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -9034,97 +9473,55 @@
           },
           "config": {
             "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
-      "CreateVectorStoreRequest": {
-        "type": "object",
-        "properties": {
-          "name": {
-            "type": "string",
-            "nullable": true
           },
-          "embedding_provider": {
-            "type": "string",
+          "payload_variants_json": {
             "nullable": true
           },
-          "embedding_model": {
-            "type": "string",
+          "thread_key_spec_json": {
             "nullable": true
           },
-          "dimension": {
-            "type": "integer",
-            "format": "int32",
-            "nullable": true
-          },
-          "credential_binding_alias": {
-            "type": "string",
+          "idempotency_spec_json": {
             "nullable": true
           }
         },
         "additionalProperties": false
       },
-      "CreateWorkspaceRequest": {
+      "CreateVectorStoreRequest": {
         "type": "object",
         "properties": {
           "name": {
             "type": "string",
             "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
-      "CredentialAccessGrantedResponse": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "status": {
-            "type": "string",
-            "nullable": true
-          }
-        },
-        "additionalProperties": false,
-        "description": "Response after granting access."
-      },
-      "CredentialCreatedResponse": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string",
-            "format": "uuid"
           },
-          "name": {
+          "embedding_provider": {
             "type": "string",
             "nullable": true
           },
-          "scope": {
+          "embedding_model": {
             "type": "string",
             "nullable": true
-          },
-          "tenant_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "workspace_id": {
-            "type": "string",
-            "format": "uuid",
+          },
+          "dimension": {
+            "type": "integer",
+            "format": "int32",
             "nullable": true
           },
-          "status": {
+          "credential_binding_alias": {
             "type": "string",
             "nullable": true
-          },
-          "created_at": {
+          }
+        },
+        "additionalProperties": false
+      },
+      "CreateWorkspaceRequest": {
+        "type": "object",
+        "properties": {
+          "name": {
             "type": "string",
-            "format": "date-time"
+            "nullable": true
           }
         },
-        "additionalProperties": false,
-        "description": "Response after creating a credential."
+        "additionalProperties": false
       },
       "CredentialDetailResponse": {
         "type": "object",
@@ -9172,6 +9569,11 @@
           },
           "public_config": {
             "nullable": true
+          },
+          "values": {
+            "type": "object",
+            "additionalProperties": { },
+            "nullable": true
           }
         },
         "additionalProperties": false,
@@ -9239,24 +9641,30 @@
         "additionalProperties": false,
         "description": "Credential metadata (without encrypted values)."
       },
-      "CredentialUpdatedResponse": {
+      "CurlCommandParts": {
         "type": "object",
         "properties": {
-          "id": {
+          "method": {
             "type": "string",
-            "format": "uuid"
+            "nullable": true
           },
-          "status": {
+          "url": {
             "type": "string",
             "nullable": true
           },
-          "sharing_mode": {
+          "headers": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "body_json": {
             "type": "string",
             "nullable": true
           }
         },
-        "additionalProperties": false,
-        "description": "Response after updating a credential."
+        "additionalProperties": false
       },
       "DatasetResponse": {
         "type": "object",
@@ -9471,6 +9879,63 @@
         },
         "additionalProperties": false
       },
+      "FrontendLogIngestRequest": {
+        "type": "object",
+        "properties": {
+          "level": {
+            "type": "string",
+            "nullable": true
+          },
+          "message": {
+            "type": "string",
+            "nullable": true
+          },
+          "stack": {
+            "type": "string",
+            "nullable": true
+          },
+          "component": {
+            "type": "string",
+            "nullable": true
+          },
+          "route": {
+            "type": "string",
+            "nullable": true
+          },
+          "url": {
+            "type": "string",
+            "nullable": true
+          },
+          "user_agent": {
+            "type": "string",
+            "nullable": true
+          },
+          "correlation_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "trace_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "run_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "session_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "context": {
+            "type": "object",
+            "additionalProperties": {
+              "nullable": true
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "GetGraphSpecResponse": {
         "type": "object",
         "properties": {
@@ -9533,6 +9998,36 @@
         },
         "additionalProperties": false
       },
+      "InferSchemaRequest": {
+        "type": "object",
+        "properties": {
+          "sample_payload": { }
+        },
+        "additionalProperties": false,
+        "description": "Request for POST /triggers/{id}/infer-schema"
+      },
+      "InferSchemaResponse": {
+        "type": "object",
+        "properties": {
+          "inferred_schema": { },
+          "paths": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/PathInfoDto"
+            },
+            "nullable": true
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Response for POST /triggers/{id}/infer-schema"
+      },
       "IntrospectGraphRequest": {
         "type": "object",
         "properties": {
@@ -9586,6 +10081,30 @@
         },
         "additionalProperties": false
       },
+      "JsonNode": {
+        "type": "object",
+        "properties": {
+          "options": {
+            "$ref": "#/components/schemas/JsonNodeOptions"
+          },
+          "parent": {
+            "$ref": "#/components/schemas/JsonNode"
+          },
+          "root": {
+            "$ref": "#/components/schemas/JsonNode"
+          }
+        },
+        "additionalProperties": false
+      },
+      "JsonNodeOptions": {
+        "type": "object",
+        "properties": {
+          "property_name_case_insensitive": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      },
       "JsonRpcRequest": {
         "type": "object",
         "properties": {
@@ -9606,6 +10125,25 @@
         },
         "additionalProperties": false
       },
+      "MappingValidationError": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "nullable": true
+          },
+          "path": {
+            "type": "string",
+            "nullable": true
+          },
+          "message": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Structured validation error with path for better UI feedback."
+      },
       "MemberDetailResponse": {
         "type": "object",
         "properties": {
@@ -9615,7 +10153,8 @@
           },
           "user_id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "nullable": true
           },
           "tenant_id": {
             "type": "string",
@@ -9697,6 +10236,29 @@
         },
         "additionalProperties": false
       },
+      "MembershipContextDto": {
+        "type": "object",
+        "properties": {
+          "member_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "tenant": {
+            "$ref": "#/components/schemas/TenantContextDto"
+          },
+          "role": {
+            "$ref": "#/components/schemas/RoleContextDto"
+          },
+          "workspaces": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/WorkspaceContextDto"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "NodeCatalogResponse": {
         "required": [
           "nodes",
@@ -9746,6 +10308,10 @@
             "nullable": true
           },
           "locked_fields": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
             "nullable": true
           },
           "ui_variant": {
@@ -9779,12 +10345,12 @@
       "NodeTypeDto": {
         "required": [
           "category",
-          "id",
+          "kind",
           "title"
         ],
         "type": "object",
         "properties": {
-          "id": {
+          "kind": {
             "type": "string",
             "nullable": true
           },
@@ -9800,18 +10366,44 @@
             "type": "string",
             "nullable": true
           },
-          "ports": {
-            "nullable": true
-          },
           "config_schema": {
             "nullable": true
           },
           "default_config": {
             "nullable": true
+          },
+          "inputs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "outputs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
           }
         },
         "additionalProperties": false
       },
+      "PathInfoDto": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "nullable": true
+          },
+          "kind": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "A JSONPath with its inferred type."
+      },
       "PlaygroundRequest": {
         "type": "object",
         "properties": {
@@ -9907,6 +10499,37 @@
         },
         "additionalProperties": false
       },
+      "PreviewMappingRequest": {
+        "type": "object",
+        "properties": {
+          "sample_payload": { },
+          "input_mapping_override": { }
+        },
+        "additionalProperties": false,
+        "description": "Request for POST /triggers/{id}/preview-input-mapping"
+      },
+      "PreviewMappingResponse": {
+        "type": "object",
+        "properties": {
+          "result_input": { },
+          "resolution": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ResolutionRowDto"
+            },
+            "nullable": true
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Response for POST /triggers/{id}/preview-input-mapping"
+      },
       "ProblemDetails": {
         "type": "object",
         "properties": {
@@ -10020,6 +10643,28 @@
         },
         "additionalProperties": false
       },
+      "ResolutionRowDto": {
+        "type": "object",
+        "properties": {
+          "target": {
+            "type": "string",
+            "nullable": true
+          },
+          "source": {
+            "type": "string",
+            "nullable": true
+          },
+          "ok": {
+            "type": "boolean"
+          },
+          "note": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Resolution row showing how a mapping was resolved."
+      },
       "ResumeRequest": {
         "type": "object",
         "properties": {
@@ -10185,10 +10830,34 @@
           "data": {
             "$ref": "#/components/schemas/RevisionListResponse"
           },
-          "hints": {
+          "hints": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ApiHint"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "RoleContextDto": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "is_system": {
+            "type": "boolean"
+          },
+          "permissions": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/ApiHint"
+              "type": "string"
             },
             "nullable": true
           }
@@ -10222,23 +10891,34 @@
             "type": "string",
             "format": "uuid"
           },
+          "current_attempt_id": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          },
+          "current_attempt_no": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "latest_seq": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
           "status": {
             "$ref": "#/components/schemas/RunStatus"
           },
-          "input_json": {
-            "type": "string",
+          "input": {
             "nullable": true
           },
-          "output_json": {
-            "type": "string",
+          "output": {
             "nullable": true
           },
-          "error_json": {
-            "type": "string",
+          "error": {
             "nullable": true
           },
-          "metrics_json": {
-            "type": "string",
+          "metrics": {
             "nullable": true
           },
           "started_at": {
@@ -10255,6 +10935,11 @@
             "type": "string",
             "format": "date-time"
           },
+          "duration_ms": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
           "prompt_hash": {
             "type": "string",
             "nullable": true
@@ -10298,27 +10983,6 @@
         },
         "additionalProperties": false
       },
-      "RunEventItem": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string",
-            "nullable": true
-          },
-          "type": {
-            "type": "string",
-            "nullable": true
-          },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "data": {
-            "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
       "RunEventsPollResponse": {
         "type": "object",
         "properties": {
@@ -10344,34 +11008,6 @@
         },
         "additionalProperties": false
       },
-      "RunEventsResponse": {
-        "type": "object",
-        "properties": {
-          "items": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/RunEventItem"
-            },
-            "nullable": true
-          },
-          "total": {
-            "type": "integer",
-            "format": "int32"
-          },
-          "offset": {
-            "type": "integer",
-            "format": "int32"
-          },
-          "limit": {
-            "type": "integer",
-            "format": "int32"
-          },
-          "has_more": {
-            "type": "boolean"
-          }
-        },
-        "additionalProperties": false
-      },
       "RunListItem": {
         "type": "object",
         "properties": {
@@ -10476,6 +11112,56 @@
         "type": "integer",
         "format": "int32"
       },
+      "SaveMappingRequest": {
+        "type": "object",
+        "properties": {
+          "input_mapping_override": { }
+        },
+        "additionalProperties": false,
+        "description": "Request for PUT /triggers/{id}/input-mapping"
+      },
+      "SaveMappingResponse": {
+        "type": "object",
+        "properties": {
+          "trigger_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "input_mapping_override": { }
+        },
+        "additionalProperties": false,
+        "description": "Response for PUT /triggers/{id}/input-mapping"
+      },
+      "ScopeInfo": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string",
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "ScopeListResponse": {
+        "required": [
+          "scopes"
+        ],
+        "type": "object",
+        "properties": {
+          "scopes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScopeInfo"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "SetLiveVersionRequest": {
         "type": "object",
         "properties": {
@@ -10589,34 +11275,18 @@
         },
         "additionalProperties": false
       },
-      "StreamRunRequest": {
+      "TenantContextDto": {
         "type": "object",
         "properties": {
-          "tenant_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "workspace_id": {
+          "id": {
             "type": "string",
             "format": "uuid"
           },
-          "agent_id": {
-            "type": "string",
-            "format": "uuid",
-            "nullable": true
-          },
-          "thread": {
-            "$ref": "#/components/schemas/ThreadRequest"
-          },
-          "idempotency_key": {
-            "type": "string",
-            "nullable": true
-          },
-          "input_json": {
+          "name": {
             "type": "string",
             "nullable": true
           },
-          "stream_mode": {
+          "slug": {
             "type": "string",
             "nullable": true
           }
@@ -10692,11 +11362,56 @@
         },
         "additionalProperties": false
       },
+      "TestMappingRequest": {
+        "type": "object",
+        "properties": {
+          "sample_payload": { }
+        },
+        "additionalProperties": false,
+        "description": "Request for POST /triggers/{id}/test-mapping - Preview payload transformation."
+      },
+      "TestMappingResponse": {
+        "type": "object",
+        "properties": {
+          "original_payload": {
+            "description": "The original payload as received"
+          },
+          "transformed_graph_input": {
+            "description": "The transformed payload after mapping"
+          },
+          "mapping_configured": {
+            "type": "boolean",
+            "description": "True if a mapping spec is configured (trigger override or template default)"
+          },
+          "mapping_executed": {
+            "type": "boolean",
+            "description": "True if the mapping was actually executed (not just configured)"
+          },
+          "validation_errors": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MappingValidationError"
+            },
+            "description": "Structured validation errors if any",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Response for POST /triggers/{id}/test-mapping.\nP0: Separated mapping_configured from mapping_executed for honesty."
+      },
       "TestTriggerRequest": {
         "type": "object",
         "properties": {
           "payload": {
             "nullable": true
+          },
+          "thread_key": {
+            "type": "string",
+            "nullable": true
+          },
+          "idempotency_key": {
+            "type": "string",
+            "nullable": true
           }
         },
         "additionalProperties": false,
@@ -10804,18 +11519,35 @@
         },
         "additionalProperties": false
       },
-      "ToolCallRequest": {
+      "TriggerInputContractResponse": {
         "type": "object",
         "properties": {
-          "name": {
+          "trigger_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "template_slug": {
             "type": "string",
             "nullable": true
           },
-          "arguments": {
+          "external_body_schema": {
+            "nullable": true
+          },
+          "run_input_schema": {
+            "nullable": true
+          },
+          "effective_input_mapping_spec": {
+            "nullable": true
+          },
+          "example_payload": {
             "nullable": true
+          },
+          "has_input_mapping": {
+            "type": "boolean"
           }
         },
-        "additionalProperties": false
+        "additionalProperties": false,
+        "description": "Response for GET /triggers/{id}/contract - Full input contract details."
       },
       "TriggerRequestContract": {
         "type": "object",
@@ -10849,6 +11581,9 @@
           "curl_example": {
             "type": "string",
             "nullable": true
+          },
+          "curl_command_parts": {
+            "$ref": "#/components/schemas/CurlCommandParts"
           }
         },
         "additionalProperties": false
@@ -10890,6 +11625,26 @@
           "is_active": {
             "type": "boolean"
           },
+          "template_slug": {
+            "type": "string",
+            "nullable": true
+          },
+          "config_json": {
+            "type": "string",
+            "nullable": true
+          },
+          "payload_variants_json": {
+            "type": "string",
+            "nullable": true
+          },
+          "thread_key_spec_json": {
+            "type": "string",
+            "nullable": true
+          },
+          "idempotency_spec_json": {
+            "type": "string",
+            "nullable": true
+          },
           "created_at": {
             "type": "string",
             "format": "date-time"
@@ -10965,6 +11720,9 @@
             "type": "string",
             "format": "uuid",
             "nullable": true
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/JsonNode"
           }
         },
         "additionalProperties": false
@@ -11097,6 +11855,18 @@
           "is_active": {
             "type": "boolean",
             "nullable": true
+          },
+          "config": {
+            "nullable": true
+          },
+          "payload_variants_json": {
+            "nullable": true
+          },
+          "thread_key_spec_json": {
+            "nullable": true
+          },
+          "idempotency_spec_json": {
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -11111,6 +11881,36 @@
         },
         "additionalProperties": false
       },
+      "UserContextResponse": {
+        "type": "object",
+        "properties": {
+          "user": {
+            "$ref": "#/components/schemas/UserIdentityDto"
+          },
+          "memberships": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MembershipContextDto"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "UserIdentityDto": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "email": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "ValidateGraphRequest": {
         "type": "object",
         "properties": {
@@ -11455,6 +12255,24 @@
         },
         "additionalProperties": false
       },
+      "WorkspaceContextDto": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "slug": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "WorkspaceListResponse": {
         "type": "object",
         "properties": {
@@ -11519,6 +12337,9 @@
     {
       "name": "Audit"
     },
+    {
+      "name": "AuthBootstrap"
+    },
     {
       "name": "Builder"
     },
@@ -11549,6 +12370,9 @@
     {
       "name": "Files"
     },
+    {
+      "name": "FrontendObservability"
+    },
     {
       "name": "Graphs"
     },
@@ -11558,9 +12382,6 @@
     {
       "name": "Knowledge"
     },
-    {
-      "name": "Mcp"
-    },
     {
       "name": "Me"
     },