@volter-ai-dev/supercode-ui 0.1.51 → 0.1.52

package/README.md

@@ -43,6 +43,9 @@ const mounted = mountSupercodeMessenger(document.querySelector('#agent'), {
     async pickContext() {
       return host.pickFilesAndImages();
     },
+    openKeyboardShortcuts() {
+      panel.showKeyboardShortcuts();
+    },
     onClose() {
       panel.close();
     },
@@ -251,6 +254,9 @@ inventing fallback prompt text. The composer bounds images to four supported bro
 messages, retry, edit, and new-chat recovery. The host still chooses how explicit file selection
 is exposed and must revalidate every returned item.
 
+`openKeyboardShortcuts` is also optional and host-owned. When present, the default conversation
+overflow includes a Keyboard shortcuts item without consuming permanent header width.
+
 Transcript images with a browser-safe URL open in a keyboard-accessible, viewport-bounded viewer;
 remote images expose copy-link and open-original actions, while local data images can be downloaded.
 `createClientProjection` keeps large historical data URLs in a projection-scoped host registry and

package/components.mjs

@@ -2655,7 +2655,8 @@ function ConversationActions({ state, adapter, actionPending, onNew, onSettings
         state.canDetach ? { key: "detach", label: "Detach to read-only", intent: { action: "detach" } } : null,
         state.canOpenTerminal ? { key: "terminal", label: "Prepare terminal handoff", intent: { action: "terminal" } } : null,
         state.canExport && state.exportBackTarget ? { key: "export", label: `Export back to ${harnessDisplayName(state.exportBackTarget)}`, intent: { action: "export", targetHarness: state.exportBackTarget } } : null,
-        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null
+        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null,
+        adapter.openKeyboardShortcuts ? { key: "shortcuts", label: "Keyboard shortcuts", onSelect: adapter.openKeyboardShortcuts } : null
       ].filter(Boolean)
     },
     {

package/embed.mjs

@@ -2572,7 +2572,8 @@ function ConversationActions({ state, adapter, actionPending, onNew, onSettings
         state.canDetach ? { key: "detach", label: "Detach to read-only", intent: { action: "detach" } } : null,
         state.canOpenTerminal ? { key: "terminal", label: "Prepare terminal handoff", intent: { action: "terminal" } } : null,
         state.canExport && state.exportBackTarget ? { key: "export", label: `Export back to ${harnessDisplayName(state.exportBackTarget)}`, intent: { action: "export", targetHarness: state.exportBackTarget } } : null,
-        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null
+        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null,
+        adapter.openKeyboardShortcuts ? { key: "shortcuts", label: "Keyboard shortcuts", onSelect: adapter.openKeyboardShortcuts } : null
       ].filter(Boolean)
     },
     {

package/index.d.ts

@@ -348,6 +348,8 @@ export interface UiAdapter {
   pickContext?(): TranscriptAttachment | TranscriptAttachment[] | null | Promise<TranscriptAttachment | TranscriptAttachment[] | null>;
   /** Resolve one projected historical image on demand. The UI owns and revokes its object URL. */
   resolveImage?(image: TranscriptImage): Blob | Promise<Blob>;
+  /** Open the embedding host's keyboard-shortcut reference from the standard overflow menu. */
+  openKeyboardShortcuts?(): void;
   onClose?(): void;
   onOpen?(): void;
   copyText?(value: string): void | Promise<void>;

package/messenger.mjs

@@ -2569,7 +2569,8 @@ function ConversationActions({ state, adapter, actionPending, onNew, onSettings
         state.canDetach ? { key: "detach", label: "Detach to read-only", intent: { action: "detach" } } : null,
         state.canOpenTerminal ? { key: "terminal", label: "Prepare terminal handoff", intent: { action: "terminal" } } : null,
         state.canExport && state.exportBackTarget ? { key: "export", label: `Export back to ${harnessDisplayName(state.exportBackTarget)}`, intent: { action: "export", targetHarness: state.exportBackTarget } } : null,
-        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null
+        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null,
+        adapter.openKeyboardShortcuts ? { key: "shortcuts", label: "Keyboard shortcuts", onSelect: adapter.openKeyboardShortcuts } : null
       ].filter(Boolean)
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter-ai-dev/supercode-ui",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "type": "module",
   "description": "Composable default UI kit for Supercode-powered coding-agent experiences",
   "exports": {

package/react/components.mjs

@@ -2655,7 +2655,8 @@ function ConversationActions({ state, adapter, actionPending, onNew, onSettings
         state.canDetach ? { key: "detach", label: "Detach to read-only", intent: { action: "detach" } } : null,
         state.canOpenTerminal ? { key: "terminal", label: "Prepare terminal handoff", intent: { action: "terminal" } } : null,
         state.canExport && state.exportBackTarget ? { key: "export", label: `Export back to ${harnessDisplayName(state.exportBackTarget)}`, intent: { action: "export", targetHarness: state.exportBackTarget } } : null,
-        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null
+        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null,
+        adapter.openKeyboardShortcuts ? { key: "shortcuts", label: "Keyboard shortcuts", onSelect: adapter.openKeyboardShortcuts } : null
       ].filter(Boolean)
     },
     {

package/react/messenger.mjs

@@ -2569,7 +2569,8 @@ function ConversationActions({ state, adapter, actionPending, onNew, onSettings
         state.canDetach ? { key: "detach", label: "Detach to read-only", intent: { action: "detach" } } : null,
         state.canOpenTerminal ? { key: "terminal", label: "Prepare terminal handoff", intent: { action: "terminal" } } : null,
         state.canExport && state.exportBackTarget ? { key: "export", label: `Export back to ${harnessDisplayName(state.exportBackTarget)}`, intent: { action: "export", targetHarness: state.exportBackTarget } } : null,
-        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null
+        state.interopSettings || state.interopSettingsError ? { key: "settings", label: "Interoperability settings", onSelect: onSettings } : null,
+        adapter.openKeyboardShortcuts ? { key: "shortcuts", label: "Keyboard shortcuts", onSelect: adapter.openKeyboardShortcuts } : null
       ].filter(Boolean)
     },
     {