shortcutxl 0.2.12 → 0.2.13

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

@@ -1,206 +1,206 @@
-import type { ExtensionAPI, ExtensionCommandContext } from 'shortcutxl';
-import {
-  complete,
-  Container,
-  DynamicBorder,
-  getMarkdownTheme,
-  getModel,
-  Markdown,
-  matchesKey,
-  Text
-} from 'shortcutxl';
-
-type ContentBlock = {
-  type?: string;
-  text?: string;
-  name?: string;
-  arguments?: Record<string, unknown>;
-};
-
-type SessionEntry = {
-  type: string;
-  message?: {
-    role?: string;
-    content?: unknown;
-  };
-};
-
-const extractTextParts = (content: unknown): string[] => {
-  if (typeof content === 'string') {
-    return [content];
-  }
-
-  if (!Array.isArray(content)) {
-    return [];
-  }
-
-  const textParts: string[] = [];
-  for (const part of content) {
-    if (!part || typeof part !== 'object') {
-      continue;
-    }
-
-    const block = part as ContentBlock;
-    if (block.type === 'text' && typeof block.text === 'string') {
-      textParts.push(block.text);
-    }
-  }
-
-  return textParts;
-};
-
-const extractToolCallLines = (content: unknown): string[] => {
-  if (!Array.isArray(content)) {
-    return [];
-  }
-
-  const toolCalls: string[] = [];
-  for (const part of content) {
-    if (!part || typeof part !== 'object') {
-      continue;
-    }
-
-    const block = part as ContentBlock;
-    if (block.type !== 'toolCall' || typeof block.name !== 'string') {
-      continue;
-    }
-
-    const args = block.arguments ?? {};
-    toolCalls.push(`Tool ${block.name} was called with args ${JSON.stringify(args)}`);
-  }
-
-  return toolCalls;
-};
-
-const buildConversationText = (entries: SessionEntry[]): string => {
-  const sections: string[] = [];
-
-  for (const entry of entries) {
-    if (entry.type !== 'message' || !entry.message?.role) {
-      continue;
-    }
-
-    const role = entry.message.role;
-    const isUser = role === 'user';
-    const isAssistant = role === 'assistant';
-
-    if (!isUser && !isAssistant) {
-      continue;
-    }
-
-    const entryLines: string[] = [];
-    const textParts = extractTextParts(entry.message.content);
-    if (textParts.length > 0) {
-      const roleLabel = isUser ? 'User' : 'Assistant';
-      const messageText = textParts.join('\n').trim();
-      if (messageText.length > 0) {
-        entryLines.push(`${roleLabel}: ${messageText}`);
-      }
-    }
-
-    if (isAssistant) {
-      entryLines.push(...extractToolCallLines(entry.message.content));
-    }
-
-    if (entryLines.length > 0) {
-      sections.push(entryLines.join('\n'));
-    }
-  }
-
-  return sections.join('\n\n');
-};
-
-const buildSummaryPrompt = (conversationText: string): string =>
-  [
-    'Summarize this conversation so I can resume it later.',
-    'Include goals, key decisions, progress, open questions, and next steps.',
-    'Keep it concise and structured with headings.',
-    '',
-    '<conversation>',
-    conversationText,
-    '</conversation>'
-  ].join('\n');
-
-const showSummaryUi = async (summary: string, ctx: ExtensionCommandContext) => {
-  if (!ctx.hasUI) {
-    return;
-  }
-
-  await ctx.ui.custom((_tui, theme, _kb, done) => {
-    const container = new Container();
-    const border = new DynamicBorder((s: string) => theme.fg('accent', s));
-    const mdTheme = getMarkdownTheme();
-
-    container.addChild(border);
-    container.addChild(new Text(theme.fg('accent', theme.bold('Conversation Summary')), 1, 0));
-    container.addChild(new Markdown(summary, 1, 1, mdTheme));
-    container.addChild(new Text(theme.fg('dim', 'Press Enter or Esc to close'), 1, 0));
-    container.addChild(border);
-
-    return {
-      render: (width: number) => container.render(width),
-      invalidate: () => container.invalidate(),
-      handleInput: (data: string) => {
-        if (matchesKey(data, 'enter') || matchesKey(data, 'escape')) {
-          done(undefined);
-        }
-      }
-    };
-  });
-};
-
-export default function (shortcut: ExtensionAPI) {
-  shortcut.registerCommand('summarize', {
-    description: 'Summarize the current conversation in a custom UI',
-    handler: async (_args, ctx) => {
-      const branch = ctx.sessionManager.getBranch();
-      const conversationText = buildConversationText(branch);
-
-      if (!conversationText.trim()) {
-        if (ctx.hasUI) {
-          ctx.ui.notify('No conversation text found', 'warning');
-        }
-        return;
-      }
-
-      if (ctx.hasUI) {
-        ctx.ui.notify('Preparing summary...', 'info');
-      }
-
-      const model = getModel('openai', 'gpt-5.2');
-      if (!model && ctx.hasUI) {
-        ctx.ui.notify('Model openai/gpt-5.2 not found', 'warning');
-      }
-
-      const apiKey = model ? await ctx.modelRegistry.getApiKey(model) : undefined;
-      if (!apiKey && ctx.hasUI) {
-        ctx.ui.notify('No API key for openai/gpt-5.2', 'warning');
-      }
-
-      if (!model || !apiKey) {
-        return;
-      }
-
-      const summaryMessages = [
-        {
-          role: 'user' as const,
-          content: [{ type: 'text' as const, text: buildSummaryPrompt(conversationText) }],
-          timestamp: Date.now()
-        }
-      ];
-
-      const response = await complete(
-        model,
-        { messages: summaryMessages },
-        { apiKey, reasoningEffort: 'high' }
-      );
-
-      const summary = response.content
-        .filter((c): c is { type: 'text'; text: string } => c.type === 'text')
-        .map((c) => c.text)
-        .join('\n');
-
-      await showSummaryUi(summary, ctx);
-    }
-  });
-}
+import type { ExtensionAPI, ExtensionCommandContext } from 'shortcutxl';
+import {
+  complete,
+  Container,
+  DynamicBorder,
+  getMarkdownTheme,
+  getModel,
+  Markdown,
+  matchesKey,
+  Text
+} from 'shortcutxl';
+
+type ContentBlock = {
+  type?: string;
+  text?: string;
+  name?: string;
+  arguments?: Record<string, unknown>;
+};
+
+type SessionEntry = {
+  type: string;
+  message?: {
+    role?: string;
+    content?: unknown;
+  };
+};
+
+const extractTextParts = (content: unknown): string[] => {
+  if (typeof content === 'string') {
+    return [content];
+  }
+
+  if (!Array.isArray(content)) {
+    return [];
+  }
+
+  const textParts: string[] = [];
+  for (const part of content) {
+    if (!part || typeof part !== 'object') {
+      continue;
+    }
+
+    const block = part as ContentBlock;
+    if (block.type === 'text' && typeof block.text === 'string') {
+      textParts.push(block.text);
+    }
+  }
+
+  return textParts;
+};
+
+const extractToolCallLines = (content: unknown): string[] => {
+  if (!Array.isArray(content)) {
+    return [];
+  }
+
+  const toolCalls: string[] = [];
+  for (const part of content) {
+    if (!part || typeof part !== 'object') {
+      continue;
+    }
+
+    const block = part as ContentBlock;
+    if (block.type !== 'toolCall' || typeof block.name !== 'string') {
+      continue;
+    }
+
+    const args = block.arguments ?? {};
+    toolCalls.push(`Tool ${block.name} was called with args ${JSON.stringify(args)}`);
+  }
+
+  return toolCalls;
+};
+
+const buildConversationText = (entries: SessionEntry[]): string => {
+  const sections: string[] = [];
+
+  for (const entry of entries) {
+    if (entry.type !== 'message' || !entry.message?.role) {
+      continue;
+    }
+
+    const role = entry.message.role;
+    const isUser = role === 'user';
+    const isAssistant = role === 'assistant';
+
+    if (!isUser && !isAssistant) {
+      continue;
+    }
+
+    const entryLines: string[] = [];
+    const textParts = extractTextParts(entry.message.content);
+    if (textParts.length > 0) {
+      const roleLabel = isUser ? 'User' : 'Assistant';
+      const messageText = textParts.join('\n').trim();
+      if (messageText.length > 0) {
+        entryLines.push(`${roleLabel}: ${messageText}`);
+      }
+    }
+
+    if (isAssistant) {
+      entryLines.push(...extractToolCallLines(entry.message.content));
+    }
+
+    if (entryLines.length > 0) {
+      sections.push(entryLines.join('\n'));
+    }
+  }
+
+  return sections.join('\n\n');
+};
+
+const buildSummaryPrompt = (conversationText: string): string =>
+  [
+    'Summarize this conversation so I can resume it later.',
+    'Include goals, key decisions, progress, open questions, and next steps.',
+    'Keep it concise and structured with headings.',
+    '',
+    '<conversation>',
+    conversationText,
+    '</conversation>'
+  ].join('\n');
+
+const showSummaryUi = async (summary: string, ctx: ExtensionCommandContext) => {
+  if (!ctx.hasUI) {
+    return;
+  }
+
+  await ctx.ui.custom((_tui, theme, _kb, done) => {
+    const container = new Container();
+    const border = new DynamicBorder((s: string) => theme.fg('accent', s));
+    const mdTheme = getMarkdownTheme();
+
+    container.addChild(border);
+    container.addChild(new Text(theme.fg('accent', theme.bold('Conversation Summary')), 1, 0));
+    container.addChild(new Markdown(summary, 1, 1, mdTheme));
+    container.addChild(new Text(theme.fg('dim', 'Press Enter or Esc to close'), 1, 0));
+    container.addChild(border);
+
+    return {
+      render: (width: number) => container.render(width),
+      invalidate: () => container.invalidate(),
+      handleInput: (data: string) => {
+        if (matchesKey(data, 'enter') || matchesKey(data, 'escape')) {
+          done(undefined);
+        }
+      }
+    };
+  });
+};
+
+export default function (shortcut: ExtensionAPI) {
+  shortcut.registerCommand('summarize', {
+    description: 'Summarize the current conversation in a custom UI',
+    handler: async (_args, ctx) => {
+      const branch = ctx.sessionManager.getBranch();
+      const conversationText = buildConversationText(branch);
+
+      if (!conversationText.trim()) {
+        if (ctx.hasUI) {
+          ctx.ui.notify('No conversation text found', 'warning');
+        }
+        return;
+      }
+
+      if (ctx.hasUI) {
+        ctx.ui.notify('Preparing summary...', 'info');
+      }
+
+      const model = getModel('openai', 'gpt-5.2');
+      if (!model && ctx.hasUI) {
+        ctx.ui.notify('Model openai/gpt-5.2 not found', 'warning');
+      }
+
+      const apiKey = model ? await ctx.modelRegistry.getApiKey(model) : undefined;
+      if (!apiKey && ctx.hasUI) {
+        ctx.ui.notify('No API key for openai/gpt-5.2', 'warning');
+      }
+
+      if (!model || !apiKey) {
+        return;
+      }
+
+      const summaryMessages = [
+        {
+          role: 'user' as const,
+          content: [{ type: 'text' as const, text: buildSummaryPrompt(conversationText) }],
+          timestamp: Date.now()
+        }
+      ];
+
+      const response = await complete(
+        model,
+        { messages: summaryMessages },
+        { apiKey, reasoningEffort: 'high' }
+      );
+
+      const summary = response.content
+        .filter((c): c is { type: 'text'; text: string } => c.type === 'text')
+        .map((c) => c.text)
+        .join('\n');
+
+      await showSummaryUi(summary, ctx);
+    }
+  });
+}

