@classic-homes/agent-chat 0.9.0 → 0.10.0

package/README.md

@@ -43,6 +43,8 @@ agent-api origin that serves `/frame`; artifacts and MCP-UI resources only ever
 `AgentChat` composes the rest; each is also exported for other layouts:
 
 - `ChatHeader`, `ConversationSidebar`: title and conversation actions; the history rail.
+  `ChatHeader`'s menu opens `ShortcutsDialog` (the chat's `CHAT_SHORTCUTS` plus the host's
+  `shortcuts`, e.g. a panel toggle). Hosts implement their own app-level shortcuts.
 - `MessageList`: transcript with day separators and a jump-to-latest button.
 - `MessageItem` → `UserMessage` / `AssistantMessage`, with `MessageActions` (copy, time,
   `MessageFeedback` thumbs up/down with an optional note, Regenerate and Edit on the latest turn),

package/dist/components/ChatHeader.svelte

@@ -1,8 +1,9 @@
 <!--
   @component
   Header for a chat: conversation title, agent badge and the conversation menu (rename,
-  open full page, delete). Pass it to `AgentChat` through the `header` snippet. Actions only
-  show when their handler is set; rename and delete also need a `conversationId`.
+  open full page, delete, keyboard shortcuts). Pass it to `AgentChat` through the `header`
+  snippet. Actions only show when their handler is set; rename and delete also need a
+  `conversationId`. "Keyboard shortcuts" always shows and lists the host's `shortcuts` first.
 -->
 <script lang="ts">
   import {
@@ -14,7 +15,9 @@
     type DropdownMenuItem,
   } from '@classic-homes/theme-svelte';
   import type { Snippet } from 'svelte';
+  import type { ChatShortcut } from '../shortcuts.js';
   import ConversationDialogs, { type ConversationRef } from './ConversationDialogs.svelte';
+  import ShortcutsDialog from './ShortcutsDialog.svelte';
 
   interface Props {
     title?: string;
@@ -29,6 +32,8 @@
     onrename?: (conversationId: string, title: string) => void | Promise<void>;
     ondelete?: (conversationId: string) => void | Promise<void>;
     onerror?: (message: string) => void;
+    /** Host shortcuts for the "Keyboard shortcuts" dialog, e.g. opening the panel. */
+    shortcuts?: ChatShortcut[];
     /** Extra controls before the menu. */
     actions?: Snippet;
     class?: string;
@@ -43,12 +48,14 @@
     onrename,
     ondelete,
     onerror,
+    shortcuts,
     actions,
     class: className,
   }: Props = $props();
 
   let renaming = $state<ConversationRef | null>(null);
   let deleting = $state<ConversationRef | null>(null);
+  let showingShortcuts = $state(false);
   let headerEl = $state<HTMLElement | null>(null);
   let returnFocus = $state<HTMLElement | null>(null);
   /** Remember the menu trigger before a dialog takes focus from the closing menu. */
@@ -77,6 +84,12 @@
         onSelect: () => open(() => (deleting = current)),
       });
     }
+    if (list.length) list.push({ type: 'separator' });
+    list.push({
+      label: 'Keyboard shortcuts',
+      icon: 'keyboard',
+      onSelect: () => open(() => (showingShortcuts = true)),
+    });
     return list;
   });
 </script>
@@ -104,19 +117,18 @@
       ><Icon name="plus" size={18} /></Button
     >
   {/if}
