shortcutxl 0.3.53 → 0.3.55

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.3.55]
+
+- **Improved error handling** - Improved error handling.
+
+## [0.3.54]
+
+- **Skill selector rendering** - Skill source and visibility selectors now stay within narrow Windows terminal widths.
+
 ## [0.3.53]
 
 - **Enterprise MCP OAuth fixes** - Hosted enterprise MCP servers now handle OAuth discovery and proxied requests more reliably.
@@ -140,7 +148,7 @@
 - **Connections** — Connect external data sources via `/connect`. Supports databases (Snowflake, Postgres, Oracle, MySQL), SaaS APIs (Salesforce, Notion, HubSpot, Airtable), and cloud drives. Credentials are stored in the OS keychain.
 - **Skill sync** — Download shared skills from the cloud with `/download-skills`.
 - **Skill creator** — A built-in eval-driven workflow for authoring, testing, and improving custom skills.
-- **Fixed local install issues** — Resolved a shell path bug that could prevent the CLI from launching after a global npm install.
+- **Fixed local install issues** — Resolved a shell path bug that could prevent the CLI from launching after a global package-manager install.
 
 ## [0.2.22]
 

package/agent-docs/docs/development.md

@@ -7,8 +7,8 @@ See [AGENTS.md](../../../AGENTS.md) for additional guidelines.
 ```bash
 git clone https://github.com/badlogic/pi-mono
 cd pi-mono
-npm install
-npm run build
+pnpm install
+pnpm run build
 ```
 
 Run from source:
@@ -34,7 +34,7 @@ Change `name`, `configDir`, and `bin` field for your fork. Affects CLI banner, c
 
 ## Path Resolution
 
-Three execution modes: npm install, standalone binary, tsx from source.
+Three execution modes: pnpm install, standalone binary, tsx from source.
 
 **Always use `src/config.ts`** for package assets:
 
@@ -54,8 +54,8 @@ Never use `__dirname` directly for package assets.
 
 ```bash
 ./test.sh                         # Run non-LLM tests (no API keys needed)
-npm test                          # Run all tests
-npm test -- test/specific.test.ts # Run specific test
+pnpm test                          # Run all tests
+pnpm test -- test/specific.test.ts # Run specific test
 ```
 
 ## Project Structure

package/agent-docs/docs/extensions.md

