@shardflux/sdk 0.8.0 → 0.10.0

package/dist/generated/cell-api.d.ts

@@ -66,8 +66,20 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Start a command (idempotent by session_id)
+         * Start a command (idempotent by session_id), or run an execution of a file-first workspace
          * @description Requires tool `exec`. argv is executed directly (no shell).
+         *
+         *     On a file-first workspace (contracts §29.2) this runs an execution:
+         *     `execution_id` is required (the idempotency key), and the call
+         *     answers when the command ended with an `ExecutionResult` (`201`
+         *     when this call ran it; `200` when the execution already existed:
+         *     its recorded result, after waiting for it if it was still running;
+         *     a client that gives up waiting retries with the same id or polls
+         *     `GET /executions/{execution_id}`). Refusals before anything ran
+         *     leave the id unused: `409 workspace_busy` (`execution_in_progress`),
+         *     `503 service_unavailable` (`no_execution_host`: no host with
+         *     protocol feature `file_first` has room; retry), secret resolution
+         *     errors as for processful starts.
          */
         post: operations["execStart"];
         delete?: never;
@@ -198,6 +210,33 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/workspaces/{workspace_id}/executions/{execution_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                execution_id: components["parameters"]["ExecutionId"];
+            };
+            cookie?: never;
+        };
+        /**
+         * An execution of a file-first workspace (contracts §29.2)
+         * @description Requires tool `exec`. `200` with the result once the execution
+         *     ended (`succeeded`, `failed` or `lost`), `202` with `state` `queued`
+         *     or `running` (no output yet) while it runs; `404 not_found` for an
+         *     unknown id. Results are kept 7 days. Processful workspaces: `409
+         *     conflict`, `details.reason not_supported_for_mode`.
+         */
+        get: operations["executionGet"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/workspaces/{workspace_id}/pty": {
         parameters: {
             query?: never;
@@ -431,6 +470,72 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/workspaces/{workspace_id}/files/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Search file contents under a directory (bounded; read-only)
+         * @description Walks `path` (default `/`), skipping `exclude` globs, files above
+         *     `max_file_bytes`, binary files (a NUL byte in the first 8 KiB) and
+         *     symbolic links, and returns matching lines in path order until
+         *     `max_matches` or the time budget. `truncated` says whether the walk
+         *     stopped early. Served from disk while the workspace sleeps
+         *     (contracts §26.4). A workspace whose host predates search: `409
+         *     conflict`, `details.reason host_feature_unavailable`,
+         *     `details.feature file_search`, not retryable (contracts §26.7).
+         *     Tool `files`.
+         */
+        post: operations["fileSearch"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/files/patch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Apply text edits to a file atomically, optionally requiring its current revision
+         * @description Exactly one of `edits` (each `old_text` must occur exactly once unless
+         *     `replace_all`; applied in order) or `content` (replace the whole file).
+         *     With `expected_revision` the file must currently have that revision
+         *     (`absent`: it must not exist) or the call fails with `409 conflict`,
+         *     `details.reason revision_mismatch`, `details.current_revision`
+         *     (`absent` for a missing file). An existing file keeps its mode and
+         *     owner. Edits that do not apply: `422 validation_failed`,
+         *     `details.reason edit_not_found` or `edit_ambiguous`, `details.index`.
+         *     Acknowledged after the file and its parent directory were fsync'd.
+         *     Send `Idempotency-Key` to make a retry a no-op. Limits: request body
+         *     up to 7 MiB (`413 payload_too_large`), files up to 64 MiB, a symlink
+         *     target is refused. A workspace whose host predates patches: `409
+         *     conflict`, `details.reason host_feature_unavailable`,
+         *     `details.feature file_patch`, not retryable (contracts §26.7).
+         *     Tool `files`.
+         */
+        post: operations["filePatch"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/workspaces/{workspace_id}/files/move": {
         parameters: {
             query?: never;
@@ -547,6 +652,35 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/workspaces/{workspace_id}/wake-hint": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Announce an imminent tool call so a parked workspace is restored ahead of it
+         * @description Best effort and cheap: returns immediately. If the workspace is
+         *     hibernated its host starts restoring it now (contracts §25.5); frozen
+         *     and resident workspaces need nothing. A hint not followed by a tool
+         *     call within `WAKE_HINT_HOLD_SECONDS` (default 60) is released. A
+         *     suspended workspace answers `409 workspace_not_running` (resume it
+         *     through the application API). A host that predates wake hints does
+         *     not park: `resident` (contracts §26.7). Not subject to the tool gate
+         *     and not tool activity; any tool the token grants authorizes it.
+         */
+        post: operations["workspaceWakeHint"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/workspaces/{workspace_id}/keepalive": {
         parameters: {
             query?: never;
@@ -589,9 +723,22 @@ export interface paths {
          *     none is known; in the future while a keepalive or a running command is
          *     active). A running exec command counts as work until min(its start +
          *     `IDLE_COMMAND_MAX_SECONDS`, its start + `timeout_ms`), and its end is
-         *     activity (contracts §20.6). `suspend_at` = `idle_since` + `idle_minutes` when
+         *     activity (contracts §20.6): an end seen without a client call is
+         *     recorded in `last_attach_at`, which is work but not a tool call.
+         *     `suspend_at` = `idle_since` + `idle_minutes` when
          *     the policy is `suspend_after` and automatic suspend is enabled, else
          *     null; the idle loop acts within `2 x ACTIVITY_FLUSH_MS` after it.
+         *     `suspend_request` is the pending suspend request of the application
+         *     API's `POST /v1/workspaces/{id}/suspend-when-idle` while it is valid:
+         *     the workspace is running, `last_tool_at` is not later than
+         *     `requested_at` + 0.5 s and `running_since` not later than
+         *     `requested_at` (a tool call or a resume after the request cancels it
+         *     for good), else null. A valid request applies under every policy
+         *     (`never` included) unless automatic suspend was disabled after
+         *     repeated failures; `suspend_at` is then the earlier of the policy's
+         *     time and max(`idle_since`, `requested_at`) + `after_seconds`, so an
+         *     attached stream, a keepalive or a running command defers it until
+         *     `after_seconds` after it ends (contracts §20.6).
          *     Activity lags tool traffic by up to `ACTIVITY_FLUSH_MS`. Any
          *     tool granted by the token authorizes the call; the tool gate does not
          *     apply and the call is not tool activity.
@@ -693,6 +840,7 @@ export interface components {
             env?: {
                 [key: string]: string;
             };
+            /** @description Absolute working directory; omitted or empty starts in the default (/home/user). A relative path is refused, not resolved: 422 validation_failed, details.reason invalid_cwd, details.field cwd, the message naming the absolute path it likely means. A cwd that is not a directory ends the session failed_to_start (processful) or the execution failed with details.reason exec_failed_to_start (file-first). */
             cwd?: string;
             user?: string;
             /** @description Written to stdin, which is then closed (max 1 MiB decoded). */
@@ -702,9 +850,82 @@ export interface components {
             /** Format: int64 */
             kill_grace_ms?: number;
             secret_refs?: components["schemas"]["SecretRefs"];
+            /** @description File-first workspaces (required there, refused otherwise) — the execution's idempotency key. */
+            execution_id?: components["schemas"]["ExecutionIdValue"];
+            /**
+             * Format: int64
+             * @description File-first workspaces — stdout and stderr are each captured up to this many bytes.
+             * @default 1048576
+             */
+            output_limit_bytes?: number;
         };
         /** @description Names of customer secrets (contracts §17) to inject as environment variables NAME=value of this process only. The cell resolves them at session start through the API with the caller's tool token (permission-checked and audited by the API); values are never logged, persisted or returned by the cell. Any name the caller may not use (unknown, not permitted for this workspace/project/tool) refuses the whole start with 403 forbidden (details.reason secret_not_available, details.names); nothing is started. A name that is also a key of `env` is refused (422 validation_failed). Requires a workspace tool token (browser stream tickets cannot resolve secrets: 403, details.reason secret_refs_require_tool_token). Resolution failures: 401 (token revoked/expired), 409 stale_epoch, 429 rate_limited, 503 dependency_unavailable. A retried start with the same session_id re-resolves the names; if a value changed since the first start the host refuses the different request (409 conflict). */
         SecretRefs: string[];
+        /** @description A caller-chosen execution id (8..128 characters), unique per workspace. */
+        ExecutionIdValue: string;
+        /**
+         * @description queued/running: in progress. succeeded: the command ran to its end
+         *     (any exit code; see exit_code, timed_out) and the files it changed
+         *     were published as tree_revision. failed: the execution could not run
+         *     the command or its result could not be published (error); nothing
+         *     was published. lost: the execution's host or cell stopped answering
+         *     (no heartbeat for EXECUTION_LEASE_SECONDS), the host restarted, or the
+         *     workspace was deleted; nothing was published. After failed or lost,
+         *     retry with a new execution_id.
+         * @enum {string}
+         */
+        ExecutionState: "queued" | "running" | "succeeded" | "failed" | "lost";
+        ExecutionChange: {
+            /** @description Guest path (under /home/user). */
+            path: string;
+            /** @enum {string} */
+            change: "added" | "modified" | "deleted";
+            /**
+             * @description The new entry's type (deleted: the removed entry's).
+             * @enum {string}
+             */
+            type: "file" | "directory" | "symlink";
+        };
+        ExecutionResult: {
+            execution_id: string;
+            state: components["schemas"]["ExecutionState"];
+            /**
+             * Format: int64
+             * @description The tree revision the command ran on.
+             */
+            base_revision: number;
+            /**
+             * Format: int64
+             * @description The tree revision after the execution (succeeded) — base_revision + 1 when it changed files, else base_revision; null otherwise.
+             */
+            tree_revision: number | null;
+            /** @description The command's exit status (-1 when terminated by a signal); null unless succeeded. */
+            exit_code: number | null;
+            term_signal: number | null;
+            /** @description The command ran past timeout_ms and was killed. */
+            timed_out: boolean;
+            /** @description Standard output (base64), at most output_limit_bytes. */
+            stdout: string;
+            /** @description Standard error (base64), at most output_limit_bytes. */
+            stderr: string;
+            stdout_truncated: boolean;
+            stderr_truncated: boolean;
+            /** @description Entries the execution added, modified or deleted under /home/user, sorted by path (at most 10000). */
+            changed: components["schemas"]["ExecutionChange"][];
+            changed_truncated: boolean;
+            /** @description Milliseconds and counts: queue_ms, run_ms, publish_ms, total_ms, and the host's (materialize_ms, boot_ms, exec_ms, collect_ms, blobs_fetched, blobs_uploaded, vm_seconds, ...). */
+            timings: {
+                [key: string]: number;
+            };
+            /** @description failed / lost: the ErrorBody.error shape {code (an ErrorCode), message, retryable, details.reason}; reason names the cause: a host refusal (blob_missing, blob_corrupt, exec_failed_to_start, template_missing, layout_unsupported, guest_feature_unavailable, tree_invalid, ...), no_execution_host, lease_expired, host_unreachable, host_restarted, workspace_deleted, tree_moved, result_invalid. retryable: a new execution_id may succeed. */
+            error?: {
+                [key: string]: unknown;
+            } | null;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            finished_at: string | null;
+        };
         ExecSession: {
             session_id: string;
             state: components["schemas"]["SessionState"];
@@ -732,6 +953,7 @@ export interface components {
             started_at?: string | null;
             /** Format: date-time */
             ended_at?: string | null;
+            /** @description Why the session ended without an exit code. For failed_to_start the command never ran and this names the cause, e.g. `working directory "/home/user/app" is not a directory` or `executable "foo" not found in PATH`. */
             error?: string;
         };
         OutputEvent: {
@@ -775,6 +997,7 @@ export interface components {
             env?: {
                 [key: string]: string;
             };
+            /** @description Absolute working directory; omitted or empty starts in the default (/home/user). A relative path is refused: 422 validation_failed, details.reason invalid_cwd, details.field cwd. */
             cwd?: string;
             user?: string;
             /** @default 24 */
@@ -860,6 +1083,93 @@ export interface components {
             uid?: number;
             gid?: number;
             symlink_target?: string;
+            /** @description SHA-256 of the content (regular files; only when requested or returned by a write/patch). */
+            revision?: string;
+        };
+        /** @description A content SHA-256, or `absent` for a path that must not exist. */
+        FileRevision: string;
+        FileSearchRequest: {
+            /** @default / */
+            path?: components["schemas"]["GuestPath"];
+            pattern: string;
+            /**
+             * @description RE2 syntax when true; a literal substring otherwise.
+             * @default false
+             */
+            regex?: boolean;
+            /** @default false */
+            case_insensitive?: boolean;
+            /** @description Glob patterns (`*`, `**`, `?`, `[...]`), gitignore-style: a pattern without `/` matches the name at any depth (`*.go`); one with `/` matches the path relative to `path` (`src/**\/*.ts`). A file must match one when given. */
+            include?: string[];
+            /** @description Glob patterns skipped (files and whole directories). Default: ["**\/.git/**", "**\/node_modules/**"]; send [] to search everything. */
+            exclude?: string[];
+            /** @default 200 */
+            max_matches?: number;
+            /**
+             * Format: int64
+             * @default 1048576
+             */
+            max_file_bytes?: number;
+            /** @default 0 */
+            context_lines?: number;
+        };
+        FileSearchMatch: {
+            path: string;
+            /** @description 1-based. */
+            line: number;
+            /** @description 1-based byte column of the first match on the line. */
+            column: number;
+            /** @description The line, without its newline, truncated to 1000 bytes. */
+            text: string;
+            before?: string[];
+            after?: string[];
+        };
+        FileSearchResult: {
+            matches: components["schemas"]["FileSearchMatch"][];
+            /** @description true when the walk stopped early (see stop_reason). */
+            truncated: boolean;
+            /**
+             * @description Why the walk stopped early: max_matches reached, the 10 s budget, or 4 MiB of results.
+             * @enum {string}
+             */
+            stop_reason?: "max_matches" | "budget" | "max_bytes";
+            /** Format: int64 */
+            files_scanned: number;
+        };
+        FileEdit: {
+            old_text: string;
+            new_text: string;
+            /** @default false */
+            replace_all?: boolean;
+        };
+        FilePatchRequest: {
+            path: components["schemas"]["GuestPath"];
+            edits?: components["schemas"]["FileEdit"][];
+            /** @description Replace the whole file (UTF-8 text) instead of edits. */
+            content?: string;
+            expected_revision?: components["schemas"]["FileRevision"];
+            /** @default false */
+            create_parents?: boolean;
+            /** @description Permission bits for a new file (an existing file keeps its mode). */
+            mode?: string;
+        };
+        FilePatchResult: {
+            path: string;
+            revision: string;
+            previous_revision: components["schemas"]["FileRevision"];
+            /** Format: int64 */
+            bytes_written: number;
+            durable: boolean;
+            /** @description Number of replaced occurrences (edits). */
+            replacements?: number;
+            file?: components["schemas"]["FileInfo"];
+        };
+        WakeHintResult: {
+            /**
+             * @description What the host found when the hint arrived (contracts §25.1).
+             * @enum {string}
+             */
+            residency: "resident" | "frozen" | "hibernated" | "restoring";
         };
         FileList: {
             entries: components["schemas"]["FileInfo"][];
@@ -916,6 +1226,8 @@ export interface components {
             /** @description The file and its parent directory were fsync'd before this reply. */
             durable: boolean;
             file?: components["schemas"]["FileInfo"];
+            /** @description The file's revision after the write (equals sha256 for a replace; the whole file's hash after an append). */
+            revision?: string;
         };
         MkdirRequest: {
             path: components["schemas"]["GuestPath"];
@@ -1052,6 +1364,25 @@ export interface components {
                 [key: string]: unknown;
             } | null;
         };
+        /**
+         * @description A pending suspend request (application API `POST /v1/workspaces/{id}/suspend-when-idle`):
+         *     once the workspace has been idle for `after_seconds` after `requested_at`, suspend it.
+         */
+        IdleSuspendRequest: {
+            /**
+             * Format: date-time
+             * @description When the request was made (database clock); a newer request replaces it.
+             */
+            requested_at: string;
+            after_seconds: number;
+            /**
+             * Format: date-time
+             * @description requested_at + after_seconds, the earliest suspend (the idle loop acts within
+             *     2 x ACTIVITY_FLUSH_MS after it). A work signal still active then defers it;
+             *     suspend_at is the projection.
+             */
+            not_before: string;
+        };
         IdleStatus: {
             policy: components["schemas"]["IdlePolicy"];
             /** @description Workspace observed_state (contracts §9). */
@@ -1069,6 +1400,8 @@ export interface components {
             /** Format: date-time */
             suspend_at: string | null;
             auto_suspend: components["schemas"]["IdleAutoSuspend"];
+            /** @description The pending suspend request while it is valid, else null. */
+            suspend_request: components["schemas"]["IdleSuspendRequest"] | null;
         };
     };
     responses: {
@@ -1088,6 +1421,9 @@ export interface components {
         WorkspaceId: string;
         SessionId: components["schemas"]["SessionIdValue"];
         FilePath: components["schemas"]["GuestPath"];
+        ExecutionId: components["schemas"]["ExecutionIdValue"];
+        /** @description File-first workspaces only (ignored otherwise): the tree revision the call applies to, e.g. `7` or `"7"`. Another current revision fails the call with 409 conflict, details.reason tree_revision_mismatch, details.current_tree_revision. */
+        IfMatch: string;
     };
     requestBodies: never;
     headers: never;
@@ -1171,22 +1507,22 @@ export interface operations {
             };
         };
         responses: {
-            /** @description The session already existed; nothing was run again. */
+            /** @description The session already existed; nothing was run again (processful), or the recorded result of an existing execution (file-first). */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ExecSession"];
+                    "application/json": components["schemas"]["ExecSession"] | components["schemas"]["ExecutionResult"];
                 };
             };
-            /** @description Session created and started. */
+            /** @description Session created and started (processful), or the execution ran (file-first, ExecutionResult). */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ExecSession"];
+                    "application/json": components["schemas"]["ExecSession"] | components["schemas"]["ExecutionResult"];
                 };
             };
             default: components["responses"]["Error"];
@@ -1327,6 +1663,39 @@ export interface operations {
             default: components["responses"]["Error"];
         };
     };
+    executionGet: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+                execution_id: components["parameters"]["ExecutionId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The execution ended. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecutionResult"];
+                };
+            };
+            /** @description The execution is queued or running. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExecutionResult"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
     ptyOpen: {
         parameters: {
             query?: never;
@@ -1563,6 +1932,12 @@ export interface operations {
                 headers: {
                     /** @description File size when the read started. */
                     "X-File-Size"?: number;
+                    /** @description SHA-256 of the whole file's content, for files of 16 MiB or less (contracts §26.2). */
+                    "X-File-Revision"?: string;
+                    /** @description disk: read from the suspended or hibernated workspace's disk (contracts §26.4). */
+                    "X-Served-From"?: "guest" | "disk";
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
                     [name: string]: unknown;
                 };
                 content: {
@@ -1573,6 +1948,8 @@ export interface operations {
             206: {
                 headers: {
                     "Content-Range"?: string;
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
                     [name: string]: unknown;
                 };
                 content: {
@@ -1593,6 +1970,8 @@ export interface operations {
             };
             header?: {
                 "Idempotency-Key"?: string;
+                /** @description File-first workspaces only (ignored otherwise): the tree revision the call applies to, e.g. `7` or `"7"`. Another current revision fails the call with 409 conflict, details.reason tree_revision_mismatch, details.current_tree_revision. */
+                "If-Match"?: components["parameters"]["IfMatch"];
             };
             path: {
                 workspace_id: components["parameters"]["WorkspaceId"];
@@ -1608,6 +1987,8 @@ export interface operations {
             /** @description Written and fsync'd. */
             200: {
                 headers: {
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
                     [name: string]: unknown;
                 };
                 content: {
@@ -1623,7 +2004,10 @@ export interface operations {
                 path: components["parameters"]["FilePath"];
                 recursive?: boolean;
             };
-            header?: never;
+            header?: {
+                /** @description File-first workspaces only (ignored otherwise): the tree revision the call applies to, e.g. `7` or `"7"`. Another current revision fails the call with 409 conflict, details.reason tree_revision_mismatch, details.current_tree_revision. */
+                "If-Match"?: components["parameters"]["IfMatch"];
+            };
             path: {
                 workspace_id: components["parameters"]["WorkspaceId"];
             };
@@ -1634,6 +2018,8 @@ export interface operations {
             /** @description Removed. */
             204: {
                 headers: {
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
                     [name: string]: unknown;
                 };
                 content?: never;
@@ -1645,6 +2031,8 @@ export interface operations {
         parameters: {
             query: {
                 path: components["parameters"]["FilePath"];
+                /** @description Include `revision` (SHA-256 of the content) for a regular file of up to 256 MiB. Omitted when the workspace's host predates revisions (contracts §26.7). */
+                revision?: boolean;
             };
             header?: never;
             path: {
@@ -1657,6 +2045,10 @@ export interface operations {
             /** @description File info. */
             200: {
                 headers: {
+                    /** @description disk: read from the suspended or hibernated workspace's disk (contracts §26.4). */
+                    "X-Served-From"?: "guest" | "disk";
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
                     [name: string]: unknown;
                 };
                 content: {
@@ -1683,6 +2075,10 @@ export interface operations {
             /** @description Entries. */
             200: {
                 headers: {
+                    /** @description disk: read from the suspended or hibernated workspace's disk (contracts §26.4). */
+                    "X-Served-From"?: "guest" | "disk";
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
                     [name: string]: unknown;
                 };
                 content: {
@@ -1695,7 +2091,10 @@ export interface operations {
     fileMkdir: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description File-first workspaces only (ignored otherwise): the tree revision the call applies to, e.g. `7` or `"7"`. Another current revision fails the call with 409 conflict, details.reason tree_revision_mismatch, details.current_tree_revision. */
+                "If-Match"?: components["parameters"]["IfMatch"];
+            };
             path: {
                 workspace_id: components["parameters"]["WorkspaceId"];
             };
@@ -1710,6 +2109,8 @@ export interface operations {
             /** @description Directory info. */
             200: {
                 headers: {
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
                     [name: string]: unknown;
                 };
                 content: {
@@ -1719,7 +2120,7 @@ export interface operations {
             default: components["responses"]["Error"];
         };
     };
-    fileMove: {
+    fileSearch: {
         parameters: {
             query?: never;
             header?: never;
@@ -1728,6 +2129,72 @@ export interface operations {
             };
             cookie?: never;
         };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["FileSearchRequest"];
+            };
+        };
+        responses: {
+            /** @description Matches. */
+            200: {
+                headers: {
+                    "X-Served-From"?: "guest" | "disk";
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileSearchResult"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    filePatch: {
+        parameters: {
+            query?: never;
+            header?: {
+                "Idempotency-Key"?: string;
+                /** @description File-first workspaces only (ignored otherwise): the tree revision the call applies to, e.g. `7` or `"7"`. Another current revision fails the call with 409 conflict, details.reason tree_revision_mismatch, details.current_tree_revision. */
+                "If-Match"?: components["parameters"]["IfMatch"];
+            };
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["FilePatchRequest"];
+            };
+        };
+        responses: {
+            /** @description Patched and fsync'd. */
+            200: {
+                headers: {
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilePatchResult"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    fileMove: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description File-first workspaces only (ignored otherwise): the tree revision the call applies to, e.g. `7` or `"7"`. Another current revision fails the call with 409 conflict, details.reason tree_revision_mismatch, details.current_tree_revision. */
+                "If-Match"?: components["parameters"]["IfMatch"];
+            };
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
         requestBody: {
             content: {
                 "application/json": components["schemas"]["MoveRequest"];
@@ -1737,6 +2204,8 @@ export interface operations {
             /** @description Info of the destination. */
             200: {
                 headers: {
+                    /** @description File-first workspaces: the tree revision served or produced (contracts §29.2). */
+                    "X-Tree-Revision"?: number;
                     [name: string]: unknown;
                 };
                 content: {
@@ -1879,6 +2348,29 @@ export interface operations {
             default: components["responses"]["Error"];
         };
     };
+    workspaceWakeHint: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Hint accepted. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WakeHintResult"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
     workspaceKeepalive: {
         parameters: {
             query?: never;