libfx 0.0.8 → 0.0.9-dev.982.ge26e97ec4040

package/README.md

@@ -325,9 +325,25 @@ const runtime = await createFxTerminal({
 await runtime.interactive;
 ```
 
+The xterm adapter preserves browser-style composer editing for Shift+Enter,
+Command+A, Command+C, Command+X, Command+Z, and Command+Shift+Z. Shift+Enter
+inserts a newline without submitting. A click inside the visible composer moves
+its caret; pointer drags remain xterm terminal-output selections.
+When xterm already has an output selection, Command+C copies that selection
+instead of the composer selection.
+
 The terminal runtime exposes `interactive`, `exited`, `write`, `resize`, and
-`abort`. Terminal session, config, OAuth, prompt-history, URL, and workspace
-stores remain terminal-only host integrations.
+`abort`. Terminal session, config, OAuth, prompt-history, clipboard, URL, and
+workspace stores remain terminal-only host integrations. Clipboard copy writes
+through the host `clipboard.writeText(text)` adapter and defaults to
+`navigator.clipboard`.
+
+During `/compact` and automatic compaction, the terminal shows a live
+`Compacting` activity row with elapsed time. Input and cancellation remain
+responsive while the summary request is pending. Compaction progress and
+outcomes do not add transcript entries, including cancellation after resume.
+Stored snapshots retain cancellation-origin metadata; keep them opaque and
+resume with the same or a newer SDK build. Older snapshots remain readable.
 
 ## Security
 

package/fx-sdk.js

@@ -36,6 +36,7 @@ function validateGatewayChatUrl(value) {
   if (url.username || url.password || url.hash) {
     throw new TypeError("gatewayChatUrl must not contain credentials or a fragment");
   }
+  if (url.href === "https://ai-gateway.vercel.sh/v4/ai/language-model") return;
   if (url.href === "https://ai-gateway.vercel.sh/v3/ai/language-model") return;
   const loopback = url.hostname === "127.0.0.1" || url.hostname === "[::1]" || url.hostname === "localhost";
   if (url.protocol !== "http:" || !loopback || !url.port) {
@@ -208,14 +209,83 @@ export function encodeXtermKeyEvent(event) {
     if (event.key === "Backspace") return `\x1b[127;${modifiers + 1}u`;
     const arrow = { ArrowUp: "A", ArrowDown: "B", ArrowRight: "C", ArrowLeft: "D" }[event.key];
     if (arrow) return `\x1b[1;${modifiers + 1}${arrow}`;
+    const shortcut = { a: 97, c: 99, x: 120, z: 122 }[event.key.toLowerCase()];
+    if (shortcut) return `\x1b[${shortcut};${modifiers + 1}u`;
   }
   return null;
 }
 
+function xtermPointerCell(term, event) {
+  const root = term.element;
+  const screen = root?.querySelector?.(".xterm-screen") || root;
+  const rect = screen?.getBoundingClientRect?.();
+  if (!rect || rect.width <= 0 || rect.height <= 0 || term.cols <= 0 || term.rows <= 0) return null;
+  if (event.clientX < rect.left || event.clientX >= rect.right ||
+    event.clientY < rect.top || event.clientY >= rect.bottom) return null;
+  return {
+    column: Math.min(term.cols, Math.floor((event.clientX - rect.left) * term.cols / rect.width) + 1),
+    row: Math.min(term.rows, Math.floor((event.clientY - rect.top) * term.rows / rect.height) + 1),
+  };
+}
+
+function installXtermClickHandler(term, callback) {
+  const element = term.element;
+  if (typeof element?.addEventListener !== "function") return () => {};
+  let pointerDown = null;
+  const down = (event) => {
+    if (event.button !== 0) return;
+    pointerDown = { id: event.pointerId, x: event.clientX, y: event.clientY };
+  };
+  const up = (event) => {
+    const start = pointerDown;
+    pointerDown = null;
+    if (!start || event.button !== 0 || event.pointerId !== start.id ||
+      event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return;
+    const dx = event.clientX - start.x;
+    const dy = event.clientY - start.y;
+    if (dx * dx + dy * dy > 16) return;
+    if (term.modes?.mouseTrackingMode && term.modes.mouseTrackingMode !== "none") return;
+    const cell = xtermPointerCell(term, event);
+    if (!cell) return;
+    callback(`\x1b[<0;${cell.column};${cell.row}M\x1b[<0;${cell.column};${cell.row}m`);
+  };
+  const cancel = () => { pointerDown = null; };
+  element.addEventListener("pointerdown", down);
+  element.addEventListener("pointerup", up);
+  element.addEventListener("pointercancel", cancel);
+  return () => {
+    element.removeEventListener("pointerdown", down);
+    element.removeEventListener("pointerup", up);
+    element.removeEventListener("pointercancel", cancel);
+  };
+}
+
+function installXtermShortcutHandler(term, callback) {
+  const element = term.element;
+  if (typeof element?.addEventListener !== "function") return () => {};
+  const keydown = (event) => {
+    if (xtermSelectionOwnsShortcut(term, event)) return;
+    const data = encodeXtermKeyEvent(event);
+    if (data === null) return;
+    event.preventDefault();
+    event.stopImmediatePropagation();
+    callback(data);
+  };
+  element.addEventListener("keydown", keydown, true);
+  return () => element.removeEventListener("keydown", keydown, true);
+}
+
+function xtermSelectionOwnsShortcut(term, event) {
+  return event.type === "keydown" && event.metaKey &&
+    (event.key.toLowerCase() === "c" || event.key.toLowerCase() === "x") &&
+    term.hasSelection?.();
+}
+
 export function xtermAdapter(term) {
   let keyDataHandler = null;
   if (typeof term.attachCustomKeyEventHandler === "function") {
     term.attachCustomKeyEventHandler((event) => {
+      if (xtermSelectionOwnsShortcut(term, event)) return true;
       const data = encodeXtermKeyEvent(event);
       if (data === null || keyDataHandler === null) return true;
       keyDataHandler(data);
@@ -227,7 +297,13 @@ export function xtermAdapter(term) {
     onData(callback) { const disposable = term.onData(callback); return () => disposable.dispose(); },
     onKeyData(callback) {
       keyDataHandler = callback;
-      return () => { if (keyDataHandler === callback) keyDataHandler = null; };
+      const removeShortcutHandler = installXtermShortcutHandler(term, callback);
+      const removeClickHandler = installXtermClickHandler(term, callback);
+      return () => {
+        removeShortcutHandler();
+        removeClickHandler();
+        if (keyDataHandler === callback) keyDataHandler = null;
+      };
     },
     get cols() { return term.cols; },
     get rows() { return term.rows; },
@@ -607,6 +683,23 @@ function createRuntime(options) {
       accepted === false ? 0 : 1).catch(() => 0);
   }
 
+  function clipboardCopy(valuePtr, valueLen) {
+    let clipboard = options.clipboard;
+    if (clipboard === undefined) {
+      try { clipboard = globalThis.navigator?.clipboard; } catch { clipboard = null; }
+    }
+    if (typeof clipboard?.writeText !== "function") return Promise.resolve(0);
+    const value = text(valuePtr, valueLen);
+    return Promise.resolve().then(() => clipboard.writeText(value)).then((accepted) => {
+      if (accepted === false) return 0;
+      options.emit?.("clipboard.copy", { length: value.length });
+      return 1;
+    }).catch((error) => {
+      options.emit?.("clipboard.copy_error", { error });
+      return 0;
+    });
+  }
+
   function oauthSessionLoad(outPtr, outCap, revisionPtr, revisionCap, revisionLenOut) {
     if (!options.oauthSessionStore?.load) return -1;
     return Promise.resolve().then(() => options.oauthSessionStore.load()).then((record) => {
@@ -913,6 +1006,7 @@ function createRuntime(options) {
 
   const fx = {
     fx_term_poll_input: new WebAssembly.Suspending(termPollInput),
+    fx_clipboard_copy: new WebAssembly.Suspending(clipboardCopy),
     fx_prompt_history_available() { return options.promptHistoryStore ? 1 : 0; },
     fx_workspace_available() { return workspace.present ? 1 : 0; },
     fx_workspace_info: workspaceInfo,

package/node.cjs

@@ -218,6 +218,8 @@ function validateGatewayChatUrl(value) {
   if (url.username || url.password || url.hash) {
     throw new TypeError("gatewayChatUrl must not contain credentials or a fragment");
   }
+  if (url.href === "https://ai-gateway.vercel.sh/v4/ai/language-model")
+    return;
   if (url.href === "https://ai-gateway.vercel.sh/v3/ai/language-model")
     return;
   const loopback = url.hostname === "127.0.0.1" || url.hostname === "[::1]" || url.hostname === "localhost";
@@ -393,13 +395,89 @@ function encodeXtermKeyEvent(event) {
     const arrow = { ArrowUp: "A", ArrowDown: "B", ArrowRight: "C", ArrowLeft: "D" }[event.key];
     if (arrow)
       return `\x1B[1;${modifiers + 1}${arrow}`;
+    const shortcut = { a: 97, c: 99, x: 120, z: 122 }[event.key.toLowerCase()];
+    if (shortcut)
+      return `\x1B[${shortcut};${modifiers + 1}u`;
   }
   return null;
 }
+function xtermPointerCell(term, event) {
+  const root = term.element;
+  const screen = root?.querySelector?.(".xterm-screen") || root;
+  const rect = screen?.getBoundingClientRect?.();
+  if (!rect || rect.width <= 0 || rect.height <= 0 || term.cols <= 0 || term.rows <= 0)
+    return null;
+  if (event.clientX < rect.left || event.clientX >= rect.right || event.clientY < rect.top || event.clientY >= rect.bottom)
+    return null;
+  return {
+    column: Math.min(term.cols, Math.floor((event.clientX - rect.left) * term.cols / rect.width) + 1),
+    row: Math.min(term.rows, Math.floor((event.clientY - rect.top) * term.rows / rect.height) + 1)
+  };
+}
+function installXtermClickHandler(term, callback) {
+  const element = term.element;
+  if (typeof element?.addEventListener !== "function")
+    return () => {};
+  let pointerDown = null;
+  const down = (event) => {
+    if (event.button !== 0)
+      return;
+    pointerDown = { id: event.pointerId, x: event.clientX, y: event.clientY };
+  };
+  const up = (event) => {
+    const start = pointerDown;
+    pointerDown = null;
+    if (!start || event.button !== 0 || event.pointerId !== start.id || event.shiftKey || event.altKey || event.ctrlKey || event.metaKey)
+      return;
+    const dx = event.clientX - start.x;
+    const dy = event.clientY - start.y;
+    if (dx * dx + dy * dy > 16)
+      return;
+    if (term.modes?.mouseTrackingMode && term.modes.mouseTrackingMode !== "none")
+      return;
+    const cell = xtermPointerCell(term, event);
+    if (!cell)
+      return;
+    callback(`\x1B[<0;${cell.column};${cell.row}M\x1B[<0;${cell.column};${cell.row}m`);
+  };
+  const cancel = () => {
+    pointerDown = null;
+  };
+  element.addEventListener("pointerdown", down);
+  element.addEventListener("pointerup", up);
+  element.addEventListener("pointercancel", cancel);
+  return () => {
+    element.removeEventListener("pointerdown", down);
+    element.removeEventListener("pointerup", up);
+    element.removeEventListener("pointercancel", cancel);
+  };
+}
+function installXtermShortcutHandler(term, callback) {
+  const element = term.element;
+  if (typeof element?.addEventListener !== "function")
+    return () => {};
+  const keydown = (event) => {
+    if (xtermSelectionOwnsShortcut(term, event))
+      return;
+    const data = encodeXtermKeyEvent(event);
+    if (data === null)
+      return;
+    event.preventDefault();
+    event.stopImmediatePropagation();
+    callback(data);
+  };
+  element.addEventListener("keydown", keydown, true);
+  return () => element.removeEventListener("keydown", keydown, true);
+}
+function xtermSelectionOwnsShortcut(term, event) {
+  return event.type === "keydown" && event.metaKey && (event.key.toLowerCase() === "c" || event.key.toLowerCase() === "x") && term.hasSelection?.();
+}
 function xtermAdapter(term) {
   let keyDataHandler = null;
   if (typeof term.attachCustomKeyEventHandler === "function") {
     term.attachCustomKeyEventHandler((event) => {
+      if (xtermSelectionOwnsShortcut(term, event))
+        return true;
       const data = encodeXtermKeyEvent(event);
       if (data === null || keyDataHandler === null)
         return true;
@@ -417,7 +495,11 @@ function xtermAdapter(term) {
     },
     onKeyData(callback) {
       keyDataHandler = callback;
+      const removeShortcutHandler = installXtermShortcutHandler(term, callback);
+      const removeClickHandler = installXtermClickHandler(term, callback);
       return () => {
+        removeShortcutHandler();
+        removeClickHandler();
         if (keyDataHandler === callback)
           keyDataHandler = null;
       };
@@ -844,6 +926,28 @@ function createRuntime(options) {
       return 0;
     return Promise.resolve().then(() => options.openUrl(text(urlPtr, urlLen))).then((accepted) => accepted === false ? 0 : 1).catch(() => 0);
   }
+  function clipboardCopy(valuePtr, valueLen) {
+    let clipboard = options.clipboard;
+    if (clipboard === undefined) {
+      try {
+        clipboard = globalThis.navigator?.clipboard;
+      } catch {
+        clipboard = null;
+      }
+    }
+    if (typeof clipboard?.writeText !== "function")
+      return Promise.resolve(0);
+    const value = text(valuePtr, valueLen);
+    return Promise.resolve().then(() => clipboard.writeText(value)).then((accepted) => {
+      if (accepted === false)
+        return 0;
+      options.emit?.("clipboard.copy", { length: value.length });
+      return 1;
+    }).catch((error) => {
+      options.emit?.("clipboard.copy_error", { error });
+      return 0;
+    });
+  }
   function oauthSessionLoad(outPtr, outCap, revisionPtr, revisionCap, revisionLenOut) {
     if (!options.oauthSessionStore?.load)
       return -1;
@@ -1216,6 +1320,7 @@ function createRuntime(options) {
   };
   const fx = {
     fx_term_poll_input: new WebAssembly.Suspending(termPollInput),
+    fx_clipboard_copy: new WebAssembly.Suspending(clipboardCopy),
     fx_prompt_history_available() {
       return options.promptHistoryStore ? 1 : 0;
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libfx",
-  "version": "0.0.8",
+  "version": "0.0.9-dev.982.ge26e97ec4040",
   "description": "Embed fx agents and terminals in JavaScript hosts",
   "type": "module",
   "repository": {