shortcutxl 0.2.19 → 0.2.21

package/dist/custom/sandbox/tests/test-helpers.js

@@ -0,0 +1,24 @@
+/**
+ * Shared test helpers for sandbox tests.
+ */
+import { toLinuxPath } from '../lib/index.js';
+import { join } from 'path';
+import { getAgentDir } from '../../../config.js';
+import { getDefaultSandboxSettings } from '../../../core/settings-manager.js';
+/** Map agent defaults to the package's SandboxConfig for integration tests. */
+export function agentDefaults() {
+    const settings = getDefaultSandboxSettings();
+    const pipDir = toLinuxPath(join(getAgentDir(), 'pip-packages'));
+    return {
+        readPaths: settings.readPaths,
+        writePaths: settings.writePaths,
+        networkMode: settings.network,
+        env: {
+            PYTHONUSERBASE: pipDir,
+            PIP_USER: '1',
+            PIP_BREAK_SYSTEM_PACKAGES: '1',
+            PATH: `${pipDir}/bin:/usr/local/bin:/usr/bin:/bin`
+        }
+    };
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/custom/sheet-api/api-guidelines.js

@@ -0,0 +1,83 @@
+/**
+ * Headless sheet engine API guidelines for the agent system prompt.
+ *
+ * Replaces the COM API guidelines when running in sheet mode.
+ * Generated from:
+ *   1. os/docs/generated/api-reference.json  (signatures + docstrings from contracts)
+ *   2. ./api-overlay.ts                       (agent policy: allowlist, tags, overrides)
+ */
+import { WORKBOOK_DOC_OVERRIDES, WORKBOOK_METHODS, WORKBOOK_PATCHES, WORKSHEET_DOC_OVERRIDES, WORKSHEET_METHODS, WORKSHEET_PATCHES } from './api-overlay.js';
+import { loadApiReference } from './api-reference-loader.js';
+// ---------------------------------------------------------------------------
+// Resolve a single method: JSON → patch → doc override
+// ---------------------------------------------------------------------------
+function resolveLine(name, json, patches, docOverrides, overlayDoc) {
+    const gen = json[name];
+    const patch = patches[name];
+    const sig = gen?.signature ?? patch?.signature;
+    if (!sig) {
+        console.warn(`[api-guidelines] "${name}" not in generated JSON or patches`);
+        return null;
+    }
+    const doc = overlayDoc ?? docOverrides[name] ?? gen?.docstring ?? patch?.docstring ?? null;
+    return doc ? `${sig}  // ${doc.split('\n')[0]}` : sig;
+}
+// ---------------------------------------------------------------------------
+// Build the full prompt
+// ---------------------------------------------------------------------------
+function renderSection(title, allowlist, json, patches, docOverrides) {
+    const lines = [`### ${title}`];
+    let currentNs = '';
+    for (const name of Object.keys(allowlist)) {
+        // Group by namespace (e.g. "formats" from "formats.set")
+        const dot = name.indexOf('.');
+        const ns = dot >= 0 ? name.slice(0, dot) : '';
+        if (ns !== currentNs) {
+            currentNs = ns;
+            if (ns)
+                lines.push(`\n${ns}:`);
+        }
+        const line = resolveLine(name, json, patches, docOverrides, allowlist[name].doc);
+        if (line)
+            lines.push(line);
+    }
+    return lines.join('\n');
+}
+export function getSheetApiGuidelines() {
+    const ref = loadApiReference();
+    const wsJson = ref.Worksheet;
+    const wbJson = ref.Workbook;
+    const ws = renderSection('Worksheet API (ws = worksheet)', WORKSHEET_METHODS, wsJson, WORKSHEET_PATCHES, WORKSHEET_DOC_OVERRIDES);
+    const wb = renderSection('Workbook API (wb = workbook)', WORKBOOK_METHODS, wbJson, WORKBOOK_PATCHES, WORKBOOK_DOC_OVERRIDES);
+    return `\
+===========================
+## Spreadsheet API Guidelines
+===========================
+Code runs in a TypeScript sandbox. All methods are async — always use \`await\`.
+Each execution is isolated — variables don't persist between calls.
+But workbooks persist across calls (like Excel staying open).
+
+### Sandbox Globals
+Convenience aliases (point to the most recently opened/created workbook):
+- \`workbook\` — the active Workbook
+- \`worksheet\` — the active Worksheet of that Workbook
+- \`console.log()\` — output captured and returned to you
+- \`getMethodInfo(name)\` — look up API docs for any method not listed below.
+  Pass a namespace to list all methods: \`getMethodInfo("slicers")\`
+  Pass a specific method for its signature: \`getMethodInfo("slicers.add")\`
+  Discoverable namespaces: charts, tables, filters, pivots, conditionalFormats, validation, slicers, sparklines, hyperlinks, outline, protection, print, objects, settings, bindings
+
+Workbook lifecycle:
+- \`createWorkbook(name?)\` — create blank workbook (auto-named "Book1" etc.), returns Workbook
+- \`loadWorkbook(path)\` — load xlsx from disk, returns Workbook. Keyed by basename (e.g. \`loadWorkbook("/tmp/Budget.xlsx")\` → keyed as \`"Budget.xlsx"\`)
+- \`getWorkbook(name)\` — get an already-open workbook by its key (the basename from loadWorkbook, or "Book1" etc. from createWorkbook)
+- \`listWorkbooks()\` — list all open workbook keys
+- \`saveWorkbook(path, wb?)\` — export workbook to xlsx on disk, defaults to active workbook
+- \`closeWorkbook(name)\` — close a workbook and free resources
+
+${wb}
+
+${ws}
+`;
+}
+//# sourceMappingURL=api-guidelines.js.map

package/dist/custom/sheet-api/api-lookup.js

@@ -0,0 +1,69 @@
+/**
+ * Runtime API method lookup for the agent sandbox.
+ *
+ * Loads `agent-docs/api-reference.json` (copied from os/ at build time)
+ * and provides a lookup function the agent can call to discover
+ * Worksheet/Workbook API methods it doesn't see in the system prompt.
+ *
+ * Usage in sandbox:
+ *   getMethodInfo("slicers")        → lists all slicers.* methods
+ *   getMethodInfo("slicers.add")    → signature + docs for that method
+ *   getMethodInfo("setCell")        → signature + docs for ws.setCell
+ */
+import { loadApiReference } from './api-reference-loader.js';
+function ensureLoaded() {
+    const ref = loadApiReference();
+    return { ws: ref.Worksheet, wb: ref.Workbook };
+}
+// ---------------------------------------------------------------------------
+// Lookup
+// ---------------------------------------------------------------------------
+function formatEntry(name, entry, prefix) {
+    const lines = [`// ${prefix}.${name}`];
+    if (entry.docstring)
+        lines.push(`// ${entry.docstring.split('\n')[0]}`);
+    lines.push(entry.signature);
+    return lines.join('\n');
+}
+/**
+ * Look up API method docs. Exposed as a sandbox global.
+ *
+ * - Exact match: getMethodInfo("slicers.add") → that method's docs
+ * - Namespace:   getMethodInfo("slicers")     → all slicers.* methods
+ * - Root method: getMethodInfo("setCell")     → ws.setCell docs
+ */
+export function getMethodInfo(query) {
+    const { ws, wb } = ensureLoaded();
+    // 1. Exact match in either interface
+    const wsHit = ws[query];
+    if (wsHit)
+        return formatEntry(query, wsHit, 'ws');
+    const wbHit = wb[query];
+    if (wbHit)
+        return formatEntry(query, wbHit, 'wb');
+    // 2. Namespace prefix — collect all matching methods
+    const prefix = query.endsWith('.') ? query : query + '.';
+    const matches = [];
+    for (const [name, entry] of Object.entries(ws)) {
+        if (name.startsWith(prefix)) {
+            matches.push(formatEntry(name, entry, 'ws'));
+        }
+    }
+    for (const [name, entry] of Object.entries(wb)) {
+        if (name.startsWith(prefix)) {
+            matches.push(formatEntry(name, entry, 'wb'));
+        }
+    }
+    if (matches.length > 0) {
+        return `${matches.length} method(s) in ${query}:\n\n${matches.join('\n\n')}`;
+    }
+    // 3. List available namespaces as help
+    const namespaces = new Set();
+    for (const name of Object.keys(ws)) {
+        const dot = name.indexOf('.');
+        if (dot >= 0)
+            namespaces.add(name.slice(0, dot));
+    }
+    return `No method "${query}" found. Available namespaces: ${[...namespaces].sort().join(', ')}. Root methods: setCell, getRange, describe, describeRange, summarize, etc.`;
+}
+//# sourceMappingURL=api-lookup.js.map

package/dist/custom/sheet-api/api-overlay.js

@@ -0,0 +1,133 @@
+/**
+ * Agent API overlay — allowlist, tags, and doc overrides for the OS API.
+ *
+ * Only CORE methods go here — these appear in the system prompt.
+ * Everything else is discoverable at runtime via getMethodInfo().
+ *
+ * The generated reference (agent-docs/api-reference.json) contains every
+ * method. This overlay controls what the agent sees upfront.
+ */
+// ========================== WORKSHEET ======================================
+export const WORKSHEET_METHODS = {
+    // --- Identity ---
+    getName: { tags: ['action', 'ask'] },
+    setName: { tags: ['action', 'approval'] },
+    // --- Cell read/write ---
+    setCell: { tags: ['action', 'approval'] },
+    getCell: { tags: ['action', 'ask'] },
+    getValue: { tags: ['action', 'ask'] },
+    getRange: { tags: ['action', 'ask'] },
+    setRange: {
+        tags: ['action', 'approval'],
+        doc: 'Bulk set cell contents. ALWAYS use this instead of setCell() loops for >100 cells.'
+    },
+    getData: { tags: ['action', 'ask'] },
+    getFormula: { tags: ['action', 'ask'] },
+    clearData: { tags: ['action', 'approval'] },
+    // --- LLM presentation ---
+    describe: {
+        tags: ['action', 'ask'],
+        doc: 'Human-readable cell description: "Revenue | =SUM(B2:B10) | [bold]". Prefer over getCell for context.'
+    },
+    describeRange: {
+        tags: ['action', 'ask'],
+        doc: 'Tabular range description with formula abbreviation. Prefer over getRange for reading context.'
+    },
+    summarize: {
+        tags: ['action', 'ask'],
+        doc: 'Sheet overview: name, used range, dimensions, tables, charts, named ranges.'
+    },
+    // --- Query & search ---
+    getUsedRange: { tags: ['action', 'ask'] },
+    findByValue: { tags: ['action', 'ask'] },
+    regexSearch: { tags: ['action', 'ask'] },
+    // --- Sort / batch / autofill ---
+    sortRange: { tags: ['action', 'approval'] },
+    autoFill: { tags: ['action', 'approval'] },
+    batchSetCells: {
+        tags: ['action', 'approval'],
+        doc: 'Batch-write cell values. More efficient than setCell() in a loop.'
+    },
+    // --- Visibility ---
+    isVisible: { tags: ['action', 'ask'] },
+    setVisible: { tags: ['action', 'approval'] },
+    // --- formats (core) ---
+    'formats.set': { tags: ['action', 'approval'] },
+    'formats.setRange': { tags: ['action', 'approval'] },
+    'formats.get': { tags: ['action', 'ask'] },
+    'formats.clear': { tags: ['action', 'approval'] },
+    // --- structure (core) ---
+    'structure.insertRows': { tags: ['action', 'approval'] },
+    'structure.deleteRows': { tags: ['action', 'approval'] },
+    'structure.insertColumns': { tags: ['action', 'approval'] },
+    'structure.deleteColumns': { tags: ['action', 'approval'] },
+    'structure.merge': { tags: ['action', 'approval'] },
+    'structure.unmerge': { tags: ['action', 'approval'] },
+    // --- layout (core) ---
+    'layout.setRowHeight': { tags: ['action', 'approval'] },
+    'layout.setColumnWidth': { tags: ['action', 'approval'] },
+    'layout.autoFitColumn': { tags: ['action', 'approval'] },
+    // --- view (core) ---
+    'view.freezeRows': { tags: ['action', 'approval'] },
+    'view.freezeColumns': { tags: ['action', 'approval'] },
+    'view.unfreeze': { tags: ['action', 'approval'] },
+    'view.setGridlines': { tags: ['action', 'approval'] },
+    // --- comments (core) ---
+    'comments.addNote': { tags: ['action', 'approval'] },
+    'comments.getNote': { tags: ['action', 'ask'] },
+    'comments.removeNote': { tags: ['action', 'approval'] }
+};
+// ========================== WORKBOOK =======================================
+export const WORKBOOK_METHODS = {
+    // --- Sheet access ---
+    getActiveSheet: { tags: ['action', 'ask'] },
+    getSheetByName: { tags: ['action', 'ask'] },
+    getSheetByIndex: { tags: ['action', 'ask'] },
+    getSheetNames: { tags: ['action', 'ask'] },
+    // --- Formula introspection ---
+    getAPIInfo: {
+        tags: ['action', 'ask'],
+        doc: 'Get docs for a spreadsheet formula (e.g. "SUM", "VLOOKUP"). For API method docs, use getMethodInfo() instead.'
+    },
+    // --- Utilities ---
+    indexToAddress: { tags: ['action', 'ask'] },
+    addressToIndex: { tags: ['action', 'ask'] },
+    // --- sheets (core) ---
+    'sheets.add': { tags: ['action', 'approval'] },
+    'sheets.remove': { tags: ['action', 'approval'] },
+    'sheets.rename': { tags: ['action', 'approval'] },
+    'sheets.move': { tags: ['action', 'approval'] },
+    'sheets.copy': { tags: ['action', 'approval'] },
+    // --- history (core) ---
+    'history.undo': { tags: ['action', 'approval'] },
+    'history.redo': { tags: ['action', 'approval'] },
+    // --- names (core) ---
+    'names.add': { tags: ['action', 'approval'] },
+    'names.remove': { tags: ['action', 'approval'] },
+    'names.list': { tags: ['action', 'ask'] }
+};
+export const WORKSHEET_PATCHES = {
+    getValue: {
+        signature: 'getValue(address: string): Promise<CellValue>',
+        docstring: 'Get the computed value of a cell. Returns null for empty cells. Also accepts (row, col) overload.'
+    },
+    getData: {
+        signature: 'getData(): Promise<CellValue[][]>',
+        docstring: 'Get all cell values in the used range as a 2D array. Returns [] if sheet is empty.'
+    },
+    clearData: {
+        signature: 'clearData(range: string): Promise<void>',
+        docstring: 'Clear cell values and formulas in a range, preserving formatting.'
+    },
+    batchSetCells: {
+        signature: 'batchSetCells(updates: Array<{ row: number; col: number; value: any }>): Promise<void>',
+        docstring: 'Batch-write cell values. More efficient than setCell() in a loop.'
+    }
+};
+export const WORKBOOK_PATCHES = {};
+// ---------------------------------------------------------------------------
+// Docstring overrides
+// ---------------------------------------------------------------------------
+export const WORKSHEET_DOC_OVERRIDES = {};
+export const WORKBOOK_DOC_OVERRIDES = {};
+//# sourceMappingURL=api-overlay.js.map

package/dist/custom/sheet-api/api-reference-loader.js

@@ -0,0 +1,29 @@
+/**
+ * Shared loader for agent-docs/api-reference.json.
+ *
+ * Both api-guidelines.ts (system prompt) and api-lookup.ts (runtime sandbox)
+ * need the same parsed JSON. This module loads it once and caches the result.
+ */
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { getPackageDir } from '../../config.js';
+let _cached = null;
+export function loadApiReference() {
+    if (_cached)
+        return _cached;
+    const path = join(getPackageDir(), 'agent-docs', 'api-reference.json');
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf-8'));
+        const ifaces = raw.interfaces ?? {};
+        _cached = {
+            Worksheet: ifaces.Worksheet?.functions ?? {},
+            Workbook: ifaces.Workbook?.functions ?? {}
+        };
+    }
+    catch {
+        console.warn(`[api-reference] ${path} not found`);
+        _cached = { Worksheet: {}, Workbook: {} };
+    }
+    return _cached;
+}
+//# sourceMappingURL=api-reference-loader.js.map

