@immediately-run/sandbox-protocol 0.7.6 → 0.8.0

package/dist/sandbox.d.ts

@@ -140,7 +140,9 @@ export declare const SUCCESS = "success";
 /** `theme` — push · host->app. polled with `request-theme`. */
 export declare const THEME = "theme";
 export interface ThemePayload {
+    modeId: string;
     theme: "dark" | "light";
+    themeKey: string;
 }
 /** `vcs-state` — push · host->app. polled with `request-vcs-state`. */
 export declare const VCS_STATE = "vcs-state";

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: 5931b7d64869b9a2
+// descriptorsHash: d443b5ffbec18020
 //
 // 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-recents' | 'protocol-secrets' | 'protocol-settings' | 'protocol-spaces' | 'protocol-task' | 'protocol-theme' | 'protocol-vcs' | 'region-message' | '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-secrets-metadata' | 'request-session-mounts' | 'request-theme' | 'request-vcs-state' | 'sdk-handshake' | 'secrets-metadata' | 'session-mounts' | 'task-cancel' | 'task-complete' | 'task-input' | 'theme' | 'urlchange' | 'vcs-state';
+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-recents' | 'protocol-secrets' | 'protocol-settings' | 'protocol-spaces' | 'protocol-task' | 'protocol-theme' | 'protocol-vcs' | 'region-message' | '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-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';
 /** `api-catalog` — push · host->app. polled with `request-api-catalog`. */
 export declare const API_CATALOG = "api-catalog";
 /** Read off this message today: `methods`. */