-  {#if items.length}
-    <DropdownMenu
-      {items}
-      align="end"
-      triggerVariant="ghost"
-      triggerSize="icon"
-      triggerClass="size-8"
-      triggerLabel="Conversation options"
-      showChevron={false}
-    >
-      {#snippet trigger()}<Icon name="more-horizontal" size={18} />{/snippet}
-    </DropdownMenu>
-  {/if}
+  <DropdownMenu
+    {items}
+    align="end"
+    triggerVariant="ghost"
+    triggerSize="icon"
+    triggerClass="size-8"
+    triggerLabel="Conversation options"
+    showChevron={false}
+  >
+    {#snippet trigger()}<Icon name="more-horizontal" size={18} />{/snippet}
+  </DropdownMenu>
 </header>
 
 <ConversationDialogs bind:renaming bind:deleting {onrename} {ondelete} {onerror} {returnFocus} />
+<ShortcutsDialog bind:open={showingShortcuts} {shortcuts} {returnFocus} />

package/dist/components/ChatHeader.svelte.d.ts

@@ -1,4 +1,5 @@
 import type { Snippet } from 'svelte';
+import type { ChatShortcut } from '../shortcuts.js';
 interface Props {
     title?: string;
     conversationId?: string | null;
@@ -12,14 +13,17 @@ interface Props {
     onrename?: (conversationId: string, title: string) => void | Promise<void>;
     ondelete?: (conversationId: string) => void | Promise<void>;
     onerror?: (message: string) => void;
+    /** Host shortcuts for the "Keyboard shortcuts" dialog, e.g. opening the panel. */
+    shortcuts?: ChatShortcut[];
     /** Extra controls before the menu. */
     actions?: Snippet;
     class?: string;
 }
 /**
  * Header for a chat: conversation title, agent badge and the conversation menu (rename,
- * open full page, delete). Pass it to `AgentChat` through the `header` snippet. Actions only
- * show when their handler is set; rename and delete also need a `conversationId`.
+ * open full page, delete, keyboard shortcuts). Pass it to `AgentChat` through the `header`
+ * snippet. Actions only show when their handler is set; rename and delete also need a
+ * `conversationId`. "Keyboard shortcuts" always shows and lists the host's `shortcuts` first.
  */
 declare const ChatHeader: import("svelte").Component<Props, {}, "">;
 type ChatHeader = ReturnType<typeof ChatHeader>;

package/dist/components/ChatHeader.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatHeader.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/ChatHeader.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIpC,UAAU,KAAK;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8EH;;;;GAIG;AACH,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ChatHeader.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/ChatHeader.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKlD,UAAU,KAAK;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,kFAAkF;IAClF,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuFH;;;;;GAKG;AACH,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/components/ShortcutsDialog.svelte

@@ -0,0 +1,56 @@
+<!--
+  @component
+  Lists the chat's keyboard shortcuts (`CHAT_SHORTCUTS`) and the host's own (`shortcuts`, shown
+  first). Opened from the `ChatHeader` menu; focus returns to `returnFocus` on close.
+-->
+<script lang="ts">
+  import { Dialog, Kbd } from '@classic-homes/theme-svelte';
+  import { releaseStuckBodyLock } from '../body-lock.js';
+  import { CHAT_SHORTCUTS, type ChatShortcut } from '../shortcuts.js';
+
+  interface Props {
+    open?: boolean;
+    /** Host shortcuts, e.g. opening the agent panel or starting a new chat. */
+    shortcuts?: ChatShortcut[];
+    returnFocus?: HTMLElement | null;
+  }
+  let { open = $bindable(false), shortcuts = [], returnFocus = null }: Props = $props();
+
+  const groups = $derived(
+    [
+      { title: 'App', items: shortcuts },
+      { title: 'Chat', items: [...CHAT_SHORTCUTS] },
+    ].filter((g) => g.items.length),
+  );
+</script>
+
+<Dialog
+  bind:open
+  title="Keyboard shortcuts"
+  size="sm"
+  onCloseAutoFocus={(event: Event) => {
+    if (returnFocus?.isConnected) {
+      event.preventDefault();
+      returnFocus.focus();
+    }
+    releaseStuckBodyLock();
+  }}
+>
+  <div class="grid gap-4">
+    {#each groups as group (group.title)}
+      <section>
+        <h3 class="mb-1 text-[11px] font-semibold uppercase tracking-wide text-muted-foreground">
+          {group.title}
+        </h3>
+        <dl class="divide-y divide-border text-sm">
+          {#each group.items as s (s.label)}
+            <div class="flex items-center justify-between gap-4 py-1.5">
+              <dt>{s.label}</dt>
+              <dd class="shrink-0"><Kbd keys={s.keys} size="sm" /></dd>
+            </div>
+          {/each}
+        </dl>
+      </section>
+    {/each}
+  </div>
+</Dialog>

package/dist/components/ShortcutsDialog.svelte.d.ts

@@ -0,0 +1,15 @@
+import { type ChatShortcut } from '../shortcuts.js';
+interface Props {
+    open?: boolean;
+    /** Host shortcuts, e.g. opening the agent panel or starting a new chat. */
+    shortcuts?: ChatShortcut[];
+    returnFocus?: HTMLElement | null;
+}
+/**
+ * Lists the chat's keyboard shortcuts (`CHAT_SHORTCUTS`) and the host's own (`shortcuts`, shown
+ * first). Opened from the `ChatHeader` menu; focus returns to `returnFocus` on close.
+ */
+declare const ShortcutsDialog: import("svelte").Component<Props, {}, "open">;
+type ShortcutsDialog = ReturnType<typeof ShortcutsDialog>;
+export default ShortcutsDialog;
+//# sourceMappingURL=ShortcutsDialog.svelte.d.ts.map

package/dist/components/ShortcutsDialog.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShortcutsDialog.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/ShortcutsDialog.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGlE,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAClC;AA6CH;;;GAGG;AACH,QAAA,MAAM,eAAe,+CAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/components/a11y.svelte.test.js

@@ -3,6 +3,7 @@ import { cleanup, render, screen, waitFor } from '@testing-library/svelte';
 import axe from 'axe-core';
 import userEvent from '@testing-library/user-event';
 import AgentChat from './AgentChat.svelte';
+import ChatHeader from './ChatHeader.svelte';
 import ConversationSidebar from './ConversationSidebar.svelte';
 afterEach(() => {
     cleanup();
@@ -100,6 +101,16 @@ describe('accessibility (axe)', () => {
         await user.keyboard('{Escape}');
         expect(await violations()).toEqual([]);
     });
+    it('has no violations in the keyboard shortcuts dialog', async () => {
+        const user = userEvent.setup();
+        render(ChatHeader, {
+            props: { title: 'x', shortcuts: [{ keys: ['Mod', 'J'], label: 'Open the agent panel' }] },
+        });
+        await user.click(screen.getByRole('button', { name: 'Conversation options' }));
+        await user.click(await screen.findByRole('menuitem', { name: /Keyboard shortcuts/ }));
+        await screen.findByRole('dialog', { name: 'Keyboard shortcuts' });
+        expect(await violations()).toEqual([]);
+    });
     it('has no violations in the conversation rail', async () => {
         const now = new Date().toISOString();
         render(ConversationSidebar, {

package/dist/components/conversation-chrome.svelte.test.js

@@ -94,11 +94,31 @@ describe('ConversationSidebar', () => {
     });
 });
 describe('ChatHeader', () => {
-    it('shows the title, falls back to "New chat" and hides actions without handlers', () => {
+    it('shows the title, falls back to "New chat" and hides actions without handlers', async () => {
+        const user = userEvent.setup();
         render(ChatHeader, { props: { title: '  ' } });
         expect(screen.getByRole('heading', { name: 'New chat' })).toBeTruthy();
-        expect(screen.queryByRole('button', { name: 'Conversation options' })).toBeNull();
         expect(screen.queryByRole('button', { name: 'Show conversations' })).toBeNull();
+        // Only the shortcuts entry is left in the menu.
+        await user.click(screen.getByRole('button', { name: 'Conversation options' }));
+        const items = await screen.findAllByRole('menuitem');
+        expect(items.map((i) => i.textContent?.trim())).toEqual(['Keyboard shortcuts']);
+    });
+    it('lists host and chat shortcuts, then returns focus to the menu button', async () => {
+        const user = userEvent.setup();
+        render(ChatHeader, {
+            props: { title: 'x', shortcuts: [{ keys: ['Mod', 'Shift', 'O'], label: 'New chat' }] },
+        });
+        const trigger = screen.getByRole('button', { name: 'Conversation options' });
+        await user.click(trigger);
+        await user.click(await screen.findByRole('menuitem', { name: /Keyboard shortcuts/ }));
+        const dialog = await screen.findByRole('dialog', { name: 'Keyboard shortcuts' });
+        expect(dialog.textContent).toContain('New chat');
+        expect(dialog.textContent).toContain('Stop the reply');
+        expect(dialog.textContent).toContain('Insert a saved prompt');
+        await user.keyboard('{Escape}');
+        await waitFor(() => expect(screen.queryByRole('dialog')).toBeNull());
+        await waitFor(() => expect(document.activeElement).toBe(trigger));
     });
     const handlers = () => ({ title: 'Lot 12 budget', onrename: vi.fn(), ondelete: vi.fn() });
     it('offers no rename or delete before the conversation is saved', async () => {

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './markdown.js';
 export * from './message-format.js';
 export * from './reducer.js';
 export * from './session.svelte.js';
+export * from './shortcuts.js';
 export * from './ui-frame-protocol.js';
 export * from './welcome.js';
 export { default as AgentChat } from './components/AgentChat.svelte';
@@ -24,4 +25,5 @@ export { default as ArtifactChip } from './components/ArtifactChip.svelte';
 export { default as MessageFiles } from './components/MessageFiles.svelte';
 export { default as ProposalCard } from './components/ProposalCard.svelte';
 export { default as Welcome } from './components/Welcome.svelte';
+export { default as ShortcutsDialog } from './components/ShortcutsDialog.svelte';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export * from './markdown.js';
 export * from './message-format.js';
 export * from './reducer.js';
 export * from './session.svelte.js';
+export * from './shortcuts.js';
 export * from './ui-frame-protocol.js';
 export * from './welcome.js';
 export { default as AgentChat } from './components/AgentChat.svelte';
@@ -24,3 +25,4 @@ export { default as ArtifactChip } from './components/ArtifactChip.svelte';
 export { default as MessageFiles } from './components/MessageFiles.svelte';
 export { default as ProposalCard } from './components/ProposalCard.svelte';
 export { default as Welcome } from './components/Welcome.svelte';
+export { default as ShortcutsDialog } from './components/ShortcutsDialog.svelte';

package/dist/shortcuts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Keyboard shortcuts listed in the chat's "Keyboard shortcuts" dialog. `keys` use the theme
+ * `Kbd` names ("Mod" shows as ⌘ on Apple devices and Ctrl elsewhere).
+ */
+export interface ChatShortcut {
+    keys: string[];
+    label: string;
+}
+/** What the chat itself handles, in the composer. Hosts add their own (e.g. a panel toggle). */
+export declare const CHAT_SHORTCUTS: readonly ChatShortcut[];
+//# sourceMappingURL=shortcuts.d.ts.map

package/dist/shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.d.ts","sourceRoot":"","sources":["../src/lib/shortcuts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gGAAgG;AAChG,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAMjD,CAAC"}

package/dist/shortcuts.js

@@ -0,0 +1,8 @@
+/** What the chat itself handles, in the composer. Hosts add their own (e.g. a panel toggle). */
+export const CHAT_SHORTCUTS = [
+    { keys: ['Enter'], label: 'Send the message' },
+    { keys: ['Shift', 'Enter'], label: 'New line' },
+    { keys: ['Esc'], label: 'Stop the reply' },
+    { keys: ['/'], label: 'Insert a saved prompt' },
+    { keys: ['Esc'], label: 'Cancel editing a message' },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/agent-chat",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "private": false,
   "type": "module",
   "description": "Svelte 5 chat UI for Classic Agent: session state, message list, composer, tool timeline, artifacts and MCP-UI sandbox frames. Consumed by the Classic App.",
@@ -17,8 +17,8 @@
     "dist"
   ],
   "dependencies": {
-    "@classic-homes/agent-client": "0.9.0",
-    "@classic-homes/agent-contracts": "0.9.0",
+    "@classic-homes/agent-client": "0.10.0",
+    "@classic-homes/agent-contracts": "0.10.0",
     "dompurify": "3.4.17"
   },
   "peerDependencies": {