@steerable/agent-shell-web 0.6.70 → 0.6.71

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-shell-web",
-  "version": "0.6.70",
+  "version": "0.6.71",
   "type": "module",
   "description": "Steerable framework — product-neutral renderer SPA source for @steerable/agent-shell (React + Vite). Consumed by product web entry points via the `@/` alias (anchored at this package's src/) and the createProductViteConfig factory. Published as a source package (src/), plus the compiled vite.base config factory (vite.base.js + .d.ts) for Node-side config loading.",
   "license": "Apache-2.0",
@@ -45,8 +45,8 @@
     "react-router-dom": "^6.30.0",
     "rehype-raw": "^7.0.0",
     "remark-gfm": "^4.0.1",
-    "@steerable/agent-protocol": "0.6.70",
-    "@steerable/agent-ui": "0.6.70"
+    "@steerable/agent-protocol": "0.6.71",
+    "@steerable/agent-ui": "0.6.71"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.3.0",
@@ -59,7 +59,7 @@
     "typescript": "^5.8.3",
     "vite": "^5.4.21",
     "vitest": "^3.2.4",
-    "@steerable/pack-sdk": "0.6.70"
+    "@steerable/pack-sdk": "0.6.71"
   },
   "scripts": {
     "gen": "echo agent-shell-web",

package/src/lib/host-bridge.ts

@@ -129,6 +129,18 @@ export interface PythonRunnerSnapshot {
   restartRequired: boolean;
 }
 
+export interface HostClipboardFile {
+  name: string;
+  path?: string;
+  dataBase64?: string;
+  mime?: string;
+}
+
+export interface HostClipboard {
+  text: string;
+  files: HostClipboardFile[];
+}
+
 export interface HostBridge {
   runtime: 'local';
   platform: NodeJS.Platform;
@@ -197,25 +209,17 @@ export interface HostBridge {
   offMenuOpenTerminal?: () => void;
   /**
    * App menu IPC — `Cmd+V` / 编辑 → 粘贴 fires `menu:paste`.
-   * WKWebView does not expose that pasteboard to the page, so the renderer
-   * reads it through `readClipboard`.
+   * WKWebView does not expose that pasteboard to the page, so the host reads
+   * it before emitting the event.
    */
-  onMenuPaste?: (callback: () => void) => void;
+  onMenuPaste?: (callback: (clipboard: HostClipboard) => void) => void;
   offMenuPaste?: () => void;
   /**
    * OS pasteboard. `files` are copied paths or a screenshot PNG.
    * Text is empty when the pasteboard holds files, so the path is not
    * inserted into the composer as well.
    */
-  readClipboard?: () => Promise<{
-    text: string;
-    files: Array<{
-      name: string;
-      path?: string;
-      dataBase64?: string;
-      mime?: string;
-    }>;
-  }>;
+  readClipboard?: () => Promise<HostClipboard>;
   /** Plain text from the OS pasteboard. Empty when the clipboard has no text. */
   readClipboardText?: () => Promise<string>;
   /**

package/src/lib/host-paste.ts

@@ -4,18 +4,13 @@
  * and writes it into the focused field.
  */
 
-export interface HostClipboardFile {
-  name: string;
-  path?: string;
-  dataBase64?: string;
-  mime?: string;
-}
+import {
+  getHostBridge,
+  type HostClipboard,
+  type HostClipboardFile,
+} from './host-bridge';
 
-export interface HostClipboard {
-  text: string;
-  files: HostClipboardFile[];
-}
-import { getHostBridge } from './host-bridge';
+export type { HostClipboardFile } from './host-bridge';
 
 let pending = false;
 let lastEditable: HTMLElement | null = null;
@@ -44,8 +39,8 @@ export function installHostPaste(): void {
     if (isEditable(target)) lastEditable = target;
   });
   const bridge = getHostBridge();
-  bridge?.onMenuPaste?.(() => {
-    requestHostPaste();
+  bridge?.onMenuPaste?.((clipboard) => {
+    insertHostClipboard(clipboard);
   });
 }
 
@@ -58,8 +53,7 @@ export function requestHostPaste(target?: HTMLElement | null): void {
   pending = true;
   void readHostClipboard(readClipboard, readText)
     .then((clip) => {
-      if (clip.files.length > 0) insertHostFiles(clip.files, target ?? null);
-      if (clip.text) insertHostText(clip.text, target ?? null);
+      insertHostClipboard(clip, target ?? null);
     })
     .catch((error: unknown) => {
       console.warn('[host-paste] clipboard read failed', error);
@@ -100,6 +94,11 @@ export function hostClipboardAvailable(): boolean {
   );
 }
 
+function insertHostClipboard(clipboard: HostClipboard, target: HTMLElement | null = null): void {
+  if (clipboard.files.length > 0) insertHostFiles(clipboard.files, target);
+  if (clipboard.text) insertHostText(clipboard.text, target);
+}
+
 function isEditable(target: EventTarget | null): target is HTMLElement {
   if (isTerminalInput(target) || !(target instanceof HTMLElement)) return false;
   if (target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement) return true;

package/src/lib/tauri-bridge.ts

@@ -10,22 +10,23 @@ import { listen, type UnlistenFn } from '@tauri-apps/api/event';
 import html2canvas from 'html2canvas';
 import type {
   AppReleaseSnapshot,
+  HostClipboard,
   HostBridge,
   PythonRunnerSnapshot,
 } from './host-bridge';
 import { createHttpBridge } from './http-bridge';
 
-type VoidCallback = () => void;
+type EventCallback<T> = (payload: T) => void;
 
-function createMenuSubscription(event: string): {
-  on(callback: VoidCallback): void;
+function createMenuSubscription<T = void>(event: string): {
+  on(callback: EventCallback<T>): void;
   off(): void;
 } {
-  const subscriptions = new Map<VoidCallback, Promise<UnlistenFn>>();
+  const subscriptions = new Map<EventCallback<T>, Promise<UnlistenFn>>();
   return {
     on(callback) {
       if (subscriptions.has(callback)) return;
-      const subscription = listen(event, () => callback());
+      const subscription = listen<T>(event, ({ payload }) => callback(payload));
       subscriptions.set(callback, subscription);
     },
     off() {
@@ -42,7 +43,7 @@ export function createTauriBridge(): HostBridge {
   const bridge = createHttpBridge();
   const newChatMenu = createMenuSubscription('menu:new-chat');
   const terminalMenu = createMenuSubscription('menu:open-terminal');
-  const pasteMenu = createMenuSubscription('menu:paste');
+  const pasteMenu = createMenuSubscription<HostClipboard>('menu:paste');
 
   return {
     ...bridge,
@@ -92,11 +93,7 @@ export function createTauriBridge(): HostBridge {
     offMenuOpenTerminal: terminalMenu.off,
     onMenuPaste: pasteMenu.on,
     offMenuPaste: pasteMenu.off,
-    readClipboard: () =>
-      invoke<{
-        text: string;
-        files: Array<{ name: string; path?: string; dataBase64?: string; mime?: string }>;
-      }>('host_read_clipboard'),
+    readClipboard: () => invoke<HostClipboard>('host_read_clipboard'),
     readClipboardText: () => invoke<string>('host_read_clipboard_text'),
     app: {
       snapshot: () => invoke<AppReleaseSnapshot>('app_release_snapshot'),