shortcutxl 0.3.61 → 0.3.62

package/BINARY-INVENTORY.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-06-05T01:51:32.781Z",
+  "generatedAt": "2026-06-10T21:37:57.358Z",
   "package": "shortcutxl",
   "binaryExtensions": [
     ".dll",
@@ -11,7 +11,7 @@
   "files": [
     {
       "path": "xll/ShortcutXL.xll",
-      "sha256": "7c86275b7bfd0b33b422de02a5d46e11004462b545d811bd53b7590a0b2891f9",
+      "sha256": "6eaecb6c7dd047ee91a0717b8849c43baa847d0c21afe094fe1d9e6fd1f89f6a",
       "source": "ShortcutXL native XLL build",
       "version": "package",
       "builtBy": "shortcut",
@@ -523,7 +523,7 @@
     },
     {
       "path": "xll/python/Scripts/httpx.exe",
-      "sha256": "6443bf0359e479a00549f26cfaaecebec067687bd721258108880e3e4b8c0cf9",
+      "sha256": "6e6b7c9bb24e920a8d59ee9464ee83f245f9a2daa1489bb23a09e80e1eac59f8",
       "source": "httpx console launcher installed into embedded Python",
       "version": "see packaged httpx distribution",
       "builtBy": "third-party",
@@ -531,7 +531,7 @@
     },
     {
       "path": "xll/python/Scripts/idna.exe",
-      "sha256": "eb0bee35c9a602f93ee605c2a6d6df3069be9e2be8a4b5131b4e7599a438d168",
+      "sha256": "15dbbd45e6257c0ca2dc305880d90ccf626ddb5c9265f8e9116f564483176ce1",
       "source": "Python package console launcher installed into embedded Python",
       "version": "see owning Python package metadata in site-packages",
       "builtBy": "third-party",
@@ -539,7 +539,7 @@
     },
     {
       "path": "xll/python/Scripts/pip.exe",
-      "sha256": "1c0d88a63c83e6bb9ce9480ab1e5b1240cf391656806130748441871958fe337",
+      "sha256": "373818f3109b5b0e3d7f249ebced133b042d0e2ffd2fb983967cb611c40e5d57",
       "source": "pip console launcher installed into embedded Python",
       "version": "see packaged pip distribution",
       "builtBy": "third-party",
@@ -547,7 +547,7 @@
     },
     {
       "path": "xll/python/Scripts/pip3.13.exe",
-      "sha256": "1c0d88a63c83e6bb9ce9480ab1e5b1240cf391656806130748441871958fe337",
+      "sha256": "373818f3109b5b0e3d7f249ebced133b042d0e2ffd2fb983967cb611c40e5d57",
       "source": "pip console launcher installed into embedded Python",
       "version": "see packaged pip distribution",
       "builtBy": "third-party",
@@ -555,7 +555,7 @@
     },
     {
       "path": "xll/python/Scripts/pip3.exe",
-      "sha256": "1c0d88a63c83e6bb9ce9480ab1e5b1240cf391656806130748441871958fe337",
+      "sha256": "373818f3109b5b0e3d7f249ebced133b042d0e2ffd2fb983967cb611c40e5d57",
       "source": "pip console launcher installed into embedded Python",
       "version": "see packaged pip distribution",
       "builtBy": "third-party",
@@ -563,7 +563,7 @@
     },
     {
       "path": "xll/python/Scripts/pywin32_postinstall.exe",
-      "sha256": "33c9bf469edc79cbdea68966e2b50eb15db5ba63278fec1befd274f00ef26bf4",
+      "sha256": "e6f28aa72208afcf845960aed0d938f48d993c78f111dab4da6e3c0b5f4a3a18",
       "source": "Python package console launcher installed into embedded Python",
       "version": "see owning Python package metadata in site-packages",
       "builtBy": "third-party",
@@ -571,7 +571,7 @@
     },
     {
       "path": "xll/python/Scripts/pywin32_testall.exe",
-      "sha256": "f4ab6b20be97a838b4e2eb369c603136e8bcf7d8b1829dd30e7fd7a681b48e65",
+      "sha256": "3014d8654460053f2061f84ba4cfa908682a28e81780c53763ecc01a934fa4a8",
       "source": "Python package console launcher installed into embedded Python",
       "version": "see owning Python package metadata in site-packages",
       "builtBy": "third-party",
@@ -779,11 +779,11 @@
     },
     {
       "path": "xll/python/sqlite3.dll",
-      "sha256": "aaae3fe73a4dda249da1ed740c087d1548a1ff7b73eaa7aa62c2354a581ee299",
-      "source": "SQLite library bundled with CPython Windows embeddable runtime",
-      "version": "see packaged python runtime",
+      "sha256": "73b045c910fc19a069bae2e2c7ebb5ea66fe6c85f166535a6e07e09155cd9e6d",
+      "source": "SQLite official precompiled Windows x64 DLL",
+      "version": "3.53.2",
       "builtBy": "third-party",
-      "verification": "Downloaded from python.org CPython release artifacts; verify upstream SHA/signature before vendoring."
+      "verification": "Downloaded from sqlite.org sqlite-dll-win-x64-3530200.zip; upstream SHA3-256 is b898ced2e0627999d7d0b9d554ea53086a9b165e52ae743277d115dcd39e6868, and vendor-python.ps1 verifies extracted sqlite3.dll SHA256 73b045c910fc19a069bae2e2c7ebb5ea66fe6c85f166535a6e07e09155cd9e6d before copying."
     },
     {
       "path": "xll/python/unicodedata.pyd",

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.3.62]
+
+- **Windows runtime security** - Updated the embedded Windows SQLite DLL used by ShortcutXL's bundled Python runtime.
+- **Default model update** - Updated the default model to Fable.
+
 ## [0.3.61]
 
 - **ShortcutXL plugin guidance** - Refreshed the bundled Claude and Codex ShortcutXL plugin guidance.

package/agent-docs/examples/extensions/custom-provider-anthropic/package.json

@@ -14,6 +14,6 @@
     ]
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.52.0"
+    "@anthropic-ai/sdk": "0.91.1"
   }
 }

