shortcutxl 0.2.12 → 0.2.13

package/agent-docs/examples/extensions/modal-editor.ts

@@ -1,90 +1,90 @@
-/**
- * Modal Editor - vim-like modal editing example
- *
- * Usage: shortcut --extension ./examples/extensions/modal-editor.ts
- *
- * - Escape: insert → normal mode (in normal mode, aborts agent)
- * - i: normal → insert mode
- * - hjkl: navigation in normal mode
- * - ctrl+c, ctrl+d, etc. work in both modes
- */
-
-import {
-  CustomEditor,
-  matchesKey,
-  truncateToWidth,
-  visibleWidth,
-  type ExtensionAPI
-} from 'shortcutxl';
-
-// Normal mode key mappings: key -> escape sequence (or null for mode switch)
-const NORMAL_KEYS: Record<string, string | null> = {
-  h: '\x1b[D', // left
-  j: '\x1b[B', // down
-  k: '\x1b[A', // up
-  l: '\x1b[C', // right
-  '0': '\x01', // line start
-  $: '\x05', // line end
-  x: '\x1b[3~', // delete char
-  i: null, // insert mode
-  a: null // append (insert + right)
-};
-
-class ModalEditor extends CustomEditor {
-  private mode: 'normal' | 'insert' = 'insert';
-
-  handleInput(data: string): void {
-    // Escape toggles to normal mode, or passes through for app handling
-    if (matchesKey(data, 'escape')) {
-      if (this.mode === 'insert') {
-        this.mode = 'normal';
-      } else {
-        super.handleInput(data); // abort agent, etc.
-      }
-      return;
-    }
-
-    // Insert mode: pass everything through
-    if (this.mode === 'insert') {
-      super.handleInput(data);
-      return;
-    }
-
-    // Normal mode: check mapped keys
-    if (data in NORMAL_KEYS) {
-      const seq = NORMAL_KEYS[data];
-      if (data === 'i') {
-        this.mode = 'insert';
-      } else if (data === 'a') {
-        this.mode = 'insert';
-        super.handleInput('\x1b[C'); // move right first
-      } else if (seq) {
-        super.handleInput(seq);
-      }
-      return;
-    }
-
-    // Pass control sequences (ctrl+c, etc.) to super, ignore printable chars
-    if (data.length === 1 && data.charCodeAt(0) >= 32) return;
-    super.handleInput(data);
-  }
-
-  render(width: number): string[] {
-    const lines = super.render(width);
-    if (lines.length === 0) return lines;
-
-    // Add mode indicator to bottom border
-    const label = this.mode === 'normal' ? ' NORMAL ' : ' INSERT ';
-    const last = lines.length - 1;
-    if (visibleWidth(lines[last]!) >= label.length) {
-      lines[last] = truncateToWidth(lines[last]!, width - label.length, '') + label;
-    }
-    return lines;
-  }
-}
-
-export default function (shortcut: ExtensionAPI) {
-  shortcut.on('session_start', (_event, ctx) => {
-    ctx.ui.setEditorComponent((tui, theme, kb) => new ModalEditor(tui, theme, kb));
-  });
-}
+/**
+ * Modal Editor - vim-like modal editing example
+ *
+ * Usage: shortcut --extension ./examples/extensions/modal-editor.ts
+ *
+ * - Escape: insert → normal mode (in normal mode, aborts agent)
+ * - i: normal → insert mode
+ * - hjkl: navigation in normal mode
+ * - ctrl+c, ctrl+d, etc. work in both modes
+ */
+
+import {
+  CustomEditor,
+  matchesKey,
+  truncateToWidth,
+  visibleWidth,
+  type ExtensionAPI
+} from 'shortcutxl';
+
+// Normal mode key mappings: key -> escape sequence (or null for mode switch)
+const NORMAL_KEYS: Record<string, string | null> = {
+  h: '\x1b[D', // left
+  j: '\x1b[B', // down
+  k: '\x1b[A', // up
+  l: '\x1b[C', // right
+  '0': '\x01', // line start
+  $: '\x05', // line end
+  x: '\x1b[3~', // delete char
+  i: null, // insert mode
+  a: null // append (insert + right)
+};
+
+class ModalEditor extends CustomEditor {
+  private mode: 'normal' | 'insert' = 'insert';
+
+  handleInput(data: string): void {
+    // Escape toggles to normal mode, or passes through for app handling
+    if (matchesKey(data, 'escape')) {
+      if (this.mode === 'insert') {
+        this.mode = 'normal';
+      } else {
+        super.handleInput(data); // abort agent, etc.
+      }
+      return;
+    }
+
+    // Insert mode: pass everything through
+    if (this.mode === 'insert') {
+      super.handleInput(data);
+      return;
+    }
+
+    // Normal mode: check mapped keys
+    if (data in NORMAL_KEYS) {
+      const seq = NORMAL_KEYS[data];
+      if (data === 'i') {
+        this.mode = 'insert';
+      } else if (data === 'a') {
+        this.mode = 'insert';
+        super.handleInput('\x1b[C'); // move right first
+      } else if (seq) {
+        super.handleInput(seq);
+      }
+      return;
+    }
+
+    // Pass control sequences (ctrl+c, etc.) to super, ignore printable chars
+    if (data.length === 1 && data.charCodeAt(0) >= 32) return;
+    super.handleInput(data);
+  }
+
+  render(width: number): string[] {
+    const lines = super.render(width);
+    if (lines.length === 0) return lines;
+
+    // Add mode indicator to bottom border
+    const label = this.mode === 'normal' ? ' NORMAL ' : ' INSERT ';
+    const last = lines.length - 1;
+    if (visibleWidth(lines[last]!) >= label.length) {
+      lines[last] = truncateToWidth(lines[last]!, width - label.length, '') + label;
+    }
+    return lines;
+  }
+}
+
+export default function (shortcut: ExtensionAPI) {
+  shortcut.on('session_start', (_event, ctx) => {
+    ctx.ui.setEditorComponent((tui, theme, kb) => new ModalEditor(tui, theme, kb));
+  });
+}

