@openchamber/sdk 2.1.1 → 2.3.0

package/dist/protocol.d.ts

@@ -92,6 +92,48 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
     }, z.core.$strip>;
     channel: z.ZodLiteral<"openchamber.sdk">;
     v: z.ZodLiteral<1>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"shells">;
+    payload: z.ZodObject<{
+        subscriptionId: z.ZodString;
+        snapshot: z.ZodObject<{
+            kind: z.ZodLiteral<"shells">;
+            scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"session">;
+                sessionId: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"project">;
+                projectId: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"global">;
+            }, z.core.$strict>], "kind">;
+            shells: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                sessionID: z.ZodString;
+                command: z.ZodString;
+                startedAt: z.ZodNumber;
+                background: z.ZodBoolean;
+            }, z.core.$strict>>;
+            ended: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                sessionID: z.ZodString;
+                command: z.ZodString;
+                startedAt: z.ZodNumber;
+                background: z.ZodBoolean;
+                status: z.ZodEnum<{
+                    exited: "exited";
+                    timeout: "timeout";
+                    killed: "killed";
+                    stopped: "stopped";
+                    unknown: "unknown";
+                }>;
+                exit: z.ZodOptional<z.ZodNumber>;
+                endedAt: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strip>;
+    channel: z.ZodLiteral<"openchamber.sdk">;
+    v: z.ZodLiteral<1>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"ready">;
     payload: z.ZodObject<{
@@ -459,7 +501,13 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
                 data: z.ZodOptional<z.ZodJSONSchema>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
-    }, z.core.$strip>], "kind">, z.ZodUnion<readonly [z.ZodObject<{
+    }, z.core.$strip>], "kind">, z.ZodObject<{
+        output: z.ZodString;
+        cursor: z.ZodNumber;
+        skipped: z.ZodBoolean;
+    }, z.core.$strip>, z.ZodObject<{
+        stopped: z.ZodLiteral<true>;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
         sessionId: z.ZodString;
         sent: z.ZodEnum<{
             failed: "failed";
@@ -511,9 +559,9 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
         }>;
     }, z.core.$strip>, z.ZodObject<{
         status: z.ZodEnum<{
+            stopped: "stopped";
             ready: "ready";
             failed: "failed";
-            stopped: "stopped";
             starting: "starting";
         }>;
     }, z.core.$strip>, z.ZodObject<{
@@ -641,7 +689,7 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
     } | {
         sent: "failed" | "sent" | "no-model" | "skipped";
     } | {
-        status: "ready" | "failed" | "stopped" | "starting";
+        status: "stopped" | "ready" | "failed" | "starting";
     } | {
         content: string;
     } | {
@@ -657,6 +705,12 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
         mtime: number;
     } | {
         text: string;
+    } | {
+        output: string;
+        cursor: number;
+        skipped: boolean;
+    } | {
+        stopped: true;
     };
     error?: undefined;
     code?: undefined;
@@ -676,7 +730,7 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
     id: string;
     ok: false;
     error: string;