package/dist/custom/sync-xll.js

@@ -18,8 +18,8 @@
  * stable directory. This is intentional — pip-installed packages live in
  * python/Lib/site-packages/ and must survive re-syncs.
  */
-import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, utimesSync, writeFileSync } from 'fs';
 import { createHash } from 'crypto';
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, utimesSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { getAgentDir, getPackageDir, VERSION } from '../config.js';
 /** Stable XLL directory that the registry should point to. */

package/dist/custom/tools/approval.js

@@ -17,7 +17,7 @@ import { Container, getEditorKeybindings, Text } from '../../tui/index.js';
 export const APPROVAL = {
     ACCEPT: 'Accept',
     ACCEPT_ALL: 'Accept All',
-    REJECT: 'Reject',
+    REJECT: 'Reject'
 };
 // ---------------------------------------------------------------------------
 // Approval gate factory
@@ -58,7 +58,7 @@ export function createApprovalGate(ComponentClass, settings) {
                 });
             });
         },
-        onAcceptAll: () => settings.setAutoApprove(true),
+        onAcceptAll: () => settings.setAutoApprove(true)
     };
 }
 // ---------------------------------------------------------------------------

package/dist/custom/tools/excel-exec.js

@@ -10,24 +10,25 @@ import { Type } from '@sinclair/typebox';
 import { truncateOutput } from '../../core/tools/truncate.js';
 import { EXCEL_EXEC } from '../../tool-names.js';
 import { Text } from '../../tui/index.js';