package/agent-docs/examples/extensions/model-status.ts

@@ -1,31 +1,31 @@
-/**
- * Model status extension - shows model changes in the status bar.
- *
- * Demonstrates the `model_select` hook which fires when the model changes
- * via /model command, Ctrl+P cycling, or session restore.
- *
- * Usage: shortcut -e ./model-status.ts
- */
-
-import type { ExtensionAPI } from 'shortcutxl';
-
-export default function (shortcut: ExtensionAPI) {
-  shortcut.on('model_select', async (event, ctx) => {
-    const { model, previousModel, source } = event;
-
-    // Format model identifiers
-    const next = `${model.provider}/${model.id}`;
-    const prev = previousModel ? `${previousModel.provider}/${previousModel.id}` : 'none';
-
-    // Show notification on change
-    if (source !== 'restore') {
-      ctx.ui.notify(`Model: ${next}`, 'info');
-    }
-
-    // Update status bar with current model
-    ctx.ui.setStatus('model', `🤖 ${model.id}`);
-
-    // Log change details (visible in debug output)
-    console.log(`[model_select] ${prev} → ${next} (${source})`);
-  });
-}
+/**
+ * Model status extension - shows model changes in the status bar.
+ *
+ * Demonstrates the `model_select` hook which fires when the model changes
+ * via /model command, Ctrl+P cycling, or session restore.
+ *
+ * Usage: shortcut -e ./model-status.ts
+ */
+
+import type { ExtensionAPI } from 'shortcutxl';
+
+export default function (shortcut: ExtensionAPI) {
+  shortcut.on('model_select', async (event, ctx) => {
+    const { model, previousModel, source } = event;
+
+    // Format model identifiers
+    const next = `${model.provider}/${model.id}`;
+    const prev = previousModel ? `${previousModel.provider}/${previousModel.id}` : 'none';
+
+    // Show notification on change
+    if (source !== 'restore') {
+      ctx.ui.notify(`Model: ${next}`, 'info');
+    }
+
+    // Update status bar with current model
+    ctx.ui.setStatus('model', `🤖 ${model.id}`);
+
+    // Log change details (visible in debug output)
+    console.log(`[model_select] ${prev} → ${next} (${source})`);
+  });
+}

package/agent-docs/examples/extensions/notify.ts

