agentxl 1.1.0 → 1.1.2

package/README.md

@@ -52,6 +52,18 @@ No server. No cloud account with us. No classic RAG stack. You bring your own AI
 
 ## Quick Start
 
+## Windows — Quick Start (no coding required)
+
+1. Download the latest `.zip` from [GitHub Releases](https://github.com/satish860/agentxl/releases)
+2. Extract to a folder (e.g. `Desktop\AgentXL`)
+3. Double-click **AgentXL.vbs**
+4. If sign-in is needed, run **AgentXL Login.vbs** first
+5. Excel opens with AgentXL in the **Home** ribbon
+
+The Windows release is self-contained — bundled Node.js, no system install required.
+
+Alternatively, install the add-in directly from Excel (see [Install the Excel add-in](#5-add-to-excel) below).
+
 ### 1. Install
 
 **Option A — npm**
@@ -60,16 +72,15 @@ No server. No cloud account with us. No classic RAG stack. You bring your own AI
 npm install -g agentxl
 ```
 
-**Option B — Windows installer**
+This is the simplest cross-platform install path.
 
-Use the packaged `AgentXL-Setup-<version>.exe`.
+**Option B — Windows release (no Node.js needed)**
 
-The installer is self-contained. It:
-- bundles its own Node.js runtime
-- bundles the built AgentXL app and production dependencies
-- copies `manifest.xml` into a stable local folder for Excel catalog setup
-- creates Start Menu shortcuts for Start/Login/Open Taskpane
-- does not require a separate Node.js installation on the target machine
+1. Download the latest `.zip` from [GitHub Releases](https://github.com/satish860/agentxl/releases)
+2. Extract to a folder
+3. Double-click **AgentXL.vbs**
+
+The release ZIP is self-contained: it bundles its own Node.js runtime, the built app, and production dependencies. No separate Node.js installation required.
 
 ### 2. Start
 
@@ -105,20 +116,42 @@ Open **https://localhost:3001/taskpane/** in your browser.
 
 You should see the AgentXL UI. This confirms the server, HTTPS, and UI all work before you touch Excel.
 
-### 5. Add to Excel (one-time setup)
+### 5. Add to Excel
+
+Choose one method:
+
+**Option A — Office Store (simplest)**
+1. Open Excel → **Insert** → **Get Add-ins**
+2. Search **"AgentXL"** → click **Add**
 
+> The Office Store listing is pending review. Use Option B or C in the meantime.
+
+**Option B — Upload hosted manifest (no Trust Center needed)**
+1. Download [`manifest.xml`](https://satish860.github.io/agentxl/manifest/manifest.xml)
+2. Open Excel → **Insert** → **Get Add-ins** → **My Add-ins** → **Upload My Add-in**
+3. Browse to the downloaded `manifest.xml` → **Upload**
+
+**Option C — Shared folder catalog (persistent, Windows)**
 1. **Excel** → **File** → **Options** → **Trust Center** → **Trust Center Settings**
 2. Click **Trusted Add-in Catalogs**
-3. Add the catalog path printed in your terminal
-   - Windows installer default: `C:\Program Files\AgentXL\manifest`
-   - npm install flow: use the path printed by `agentxl start`
+3. Add the `manifest` folder path from your release ZIP or the path printed by `agentxl start`
 4. Check **Show in Menu** → **OK** → **OK**
 5. **Restart Excel**
-6. **Insert** → **My Add-ins** → **SHARED FOLDER** tab → **AgentXL** → **Add**
+6. **Insert** → **My Add-ins** → **SHARED FOLDER** → **AgentXL** → **Add**
+
+**Option D — Windows release auto-setup**
+- Double-click **AgentXL.vbs** from the extracted release folder
+- It handles certificate trust, add-in registration, and opens Excel automatically
 
 ### 6. Start from a document folder
 
-Open Excel, launch **AgentXL**, then use a workflow like:
+Open Excel, launch **AgentXL**, and the first-run taskpane now guides the user through:
+
+1. **Connect** — sign in with your model provider if needed
+2. **Folder** — choose the local folder with supporting documents
+3. **Ask** — send a grounded question about that folder
+
+From there, the working flow is:
 
 1. select the workbook you want to populate
 2. point AgentXL at a local folder of supporting files
@@ -386,10 +419,13 @@ When you ask the agent about your documents or workbook, the relevant content is
 ### Add-in doesn't appear in Excel
 
 1. Is the server running?
-2. Did you add the catalog path in Trust Center → Trusted Add-in Catalogs?
-3. Did you check **Show in Menu**?
-4. Did you restart Excel?
-5. Look in **Insert → My Add-ins → SHARED FOLDER**
+2. Did you try the automated Windows onboarding path first?
+   - Start Menu: `Launch AgentXL onboarding`
+   - zip build: `Launch AgentXL Onboarding.cmd`
+3. If automatic setup failed, did you add the catalog path in Trust Center → Trusted Add-in Catalogs?
+4. Did you check **Show in Menu**?
+5. Did you restart Excel?
+6. Look in **Insert → My Add-ins → SHARED FOLDER**
 
 ### Port 3001 is already in use
 
@@ -399,42 +435,19 @@ agentxl start --port 3002
 
 > If you change the port, update `manifest/manifest.xml` to match.
 
-### Building the Windows installer
-
-From the repo root:
-
-```bash
-npm run prepare:installer:win
-```
-
-This creates a **self-contained** installer payload in:
-
-```text
-release/windows/payload
-```
-
-It includes:
-- the built app
-- production `node_modules`
-- a bundled Node.js runtime
-
-To compile the `.exe` installer, install **Inno Setup 6** and run:
+### Building the Windows release
 
 ```bash
-npm run build:installer:win
+npm run prepare:release:win
 ```
 
-The compiled installer is written to:
-
-```text
-release/windows/dist
-```
+This creates a self-contained ZIP in `release/windows/dist/` containing:
+- Portable Node.js runtime (no system install needed)
+- Built AgentXL app + production dependencies
+- Manifest for Excel sideloading
+- VBScript launchers (double-click to start)
 
-For a fuller release workflow, see:
-
-```text
-docs/RELEASING.md
-```
+GitHub Actions builds and publishes this automatically on tagged releases.
 
 ### "No model available"
 

package/dist/agent/prompt/folder-context.d.ts

@@ -1,14 +1,16 @@
 /**
- * Build the folder context block prepended to every agent message.
+ * Build the per-message folder context block.
  *
- * This is the primary mechanism for grounding the agent:
- * - Tells the agent what files are available
- * - Teaches absolute-path discipline
- * - Provides file listing and usage examples
- * - Explains document handling strategies (PDF→MD, XLSX/DOCX via code)
+ * This block is prepended to every user message and tells the agent:
+ *   - Which folder is linked
+ *   - What files are available (with sizes)
+ *   - Which PDFs have been pre-converted to markdown
+ *   - How to access XLSX / DOCX files (binary → code)
+ *   - How to access text / CSV / MD files (read tool)
  *
- * Extracted as its own module because this prompt will be tuned
- * frequently as document behavior improves.
+ * Behavioral rules (citation format, review-before-write, extraction
+ * workflow) live in the system prompt — see ./system-prompt.ts.
+ * This module is file-inventory only.
  */
 import type { FolderInventory } from "../../server/folder-scanner.js";
 /** Max supported files to list individually in context. */
@@ -17,8 +19,8 @@ export declare const MAX_FILES_IN_CONTEXT = 50;
 export declare function formatFileSize(bytes: number): string;
 /**
  * Build a folder context block to prepend to the agent message.
- * Gives the agent awareness of what files are available and
- * how to access them.
+ * Contains only the file inventory and access instructions — no
+ * behavioral rules (those are in the system prompt).
  */
 export declare function buildFolderContext(folderPath: string, inventory: FolderInventory): string;
 //# sourceMappingURL=folder-context.d.ts.map

package/dist/agent/prompt/folder-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"folder-context.d.ts","sourceRoot":"","sources":["../../../src/agent/prompt/folder-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,eAAe,GACzB,MAAM,CAgSR"}
+{"version":3,"file":"folder-context.d.ts","sourceRoot":"","sources":["../../../src/agent/prompt/folder-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,eAAe,GACzB,MAAM,CA4GR"}

package/dist/agent/prompt/folder-context.js

@@ -1,14 +1,16 @@
 /**
- * Build the folder context block prepended to every agent message.
+ * Build the per-message folder context block.
  *
- * This is the primary mechanism for grounding the agent:
- * - Tells the agent what files are available
- * - Teaches absolute-path discipline
- * - Provides file listing and usage examples
- * - Explains document handling strategies (PDF→MD, XLSX/DOCX via code)
+ * This block is prepended to every user message and tells the agent:
+ *   - Which folder is linked
+ *   - What files are available (with sizes)
+ *   - Which PDFs have been pre-converted to markdown
+ *   - How to access XLSX / DOCX files (binary → code)
+ *   - How to access text / CSV / MD files (read tool)
  *
- * Extracted as its own module because this prompt will be tuned
- * frequently as document behavior improves.
+ * Behavioral rules (citation format, review-before-write, extraction
+ * workflow) live in the system prompt — see ./system-prompt.ts.
+ * This module is file-inventory only.
  */
 import { listConvertedFiles } from "../../server/document-converter.js";
 /** Max supported files to list individually in context. */
@@ -23,27 +25,23 @@ export function formatFileSize(bytes) {
 }
 /**
  * Build a folder context block to prepend to the agent message.
- * Gives the agent awareness of what files are available and
- * how to access them.
+ * Contains only the file inventory and access instructions — no
+ * behavioral rules (those are in the system prompt).
  */
 export function buildFolderContext(folderPath, inventory) {
     const lines = [];
-    lines.push("[AgentXL Context]");
+    lines.push("[AgentXL — Linked Folder]");
     lines.push("");
-    lines.push("You are AgentXL, a document-to-Excel agent. The user's source documents are in the linked folder below.");
-    lines.push("Ground every answer in these files. Cite the source file when you reference a value.");
-    lines.push("If the folder does not contain enough evidence, say so. Do not fabricate data.");
-    lines.push("");
-    lines.push("IMPORTANT: All file operations MUST use absolute paths under the linked folder.");
-    lines.push(`The linked folder is: ${folderPath}`);
-    lines.push("Do NOT use relative paths. Do NOT read files from the current working directory.");
-    lines.push(`When the user asks about files, they mean files in: ${folderPath}`);
+    lines.push(`Folder: ${folderPath}`);
     lines.push(`${inventory.supportedFiles} supported file${inventory.supportedFiles !== 1 ? "s" : ""}, ${inventory.totalFiles} total`);
+    lines.push("");
+    lines.push("IMPORTANT: All file paths MUST be absolute paths under this folder.");
+    // ── Supported files ────────────────────────────────────────────────────
     const supported = inventory.files.filter((f) => f.supported);
     const unsupported = inventory.files.filter((f) => !f.supported);
     if (supported.length > 0) {
         lines.push("");
-        lines.push("Supported files (you can read these):");
+        lines.push("Supported files:");
         const shown = supported.slice(0, MAX_FILES_IN_CONTEXT);
         for (const f of shown) {
             lines.push(`- ${f.relativePath} (${formatFileSize(f.sizeBytes)})`);
@@ -63,222 +61,45 @@ export function buildFolderContext(folderPath, inventory) {
             : "";
         lines.push(`Unsupported files (cannot read): ${unsupportedNames}${suffix}`);
     }
-    // -----------------------------------------------------------------------
-    // Document handling instructions
-    // -----------------------------------------------------------------------
-    // PDF conversions
+    // ── PDF conversions ────────────────────────────────────────────────────
     const conversions = listConvertedFiles(inventory);
     if (conversions.length > 0) {
         lines.push("");
         lines.push("📄 PDF files (pre-converted to Markdown):");
-        lines.push("PDFs have been converted to readable Markdown. Read the .md version, NOT the raw PDF.");
+        lines.push("Read the .md version, NOT the raw PDF.");
         for (const c of conversions) {
             lines.push(`- ${c.source} → READ: "${folderPath}/${c.converted}"`);
         }
     }
-    // XLSX handling
+    // ── XLSX handling ──────────────────────────────────────────────────────
     const xlsxFiles = supported.filter((f) => f.extension === ".xlsx" || f.extension === ".xls");
     if (xlsxFiles.length > 0) {
         lines.push("");
-        lines.push("📊 Excel files (use code to extract):");
-        lines.push("Do NOT try to read .xlsx/.xls with the read tool — they are binary.");
-        lines.push("Write a Node.js script via bash that uses the `xlsx` npm package (already installed).");
-        lines.push("Example:");
+        lines.push("📊 Excel files — do NOT read with the read tool (binary).");
+        lines.push("Use bash + xlsx npm package:");
         lines.push("```");
-        lines.push(`bash: node -e "const XLSX = require('xlsx'); const wb = XLSX.readFile('${xlsxFiles[0].absolutePath}'); const ws = wb.Sheets[wb.SheetNames[0]]; console.log(JSON.stringify(XLSX.utils.sheet_to_json(ws), null, 2));"`);
+        lines.push(`node -e "const XLSX = require('xlsx'); const wb = XLSX.readFile('${xlsxFiles[0].absolutePath}'); const ws = wb.Sheets[wb.SheetNames[0]]; console.log(JSON.stringify(XLSX.utils.sheet_to_json(ws), null, 2));"`);
         lines.push("```");
     }
-    // DOCX handling
+    // ── DOCX handling ──────────────────────────────────────────────────────
     const docxFiles = supported.filter((f) => f.extension === ".docx" || f.extension === ".doc");
     if (docxFiles.length > 0) {
         lines.push("");
-        lines.push("📝 Word files (use code to extract):");
-        lines.push("Do NOT try to read .docx/.doc with the read tool — they are binary.");
-        lines.push("Write a Node.js script via bash that uses the `mammoth` npm package (already installed).");
-        lines.push("Example:");
+        lines.push("📝 Word files — do NOT read with the read tool (binary).");
+        lines.push("Use bash + mammoth npm package:");
         lines.push("```");
-        lines.push(`bash: node -e "const mammoth = require('mammoth'); mammoth.convertToMarkdown({path: '${docxFiles[0].absolutePath}'}).then(r => console.log(r.value));"`);
+        lines.push(`node -e "const mammoth = require('mammoth'); mammoth.convertToMarkdown({path: '${docxFiles[0].absolutePath}'}).then(r => console.log(r.value));"`);
         lines.push("```");
     }
-    // -----------------------------------------------------------------------
-    // EXTRACTION + CITATION WORKFLOW (mandatory)
-    // -----------------------------------------------------------------------
-    lines.push("");
-    lines.push("═══════════════════════════════════════════════════════════════");
-    lines.push("⚡ EXTRACTION WORKFLOW — WRITE CODE + CITE EVERY VALUE");
-    lines.push("═══════════════════════════════════════════════════════════════");
-    lines.push("");
-    lines.push("When extracting data from documents to write to Excel, you MUST follow");
-    lines.push("this 3-step workflow. This is NOT optional — every value needs a citation.");
-    lines.push("");
-    lines.push("STEP 1: EXTRACT WITH CITATIONS (bash script)");
-    lines.push("─────────────────────────────────────────────");
-    lines.push("Write a Node.js script that reads the source files and returns structured");
-    lines.push("JSON with BOTH the value AND its citation. Do NOT make 10+ individual");
-    lines.push("read/grep calls — extract everything in one script run.");
-    lines.push("");
-    lines.push("The script MUST output JSON in this exact format:");
-    lines.push("```json");
-    lines.push("{");
-    lines.push('  "fieldName": {');
-    lines.push('    "value": "the extracted value",');
-    lines.push('    "source": "Original File Name.pdf",');
-    lines.push('    "page": 14,');
-    lines.push('    "excerpt": "...surrounding ~150 chars with the extracted value in context..."');
-    lines.push("  }");
-    lines.push("}");
-    lines.push("```");
-    lines.push("");
-    lines.push("How to determine page numbers from converted markdown:");
-    lines.push("- PDF markdown files have `---` page separators");
-    lines.push("- Count `---` separators before the match to get the page number");
-    lines.push("- For XLSX: use sheet name + cell reference as 'page'");
-    lines.push("- For DOCX: use section heading as 'page'");
-    lines.push("");
-    lines.push("How to capture excerpts:");
-    lines.push("- Find the match position in the text");
-    lines.push("- Take ~75 chars before and ~75 chars after the match");
-    lines.push("- Trim to word boundaries");
-    lines.push("- Prefix/suffix with '...' if truncated");
-    lines.push("");
-    lines.push("Example extraction script:");
-    lines.push("```");
-    lines.push(`bash: node -e "`);
-    lines.push("const fs = require('fs');");
-    lines.push("const path = require('path');");
-    lines.push(`const cacheDir = '${folderPath}/.agentxl-cache';`);
-    lines.push("const files = fs.readdirSync(cacheDir, {recursive: true}).filter(f => f.toString().endsWith('.md'));");
-    lines.push("const results = {};");
-    lines.push("for (const f of files) {");
-    lines.push("  const text = fs.readFileSync(path.join(cacheDir, f.toString()), 'utf8');");
-    lines.push("  const sourceFile = f.toString().replace('.md','');");
-    lines.push("  // Count pages by --- separators");
-    lines.push("  function getPage(pos) { return (text.slice(0, pos).match(/^---$/gm) || []).length + 1; }");
-    lines.push("  function getExcerpt(pos, len) {");
-    lines.push("    const start = Math.max(0, pos - 75);");
-    lines.push("    const end = Math.min(text.length, pos + len + 75);");
-    lines.push("    return (start > 0 ? '...' : '') + text.slice(start, end).replace(/\\n/g, ' ').trim() + (end < text.length ? '...' : '');");
-    lines.push("  }");
-    lines.push("  const termMatch = text.match(/(?:lease\\s+term|term\\s+of\\s+(?:the\\s+)?lease)[:\\s]+([^.\\n]+)/i);");
-    lines.push("  if (termMatch) {");
-    lines.push("    results.leaseTerm = {");
-    lines.push("      value: termMatch[1].trim(),");
-    lines.push("      source: sourceFile,");
-    lines.push("      page: getPage(termMatch.index),");
-    lines.push("      excerpt: getExcerpt(termMatch.index, termMatch[0].length)");
-    lines.push("    };");
-    lines.push("  }");
-    lines.push("  // ... add more fields with same pattern");
-    lines.push("}");
-    lines.push("console.log(JSON.stringify(results, null, 2));");
-    lines.push('"');
-    lines.push("```");
-    lines.push("");
-    lines.push("If a value is INFERRED (not directly quoted from a source), mark it:");
-    lines.push('  "source": "INFERRED",');
-    lines.push('  "page": null,');
-    lines.push('  "excerpt": "Reasoning: [explain why you inferred this value]"');
-    lines.push("");
-    lines.push("STEP 2: WRITE VALUES + COMMENTS TO EXCEL (excel tool)");
-    lines.push("─────────────────────────────────────────────────────");
-    lines.push("After extracting data with citations, write to Excel in ONE excel tool call.");
-    lines.push("For EVERY cell you write, also add an Excel comment with the citation.");
-    lines.push("IMPORTANT: do NOT use cell.note or range.note — use worksheet.comments.add(cellAddress, content).");
-    lines.push("");
-    lines.push("```javascript");
-    lines.push("// Inside Excel.run(async (context) => { ... }):");
-    lines.push("const sheet = context.workbook.worksheets.getItem('SheetName');");
-    lines.push("const address = 'B5';");
+    // ── Quick access examples ──────────────────────────────────────────────
     lines.push("");
-    lines.push("// Write value");
-    lines.push("sheet.getRange(address).values = [['12 months']];");
-    lines.push("");
-    lines.push("// Add or replace citation comment");
-    lines.push("try {");
-    lines.push("  sheet.comments.getItemByCell(address).delete();");
-    lines.push("  await context.sync();");
-    lines.push("} catch {}");
-    lines.push("sheet.comments.add(address, '📄 Source: Operating Lease.pdf\\n📑 Page: 14\\n💬 \"...the lease term shall be twelve (12) months from the Delivery Date...\"\\n🤖 Extracted by AgentXL');");
-    lines.push("");
-    lines.push("// For inferred values:");
-    lines.push("// sheet.comments.add(address, '⚠️ Inferred — no direct source citation\\n💬 Reasoning: Based on aircraft registration VT-YBH (Indian registry)\\n🤖 Extracted by AgentXL');");
-    lines.push("");
-    lines.push("await context.sync();");
-    lines.push("```");
-    lines.push("");
-    lines.push("STEP 3: LOG TO _AgentXL_Sources SHEET (excel tool)");
-    lines.push("──────────────────────────────────────────────────");
-    lines.push("After writing values, append citation records to a Sources sheet.");
-    lines.push("Create it if it doesn't exist. This is the audit trail.");
-    lines.push("");
-    lines.push("```javascript");
-    lines.push("// Inside Excel.run(async (context) => { ... }):");
-    lines.push("let sourcesSheet;");
-    lines.push("try {");
-    lines.push("  sourcesSheet = context.workbook.worksheets.getItem('_AgentXL_Sources');");
-    lines.push("} catch {");
-    lines.push("  // Create the sheet if it doesn't exist");
-    lines.push("  sourcesSheet = context.workbook.worksheets.add('_AgentXL_Sources');");
-    lines.push("  const header = sourcesSheet.getRange('A1:G1');");
-    lines.push("  header.values = [['Target Sheet', 'Target Cell', 'Value', 'Source File', 'Page', 'Excerpt', 'Timestamp']];");
-    lines.push("  header.format.font.bold = true;");
-    lines.push("  header.format.fill.color = '#4472C4';");
-    lines.push("  header.format.font.color = '#FFFFFF';");
-    lines.push("  // Set column widths");
-    lines.push("  sourcesSheet.getRange('A:A').format.columnWidth = 100;");
-    lines.push("  sourcesSheet.getRange('B:B').format.columnWidth = 70;");
-    lines.push("  sourcesSheet.getRange('C:C').format.columnWidth = 120;");
-    lines.push("  sourcesSheet.getRange('D:D').format.columnWidth = 180;");
-    lines.push("  sourcesSheet.getRange('E:E').format.columnWidth = 50;");
-    lines.push("  sourcesSheet.getRange('F:F').format.columnWidth = 300;");
-    lines.push("  sourcesSheet.getRange('G:G').format.columnWidth = 140;");
-    lines.push("}");
-    lines.push("");
-    lines.push("// Find next empty row");
-    lines.push("const usedRange = sourcesSheet.getUsedRange();");
-    lines.push("usedRange.load('rowCount');");
-    lines.push("await context.sync();");
-    lines.push("const nextRow = usedRange.rowCount + 1;");
-    lines.push("");
-    lines.push("// Append citation rows (one per written cell)");
-    lines.push("const timestamp = new Date().toISOString();");
-    lines.push("sourcesSheet.getRange(`A${nextRow}:G${nextRow}`).values = [[");
-    lines.push("  'Redelivery Details',  // target sheet");
-    lines.push("  'B5',                  // target cell");
-    lines.push("  '12 months',           // value written");
-    lines.push("  'Operating Lease.pdf', // source file");
-    lines.push("  14,                    // page number");
-    lines.push("  '...the lease term shall be twelve (12) months...', // excerpt");
-    lines.push("  timestamp");
-    lines.push("]];");
-    lines.push("await context.sync();");
-    lines.push("```");
-    lines.push("");
-    lines.push("IMPORTANT RULES:");
-    lines.push("- NEVER write a value to Excel without adding a citation comment.");
-    lines.push("- NEVER skip the _AgentXL_Sources entry.");
-    lines.push("- If you cannot find a source for a value, mark it as INFERRED with reasoning.");
-    lines.push("- Combine Steps 2 and 3 into a SINGLE excel tool call when possible.");
-    lines.push("- The _AgentXL_Sources sheet is APPEND-ONLY — never delete existing rows.");
-    lines.push("");
-    lines.push("Use simple read/grep only for:");
-    lines.push("- Quick single-value lookups");
-    lines.push("- Checking if a file contains a specific term");
-    lines.push("- Reading small files in full");
-    // -----------------------------------------------------------------------
-    // General file access
-    // -----------------------------------------------------------------------
-    lines.push("");
-    lines.push("How to access files:");
-    lines.push(`- To list files: ls "${folderPath}"`);
-    if (supported.length > 0) {
-        const textExample = supported.find((f) => ![".pdf", ".xlsx", ".xls", ".docx", ".doc"].includes(f.extension));
-        if (textExample) {
-            lines.push(`- To read a text file: read "${textExample.absolutePath}"`);
-        }
+    lines.push("File access:");
+    lines.push(`- List: ls "${folderPath}"`);
+    const textExample = supported.find((f) => ![".pdf", ".xlsx", ".xls", ".docx", ".doc"].includes(f.extension));
+    if (textExample) {
+        lines.push(`- Read text file: read "${textExample.absolutePath}"`);
     }
-    lines.push(`- To search text files: grep with path "${folderPath}"`);
-    lines.push('Always use the FULL ABSOLUTE PATH shown above. Never use "." or relative paths.');
+    lines.push(`- Search: grep with path "${folderPath}"`);
     return lines.join("\n");
 }
 //# sourceMappingURL=folder-context.js.map

package/dist/agent/prompt/folder-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"folder-context.js","sourceRoot":"","sources":["../../../src/agent/prompt/folder-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"folder-context.js","sourceRoot":"","sources":["../../../src/agent/prompt/folder-context.ts"],"names":[],"mappings":"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"}

package/dist/agent/prompt/system-prompt.d.ts

@@ -0,0 +1,21 @@
+/**
+ * AgentXL system prompt — appended on top of Pi's built-in system prompt.
+ *
+ * This is the behavioral layer that makes the agent act like a
+ * document-to-Excel agent with show-your-work traceability.
+ *
+ * Pi's base prompt handles:
+ *   - tool descriptions (read, bash, edit, write, custom tools)
+ *   - tool usage guidelines
+ *   - skills, context files, AGENTS.md
+ *   - date/time, cwd
+ *
+ * This prompt adds:
+ *   - AgentXL identity and workflow rules
+ *   - Show-your-work traceability (not a permission gate)
+ *   - Citation format and traceability rules
+ *   - Excel comment API guidance (no .note)
+ *   - _AgentXL_Sources audit sheet spec
+ */
+export declare const AGENTXL_SYSTEM_PROMPT: string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/agent/prompt/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../../src/agent/prompt/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,eAAO,MAAM,qBAAqB,QA0G1B,CAAC"}