shortcutxl 0.3.51 → 0.3.52

package/CHANGELOG.md

@@ -1,8 +1,14 @@
-# Changelog
-
-## [0.3.51]
-
-- **TUI rendering and text selection** - Improved TUI rendering, scrolling. Fixed text highlighting and selection for copy pastes.
+# Changelog
+
+## [0.3.52]
+
+- **Team fast mode policy** - Fast Mode is now automatically disabled for team accounts, with a clear message when your team policy blocks it.
+- **Cleaner footer and shortcuts** - The footer now uses shorter model names, shows model/thinking hotkeys inline, and moves model cycling to `alt+p`, thinking to `alt+t`, and runtime permission bypass to `alt+r`.
+- **Copy selection hint** - Selecting transcript text now shows a `Ctrl+C to copy` hint while preserving the exact copied text.
+
+## [0.3.51]
+
+- **TUI rendering and text selection** - Improved TUI rendering, scrolling. Fixed text highlighting and selection for copy pastes.
 - **Agentic MCP setup** - Agents can now help set up MCP servers through `shortcut mcp add/list/get/login/logout/remove`, with clearer login, logs, and OAuth settings.
 - **User-requested session settings** - When asked, agents can inspect available models and thinking levels or apply your requested session change.
 - **Skill sync clarity** - Skill sync now shows startup differences plus per-file upload/download changes, source, and visibility.

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