package/agent-docs/examples/extensions/system-prompt-header.ts

@@ -1,17 +1,17 @@
-/**
- * Displays a status widget showing the system prompt length.
- *
- * Demonstrates ctx.getSystemPrompt() for accessing the effective system prompt.
- */
-import type { ExtensionAPI } from 'shortcutxl';
-
-export default function (shortcut: ExtensionAPI) {
-  shortcut.on('agent_start', (_event, ctx) => {
-    const prompt = ctx.getSystemPrompt();
-    ctx.ui.setStatus('system-prompt', `System: ${prompt.length} chars`);
-  });
-
-  shortcut.on('session_shutdown', (_event, ctx) => {
-    ctx.ui.setStatus('system-prompt', undefined);
-  });
-}
+/**
+ * Displays a status widget showing the system prompt length.
+ *
+ * Demonstrates ctx.getSystemPrompt() for accessing the effective system prompt.
+ */
+import type { ExtensionAPI } from 'shortcutxl';
+
+export default function (shortcut: ExtensionAPI) {
+  shortcut.on('agent_start', (_event, ctx) => {
+    const prompt = ctx.getSystemPrompt();
+    ctx.ui.setStatus('system-prompt', `System: ${prompt.length} chars`);
+  });
+
+  shortcut.on('session_shutdown', (_event, ctx) => {
+    ctx.ui.setStatus('system-prompt', undefined);
+  });
+}