+import { log } from '../../utils/log.js';
 import { xllFetch } from '../excel-session.js';
-import { formatNotation, parseExcelLocation } from './excel-range.js';
 import { APPROVAL } from './approval.js';
+import { formatNotation, parseExcelLocation } from './excel-range.js';
+import { highlightCode } from './render-helpers.js';
 // ---------------------------------------------------------------------------
 // Control/outcome constants (HTTP control actions & approval results)
 // ---------------------------------------------------------------------------
 /** Control actions sent from TS → Python over HTTP. */
 const CONTROL = {
     REVERT: 'revert',
-    CLEANUP: 'cleanup',
+    CLEANUP: 'cleanup'
 };
 /** Outcome of the approval flow (internal to this module). */
 const OUTCOME = {
     ACCEPTED: 'accepted',
     REVERTED: 'reverted',
-    REVERT_FAILED: 'revert-failed',
+    REVERT_FAILED: 'revert-failed'
 };
-import { highlightCode } from './render-helpers.js';
 const TOOL_NAME = EXCEL_EXEC;
 const NO_OUTPUT_FALLBACK = '(no output)';
 const TOOL_DESCRIPTION = `\
@@ -57,6 +58,17 @@ const schema = Type.Object({
         description: 'Python code to execute in Excel. `app` (Excel.Application) is already available — do NOT import xl_app. Use print() to return values.'
     })
 });
+class ExcelShapeError extends Error {
+}
+/** Validate that a parsed JSON value has the ExcelExecResult shape. */
+function isExcelExecResult(v) {
+    if (typeof v !== 'object' || v === null || !('ok' in v))
+        return false;
+    const r = v;
+    return (typeof r.ok === 'boolean' &&
+        (r.output === undefined || typeof r.output === 'string') &&
+        (r.error === undefined || typeof r.error === 'string'));
+}
 /**
  * Resolve approval for cell changes: show UI if needed, then revert or cleanup.
  * Extracted from execute() so the approval flow is independently testable.
@@ -87,7 +99,7 @@ async function resolveApproval(result, approval, postControl, ctx) {
     if (cfTxId != null) {
         await postControl({ control: CONTROL.CLEANUP, cfTxId }).catch((e) => {
             const msg = e instanceof Error ? e.message : String(e);
-            console.error(`excel-exec: CF cleanup failed for tx ${cfTxId}: ${msg}`);
+            log.error('excel-exec', `CF cleanup failed for tx ${cfTxId}: ${msg}`);
         });
     }
     return OUTCOME.ACCEPTED;
@@ -155,9 +167,15 @@ export function createExcelExecTool(httpUrl, approval) {
             let result;
             const body = await response.text();
             try {
-                result = JSON.parse(body);
+                const parsed = JSON.parse(body);
+                if (!isExcelExecResult(parsed)) {
+                    throw new ExcelShapeError(`Excel returned unexpected shape (HTTP ${response.status}): ${body.slice(0, 200)}`);
+                }
+                result = parsed;
             }
-            catch {
+            catch (e) {
+                if (e instanceof ExcelShapeError)
+                    throw e;
                 throw new Error(`Excel returned non-JSON (HTTP ${response.status}): ${body.slice(0, 200)}`);
             }
             if (!result.ok) {
@@ -166,10 +184,12 @@ export function createExcelExecTool(httpUrl, approval) {
             const outcome = await resolveApproval(result, approval, (b) => postControl(b), ctx);
             if (outcome === OUTCOME.REVERT_FAILED) {
                 return {
-                    content: [{
+                    content: [
+                        {
                             type: 'text',
                             text: 'Revert failed — changes are still applied in Excel. You may need to undo manually (Ctrl+Z).'
-                        }],
+                        }
+                    ],
                     details: result
                 };
             }

package/dist/custom/tools/llm-analysis.js

@@ -4,13 +4,13 @@
  *
  * Output is always written to the agent temp directory.
  */
-import { readFile, mkdir, writeFile, readdir, stat, unlink } from 'fs/promises';
-import { join, extname, basename } from 'path';
 import { Type } from '@sinclair/typebox';
-import { LLM_ANALYSIS } from '../../tool-names.js';
-import { SHORTCUT_PROVIDER_ID } from '../providers/provider-ids.js';
+import { mkdir, readdir, readFile, stat, unlink, writeFile } from 'fs/promises';
+import { basename, extname, join } from 'path';
 import { APP_NAME, getAgentDir } from '../../config.js';
+import { LLM_ANALYSIS } from '../../tool-names.js';
 import { Text } from '../../tui/index.js';
+import { SHORTCUT_PROVIDER_ID } from '../providers/provider-ids.js';
 const TOOL_NAME = LLM_ANALYSIS;
 const OUTPUT_DIR_NAME = 'llm_analysis';
 const CLEANUP_MAX_AGE_MS = 60 * 60 * 1000; // 1 hour
@@ -20,17 +20,42 @@ const IMAGE_EXTENSIONS = {
     '.jpg': 'image/jpeg',
     '.jpeg': 'image/jpeg',
     '.gif': 'image/gif',
-    '.webp': 'image/webp',
+    '.webp': 'image/webp'
 };
 /** Extensions treated as readable text (sent as text blocks). */
 const TEXT_EXTENSIONS = new Set([
-    '.txt', '.csv', '.tsv', '.json', '.jsonl', '.md', '.xml', '.yaml', '.yml',
-    '.html', '.css', '.js', '.ts', '.py', '.sql', '.log', '.sh', '.cfg', '.ini',
-    '.toml', '.env', '.bat', '.ps1', '.r', '.sas', '.do', '.vba', '.bas',
+    '.txt',
+    '.csv',
+    '.tsv',
+    '.json',
+    '.jsonl',
+    '.md',
+    '.xml',
+    '.yaml',
+    '.yml',
+    '.html',
+    '.css',
+    '.js',
+    '.ts',
+    '.py',
+    '.sql',
+    '.log',
+    '.sh',
+    '.cfg',
+    '.ini',
+    '.toml',
+    '.env',
+    '.bat',
+    '.ps1',
+    '.r',
+    '.sas',
+    '.do',
+    '.vba',
+    '.bas'
 ]);
 const MODELS = {
     'gemini-3-flash-preview': 'gemini-3-flash-preview',
-    'claude-haiku-4-5-20251001': 'claude-haiku-4-5-20251001',
+    'claude-haiku-4-5-20251001': 'claude-haiku-4-5-20251001'
 };
 const DEFAULT_MODEL = 'gemini-3-flash-preview';
 const SYSTEM_PROMPT = `You are a document extraction assistant.