@@ -38,6 +38,7 @@ export interface CreateAgentSessionRuntimeAdapterOptions {
     approvalState?: AgentApprovalState;
     budgetLimits?: RuntimeBudgetLimits;
     enableToolSummaries?: boolean;
+    fastModeAllowed?: boolean;
     modeName?: string;
     model?: Model<Api>;
     observability?: RuntimeObservability;

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

@@ -211,6 +211,7 @@ export async function createAgentSessionRuntimeAdapter(options) {
         initialModeName: options.modeName,
         initialPermissionPolicy: options.permissionPolicy,
         modelRegistry,
+        fastModeAllowed: options.fastModeAllowed,
         extensionRunnerRef,
         prePromptContext: options.prePromptContext,
         budgetLimits: options.budgetLimits,

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

@@ -105,6 +105,7 @@ export interface AgentSessionConfig {
     initialPermissionPolicy?: RuntimePermissionPolicy;
     /** Model registry for API key resolution and model discovery */
     modelRegistry: AgentModelRegistry;
+    fastModeAllowed?: boolean;
     /** Mutable ref used by AgentController to access the current ExtensionRunner */
     extensionRunnerRef?: {
         current?: ExtensionRunner;
@@ -182,6 +183,7 @@ export declare class AgentSession {
     private _observability?;
     private _tools;
     private _models;
+    private _fastModeAllowed;
     private _extensions;
     private _compactionActions;
     private _compactionTriggerDeps;
@@ -262,7 +264,9 @@ export declare class AgentSession {
     /** Current thinking level */
     get thinkingLevel(): ThinkingLevel;
     get isFastModeEnabled(): boolean;
+    get isFastModeAllowed(): boolean;
     get isFastModeAvailable(): boolean;
+    setFastModeAllowed(allowed: boolean): void;
     setFastModeEnabled(enabled: boolean): void;
     toggleFastMode(): boolean;
     /** Whether agent is currently streaming a response */

package/dist/app/agent-session.js

@@ -27,7 +27,7 @@ import { emitExtensionEvent } from './session/extension-emitter.js';
 import { ExtensionLifecycle } from './session/extension-lifecycle.js';
 import { ModelManager } from './session/model-manager.js';
 import { resolvePendingRefreshOverride } from './session/pending-refresh-overrides.js';
-import { formatRuntimePermissionBypassContext } from './session/permission-context.js';
+import { formatRuntimePermissionBypassReminder } from './session/permission-context.js';
 import { PersistenceHandler } from './session/persistence-handler.js';
 import { assertNotExtensionCommand, buildMessageContent, normalizeUserContent, tryExtensionCommand } from './session/prompt-pipeline.js';
 import { QueueTracker } from './session/queue-tracker.js';
@@ -37,6 +37,7 @@ import { executeNewSession, executeSwitchSession } from './session/session-lifec
 import { getAvailableThinkingLevels, supportsThinking, supportsXhighThinking } from './session/session-models.js';
 import { computeContextUsage, computeSessionStats } from './session/session-stats.js';
 import { expandSkillCommand } from './session/skill-expansion.js';
+import { formatSystemReminderContext } from './session/system-reminder-context.js';
 import { ToolRegistry } from './session/tool-registry.js';
 import { ToolSummaryEmitter } from './session/tool-summary-emitter.js';
 import { isToolSummaryEligible } from './session/tool-summary-policy.js';
@@ -109,6 +110,7 @@ export class AgentSession {
     _tools;
     // Model manager — model switching, cycling, thinking level
     _models;
+    _fastModeAllowed = true;
     // Extension lifecycle — owns extension runner, bindings, reload
     _extensions;
     // Bridge objects for compaction/recovery/budget subsystems
@@ -127,6 +129,7 @@ export class AgentSession {
         this._prePromptContext = config.prePromptContext;
         this._budgetLimits = config.budgetLimits;
         this._observability = config.observability;
+        this._fastModeAllowed = config.fastModeAllowed ?? true;
         this._summaryEmitter = new ToolSummaryEmitter({
             enabled: config.enableToolSummaries ?? true,
             isFeatureEnabled: () => this.settingsManager.getToolSummariesEnabled(),
@@ -587,8 +590,16 @@ export class AgentSession {
     get isFastModeEnabled() {
         return this.isFastModeAvailable && this.agent.speed === 'fast';
     }
+    get isFastModeAllowed() {
+        return this._fastModeAllowed;
+    }
     get isFastModeAvailable() {
-        return isShortcutFastModeModel(this.model);
+        return this._fastModeAllowed && isShortcutFastModeModel(this.model);
+    }
+    setFastModeAllowed(allowed) {
+        this._fastModeAllowed = allowed;
+        if (!allowed)
+            this.setFastModeEnabled(false);
     }
     setFastModeEnabled(enabled) {
         this.agent.speed = enabled && this.isFastModeAvailable ? 'fast' : undefined;
@@ -801,18 +812,8 @@ export class AgentSession {
         }
         // Build messages array (custom message if any, then user message)
         const messages = [];
-        // Add user message
-        const userContent = [{ type: 'text', text: expandedText }];
-        if (currentImages) {
-            userContent.push(...currentImages);
-        }
-        messages.push({
-            role: 'user',
-            content: userContent,
-            timestamp: Date.now()
-        });
         this.lastPrePromptDetails = undefined;
-        const prePromptContextParts = [formatRuntimePermissionBypassContext(this.permissionPolicy)];
+        const prePromptContextParts = [formatRuntimePermissionBypassReminder(this.permissionPolicy)];
         let prePromptDetails;
         if (this._prePromptContext) {
             const ctx = await this._prePromptContext();
@@ -825,19 +826,21 @@ export class AgentSession {
         messages.push({
             role: 'custom',
             customType: 'prePromptContext',
-            content: prePromptContextParts.join('\n\n'),
+            content: formatSystemReminderContext(prePromptContextParts),
             display: false,
             details: prePromptDetails,
             timestamp: Date.now()
         });
-        for (const message of messages) {
-            if (message.role === 'custom') {
-                this.sessionManager.appendCustomMessageEntry(message.customType, message.content, message.display, message.details);
-            }
-            else if (message.role === 'user') {
-                this.sessionManager.appendMessage(message);
-            }
+        // Add user message
+        const userContent = [{ type: 'text', text: expandedText }];
+        if (currentImages) {
+            userContent.push(...currentImages);
         }
+        messages.push({
+            role: 'user',
+            content: userContent,
+            timestamp: Date.now()
+        });
         // Inject any pending "nextTurn" messages as context alongside the user message
         for (const msg of this._pendingNextTurnMessages) {
             messages.push(msg);

package/dist/app/index.d.ts

@@ -53,6 +53,6 @@ export type { SkillSyncStatusItem, SkillsSyncStatus } from './sync/skills-status
 export { uploadSkills } from './sync/skills-upload.js';
 export type { SkillUploadApprovalRequest, SkillsUploadResult } from './sync/skills-upload.js';
 export * from './tools/index.js';
-export { buildWorkbookPromptContext, fetchWorkbookConnectionState, formatWorkbookScopePromptContext } from './workbook-context/workbook-summary.js';
+export { buildWorkbookPromptContext, fetchWorkbookConnectionState, formatWorkbookScopeReminder } from './workbook-context/workbook-summary.js';
 export { SCOPE_UNSET, type WorkbookConnectionState, type WorkbookScopeDetails, type WorkbookScopeStateRef } from './workbook-scope.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/app/index.js

@@ -40,6 +40,6 @@ export { downloadSkillsWithApproval } from './sync/skills-download.js';
 export { checkSkillsSyncStatus } from './sync/skills-status.js';
 export { uploadSkills } from './sync/skills-upload.js';
 export * from './tools/index.js';
-export { buildWorkbookPromptContext, fetchWorkbookConnectionState, formatWorkbookScopePromptContext } from './workbook-context/workbook-summary.js';
+export { buildWorkbookPromptContext, fetchWorkbookConnectionState, formatWorkbookScopeReminder } from './workbook-context/workbook-summary.js';
 export { SCOPE_UNSET } from './workbook-scope.js';
 //# sourceMappingURL=index.js.map

package/dist/app/prompts/com-api-reference.json

@@ -1,215 +1,146 @@
-{
-  "interfaces": {
-    "Workbook": {
-      "docstring": "Workbook wrapper.\nUsage:\n    wb = Workbook(app.Workbooks(\"MyFile.xlsx\"))\n\nRaw COM access:\n    wb._wb  \u2014 the underlying COM Workbook object for direct platform API calls.\n    Example: wb._wb.Worksheets(\"Sheet1\").Visible = False",
-      "functions": {
-        "getSheetNames": {
-          "signature": "def getSheetNames() -> list[str]",
-          "docstring": "Get the names of all sheets in the workbook.",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "getWorkbookSummary": {
-          "signature": "def getWorkbookSummary() -> str",
-          "docstring": "Get sheet names and used ranges for this workbook.\nReturns lines like:\n    Sheets and their used ranges:\n      Sheet1: A1:D10 (active)\n      Inputs: (empty)",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "getSheet": {
-          "signature": "def getSheet(name: str) -> 'Worksheet'",
-          "docstring": "Get a sheet by name, returned as a wrapped Worksheet.",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "addSheet": {
-          "signature": "def addSheet(name: str, index: int | None = None) -> 'Worksheet'",
-          "docstring": "Add a new sheet at 0-based index. index=0 inserts before the first sheet.\nOmit index for Excel's default position.\nExample: wb.addSheet(\"NewSheet\", 0)  # insert as first sheet",
-          "tags": [
-            "action"
-          ]
-        },
-        "moveSheet": {
-          "signature": "def moveSheet(name: str, index: int) -> None",
-          "docstring": "Move a sheet to 0-based index. index=0 moves to first, index=Count-1 moves to last.\nExample: wb.moveSheet(\"Data\", 0)  # move to first position",
-          "tags": [
-            "action"
-          ]
-        },
-        "calculate": {
-          "signature": "def calculate() -> None",
-          "docstring": "Recalculate the entire workbook.\nDependent formulas don't update until after code block completes \u2014 read in a follow-up block.",
-          "tags": [
-            "action"
-          ]
-        },
-        "errorCheck": {
-          "signature": "def errorCheck(ranges: list[str] | None = None) -> str",
-          "docstring": "Scan for errors (#REF!, #DIV/0!, #NAME?, #VALUE!, #N/A, #NULL!, #NUM!). Ranges MUST include a sheet name (\"Sheet1\" or \"Sheet1!A1:D50\") \u2014 bare ranges like \"A1:D50\" will fail.\n      Args:\n          ranges: Optional sheet names (\"Sheet1\") or ranges (\"Sheet1!A1:D50\"). Omit to check all.\n      Returns:\n          \"No issues found.\" or \"Errors (N):\nSheet1!A1: #REF!\n...\"",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "copyPasteRange": {
-          "signature": "def copyPasteRange(from_range: str, to_address: str, paste_type: str = 'all', ) -> None",
-          "docstring": "Copy range within same workbook via range.Copy + PasteSpecial.\nAddresses must include sheet name. Do NOT use Sheet.Copy (broken via pywin32).\nExample: wb.copyPasteRange(\"Sheet1!A1:D10\", \"Sheet2!A1\", paste_type=\"values\")",
-          "tags": [
-            "action"
-          ]
-        },
-        "getNamedRangeInfo": {
-          "signature": "def getNamedRangeInfo(max_count: int = 50) -> str",
-          "docstring": "Get named ranges. Returns formatted string with name, reference, scope, and comment.\nExample output: \"Named Ranges (2):\\n  Name: TaxRate | Ref: =Settings!$B$2 | Scope: workbook | Comment: ...\"\nReturns \"No named ranges found.\" if none exist.",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        }
-      }
-    },
-    "Worksheet": {
-      "docstring": "Worksheet wrapper.\nUsage:\n    sheet = wb.getSheet(\"Sheet1\")\n\nRaw COM access:\n    sheet._ws  \u2014 the underlying COM Worksheet object for direct platform API calls.\n    Use for borders, text orientation, cell protection, and other properties not covered by the wrapper.\n    Example: sheet._ws.Range(\"A1\").Borders(9).LineStyle = 1  # xlEdgeBottom, xlContinuous",
-      "functions": {
-        "getSheetSummary": {
-          "signature": "def getSheetSummary() -> str",
-          "docstring": "Overview: name, used range, tables (with style/banded/header/total props),\npivots (with range), conditional formats (type/range/priority/stopIfTrue),\nautofilter (with filtering status), charts (with type).",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "getUsedRange": {
-          "signature": "def getUsedRange() -> str",
-          "docstring": "Get the used range address like \"A1:F20\", or \"\" if empty.",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "getCell": {
-          "signature": "def getCell(address: str, include_style: bool = True) -> str",
-          "docstring": "Formatted cell string: \"value(=FORMULA) (style_json)\". Formula always included.\nZero with custom format appends [0]: \"$ - [0]\".\nExample:\n    print(sheet.getCell(\"A1\"))\n    print(sheet.getCell(\"A1\", include_style=False))",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "getCellRange": {
-          "signature": "def getCellRange(range_addr: str, include_style: bool = True) -> str",
-          "docstring": "Markdown-like range: \"A1:Name | B1:Value\\nA2:Alice | B2:100\". Uses display text. Max 3000 cells; read larger areas in smaller chunks.\nAppends \"--- Style patterns ---\" section when include_style=True.",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "getRawCellData": {
-          "signature": "def getRawCellData(address: str, formula: bool = False) -> Any",
-          "docstring": "Get raw data value from a cell, preserving data type. Set formula=True to get the formula string.",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "getRawRangeData": {
-          "signature": "def getRawRangeData(range_addr: str, formula: bool = False) -> list[list[Any]]",
-          "docstring": "Get raw data for a range as 2D list. Always returns 2D list even for single row/column.",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "regexSearch": {
-          "signature": "def regexSearch(patterns: list[str], match_case: bool = False) -> list[dict]",
-          "docstring": "Regex search across used range using display text. Returns [{\"address\": \"A1\", \"value\": \"display text\"}, ...].\nExample: sheet.regexSearch([\"revenue\", \"cost\"])",
-          "tags": [
-            "action",
-            "ask"
-          ]
-        },
-        "setCell": {
-          "signature": "def setCell(address: str, value: Any, number_format: str | None = None, note: str | None = None, ) -> None",
-          "docstring": "Write value or formula. \"=\" prefix = formula. None or \"\" clears the cell.\nExamples:\n    sheet.setCell(\"A1\", 8000)\n    sheet.setCell(\"C1\", 0.15, number_format=\"0%\", note=\"Tax rate\")\n    sheet.setCell(\"B1\", \"=SUM(A1:A10)\")",
-          "tags": [
-            "action"
-          ]
-        },
-        "setCellRange": {
-          "signature": "def setCellRange(range_addr: str, values: list[list[Any]], number_format: str | None = None, ) -> None",
-          "docstring": "Bulk write \u2014 ALWAYS use for >100 cells. \"=\" prefix = formula.\nExamples:\n    sheet.setCellRange(\"A1:B2\", [[1, 2], [3, 4]])\n    sheet.setCellRange(\"A1:B2\", [[\"=SUM(C1)\", \"=SUM(D1)\"], [5, 6]], number_format=\"$#,##0\")",
-          "tags": [
-            "action"
-          ]
-        },
-        "autoFill": {
-          "signature": "def autoFill(source_range: str, target_range: str, fill_mode: str = 'auto', ) -> None",
-          "docstring": "Drag-fill. Source must be contained within target. Default \"auto\" increments hardcoded numeric literals; use fill_mode=\"constant\" to copy literal values, then read back destination cells and check for empty/NaN values.\nUse fill_mode=\"constant\" when copying a single value without incrementing.\nWARNING: Single numeric value with \"auto\" creates incrementing sequence (0,1,2,3...).\nExample: sheet.autoFill(\"A1:A2\", \"A1:A10\")",
-          "tags": [
-            "action"
-          ]
-        },
-        "addPicture": {
-          "signature": "def addPicture(name: str, base64_data: str, anchor_cell: str) -> None",
-          "docstring": "Add a picture from base64-encoded PNG or JPEG data. No data URI prefix.\nExample: sheet.addPicture(\"chart1\", base64_string, \"F2\")",
-          "tags": [
-            "action"
-          ]
-        },
-        "setIBTextColors": {
-          "signature": "def setIBTextColors(range_addr: str, ignored_constants: list[int] | None = None, colors: dict | None = None, ) -> None",
-          "docstring": "IB text colors for numeric inputs only. Text strings and booleans are left untouched.\n- Blue/16711680: hard-coded numeric constants (int/float)\n- Black/0: formulas (same-sheet references)\n- Green/32768: formulas with cross-sheet references (contains '!')\nColors are BGR integers (native COM format).\nExample: sheet.setIBTextColors(\"A1:D10\", ignored_constants=[0])",
-          "tags": [
-            "action"
-          ]
-        }
-      }
-    }
-  },
-  "helpers": {
-    "hex_to_bgr": {
-      "signature": "def hex_to_bgr(hex_str: str) -> int",
-      "docstring": "Convert \"#RRGGBB\" hex string to BGR integer for Excel COM.\nExample: ws.Range(\"A1\").Font.Color = hex_to_bgr(\"#FF0000\")  # red",
-      "tags": [
-        "action",
-        "ask"
-      ]
-    },
-    "index_to_address": {
-      "signature": "def index_to_address(row: int, col: int) -> str",
-      "docstring": "Convert 0-based (row, col) to Excel address: index_to_address(0, 0) \u2192 \"A1\".",
-      "tags": [
-        "action",
-        "ask"
-      ]
-    },
-    "address_to_index": {
-      "signature": "def address_to_index(address: str) -> tuple[int, int]",
-      "docstring": "Parse \"A1\" into (row, col) 0-based tuple: address_to_index(\"B3\") \u2192 (2, 1).",
-      "tags": [
-        "action",
-        "ask"
-      ]
-    },
-    "col_letter": {
-      "signature": "def col_letter(index: int) -> str",
-      "docstring": "Convert 0-based column index to letter: col_letter(26) \u2192 \"AA\".",
-      "tags": [
-        "action",
-        "ask"
-      ]
-    },
-    "col_index": {
-      "signature": "def col_index(letter: str) -> int",
-      "docstring": "Convert column letter to 0-based index: col_index(\"AA\") \u2192 26.",
-      "tags": [
-        "action",
-        "ask"
-      ]
-    }
-  }
-}
+{
+  "interfaces": {
+    "Workbook": {
+      "docstring": "Workbook wrapper.\nUsage:\n    wb = Workbook(app.Workbooks(\"MyFile.xlsx\"))\n\nRaw COM access:\n    wb._wb  \u2014 the underlying COM Workbook object for direct platform API calls.\n    Example: wb._wb.Worksheets(\"Sheet1\").Visible = False",
+      "functions": {
+        "getSheetNames": {
+          "signature": "def getSheetNames() -> list[str]",
+          "docstring": "Get the names of all sheets in the workbook.",
+          "tags": ["action", "ask"]
+        },
+        "getWorkbookSummary": {
+          "signature": "def getWorkbookSummary() -> str",
+          "docstring": "Get sheet names and used ranges for this workbook.\nReturns lines like:\n    Sheets and their used ranges:\n      Sheet1: A1:D10 (active)\n      Inputs: (empty)",
+          "tags": ["action", "ask"]
+        },
+        "getSheet": {
+          "signature": "def getSheet(name: str) -> 'Worksheet'",
+          "docstring": "Get a sheet by name, returned as a wrapped Worksheet.",
+          "tags": ["action", "ask"]
+        },
+        "addSheet": {
+          "signature": "def addSheet(name: str, index: int | None = None) -> 'Worksheet'",
+          "docstring": "Add a new sheet at 0-based index. index=0 inserts before the first sheet.\nOmit index for Excel's default position.\nExample: wb.addSheet(\"NewSheet\", 0)  # insert as first sheet",
+          "tags": ["action"]
+        },
+        "moveSheet": {
+          "signature": "def moveSheet(name: str, index: int) -> None",
+          "docstring": "Move a sheet to 0-based index. index=0 moves to first, index=Count-1 moves to last.\nExample: wb.moveSheet(\"Data\", 0)  # move to first position",
+          "tags": ["action"]
+        },
+        "calculate": {
+          "signature": "def calculate() -> None",
+          "docstring": "Recalculate the entire workbook.\nDependent formulas don't update until after code block completes \u2014 read in a follow-up block.",
+          "tags": ["action"]
+        },
+        "errorCheck": {
+          "signature": "def errorCheck(ranges: list[str] | None = None) -> str",
+          "docstring": "Scan for errors (#REF!, #DIV/0!, #NAME?, #VALUE!, #N/A, #NULL!, #NUM!). Ranges MUST include a sheet name (\"Sheet1\" or \"Sheet1!A1:D50\") \u2014 bare ranges like \"A1:D50\" will fail.\n      Args:\n          ranges: Optional sheet names (\"Sheet1\") or ranges (\"Sheet1!A1:D50\"). Omit to check all.\n      Returns:\n          \"No issues found.\" or \"Errors (N):\nSheet1!A1: #REF!\n...\"",
+          "tags": ["action", "ask"]
+        },
+        "copyPasteRange": {
+          "signature": "def copyPasteRange(from_range: str, to_address: str, paste_type: str = 'all', ) -> None",
+          "docstring": "Copy range within same workbook via range.Copy + PasteSpecial.\nAddresses must include sheet name. Do NOT use Sheet.Copy (broken via pywin32).\nExample: wb.copyPasteRange(\"Sheet1!A1:D10\", \"Sheet2!A1\", paste_type=\"values\")",
+          "tags": ["action"]
+        },
+        "getNamedRangeInfo": {
+          "signature": "def getNamedRangeInfo(max_count: int = 50) -> str",
+          "docstring": "Get named ranges. Returns formatted string with name, reference, scope, and comment.\nExample output: \"Named Ranges (2):\\n  Name: TaxRate | Ref: =Settings!$B$2 | Scope: workbook | Comment: ...\"\nReturns \"No named ranges found.\" if none exist.",
+          "tags": ["action", "ask"]
+        }
+      }
+    },
+    "Worksheet": {
+      "docstring": "Worksheet wrapper.\nUsage:\n    sheet = wb.getSheet(\"Sheet1\")\n\nRaw COM access:\n    sheet._ws  \u2014 the underlying COM Worksheet object for direct platform API calls.\n    Use for borders, text orientation, cell protection, and other properties not covered by the wrapper.\n    Example: sheet._ws.Range(\"A1\").Borders(9).LineStyle = 1  # xlEdgeBottom, xlContinuous",
+      "functions": {
+        "getSheetSummary": {
+          "signature": "def getSheetSummary() -> str",
+          "docstring": "Overview: name, used range, tables (with style/banded/header/total props),\npivots (with range), conditional formats (type/range/priority/stopIfTrue),\nautofilter (with filtering status), charts (with type).",
+          "tags": ["action", "ask"]
+        },
+        "getUsedRange": {
+          "signature": "def getUsedRange() -> str",
+          "docstring": "Get the used range address like \"A1:F20\", or \"\" if empty.",
+          "tags": ["action", "ask"]
+        },
+        "getCell": {
+          "signature": "def getCell(address: str, include_style: bool = True) -> str",
+          "docstring": "Formatted cell string: \"value(=FORMULA) (style_json)\". Formula always included.\nZero with custom format appends [0]: \"$ - [0]\".\nExample:\n    print(sheet.getCell(\"A1\"))\n    print(sheet.getCell(\"A1\", include_style=False))",
+          "tags": ["action", "ask"]
+        },
+        "getCellRange": {
+          "signature": "def getCellRange(range_addr: str, include_style: bool = True) -> str",
+          "docstring": "Markdown-like range: \"A1:Name | B1:Value\\nA2:Alice | B2:100\". Uses display text. Max 3000 cells; read larger areas in smaller chunks.\nAppends \"--- Style patterns ---\" section when include_style=True.",
+          "tags": ["action", "ask"]
+        },
+        "getRawCellData": {
+          "signature": "def getRawCellData(address: str, formula: bool = False) -> Any",
+          "docstring": "Get raw data value from a cell, preserving data type. Set formula=True to get the formula string.",
+          "tags": ["action", "ask"]
+        },
+        "getRawRangeData": {
+          "signature": "def getRawRangeData(range_addr: str, formula: bool = False) -> list[list[Any]]",
+          "docstring": "Get raw data for a range as 2D list. Always returns 2D list even for single row/column.",
+          "tags": ["action", "ask"]
+        },
+        "regexSearch": {
+          "signature": "def regexSearch(patterns: list[str], match_case: bool = False) -> list[dict]",
+          "docstring": "Regex search across used range using display text. Returns [{\"address\": \"A1\", \"value\": \"display text\"}, ...].\nExample: sheet.regexSearch([\"revenue\", \"cost\"])",
+          "tags": ["action", "ask"]
+        },
+        "setCell": {
+          "signature": "def setCell(address: str, value: Any, number_format: str | None = None, note: str | None = None, ) -> None",
+          "docstring": "Write value or formula. \"=\" prefix = formula. None or \"\" clears the cell.\nExamples:\n    sheet.setCell(\"A1\", 8000)\n    sheet.setCell(\"C1\", 0.15, number_format=\"0%\", note=\"Tax rate\")\n    sheet.setCell(\"B1\", \"=SUM(A1:A10)\")",
+          "tags": ["action"]
+        },
+        "setCellRange": {
+          "signature": "def setCellRange(range_addr: str, values: list[list[Any]], number_format: str | None = None, ) -> None",
+          "docstring": "Bulk write \u2014 ALWAYS use for >100 cells. \"=\" prefix = formula.\nExamples:\n    sheet.setCellRange(\"A1:B2\", [[1, 2], [3, 4]])\n    sheet.setCellRange(\"A1:B2\", [[\"=SUM(C1)\", \"=SUM(D1)\"], [5, 6]], number_format=\"$#,##0\")",
+          "tags": ["action"]
+        },
+        "autoFill": {
+          "signature": "def autoFill(source_range: str, target_range: str, fill_mode: str = 'auto', ) -> None",
+          "docstring": "Drag-fill. Source must be contained within target. Default \"auto\" increments hardcoded numeric literals; use fill_mode=\"constant\" to copy literal values, then read back destination cells and check for empty/NaN values.\nUse fill_mode=\"constant\" when copying a single value without incrementing.\nWARNING: Single numeric value with \"auto\" creates incrementing sequence (0,1,2,3...).\nExample: sheet.autoFill(\"A1:A2\", \"A1:A10\")",
+          "tags": ["action"]
+        },
+        "addPicture": {
+          "signature": "def addPicture(name: str, base64_data: str, anchor_cell: str) -> None",
+          "docstring": "Add a picture from base64-encoded PNG or JPEG data. No data URI prefix.\nExample: sheet.addPicture(\"chart1\", base64_string, \"F2\")",
+          "tags": ["action"]
+        },
+        "setIBTextColors": {
+          "signature": "def setIBTextColors(range_addr: str, ignored_constants: list[int] | None = None, colors: dict | None = None, ) -> None",
+          "docstring": "IB text colors for numeric inputs only. Text strings and booleans are left untouched.\n- Blue/16711680: hard-coded numeric constants (int/float)\n- Black/0: formulas (same-sheet references)\n- Green/32768: formulas with cross-sheet references (contains '!')\nColors are BGR integers (native COM format).\nExample: sheet.setIBTextColors(\"A1:D10\", ignored_constants=[0])",
+          "tags": ["action"]
+        }
+      }
+    }
+  },
+  "helpers": {
+    "hex_to_bgr": {
+      "signature": "def hex_to_bgr(hex_str: str) -> int",
+      "docstring": "Convert \"#RRGGBB\" hex string to BGR integer for Excel COM.\nExample: ws.Range(\"A1\").Font.Color = hex_to_bgr(\"#FF0000\")  # red",
+      "tags": ["action", "ask"]
+    },
+    "index_to_address": {
+      "signature": "def index_to_address(row: int, col: int) -> str",
+      "docstring": "Convert 0-based (row, col) to Excel address: index_to_address(0, 0) \u2192 \"A1\".",
+      "tags": ["action", "ask"]
+    },
+    "address_to_index": {
+      "signature": "def address_to_index(address: str) -> tuple[int, int]",
+      "docstring": "Parse \"A1\" into (row, col) 0-based tuple: address_to_index(\"B3\") \u2192 (2, 1).",
+      "tags": ["action", "ask"]
+    },
+    "col_letter": {
+      "signature": "def col_letter(index: int) -> str",
+      "docstring": "Convert 0-based column index to letter: col_letter(26) \u2192 \"AA\".",
+      "tags": ["action", "ask"]
+    },
+    "col_index": {
+      "signature": "def col_index(letter: str) -> int",
+      "docstring": "Convert column letter to 0-based index: col_index(\"AA\") \u2192 26.",
+      "tags": ["action", "ask"]
+    }
+  }
+}

package/dist/app/session/permission-context.d.ts

@@ -1,3 +1,3 @@
 import type { RuntimePermissionPolicy } from '../../core/index.js';
-export declare function formatRuntimePermissionBypassContext(policy: RuntimePermissionPolicy): string;
+export declare function formatRuntimePermissionBypassReminder(policy: RuntimePermissionPolicy): string;
 //# sourceMappingURL=permission-context.d.ts.map

package/dist/app/session/permission-context.js

@@ -1,4 +1,4 @@
-export function formatRuntimePermissionBypassContext(policy) {
-    return `Runtime permissions bypass: ${policy.dangerouslySkipRuntimePermissions ? 'enabled' : 'disabled'}`;
+export function formatRuntimePermissionBypassReminder(policy) {
+    return `Runtime permissions bypass: ${policy.dangerouslySkipRuntimePermissions ? 'enabled' : 'disabled'}.`;
 }
 //# sourceMappingURL=permission-context.js.map

package/dist/app/session/system-reminder-context.d.ts

@@ -0,0 +1,2 @@
+export declare function formatSystemReminderContext(lines: string[]): string;
+//# sourceMappingURL=system-reminder-context.d.ts.map

package/dist/app/session/system-reminder-context.js

@@ -0,0 +1,8 @@
+export function formatSystemReminderContext(lines) {
+    const text = lines
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .join('\n');
+    return `<system_reminder>\n${text}\n</system_reminder>`;
+}
+//# sourceMappingURL=system-reminder-context.js.map

package/dist/app/workbook-context/workbook-summary.d.ts

@@ -13,7 +13,7 @@ export interface WorkbookPromptContext {
 type WorkbookPromptReminderDetails = WorkbookConnectionState & {
     scopeMode?: ActiveScopeMode;
 };
-export declare function formatWorkbookScopePromptContext(details: WorkbookPromptReminderDetails): string;
+export declare function formatWorkbookScopeReminder(details: WorkbookPromptReminderDetails): string;
 export declare function fetchWorkbookConnectionState(httpUrl?: string): Promise<WorkbookConnectionState>;
 export declare function buildWorkbookPromptContext(connectionState: WorkbookConnectionState, scope: WorkbookScope): WorkbookPromptContext;
 export {};