@@ -139,7 +139,7 @@ To share extensions via npm or git as Shortcut packages, see [packages.md](packa
 | `shortcutxl/tui`      | TUI components for custom rendering                            |
 | `shortcutxl/shell`    | Shell-owned render helpers and components                      |
 
-npm dependencies work too. Add a `package.json` next to your extension (or in a parent directory), run `npm install`, and imports from `node_modules/` are resolved automatically.
+npm dependencies work too. Add a `package.json` next to your extension (or in a parent directory), run `pnpm install`, and imports from `node_modules/` are resolved automatically.
 
 Node.js built-ins (`node:fs`, `node:path`, etc.) are also available.
 
@@ -191,8 +191,8 @@ Extensions are loaded via [jiti](https://github.com/unjs/jiti), so TypeScript wo
 ~/.shortcut/agent/extensions/
 └── my-extension/
     ├── package.json    # Declares dependencies and entry points
-    ├── package-lock.json
-    ├── node_modules/   # After npm install
+    ├── pnpm-lock.yaml
+    ├── node_modules/   # After pnpm install
     └── src/
         └── index.ts
 ```
@@ -211,7 +211,7 @@ Extensions are loaded via [jiti](https://github.com/unjs/jiti), so TypeScript wo
 }
 ```
 
-Run `npm install` in the extension directory, then imports from `node_modules/` work automatically.
+Run `pnpm install` in the extension directory, then imports from `node_modules/` work automatically.
 
 ## Events
 

package/agent-docs/docs/packages.md

@@ -52,7 +52,7 @@ npm:pkg
 ```
 
 - Versioned specs are pinned and skipped by `shortcut update`.
-- Global installs use `npm install -g`.
+- Global installs use `pnpm add -g`.
 - Project installs go under `.shortcut/npm/`.
 
 ### git
@@ -71,7 +71,7 @@ ssh://git@github.com/user/repo@v1
 - For non-interactive runs (for example CI), you can set `GIT_TERMINAL_PROMPT=0` to disable credential prompts and set `GIT_SSH_COMMAND` (for example `ssh -o BatchMode=yes -o ConnectTimeout=5`) to fail fast.
 - Refs pin the package and skip `shortcut update`.
 - Cloned to `~/.shortcut/agent/git/<host>/<path>` (global) or `.shortcut/git/<host>/<path>` (project).
-- Runs `npm install` after clone or pull if `package.json` exists.
+- Runs `pnpm install` after clone or pull if `package.json` exists.
 
 **SSH examples:**
 ```bash
@@ -147,7 +147,7 @@ If no `shortcut` manifest is present, Shortcut auto-discovers resources from the
 
 ## Dependencies
 
-Third party runtime dependencies belong in `dependencies` in `package.json`. Dependencies that do not register extensions, skills, prompt templates, or themes also belong in `dependencies`. When Shortcut installs a package from npm or git, it runs `npm install`, so those dependencies are installed automatically.
+Third party runtime dependencies belong in `dependencies` in `package.json`. Dependencies that do not register extensions, skills, prompt templates, or themes also belong in `dependencies`. When Shortcut installs a package from npm or git, it runs `pnpm install`, so those dependencies are installed automatically.
 
 Shortcut bundles core packages for extensions and skills. If you import any of these, list them in `peerDependencies` with a `"*"` range and do not bundle them: `shortcutxl`, `@sinclair/typebox`.
 

package/agent-docs/docs/skills.md

@@ -115,7 +115,7 @@ description: What this skill does and when to use it. Be specific.
 
 Run once before first use:
 \`\`\`bash
-cd /path/to/skill && npm install
+cd /path/to/skill && pnpm install
 \`\`\`
 
 ## Usage
@@ -209,7 +209,7 @@ description: Web search and content extraction via Brave Search API. Use for sea
 ## Setup
 
 \`\`\`bash
-cd /path/to/brave-search && npm install
+cd /path/to/brave-search && pnpm install
 \`\`\`
 
 ## Search

package/agent-docs/docs/tui.md

@@ -459,20 +459,20 @@ SHORTCUT_TUI_RENDER_TRACE=C:\temp\shortcut-tui.jsonl SHORTCUT_TUI_RENDER_TRACE_F
 Set `SHORTCUT_TUI_WRITE_LOG` to capture the raw ANSI stream written to stdout.
 
 ```bash
-SHORTCUT_TUI_WRITE_LOG=/tmp/tui-ansi.log npx tsx packages/tui/test/chat-simple.ts
+SHORTCUT_TUI_WRITE_LOG=/tmp/tui-ansi.log pnpm exec tsx packages/tui/test/chat-simple.ts
 ```
 
 Summarize a captured trace with:
 
 ```bash
-npm run analyze:tui-trace -- C:\temp\shortcut-tui.jsonl
-npm run analyze:tui-trace -- C:\temp\shortcut-tui.jsonl --json
+pnpm run analyze:tui-trace -- C:\temp\shortcut-tui.jsonl
+pnpm run analyze:tui-trace -- C:\temp\shortcut-tui.jsonl --json
 ```
 
 For deterministic repro coverage, run the PTY render matrix:
 
 ```bash
-npm run test:pty -- tests/interactive/tui-render-matrix/tui-render-matrix.pty.test.ts
+pnpm run test:pty -- tests/interactive/tui-render-matrix/tui-render-matrix.pty.test.ts
 ```
 
 ## Performance

package/agent-docs/examples/extensions/custom-provider-anthropic/index.ts

@@ -10,7 +10,7 @@
  *
  * Usage:
  *   # First install dependencies
- *   cd packages/coding-agent/examples/extensions/custom-provider && npm install
+ *   cd packages/coding-agent/examples/extensions/custom-provider && pnpm install
  *
  *   # With OAuth (run /login custom-anthropic first)
  *   shortcut -e ./packages/coding-agent/examples/extensions/custom-provider

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

@@ -1,11 +1,11 @@
 /**
  * Test script for GitLab Duo extension
- * Run: npx tsx test.ts [model-id] [--thinking]
+ * Run: pnpm exec tsx test.ts [model-id] [--thinking]
  *
  * Examples:
- *   npx tsx test.ts                              # Test default (claude-sonnet-4-5-20250929)
- *   npx tsx test.ts gpt-5-codex                  # Test GPT-5 Codex
- *   npx tsx test.ts claude-sonnet-4-5-20250929 --thinking
+ *   pnpm exec tsx test.ts                              # Test default (claude-sonnet-4-5-20250929)
+ *   pnpm exec tsx test.ts gpt-5-codex                  # Test GPT-5 Codex
+ *   pnpm exec tsx test.ts claude-sonnet-4-5-20250929 --thinking
  */
 
 import { readFileSync } from 'fs';

package/agent-docs/examples/extensions/sandbox/index.ts

@@ -32,7 +32,7 @@
  *
  * Setup:
  * 1. Copy sandbox/ directory to ~/.shortcut/agent/extensions/
- * 2. Run `npm install` in ~/.shortcut/agent/extensions/sandbox/
+ * 2. Run `pnpm install` in ~/.shortcut/agent/extensions/sandbox/
  *
  * Linux also requires: bubblewrap, socat, ripgrep
  */

package/agent-docs/examples/extensions/with-deps/index.ts

@@ -2,7 +2,7 @@
  * Example extension with its own npm dependencies.
  * Tests that jiti resolves modules from the extension's own node_modules.
  *
- * Requires: npm install in this directory
+ * Requires: pnpm install in this directory
  */
 
 import { Type } from '@sinclair/typebox';

package/agent-docs/examples/rpc-extension-ui.ts

@@ -5,7 +5,7 @@
  * Demonstrates how to build a custom UI on top of the RPC protocol,
  * including handling extension UI requests (select, confirm, input, editor).
  *
- * Usage: npx tsx examples/rpc-extension-ui.ts
+ * Usage: pnpm exec tsx examples/rpc-extension-ui.ts
  *
  * Slash commands:
  *   /select  - demo select dialog

package/agent-docs/examples/sdk/08-prompt-templates.ts

@@ -19,9 +19,9 @@ const deployTemplate: PromptTemplate = {
   filePath: '/virtual/prompts/deploy.md',
   content: `# Deploy Instructions
 
-1. Build: npm run build
-2. Test: npm test
-3. Deploy: npm run deploy`
+1. Build: pnpm run build
+2. Test: pnpm test
+3. Deploy: pnpm run deploy`
 };
 
 const loader = new DefaultResourceLoader({

package/agent-docs/examples/sdk/README.md

@@ -23,7 +23,7 @@ Programmatic usage of `shortcutxl/app` via `createAgentSession()`.
 
 ```bash
 cd packages/coding-agent
-npx tsx examples/sdk/01-minimal.ts
+pnpm exec tsx examples/sdk/01-minimal.ts
 ```
 
 ## Quick Reference

package/dist/app/agent-session.d.ts

@@ -165,6 +165,7 @@ export declare class AgentSession {
     private _autonomousState;
     private _turnIndex;
     private _persistence;
+    private _pendingImmediateRunAgentMetadata?;
     private _resourceLoader;
     private _prePromptContext?;
     /** Details from the last prePromptContext call (e.g. { workbooks: string[] }). Read by TUI for annotations. */

package/dist/app/agent-session.js

@@ -12,10 +12,11 @@
  *
  * Modes use this class and add their own I/O layer on top.
  */
-import { isContextOverflow } from '@mariozechner/pi-ai';
 import { SessionState } from '../core/session-state.js';
 import { createCompactionActions, createErrorRecoveryActions, triggerCompactionIfNeeded } from '../core/session/compaction-bridge.js';
+import { isContextOverflow } from '../core/session/context-overflow.js';
 import { SessionCompaction } from '../core/session/session-compaction.js';
+import { classifyError, SessionErrorRecovery } from '../core/session/session-error-recovery.js';
 import { isShortcutFastModeModel } from '../model-ids.js';
 import { formatFileUploadsContext, mergeFileUploads } from './file-uploads.js';
 import { expandPromptTemplate } from './resources/prompt-template-expansion.js';
@@ -31,8 +32,8 @@ import { formatRuntimePermissionBypassReminder } from './session/permission-cont
 import { PersistenceHandler } from './session/persistence-handler.js';
 import { assertNotExtensionCommand, buildMessageContent, normalizeUserContent, tryExtensionCommand } from './session/prompt-pipeline.js';
 import { QueueTracker } from './session/queue-tracker.js';
+import { buildRunAgentMetadata, emitRunAgent, summarizeDeliveredUserContent } from './session/run-agent-observability.js';
 import { SessionBudgetContinuation } from './session/session-budget-continuation.js';
-import { classifyError, SessionErrorRecovery } from './session/session-error-recovery.js';
 import { executeNewSession, executeSwitchSession } from './session/session-lifecycle.js';
 import { getAvailableThinkingLevels, supportsThinking, supportsXhighThinking } from './session/session-models.js';
 import { computeContextUsage, computeSessionStats } from './session/session-stats.js';
@@ -85,6 +86,7 @@ export class AgentSession {
     // Event pipeline
     _turnIndex = 0; // shared counter — passed to both extension emitter and persistence
     _persistence = new PersistenceHandler();
+    _pendingImmediateRunAgentMetadata;
     _resourceLoader;
     _prePromptContext;
     /** Details from the last prePromptContext call (e.g. { workbooks: string[] }). Read by TUI for annotations. */
@@ -123,7 +125,7 @@ export class AgentSession {
         this.sessionManager = config.sessionManager;
         this.settingsManager = config.settingsManager;
         this.approvalState = config.approvalState;
-        this._compaction = new SessionCompaction(config.compactionComplete);
+        this._compaction = new SessionCompaction({ complete: config.compactionComplete });
         this._resourceLoader = config.resourceLoader;
         this._modelRegistry = config.modelRegistry;
         this._prePromptContext = config.prePromptContext;
@@ -202,7 +204,6 @@ export class AgentSession {
         this._compactionActions = createCompactionActions({
             extensionRunner: () => this._extensions.extensionRunner,
             sessionManager: this.sessionManager,
-            settingsManager: this.settingsManager,
             agent: this.agent,
             removeLastErrorGroup: () => this._removeLastErrorGroup()
         });
@@ -210,7 +211,6 @@ export class AgentSession {
             model: () => this.model,
             modelRegistry: this._modelRegistry,
             sessionManager: this.sessionManager,
-            settingsManager: this.settingsManager,
             compaction: this._compaction,
             compactionActions: this._compactionActions,
             agent: this.agent
@@ -220,7 +220,6 @@ export class AgentSession {
             model: () => this.model,
             modelRegistry: this._modelRegistry,
             sessionManager: this.sessionManager,
-            settingsManager: this.settingsManager,
             compaction: this._compaction,
             compactionActions: () => this._compactionActions,
             removeLastErrorGroup: () => this._removeLastErrorGroup(),
@@ -337,6 +336,31 @@ export class AgentSession {
     async _processAgentLoopEvent(event) {
         // --- Step 1: Queue tracking (sync) ---
         this._queueTracker.handle(event);
+        if (event.type === 'message_start' && event.message.role === 'user') {
+            const deliveredContent = summarizeDeliveredUserContent(event.message.content);
+            const pendingMetadata = this._pendingImmediateRunAgentMetadata;
+            const conversationId = this.sessionManager.getSessionId();
+            const userMessageId = typeof event.message.id === 'string' && event.message.id.length > 0
+                ? event.message.id
+                : undefined;
+            this._pendingImmediateRunAgentMetadata = undefined;
+            emitRunAgent(this._observability, {
+                ...(pendingMetadata ??
+                    buildRunAgentMetadata({
+                        charCount: deliveredContent.charCount,
+                        imageCount: deliveredContent.imageCount,
+                        conversationId,
+                        userMessageId
+                    })),
+                conversationId,
+                thread_id: conversationId,
+                platform: 'cli',
+                char_count: deliveredContent.charCount,
+                message_length: deliveredContent.charCount,
+                image_count: deliveredContent.imageCount,
+                ...(userMessageId ? { user_message_id: userMessageId, turnId: userMessageId } : {})
+            });
+        }
         // --- Step 2: Extensions (async — must complete before persistence) ---
         // Reset turnIndex on agent_start BEFORE the snapshot so extensions see 0.
         if (event.type === 'agent_start') {
@@ -434,8 +458,12 @@ export class AgentSession {
                     if (didRecover)
                         return;
                 }
-                // Threshold compaction for non-error responses (overflow is handled by error recovery)
-                await this._triggerCompactionIfNeeded(lastAssistant, true);
+                // Threshold compaction for non-error responses (overflow is handled by error recovery).
+                // Auto-compaction now rejects on failure (timeout / model error / persist error) so
+                // that heartbeat emits a compaction_failed/timeout OpEnd row to ClickHouse with the
+                // real error message. The failure is already on the auto_compaction_end session event
+                // by the time the rejection lands here, so the agent_end hook must not crash.
+                await this._triggerCompactionIfNeeded(lastAssistant, true).catch(() => undefined);
             }
         }
     }
@@ -805,10 +833,13 @@ export class AgentSession {
         if (!apiKey) {
             throw new LoginRequiredError();
         }
-        // Check if we need to compact before sending (catches aborted responses)
+        // Check if we need to compact before sending (catches aborted responses).
+        // See parallel call above re: swallowing — auto-compaction now rejects on failure
+        // for telemetry purposes; the failure is already on the session event so the
+        // pre-submit path must not abort here.
         const lastAssistant = this._findLastAssistantMessage();
         if (lastAssistant) {
-            await this._triggerCompactionIfNeeded(lastAssistant, false);
+            await this._triggerCompactionIfNeeded(lastAssistant, false).catch(() => undefined);
         }
         // Build messages array (custom message if any, then user message)
         const messages = [];
@@ -836,7 +867,9 @@ export class AgentSession {
         if (currentImages) {
             userContent.push(...currentImages);
         }
+        const userMessageId = globalThis.crypto.randomUUID();
         messages.push({
+            id: userMessageId,
             role: 'user',
             content: userContent,
             timestamp: Date.now()
@@ -878,19 +911,30 @@ export class AgentSession {
         }
         this._budgetContinuation.beginPromptRun(parsedBudget?.budgetTokens);
         const workbookDetails = this.lastPrePromptDetails;
+        const promptMetadata = buildRunAgentMetadata({
+            charCount: expandedText.length,
+            imageCount: currentImages?.length ?? 0,
+            conversationId: this.sessionManager.getSessionId(),
+            workbookDetails,
+            userMessageId
+        });
+        this._pendingImmediateRunAgentMetadata = promptMetadata;
         this._observability?.info?.({
             module: 'ui',
             event: 'prompt_submitted',
-            data: {
-                char_count: expandedText.length,
-                image_count: currentImages?.length ?? 0,
-                has_workbook_context: Boolean(workbookDetails),
-                workbook_count: workbookDetails?.workbooks?.length ?? 0,
-                workbook_scope_mode: workbookDetails?.scopeMode
-            }
+            data: promptMetadata
         });
-        await this.agent.prompt(messages);
-        await this._recovery.wait();
+        try {
+            await this.agent.prompt(messages);
+            await this._agentEventQueue.catch(() => { });
+            await this._recovery.wait();
+        }
+        finally {
+            await this._agentEventQueue.catch(() => { });
+            if (this._pendingImmediateRunAgentMetadata === promptMetadata) {
+                this._pendingImmediateRunAgentMetadata = undefined;
+            }
+        }
     }
     /** Rewrite skill commands (/skill:name args) to selected-skill markers. */
     _expandSkillCommand(text) {
@@ -1008,6 +1052,7 @@ export class AgentSession {
     async _queueSteer(text, images) {
         this._queueTracker.pushSteering(text);
         this.agent.steer({
+            id: globalThis.crypto.randomUUID(),
             role: 'user',
             content: buildMessageContent(text, images),
             timestamp: Date.now()
@@ -1017,6 +1062,7 @@ export class AgentSession {
     async _queueFollowUp(text, images) {
         this._queueTracker.pushFollowUp(text);
         this.agent.followUp({
+            id: globalThis.crypto.randomUUID(),
             role: 'user',
             content: buildMessageContent(text, images),
             timestamp: Date.now()
@@ -1235,7 +1281,7 @@ export class AgentSession {
             const apiKey = await this._modelRegistry.getApiKey(this.model);
             if (!apiKey)
                 throw new Error(`No API key for ${this.model.provider}`);
-            return await this._compaction.runManual(this.model, apiKey, this.sessionManager.getBranch(), this.settingsManager.getCompactionSettings(), customInstructions, this._compactionActions);
+            return await this._compaction.runManual(this.model, apiKey, this.sessionManager.getBranch(), customInstructions, this._compactionActions);
         }
         finally {
             this._reconnectToAgent();

package/dist/app/collab/collab-sync.js

@@ -70,21 +70,11 @@ export class CollabSync {
         try {
             // Create engine from raw Yrs bytes — preserves exact Yrs item identities
             // so that subsequent syncApply diffs merge correctly.
-            // Suppress console.debug during creation (mog SDK logs "DatabaseBridge
-            // unavailable" which pollutes the TUI).
-            const origDebug = console.debug;
-            console.debug = () => { };
             const addon = SyncBridge.getNativeAddon();
-            let engine;
-            try {
-                engine = await createHeadlessEngine({
-                    computeAddon: addon,
-                    yrsState: state
-                });
-            }
-            finally {
-                console.debug = origDebug;
-            }
+            const engine = await createHeadlessEngine({
+                computeAddon: addon,
+                yrsState: state
+            });
             const wb = engine.workbook;
             const bridge = new SyncBridge(wb);
             this.bridges.set(docId, bridge);

package/dist/app/index.d.ts

@@ -22,7 +22,7 @@ export { createMcpManager, type McpManager } from './mcp/index.js';
 export { isManagedMcpOAuthProvider } from './mcp/managed-oauth-providers.js';
 export { McpOAuthStore } from './mcp/oauth-state-store.js';
 export { convertToLlm, createCompactionSummaryMessage, createCustomMessage, type CustomMessage } from './messages.js';
-export { handleNewSheetCommand } from './new-sheet-command.js';
+export { handleMogCommand } from './mog-command.js';
 export { ModelRegistry } from './providers/model-registry.js';
 export { resolveCliModel } from './providers/model-resolver.js';
 export { registerShortcutProvider } from './providers/register-shortcut-provider.js';
@@ -38,7 +38,7 @@ export type { SessionObservability } from './session/session-observability.js';
 export { FileSessionPersistenceBackend } from './session/session-persistence-backend.js';
 export type { SessionPersistenceBackend } from './session/session-persistence-backend.js';
 export type { BranchSessionStore, ModelSessionStore, PersistenceSessionStore, ProductSessionStore, SessionInfoStore } from './session/session-store-types.js';
-export { SettingsManager, type CompactionSettings, type ImageSettings, type PackageSource, type RetrySettings } from './settings-manager.js';
+export { SettingsManager, type ImageSettings, type PackageSource, type RetrySettings } from './settings-manager.js';
 export { countSkillProposals, listSkillProposals, type ProposalKind, type SkillProposalSummary } from './skill-proposals/catalog.js';
 export { default as skillProposalsExtension } from './skill-proposals/extension.js';
 export { getSkillProposalRoots, type ProposalRoots } from './skill-proposals/proposal-fs.js';

package/dist/app/index.js

@@ -18,7 +18,7 @@ export { createMcpManager } from './mcp/index.js';
 export { isManagedMcpOAuthProvider } from './mcp/managed-oauth-providers.js';
 export { McpOAuthStore } from './mcp/oauth-state-store.js';
 export { convertToLlm, createCompactionSummaryMessage, createCustomMessage } from './messages.js';
-export { handleNewSheetCommand } from './new-sheet-command.js';
+export { handleMogCommand } from './mog-command.js';
 export { ModelRegistry } from './providers/model-registry.js';
 export { resolveCliModel } from './providers/model-resolver.js';
 export { registerShortcutProvider } from './providers/register-shortcut-provider.js';

package/dist/app/modes/action/agent.js

@@ -5,7 +5,7 @@
  * Can switch to plan or installation mode.
  */
 import { MODE } from '../../../mode-names.js';
-import { ACTION_SWITCH_MODE, BASH, EXECUTE_CODE, EXECUTE_TOOL, GET_TOOL_INFO, MCP_TOOL_NAMES, SEND_MESSAGE, TASK, TODO_LIST, WRITE } from '../../../tool-names.js';
+import { ACTION_SWITCH_MODE, BASH, EXECUTE_CODE, EXECUTE_TOOL, GET_TOOL_INFO, MCP_TOOL_NAMES, SEND_MESSAGE, TASK, WRITE } from '../../../tool-names.js';
 import { buildActionPrompt } from './prompt.js';
 const DESCRIPTION = 'Execute changes to the spreadsheet.';
 const TOOLS = [
@@ -14,7 +14,6 @@ const TOOLS = [
     EXECUTE_CODE,
     TASK,
     SEND_MESSAGE,
-    TODO_LIST,
     ACTION_SWITCH_MODE,
     GET_TOOL_INFO,
     EXECUTE_TOOL,

package/dist/app/modes/action/prompt.js

@@ -33,6 +33,10 @@ Match the scope of your actions to what was actually requested. Complete the req
 execute_code: use it for all spreadsheet interactions
 ${engine.execTool}
 
+File Writing:
+- ALWAYS use the write tool to create or replace authored text files such as Markdown, TXT, CSV, JSON, YAML, scripts, notes, and plans.
+- Do not use bash heredocs, echo/printf chains, or inline Python solely to transport file contents into a file unless write is unavailable or the content is naturally generated by a command.
+
 PDF Processing:
 - You MUST ALWAYS use document readers to understand and extract data from PDFs, no matter if it is programmatic extraction or multimodal extraction.
 - First understand the task, then parallelize document readers to optimize performance when tasks can be broken down into independent components. Always leave the real work to the document readers

package/dist/app/modes/manage/agent.js

@@ -5,10 +5,10 @@
  * Explicit /manage can enter it, but it does not switch out again.
  */
 import { MODE } from '../../../mode-names.js';
-import { EXECUTE_TOOL, GET_TOOL_INFO, MCP_TOOL_NAMES, SEND_MESSAGE, TASK, TODO_LIST } from '../../../tool-names.js';
+import { EXECUTE_TOOL, GET_TOOL_INFO, MCP_TOOL_NAMES, SEND_MESSAGE, TASK } from '../../../tool-names.js';
 import { buildManagePrompt } from './prompt.js';
 const DESCRIPTION = 'Orchestration mode — decomposes complex tasks, delegates to subagents in parallel, and synthesizes results.';
-const TOOLS = [TASK, SEND_MESSAGE, TODO_LIST, GET_TOOL_INFO, EXECUTE_TOOL, ...MCP_TOOL_NAMES];
+const TOOLS = [TASK, SEND_MESSAGE, GET_TOOL_INFO, EXECUTE_TOOL, ...MCP_TOOL_NAMES];
 /** Construct the manage-mode agent definition that orchestrates work via subagents. */
 export function manageAgent() {
     return {

package/dist/app/modes/manage/prompt.js

@@ -17,12 +17,19 @@ Be concise and direct. No emojis. No filler phrases. Describe what you're delega
 
 You have NO direct access to the spreadsheet, file system, or shell. Your only tools are:
 - **task**: Spawn subagent workers (clone, document_reader, general)
-- **todo_list**: Track progress across delegated work
 - **get_tool_info / execute_tool**: Inspect and invoke tools dynamically
 - **MCP tools**: Access external services via MCP
 
 Mode switching is not available from Manage Mode. Finish orchestration here.
 
+## Progress Tracking
+
+For complex multi-step work, make delegated workers maintain progress in small markdown files.
+- Use a unique folder under \`/workspace/work/\`, such as \`/workspace/work/<task-slug>/\`.
+- A single \`status.md\` is enough for most tasks; use \`plan.md\` as well when the task has phases or acceptance criteria.
+- Tell workers to update current goal, completed steps, next step, blockers, and verification status as work proceeds.
+- Before context refreshes or autonomous resumes, workers must leave enough state for a fresh context to continue safely.
+
 ## Phased Workflow
 
 ### 1. Research Phase

package/dist/app/mog-command.d.ts

@@ -0,0 +1,13 @@
+/**
+ * /mog slash command handler.
+ *
+ * Toggles the Mog headless spreadsheet engine on or off.
+ * Requires a restart to take effect.
+ */
+import type { SettingsManager } from './settings-manager.js';
+export interface MogCommandPolicy {
+    enableDisabledReason?: string;
+    forceEnabled?: boolean;
+}
+export declare function handleMogCommand(showStatus: (msg: string) => void, select: (title: string, options: string[]) => Promise<string | undefined>, settingsManager: SettingsManager, policy?: MogCommandPolicy): Promise<boolean>;
+//# sourceMappingURL=mog-command.d.ts.map

package/dist/app/mog-command.js

@@ -0,0 +1,29 @@
+/**
+ * /mog slash command handler.
+ *
+ * Toggles the Mog headless spreadsheet engine on or off.
+ * Requires a restart to take effect.
+ */
+export async function handleMogCommand(showStatus, select, settingsManager, policy = {}) {
+    const current = settingsManager.getNewSheet();
+    const menuOptions = [
+        current ? 'Enable (current)' : 'Enable',
+        current ? 'Disable' : 'Disable (current)',
+        'Cancel'
+    ];
+    const choice = await select('Mog Spreadsheet Engine', menuOptions);
+    if (!choice || choice === 'Cancel')
+        return true;
+    const enable = choice.startsWith('Enable');
+    if (enable && !current && policy.enableDisabledReason) {
+        showStatus(policy.enableDisabledReason);
+        return true;
+    }
+    if (enable !== current) {
+        settingsManager.setNewSheet(enable);
+        const suffix = policy.forceEnabled ? ' (forced by SHORTCUT_NEW_SHEET)' : '';
+        showStatus(`Mog ${enable ? 'enabled' : 'disabled'}${suffix} — restart session to take effect`);
+    }
+    return true;
+}
+//# sourceMappingURL=mog-command.js.map

package/dist/app/new-sheet/mutation-tracker.js

@@ -137,6 +137,20 @@ function createTrackedWorksheet(ws, wb, mutations) {
                     return original.call(target, updates);
                 };
             }
+            // setArrayFormula({ startRow, startCol, endRow, endCol }, formula)
+            if (prop === 'setArrayFormula') {
+                return async (range, formula) => {
+                    const oldValues = await captureOldRange(target, range.startRow, range.startCol, range.endRow, range.endCol);
+                    for (let r = range.startRow; r <= range.endRow; r++) {
+                        for (let c = range.startCol; c <= range.endCol; c++) {
+                            const addr = indexToAddress(r, c);
+                            const old = oldValues.get(addr) ?? { oldValue: null };
+                            mutations.push({ workbook: wb, worksheet: target, address: addr, ...old });
+                        }
+                    }
+                    return original.call(target, range, formula);
+                };
+            }
             // setDateValue(row, col, date)
             if (prop === 'setDateValue') {
                 return async (row, col, ...args) => {

package/dist/app/new-sheet/sdk-types.d.ts

@@ -44,6 +44,7 @@ interface MogSdkModule {
     createWorkbook(options?: CreateWorkbookOptions): Promise<Workbook>;
     createHeadlessEngine(options: CreateHeadlessEngineOptions): Promise<HeadlessEngine>;
 }
+export declare function isMogSdkAvailable(): boolean;
 export declare function normalizeMogSdkModule(value: unknown): MogSdkModule | null;
 export declare function createWorkbook(options?: CreateWorkbookOptions): Promise<Workbook>;
 export declare function createHeadlessEngine(options: CreateHeadlessEngineOptions): Promise<HeadlessEngine>;