shortcutxl 0.3.34 → 0.3.35

package/CHANGELOG.md

@@ -1,12 +1,17 @@
-# Changelog
-
-## [0.3.34]
-
-- **Revamped update flow** - When an update is available at launch, ShortcutXL now prompts before the shell starts and runs the update in the foreground.
-- **Import skills from Claude Code and Codex** - New `/port-skills` lets you register skills from Claude Code, Codex, and `.agents` folders.
-- **Better `/autonomous` continuation** - Long-running autonomous tasks now continue more cleanly after a context refresh instead of losing the thread mid-run.
-
-## [0.2.32]
+# Changelog
+
+## [0.3.35]
+
+- **Edit-mode detection** — When you're editing a cell, ShortcutXL now detects it and waits instead of throwing a cryptic COM error. You'll see a prompt asking you to press Enter or Escape, and execution resumes automatically.
+- **Bug fixes** — General stability and reliability improvements across credit reporting, Excel operations, session resumption, and concurrency.
+
+## [0.3.34]
+
+- **Revamped update flow** - When an update is available at launch, ShortcutXL now prompts before the shell starts and runs the update in the foreground.
+- **Import skills from Claude Code and Codex** - New `/port-skills` lets you register skills from Claude Code, Codex, and `.agents` folders.
+- **Better `/autonomous` continuation** - Long-running autonomous tasks now continue more cleanly after a context refresh instead of losing the thread mid-run.
+
+## [0.2.32]
 
 - **Durable memory** - ShortcutXL now remembers useful context across sessions, so you no longer need to repeat the same preferences and project details every time you start a new conversation.
 - **Faster and more reliable tool use** - Read-only tools can run while the assistant is still streaming, interrupted turns recover more gracefully, and long responses continue more reliably.

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

@@ -0,0 +1,6 @@
+import type { AgentMessage } from '../../core/index.js';
+import type { ModelRegistry } from '../providers/model-registry.js';
+type CreditModelLookup = Pick<ModelRegistry, 'find' | 'getAll'>;
+export declare function computeSessionCreditsUsed(messages: AgentMessage[], modelRegistry: CreditModelLookup): number;
+export {};
+//# sourceMappingURL=session-credits.d.ts.map

package/dist/app/credits/shortcut-credits.d.ts

@@ -7,6 +7,7 @@
 interface CreditBalance {
     creditsRemaining: number;
     isUnlimited: boolean;
+    hasTeamBilling: boolean;
 }
 /**
  * Fetch the current credit balance for a Shortcut-authenticated user.

package/dist/app/index.d.ts

@@ -37,6 +37,7 @@ export type { SessionPersistenceBackend } from './session/session-persistence-ba
 export type { SessionEntry, SessionHeader, SessionInfoEntry, SessionMessageEntry } from './session/session-schema.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 type { StartupInfoEntry } from './startup-info.js';
 export { downloadSkills } from './sync/skills-download.js';
 export { uploadSkills } from './sync/skills-upload.js';
 export type { SkillUploadApprovalRequest, SkillsUploadResult } from './sync/skills-upload.js';

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

@@ -6,47 +6,70 @@
         "getSheetNames": {
           "signature": "def getSheetNames() -> list[str]",
           "docstring": "Get the names of all sheets in the workbook.",
-          "tags": ["action", "ask"]
+          "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"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "getSheet": {
           "signature": "def getSheet(name: str) -> 'Worksheet'",
           "docstring": "Get a sheet by name, returned as a wrapped Worksheet.",
-          "tags": ["action", "ask"]
+          "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"]
+          "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"]
+          "tags": [
+            "action"
+          ]
         },
         "calculate": {
           "signature": "def calculate() -> None",
           "docstring": "Recalculate the entire workbook.\nDependent formulas don't update until after code block completes \u00e2\u20ac\u201d read in a follow-up block.",
-          "tags": ["action"]
+          "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!).\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"]
+          "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"]
+          "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"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         }
       }
     },
@@ -56,62 +79,93 @@
         "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"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "getUsedRange": {
           "signature": "def getUsedRange() -> str",
           "docstring": "Get the used range address like \"A1:F20\", or \"\" if empty.",
-          "tags": ["action", "ask"]
+          "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"]
+          "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.\nAppends \"--- Style patterns ---\" section when include_style=True.",
-          "tags": ["action", "ask"]
+          "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"]
+          "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"]
+          "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"]
+          "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"]
+          "tags": [
+            "action"
+          ]
         },
         "setCellRange": {
           "signature": "def setCellRange(range_addr: str, values: list[list[Any]], number_format: str | None = None, ) -> None",
           "docstring": "Bulk write \u00e2\u20ac\u201d 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"]
+          "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.\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"]
+          "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"]
+          "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"]
+          "tags": [
+            "action"
+          ]
         }
       }
     }
@@ -120,27 +174,42 @@
     "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"]
+      "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) \u00e2\u2020\u2019 \"A1\".",
-      "tags": ["action", "ask"]
+      "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\") \u00e2\u2020\u2019 (2, 1).",
-      "tags": ["action", "ask"]
+      "tags": [
+        "action",
+        "ask"
+      ]
     },
     "col_letter": {
       "signature": "def col_letter(index: int) -> str",
       "docstring": "Convert 0-based column index to letter: col_letter(26) \u00e2\u2020\u2019 \"AA\".",
-      "tags": ["action", "ask"]
+      "tags": [
+        "action",
+        "ask"
+      ]
     },
     "col_index": {
       "signature": "def col_index(letter: str) -> int",
       "docstring": "Convert column letter to 0-based index: col_index(\"AA\") \u00e2\u2020\u2019 26.",
-      "tags": ["action", "ask"]
+      "tags": [
+        "action",
+        "ask"
+      ]
     }
   }
 }

package/dist/app/settings-manager.d.ts

@@ -63,6 +63,10 @@ export interface SandboxSettings {
     network?: 'none' | 'proxy' | 'full';
     allowedDomains?: string[];
 }
+export interface RemoteControlSettings {
+    enabled?: boolean;
+    provider?: 'whatsapp';
+}
 /** Concrete sandbox defaults — always called at runtime so paths resolve correctly. */
 export declare function getDefaultSandboxSettings(): Required<SandboxSettings>;
 export type TransportSetting = Transport;