package/agent-docs/examples/extensions/timed-confirm.ts

@@ -1,72 +1,72 @@
-/**
- * Example extension demonstrating timed dialogs with live countdown.
- *
- * Commands:
- * - /timed - Shows confirm dialog that auto-cancels after 5 seconds with countdown
- * - /timed-select - Shows select dialog that auto-cancels after 10 seconds with countdown
- * - /timed-signal - Shows confirm using AbortSignal (manual approach)
- */
-
-import type { ExtensionAPI } from 'shortcutxl';
-
-export default function (shortcut: ExtensionAPI) {
-  // Simple approach: use timeout option (recommended)
-  shortcut.registerCommand('timed', {
-    description: 'Show a timed confirmation dialog (auto-cancels in 5s with countdown)',
-    handler: async (_args, ctx) => {
-      const confirmed = await ctx.ui.confirm(
-        'Timed Confirmation',
-        'This dialog will auto-cancel in 5 seconds. Confirm?',
-        { timeout: 5000 }
-      );
-
-      if (confirmed) {
-        ctx.ui.notify('Confirmed by user!', 'info');
-      } else {
-        ctx.ui.notify('Cancelled or timed out', 'info');
-      }
-    }
-  });
-
-  shortcut.registerCommand('timed-select', {
-    description: 'Show a timed select dialog (auto-cancels in 10s with countdown)',
-    handler: async (_args, ctx) => {
-      const choice = await ctx.ui.select('Pick an option', ['Option A', 'Option B', 'Option C'], {
-        timeout: 10000
-      });
-
-      if (choice) {
-        ctx.ui.notify(`Selected: ${choice}`, 'info');
-      } else {
-        ctx.ui.notify('Selection cancelled or timed out', 'info');
-      }
-    }
-  });
-
-  // Manual approach: use AbortSignal for more control
-  shortcut.registerCommand('timed-signal', {
-    description: 'Show a timed confirm using AbortSignal (manual approach)',
-    handler: async (_args, ctx) => {
-      const controller = new AbortController();
-      const timeoutId = setTimeout(() => controller.abort(), 5000);
-
-      ctx.ui.notify('Dialog will auto-cancel in 5 seconds...', 'info');
-
-      const confirmed = await ctx.ui.confirm(
-        'Timed Confirmation',
-        'This dialog will auto-cancel in 5 seconds. Confirm?',
-        { signal: controller.signal }
-      );
-
-      clearTimeout(timeoutId);
-
-      if (confirmed) {
-        ctx.ui.notify('Confirmed by user!', 'info');
-      } else if (controller.signal.aborted) {
-        ctx.ui.notify('Dialog timed out (auto-cancelled)', 'warning');
-      } else {
-        ctx.ui.notify('Cancelled by user', 'info');
-      }
-    }
-  });
-}
+/**
+ * Example extension demonstrating timed dialogs with live countdown.
+ *
+ * Commands:
+ * - /timed - Shows confirm dialog that auto-cancels after 5 seconds with countdown
+ * - /timed-select - Shows select dialog that auto-cancels after 10 seconds with countdown
+ * - /timed-signal - Shows confirm using AbortSignal (manual approach)
+ */
+
+import type { ExtensionAPI } from 'shortcutxl';
+
+export default function (shortcut: ExtensionAPI) {
+  // Simple approach: use timeout option (recommended)
+  shortcut.registerCommand('timed', {
+    description: 'Show a timed confirmation dialog (auto-cancels in 5s with countdown)',
+    handler: async (_args, ctx) => {
+      const confirmed = await ctx.ui.confirm(
+        'Timed Confirmation',
+        'This dialog will auto-cancel in 5 seconds. Confirm?',
+        { timeout: 5000 }
+      );
+
+      if (confirmed) {
+        ctx.ui.notify('Confirmed by user!', 'info');
+      } else {
+        ctx.ui.notify('Cancelled or timed out', 'info');
+      }
+    }
+  });
+
+  shortcut.registerCommand('timed-select', {
+    description: 'Show a timed select dialog (auto-cancels in 10s with countdown)',
+    handler: async (_args, ctx) => {
+      const choice = await ctx.ui.select('Pick an option', ['Option A', 'Option B', 'Option C'], {
+        timeout: 10000
+      });
+
+      if (choice) {
+        ctx.ui.notify(`Selected: ${choice}`, 'info');
+      } else {
+        ctx.ui.notify('Selection cancelled or timed out', 'info');
+      }
+    }
+  });
+
+  // Manual approach: use AbortSignal for more control
+  shortcut.registerCommand('timed-signal', {
+    description: 'Show a timed confirm using AbortSignal (manual approach)',
+    handler: async (_args, ctx) => {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 5000);
+
+      ctx.ui.notify('Dialog will auto-cancel in 5 seconds...', 'info');
+
+      const confirmed = await ctx.ui.confirm(
+        'Timed Confirmation',
+        'This dialog will auto-cancel in 5 seconds. Confirm?',
+        { signal: controller.signal }
+      );
+
+      clearTimeout(timeoutId);
+
+      if (confirmed) {
+        ctx.ui.notify('Confirmed by user!', 'info');
+      } else if (controller.signal.aborted) {
+        ctx.ui.notify('Dialog timed out (auto-cancelled)', 'warning');
+      } else {
+        ctx.ui.notify('Cancelled by user', 'info');
+      }
+    }
+  });
+}