@@ -1,55 +1,55 @@
-/**
- * Pi Notify Extension
- *
- * Sends a native terminal notification when Pi agent is done and waiting for input.
- * Supports multiple terminal protocols:
- * - OSC 777: Ghostty, iTerm2, WezTerm, rxvt-unicode
- * - OSC 99: Kitty
- * - Windows toast: Windows Terminal (WSL)
- */
-
-import type { ExtensionAPI } from 'shortcutxl';
-
-function windowsToastScript(title: string, body: string): string {
-  const type = 'Windows.UI.Notifications';
-  const mgr = `[${type}.ToastNotificationManager, ${type}, ContentType = WindowsRuntime]`;
-  const template = `[${type}.ToastTemplateType]::ToastText01`;
-  const toast = `[${type}.ToastNotification]::new($xml)`;
-  return [
-    `${mgr} > $null`,
-    `$xml = [${type}.ToastNotificationManager]::GetTemplateContent(${template})`,
-    `$xml.GetElementsByTagName('text')[0].AppendChild($xml.CreateTextNode('${body}')) > $null`,
-    `[${type}.ToastNotificationManager]::CreateToastNotifier('${title}').Show(${toast})`
-  ].join('; ');
-}
-
-function notifyOSC777(title: string, body: string): void {
-  process.stdout.write(`\x1b]777;notify;${title};${body}\x07`);
-}
-
-function notifyOSC99(title: string, body: string): void {
-  // Kitty OSC 99: i=notification id, d=0 means not done yet, p=body for second part
-  process.stdout.write(`\x1b]99;i=1:d=0;${title}\x1b\\`);
-  process.stdout.write(`\x1b]99;i=1:p=body;${body}\x1b\\`);
-}
-
-function notifyWindows(title: string, body: string): void {
-  const { execFile } = require('child_process');
-  execFile('powershell.exe', ['-NoProfile', '-Command', windowsToastScript(title, body)]);
-}
-
-function notify(title: string, body: string): void {
-  if (process.env.WT_SESSION) {
-    notifyWindows(title, body);
-  } else if (process.env.KITTY_WINDOW_ID) {
-    notifyOSC99(title, body);
-  } else {
-    notifyOSC777(title, body);
-  }
-}
-
-export default function (shortcut: ExtensionAPI) {
-  shortcut.on('agent_end', async () => {
-    notify('Pi', 'Ready for input');
-  });
-}
+/**
+ * Pi Notify Extension
+ *
+ * Sends a native terminal notification when Pi agent is done and waiting for input.
+ * Supports multiple terminal protocols:
+ * - OSC 777: Ghostty, iTerm2, WezTerm, rxvt-unicode
+ * - OSC 99: Kitty
+ * - Windows toast: Windows Terminal (WSL)
+ */
+
+import type { ExtensionAPI } from 'shortcutxl';
+
+function windowsToastScript(title: string, body: string): string {
+  const type = 'Windows.UI.Notifications';
+  const mgr = `[${type}.ToastNotificationManager, ${type}, ContentType = WindowsRuntime]`;
+  const template = `[${type}.ToastTemplateType]::ToastText01`;
+  const toast = `[${type}.ToastNotification]::new($xml)`;
+  return [
+    `${mgr} > $null`,
+    `$xml = [${type}.ToastNotificationManager]::GetTemplateContent(${template})`,
+    `$xml.GetElementsByTagName('text')[0].AppendChild($xml.CreateTextNode('${body}')) > $null`,
+    `[${type}.ToastNotificationManager]::CreateToastNotifier('${title}').Show(${toast})`
+  ].join('; ');
+}
+
+function notifyOSC777(title: string, body: string): void {
+  process.stdout.write(`\x1b]777;notify;${title};${body}\x07`);
+}
+
+function notifyOSC99(title: string, body: string): void {
+  // Kitty OSC 99: i=notification id, d=0 means not done yet, p=body for second part
+  process.stdout.write(`\x1b]99;i=1:d=0;${title}\x1b\\`);
+  process.stdout.write(`\x1b]99;i=1:p=body;${body}\x1b\\`);
+}
+
+function notifyWindows(title: string, body: string): void {
+  const { execFile } = require('child_process');
+  execFile('powershell.exe', ['-NoProfile', '-Command', windowsToastScript(title, body)]);
+}
+
+function notify(title: string, body: string): void {
+  if (process.env.WT_SESSION) {
+    notifyWindows(title, body);
+  } else if (process.env.KITTY_WINDOW_ID) {
+    notifyOSC99(title, body);
+  } else {
+    notifyOSC777(title, body);
+  }
+}
+
+export default function (shortcut: ExtensionAPI) {
+  shortcut.on('agent_end', async () => {
+    notify('Pi', 'Ready for input');
+  });
+}