@walkeros/cli 4.5.0 → 4.5.1-next-1788726985928

package/dist/index.d.ts

@@ -3693,7 +3693,7 @@ interface paths {
     put?: never;
     /**
      * Deploy settings
-     * @description Start a deployment for a specific settings entry. Detects platform from the settings.
+     * @description Start a deployment for a specific settings entry. Detects platform from the settings. The body is optional and carries only `humanText`, the reason for the change, which becomes the description of the release this deploy produces; it is ignored when the release already has one.
      */
     post: {
       parameters: {
@@ -3706,7 +3706,11 @@ interface paths {
         };
         cookie?: never;
       };
-      requestBody?: never;
+      requestBody?: {
+        content: {
+          'application/json': components['schemas']['DeploySettingsRequest'];
+        };
+      };
       responses: {
         /** @description Deployment started */
         201: {
@@ -7506,6 +7510,95 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  '/api/projects/{projectId}/flows/{flowId}/releases/{versionId}/content': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Read a release snapshot
+     * @description The flow config one release of this flow froze, addressed by its spine version id. This is the only route that serves a release snapshot: the positional `/versions/{versionNumber}` route numbers the autosave revisions, a disjoint set of rows, so a release number handed to it addresses an unrelated revision or nothing. Inline secret literals are masked. An unknown id, a sibling flow's version, and an autosave revision all answer 404 alike. Requires member role and the `hub` feature.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          flowId: string;
+          /** @description Spine version ID of the release (ver_...) */
+          versionId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description The release snapshot */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ReleaseContentResponse'];
+          };
+        };
+        /** @description Invalid version id */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   '/api/projects/{projectId}/flows/{flowId}/releases/annotations': {
     parameters: {
       query?: never;
@@ -8057,7 +8150,7 @@ interface paths {
     };
     trace?: never;
   };
-  '/api/projects/{projectId}/flows/{flowId}/releases/step-history': {
+  '/api/projects/{projectId}/knowledge': {
     parameters: {
       query?: never;
       header?: never;
@@ -8065,35 +8158,36 @@ interface paths {
       cookie?: never;
     };
     /**
-     * List the releases that touched one step
-     * @description The releases of this flow that added, changed, or removed one step, newest first, each carrying the rationale stored for it. `step` is a `type.name` key over source, transformer, destination, store, and contract. `flow` narrows the scan to one named flow inside the config and is ignored for a contract key. `limit` bounds the releases scanned, not the entries returned. When nothing matched, `knownSteps` lists the addressable keys of the newest scanned release. Requires member role.
+     * List knowledge captured in this project
+     * @description What people wrote on the frames of a page, most recently active first. Two kinds come back together and `kind` separates them: a `thread` carries its text in messages, a `description` carries one body and cannot be replied to. `pageKey` narrows to a whole page, resolved server-side to every frame that page holds at any depth; `frameId` narrows to one frame; `markId` narrows to one mark within it and is refused without `frameId`, since a mark id alone addresses nothing. `includeMessages=true` attaches message bodies and holds the page to a much smaller ceiling, so `hasMoreEntries` is what separates a complete answer from a truncated one. `validity` says when an entry was true and `freshness` compares that against the flow’s newest release; neither is a verdict. Requires member role.
      */
     get: {
       parameters: {
-        query: {
-          step: string;
-          flow?: string;
-          limit?: number | null;
+        query?: {
+          pageKey?: string;
+          frameId?: string;
+          markId?: string;
+          includeMessages?: 'true' | 'false';
+          limit?: number;
         };
         header?: never;
         path: {
           projectId: string;
-          flowId: string;
         };
         cookie?: never;
       };
       requestBody?: never;
       responses: {
-        /** @description The releases that touched the step */
+        /** @description Knowledge in this project */
         200: {
           headers: {
             [name: string]: unknown;
           };
           content: {
-            'application/json': components['schemas']['StepHistoryResponse'];
+            'application/json': components['schemas']['ListKnowledgeResponse'];
           };
         };
-        /** @description Invalid step key or query */
+        /** @description Invalid query, or a mark filter with no frame */
         400: {
           headers: {
             [name: string]: unknown;
@@ -8141,25 +8235,9 @@ interface paths {
       };
     };
     put?: never;
-    post?: never;
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
-  '/api/projects/{projectId}/flows/{flowId}/releases/summarize': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    get?: never;
-    put?: never;
     /**
-     * Summarize or check a release
-     * @description Describe what one release of this flow changed against an earlier release, or check a written note against that same change. In `draft` mode the generated text is stored as the release's generated summary; in `check` mode nothing is stored and the response says whether the note matches. The diff is always recomputed from the two stored snapshots, with secret literals masked, and is never taken from the request. Both versions must be numbered releases of this flow, and `prevVersionId` must be the earlier of the two. Requires member role and the `hub` feature.
+     * Open a thread on a mark or a frame
+     * @description Open a thread on one mark of one frame, or on the frame itself with `anchorType` `page` and no `markId`, with its first message. A thread never exists empty, so `text` is required and may not be blank. `clientThreadId` and `clientMessageId` are minted by the client at compose time and are what make a replay idempotent: repeating a known `clientThreadId` hands back the existing thread and writes nothing, so an offline queue can drain repeatedly without duplicating what a person wrote once. `flowId` binds the capture to a flow or is explicitly null; a flow this project cannot see answers 404, never 403. A frame this project does not hold answers 404 with `FRAME_NOT_FOUND`, which a draining client waits on and retries, because the frame’s own write may not have landed yet. The server decides the composed anchor key, the born release, the author and the source: a client cannot assert any of them. Requires member role.
      */
     post: {
       parameters: {
@@ -8167,34 +8245,43 @@ interface paths {
         header?: never;
         path: {
           projectId: string;
-          flowId: string;
         };
         cookie?: never;
       };
       requestBody?: {
         content: {
           'application/json': {
-            /** @example ver_a1b2c3d4 */
-            versionId: string;
-            /** @example ver_a1b2c3d4 */
-            prevVersionId: string;
-            /** @enum {string} */
-            mode: 'draft' | 'check';
-            currentText?: string;
+            /**
+             * @example tag
+             * @enum {string}
+             */
+            anchorType: 'tag' | 'page';
+            /** @example frm_V1StGXR8Z5jdHi6BmyT7K */
+            frameId: string;
+            markId?: string;
+            anchorLabel?: string;
+            flowId: string | null;
+            subjectKey?: string;
+            spatial?: components['schemas']['KnowledgeSpatial'];
+            /** @example ct_7f3a91 */
+            clientThreadId: string;
+            text: string;
+            /** @example ct_7f3a91 */
+            clientMessageId: string;
           };
         };
       };
       responses: {
-        /** @description The generated summary or the check verdict */
-        200: {
+        /** @description The thread, with its first message */
+        201: {
           headers: {
             [name: string]: unknown;
           };
           content: {
-            'application/json': components['schemas']['SummarizeReleaseResponse'];
+            'application/json': components['schemas']['KnowledgeThreadResponse'];
           };
         };
-        /** @description Invalid body, a target is not a release, the pair is out of order, or no LLM provider is configured */
+        /** @description Invalid body */
         400: {
           headers: {
             [name: string]: unknown;
@@ -8221,7 +8308,7 @@ interface paths {
             'application/json': components['schemas']['ErrorResponse'];
           };
         };
-        /** @description Not found */
+        /** @description The named flow or frame is not in this project */
         404: {
           headers: {
             [name: string]: unknown;
@@ -8239,15 +8326,6 @@ interface paths {
             'application/json': components['schemas']['ErrorResponse'];
           };
         };
-        /** @description The model call failed or returned no usable text */
-        502: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            'application/json': components['schemas']['ErrorResponse'];
-          };
-        };
       };
     };
     delete?: never;
@@ -8256,36 +8334,56 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  '/api/projects/{projectId}/deployments/{deploymentId}/versions/current/content': {
+  '/api/projects/{projectId}/knowledge/{threadId}/messages': {
     parameters: {
       query?: never;
       header?: never;
       path?: never;
       cookie?: never;
     };
+    get?: never;
+    put?: never;
     /**
-     * Get current deployed content
-     * @description Get the active deployed per-setting content for a deployment, used to diff changes since deploy. Content is masked and display-only; every field is null when there is no deployed baseline. Requires member role.
+     * Reply to a knowledge thread
+     * @description Append a message to a thread and get the whole thread back, so a surface renders the new exchange without a second read. `text` may not be blank: a message cannot be cleared, so empty is invalid rather than a way to erase one. Repeating a `clientMessageId` already on the thread appends nothing and leaves `updatedAt` alone, so a retrying drain never keeps bumping a thread to the top of every list. A description has no conversation and cannot be replied to; addressing one answers 404. Requires member role.
      */
-    get: {
+    post: {
       parameters: {
         query?: never;
         header?: never;
         path: {
           projectId: string;
-          deploymentId: string;
+          /** @description Thread ID (thr_...) */
+          threadId: string;
         };
         cookie?: never;
       };
-      requestBody?: never;
+      requestBody?: {
+        content: {
+          'application/json': {
+            text: string;
+            /** @example ct_7f3a91 */
+            clientMessageId: string;
+          };
+        };
+      };
       responses: {
-        /** @description Deployed content (or a null baseline) */
-        200: {
+        /** @description The thread, with the new message */
+        201: {
           headers: {
             [name: string]: unknown;
           };
           content: {
-            'application/json': components['schemas']['DeployedContentResponse'];
+            'application/json': components['schemas']['KnowledgeThreadResponse'];
+          };
+        };
+        /** @description Invalid body */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
           };
         };
         /** @description Unauthorized */
@@ -8326,51 +8424,69 @@ interface paths {
         };
       };
     };
-    put?: never;
-    post?: never;
     delete?: never;
     options?: never;
     head?: never;
     patch?: never;
     trace?: never;
   };
-  '/api/projects/{projectId}/deployments/{deploymentId}/heartbeats': {
+  '/api/projects/{projectId}/knowledge/description': {
     parameters: {
       query?: never;
       header?: never;
       path?: never;
       cookie?: never;
     };
+    get?: never;
     /**
-     * List deployment heartbeats
-     * @description List heartbeat records for a deployment with optional from/to time-range filtering and pagination. Requires member role.
+     * Write the description of a mark or a frame
+     * @description Write the one description of one anchor, a mark or the frame itself, replacing whatever it said before. There is no id to mint: the anchor is the key, so a replayed write lands on the same row by construction, which is why this is a PUT. An empty `body` is refused rather than stored, so a drain that arrives with nothing to say can never erase what a person wrote. The response is 200 whether the description was opened or replaced. Requires member role.
      */
-    get: {
+    put: {
       parameters: {
-        query?: {
-          /** @description ISO start of the time range. */
-          from?: string;
-          /** @description ISO end of the time range. */
-          to?: string;
-          limit?: number;
-          offset?: number | null;
-        };
+        query?: never;
         header?: never;
         path: {
           projectId: string;
-          deploymentId: string;
         };
         cookie?: never;
       };
-      requestBody?: never;
+      requestBody?: {
+        content: {
+          'application/json': {
+            /**
+             * @example tag
+             * @enum {string}
+             */
+            anchorType: 'tag' | 'page';
+            /** @example frm_V1StGXR8Z5jdHi6BmyT7K */
+            frameId: string;
+            markId?: string;
+            anchorLabel?: string;
+            flowId: string | null;
+            subjectKey?: string;
+            spatial?: components['schemas']['KnowledgeSpatial'];
+            body: string;
+          };
+        };
+      };
       responses: {
-        /** @description Heartbeat history */
+        /** @description The stored description */
         200: {
           headers: {
             [name: string]: unknown;
           };
           content: {
-            'application/json': components['schemas']['ListHeartbeatsResponse'];
+            'application/json': components['schemas']['KnowledgeDescriptionResponse'];
+          };
+        };
+        /** @description Invalid body */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
           };
         };
         /** @description Unauthorized */
@@ -8391,7 +8507,7 @@ interface paths {
             'application/json': components['schemas']['ErrorResponse'];
           };
         };
-        /** @description Not found */
+        /** @description The named flow or frame is not in this project */
         404: {
           headers: {
             [name: string]: unknown;
@@ -8400,9 +8516,17 @@ interface paths {
             'application/json': components['schemas']['ErrorResponse'];
           };
         };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
       };
     };
-    put?: never;
     post?: never;
     delete?: never;
     options?: never;
@@ -8410,38 +8534,48 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  '/api/projects/{projectId}/deployments/{deploymentId}/rotate-ingest-token': {
+  '/api/projects/{projectId}/frames': {
     parameters: {
       query?: never;
       header?: never;
       path?: never;
       cookie?: never;
     };
-    get?: never;
-    put?: never;
     /**
-     * Rotate ingest token
-     * @description Rotate the ingest token for a deployment. Owner-only. No grace window: the previous token is immediately invalidated and the new token is returned once.
+     * List the frames of a page, or of the whole project
+     * @description A frame is a named rectangle with marks inside it, the spatial unit of a measurement plan. Naming a `pageKey` returns that page’s frames at any depth, marks and all, newest updated first: the walk starts at the page’s top-level frames and descends containment, so a child is reachable through its parent rather than by carrying a page of its own. Naming no page returns every live frame of the project WITHOUT its marks, which is what makes that read cheap enough to answer "what does this project have": the marks are the bulk of a frame and a listing never renders them. That lean read asks nothing about containment, so a frame whose parent cannot be resolved still appears. Requires member role.
      */
-    post: {
+    get: {
       parameters: {
-        query?: never;
+        query?: {
+          pageKey?: string;
+        };
         header?: never;
         path: {
           projectId: string;
-          deploymentId: string;
         };
         cookie?: never;
       };
       requestBody?: never;
       responses: {
-        /** @description New ingest token */
+        /** @description The page’s frames with their marks, or the project’s frames without them */
         200: {
           headers: {
             [name: string]: unknown;
           };
           content: {
-            'application/json': components['schemas']['RotateIngestTokenResponse'];
+            'application/json':
+              | components['schemas']['FrameListResponse']
+              | components['schemas']['FrameLeanListResponse'];
+          };
+        };
+        /** @description Validation error */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
           };
         };
         /** @description Unauthorized */
@@ -8471,9 +8605,892 @@ interface paths {
             'application/json': components['schemas']['ErrorResponse'];
           };
         };
-      };
-    };
-    delete?: never;
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/projects/{projectId}/frames/{frameId}': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Read one frame
+     * @description One frame with its marks. A frame of another project reads back as nothing and answers 404, never 403, so this route cannot become an oracle for what exists elsewhere. A deleted frame is gone to every read. Requires member role.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          /** @description Frame ID (frm_...) */
+          frameId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description The frame */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['Frame'];
+          };
+        };
+        /** @description The path segment does not address a frame */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    /**
+     * Create or replace one frame
+     * @description The path is the identity, so the body carries no id: a create is a write to an absent row at `baseVersion` 0 and everything else is a replace. `clientWriteId` is minted at compose time and is what makes a replayed drain exact: a write whose id already produced the stored version landed once and is answered with that version, writing nothing, so an offline queue drains repeatedly without turning one edit into two versions. A write against a version someone else has moved past answers 409 `FRAME_VERSION_CONFLICT` carrying the head, which is what lets a client raise keep-mine against load-theirs on the one frame that conflicted instead of dropping what a person drew. A name another live frame already holds is a distinct 409 `FRAME_NAME_EXISTS`. A relation naming a frame this project does not hold, or one that would place a frame inside itself, is 400 `INVALID_FRAME`. The screenshot is never touched here: a frame write carries no capture. Requires member role.
+     */
+    put: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          /** @description Frame ID (frm_...) */
+          frameId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            frame: components['schemas']['FrameInput'];
+            baseVersion: number;
+            clientWriteId: string;
+          };
+        };
+      };
+      responses: {
+        /** @description The stored version */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['PutFrameResponse'];
+          };
+        };
+        /** @description Invalid body, a bad relation, or a path segment that addresses no frame */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description A stale base version, carrying the head, or a name another live frame already holds. Only the version conflict carries `head`: a name clash needs no frame to resolve, since the client already knows the name it sent. */
+        409: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json':
+              | components['schemas']['FrameConflictResponse']
+              | components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    post?: never;
+    /**
+     * Delete one frame
+     * @description Soft-delete the frame and, transitively, every variation of what this delete removes. Children are not variations and survive: each live frame under a removed one is re-parented to its nearest live ancestor in the same transaction, and one left with no live ancestor becomes top-level and inherits the page it hung under, so nothing is left unreachable. Those re-parents are server writes that bump their own versions, so a client still holding a pre-delete version meets a conflict carrying the new parent. A frame this project does not hold answers 404: a delete that removed nothing is not a delete that succeeded. Requires member role.
+     */
+    delete: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          /** @description Frame ID (frm_...) */
+          frameId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description The frame is deleted */
+        204: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content?: never;
+        };
+        /** @description The path segment does not address a frame */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/projects/{projectId}/frames/{frameId}/screenshot': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Store the capture of one frame
+     * @description Store one screenshot and set it on its frame. The image arrives as base64 rather than multipart, because the extension relay carries string bodies only. The server decides everything about the bytes: it decodes them, counts the DECODED length against a 4 MB cap, reads the type from the file’s own magic bytes, and hashes them, so nothing the client claims about size or type is consulted. Captures are deduplicated by content within a project: identical pixels resolve to one asset and one upload, and `reused` says whether that happened, which is the common answer rather than the rare one because re-capturing an unchanged frame produces identical bytes. A body past the cap is 413 `PAYLOAD_TOO_LARGE` and one that is not a PNG is 415 `UNSUPPORTED_MEDIA_TYPE`. The capture bumps no frame version: it is not an edit, so an upload never conflicts with the frame write the client queued beside it. Requires member role.
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          /** @description Frame ID (frm_...) */
+          frameId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            imageBase64: string;
+            meta: components['schemas']['FrameScreenshotMeta'];
+          };
+        };
+      };
+      responses: {
+        /** @description The asset the bytes resolved to, and whether it already existed */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ScreenshotUploadResponse'];
+          };
+        };
+        /** @description Invalid body, or a path segment that addresses no frame */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description This project does not hold the named frame */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description The decoded image is past the 4 MB cap */
+        413: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description The bytes are not a PNG */
+        415: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/projects/{projectId}/assets/{assetId}': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Read one stored capture
+     * @description The bytes of one frame screenshot, for the app canvas. The extension keeps its own capture locally and never reads assets back. Same-origin and session-authenticated: the response carries `Cross-Origin-Resource-Policy: same-origin`, so no other site can embed a tenant capture off the reader’s session. The bytes are immutable by construction, since the object key is their own content hash, which is why they are cacheable for a year, and `private` keeps a shared cache from serving one tenant’s capture to the next request for the same URL. An asset another project holds answers 404, never 403. Requires member role.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          /** @description Asset ID (fas_...) */
+          assetId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description The image bytes */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'image/png': string;
+          };
+        };
+        /** @description The path segment does not address an asset */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/projects/{projectId}/flows/{flowId}/releases/step-history': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List the releases that touched one step
+     * @description The releases of this flow that added, changed, or removed one step, newest first, each carrying the rationale stored for it. `step` is a `type.name` key over source, transformer, destination, store, and contract. `flow` narrows the scan to one named flow inside the config and is ignored for a contract key. `limit` bounds the releases scanned, not the entries returned. When nothing matched, `knownSteps` lists the addressable keys of the newest scanned release. Requires member role.
+     */
+    get: {
+      parameters: {
+        query: {
+          step: string;
+          flow?: string;
+          limit?: number | null;
+        };
+        header?: never;
+        path: {
+          projectId: string;
+          flowId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description The releases that touched the step */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['StepHistoryResponse'];
+          };
+        };
+        /** @description Invalid step key or query */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/projects/{projectId}/flows/{flowId}/releases/summarize': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Summarize or check a release
+     * @description Describe what one release of this flow changed against an earlier release, or check a written note against that same change. In `draft` mode the generated text is stored as the release's generated summary; in `check` mode nothing is stored and the response says whether the note matches. The diff is always recomputed from the two stored snapshots, with secret literals masked, and is never taken from the request. Both versions must be numbered releases of this flow, and `prevVersionId` must be the earlier of the two. Requires member role and the `hub` feature.
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          flowId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: {
+        content: {
+          'application/json': {
+            /** @example ver_a1b2c3d4 */
+            versionId: string;
+            /** @example ver_a1b2c3d4 */
+            prevVersionId: string;
+            /** @enum {string} */
+            mode: 'draft' | 'check';
+            currentText?: string;
+          };
+        };
+      };
+      responses: {
+        /** @description The generated summary or the check verdict */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['SummarizeReleaseResponse'];
+          };
+        };
+        /** @description Invalid body, a target is not a release, the pair is out of order, or no LLM provider is configured */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description The model call failed or returned no usable text */
+        502: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/projects/{projectId}/deployments/{deploymentId}/versions/current/content': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get current deployed content
+     * @description Get the active deployed per-setting content for a deployment, used to diff changes since deploy. Content is masked and display-only; every field is null when there is no deployed baseline. Requires member role.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          deploymentId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Deployed content (or a null baseline) */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['DeployedContentResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Rate limited */
+        429: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/projects/{projectId}/deployments/{deploymentId}/heartbeats': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List deployment heartbeats
+     * @description List heartbeat records for a deployment with optional from/to time-range filtering and pagination. Requires member role.
+     */
+    get: {
+      parameters: {
+        query?: {
+          /** @description ISO start of the time range. */
+          from?: string;
+          /** @description ISO end of the time range. */
+          to?: string;
+          limit?: number;
+          offset?: number | null;
+        };
+        header?: never;
+        path: {
+          projectId: string;
+          deploymentId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Heartbeat history */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ListHeartbeatsResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/api/projects/{projectId}/deployments/{deploymentId}/rotate-ingest-token': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Rotate ingest token
+     * @description Rotate the ingest token for a deployment. Owner-only. No grace window: the previous token is immediately invalidated and the new token is returned once.
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          projectId: string;
+          deploymentId: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description New ingest token */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['RotateIngestTokenResponse'];
+          };
+        };
+        /** @description Unauthorized */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Forbidden */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+        /** @description Not found */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': components['schemas']['ErrorResponse'];
+          };
+        };
+      };
+    };
+    delete?: never;
     options?: never;
     head?: never;
     patch?: never;