@@ -275,7 +275,8 @@ export interface ProtocolTaskInvokeParams {
 export declare const PROTOCOL_THEME = "protocol-theme";
 /** Params of `protocol-theme` method `set`. */
 export interface ProtocolThemeSetParams {
-    theme: "dark" | "light";
+    mode?: string | undefined;
+    theme: string;
 }
 /** `protocol-vcs` — request · app->host. */
 export declare const PROTOCOL_VCS = "protocol-vcs";
@@ -315,8 +316,12 @@ export declare const REQUEST_SECRETS_METADATA = "request-secrets-metadata";
 export declare const REQUEST_SESSION_MOUNTS = "request-session-mounts";
 /** `request-theme` — poll · app->host. */
 export declare const REQUEST_THEME = "request-theme";
+/** `request-theme-catalog` — poll · app->host. */
+export declare const REQUEST_THEME_CATALOG = "request-theme-catalog";
 /** `request-vcs-state` — poll · app->host. */
 export declare const REQUEST_VCS_STATE = "request-vcs-state";
+/** `request-workspace` — poll · app->host. */
+export declare const REQUEST_WORKSPACE = "request-workspace";
 /** `sdk-handshake` — message · app->host. */
 export declare const SDK_HANDSHAKE = "sdk-handshake";
 export interface SdkHandshakePayload {
@@ -345,12 +350,18 @@ export interface TaskInputPayload {
 }
 /** `theme` — push · host->app. polled with `request-theme`. */
 export declare const THEME = "theme";
-/** Read off this message today: `theme`. */
+/** Read off this message today: `modeId`, `theme`, `themeKey`. */
+/** `theme-catalog` — push · host->app. polled with `request-theme-catalog`. */
+export declare const THEME_CATALOG = "theme-catalog";
+/** Read off this message today: `themes`. */
 /** `urlchange` — message · both. */
 export declare const URLCHANGE = "urlchange";
 /** `vcs-state` — push · host->app. polled with `request-vcs-state`. */
 export declare const VCS_STATE = "vcs-state";
 /** Read off this message today: `branch`, `changes`, `diffLoading`, `prs`. */
+/** `workspace` — push · host->app. polled with `request-workspace`. */
+export declare const WORKSPACE = "workspace";
+/** Read off this message today: `workspace`. */
 /** Every wire name this side speaks, keyed by its constant. */
 export declare const WIRE_NAMES: {
     readonly API_CATALOG: "api-catalog";
@@ -407,7 +418,9 @@ export declare const WIRE_NAMES: {
     readonly REQUEST_SECRETS_METADATA: "request-secrets-metadata";
     readonly REQUEST_SESSION_MOUNTS: "request-session-mounts";
     readonly REQUEST_THEME: "request-theme";
+    readonly REQUEST_THEME_CATALOG: "request-theme-catalog";
     readonly REQUEST_VCS_STATE: "request-vcs-state";
+    readonly REQUEST_WORKSPACE: "request-workspace";
     readonly SDK_HANDSHAKE: "sdk-handshake";
     readonly SECRETS_METADATA: "secrets-metadata";
     readonly SESSION_MOUNTS: "session-mounts";
@@ -415,6 +428,8 @@ export declare const WIRE_NAMES: {
     readonly TASK_COMPLETE: "task-complete";
     readonly TASK_INPUT: "task-input";
     readonly THEME: "theme";
+    readonly THEME_CATALOG: "theme-catalog";
     readonly URLCHANGE: "urlchange";
     readonly VCS_STATE: "vcs-state";
+    readonly WORKSPACE: "workspace";
 };

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: 5931b7d64869b9a2
+// descriptorsHash: d443b5ffbec18020
 //
 // 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
@@ -10,7 +10,7 @@
 // list in the doc comment instead (R3-274e is where those grow real types).
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.REQUEST_LLM_PROVIDER = exports.REQUEST_INVITATIONS = exports.REQUEST_HOST_ATTENTION = exports.REQUEST_HANDSHAKE = 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_MESSAGE = exports.PROTOCOL_VCS = exports.PROTOCOL_THEME = exports.PROTOCOL_TASK = exports.PROTOCOL_SPACES = exports.PROTOCOL_SETTINGS = exports.PROTOCOL_SECRETS = exports.PROTOCOL_RECENTS = 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.VCS_STATE = exports.URLCHANGE = exports.THEME = exports.TASK_INPUT = exports.TASK_COMPLETE = exports.TASK_CANCEL = exports.SESSION_MOUNTS = exports.SECRETS_METADATA = exports.SDK_HANDSHAKE = exports.REQUEST_VCS_STATE = exports.REQUEST_THEME = exports.REQUEST_SESSION_MOUNTS = exports.REQUEST_SECRETS_METADATA = exports.REQUEST_MOUNTS = 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_MOUNTS = void 0;
 /** `api-catalog` — push · host->app. polled with `request-api-catalog`. */
 exports.API_CATALOG = 'api-catalog';
 /** Read off this message today: `methods`. */
@@ -132,8 +132,12 @@ exports.REQUEST_SECRETS_METADATA = 'request-secrets-metadata';
 exports.REQUEST_SESSION_MOUNTS = 'request-session-mounts';
 /** `request-theme` — poll · app->host. */
 exports.REQUEST_THEME = 'request-theme';
+/** `request-theme-catalog` — poll · app->host. */
+exports.REQUEST_THEME_CATALOG = 'request-theme-catalog';
 /** `request-vcs-state` — poll · app->host. */
 exports.REQUEST_VCS_STATE = 'request-vcs-state';
+/** `request-workspace` — poll · app->host. */
+exports.REQUEST_WORKSPACE = 'request-workspace';
 /** `sdk-handshake` — message · app->host. */
 exports.SDK_HANDSHAKE = 'sdk-handshake';
 /** `secrets-metadata` — push · host->app. polled with `request-secrets-metadata`. */
@@ -150,12 +154,18 @@ exports.TASK_COMPLETE = 'task-complete';
 exports.TASK_INPUT = 'task-input';
 /** `theme` — push · host->app. polled with `request-theme`. */
 exports.THEME = 'theme';
-/** Read off this message today: `theme`. */
+/** Read off this message today: `modeId`, `theme`, `themeKey`. */
+/** `theme-catalog` — push · host->app. polled with `request-theme-catalog`. */
+exports.THEME_CATALOG = 'theme-catalog';
+/** Read off this message today: `themes`. */
 /** `urlchange` — message · both. */
 exports.URLCHANGE = 'urlchange';
 /** `vcs-state` — push · host->app. polled with `request-vcs-state`. */
 exports.VCS_STATE = 'vcs-state';
 /** Read off this message today: `branch`, `changes`, `diffLoading`, `prs`. */
+/** `workspace` — push · host->app. polled with `request-workspace`. */
+exports.WORKSPACE = 'workspace';
+/** Read off this message today: `workspace`. */
 /** Every wire name this side speaks, keyed by its constant. */
 exports.WIRE_NAMES = {
     API_CATALOG: exports.API_CATALOG,
@@ -212,7 +222,9 @@ exports.WIRE_NAMES = {
     REQUEST_SECRETS_METADATA: exports.REQUEST_SECRETS_METADATA,
     REQUEST_SESSION_MOUNTS: exports.REQUEST_SESSION_MOUNTS,
     REQUEST_THEME: exports.REQUEST_THEME,
+    REQUEST_THEME_CATALOG: exports.REQUEST_THEME_CATALOG,
     REQUEST_VCS_STATE: exports.REQUEST_VCS_STATE,
+    REQUEST_WORKSPACE: exports.REQUEST_WORKSPACE,
     SDK_HANDSHAKE: exports.SDK_HANDSHAKE,
     SECRETS_METADATA: exports.SECRETS_METADATA,
     SESSION_MOUNTS: exports.SESSION_MOUNTS,
@@ -220,6 +232,8 @@ exports.WIRE_NAMES = {
     TASK_COMPLETE: exports.TASK_COMPLETE,
     TASK_INPUT: exports.TASK_INPUT,
     THEME: exports.THEME,
+    THEME_CATALOG: exports.THEME_CATALOG,
     URLCHANGE: exports.URLCHANGE,
     VCS_STATE: exports.VCS_STATE,
+    WORKSPACE: exports.WORKSPACE,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immediately-run/sandbox-protocol",
-  "version": "0.7.6",
+  "version": "0.8.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/sandbox.json

@@ -667,6 +667,11 @@
       "poll": "request-theme",
       "payload": {
         "fields": [
+          {
+            "name": "modeId",
+            "optional": false,
+            "type": "string"
+          },
           {
             "name": "theme",
             "optional": false,
@@ -678,10 +683,17 @@
                 "type": "\"light\""
               }
             ]
+          },
+          {
+            "name": "themeKey",
+            "optional": false,
+            "type": "string"
           }
         ],
         "reads": [
-          "theme"
+          "modeId",
+          "theme",
+          "themeKey"
         ]
       },
       "sites": [

package/snapshots/sdk.json

@@ -1713,20 +1713,91 @@
         "set": {
           "payload": {
             "fields": [
+              {
+                "name": "mode",
+                "optional": true,
+                "union": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "undefined"
+                  }
+                ]
+              },
               {
                 "name": "theme",
                 "optional": false,
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "add-source": {
+          "payload": {
+            "fields": [
+              {
+                "name": "location",
+                "optional": false,
                 "union": [
                   {
-                    "type": "\"dark\""
+                    "fields": [
+                      {
+                        "name": "kind",
+                        "optional": false,
+                        "type": "\"repo\""
+                      },
+                      {
+                        "name": "path",
+                        "optional": false,
+                        "type": "string"
+                      },
+                      {
+                        "name": "ref",
+                        "optional": true,
+                        "type": "string | undefined"
+                      },
+                      {
+                        "name": "repo",
+                        "optional": false,
+                        "type": "string"
+                      }
+                    ]
                   },
                   {
-                    "type": "\"light\""
+                    "fields": [
+                      {
+                        "name": "kind",
+                        "optional": false,
+                        "type": "\"space\""
+                      },
+                      {
+                        "name": "path",
+                        "optional": false,
+                        "type": "string"
+                      },
+                      {
+                        "name": "spaceId",
+                        "optional": false,
+                        "type": "string"
+                      }
+                    ]
                   }
                 ]
               }
             ]
           }
+        },
+        "remove-source": {
+          "payload": {
+            "fields": [
+              {
+                "name": "themeKey",
+                "optional": false,
+                "type": "string"
+              }
+            ]
+          }
         }
       },
       "sites": [
@@ -1922,6 +1993,16 @@
         "src/theme.ts"
       ]
     },
+    "request-theme-catalog": {
+      "kind": "poll",
+      "direction": "app->host",
+      "payload": {
+        "fields": []
+      },
+      "sites": [
+        "src/theme.ts"
+      ]
+    },
     "request-vcs-state": {
       "kind": "poll",
       "direction": "app->host",
@@ -1932,6 +2013,16 @@
         "src/vcs.ts"
       ]
     },
+    "request-workspace": {
+      "kind": "poll",
+      "direction": "app->host",
+      "payload": {
+        "fields": []
+      },
+      "sites": [
+        "src/workspace.ts"
+      ]
+    },
     "sdk-handshake": {
       "kind": "message",
       "direction": "app->host",
@@ -2148,19 +2239,98 @@
       "poll": "request-theme",
       "payload": {
         "reads": [
-          "theme"
+          "modeId",
+          "theme",
+          "themeKey"
         ]
       },
       "value": {
-        "union": [
+        "fields": [
+          {
+            "name": "modeId",
+            "optional": false,
+            "type": "string"
+          },
           {
-            "type": "\"dark\""
+            "name": "theme",
+            "optional": false,
+            "union": [
+              {
+                "type": "\"dark\""
+              },
+              {
+                "type": "\"light\""
+              }
+            ]
           },
           {
-            "type": "\"light\""
+            "name": "themeKey",
+            "optional": false,
+            "type": "string"
+          }
+        ],
+        "type": "HostThemeSelection"
+      },
+      "sites": [
+        "src/theme.ts"
+      ]
+    },
+    "theme-catalog": {
+      "kind": "push",
+      "direction": "host->app",
+      "poll": "request-theme-catalog",
+      "payload": {
+        "reads": [
+          "themes"
+        ]
+      },
+      "value": {
+        "fields": [
+          {
+            "name": "themes",
+            "optional": false,
+            "array": {
+              "fields": [
+                {
+                  "name": "label",
+                  "optional": false,
+                  "type": "string"
+                },
+                {
+                  "name": "modes",
+                  "optional": false,
+                  "array": {
+                    "fields": [
+                      {
+                        "name": "id",
+                        "optional": false,
+                        "type": "string"
+                      },
+                      {
+                        "name": "polarity",
+                        "optional": false,
+                        "union": [
+                          {
+                            "type": "\"dark\""
+                          },
+                          {
+                            "type": "\"light\""
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                },
+                {
+                  "name": "themeKey",
+                  "optional": false,
+                  "type": "string"
+                }
+              ]
+            }
           }
         ],
-        "type": "HostTheme"
+        "type": "ThemeCatalog"
       },
       "sites": [
         "src/theme.ts"
@@ -2228,6 +2398,56 @@
       "sites": [
         "src/vcs.ts"
       ]
+    },
+    "workspace": {
+      "kind": "push",
+      "direction": "host->app",
+      "poll": "request-workspace",
+      "payload": {
+        "reads": [
+          "workspace"
+        ]
+      },
+      "value": {
+        "union": [
+          {
+            "fields": [
+              {
+                "name": "label",
+                "optional": false,
+                "type": "string"
+              },
+              {
+                "name": "namespace",
+                "optional": false,
+                "type": "string"
+              },
+              {
+                "name": "provider",
+                "optional": false,
+                "type": "string"
+              },
+              {
+                "name": "ref",
+                "optional": false,
+                "type": "string"
+              },
+              {
+                "name": "repository",
+                "optional": false,
+                "type": "string"
+              }
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "type": "Workspace | null"
+      },
+      "sites": [
+        "src/workspace.ts"
+      ]
     }
   },
   "dynamicFamilies": {