@immediately-run/sandbox-protocol 0.10.7 → 0.12.0

package/README.md

@@ -31,7 +31,7 @@ dependency bump.
 | `@immediately-run/sandbox-protocol` | the format version + the snapshot types. **No constants** — importing the root must not be a way to reach the other side's vocabulary |
 
 **Two modules, not a union.** The sides speak overlapping but different subsets — 34
-wire names in the frame, 73 in the SDK, 18 shared. 55 are SDK-only because the frame
+wire names in the frame, 76 in the SDK, 18 shared. 58 are SDK-only because the frame
 merely *relays* them and the host is the other end (the R3-274a cross-repo audit). Each
 repo's own gate asserts its module covers *exactly* its extracted wire surface, so a
 union module would fail there, far from its cause.

package/dist/index.js

@@ -12,7 +12,7 @@
 //                                               repo's own gate compares against
 //
 // The two sides speak overlapping but DIFFERENT subsets — 34 wire names in the frame,
-// 73 in the SDK, 18 shared; 55 are SDK-only because the frame merely relays them and
+// 76 in the SDK, 18 shared; 58 are SDK-only because the frame merely relays them and
 // the host is the other end. (These four counts are ASSERTED against the descriptors by
 // `test/protocol.test.ts` — they are shipped in `dist/index.d.ts`, so a reader downloads
 // them, and they had drifted to 57/39 because nothing checked.) Hence a module per side:

package/dist/sandbox.js

@@ -1,7 +1,7 @@
 "use strict";
 // GENERATED by scripts/generate.mjs — DO NOT EDIT.
 // Source of truth: src/descriptors.protocol.mjs (@immediately-run/sandbox-protocol)
-// descriptorsHash: 72be4ea435f3b318
+// descriptorsHash: ea023de202a49fbd
 //
 // The sandbox↔SDK wire vocabulary (PLATFORM_LAYERING_SPEC §2 / S1). Import the
 // constants instead of writing the string: a rename then has ONE edit site and

package/dist/sdk.d.ts

@@ -1,5 +1,5 @@
 /** Every wire name this side speaks, as a union. */