package/binary-provenance.json

@@ -50,13 +50,13 @@
       "builtBy": "third-party",
       "verification": "Downloaded from python.org CPython release artifacts; verify upstream SHA/signature before vendoring."
     },
-    {
-      "pattern": "xll/python/sqlite3.dll",
-      "source": "SQLite library bundled with CPython Windows embeddable runtime",
-      "version": "see packaged python runtime",
-      "builtBy": "third-party",
-      "verification": "Downloaded from python.org CPython release artifacts; verify upstream SHA/signature before vendoring."
-    },
+    {
+      "pattern": "xll/python/sqlite3.dll",
+      "source": "SQLite official precompiled Windows x64 DLL",
+      "version": "3.53.2",
+      "builtBy": "third-party",
+      "verification": "Downloaded from sqlite.org sqlite-dll-win-x64-3530200.zip; upstream SHA3-256 is b898ced2e0627999d7d0b9d554ea53086a9b165e52ae743277d115dcd39e6868, and vendor-python.ps1 verifies extracted sqlite3.dll SHA256 73b045c910fc19a069bae2e2c7ebb5ea66fe6c85f166535a6e07e09155cd9e6d before copying."
+    },
     {
       "pattern": "xll/python/vcruntime*.dll",
       "source": "Microsoft Visual C++ runtime library bundled with CPython Windows embeddable runtime",

package/dist/app/agent-session-runtime-adapter.js

@@ -35,6 +35,14 @@ function createAgentSessionCore(session, pendingHostToolRequests) {
             session.replaceToolsByName(configuration.toolNames);
             session.agent.setSystemPrompt(configuration.systemPrompt);
         },
+        async controlTask(request) {
+            return {
+                ok: false,
+                action: request.action,
+                taskId: request.taskId,
+                reason: 'Task control is only available in the embedded ShortcutXL runtime.'
+            };
+        },
         dispose() {
             session.dispose();
         },

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

@@ -346,7 +346,7 @@ export declare class AgentSession {
     private _setAutonomousState;
     /** Reload autonomous-run state from the persisted session header on resume. */
     private _restoreAutonomousStateFromSession;
-    /** Wrap a user prompt with autonomous-run framing before sending it to the model. */
+    /** Handle the product-owned /autonomous command before sending text to the model. */
     private _prepareAutonomousPrompt;
     /**
      * Queue a steering message to interrupt the agent mid-run.
@@ -362,7 +362,7 @@ export declare class AgentSession {
      * @param images Optional image attachments to include with the message
      */
     followUp(text: string, images?: ImageContent[]): Promise<void>;
-    /** Resolve raw prompt text + images into the final agent-input shape (skills, autonomous, etc.). */
+    /** Resolve raw prompt text + images into the final agent-input shape. */
     private _preparePromptInput;
     /** Enqueue a steering message to be delivered before the next assistant response. */
     private _queueSteer;

package/dist/app/agent-session.js

@@ -22,7 +22,6 @@ import { isShortcutFastModeModel } from '../model-ids.js';
 import { formatFileUploadsContext, mergeFileUploads } from './file-uploads.js';
 import { createShortcutLlmProxyClient } from './providers/shortcut-llm-proxy-client.js';
 import { expandPromptTemplate } from './resources/prompt-template-expansion.js';
-import { parseSkillBlock } from './resources/skill-block.js';
 import { AUTONOMOUS_STATE_CUSTOM_TYPE, buildAutonomousRefreshPrompt, extractProgressFolder, inferAutonomousStateFromEntries } from './session/autonomous-workflow.js';
 import { BranchManager } from './session/branch-manager.js';
 import { parseBudgetCommand } from './session/budget-command.js';
@@ -756,7 +755,7 @@ export class AgentSession {
             enabled: true,
             originalUserTask: trimmed
         });
-        await this.prompt(`[Skill:autonomous selected] ${trimmed}`);
+        await this.prompt(trimmed);
     }
     /** Stage a pending session refresh (mode/model swap) to be applied on the next prompt. */
     async preparePendingRefresh(refresh) {
@@ -977,7 +976,7 @@ export class AgentSession {
     _restoreAutonomousStateFromSession() {
         this._autonomousState = inferAutonomousStateFromEntries(this.sessionManager.getEntries());
     }
-    /** Wrap a user prompt with autonomous-run framing before sending it to the model. */
+    /** Handle the product-owned /autonomous command before sending text to the model. */
     _prepareAutonomousPrompt(text) {
         if (!text.startsWith('/autonomous'))
             return text;
@@ -989,7 +988,7 @@ export class AgentSession {
             enabled: true,
             originalUserTask: task
         });
-        return `[Skill:autonomous selected] ${task}`;
+        return task;
     }
     /**
      * Queue a steering message to interrupt the agent mid-run.
@@ -1025,7 +1024,7 @@ export class AgentSession {
         }
         await this._queueFollowUp(prepared.text, prepared.images);
     }
-    /** Resolve raw prompt text + images into the final agent-input shape (skills, autonomous, etc.). */
+    /** Resolve raw prompt text + images into the final agent-input shape. */
     async _preparePromptInput(text, images, options) {
         let currentText = this._prepareAutonomousPrompt(text);
         let currentImages = images;
@@ -1050,13 +1049,6 @@ export class AgentSession {
             currentText = this._expandSkillCommand(currentText);
             currentText = expandPromptTemplate(currentText, [...this.promptTemplates]);
         }
-        const parsedSkill = parseSkillBlock(currentText);
-        if (parsedSkill?.name === 'autonomous' && parsedSkill.userMessage) {
-            this._setAutonomousState({
-                enabled: true,
-                originalUserTask: parsedSkill.userMessage
-            });
-        }
         if (options.commandMode === 'reject' && currentText.startsWith('/')) {
             assertNotExtensionCommand(currentText, extensionRunner);
         }

package/dist/app/approvals/types.d.ts

@@ -75,5 +75,6 @@ export interface SwitchModeApprovalData {
     currentMode: string;
     targetMode: string;
     reason?: string;
+    documentPath?: string;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -19,9 +19,9 @@ const PLATFORM_PACKAGES = {
 let _cachedAddon;
 /**
  * Load the platform-native compute addon.
- * Same resolution as @mog-sdk/node's internal tryLoadNapiAddon.
+ * Same resolution as @mog-sdk/sdk's internal tryLoadNapiAddon.
  *
- * Uses createRequire anchored to @mog-sdk/node's package location so
+ * Uses createRequire anchored to @mog-sdk/sdk's package location so
  * pnpm's symlinked node_modules resolves the platform package correctly.
  */
 function loadNativeAddon() {
@@ -30,7 +30,7 @@ function loadNativeAddon() {
     // Resolve the SDK's main entry, then create require from its directory.
     // This ensures pnpm's symlinked deps (@mog-sdk/darwin-arm64 etc.) are findable.
     const req = createRequire(import.meta.url);
-    const sdkEntry = req.resolve('@mog-sdk/node');
+    const sdkEntry = req.resolve('@mog-sdk/sdk');
     const sdkReq = createRequire(sdkEntry);
     const pkg = PLATFORM_PACKAGES[process.platform]?.[process.arch];
     if (!pkg)

package/dist/app/credits/credit-gate.d.ts

@@ -24,6 +24,7 @@ export declare class CreditGate {
         creditsRemaining: number;
         isUnlimited: boolean;
         hasTeamBilling: boolean;
+        canSendMessage?: boolean;
     }): void;
     invalidate(): void;
 }

package/dist/app/credits/credit-gate.js

@@ -6,6 +6,9 @@
  *
  */
 import { fetchCreditBalance } from '../../credits/shortcut-credits.js';
+function hasUsableCredits(balance) {
+    return balance.canSendMessage ?? (balance.isUnlimited || balance.creditsRemaining > 0);
+}
 export class CreditGate {
     cachedResult = null;
     cachedAt = 0;
@@ -28,7 +31,7 @@ export class CreditGate {
             return { hasCredits: true, creditsRemaining: 0, isUnlimited: false, hasTeamBilling: false };
         }
         const result = {
-            hasCredits: balance.isUnlimited || balance.creditsRemaining > 0,
+            hasCredits: hasUsableCredits(balance),
             creditsRemaining: balance.creditsRemaining,
             isUnlimited: balance.isUnlimited,
             hasTeamBilling: balance.hasTeamBilling
@@ -47,7 +50,7 @@ export class CreditGate {
     /** Populate the cache from an already-fetched balance (e.g. from polling). */
     populate(balance) {
         this.cachedResult = {
-            hasCredits: balance.isUnlimited || balance.creditsRemaining > 0,
+            hasCredits: hasUsableCredits(balance),
             creditsRemaining: balance.creditsRemaining,
             isUnlimited: balance.isUnlimited,
             hasTeamBilling: balance.hasTeamBilling

package/dist/app/modes/action/agent.d.ts

@@ -5,6 +5,7 @@
  * Can switch to plan or installation mode.
  */
 import type { AgentDefinition } from '../../agent-definition.js';
+export declare const ACTION_AGENT_TOOL_NAMES: ("write" | "bash" | "execute_code" | "task" | "send_message" | "switch_from_action_mode" | "refresh_context" | "mcp" | "get_tool_info" | "execute_tool")[];
 /** Construct the action-mode agent definition with the full execution toolset. */
 export declare function actionAgent(): AgentDefinition;
 //# sourceMappingURL=agent.d.ts.map

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

@@ -8,7 +8,7 @@ import { MODE } from '../../../mode-names.js';
 import { ACTION_SWITCH_MODE, BASH, EXECUTE_CODE, EXECUTE_TOOL, GET_TOOL_INFO, MCP_TOOL_NAMES, REFRESH_CONTEXT, SEND_MESSAGE, TASK, WRITE } from '../../../tool-names.js';
 import { buildActionPrompt } from './prompt.js';
 const DESCRIPTION = 'Execute changes to the spreadsheet.';
-const TOOLS = [
+export const ACTION_AGENT_TOOL_NAMES = [
     BASH,
     WRITE,
     EXECUTE_CODE,
@@ -26,7 +26,7 @@ export function actionAgent() {
         name: MODE.ACTION,
         description: DESCRIPTION,
         systemPrompt: buildActionPrompt(),
-        tools: TOOLS,
+        tools: ACTION_AGENT_TOOL_NAMES,
         switchTo: [MODE.PLAN, MODE.INSTALLATION]
     };
 }

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

@@ -24,8 +24,8 @@ Deliver professional-grade results with precise calculations, consistent formatt
 Beyond spreadsheets, you can interact with external services (email, databases, APIs, etc.). Check your docs and capabilities before telling the user you can't do something
 Current date: ${new Date().toISOString().slice(0, 10)}. Use this as single source of truth for time, overriding pretrained knowledge. Verify recency with tools for time-sensitive facts.
 
-General flow: execute code → verify → iterate on feedback. Respond in Markdown, be brief
-Avoid over-interpretation and don't be extra. Only make changes that are directly requested or clearly necessary
+General flow: execute → verify yourself and via independent subagents → iterate on feedback.
+Avoid over-interpretation and don't be extra. Only make changes that are directly requested or clearly necessary. Respond in Markdown, be brief
 Keep solutions simple and focused. For example, don't add extra sheets, reformat untouched areas, or make "improvements" beyond what was asked
 Do not add improvements, cleanup, formatting changes, structural edits, or extra analysis beyond what the user asked for.
 Match the scope of your actions to what was actually requested. Complete the requested task, but do not overstep.

package/dist/app/modes/manage/agent.d.ts

@@ -1,7 +1,7 @@
 /**
  * Manage mode agent definition — sink orchestration mode.
  *
- * Delegates all work to subagents. No direct file/spreadsheet access.
+ * Delegates workbook work to subagents, with bash for coordination files and inspection.
  * Explicit /manage can enter it, but it does not switch out again.
  */
 import type { AgentDefinition } from '../../agent-definition.js';

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

@@ -1,14 +1,14 @@
 /**
  * Manage mode agent definition — sink orchestration mode.
  *
- * Delegates all work to subagents. No direct file/spreadsheet access.
+ * Delegates workbook work to subagents, with bash for coordination files and inspection.
  * 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 } from '../../../tool-names.js';
+import { BASH, 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, GET_TOOL_INFO, EXECUTE_TOOL, ...MCP_TOOL_NAMES];
+const TOOLS = [TASK, SEND_MESSAGE, GET_TOOL_INFO, EXECUTE_TOOL, BASH, ...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

@@ -6,7 +6,7 @@
  */
 import { buildCurrentSkillsSection } from '../../prompts/shared-guidelines.js';
 const MANAGE_BASE = `\
-You are Shortcut in Manage Mode — a pure orchestrator. You NEVER execute work directly. You decompose tasks, delegate to subagents via the task tool, and synthesize their results.
+You are Shortcut in Manage Mode — an orchestrator. You decompose tasks, delegate workbook/document work to subagents via the task tool, use bash for coordination files and lightweight inspection, and synthesize results.
 
 Current date: ${new Date().toISOString().slice(0, 10)}. Use this as single source of truth for time.
 
@@ -15,8 +15,9 @@ Be concise and direct. No emojis. No filler phrases. Describe what you're delega
 
 ## YOU ARE IN MANAGE MODE
 
-You have NO direct access to the spreadsheet, file system, or shell. Your only tools are:
+You do not directly edit the spreadsheet. Your tools are:
 - **task**: Spawn subagent workers (clone, document_reader, general)
+- **bash**: Maintain progress files, inspect artifacts, run lightweight filesystem checks, and prepare clear handoffs. Do not use bash as a substitute for delegated workbook implementation.
 - **get_tool_info / execute_tool**: Inspect and invoke tools dynamically
 - **MCP tools**: Access external services via MCP
 
@@ -24,10 +25,12 @@ 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.
+For substantial builds or edits, make delegated workers maintain progress in small markdown files. Progress files are for auditability and resumability, not just the worker's convenience.
 - 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.
+- Require \`status.md\` when work creates or edits 3+ sheets, touches multiple workbook areas, has 3+ phases, requires source extraction, uses parallel/subagents, has nontrivial formulas, or includes enough decisions that a reviewer would need a record.
+- When in doubt, require a concise \`status.md\`. A short status file is preferred over losing the decision trail.
+- Use \`status.md\` for current goal, phase, completed work, next step, blockers, verification status, and decisions/rationale. Add \`plan.md\` when the task has phases or acceptance criteria.
+- Tell workers to create/update \`status.md\` before the first major implementation step and after each phase or important decision.
 - Before context refreshes or autonomous resumes, workers must leave enough state for a fresh context to continue safely.
 
 ## Phased Workflow
@@ -54,7 +57,7 @@ Delegate implementation tasks to clone subagents. Each task MUST be self-contain
 Parallelize independent tasks. Serialize dependent ones.
 
 ### 4. Verification Phase
-Launch verification subagent(s) to check results against requirements.
+Launch verification subagent(s) in the background to check results against requirements unless the next orchestration step must wait for the verdict.
 - Read back all modified cells and verify values
 - Check formula linkages and cross-sheet references
 - Confirm formatting matches conventions

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

@@ -8,16 +8,7 @@ import { MODE } from '../../../mode-names.js';
 import { BASH, EXECUTE_CODE, EXECUTE_TOOL, FIND, GET_TOOL_INFO, GREP, LLM_ANALYSIS, LS, MCP_TOOL_NAMES, PLAN_SWITCH_MODE, READ } from '../../../tool-names.js';
 import { buildPlanPrompt } from './prompt.js';
 const DESCRIPTION = `\
-Read-only planning mode — explores workbook, asks clarifying questions, produces implementation plan.
-Switch to plan mode for: user frustrations, ambiguous asks, subjective asks, and complex workbooks.
-- Multi-sheet financial models, DCF valuations, comprehensive dashboards
-- Major structural reorganizations affecting multiple sheets
-- Truly ambiguous asks: "build a DCF", "create executive KPI dashboard"
-- Vague requests: "this is broken", "help", "make this look better"
-
-DON'T switch to plan mode when:
-- Recent messages already established what needs to be done
-- The user just confirmed or approved a course of action`;
+Read-only planning mode for exploration, clarifying requirements and drafting an implementation plan.`;
 const TOOLS = [
     BASH,
     EXECUTE_CODE,

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

@@ -37,7 +37,7 @@ ${engine.execTool}
 1. Gauge user experience: If unclear from their query, ASK about their spreadsheet familiarity first - then adapt all explanations accordingly (beginners need more context, experts want concise trade-offs)
 2. After exploration: State (1) task understanding (MAX 3-4 lines), (2) list ALL open questions upfront with a brief description of each (e.g., "I need to clarify 3 things: 1) how to handle missing data, 2) whether to use formulas or static values, 3) where to place output"), (3) first question
 3. ONE question per response. Before each question, state which open items remain (e.g., "Still need to resolve: output location, formula vs static values."). If a user's answer resolves multiple items, acknowledge that and move on. Do NOT re-count or renumber — just reference the open items by topic.
-4. Call switch_from_plan_mode(mode: "action", reason: <plan>) with plan (MAX 250 words)
+4. Write the final plan as markdown to a file under /tmp, then call switch_from_plan_mode(mode: "action", documentPath: "<that file path>").
 5. If plan rejected: Restart question cycle to understand needed changes
 
 **Critical Rules:**
@@ -65,8 +65,8 @@ Structure:
 - **Recommendation: [Letter]** - Your reasoning, or explain why you're uncertain
 - **[Bold question]?**
 
-**Final Plan Format (MAX 250 words):**
-Call switch_from_plan_mode(mode: "action", reason: <your plan>) with high-level plan (logical operations + key cells - NO specific arguments/parameters/formulas):
+**Final Plan Format:**
+Write the full plan as markdown to a file under /tmp. Then call switch_from_plan_mode(mode: "action", documentPath: "<that file path>").
 
 \`\`\`
 Task: [One sentence]
@@ -83,7 +83,7 @@ Things to Watch Out For:
 - [Key considerations and edge cases]
 \`\`\`
 
-MUST call switch_from_plan_mode(mode: "action", reason: <plan>) - do NOT output plan directly.
+MUST call switch_from_plan_mode(mode: "action", documentPath: "<that file path>") - do NOT output plan directly.
 `;
 // ---------------------------------------------------------------------------
 // Assembly

package/dist/app/modes/switch-mode.d.ts

@@ -14,6 +14,7 @@ export interface ModeSettings {
 export interface SwitchModeOptions {
     settings?: ModeSettings;
     reason?: string;
+    documentPath?: string;
     ctx?: Pick<ExtensionContext, 'hasUI' | 'ui'>;
     confirm?: (request: ModeSwitchConfirmationRequest) => Promise<boolean>;
     /** Bypass switchTo constraints (used by slash commands — user explicitly chose the mode). */
@@ -23,6 +24,7 @@ export interface ModeSwitchConfirmationRequest {
     currentMode: string;
     targetMode: string;
     reason?: string;
+    documentPath?: string;
     ctx?: Pick<ExtensionContext, 'hasUI' | 'ui'>;
 }
 export declare function requiresModeSwitchConfirmation(currentMode: string, targetMode: string): boolean;

package/dist/app/modes/switch-mode.js

@@ -14,12 +14,16 @@ export function requiresModeSwitchConfirmation(currentMode, targetMode) {
 function formatModeName(mode) {
     return mode.length > 0 ? mode.charAt(0).toUpperCase() + mode.slice(1) : mode;
 }
-async function confirmModeSwitch(currentMode, targetMode, reason, ctx) {
+async function confirmModeSwitch(currentMode, targetMode, reason, documentPath, ctx) {
     if (!ctx?.hasUI)
         return true;
     const title = chalk.green(`Switch from ${formatModeName(currentMode)} to ${formatModeName(targetMode)}`);
     const trimmedReason = reason?.trim();
-    const message = trimmedReason ? `${title}\n\n${trimmedReason}` : title;
+    const trimmedDocumentPath = documentPath?.trim();
+    const documentPathText = trimmedDocumentPath
+        ? `\n\nThis document as written is saved at:\n${trimmedDocumentPath}`
+        : '';
+    const message = trimmedReason ? `${title}\n\n${trimmedReason}${documentPathText}` : title;
     return (await ctx.ui.select(message, ['Confirm', 'Cancel'])) === 'Confirm';
 }
 function applyModeSwitch(session, target, settings) {
@@ -46,7 +50,7 @@ function applyModeSwitch(session, target, settings) {
     })));
 }
 export async function switchMode(session, modeName, opts = {}) {
-    const { settings, reason, ctx, confirm, force } = opts;
+    const { settings, reason, documentPath, ctx, confirm, force } = opts;
     const currentMode = getCurrentMode();
     if (modeName === currentMode) {
         return { ok: false, message: `Already in ${currentMode} mode.` };
@@ -79,14 +83,18 @@ export async function switchMode(session, modeName, opts = {}) {
     }
     if (requiresModeSwitchConfirmation(currentMode, target.name)) {
         const confirmed = confirm
-            ? await confirm({ currentMode, targetMode: target.name, reason, ctx })
-            : await confirmModeSwitch(currentMode, target.name, reason, ctx);
+            ? await confirm({ currentMode, targetMode: target.name, reason, documentPath, ctx })
+            : await confirmModeSwitch(currentMode, target.name, reason, documentPath, ctx);
         if (!confirmed) {
             return { ok: false, message: 'User cancelled the mode switch.' };
         }
     }
     applyModeSwitch(session, target, settings);
     const reasonText = reason ? `\nReason: ${reason}` : '';
-    return { ok: true, message: `Switched to ${target.name} mode.${reasonText}` };
+    const trimmedDocumentPath = documentPath?.trim();
+    const documentPathText = trimmedDocumentPath
+        ? `\nThis document as written is saved at:\n${trimmedDocumentPath}`
+        : '';
+    return { ok: true, message: `Switched to ${target.name} mode.${reasonText}${documentPathText}` };
 }
 //# sourceMappingURL=switch-mode.js.map

package/dist/app/new-sheet/cell-diff/types.d.ts

@@ -4,7 +4,7 @@
  * TODO: Indirect change tracking — detect formula dependents that recalculate
  * when a direct cell is mutated. Currently all changes are marked as direct.
  */
-/** Excel error strings returned by @mog-sdk/node (0.1.12+). */
+/** Excel error strings returned by @mog-sdk/sdk. */
 export declare const EXCEL_ERRORS: Set<string>;
 /** Returns true if a value is an Excel error string. */
 export declare function isExcelError(val: unknown): val is string;

package/dist/app/new-sheet/cell-diff/types.js

@@ -4,7 +4,7 @@
  * TODO: Indirect change tracking — detect formula dependents that recalculate
  * when a direct cell is mutated. Currently all changes are marked as direct.
  */
-/** Excel error strings returned by @mog-sdk/node (0.1.12+). */
+/** Excel error strings returned by @mog-sdk/sdk. */
 export const EXCEL_ERRORS = new Set([
     '#DIV/0!',
     '#NAME?',

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

@@ -1,5 +1,5 @@
 /**
- * SDK type seam — the ONLY file in new-sheet/ that imports @mog-sdk/node.
+ * SDK type seam — the ONLY file in new-sheet/ that imports @mog-sdk/sdk.
  *
  * All other new-sheet files import from here. To sever the SDK dependency
  * (e.g. for a build that excludes new-sheet), this is the single cut point.
@@ -9,7 +9,7 @@ export interface Worksheet {
 }
 /**
  * Workbook type with runtime-only properties that exist on WorkbookImpl
- * but aren't part of the public @mog-sdk/node .d.ts yet.
+ * but aren't part of the public @mog-sdk/sdk .d.ts yet.
  *
  * - activeSheet: sync property returning the active Worksheet
  * - sheetNames: sync property returning sheet name list

package/dist/app/new-sheet/sdk-types.js

@@ -1,12 +1,12 @@
 /**
- * SDK type seam — the ONLY file in new-sheet/ that imports @mog-sdk/node.
+ * SDK type seam — the ONLY file in new-sheet/ that imports @mog-sdk/sdk.
  *
  * All other new-sheet files import from here. To sever the SDK dependency
  * (e.g. for a build that excludes new-sheet), this is the single cut point.
  */
 import { createRequire } from 'node:module';
 let sdkModulePromise = null;
-const MOG_SDK_NODE_SPECIFIER = '@mog-sdk/node';
+const MOG_SDK_NODE_SPECIFIER = '@mog-sdk/sdk';
 const requireFromHere = createRequire(import.meta.url);
 export function isMogSdkAvailable() {
     try {

package/dist/app/new-sheet/sheet-engine.d.ts

@@ -1,5 +1,5 @@
 /**
- * Sheet Engine Pool — manages multiple headless workbooks via @mog-sdk/node.
+ * Sheet Engine Pool — manages multiple headless workbooks via @mog-sdk/sdk.
  *
  * Each workbook is created through the SDK's createWorkbook() function.
  * Uses the full kernel so formulas, undo, and CRDT sync all work correctly.

package/dist/app/new-sheet/sheet-engine.js

@@ -1,5 +1,5 @@
 /**
- * Sheet Engine Pool — manages multiple headless workbooks via @mog-sdk/node.
+ * Sheet Engine Pool — manages multiple headless workbooks via @mog-sdk/sdk.
  *
  * Each workbook is created through the SDK's createWorkbook() function.
  * Uses the full kernel so formulas, undo, and CRDT sync all work correctly.

package/dist/app/providers/model-resolver.d.ts

@@ -1,7 +1,7 @@
 /**
  * Model resolution, scoping, and initial selection
  */
-import { type Api, type KnownProvider, type Model } from '../../ai/types.js';
+import { type Api, type Model } from '../../ai/types.js';
 import type { AgentModelRegistry } from '../../contracts/agent-model.js';
 import type { ThinkingLevel } from '../../core/core-types.js';
 export declare function formatModelRef(model: Pick<Model<any>, 'provider' | 'id'>): string;
@@ -16,8 +16,8 @@ export interface ExactModelRefResult {
  * must be unambiguous. Model ids may themselves contain slashes.
  */
 export declare function resolveExactModelRef(availableModels: readonly Model<any>[], requested: string): ExactModelRefResult;
-/** Default model IDs for each known provider */
-export declare const defaultModelPerProvider: Record<KnownProvider, string>;
+/** Default model IDs for each provider with a preferred initial model. */
+export declare const defaultModelPerProvider: Record<string, string>;
 export interface ParsedModelResult {
     model: Model<Api> | undefined;
     /** Thinking level if explicitly specified in pattern, undefined otherwise */