-    code: "HOST_UNAVAILABLE" | "HOST_TIMEOUT" | "HOST_REJECTED" | "DISCONNECTED" | "DISABLED" | "BAD_PATH" | "NO_INTEGRATION" | "NO_SERVICE" | "SERVICE_FAILED" | "NO_SESSION" | "SESSION_BUSY" | "NOT_GRANTED" | "NO_DIRECTORY" | "NOT_FOUND" | "FILE_TOO_LARGE" | "DENIED" | "NO_MODEL" | "MODEL_FAILED" | "UNSUPPORTED";
+    code: "HOST_UNAVAILABLE" | "HOST_TIMEOUT" | "HOST_REJECTED" | "DISCONNECTED" | "DISABLED" | "BAD_PATH" | "NO_INTEGRATION" | "NO_SERVICE" | "SERVICE_FAILED" | "REQUEST_FAILED" | "RESPONSE_TOO_LARGE" | "NO_SESSION" | "SESSION_BUSY" | "NOT_GRANTED" | "NO_DIRECTORY" | "NOT_FOUND" | "FILE_TOO_LARGE" | "DENIED" | "NO_MODEL" | "MODEL_FAILED" | "UNSUPPORTED";
     payload?: undefined;
 }, {
     type: "result";
@@ -778,7 +832,7 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
     } | {
         sent: "failed" | "sent" | "no-model" | "skipped";
     } | {
-        status: "ready" | "failed" | "stopped" | "starting";
+        status: "stopped" | "ready" | "failed" | "starting";
     } | {
         content: string;
     } | {
@@ -794,6 +848,12 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
         mtime: number;
     } | {
         text: string;
+    } | {
+        output: string;
+        cursor: number;
+        skipped: boolean;
+    } | {
+        stopped: true;
     } | undefined;
 }>>, z.ZodObject<{
     type: z.ZodLiteral<"action">;
@@ -915,6 +975,49 @@ export declare const guestMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
     channel: z.ZodLiteral<"openchamber.sdk">;
     v: z.ZodLiteral<1>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"shells-subscribe">;
+    id: z.ZodString;
+    payload: z.ZodObject<{
+        subscriptionId: z.ZodString;
+        scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"session">;
+            sessionId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"project">;
+            projectId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"global">;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>;
+    channel: z.ZodLiteral<"openchamber.sdk">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"shells-unsubscribe">;
+    id: z.ZodString;
+    payload: z.ZodObject<{
+        subscriptionId: z.ZodString;
+    }, z.core.$strict>;
+    channel: z.ZodLiteral<"openchamber.sdk">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"shell-output">;
+    id: z.ZodString;
+    payload: z.ZodObject<{
+        shellId: z.ZodString;
+        cursor: z.ZodOptional<z.ZodNumber>;
+        tailBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    channel: z.ZodLiteral<"openchamber.sdk">;
+    v: z.ZodLiteral<1>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"shell-stop">;
+    id: z.ZodString;
+    payload: z.ZodObject<{
+        shellId: z.ZodString;
+    }, z.core.$strict>;
+    channel: z.ZodLiteral<"openchamber.sdk">;
+    v: z.ZodLiteral<1>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"storage">;
     id: z.ZodString;

package/dist/protocol.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { guestSessionWorktreeSchema, guestStorageRequestSchema, guestStorageResultSchema, guestWorkspaceQuerySchema, guestWorkspaceSnapshotSchema } from "./workspace-schemas.js";
 import { guestStatusControlEventSchema, guestStatusControlsSchema } from "./status-control-schemas.js";
 import { guestPopoverClosedEventSchema, guestPopoverDataSchema, guestPopoverRequestSchema } from "./popover-schemas.js";
+import { GUEST_SHELL_END_STATUSES, GUEST_SHELL_ID_MAX, GUEST_SHELLS_MAX, GUEST_SHELL_OUTPUT_TAIL_MAX } from "./shells.js";
 import { OPENCHAMBER_SDK_API_VERSION, OPENCHAMBER_SDK_CHANNEL } from "./api-version.js";
 import { SERVICE_STATUS_VALUES, ATTACH_PROVIDER_ID, GUEST_ACCOUNT_MAX, GUEST_ATTACH_AUTHOR_MAX, GUEST_BADGE_MAX, GUEST_FRAME_HEIGHT_MAX, GUEST_COMMIT_SHA, GUEST_ITEM_MESSAGE_TEXT_MAX, GUEST_ITEM_SESSION_MAX, GUEST_RESOLVE_ERROR_MAX, GUEST_ATTACH_BRANCH_MAX, GUEST_ATTACH_DATA_MAX, GUEST_ATTACH_ID_MAX, GUEST_ATTACH_TEXT_MAX, GUEST_ATTACH_TITLE_MAX, GUEST_ATTACH_URL_MAX, GUEST_CLIPBOARD_TEXT_MAX, GUEST_COMPOSE_TEXT_MAX, GUEST_FILE_CONTENT_MAX, GUEST_FILE_ENTRY_KINDS, GUEST_FILE_LIST_MAX, GUEST_GENERATE_OUTPUT_TOKENS_MAX, GUEST_GENERATE_PROMPT_MAX, GUEST_GENERATE_SYSTEM_MAX, GUEST_GENERATE_TEXT_MAX, GUEST_FILE_PATH_MAX, GUEST_FILE_STAT_KINDS, GUEST_REQUEST_BODY_MAX, GUEST_REQUEST_PATH_MAX, GUEST_REQUEST_RESPONSE_MAX, GUEST_SESSION_AGENT_MAX, GUEST_SESSION_MODEL_MAX, GUEST_SETTING_VALUE_MAX, GUEST_TOAST_MAX, SESSION_LIFECYCLE_PHASES, SETTING_KEY, START_SESSION_SENT, isGuestFilePath, isGuestRequestPath, resolveHostRequestErrorCode, } from "./contract.js";
 import { GUEST_FILE_EDITOR_CONTENT_MAX, GUEST_FILE_EDITOR_VERSION_MAX } from "./file-editor.js";
@@ -98,9 +99,19 @@ const fileStatResultPayloadSchema = z.object({
 const generateResultPayloadSchema = z.object({
     text: z.string().max(GUEST_GENERATE_TEXT_MAX),
 });
+const shellOutputResultPayloadSchema = z.object({
+    output: z.string(),
+    cursor: z.number(),
+    skipped: z.boolean(),
+});
+const shellStopResultPayloadSchema = z.object({
+    stopped: z.literal(true),
+});
 const hostResultPayloadSchema = z.union([
     guestStorageResultSchema,
     guestWorkspaceSnapshotSchema,
+    shellOutputResultPayloadSchema,
+    shellStopResultPayloadSchema,
     startSessionResultPayloadSchema,
     requestResultPayloadSchema,
     promptResultPayloadSchema,
@@ -214,8 +225,36 @@ const hostResultSchema = z.object({
         code: resolveHostRequestErrorCode(message.code),
     };
 });
+const guestRunningShellSchema = z.object({
+    id: z.string().min(1).max(GUEST_SHELL_ID_MAX),
+    sessionID: z.string().min(1).max(1024),
+    command: z.string(),
+    startedAt: z.number().nonnegative(),
+    background: z.boolean(),
+}).strict();
+const guestEndedShellSchema = guestRunningShellSchema.extend({
+    status: z.enum(GUEST_SHELL_END_STATUSES),
+    exit: z.number().int().optional(),
+    endedAt: z.number().nonnegative(),
+}).strict();
+const guestShellsScopeSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('session'), sessionId: z.string().min(1).max(1024) }).strict(),
+    z.object({ kind: z.literal('project'), projectId: z.string().min(1).max(1024) }).strict(),
+    z.object({ kind: z.literal('global') }).strict(),
+]);
+const guestRunningShellsSnapshotSchema = z.object({
+    kind: z.literal('shells'),
+    scope: guestShellsScopeSchema,
+    shells: z.array(guestRunningShellSchema).max(GUEST_SHELLS_MAX),
+    ended: z.array(guestEndedShellSchema).max(GUEST_SHELLS_MAX),
+}).strict();
 export const hostMessageSchema = z.union([
     z.object({ ...envelope, type: z.literal('workspace'), payload: z.object({ subscriptionId: z.string().min(1).max(128), snapshot: guestWorkspaceSnapshotSchema }) }),
+    z.object({
+        ...envelope,
+        type: z.literal('shells'),
+        payload: z.object({ subscriptionId: z.string().min(1).max(128), snapshot: guestRunningShellsSnapshotSchema }),
+    }),
     z.object({
         ...envelope,
         type: z.literal('ready'),
@@ -332,6 +371,10 @@ export const guestMessageSchema = z.discriminatedUnion('type', [
     z.object({ ...envelope, type: z.literal('workspace-read'), id: z.string().min(1), payload: guestWorkspaceQuerySchema }),
     z.object({ ...envelope, type: z.literal('workspace-subscribe'), id: z.string().min(1), payload: z.object({ subscriptionId: z.string().min(1).max(128), query: guestWorkspaceQuerySchema }) }),
     z.object({ ...envelope, type: z.literal('workspace-unsubscribe'), id: z.string().min(1), payload: z.object({ subscriptionId: z.string().min(1).max(128) }) }),
+    z.object({ ...envelope, type: z.literal('shells-subscribe'), id: z.string().min(1), payload: z.object({ subscriptionId: z.string().min(1).max(128), scope: guestShellsScopeSchema }).strict() }),
+    z.object({ ...envelope, type: z.literal('shells-unsubscribe'), id: z.string().min(1), payload: z.object({ subscriptionId: z.string().min(1).max(128) }).strict() }),
+    z.object({ ...envelope, type: z.literal('shell-output'), id: z.string().min(1), payload: z.object({ shellId: z.string().min(1).max(GUEST_SHELL_ID_MAX), cursor: z.number().int().nonnegative().optional(), tailBytes: z.number().int().positive().max(GUEST_SHELL_OUTPUT_TAIL_MAX).optional() }).strict() }),
+    z.object({ ...envelope, type: z.literal('shell-stop'), id: z.string().min(1), payload: z.object({ shellId: z.string().min(1).max(GUEST_SHELL_ID_MAX) }).strict() }),
     z.object({ ...envelope, type: z.literal('storage'), id: z.string().min(1), payload: guestStorageRequestSchema }),
     z.object({
         ...envelope,

package/dist/scrollbar-style.d.ts

@@ -1,4 +1,4 @@
-export declare const GUEST_SCROLLBAR_CSS = "\n:root {\n  --oc-scrollbar-thumb: color-mix(in srgb, var(--oc-muted, currentColor) 40%, transparent);\n  --oc-scrollbar-thumb-hover: color-mix(in srgb, var(--oc-muted, currentColor) 65%, transparent);\n  scrollbar-gutter: stable;\n}\n* {\n  scrollbar-width: thin;\n  scrollbar-color: transparent transparent;\n}\n:hover, [data-oc-scrolling] {\n  scrollbar-color: var(--oc-scrollbar-thumb) transparent;\n}\n/* Chromium's standard scrollbar properties otherwise override its pseudo-elements. */\n@supports selector(::-webkit-scrollbar) {\n  *, :hover, [data-oc-scrolling] { scrollbar-width: auto; scrollbar-color: auto; }\n  ::-webkit-scrollbar { width: 6px; height: 6px; background: transparent; }\n  ::-webkit-scrollbar-track { background: transparent; }\n  ::-webkit-scrollbar-thumb {\n    background: transparent;\n    border-radius: 999px;\n    min-width: 24px;\n    min-height: 24px;\n  }\n  :hover::-webkit-scrollbar-thumb, [data-oc-scrolling]::-webkit-scrollbar-thumb { background: var(--oc-scrollbar-thumb); }\n  ::-webkit-scrollbar-thumb:hover { background: var(--oc-scrollbar-thumb-hover); }\n  ::-webkit-scrollbar-corner { background: transparent; }\n  ::-webkit-scrollbar-button { display: none; width: 0; height: 0; }\n}\n@media (forced-colors: active) {\n  *, :hover, [data-oc-scrolling] { scrollbar-color: auto; }\n  ::-webkit-scrollbar-thumb, ::-webkit-scrollbar-thumb:hover { background: CanvasText; }\n}\n";
+export declare const GUEST_SCROLLBAR_CSS = "\n:root {\n  /* Quiet at rest like the app's own thumbs; hover gives a clear grab target. */\n  --oc-scrollbar-thumb: color-mix(in srgb, var(--oc-muted, currentColor) 18%, transparent);\n  --oc-scrollbar-thumb-hover: color-mix(in srgb, var(--oc-muted, currentColor) 36%, transparent);\n  scrollbar-gutter: stable;\n}\n* {\n  scrollbar-width: thin;\n  scrollbar-color: transparent transparent;\n}\n:hover, [data-oc-scrolling] {\n  scrollbar-color: var(--oc-scrollbar-thumb) transparent;\n}\n/* Chromium's standard scrollbar properties otherwise override its pseudo-elements. */\n@supports selector(::-webkit-scrollbar) {\n  *, :hover, [data-oc-scrolling] { scrollbar-width: auto; scrollbar-color: auto; }\n  ::-webkit-scrollbar { width: 6px; height: 6px; background: transparent; }\n  ::-webkit-scrollbar-track { background: transparent; }\n  ::-webkit-scrollbar-thumb {\n    background: transparent;\n    border-radius: 999px;\n    min-width: 24px;\n    min-height: 24px;\n  }\n  :hover::-webkit-scrollbar-thumb, [data-oc-scrolling]::-webkit-scrollbar-thumb { background: var(--oc-scrollbar-thumb); }\n  ::-webkit-scrollbar-thumb:hover { background: var(--oc-scrollbar-thumb-hover); }\n  ::-webkit-scrollbar-corner { background: transparent; }\n  ::-webkit-scrollbar-button { display: none; width: 0; height: 0; }\n}\n@media (forced-colors: active) {\n  *, :hover, [data-oc-scrolling] { scrollbar-color: auto; }\n  ::-webkit-scrollbar-thumb, ::-webkit-scrollbar-thumb:hover { background: CanvasText; }\n}\n";
 /**
  * Marks whichever element scrolls (the root for document scrolling) with
  * `GUEST_SCROLLING_ATTRIBUTE` and clears it once scrolling has been quiet for

package/dist/scrollbar-style.js

@@ -14,8 +14,9 @@
 const GUEST_SCROLLING_ATTRIBUTE = 'data-oc-scrolling';
 export const GUEST_SCROLLBAR_CSS = `
 :root {
-  --oc-scrollbar-thumb: color-mix(in srgb, var(--oc-muted, currentColor) 40%, transparent);
-  --oc-scrollbar-thumb-hover: color-mix(in srgb, var(--oc-muted, currentColor) 65%, transparent);
+  /* Quiet at rest like the app's own thumbs; hover gives a clear grab target. */
+  --oc-scrollbar-thumb: color-mix(in srgb, var(--oc-muted, currentColor) 18%, transparent);
+  --oc-scrollbar-thumb-hover: color-mix(in srgb, var(--oc-muted, currentColor) 36%, transparent);
   scrollbar-gutter: stable;
 }
 * {

package/dist/shells.d.ts

@@ -0,0 +1,69 @@
+export declare const GUEST_SHELL_ID_MAX = 128;
+export declare const GUEST_SHELLS_MAX = 200;
+export declare const GUEST_SHELL_OUTPUT_TAIL_MAX = 65536;
+/** A shell command still running on behalf of a session. */
+export type GuestRunningShell = {
+    id: string;
+    sessionID: string;
+    command: string;
+    startedAt: number;
+    /** True for a job the turn does not wait for; false while the turn that ran it is blocked on it. */
+    background: boolean;
+};
+export declare const GUEST_SHELL_END_STATUSES: readonly ["exited", "timeout", "killed", "stopped", "unknown"];
+/**
+ * How a shell command ended: `exited` on its own (see `exit`), `timeout`,
+ * `killed` by a signal, `stopped` by a user (Stop, or aborting the turn that
+ * waited on it), or `unknown` when
+ * OpenChamber missed the end (a reconnect) and only saw the command gone.
+ */
+export type GuestShellEndStatus = (typeof GUEST_SHELL_END_STATUSES)[number];
+/** A shell command OpenChamber saw running that has since ended. */
+export type GuestEndedShell = GuestRunningShell & {
+    status: GuestShellEndStatus;
+    /** Exit code, when the command exited and OpenCode reported one. */
+    exit?: number;
+    endedAt: number;
+};
+/**
+ * Which running shells a subscription covers: one session and its subagents,
+ * every session of a registered project, or every session the app sees.
+ */
+export type GuestShellsScope = {
+    kind: 'session';
+    sessionId: string;
+} | {
+    kind: 'project';
+    projectId: string;
+} | {
+    kind: 'global';
+};
+export type GuestRunningShellsSnapshot = {
+    kind: 'shells';
+    /** Echo of the scope the subscription asked for. */
+    scope: GuestShellsScope;
+    shells: GuestRunningShell[];
+    /**
+     * Commands in scope that ended since OpenChamber started watching, oldest
+     * end first. Kept in memory only: empty after an app reload or runtime
+     * switch, and capped at `GUEST_SHELLS_MAX`, newest kept.
+     */
+    ended: GuestEndedShell[];
+};
+export type GuestShellsSubscription = {
+    subscriptionId: string;
+    scope: GuestShellsScope;
+};
+export type GuestShellOutputRequest = {
+    shellId: string;
+    cursor?: number;
+    tailBytes?: number;
+};
+export type GuestShellOutputResult = {
+    output: string;
+    cursor: number;
+    skipped: boolean;
+};
+export type GuestShellStopResult = {
+    stopped: true;
+};

package/dist/shells.js

@@ -0,0 +1,4 @@
+export const GUEST_SHELL_ID_MAX = 128;
+export const GUEST_SHELLS_MAX = 200;
+export const GUEST_SHELL_OUTPUT_TAIL_MAX = 65536;
+export const GUEST_SHELL_END_STATUSES = ['exited', 'timeout', 'killed', 'stopped', 'unknown'];

package/dist/ui/index.d.ts

@@ -1,5 +1,6 @@
 export { applyHostReady, applyHostTheme } from './theme.ts';
 export type { ThemeRoot } from './theme.ts';
+export { GUEST_UI_LOOK_CSS } from './style.ts';
 export type { Handle } from './dom.ts';
 export { mountButton } from './button.ts';
 export type { ButtonHandle, ButtonProps, ButtonSize, ButtonVariant } from './button.ts';

package/dist/ui/index.js

@@ -1,4 +1,5 @@
 export { applyHostReady, applyHostTheme } from "./theme.js";
+export { GUEST_UI_LOOK_CSS } from "./style.js";
 export { mountButton } from "./button.js";
 export { mountTextField } from "./field.js";
 export { mountSearchField } from "./search.js";

package/dist/ui/option.js

@@ -1,4 +1,5 @@
 import { button, el, setAttr } from "./dom.js";
+import { icon } from "./icons.js";
 const optionId = (uid, id) => `${uid}-${id ?? ''}`;
 export const createOption = (uid, role, spec, on) => {
     const node = button('oc-sdk-option');
@@ -18,6 +19,13 @@ export const createOption = (uid, role, spec, on) => {
         hint.textContent = spec.hint;
         node.append(hint);
     }
+    if (role === 'option') {
+        // The host's styles drop the selection fill only for options that carry the mark.
+        node.dataset.mark = 'check';
+        const check = el('span', 'oc-sdk-option-check');
+        check.append(icon('check', 14));
+        node.append(check);
+    }
     node.addEventListener('pointerenter', on.hover);
     node.addEventListener('click', on.pick);
     return node;

package/dist/ui/style.d.ts

@@ -1 +1,10 @@
+/**
+ * Appearance: colours, fonts, borders, corner radii, shadows, and the hover,
+ * pressed, selected and focus states. The kit carries it for previews outside
+ * the host, and the server appends the running app's copy to every served
+ * extension document, after the kit's own style element, so installed bundles
+ * follow the app's look without a rebuild. Selectors here keep the specificity
+ * of the rules they override in older bundles.
+ */
+export declare const GUEST_UI_LOOK_CSS: string;
 export declare const UI_CSS: string;