@@ -62,21 +87,21 @@ FOR EXTRACTION TASKS:
 Output is saved to a temp file and the path is returned. Read the file to see the full output.`;
 const schema = Type.Object({
     description: Type.String({
-        description: "Brief human-readable description of what this analysis will do (e.g., 'Extracting sales data from Q4 report')",
+        description: "Brief human-readable description of what this analysis will do (e.g., 'Extracting sales data from Q4 report')"
     }),
     file_paths: Type.Array(Type.String(), {
         description: 'List of local file paths to analyze (e.g., ["C:/Users/me/report.pdf"]). Max 20.',
-        maxItems: 20,
+        maxItems: 20
     }),
     query: Type.String({
-        description: 'The question/instruction for the LLM about the file content.',
+        description: 'The question/instruction for the LLM about the file content.'
     }),
     model: Type.Optional(Type.String({
-        description: `Model to use: '${DEFAULT_MODEL}' (default, best for images/tables) or 'claude-haiku-4-5-20251001' (fallback/verifier)`,
+        description: `Model to use: '${DEFAULT_MODEL}' (default, best for images/tables) or 'claude-haiku-4-5-20251001' (fallback/verifier)`
     })),
     output_filename: Type.Optional(Type.String({
-        description: "Optional output filename (e.g., 'analysis.md'). Auto-generated if omitted.",
-    })),
+        description: "Optional output filename (e.g., 'analysis.md'). Auto-generated if omitted."
+    }))
 });
 /** Get (and create) the output directory for analysis results. */
 async function getOutputDir() {
@@ -117,7 +142,7 @@ async function buildContent(filePaths, query) {
             const base64 = buffer.toString('base64');
             contentBlocks.push({
                 type: 'image_url',
-                image_url: { url: `data:application/pdf;base64,${base64}` },
+                image_url: { url: `data:application/pdf;base64,${base64}` }
             });
         }
         else if (IMAGE_EXTENSIONS[ext]) {
@@ -126,7 +151,7 @@ async function buildContent(filePaths, query) {
             const base64 = buffer.toString('base64');
             contentBlocks.push({
                 type: 'image_url',
-                image_url: { url: `data:${IMAGE_EXTENSIONS[ext]};base64,${base64}` },
+                image_url: { url: `data:${IMAGE_EXTENSIONS[ext]};base64,${base64}` }
             });
         }
         else if (TEXT_EXTENSIONS.has(ext)) {
@@ -135,7 +160,7 @@ async function buildContent(filePaths, query) {
             const text = buffer.toString('utf-8');
             contentBlocks.push({
                 type: 'text',
-                text: `--- File: ${basename(filePath)} ---\n${text}`,
+                text: `--- File: ${basename(filePath)} ---\n${text}`
             });
         }
         else {
@@ -144,7 +169,7 @@ async function buildContent(filePaths, query) {
             const text = buffer.toString('utf-8');
             contentBlocks.push({
                 type: 'text',
-                text: `--- File: ${basename(filePath)} ---\n${text}`,
+                text: `--- File: ${basename(filePath)} ---\n${text}`
             });
         }
     }
@@ -153,7 +178,7 @@ async function buildContent(filePaths, query) {
         const filesList = filePaths.map((fp) => `- ${basename(fp)}`).join('\n');
         contentBlocks.push({
             type: 'text',
-            text: `Query: ${query}\n\nFiles:\n${filesList}`,
+            text: `Query: ${query}\n\nFiles:\n${filesList}`
         });
     }
     else {
@@ -161,7 +186,7 @@ async function buildContent(filePaths, query) {
     }
     return [
         { role: 'system', content: SYSTEM_PROMPT },
-        { role: 'human', content: contentBlocks },
+        { role: 'human', content: contentBlocks }
     ];
 }
 export function createLlmAnalysisTool(baseUrl) {
@@ -184,7 +209,7 @@ export function createLlmAnalysisTool(baseUrl) {
             const details = [
                 files ? `Files:\n${files}` : '',
                 `Model: ${model}`,
-                args?.query ? `Query: ${args.query}` : '',
+                args?.query ? `Query: ${args.query}` : ''
             ]
                 .filter(Boolean)
                 .join('\n');
@@ -218,7 +243,7 @@ export function createLlmAnalysisTool(baseUrl) {
                 model: MODELS[selectedModel],
                 messages,
                 effort_level: 'low',
-                thinking_type: 'off',
+                thinking_type: 'off'
             };
             let response;
             try {
@@ -227,10 +252,10 @@ export function createLlmAnalysisTool(baseUrl) {
                     headers: {
                         'Content-Type': 'application/json',
                         Authorization: `Bearer ${apiKey}`,
-                        'User-Agent': `Mozilla/5.0 (compatible; ${APP_NAME}-coding-agent/1.0)`,
+                        'User-Agent': `Mozilla/5.0 (compatible; ${APP_NAME}-coding-agent/1.0)`
                     },
                     body: JSON.stringify(body),
-                    signal,
+                    signal
                 });
             }
             catch (e) {
@@ -254,12 +279,12 @@ export function createLlmAnalysisTool(baseUrl) {
                 content: [
                     {
                         type: 'text',
-                        text: `Analysis complete. Output saved to: ${outputPath}\n\nUse the read tool to view the full output.`,
-                    },
+                        text: `Analysis complete. Output saved to: ${outputPath}\n\nUse the read tool to view the full output.`
+                    }
                 ],
-                details: undefined,
+                details: undefined
             };
-        },
+        }
     };
 }
 //# sourceMappingURL=llm-analysis.js.map