@@ -10127,6 +11144,10 @@ interface components {
        */
       updatedAt: string;
     };
+    DeploySettingsRequest: {
+      flow?: string;
+      humanText?: string;
+    };
     DeploySettingsResponse: {
       deploymentId: string;
       /** @example cfg_a1b2c3d4 */
@@ -10568,6 +11589,21 @@ interface components {
       /** Format: date-time */
       createdAt: string;
       createdBy: string | null;
+      createdByLabel: string | null;
+    };
+    ReleaseContentResponse: {
+      /** @example ver_a1b2c3d4 */
+      versionId: string;
+      /** @example 22 */
+      versionNumber: number;
+      content: components['schemas']['FlowConfig'];
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      createdAt: string;
+      /** @enum {string} */
+      createdBy: 'user' | 'auto_save' | 'restore' | 'deploy' | 'preview';
     };
     ListVersionAnnotationsResponse: {
       annotations: components['schemas']['VersionAnnotation'][];
@@ -10608,11 +11644,60 @@ interface components {
        */
       updatedAt: string;
     };
-    ListHubThreadsResponse: {
-      threads: components['schemas']['HubThread'][];
-      hasMoreThreads: boolean;
+    ListHubThreadsResponse: {
+      threads: components['schemas']['HubThread'][];
+      hasMoreThreads: boolean;
+    };
+    HubThread: {
+      /** @example thr_a1b2c3d4 */
+      id: string;
+      /**
+       * @example release
+       * @enum {string}
+       */
+      anchorType: 'step' | 'entity_action' | 'release' | 'contract' | 'tag';
+      anchorKey: string;
+      anchorLabel: string;
+      /**
+       * @example open
+       * @enum {string}
+       */
+      status: 'open' | 'resolved';
+      resolvedByVersionId: string | null;
+      resolvedByVersionNumber: number | null;
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      resolvedAt: string | null;
+      resolvedBy: string | null;
+      createdBy: string;
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      createdAt: string;
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      updatedAt: string;
+      messageCount: number;
+      messages?: components['schemas']['HubMessage'][];
+      hasMoreMessages?: boolean;
+    };
+    HubMessage: {
+      id: string;
+      /** @example user_a1b2c3d4 */
+      author: string;
+      text: string;
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      createdAt: string;
     };
-    HubThread: {
+    HubThreadResponse: {
       /** @example thr_a1b2c3d4 */
       id: string;
       /**
@@ -10650,41 +11735,331 @@ interface components {
       messages?: components['schemas']['HubMessage'][];
       hasMoreMessages?: boolean;
     };
-    HubMessage: {
+    ListKnowledgeResponse: {
+      entries: components['schemas']['KnowledgeEntry'][];
+      hasMoreEntries: boolean;
+    };
+    KnowledgeEntry:
+      | components['schemas']['KnowledgeThread']
+      | components['schemas']['KnowledgeDescription'];
+    KnowledgeThread: {
+      id: string;
+      anchorKey: string;
+      anchorLabel: string;
+      frameId: string | null;
+      frameName: string | null;
+      flowId: string | null;
+      subjectKey: string | null;
+      spatial: components['schemas']['KnowledgeSpatial'];
+      validity: components['schemas']['KnowledgeValidity'];
+      /** @enum {string} */
+      freshness: 'current' | 'subject_changed' | 'unknown';
+      author: components['schemas']['KnowledgeAuthor'];
+      /** @enum {string} */
+      source: 'tag_mode' | 'hub' | 'mcp';
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      updatedAt: string;
+      /**
+       * @description discriminator enum property added by openapi-typescript
+       * @enum {string}
+       */
+      kind: 'thread';
+      /**
+       * @example tag
+       * @enum {string}
+       */
+      anchorType:
+        | 'step'
+        | 'entity_action'
+        | 'release'
+        | 'contract'
+        | 'tag'
+        | 'page';
+      /**
+       * @example open
+       * @enum {string}
+       */
+      status: 'open' | 'resolved';
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      createdAt: string;
+      messageCount: number;
+      messages?: components['schemas']['KnowledgeMessage'][];
+      hasMoreMessages?: boolean;
+    };
+    KnowledgeSpatial: {
+      at: {
+        x: number;
+        y: number;
+      };
+      element?: {
+        [key: string]: unknown;
+      };
+    } | null;
+    KnowledgeValidity:
+      | {
+          /** @enum {string} */
+          tier: 'release';
+          versionId: string;
+          versionNumber: number;
+          promoted: boolean;
+        }
+      | {
+          /** @enum {string} */
+          tier: 'draft';
+          versionId?: string;
+        }
+      | {
+          /** @enum {string} */
+          tier: 'none';
+        };
+    KnowledgeAuthor: {
+      /** @enum {string} */
+      kind: 'user' | 'preview' | 'agent';
+      id: string | null;
+      label: string;
+    };
+    KnowledgeMessage: {
       id: string;
       /** @example user_a1b2c3d4 */
       author: string;
+      /** @example ayla@elbwalker.com */
+      authorLabel: string;
       text: string;
       /**
        * Format: date-time
        * @example 2026-01-26T14:30:00.000Z
        */
       createdAt: string;
+      clientMessageId: string | null;
     };
-    HubThreadResponse: {
-      /** @example thr_a1b2c3d4 */
+    KnowledgeDescription: {
       id: string;
+      anchorKey: string;
+      anchorLabel: string;
+      frameId: string | null;
+      frameName: string | null;
+      flowId: string | null;
+      subjectKey: string | null;
+      spatial: components['schemas']['KnowledgeSpatial'];
+      validity: components['schemas']['KnowledgeValidity'];
+      /** @enum {string} */
+      freshness: 'current' | 'subject_changed' | 'unknown';
+      author: components['schemas']['KnowledgeAuthor'];
+      /** @enum {string} */
+      source: 'tag_mode' | 'hub' | 'mcp';
       /**
-       * @example release
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      updatedAt: string;
+      /**
+       * @description discriminator enum property added by openapi-typescript
        * @enum {string}
        */
-      anchorType: 'step' | 'entity_action' | 'release' | 'contract' | 'tag';
+      kind: 'description';
+      /**
+       * @example tag
+       * @enum {string}
+       */
+      anchorType: 'tag' | 'page';
+      body: string;
+    };
+    KnowledgeThreadResponse: {
+      id: string;
       anchorKey: string;
       anchorLabel: string;
+      frameId: string | null;
+      frameName: string | null;
+      flowId: string | null;
+      subjectKey: string | null;
+      spatial: components['schemas']['KnowledgeSpatial'];
+      validity: components['schemas']['KnowledgeValidity'];
+      /** @enum {string} */
+      freshness: 'current' | 'subject_changed' | 'unknown';
+      author: components['schemas']['KnowledgeAuthor'];
+      /** @enum {string} */
+      source: 'tag_mode' | 'hub' | 'mcp';
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      updatedAt: string;
+      /** @enum {string} */
+      kind: 'thread';
+      /**
+       * @example tag
+       * @enum {string}
+       */
+      anchorType:
+        | 'step'
+        | 'entity_action'
+        | 'release'
+        | 'contract'
+        | 'tag'
+        | 'page';
       /**
        * @example open
        * @enum {string}
        */
       status: 'open' | 'resolved';
-      resolvedByVersionId: string | null;
-      resolvedByVersionNumber: number | null;
       /**
        * Format: date-time
        * @example 2026-01-26T14:30:00.000Z
        */
-      resolvedAt: string | null;
-      resolvedBy: string | null;
+      createdAt: string;
+      messageCount: number;
+      messages?: components['schemas']['KnowledgeMessage'][];
+      hasMoreMessages?: boolean;
+    };
+    KnowledgeDescriptionResponse: {
+      id: string;
+      anchorKey: string;
+      anchorLabel: string;
+      frameId: string | null;
+      frameName: string | null;
+      flowId: string | null;
+      subjectKey: string | null;
+      spatial: components['schemas']['KnowledgeSpatial'];
+      validity: components['schemas']['KnowledgeValidity'];
+      /** @enum {string} */
+      freshness: 'current' | 'subject_changed' | 'unknown';
+      author: components['schemas']['KnowledgeAuthor'];
+      /** @enum {string} */
+      source: 'tag_mode' | 'hub' | 'mcp';
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      updatedAt: string;
+      /** @enum {string} */
+      kind: 'description';
+      /**
+       * @example tag
+       * @enum {string}
+       */
+      anchorType: 'tag' | 'page';
+      body: string;
+    };
+    FrameInput: {
+      name: string;
+      /** @example frm_V1StGXR8Z5jdHi6BmyT7K */
+      parentId: string | null;
+      placements: components['schemas']['FramePlacement'][];
+      size: components['schemas']['PlanSize'];
+      marks: {
+        [key: string]: unknown;
+      };
+      /** @example frm_V1StGXR8Z5jdHi6BmyT7K */
+      extends: string | null;
+      source: components['schemas']['FrameSource'];
+      /** @enum {string} */
+      origin: 'drawn' | 'imported' | 'observed';
+      flowId: string | null;
+    };
+    FramePlacement: {
+      id: string;
+      rect: components['schemas']['PlanRect'];
+      selector?: string;
+      anchor?: {
+        [key: string]: unknown;
+      };
+    };
+    PlanRect: {
+      x: number;
+      y: number;
+      w: number;
+      h: number;
+    };
+    PlanSize: {
+      width: number;
+      height: number;
+    };
+    FrameSource:
+      | {
+          /** @enum {string} */
+          kind: 'page';
+          key: string;
+          url: string;
+        }
+      | {
+          /** @enum {string} */
+          kind: 'figma';
+          fileKey: string;
+          nodeId: string;
+        }
+      | {
+          /** @enum {string} */
+          kind: 'image';
+        }
+      | null;
+    Frame: {
+      /** @example frm_V1StGXR8Z5jdHi6BmyT7K */
+      id: string;
+      projectId: string;
+      name: string;
+      parentId: string | null;
+      placements: components['schemas']['FramePlacement'][];
+      size: components['schemas']['PlanSize'];
+      marks: {
+        [key: string]: unknown;
+      };
+      extends: string | null;
+      source: components['schemas']['FrameSource'];
+      /** @enum {string} */
+      origin: 'drawn' | 'imported' | 'observed';
+      flowId: string | null;
+      screenshot: components['schemas']['FrameScreenshot'];
+      version: number;
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      createdAt: string;
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      updatedAt: string;
       createdBy: string;
+      updatedBy: string;
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      deletedAt: string | null;
+    };
+    FrameScreenshot: {
+      assetId: string;
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      capturedAt: string;
+      size: components['schemas']['PlanSize'];
+      dpr: number;
+      capturedRect: components['schemas']['PlanRect'];
+    } | null;
+    FrameLean: {
+      /** @example frm_V1StGXR8Z5jdHi6BmyT7K */
+      id: string;
+      projectId: string;
+      name: string;
+      parentId: string | null;
+      placements: components['schemas']['FramePlacement'][];
+      size: components['schemas']['PlanSize'];
+      extends: string | null;
+      source: components['schemas']['FrameSource'];
+      /** @enum {string} */
+      origin: 'drawn' | 'imported' | 'observed';
+      flowId: string | null;
+      screenshot: components['schemas']['FrameScreenshot'];
+      version: number;
       /**
        * Format: date-time
        * @example 2026-01-26T14:30:00.000Z
@@ -10695,9 +12070,30 @@ interface components {
        * @example 2026-01-26T14:30:00.000Z
        */
       updatedAt: string;
-      messageCount: number;
-      messages?: components['schemas']['HubMessage'][];
-      hasMoreMessages?: boolean;
+      createdBy: string;
+      updatedBy: string;
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      deletedAt: string | null;
+    };
+    FrameListResponse: {
+      frames: components['schemas']['Frame'][];
+    };
+    FrameLeanListResponse: {
+      frames: components['schemas']['FrameLean'][];
+    };
+    PutFrameResponse: {
+      version: number;
+    };
+    FrameConflictResponse: {
+      error: {
+        /** @enum {string} */
+        code: 'FRAME_VERSION_CONFLICT';
+        message: string;
+      };
+      head: components['schemas']['Frame'];
     };
     SummarizeReleaseResponse: {
       /** @enum {string} */
@@ -11936,6 +13332,21 @@ interface components {
     DeclineInvitationResponse: {
       message: string;
     };
+    ScreenshotUploadResponse: {
+      /** @example fas_V1StGXR8Z5jdHi6BmyT7K */
+      assetId: string;
+      reused: boolean;
+    };
+    FrameScreenshotMeta: {
+      /**
+       * Format: date-time
+       * @example 2026-01-26T14:30:00.000Z
+       */
+      capturedAt: string;
+      size: components['schemas']['PlanSize'];
+      dpr: number;
+      capturedRect: components['schemas']['PlanRect'];
+    };
     HeartbeatRequest: {
       /** @example a1b2c3d4e5f6 */
       instanceId: string;
@@ -12731,6 +14142,143 @@ interface EndObserveSessionOptions {
  */
 declare function endObserveSession(options: EndObserveSessionOptions): Promise<void>;
 
+type VersionAnnotation = components['schemas']['VersionAnnotation'];
+type FlowRelease = components['schemas']['FlowRelease'];
+type StepHistoryResponse = components['schemas']['StepHistoryResponse'];
+type ListHubThreadsResponse = components['schemas']['ListHubThreadsResponse'];
+type HubThreadResponse = components['schemas']['HubThreadResponse'];
+type ListKnowledgeResponse = components['schemas']['ListKnowledgeResponse'];
+/** The rationale summary a release index row carries when asked for one. */
+interface ReleaseRationaleSummary {
+    hasHumanText: boolean;
+    hasGeneratedSummary: boolean;
+    /** First non-empty line of the human text, cut at 120 characters. */
+    firstLine: string | null;
+}
+interface ReleaseIndexResponse {
+    releases: Array<FlowRelease & {
+        rationale?: ReleaseRationaleSummary | null;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+}
+interface ReleaseDiffResponse {
+    prevVersionId: string;
+    prevVersionNumber: number;
+    /** Rendered from masked content. Empty when nothing visible changed. */
+    text: string;
+    /** Compared over unmasked content hashes, so this is the real answer. */
+    contentIdentical: boolean;
+}
+interface ReleaseDetailResponse {
+    versionId: string;
+    versionNumber: number;
+    contentHash: string | null;
+    createdAt: string;
+    createdBy: string;
+    rationale: VersionAnnotation | null;
+    /** Null for the flow's oldest release. */
+    diff: ReleaseDiffResponse | null;
+}
+interface ListReleasesOptions {
+    projectId?: string;
+    flowId: string;
+    limit?: number;
+    offset?: number;
+}
+/** The release index WITH its rationale summary. Requires the hub feature. */
+declare function listReleases(options: ListReleasesOptions): Promise<ReleaseIndexResponse>;
+/** How a release is addressed: by spine id, or by spine number. */
+type ReleaseRef = {
+    versionId: string;
+} | {
+    versionNumber: number;
+};
+interface GetReleaseOptions {
+    projectId?: string;
+    flowId: string;
+    ref: ReleaseRef;
+}
+/**
+ * One release in full: rationale plus the diff the SERVER computed against the
+ * spine predecessor. The path segment is the id or the number; the app decides
+ * which it was.
+ */
+declare function getRelease(options: GetReleaseOptions): Promise<ReleaseDetailResponse>;
+interface ListStepHistoryOptions {
+    projectId?: string;
+    flowId: string;
+    step: string;
+    flow?: string;
+    limit?: number;
+}
+declare function listStepHistory(options: ListStepHistoryOptions): Promise<StepHistoryResponse>;
+interface SetReleaseRationaleOptions {
+    projectId?: string;
+    flowId: string;
+    versionId: string;
+    text: string;
+}
+declare function setReleaseRationale(options: SetReleaseRationaleOptions): Promise<VersionAnnotation>;
+type ThreadAnchorType = 'step' | 'entity_action' | 'release' | 'contract' | 'tag';
+type ThreadStatus = 'open' | 'resolved';
+interface ListThreadsOptions {
+    projectId?: string;
+    flowId: string;
+    anchorType?: ThreadAnchorType;
+    anchorKey?: string;
+    status?: ThreadStatus;
+    includeMessages: boolean;
+    limit?: number;
+}
+declare function listThreads(options: ListThreadsOptions): Promise<ListHubThreadsResponse>;
+interface CreateThreadOptions {
+    projectId?: string;
+    flowId: string;
+    anchorType: ThreadAnchorType;
+    anchorKey: string;
+    anchorLabel?: string;
+    text: string;
+}
+declare function createThread(options: CreateThreadOptions): Promise<HubThreadResponse>;
+interface AddThreadMessageOptions {
+    projectId?: string;
+    flowId: string;
+    threadId: string;
+    text: string;
+}
+declare function addThreadMessage(options: AddThreadMessageOptions): Promise<HubThreadResponse>;
+interface ListKnowledgeOptions {
+    projectId?: string;
+    pageKey?: string;
+    frameId?: string;
+    markId?: string;
+    includeMessages: boolean;
+    limit?: number;
+}
+declare function listKnowledge(options: ListKnowledgeOptions): Promise<ListKnowledgeResponse>;
+
+type FrameResponse = components['schemas']['Frame'];
+type FrameListResponse = components['schemas']['FrameListResponse'];
+type FrameLeanListResponse = components['schemas']['FrameLeanListResponse'];
+interface ListFramesOptions {
+    projectId?: string;
+}
+/** Every live frame of the project, without marks. Requires the frames feature. */
+declare function listFrames(options?: ListFramesOptions): Promise<FrameLeanListResponse>;
+interface ListPageFramesOptions {
+    projectId?: string;
+    pageKey: string;
+}
+/** The frames of one page at any depth, with their marks. */
+declare function listPageFrames(options: ListPageFramesOptions): Promise<FrameListResponse>;
+interface GetFrameOptions {
+    projectId?: string;
+    frameId: string;
+}
+declare function getFrame(options: GetFrameOptions): Promise<FrameResponse>;
+
 interface ListSecretsOptions {
     projectId?: string;
     flowId: string;
@@ -13076,4 +14624,4 @@ declare module '@walkeros/core' {
     }
 }
 
-export { ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CompareContractInput, type ContractComparison, type ContractVerdict, type CreatePreviewOptions, type CreateSecretOptions, type DeletePreviewOptions, type DeleteSecretOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceCodeOptions, type DeviceCodeResult, type EndObserveSessionOptions, type ExampleLookupResult, type FeedbackOptions, type GetObserveSessionOptions, type GetPreviewOptions, type GlobalOptions, type HealthResult, type ListDeploymentsOptions, type ListFlowsOptions, type ListJourneysOptions, type ListPreviewsOptions, type ListProjectsOptions, type ListSecretsOptions, type MinifyOptions, type PollOptions, type PollResult, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RegrantPreviewOptions, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SimulateCollectorOptions, type SimulateDataOptions, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type StartObserveSessionOptions, type UpdateSecretOptions, VERSION, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, annotateErrorWithDrift, apiFetch, bakedContractHash, bakedContractVersion, buildDataPayload, bundle, bundleCommand, canonicalContractHash, classifyStepProperties, clientContextHeaders, compareContract, compareOutput, containsCodeMarkers, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, createSecret, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deleteSecret, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, endObserveSession, feedback, feedbackCommand, fetchHealth, findExample, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getObserveSession, getPreview, getProject, getProjectCommand, getToken, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listJourneys, listPreviews, listProjects, listProjectsCommand, listSecrets, loadConfig, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, pollForToken, publicFetch, push, pushCommand, readConfig, regrantPreview, requestDeviceCode, requireProjectId, resetClientContext, resolveAppUrl, resolveToken, run, runCommand, setClientContext, setDefaultProject, setFeedbackPreference, simulateCollector, simulateDestination, simulateSource, simulateTransformer, startObserveSession, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, updateSecret, validate, validateCommand, validateFlowStructure, whoami, whoamiCommand, wrapSkeleton, writeConfig };
+export { type AddThreadMessageOptions, ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CompareContractInput, type ContractComparison, type ContractVerdict, type CreatePreviewOptions, type CreateSecretOptions, type CreateThreadOptions, type DeletePreviewOptions, type DeleteSecretOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceCodeOptions, type DeviceCodeResult, type EndObserveSessionOptions, type ExampleLookupResult, type FeedbackOptions, type GetFrameOptions, type GetObserveSessionOptions, type GetPreviewOptions, type GetReleaseOptions, type GlobalOptions, type HealthResult, type ListDeploymentsOptions, type ListFlowsOptions, type ListFramesOptions, type ListJourneysOptions, type ListKnowledgeOptions, type ListPageFramesOptions, type ListPreviewsOptions, type ListProjectsOptions, type ListReleasesOptions, type ListSecretsOptions, type ListStepHistoryOptions, type ListThreadsOptions, type MinifyOptions, type PollOptions, type PollResult, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RegrantPreviewOptions, type ReleaseDetailResponse, type ReleaseDiffResponse, type ReleaseIndexResponse, type ReleaseRationaleSummary, type ReleaseRef, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SetReleaseRationaleOptions, type SimulateCollectorOptions, type SimulateDataOptions, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type StartObserveSessionOptions, type ThreadAnchorType, type ThreadStatus, type UpdateSecretOptions, VERSION, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, addThreadMessage, annotateErrorWithDrift, apiFetch, bakedContractHash, bakedContractVersion, buildDataPayload, bundle, bundleCommand, canonicalContractHash, classifyStepProperties, clientContextHeaders, compareContract, compareOutput, containsCodeMarkers, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, createSecret, createThread, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deleteSecret, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, endObserveSession, feedback, feedbackCommand, fetchHealth, findExample, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getFrame, getObserveSession, getPreview, getProject, getProjectCommand, getRelease, getToken, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listFrames, listJourneys, listKnowledge, listPageFrames, listPreviews, listProjects, listProjectsCommand, listReleases, listSecrets, listStepHistory, listThreads, loadConfig, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, pollForToken, publicFetch, push, pushCommand, readConfig, regrantPreview, requestDeviceCode, requireProjectId, resetClientContext, resolveAppUrl, resolveToken, run, runCommand, setClientContext, setDefaultProject, setFeedbackPreference, setReleaseRationale, simulateCollector, simulateDestination, simulateSource, simulateTransformer, startObserveSession, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, updateSecret, validate, validateCommand, validateFlowStructure, whoami, whoamiCommand, wrapSkeleton, writeConfig };