@@ -124,6 +128,7 @@ export interface Settings {
         fallbackModel?: string;
         stripThinking?: boolean;
     };
+    remoteControl?: RemoteControlSettings;
 }
 export type SettingsScope = 'global' | 'project';
 export interface SettingsStorage {
@@ -326,6 +331,9 @@ export declare class SettingsManager {
     getToolSummariesEnabled(): boolean;
     setToolSummariesEnabled(enabled: boolean): void;
     getDurableMemoryEnabled(): boolean;
+    getRemoteControlEnabled(): boolean;
+    getRemoteControlProvider(): RemoteControlSettings['provider'];
+    setRemoteControl(config: RemoteControlSettings): void;
     setDurableMemoryEnabled(enabled: boolean): void;
     /** Remove a connection's metadata. */
     removeConnection(name: string): void;

package/dist/app/startup-info.d.ts

@@ -0,0 +1,5 @@
+export type StartupInfoEntry = string | {
+    message: string;
+    tone?: 'dim' | 'success';
+};
+//# sourceMappingURL=startup-info.d.ts.map

package/dist/app/tools/execute-code/com-executor.d.ts

@@ -11,14 +11,17 @@
  */
 import { type ApprovalChoice, type ApprovalGate, type ApprovalRequest } from '../../approvals/types.js';
 import type { ExtensionContext } from '../../extensions/index.js';
+import { type LocalExcelHttpUrl } from '../../xll/http-url.js';
 import type { ExcelApprovalPayload } from './approval-payload.js';
 import { type DiffPayload } from './diff.js';
+import { type EditModeRetryTiming } from './edit-mode-retry.js';
 export interface ComExecResult {
     ok: boolean;
     output?: string;
     error?: string;
     diff?: DiffPayload;
     cfTxId?: string;
+    editMode?: boolean;
 }
 export type ApprovalOutcome = 'accepted' | 'reverted' | 'revert-failed' | 'rejected';
 export interface LocalExecResult {
@@ -32,7 +35,6 @@ export interface ExcelExecApprovalObservability {
     onReverted?: (request: ApprovalRequest<ExcelApprovalPayload>) => void;
     onRevertFailed?: (request: ApprovalRequest<ExcelApprovalPayload>) => void;
 }
-export type ExcelHttpEndpoint = number | string | (() => string) | undefined;
 /** Validate that a parsed JSON value has the COM execute result shape. */
 export declare function isComExecResult(v: unknown): v is ComExecResult;
 /**
@@ -45,10 +47,11 @@ export declare function resolveApproval(result: ComExecResult, approval: Approva
  * This is the reusable core for desktop-local COM execution.
  * The XLL endpoint (`httpUrl`) is always local to the machine running the agent.
  */
-export declare function executeComLocally(httpEndpoint: ExcelHttpEndpoint, code: string, options?: {
+export declare function executeComLocally(excelHttpUrl: LocalExcelHttpUrl | undefined, code: string, options?: {
     approval?: ApprovalGate<ExcelApprovalPayload>;
     ctx?: ExtensionContext;
     signal?: AbortSignal;
     observability?: ExcelExecApprovalObservability;
+    editModeTiming?: Partial<EditModeRetryTiming>;
 }): Promise<LocalExecResult>;
 //# sourceMappingURL=com-executor.d.ts.map

package/dist/app/tools/execute-code/com.d.ts

@@ -8,11 +8,11 @@
 import type { ToolDefinition } from '../../../core/core-types.js';
 import type { ApprovalGate } from '../../approvals/types.js';
 import type { ExcelApprovalPayload } from './approval-payload.js';
-import { type ComExecResult, type ExcelExecApprovalObservability, type ExcelHttpEndpoint } from './com-executor.js';
+import { type ComExecResult, type ExcelExecApprovalObservability } from './com-executor.js';
 declare const schema: import("@sinclair/typebox").TObject<{
     description: import("@sinclair/typebox").TString;
     code: import("@sinclair/typebox").TString;
 }>;
-export declare function createExcelExecTool(httpEndpoint?: ExcelHttpEndpoint, approval?: ApprovalGate<ExcelApprovalPayload>, observability?: ExcelExecApprovalObservability): ToolDefinition<typeof schema, ComExecResult>;
+export declare function createExcelExecTool(httpPort?: number, approval?: ApprovalGate<ExcelApprovalPayload>, observability?: ExcelExecApprovalObservability): ToolDefinition<typeof schema, ComExecResult>;
 export {};
 //# sourceMappingURL=com.d.ts.map

package/dist/app/tools/execute-code/edit-mode-retry.d.ts

@@ -0,0 +1,18 @@
+import type { ExtensionContext } from '../../extensions/index.js';
+export interface EditModeAwareResult {
+    editMode?: boolean;
+}
+export interface EditModeRetryTiming {
+    retryIntervalMs: number;
+    blockingPromptAfterMs: number;
+    promptCooldownMs: number;
+}
+export declare function getEditModeAbortMessage(): string;
+export declare function isEditModeAbortError(error: unknown): boolean;
+export declare function resolveEditModeRetry<TResult extends EditModeAwareResult>(initialResult: TResult, options: {
+    ctx?: Pick<ExtensionContext, 'hasUI' | 'ui'>;
+    signal?: AbortSignal;
+    send: () => Promise<TResult>;
+    timing?: Partial<EditModeRetryTiming>;
+}): Promise<TResult>;
+//# sourceMappingURL=edit-mode-retry.d.ts.map

package/dist/app/tools/execute-code/index.d.ts

@@ -1,6 +1,6 @@
 import type { ApprovalGate } from '../../approvals/types.js';
 import type { ExcelApprovalPayload } from './approval-payload.js';
-import type { ExcelExecApprovalObservability, ExcelHttpEndpoint } from './com-executor.js';
+import type { ExcelExecApprovalObservability } from './com-executor.js';
 import { createExcelExecTool } from './com.js';
 import { createSheetExecTool } from './mog.js';
 export type { ExcelApprovalPayload } from './approval-payload.js';
@@ -9,7 +9,6 @@ export type ExecuteCodePlatform = 'com' | 'mog';
 export type ExecuteCodeFactoryOptions = {
     platform: 'com';
     httpPort?: number;
-    httpUrl?: ExcelHttpEndpoint;
     approval?: ApprovalGate<ExcelApprovalPayload>;
     observability?: ExcelExecApprovalObservability;
 } | {

package/dist/app/xll/endpoint.d.ts

@@ -1,9 +1,9 @@
+import { type LocalExcelHttpUrl } from './http-url.js';
 import { type XllSession } from './session.js';
 type ExcelHttpResolverOptions = {
-    env?: NodeJS.ProcessEnv;
     session?: Pick<XllSession, 'port'> | null;
 };
-export declare function resolveEffectiveExcelHttpUrl(options?: ExcelHttpResolverOptions): string;
-export declare function getEffectiveExcelHttpUrl(): string;
+export declare function resolveEffectiveExcelHttpUrl(options?: ExcelHttpResolverOptions): LocalExcelHttpUrl;
+export declare function getEffectiveExcelHttpUrl(): LocalExcelHttpUrl;
 export {};
 //# sourceMappingURL=endpoint.d.ts.map

package/dist/app/xll/http-url.d.ts

@@ -1,8 +1,16 @@
+export type LocalExcelHttpUrl = string & {
+    readonly __localExcelHttpUrl: unique symbol;
+};
 /**
  * Normalize the Excel XLL base URL and reject anything that is not loopback HTTP.
  * Returning `origin` strips any path/query/fragment before callers append fixed endpoints.
  */
-export declare function requireLocalExcelHttpUrl(httpUrl: string): string;
+export declare function requireLocalExcelHttpUrl(httpUrl: string): LocalExcelHttpUrl;
+/**
+ * Normalize a full Excel XLL request URL and reject anything that is not loopback HTTP.
+ * Unlike `requireLocalExcelHttpUrl`, this preserves the request path/query/fragment.
+ */
+export declare function requireLocalExcelHttpRequestUrl(httpUrl: string): LocalExcelHttpUrl;
 export declare function parseExcelHttpPort(value: string | number): number;
-export declare function buildLocalExcelHttpUrl(port: string | number): string;
+export declare function buildLocalExcelHttpUrl(port: string | number): LocalExcelHttpUrl;
 //# sourceMappingURL=http-url.d.ts.map