-export type WireName = 'api-catalog' | 'auth-state' | 'chrome-state' | 'compile' | 'debug-enabled' | 'debug-log' | 'debug-query' | 'debug-query-result' | 'diagnostics' | 'dnd-cancel' | 'dropped-item' | 'editor-context' | 'form-factor' | 'fs-change' | 'host-attention' | 'invitations' | 'launch-dismiss' | 'launch-ended' | 'llm-provider' | 'metadata-update' | 'mount-add' | 'mount-remove' | 'protocol-analytics' | 'protocol-contribute' | 'protocol-dnd' | 'protocol-editor' | 'protocol-feed' | 'protocol-fetch' | 'protocol-ipc' | 'protocol-launch' | 'protocol-llm' | 'protocol-localstore' | 'protocol-openlink' | 'protocol-openrepo' | 'protocol-recents' | 'protocol-secrets' | 'protocol-settings' | 'protocol-spaces' | 'protocol-task' | 'protocol-theme' | 'protocol-vcs' | 'region-message' | 'region-visibility' | 'request-api-catalog' | 'request-auth-state' | 'request-chrome-state' | 'request-debug-enabled' | 'request-diagnostics' | 'request-editor-context' | 'request-form-factor' | 'request-handshake' | 'request-host-attention' | 'request-invitations' | 'request-llm-provider' | 'request-mounts' | 'request-region-visibility' | 'request-secrets-metadata' | 'request-session-mounts' | 'request-theme' | 'request-theme-catalog' | 'request-vcs-state' | 'request-workspace' | 'sdk-handshake' | 'secrets-metadata' | 'session-mounts' | 'task-cancel' | 'task-complete' | 'task-input' | 'theme' | 'theme-catalog' | 'urlchange' | 'vcs-state' | 'workspace';
+export type WireName = 'api-catalog' | 'auth-state' | 'chrome-state' | 'compile' | 'debug-enabled' | 'debug-log' | 'debug-query' | 'debug-query-result' | 'diagnostics' | 'dnd-cancel' | 'dropped-item' | 'editor-context' | 'form-factor' | 'fs-change' | 'host-attention' | 'invitations' | 'launch-dismiss' | 'launch-ended' | 'llm-provider' | 'metadata-update' | 'mount-add' | 'mount-remove' | 'protocol-analytics' | 'protocol-contribute' | 'protocol-dnd' | 'protocol-editor' | 'protocol-feed' | 'protocol-fetch' | 'protocol-ipc' | 'protocol-launch' | 'protocol-llm' | 'protocol-localstore' | 'protocol-openlink' | 'protocol-openrepo' | 'protocol-recents' | 'protocol-secrets' | 'protocol-settings' | 'protocol-spaces' | 'protocol-spaces-mode' | 'protocol-task' | 'protocol-theme' | 'protocol-vcs' | 'region-message' | 'region-visibility' | 'request-api-catalog' | 'request-auth-state' | 'request-chrome-state' | 'request-debug-enabled' | 'request-diagnostics' | 'request-editor-context' | 'request-form-factor' | 'request-handshake' | 'request-host-attention' | 'request-invitations' | 'request-llm-provider' | 'request-mounts' | 'request-region-visibility' | 'request-secrets-metadata' | 'request-session-mounts' | 'request-spaces-mode' | 'request-theme' | 'request-theme-catalog' | 'request-vcs-state' | 'request-workspace' | 'sdk-handshake' | 'secrets-metadata' | 'session-mounts' | 'spaces-mode' | 'task-cancel' | 'task-complete' | 'task-input' | 'theme' | 'theme-catalog' | 'urlchange' | 'vcs-state' | 'workspace';
 /** `api-catalog` — push · host->app. polled with `request-api-catalog`. */
 export declare const API_CATALOG = "api-catalog";
 /** Read off this message today: `methods`. */
@@ -254,16 +254,31 @@ export declare const PROTOCOL_SPACES = "protocol-spaces";
 export interface ProtocolSpacesAcceptInviteParams {
     spaceId: string;
 }
+/** Params of `protocol-spaces` method `convertToShared`. */
+export interface ProtocolSpacesConvertToSharedParams {
+    confirm: boolean;
+    spaceId: string;
+}
 /** Params of `protocol-spaces` method `declineInvite`. */
 export interface ProtocolSpacesDeclineInviteParams {
     spaceId: string;
 }
+/** Params of `protocol-spaces` method `delete`. */
+export interface ProtocolSpacesDeleteParams {
+    confirm: boolean;
+    spaceId: string;
+}
 /** Params of `protocol-spaces` method `invite`. */
 export interface ProtocolSpacesInviteParams {
     login: string;
     role: "owner" | "reader" | "writer";
     spaceId: string;
 }
