@immediately-run/sandbox-protocol 0.3.1 → 0.4.0

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: 235f4011d391bd63
+// descriptorsHash: 4ce0c4b1d3f460e9
 //
 // 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' | 'compile' | 'debug-enabled' | 'debug-log' | 'debug-query' | 'debug-query-result' | 'diagnostics' | 'dnd-cancel' | 'dropped-item' | 'editor-context' | 'form-factor' | 'fs-change' | 'invitations' | 'launch-dismiss' | 'launch-ended' | 'llm-provider' | 'metadata-update' | 'mount-add' | 'mount-remove' | 'protocol-contribute' | 'protocol-dnd' | 'protocol-editor' | 'protocol-fetch' | 'protocol-ipc' | 'protocol-launch' | 'protocol-llm' | 'protocol-secrets' | 'protocol-settings' | 'protocol-spaces' | 'protocol-task' | 'protocol-theme' | 'protocol-vcs' | 'region-message' | 'request-api-catalog' | 'request-auth-state' | 'request-debug-enabled' | 'request-diagnostics' | 'request-editor-context' | 'request-form-factor' | 'request-handshake' | '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' | '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-contribute' | 'protocol-dnd' | 'protocol-editor' | 'protocol-fetch' | 'protocol-ipc' | 'protocol-launch' | 'protocol-llm' | 'protocol-secrets' | 'protocol-settings' | 'protocol-spaces' | 'protocol-task' | 'protocol-theme' | 'protocol-vcs' | 'region-message' | 'request-api-catalog' | 'request-auth-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';
 /** `api-catalog` — push · host->app. polled with `request-api-catalog`. */
 export declare const API_CATALOG = "api-catalog";
 /** Read off this message today: `methods`. */
@@ -63,6 +63,9 @@ export declare const FORM_FACTOR = "form-factor";
 /** `fs-change` — push · host->app. */
 export declare const FS_CHANGE = "fs-change";
 /** Read off this message today: `epoch`, `paths`. */
+/** `host-attention` — push · host->app. polled with `request-host-attention`. */
+export declare const HOST_ATTENTION = "host-attention";
+/** Read off this message today: `attention`. */
 /** `invitations` — push · host->app. polled with `request-invitations`. */
 export declare const INVITATIONS = "invitations";
 /** Read off this message today: `invites`. */
@@ -269,6 +272,8 @@ export declare const REQUEST_EDITOR_CONTEXT = "request-editor-context";
 export declare const REQUEST_FORM_FACTOR = "request-form-factor";
 /** `request-handshake` — message · host->app. */
 export declare const REQUEST_HANDSHAKE = "request-handshake";
+/** `request-host-attention` — poll · app->host. */
+export declare const REQUEST_HOST_ATTENTION = "request-host-attention";
 /** `request-invitations` — poll · app->host. */
 export declare const REQUEST_INVITATIONS = "request-invitations";
 /** `request-llm-provider` — poll · app->host. */
