shortcutxl 0.2.19 → 0.2.21

package/agent-docs/examples/extensions/built-in-tool-renderer.ts

@@ -23,19 +23,8 @@
  *   shortcut -e ./built-in-tool-renderer.ts
  */
 
-import type {
-  BashToolDetails,
-  EditToolDetails,
-  ExtensionAPI,
-  ReadToolDetails
-} from 'shortcutxl';
-import {
-  createBashTool,
-  createEditTool,
-  createReadTool,
-  createWriteTool,
-  Text
-} from 'shortcutxl';
+import type { BashToolDetails, EditToolDetails, ExtensionAPI, ReadToolDetails } from 'shortcutxl';
+import { createBashTool, createEditTool, createReadTool, createWriteTool, Text } from 'shortcutxl';
 
 export default function (shortcut: ExtensionAPI) {
   const cwd = process.cwd();

package/agent-docs/examples/extensions/claude-code.ts

@@ -0,0 +1,69 @@
+/**
+ * Claude Code CLI Extension
+ *
+ * Registers a tool that runs prompts through the Claude Code CLI.
+ * Pipes the prompt via stdin to avoid shell escaping issues.
+ *
+ * Requirements:
+ *   - Claude Code CLI installed and on PATH (`claude`)
+ */
+
+import { spawn } from "node:child_process";
+import type { ExtensionAPI } from "shortcutxl";
+import { Type } from "@sinclair/typebox";
+
+export default function (shortcut: ExtensionAPI) {
+  shortcut.registerTool({
+    name: "claude_code",
+    label: "Claude Code",
+    description:
+      "Run a prompt through the Claude Code CLI (claude). Use for complex coding tasks, multi-file edits, research, or any task that benefits from a separate agentic coding session. The CLI has full filesystem and shell access. Returns Claude Code's text output.",
+    parameters: Type.Object({
+      prompt: Type.String({ description: "The prompt/instruction to send to Claude Code CLI" }),
+      cwd: Type.Optional(
+        Type.String({ description: "Working directory for the command. Defaults to current directory." })
+      ),
+    }),
+    async execute(_toolCallId, params, signal) {
+      const { prompt, cwd } = params;
+
+      return new Promise((resolve) => {
+        const child = spawn("bash", ["-c", "claude -p --output-format text"], {
+          cwd: cwd || process.cwd(),
+          stdio: ["pipe", "pipe", "pipe"],
+        });
+
+        // Pipe prompt via stdin to avoid shell escaping
+        child.stdin.write(prompt);
+        child.stdin.end();
+
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (d: Buffer) => { stdout += d.toString(); });
+        child.stderr.on("data", (d: Buffer) => { stderr += d.toString(); });
+
+        const timer = setTimeout(() => child.kill(), 300_000);
+        const onAbort = () => { child.kill(); clearTimeout(timer); };
+        signal?.addEventListener("abort", onAbort, { once: true });
+
+        child.on("close", (code) => {
+          clearTimeout(timer);
+          signal?.removeEventListener("abort", onAbort);
+
+          if (code !== 0 && !stdout.trim()) {
+            resolve({
+              content: [{ type: "text", text: `Exit code ${code}\n${stderr}` }],
+              details: { error: true },
+            });
+          } else {
+            const output = stdout.trim() + (stderr.trim() ? `\n[stderr]: ${stderr.trim()}` : "");
+            resolve({
+              content: [{ type: "text", text: output || "(no output)" }],
+              details: {},
+            });
+          }
+        });
+      });
+    },
+  });
+}

package/agent-docs/examples/extensions/custom-provider-gitlab-duo/test.ts