+/** Params of `protocol-spaces` method `leave`. */
+export interface ProtocolSpacesLeaveParams {
+    confirm: boolean;
+    spaceId: string;
+}
 /** Params of `protocol-spaces` method `list`. */
 export interface ProtocolSpacesListParams {
     app?: false | true | undefined;
@@ -280,6 +295,16 @@ export interface ProtocolSpacesMembersParams {
 export interface ProtocolSpacesPendingInvitesParams {
     spaceId: string;
 }
+/** Params of `protocol-spaces` method `rename`. */
+export interface ProtocolSpacesRenameParams {
+    name: string;
+    spaceId: string;
+}
+/** Params of `protocol-spaces` method `restore`. */
+export interface ProtocolSpacesRestoreParams {
+    confirm: boolean;
+    spaceId: string;
+}
 /** Params of `protocol-spaces` method `revokeGrant`. */
 export interface ProtocolSpacesRevokeGrantParams {
     appKey: string;
@@ -301,6 +326,8 @@ export interface ProtocolSpacesUnshareParams {
     spaceId: string;
     uid: string;
 }
+/** `protocol-spaces-mode` — request · app->host. */
+export declare const PROTOCOL_SPACES_MODE = "protocol-spaces-mode";
 /** `protocol-task` — request · app->host. */
 export declare const PROTOCOL_TASK = "protocol-task";
 /** Params of `protocol-task` method `invoke`. */
@@ -356,6 +383,8 @@ export declare const REQUEST_REGION_VISIBILITY = "request-region-visibility";
 export declare const REQUEST_SECRETS_METADATA = "request-secrets-metadata";
 /** `request-session-mounts` — poll · app->host. */
 export declare const REQUEST_SESSION_MOUNTS = "request-session-mounts";
+/** `request-spaces-mode` — poll · app->host. */
+export declare const REQUEST_SPACES_MODE = "request-spaces-mode";
 /** `request-theme` — poll · app->host. */
 export declare const REQUEST_THEME = "request-theme";
 /** `request-theme-catalog` — poll · app->host. */
@@ -377,6 +406,9 @@ export declare const SECRETS_METADATA = "secrets-metadata";
 /** `session-mounts` — push · host->app. polled with `request-session-mounts`. */
 export declare const SESSION_MOUNTS = "session-mounts";
 /** Read off this message today: `mounts`. */
+/** `spaces-mode` — push · host->app. polled with `request-spaces-mode`. */
+export declare const SPACES_MODE = "spaces-mode";
+/** Read off this message today: `state`. */
 /** `task-cancel` — message · app->host. */
 export declare const TASK_CANCEL = "task-cancel";
 /** `task-complete` — message · app->host. */
@@ -444,6 +476,7 @@ export declare const WIRE_NAMES: {
     readonly PROTOCOL_SECRETS: "protocol-secrets";
     readonly PROTOCOL_SETTINGS: "protocol-settings";
     readonly PROTOCOL_SPACES: "protocol-spaces";
+    readonly PROTOCOL_SPACES_MODE: "protocol-spaces-mode";
     readonly PROTOCOL_TASK: "protocol-task";
     readonly PROTOCOL_THEME: "protocol-theme";
     readonly PROTOCOL_VCS: "protocol-vcs";
@@ -464,6 +497,7 @@ export declare const WIRE_NAMES: {
     readonly REQUEST_REGION_VISIBILITY: "request-region-visibility";
     readonly REQUEST_SECRETS_METADATA: "request-secrets-metadata";
     readonly REQUEST_SESSION_MOUNTS: "request-session-mounts";
+    readonly REQUEST_SPACES_MODE: "request-spaces-mode";
     readonly REQUEST_THEME: "request-theme";
     readonly REQUEST_THEME_CATALOG: "request-theme-catalog";
     readonly REQUEST_VCS_STATE: "request-vcs-state";
@@ -471,6 +505,7 @@ export declare const WIRE_NAMES: {
     readonly SDK_HANDSHAKE: "sdk-handshake";
     readonly SECRETS_METADATA: "secrets-metadata";
     readonly SESSION_MOUNTS: "session-mounts";
+    readonly SPACES_MODE: "spaces-mode";
     readonly TASK_CANCEL: "task-cancel";
     readonly TASK_COMPLETE: "task-complete";
     readonly TASK_INPUT: "task-input";

package/dist/sdk.js

@@ -1,7 +1,7 @@
 "use strict";
 // GENERATED by scripts/generate.mjs — DO NOT EDIT.
 // Source of truth: src/descriptors.protocol.mjs (@immediately-run/sandbox-protocol)
-// descriptorsHash: 72be4ea435f3b318
+// descriptorsHash: ea023de202a49fbd
 //
 // The sandbox↔SDK wire vocabulary (PLATFORM_LAYERING_SPEC §2 / S1). Import the
 // constants instead of writing the string: a rename then has ONE edit site and
@@ -9,8 +9,8 @@
 // that has a declared shape; a name handled as `any` today gets its read field
 // list in the doc comment instead (R3-274e is where those grow real types).
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REQUEST_FORM_FACTOR = exports.REQUEST_EDITOR_CONTEXT = exports.REQUEST_DIAGNOSTICS = exports.REQUEST_DEBUG_ENABLED = exports.REQUEST_CHROME_STATE = exports.REQUEST_AUTH_STATE = exports.REQUEST_API_CATALOG = exports.REGION_VISIBILITY = exports.REGION_MESSAGE = exports.PROTOCOL_VCS = exports.PROTOCOL_THEME = exports.PROTOCOL_TASK = exports.PROTOCOL_SPACES = exports.PROTOCOL_SETTINGS = exports.PROTOCOL_SECRETS = exports.PROTOCOL_RECENTS = exports.PROTOCOL_OPENREPO = exports.PROTOCOL_OPENLINK = exports.PROTOCOL_LOCALSTORE = exports.PROTOCOL_LLM = exports.PROTOCOL_LAUNCH = exports.PROTOCOL_IPC = exports.PROTOCOL_FETCH = exports.PROTOCOL_FEED = exports.PROTOCOL_EDITOR = exports.PROTOCOL_DND = exports.PROTOCOL_CONTRIBUTE = exports.PROTOCOL_ANALYTICS = exports.MOUNT_REMOVE = exports.MOUNT_ADD = exports.METADATA_UPDATE = exports.LLM_PROVIDER = exports.LAUNCH_ENDED = exports.LAUNCH_DISMISS = exports.INVITATIONS = exports.HOST_ATTENTION = exports.FS_CHANGE = exports.FORM_FACTOR = exports.EDITOR_CONTEXT = exports.DROPPED_ITEM = exports.DND_CANCEL = exports.DIAGNOSTICS = exports.DEBUG_QUERY_RESULT = exports.DEBUG_QUERY = exports.DEBUG_LOG = exports.DEBUG_ENABLED = exports.COMPILE = exports.CHROME_STATE = exports.AUTH_STATE = exports.API_CATALOG = void 0;
-exports.WIRE_NAMES = exports.WORKSPACE = exports.VCS_STATE = exports.URLCHANGE = exports.THEME_CATALOG = exports.THEME = exports.TASK_INPUT = exports.TASK_COMPLETE = exports.TASK_CANCEL = exports.SESSION_MOUNTS = exports.SECRETS_METADATA = exports.SDK_HANDSHAKE = exports.REQUEST_WORKSPACE = exports.REQUEST_VCS_STATE = exports.REQUEST_THEME_CATALOG = exports.REQUEST_THEME = exports.REQUEST_SESSION_MOUNTS = exports.REQUEST_SECRETS_METADATA = exports.REQUEST_REGION_VISIBILITY = exports.REQUEST_MOUNTS = exports.REQUEST_LLM_PROVIDER = exports.REQUEST_INVITATIONS = exports.REQUEST_HOST_ATTENTION = exports.REQUEST_HANDSHAKE = void 0;
+exports.REQUEST_EDITOR_CONTEXT = exports.REQUEST_DIAGNOSTICS = exports.REQUEST_DEBUG_ENABLED = exports.REQUEST_CHROME_STATE = exports.REQUEST_AUTH_STATE = exports.REQUEST_API_CATALOG = exports.REGION_VISIBILITY = exports.REGION_MESSAGE = exports.PROTOCOL_VCS = exports.PROTOCOL_THEME = exports.PROTOCOL_TASK = exports.PROTOCOL_SPACES_MODE = exports.PROTOCOL_SPACES = exports.PROTOCOL_SETTINGS = exports.PROTOCOL_SECRETS = exports.PROTOCOL_RECENTS = exports.PROTOCOL_OPENREPO = exports.PROTOCOL_OPENLINK = exports.PROTOCOL_LOCALSTORE = exports.PROTOCOL_LLM = exports.PROTOCOL_LAUNCH = exports.PROTOCOL_IPC = exports.PROTOCOL_FETCH = exports.PROTOCOL_FEED = exports.PROTOCOL_EDITOR = exports.PROTOCOL_DND = exports.PROTOCOL_CONTRIBUTE = exports.PROTOCOL_ANALYTICS = exports.MOUNT_REMOVE = exports.MOUNT_ADD = exports.METADATA_UPDATE = exports.LLM_PROVIDER = exports.LAUNCH_ENDED = exports.LAUNCH_DISMISS = exports.INVITATIONS = exports.HOST_ATTENTION = exports.FS_CHANGE = exports.FORM_FACTOR = exports.EDITOR_CONTEXT = exports.DROPPED_ITEM = exports.DND_CANCEL = exports.DIAGNOSTICS = exports.DEBUG_QUERY_RESULT = exports.DEBUG_QUERY = exports.DEBUG_LOG = exports.DEBUG_ENABLED = exports.COMPILE = exports.CHROME_STATE = exports.AUTH_STATE = exports.API_CATALOG = void 0;
+exports.WIRE_NAMES = exports.WORKSPACE = exports.VCS_STATE = exports.URLCHANGE = exports.THEME_CATALOG = exports.THEME = exports.TASK_INPUT = exports.TASK_COMPLETE = exports.TASK_CANCEL = exports.SPACES_MODE = exports.SESSION_MOUNTS = exports.SECRETS_METADATA = exports.SDK_HANDSHAKE = exports.REQUEST_WORKSPACE = exports.REQUEST_VCS_STATE = exports.REQUEST_THEME_CATALOG = exports.REQUEST_THEME = exports.REQUEST_SPACES_MODE = exports.REQUEST_SESSION_MOUNTS = exports.REQUEST_SECRETS_METADATA = exports.REQUEST_REGION_VISIBILITY = exports.REQUEST_MOUNTS = exports.REQUEST_LLM_PROVIDER = exports.REQUEST_INVITATIONS = exports.REQUEST_HOST_ATTENTION = exports.REQUEST_HANDSHAKE = exports.REQUEST_FORM_FACTOR = void 0;
 /** `api-catalog` — push · host->app. polled with `request-api-catalog`. */
 exports.API_CATALOG = 'api-catalog';
 /** Read off this message today: `methods`. */
@@ -100,6 +100,8 @@ exports.PROTOCOL_SECRETS = 'protocol-secrets';
 exports.PROTOCOL_SETTINGS = 'protocol-settings';
 /** `protocol-spaces` — request · app->host. */
 exports.PROTOCOL_SPACES = 'protocol-spaces';
+/** `protocol-spaces-mode` — request · app->host. */
+exports.PROTOCOL_SPACES_MODE = 'protocol-spaces-mode';
 /** `protocol-task` — request · app->host. */
 exports.PROTOCOL_TASK = 'protocol-task';
 /** `protocol-theme` — request · app->host. */
@@ -141,6 +143,8 @@ exports.REQUEST_REGION_VISIBILITY = 'request-region-visibility';
 exports.REQUEST_SECRETS_METADATA = 'request-secrets-metadata';
 /** `request-session-mounts` — poll · app->host. */
 exports.REQUEST_SESSION_MOUNTS = 'request-session-mounts';
+/** `request-spaces-mode` — poll · app->host. */
+exports.REQUEST_SPACES_MODE = 'request-spaces-mode';
 /** `request-theme` — poll · app->host. */
 exports.REQUEST_THEME = 'request-theme';
 /** `request-theme-catalog` — poll · app->host. */
@@ -157,6 +161,9 @@ exports.SECRETS_METADATA = 'secrets-metadata';
 /** `session-mounts` — push · host->app. polled with `request-session-mounts`. */
 exports.SESSION_MOUNTS = 'session-mounts';
 /** Read off this message today: `mounts`. */
+/** `spaces-mode` — push · host->app. polled with `request-spaces-mode`. */
+exports.SPACES_MODE = 'spaces-mode';
+/** Read off this message today: `state`. */
 /** `task-cancel` — message · app->host. */
 exports.TASK_CANCEL = 'task-cancel';
 /** `task-complete` — message · app->host. */
@@ -217,6 +224,7 @@ exports.WIRE_NAMES = {
     PROTOCOL_SECRETS: exports.PROTOCOL_SECRETS,
     PROTOCOL_SETTINGS: exports.PROTOCOL_SETTINGS,
     PROTOCOL_SPACES: exports.PROTOCOL_SPACES,
+    PROTOCOL_SPACES_MODE: exports.PROTOCOL_SPACES_MODE,
     PROTOCOL_TASK: exports.PROTOCOL_TASK,
     PROTOCOL_THEME: exports.PROTOCOL_THEME,
     PROTOCOL_VCS: exports.PROTOCOL_VCS,
@@ -237,6 +245,7 @@ exports.WIRE_NAMES = {
     REQUEST_REGION_VISIBILITY: exports.REQUEST_REGION_VISIBILITY,
     REQUEST_SECRETS_METADATA: exports.REQUEST_SECRETS_METADATA,
     REQUEST_SESSION_MOUNTS: exports.REQUEST_SESSION_MOUNTS,
+    REQUEST_SPACES_MODE: exports.REQUEST_SPACES_MODE,
     REQUEST_THEME: exports.REQUEST_THEME,
     REQUEST_THEME_CATALOG: exports.REQUEST_THEME_CATALOG,
     REQUEST_VCS_STATE: exports.REQUEST_VCS_STATE,
@@ -244,6 +253,7 @@ exports.WIRE_NAMES = {
     SDK_HANDSHAKE: exports.SDK_HANDSHAKE,
     SECRETS_METADATA: exports.SECRETS_METADATA,
     SESSION_MOUNTS: exports.SESSION_MOUNTS,
+    SPACES_MODE: exports.SPACES_MODE,
     TASK_CANCEL: exports.TASK_CANCEL,
     TASK_COMPLETE: exports.TASK_COMPLETE,
     TASK_INPUT: exports.TASK_INPUT,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immediately-run/sandbox-protocol",
-  "version": "0.10.7",
+  "version": "0.12.0",
   "description": "The sandbox<->SDK wire protocol: ONE descriptor set, projected into the wire-name constants, the payload types, and the per-side snapshots both repos gate against (PLATFORM_LAYERING_SPEC S1). Consumed by sandbox and immediately-run-sdk so a wire change is a version bump, not a hand-copied file.",
   "license": "UNLICENSED",
   "repository": {

package/snapshots/sdk.json

@@ -1647,6 +1647,22 @@
             ]
           }
         },
+        "convertToShared": {
+          "payload": {
+            "fields": [
+              {
+                "name": "confirm",
+                "optional": false,
+                "type": "boolean"
+              },
+              {
+                "name": "spaceId",
+                "optional": false,
+                "type": "string"
+              }
+            ]
+          }
+        },
         "declineInvite": {
           "payload": {
             "fields": [
@@ -1658,6 +1674,22 @@
             ]
           }
         },
+        "delete": {
+          "payload": {
+            "fields": [
+              {
+                "name": "confirm",
+                "optional": false,
+                "type": "boolean"
+              },
+              {
+                "name": "spaceId",
+                "optional": false,
+                "type": "string"
+              }
+            ]
+          }
+        },
         "grants": {
           "payload": {
             "type": "{}"
@@ -1694,6 +1726,22 @@
             ]
           }
         },
+        "leave": {
+          "payload": {
+            "fields": [
+              {
+                "name": "confirm",
+                "optional": false,
+                "type": "boolean"
+              },
+              {
+                "name": "spaceId",
+                "optional": false,
+                "type": "string"
+              }
+            ]
+          }
+        },
         "list": {
           "payload": {
             "fields": [
@@ -1758,6 +1806,38 @@
             ]
           }
         },
+        "rename": {
+          "payload": {
+            "fields": [
+              {
+                "name": "name",
+                "optional": false,
+                "type": "string"
+              },
+              {
+                "name": "spaceId",
+                "optional": false,
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "restore": {
+          "payload": {
+            "fields": [
+              {
+                "name": "confirm",
+                "optional": false,
+                "type": "boolean"
+              },
+              {
+                "name": "spaceId",
+                "optional": false,
+                "type": "string"
+              }
+            ]
+          }
+        },
         "revokeGrant": {
           "payload": {
             "fields": [
@@ -1843,6 +1923,112 @@
         "src/mounts.ts"
       ]
     },
+    "protocol-spaces-mode": {
+      "kind": "request",
+      "direction": "app->host",
+      "methods": {
+        "navigate": {
+          "payload": {
+            "union": [
+              {
+                "fields": [
+                  {
+                    "name": "activity",
+                    "optional": false,
+                    "union": [
+                      {
+                        "type": "\"inbox\""
+                      },
+                      {
+                        "type": "\"people\""
+                      },
+                      {
+                        "type": "\"settings\""
+                      },
+                      {
+                        "type": "\"spaces\""
+                      }
+                    ]
+                  },
+                  {
+                    "name": "member",
+                    "optional": true,
+                    "union": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "undefined"
+                      }
+                    ]
+                  },
+                  {
+                    "name": "path",
+                    "optional": true,
+                    "union": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "undefined"
+                      }
+                    ]
+                  },
+                  {
+                    "name": "roomId",
+                    "optional": true,
+                    "union": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "undefined"
+                      }
+                    ]
+                  },
+                  {
+                    "name": "section",
+                    "optional": true,
+                    "union": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "undefined"
+                      }
+                    ]
+                  },
+                  {
+                    "name": "spaceId",
+                    "optional": false,
+                    "union": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "type": "string"
+                      }
+                    ]
+                  }
+                ]
+              },
+              {
+                "fields": [
+                  {
+                    "name": "destination",
+                    "optional": false,
+                    "type": "\"notifications\""
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      },
+      "sites": [
+        "src/spacesMode.ts"
+      ]
+    },
     "protocol-task": {
       "kind": "request",
       "direction": "app->host",
@@ -2171,6 +2357,16 @@
         "src/mounts.ts"
       ]
     },
+    "request-spaces-mode": {
+      "kind": "poll",
+      "direction": "app->host",
+      "payload": {
+        "fields": []
+      },
+      "sites": [
+        "src/spacesMode.ts"
+      ]
+    },
     "request-theme": {
       "kind": "poll",
       "direction": "app->host",
@@ -2368,6 +2564,41 @@
         "src/mounts.ts"
       ]
     },
+    "spaces-mode": {
+      "kind": "push",
+      "direction": "host->app",
+      "poll": "request-spaces-mode",
+      "payload": {
+        "reads": [
+          "state"
+        ]
+      },
+      "value": {
+        "union": [
+          {
+            "fields": [
+              {
+                "name": "route",
+                "optional": false,
+                "type": "SpacesRoute"
+              },
+              {
+                "name": "space",
+                "optional": false,
+                "type": "SpacesModeSpace | null"
+              }
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "type": "SpacesModeState | null"
+      },
+      "sites": [
+        "src/spacesMode.ts"
+      ]
+    },
     "task-cancel": {
       "kind": "message",
       "direction": "app->host",
@@ -2625,6 +2856,7 @@
         "secrets",
         "settings",
         "spaces",
+        "spaces-mode",
         "task",
         "theme",
         "vcs"