@@ -332,6 +337,7 @@ export declare const WIRE_NAMES: {
     readonly EDITOR_CONTEXT: "editor-context";
     readonly FORM_FACTOR: "form-factor";
     readonly FS_CHANGE: "fs-change";
+    readonly HOST_ATTENTION: "host-attention";
     readonly INVITATIONS: "invitations";
     readonly LAUNCH_DISMISS: "launch-dismiss";
     readonly LAUNCH_ENDED: "launch-ended";
@@ -360,6 +366,7 @@ export declare const WIRE_NAMES: {
     readonly REQUEST_EDITOR_CONTEXT: "request-editor-context";
     readonly REQUEST_FORM_FACTOR: "request-form-factor";
     readonly REQUEST_HANDSHAKE: "request-handshake";
+    readonly REQUEST_HOST_ATTENTION: "request-host-attention";
     readonly REQUEST_INVITATIONS: "request-invitations";
     readonly REQUEST_LLM_PROVIDER: "request-llm-provider";
     readonly REQUEST_MOUNTS: "request-mounts";

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: 235f4011d391bd63
+// descriptorsHash: 4ce0c4b1d3f460e9
 //
 // 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.SECRETS_METADATA = exports.SDK_HANDSHAKE = exports.REQUEST_VCS_STATE = exports.REQUEST_THEME = exports.REQUEST_SESSION_MOUNTS = exports.REQUEST_SECRETS_METADATA = exports.REQUEST_MOUNTS = exports.REQUEST_LLM_PROVIDER = exports.REQUEST_INVITATIONS = exports.REQUEST_HANDSHAKE = exports.REQUEST_FORM_FACTOR = exports.REQUEST_EDITOR_CONTEXT = exports.REQUEST_DIAGNOSTICS = exports.REQUEST_DEBUG_ENABLED = 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_LLM = exports.PROTOCOL_LAUNCH = exports.PROTOCOL_IPC = exports.PROTOCOL_FETCH = exports.PROTOCOL_EDITOR = exports.PROTOCOL_DND = exports.PROTOCOL_CONTRIBUTE = exports.MOUNT_REMOVE = exports.MOUNT_ADD = exports.METADATA_UPDATE = exports.LLM_PROVIDER = exports.LAUNCH_ENDED = exports.LAUNCH_DISMISS = exports.INVITATIONS = 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.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 = void 0;
+exports.REQUEST_VCS_STATE = exports.REQUEST_THEME = exports.REQUEST_SESSION_MOUNTS = exports.REQUEST_SECRETS_METADATA = exports.REQUEST_MOUNTS = 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_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_LLM = exports.PROTOCOL_LAUNCH = exports.PROTOCOL_IPC = exports.PROTOCOL_FETCH = exports.PROTOCOL_EDITOR = exports.PROTOCOL_DND = exports.PROTOCOL_CONTRIBUTE = 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.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 = void 0;
 /** `api-catalog` — push · host->app. polled with `request-api-catalog`. */
 exports.API_CATALOG = 'api-catalog';
 /** Read off this message today: `methods`. */
@@ -44,6 +44,9 @@ exports.FORM_FACTOR = 'form-factor';
 /** `fs-change` — push · host->app. */
 exports.FS_CHANGE = 'fs-change';
 /** Read off this message today: `epoch`, `paths`. */
+/** `host-attention` — push · host->app. polled with `request-host-attention`. */
+exports.HOST_ATTENTION = 'host-attention';
+/** Read off this message today: `attention`. */
 /** `invitations` — push · host->app. polled with `request-invitations`. */
 exports.INVITATIONS = 'invitations';
 /** Read off this message today: `invites`. */
@@ -104,6 +107,8 @@ exports.REQUEST_EDITOR_CONTEXT = 'request-editor-context';
 exports.REQUEST_FORM_FACTOR = 'request-form-factor';
 /** `request-handshake` — message · host->app. */
 exports.REQUEST_HANDSHAKE = 'request-handshake';
+/** `request-host-attention` — poll · app->host. */
+exports.REQUEST_HOST_ATTENTION = 'request-host-attention';
 /** `request-invitations` — poll · app->host. */
 exports.REQUEST_INVITATIONS = 'request-invitations';
 /** `request-llm-provider` — poll · app->host. */
@@ -155,6 +160,7 @@ exports.WIRE_NAMES = {
     EDITOR_CONTEXT: exports.EDITOR_CONTEXT,
     FORM_FACTOR: exports.FORM_FACTOR,
     FS_CHANGE: exports.FS_CHANGE,
+    HOST_ATTENTION: exports.HOST_ATTENTION,
     INVITATIONS: exports.INVITATIONS,
     LAUNCH_DISMISS: exports.LAUNCH_DISMISS,
     LAUNCH_ENDED: exports.LAUNCH_ENDED,
@@ -183,6 +189,7 @@ exports.WIRE_NAMES = {
     REQUEST_EDITOR_CONTEXT: exports.REQUEST_EDITOR_CONTEXT,
     REQUEST_FORM_FACTOR: exports.REQUEST_FORM_FACTOR,
     REQUEST_HANDSHAKE: exports.REQUEST_HANDSHAKE,
+    REQUEST_HOST_ATTENTION: exports.REQUEST_HOST_ATTENTION,
     REQUEST_INVITATIONS: exports.REQUEST_INVITATIONS,
     REQUEST_LLM_PROVIDER: exports.REQUEST_LLM_PROVIDER,
     REQUEST_MOUNTS: exports.REQUEST_MOUNTS,

package/package.json

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

@@ -503,6 +503,62 @@
         "src/onFsChange.ts"
       ]
     },
+    "host-attention": {
+      "kind": "push",
+      "direction": "host->app",
+      "poll": "request-host-attention",
+      "payload": {
+        "reads": [
+          "attention"
+        ]
+      },
+      "value": {
+        "fields": [
+          {
+            "name": "awaiting",
+            "optional": false,
+            "type": "boolean"
+          },
+          {
+            "name": "kind",
+            "optional": false,
+            "union": [
+              {
+                "type": "\"confirmation\""
+              },
+              {
+                "type": "\"consent\""
+              },
+              {
+                "type": "\"passkey\""
+              },
+              {
+                "type": "\"picker\""
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          {
+            "name": "since",
+            "optional": false,
+            "union": [
+              {
+                "type": "null"
+              },
+              {
+                "type": "number"
+              }
+            ]
+          }
+        ],
+        "type": "HostAttention"
+      },
+      "sites": [
+        "src/hostAttention.ts"
+      ]
+    },
     "invitations": {
       "kind": "push",
       "direction": "host->app",
@@ -1634,6 +1690,16 @@
         "src/runtime.ts"
       ]
     },
+    "request-host-attention": {
+      "kind": "poll",
+      "direction": "app->host",
+      "payload": {
+        "fields": []
+      },
+      "sites": [
+        "src/hostAttention.ts"
+      ]
+    },
     "request-invitations": {
       "kind": "poll",
       "direction": "app->host",