@@ -11,13 +11,7 @@
 import { readFileSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
-import {
-  type Api,
-  type Context,
-  type Model,
-  registerApiProvider,
-  streamSimple
-} from 'shortcutxl';
+import { type Api, type Context, type Model, registerApiProvider, streamSimple } from 'shortcutxl';
 import { MODELS, streamGitLabDuo } from './index.js';
 
 const MODEL_MAP = new Map(MODELS.map((m) => [m.id, m]));

package/agent-docs/examples/sdk/04-skills.ts

@@ -5,12 +5,7 @@
  * Discover, filter, merge, or replace them.
  */
 
-import {
-  createAgentSession,
-  DefaultResourceLoader,
-  SessionManager,
-  type Skill
-} from 'shortcutxl';
+import { createAgentSession, DefaultResourceLoader, SessionManager, type Skill } from 'shortcutxl';
 
 // Or define custom skills inline
 const customSkill: Skill = {

package/dist/cli/config-selector.js

@@ -1,9 +1,9 @@
 /**
  * TUI config selector for `pi config` command
  */
-import { ProcessTerminal, TUI } from '../tui/index.js';
 import { initTheme, stopThemeWatcher } from '../core/theme.js';
 import { ConfigSelectorComponent } from '../modes/interactive/components/config-selector.js';
+import { ProcessTerminal, TUI } from '../tui/index.js';
 /** Show TUI config selector and return when closed */
 export async function selectConfig(options) {
     // Initialize theme before showing TUI

package/dist/cli/session-picker.js

@@ -1,9 +1,9 @@
 /**
  * TUI session selector for --resume flag
  */
-import { ProcessTerminal, TUI } from '../tui/index.js';
 import { KeybindingsManager } from '../core/keybindings.js';
 import { SessionSelectorComponent } from '../modes/interactive/components/session-selector.js';
+import { ProcessTerminal, TUI } from '../tui/index.js';
 /** Show TUI session selector and return selected session path or null if cancelled */
 export async function selectSession(currentSessionsLoader, allSessionsLoader) {
     return new Promise((resolve) => {

package/dist/config.js

@@ -182,6 +182,20 @@ export const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;
 // -- Sandbox defaults ------------------------------------------------------
 /** Default sandbox network mode. 'proxy' gives domain-level control with user approval. */
 export const DEFAULT_SANDBOX_NETWORK = 'proxy';
+/** Whether the new headless sheet engine is enabled. Env var takes precedence over settings.json. */
+export function isNewSheetEnabled() {
+    if (process.env.SHORTCUT_NEW_SHEET === '1')
+        return true;
+    try {
+        const raw = readFileSync(getSettingsPath(), 'utf-8');
+        const settings = JSON.parse(raw);
+        return settings.newSheet === true;
+    }
+    catch {
+        // No settings file or invalid JSON — default off
+    }
+    return false;
+}
 // -- Package & update URLs -------------------------------------------------
 /** npm registry URL for version checks. */
 export const NPM_REGISTRY_URL = `https://registry.npmjs.org/${NPM_PACKAGE_NAME}/latest`;
@@ -278,10 +292,6 @@ export function getWslDir() {
 export function getAlpineRootfsPath() {
     return join(getPackageDir(), 'wsl', 'alpine-minirootfs.tar.gz');
 }
-/** Get path to persistent pip packages directory (mounted rw into sandbox) */
-export function getPipPackagesDir() {
-    return join(getAgentDir(), 'pip-packages');
-}
 /** Get path to debug log file */
 export function getDebugLogPath() {
     return join(getAgentDir(), `${APP_NAME}-debug.log`);
@@ -296,7 +306,7 @@ export function isInstalled() {
 }
 /** Get path to ShortcutXL.xll (stable user-local copy at ~/.shortcut/agent/xll/). */
 export function getXllPath() {
-    return join(getAgentDir(), "xll", "ShortcutXL.xll");
+    return join(getAgentDir(), 'xll', 'ShortcutXL.xll');
 }
 /** Get path to the embedded Python directory (shipped with the npm package). */
 export function getEmbeddedPythonDir() {

package/dist/core/agent-loop.js

@@ -6,7 +6,6 @@
  * all tools complete, not between each tool.
  */
 import { EventStream, streamSimple, validateToolArguments } from '@mariozechner/pi-ai';
-import { LoginRequiredError } from './agent-session.js';
 import { ABORT_AGENT_MESSAGE } from './abort.js';
 import { DEFAULT_MAX_CHARS, ERROR_MAX_CHARS_LLM, truncateOutput } from './tools/truncate.js';
 /** Yield to the event loop every N stream events to prevent microtask starvation. */
@@ -100,7 +99,9 @@ async function runLoop(currentContext, newMessages, config, signal, stream, stre
                 // retries give the LLM useful context instead of an empty message.
                 // Skip for aborts: user-initiated cancellations are handled by the UI
                 // abort label and don't need "[Request failed: ...]" injected.
-                if (message.stopReason !== 'aborted' && message.content.length === 0 && message.errorMessage) {
+                if (message.stopReason !== 'aborted' &&
+                    message.content.length === 0 &&
+                    message.errorMessage) {
                     message.content.push({
                         type: 'text',
                         text: `[Request failed: ${message.errorMessage.slice(0, ERROR_MAX_CHARS_LLM)}]`
@@ -286,25 +287,23 @@ async function streamAssistantResponse(context, config, signal, stream, streamFn
  * currentContext.messages needs cleanup on retry.
  */
 async function handleAuthRetry(message, currentContext, config, signal, stream, streamFn) {
-    const is401 = message.stopReason === 'error' &&
-        message.errorMessage?.includes('LLM proxy error 401:');
+    const is401 = message.stopReason === 'error' && message.errorMessage?.includes('LLM proxy error 401:');
     if (is401 && config.onAuthError && config.getApiKey) {
         // Remove the failed message from context (not yet in newMessages)
         currentContext.messages.pop();
         config.onAuthError(config.model.provider);
         // getApiKey will now see the token as expired and refresh it
+        // Refresh the token — swallow errors; the retry will surface them if it still fails
         try {
             await config.getApiKey(config.model.provider);
         }
-        catch (e) {
-            if (!(e instanceof LoginRequiredError))
-                throw e;
+        catch {
+            // Token refresh failed — the retry below will produce a user-friendly error
         }
         message = await streamAssistantResponse(currentContext, config, signal, stream, streamFn);
     }
     // Rewrite raw 401 errors to a user-friendly message
-    if (message.stopReason === 'error' &&
-        message.errorMessage?.includes('LLM proxy error 401:')) {
+    if (message.stopReason === 'error' && message.errorMessage?.includes('LLM proxy error 401:')) {
         const rawError = message.errorMessage;
         message.errorMessage = `Session expired. Run /login to re-authenticate. Raw error: ${rawError}`;
     }