@cubos/agent-sdk 0.0.1141710 → 0.0.1142284

package/dist/generated/schema.d.ts

@@ -5176,6 +5176,431 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/tenants/{tenantSlug}/conversations/{id}/filesystem/dir": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a filesystem directory
+         * @description Lists one directory of the conversation's virtual filesystem — a single level, never recursive. The filesystem is a content-addressed tree projected from the event log; every file mutation is a browsable snapshot. Pass `at_seq` to view the tree as it stood at a given event (the latest snapshot at or before it), which reaches history the agent can no longer see. Without `at_seq` you get the live tree — exactly what the agent would be shown on its next turn, so it comes back empty once the filesystem has expired after enough idle turns, which is also the tree a write would start from. `path` defaults to the root `/`. An empty list with null `root_event_id` means no files exist there.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Event seq to anchor the snapshot at; omit for the current tree. */
+                    at_seq?: number;
+                    /** @description Directory to list; defaults to `/`. */
+                    path?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Conversation id. */
+                    id: string;
+                    /** @description Tenant slug. */
+                    tenantSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["FilesystemDirResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/tenants/{tenantSlug}/conversations/{id}/filesystem/file": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Download a filesystem file
+         * @description Streams the bytes of one file from the conversation's virtual filesystem as an attachment. Pass `at_seq` to download the file as it stood at a given event, which reaches history the agent can no longer see; without it you read the live tree, which 404s once the filesystem has expired after enough idle turns. `Content-Type` is the stored mime (inferred from the extension for entries that predate it); the `Content-Disposition` filename is the entry name.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Event seq to anchor the snapshot at; omit for the current tree. */
+                    at_seq?: number;
+                    /** @description Absolute path of the file to download. */
+                    path: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Conversation id. */
+                    id: string;
+                    /** @description Tenant slug. */
+                    tenantSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The file bytes as an attachment */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        /**
+         * Create or replace a filesystem file
+         * @description Writes one file into the conversation's filesystem, creating parent directories and overwriting whatever was at `path`. The body is `multipart/form-data` with a single `file` part. Starts no turn: the agent is told about the change as part of its next request, so send a message or a steer if you want an answer now. 409 when the conversation's agent has `feature_filesystem` off; 413 when the file or the resulting tree is over the size cap.
+         */
+        put: {
+            parameters: {
+                query: {
+                    /** @description Absolute path to write, e.g. `/notes/todo.md`. */
+                    path: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Conversation id. */
+                    id: string;
+                    /** @description Tenant slug. */
+                    tenantSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["FilesystemMutationResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                413: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        post?: never;
+        /**
+         * Delete a filesystem file or directory
+         * @description Removes `path` from the conversation's filesystem. A directory is removed with everything under it. History is untouched — earlier snapshots still resolve via `at_seq`. Starts no turn; the agent is told on its next request.
+         */
+        delete: {
+            parameters: {
+                query: {
+                    /** @description Absolute path to remove. */
+                    path: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Conversation id. */
+                    id: string;
+                    /** @description Tenant slug. */
+                    tenantSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["FilesystemMutationResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/tenants/{tenantSlug}/conversations/{id}/filesystem/files": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Write several filesystem files at once
+         * @description Writes up to 50 files as a single snapshot. The body is `multipart/form-data` with repeated `file` parts and positional `path` parts (the i-th `path` names the i-th file; an empty string falls back to `/<filename>`). One `filesystem_root` event is appended for the whole batch, so the agent sees the upload as one change rather than as N — which also means it is all-or-nothing to the reader: there is no moment at which half the files exist. Starts no turn.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Conversation id. */
+                    id: string;
+                    /** @description Tenant slug. */
+                    tenantSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["FilesystemMutationResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                413: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/tenants/{tenantSlug}/conversations/{id}/filesystem/move": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Move or rename a filesystem entry
+         * @description Re-parents `from` to `to`, creating destination directories. Works for files and directories alike (a directory moves with its subtree, since the entry carries it). Starts no turn; the agent is told on its next request.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Conversation id. */
+                    id: string;
+                    /** @description Tenant slug. */
+                    tenantSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["FilesystemMoveRequest"];
+                };
+            };
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["FilesystemMutationResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/tenants/{tenantSlug}/conversations/{id}/knowledge-bases": {
         parameters: {
             query?: never;
@@ -5915,8 +6340,9 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List a workspace directory
-         * @description Lists one directory of the conversation's virtual workspace — a single level, never recursive. The workspace is a content-addressed tree projected from the event log; every file mutation is a browsable snapshot. Pass `at_seq` to view the tree as it stood at a given event (the latest snapshot at or before it), which reaches history the agent can no longer see. Without `at_seq` you get the live tree — exactly what the agent would be shown on its next turn, so it comes back empty once the workspace has expired after enough idle turns, which is also the tree a write would start from. `path` defaults to the root `/`. An empty list with null `root_event_id` means no files exist there.
+         * List a filesystem directory (deprecated path)
+         * @deprecated
+         * @description Deprecated alias of `…/filesystem/dir`, kept for callers written before the workspace → filesystem rename. Identical behaviour.
          */
         get: {
             parameters: {
@@ -5942,7 +6368,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["WorkspaceDirResponse"];
+                        "application/json": components["schemas"]["FilesystemDirResponse"];
                     };
                 };
                 400: {
@@ -5987,15 +6413,16 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Download a workspace file
-         * @description Streams the bytes of one file from the conversation's virtual workspace as an attachment. Pass `at_seq` to download the file as it stood at a given event, which reaches history the agent can no longer see; without it you read the live tree, which 404s once the workspace has expired after enough idle turns. `Content-Type` is the stored mime (inferred from the extension for entries that predate it); the `Content-Disposition` filename is the entry name.
+         * Download a filesystem file (deprecated path)
+         * @deprecated
+         * @description Deprecated alias of `…/filesystem/file`, kept for callers written before the workspace → filesystem rename. Identical behaviour.
          */
         get: {
             parameters: {
                 query: {
                     /** @description Event seq to anchor the snapshot at; omit for the current tree. */
                     at_seq?: number;
-                    /** @description Absolute path of the file to download. */
+                    /** @description Absolute path of the file. */
                     path: string;
                 };
                 header?: never;
@@ -6009,7 +6436,6 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description The file bytes as an attachment */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6043,13 +6469,14 @@ export interface paths {
             };
         };
         /**
-         * Create or replace a workspace file
-         * @description Writes one file into the conversation's workspace, creating parent directories and overwriting whatever was at `path`. The body is `multipart/form-data` with a single `file` part. Starts no turn: the agent is told about the change as part of its next request, so send a message or a steer if you want an answer now. 409 when the conversation's agent has `feature_workspace` off; 413 when the file or the resulting tree is over the size cap.
+         * Create or replace a file (deprecated path)
+         * @deprecated
+         * @description Deprecated alias of `…/filesystem/file`, kept for callers written before the workspace → filesystem rename. Identical behaviour.
          */
         put: {
             parameters: {
                 query: {
-                    /** @description Absolute path to write, e.g. `/notes/todo.md`. */
+                    /** @description Absolute path to write to. */
                     path: string;
                 };
                 header?: never;
@@ -6068,7 +6495,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["WorkspaceMutationResponse"];
+                        "application/json": components["schemas"]["FilesystemMutationResponse"];
                     };
                 };
                 400: {
@@ -6111,8 +6538,9 @@ export interface paths {
         };
         post?: never;
         /**
-         * Delete a workspace file or directory
-         * @description Removes `path` from the conversation's workspace. A directory is removed with everything under it. History is untouched — earlier snapshots still resolve via `at_seq`. Starts no turn; the agent is told on its next request.
+         * Delete a file (deprecated path)
+         * @deprecated
+         * @description Deprecated alias of `…/filesystem/file`, kept for callers written before the workspace → filesystem rename. Identical behaviour.
          */
         delete: {
             parameters: {
@@ -6136,7 +6564,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["WorkspaceMutationResponse"];
+                        "application/json": components["schemas"]["FilesystemMutationResponse"];
                     };
                 };
                 400: {
@@ -6186,8 +6614,9 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Write several workspace files at once
-         * @description Writes up to 50 files as a single snapshot. The body is `multipart/form-data` with repeated `file` parts and positional `path` parts (the i-th `path` names the i-th file; an empty string falls back to `/<filename>`). One `workspace_root` event is appended for the whole batch, so the agent sees the upload as one change rather than as N — which also means it is all-or-nothing to the reader: there is no moment at which half the files exist. Starts no turn.
+         * Upload several files at once (deprecated path)
+         * @deprecated
+         * @description Deprecated alias of `…/filesystem/files`, kept for callers written before the workspace → filesystem rename. Identical behaviour.
          */
         post: {
             parameters: {
@@ -6208,7 +6637,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["WorkspaceMutationResponse"];
+                        "application/json": components["schemas"]["FilesystemMutationResponse"];
                     };
                 };
                 400: {
@@ -6265,8 +6694,9 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Move or rename a workspace entry
-         * @description Re-parents `from` to `to`, creating destination directories. Works for files and directories alike (a directory moves with its subtree, since the entry carries it). Starts no turn; the agent is told on its next request.
+         * Move or rename a file (deprecated path)
+         * @deprecated
+         * @description Deprecated alias of `…/filesystem/move`, kept for callers written before the workspace → filesystem rename. Identical behaviour.
          */
         post: {
             parameters: {
@@ -6282,7 +6712,7 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["WorkspaceMoveRequest"];
+                    "application/json": components["schemas"]["FilesystemMoveRequest"];
                 };
             };
             responses: {
@@ -6291,7 +6721,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["WorkspaceMutationResponse"];
+                        "application/json": components["schemas"]["FilesystemMutationResponse"];
                     };
                 };
                 400: {
@@ -10719,6 +11149,12 @@ export interface components {
              */
             error_fallback_message: string | null;
             feature_code_execution: boolean;
+            /**
+             * @description Exposes the per-conversation filesystem — `write_file` / `read_file` /
+             *     `list_files` / `move_file` / `delete_file` plus `webfetch` save-to-disk — backed
+             *     by a content-addressed tree. Off by default.
+             */
+            feature_filesystem: boolean;
             /**
              * @description Enables a secondary chat model that reviews consequential actions before dispatch.
              *     Off by default; inactive unless `guardrail_model` resolves.
@@ -10746,11 +11182,21 @@ export interface components {
             feature_user_notes: boolean;
             feature_web_search: boolean;
             /**
-             * @description Exposes the per-conversation file workspace — `write_file` / `read_file` /
-             *     `list_files` / `move_file` / `delete_file` plus `webfetch` save-to-disk — backed
-             *     by an ephemeral, content-addressed tree. Off by default.
+             * @deprecated
+             * @description Deprecated alias of `feature_filesystem`, kept so a client written before the
+             *     workspace → filesystem rename keeps reading the field it knows. Always mirrors
+             *     it; on write, the new field accepts this name too.
              */
-            feature_workspace: boolean;
+            feature_workspace?: boolean;
+            /**
+             * Format: int32
+             * @description Turns without a file touch after which the conversation's filesystem expires
+             *     from the agent's view — history stays browsable, but the agent sees an empty
+             *     tree and the next write starts a fresh one. `null` ≡ never expires, which is
+             *     the default: expiry is opt-in. Bounds 1..=1000. Ignored while
+             *     `feature_filesystem` is off.
+             */
+            filesystem_ttl_turns: number | null;
             guardrail_model: null | components["schemas"]["AiProviderModel"];
             /** @description Optional operator policy appended to the fixed guardrail verifier wrapper. */
             guardrail_prompt: string | null;
@@ -10797,6 +11243,13 @@ export interface components {
             updated_at: string;
             vision_model: null | components["schemas"]["AiProviderModel"];
             websearch_model: null | components["schemas"]["AiProviderModel"];
+            /**
+             * Format: int32
+             * @deprecated
+             * @description Deprecated alias of `filesystem_ttl_turns`. Same mirroring as
+             *     `feature_workspace`.
+             */
+            workspace_ttl_turns: number | null;
         };
         AgentListItem: {
             /** @description The chat model's provider, embedded in full (as the providers list returns it). */
@@ -10810,6 +11263,7 @@ export interface components {
             description: string;
             display_name: string;
             feature_code_execution: boolean;
+            feature_filesystem: boolean;
             feature_guardrail: boolean;
             feature_structured_memory: boolean;
             feature_subagent: boolean;
@@ -10817,7 +11271,6 @@ export interface components {
             feature_task_planning: boolean;
             feature_user_notes: boolean;
             feature_web_search: boolean;
-            feature_workspace: boolean;
             /** Format: uuid */
             id: string;
             /**
@@ -11558,6 +12011,8 @@ export interface components {
             /** @description Channel-facing message on terminal turn failure. Omit/NULL ⇒ built-in default. */
             error_fallback_message?: string | null;
             feature_code_execution?: boolean | null;
+            /** @description Also accepted as `feature_workspace`, the name it had before the rename. */
+            feature_filesystem?: boolean | null;
             feature_guardrail?: boolean | null;
             feature_proactive_memory?: boolean | null;
             feature_structured_memory?: boolean | null;
@@ -11565,7 +12020,13 @@ export interface components {
             feature_task_planning?: boolean | null;
             feature_user_notes?: boolean | null;
             feature_web_search?: boolean | null;
-            feature_workspace?: boolean | null;
+            /**
+             * Format: int32
+             * @description Turns without a file touch after which the filesystem expires from the agent's
+             *     view. Omit/NULL ⇒ never expires. Bounds: 1..=1000. Also accepted as
+             *     `workspace_ttl_turns`.
+             */
+            filesystem_ttl_turns?: number | null;
             /**
              * Format: uuid
              * @description Provider catalog row id (`provider_models.id`) for the guardrail verifier's backing chat
@@ -11973,13 +12434,13 @@ export interface components {
             enabled_skill_slugs?: string[];
             enabled_trigger_slugs?: string[];
             feature_code_execution: boolean;
+            feature_filesystem?: boolean;
             feature_proactive_memory: boolean;
             feature_structured_memory: boolean;
             feature_subagent?: boolean;
             feature_task_planning: boolean;
             feature_user_notes: boolean;
             feature_web_search: boolean;
-            feature_workspace?: boolean;
             identity_md?: string | null;
             /**
              * Format: uuid
@@ -12009,7 +12470,7 @@ export interface components {
             tags: string[];
         };
         /** @enum {string} */
-        EventType: "user_message" | "task_prompt" | "agent_directive" | "agent_message" | "agent_file" | "llm_call" | "tool_result" | "turn_done" | "todo_update" | "memory_lookup" | "media_transcription" | "sub_conversation_started" | "sub_conversation_finished" | "eval_subcall_request" | "eval_subcall_result" | "compaction_done" | "workspace_root" | "harness_error" | "guardrail_verdict" | "client_tool_call" | "title_generated" | "context_update";
+        EventType: "user_message" | "task_prompt" | "agent_directive" | "agent_message" | "agent_file" | "llm_call" | "tool_result" | "turn_done" | "todo_update" | "memory_lookup" | "media_transcription" | "sub_conversation_started" | "sub_conversation_finished" | "eval_subcall_request" | "eval_subcall_result" | "compaction_done" | "filesystem_root" | "harness_error" | "guardrail_verdict" | "client_tool_call" | "title_generated" | "context_update";
         ExternalChannel: {
             agent: components["schemas"]["AgentRef"];
             connection_secret_hint: string;
@@ -12025,6 +12486,52 @@ export interface components {
             slug: string;
             user_onboarding_mode: string;
         };
+        FilesystemDirResponse: {
+            entries: components["schemas"]["FilesystemEntryDto"][];
+            path: string;
+            /**
+             * Format: uuid
+             * @description Snapshot event the listing came from; null when the conversation has
+             *     no files (never wrote any, or none at/before `at_seq`).
+             */
+            root_event_id: string | null;
+            /** Format: int64 */
+            root_seq: number | null;
+        };
+        FilesystemEntryDto: {
+            exec: boolean;
+            /** @description One of `file`, `dir`, `symlink`. */
+            kind: string;
+            /**
+             * @description Detected content type. Empty for directories, symlinks, and files
+             *     written before entries carried it.
+             */
+            mime: string;
+            name: string;
+            /**
+             * @description Content hash: the file's bytes, or a directory's subtree. Doubles as a
+             *     cache key — the same hash is the same content, tenant-wide.
+             */
+            sha256: string | null;
+            /** Format: int64 */
+            size: number;
+            symlink_target: string | null;
+        };
+        FilesystemMoveRequest: {
+            /** @description Absolute source path. */
+            from: string;
+            /** @description Absolute destination path. */
+            to: string;
+        };
+        FilesystemMutationResponse: {
+            /** @description Paths touched, in the order they were applied. */
+            paths: string[];
+            /**
+             * Format: uuid
+             * @description The `filesystem_root` event this mutation appended — the new snapshot.
+             */
+            root_event_id: string | null;
+        };
         /**
          * @description Abnormal stop reason. Absent on the happy path; callers distinguish text vs tool calls by
          *     inspecting `messages`.
@@ -12064,7 +12571,7 @@ export interface components {
             /**
              * @description Slug of the agent that curates this base's wiki, or null when nothing
              *     curates it. Any agent of the tenant works — the harness forces the
-             *     workspace on for the run regardless of the agent's own feature flag.
+             *     filesystem on for the run regardless of the agent's own feature flag.
              */
             nap_agent_slug: string | null;
             /** Format: date-time */
@@ -13010,6 +13517,8 @@ export interface components {
              */
             error_fallback_message?: string | null;
             feature_code_execution?: boolean | null;
+            /** @description Also accepted as `feature_workspace`, the name it had before the rename. */
+            feature_filesystem?: boolean | null;
             feature_guardrail?: boolean | null;
             feature_proactive_memory?: boolean | null;
             feature_structured_memory?: boolean | null;
@@ -13017,7 +13526,13 @@ export interface components {
             feature_task_planning?: boolean | null;
             feature_user_notes?: boolean | null;
             feature_web_search?: boolean | null;
-            feature_workspace?: boolean | null;
+            /**
+             * Format: int32
+             * @description Tri-state: absent → leave alone; `null` → never expires; number → expire after
+             *     that many untouched turns. Bounds: 1..=1000. Also accepted as
+             *     `workspace_ttl_turns`.
+             */
+            filesystem_ttl_turns?: number | null;
             /**
              * Format: uuid
              * @description Tri-state: absent → leave alone; `null` → clear FK; UUID → set.
@@ -13509,52 +14024,6 @@ export interface components {
              */
             user_id: string | null;
         };
-        WorkspaceDirResponse: {
-            entries: components["schemas"]["WorkspaceEntryDto"][];
-            path: string;
-            /**
-             * Format: uuid
-             * @description Snapshot event the listing came from; null when the conversation has
-             *     no files (never wrote any, or none at/before `at_seq`).
-             */
-            root_event_id: string | null;
-            /** Format: int64 */
-            root_seq: number | null;
-        };
-        WorkspaceEntryDto: {
-            exec: boolean;
-            /** @description One of `file`, `dir`, `symlink`. */
-            kind: string;
-            /**
-             * @description Detected content type. Empty for directories, symlinks, and files
-             *     written before entries carried it.
-             */
-            mime: string;
-            name: string;
-            /**
-             * @description Content hash: the file's bytes, or a directory's subtree. Doubles as a
-             *     cache key — the same hash is the same content, tenant-wide.
-             */
-            sha256: string | null;
-            /** Format: int64 */
-            size: number;
-            symlink_target: string | null;
-        };
-        WorkspaceMoveRequest: {
-            /** @description Absolute source path. */
-            from: string;
-            /** @description Absolute destination path. */
-            to: string;
-        };
-        WorkspaceMutationResponse: {
-            /** @description Paths touched, in the order they were applied. */
-            paths: string[];
-            /**
-             * Format: uuid
-             * @description The `workspace_root` event this mutation appended — the new snapshot.
-             */
-            root_event_id: string | null;
-        };
     };
     responses: never;
     parameters: never;