agentxl 1.1.0 → 1.1.3

package/bin/agentxl.js

@@ -226,6 +226,7 @@ AgentXL v${VERSION} — AI agent for Microsoft Excel
 
 Usage:
   agentxl start [options]    Start the AgentXL server
+  agentxl install            Register the add-in with Excel (one-time)
   agentxl login              Set up or change API credentials
   agentxl --version          Print version
   agentxl --help             Show this help
@@ -235,7 +236,8 @@ Options:
   --verbose                  Log all HTTP requests
 
 Examples:
-  agentxl start
+  agentxl install            # one-time: register with Excel
+  agentxl start              # run the server
   agentxl start --port 3002
   agentxl login
 `);
@@ -329,30 +331,51 @@ async function start() {
     step("ℹ️", `Folder picker: ${pickerLabel}`);
   }
 
-  // ── Post-start guidance ────────────────────────────────────────────────
+  // ── Step 7: Auto-register add-in with Excel (first run) ─────────────
   const manifestPath = resolve(__dirname, "..", "manifest", "manifest.xml");
-  const manifestExists = existsSync(manifestPath);
 
+  if (existsSync(manifestPath)) {
+    let alreadyRegistered = false;
+    try {
+      const devSettings = await import("office-addin-dev-settings");
+      const registered = await devSettings.getRegisteredAddIns();
+      alreadyRegistered = registered.some(a => a.manifestPath === manifestPath);
+    } catch (_) {}
+
+    if (!alreadyRegistered) {
+      step("⏳", "First run — registering AgentXL with Excel...");
+      try {
+        const devSettings = await import("office-addin-dev-settings");
+        await devSettings.registerAddIn(manifestPath);
+        step("✅", "Add-in registered with Excel");
+      } catch (err) {
+        step("⚠️", `Auto-registration failed: ${err.message}`);
+        step("  ", "Run 'agentxl install' manually, or add the manifest folder to Excel Trust Center:");
+        step("  ", `  ${dirname(manifestPath)}`);
+      }
+
+      try {
+        const devSettings = await import("office-addin-dev-settings");
+        await devSettings.ensureLoopbackIsEnabled(manifestPath, false);
+      } catch (_) {}
+    } else {
+      step("✅", "Excel add-in registered");
+    }
+  }
+
+  // ── Post-start guidance ────────────────────────────────────────────────
   console.log(`
   ─────────────────────────────────────────────────
-  All systems go. Here's what to do next:
+  All systems go!
   ─────────────────────────────────────────────────
 
-  🌐 Test in browser (confirm everything works):
-     https://localhost:${port}/taskpane/
+  📎 Open Excel → AgentXL is on the Home ribbon
+     (If you don't see it: Insert → My Add-ins → SHARED FOLDER → AgentXL)
 
-  📎 Load in Excel (one-time setup):
-     1. Excel → File → Options → Trust Center → Trust Center Settings
-     2. Trusted Add-in Catalogs → add path: ${manifestExists ? dirname(manifestPath) : "[manifest folder]"}
-     3. Check "Show in Menu" → OK → OK
-     4. Restart Excel
-     5. Insert → My Add-ins → SHARED FOLDER → AgentXL → Add
-
-  After setup, just run 'agentxl start' and click
-  AgentXL on the Home ribbon. No re-sideloading needed.
+  🌐 Or test in browser first:
+     https://localhost:${port}/taskpane/
 
-  💬 Try your first message:
-     "What can you help me with in this workbook?"
+  💬 Try: "What can you help me with in this workbook?"
 `);
 
   // ── Graceful shutdown ──────────────────────────────────────────────────
@@ -370,6 +393,86 @@ async function start() {
   process.on("SIGTERM", shutdown);
 }
 
+async function install() {
+  console.log(`
+  ┌──────────────────────────────────────┐
+  │      AgentXL Excel Registration      │
+  └──────────────────────────────────────┘
+`);
+
+  const manifestPath = resolve(__dirname, "..", "manifest", "manifest.xml");
+  if (!existsSync(manifestPath)) {
+    step("❌", `Manifest not found: ${manifestPath}`);
+    process.exit(1);
+  }
+
+  // ── Step 1: HTTPS certificates ─────────────────────────────────────────
+  try {
+    step("⏳", "Ensuring HTTPS certificates are trusted...");
+    const devCerts = await import("office-addin-dev-certs");
+    await devCerts.ensureCertificatesAreInstalled();
+    step("✅", "HTTPS certificate trusted");
+  } catch (err) {
+    step("⚠️", `Certificate setup: ${err.message}`);
+  }
+
+  // ── Step 2: Register add-in ────────────────────────────────────────────
+  try {
+    step("⏳", "Registering AgentXL with Excel...");
+    const devSettings = await import("office-addin-dev-settings");
+    await devSettings.registerAddIn(manifestPath);
+    step("✅", "Add-in registered with Excel");
+  } catch (err) {
+    step("❌", `Registration failed: ${err.message}`);
+    console.log(`
+  Fallback: manually add this folder to Excel's Trusted Add-in Catalogs:
+  ${dirname(manifestPath)}
+
+  Steps:
+    1. Excel → File → Options → Trust Center → Trust Center Settings
+    2. Trusted Add-in Catalogs → paste the path above
+    3. Check "Show in Menu" → OK → OK
+    4. Restart Excel
+    5. Insert → My Add-ins → SHARED FOLDER → AgentXL → Add
+`);
+    process.exit(1);
+  }
+
+  // ── Step 3: Enable loopback ────────────────────────────────────────────
+  try {
+    const devSettings = await import("office-addin-dev-settings");
+    await devSettings.ensureLoopbackIsEnabled(manifestPath, false);
+    step("✅", "Localhost loopback enabled");
+  } catch (err) {
+    step("⚠️", `Loopback: ${err.message}`);
+  }
+
+  console.log(`
+  ─────────────────────────────────────────────────
+  Done! AgentXL is registered with Excel.
+  ─────────────────────────────────────────────────
+
+  Next steps:
+    1. Run: agentxl start
+    2. Open Excel → AgentXL appears on the Home ribbon
+
+  To open Excel with AgentXL right now:
+    agentxl install --open
+`);
+
+  // Optionally open Excel
+  if (hasFlag("open")) {
+    try {
+      const devSettings = await import("office-addin-dev-settings");
+      const manifestLib = await import("office-addin-manifest");
+      step("⏳", "Opening Excel with AgentXL...");
+      await devSettings.sideloadAddIn(manifestPath, manifestLib.OfficeApp.Excel, false, devSettings.AppType.Desktop);
+    } catch (err) {
+      step("⚠️", `Could not open Excel: ${err.message}`);
+    }
+  }
+}
+
 async function login() {
   console.log("");
   const authed = await runAuthFlow();
@@ -398,6 +501,11 @@ if (command === "start") {
     console.error(`\n  ❌ ${err.message || err}\n`);
     process.exit(1);
   });
+} else if (command === "install") {
+  install().catch((err) => {
+    console.error(`\n  ❌ ${err.message || err}\n`);
+    process.exit(1);
+  });
 } else if (command === "login") {
   login().catch((err) => {
     console.error(`\n  ❌ ${err.message || err}\n`);

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":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACjE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,SAA0B;IAE1B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CACR,GAAG,SAAS,CAAC,cAAc,kBAAkB,SAAS,CAAC,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,UAAU,QAAQ,CACxH,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,qEAAqE,CACtE,CAAC;IAEF,0EAA0E;IAE1E,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;QACvD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,KAAK,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CACR,aAAa,SAAS,CAAC,MAAM,GAAG,oBAAoB,uBAAuB,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,MAAM,gBAAgB,GAAG,WAAW;aACjC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,MAAM,GACV,WAAW,CAAC,MAAM,GAAG,EAAE;YACrB,CAAC,CAAC,QAAQ,WAAW,CAAC,MAAM,GAAG,EAAE,OAAO;YACxC,CAAC,CAAC,EAAE,CAAC;QACT,KAAK,CAAC,IAAI,CACR,oCAAoC,gBAAgB,GAAG,MAAM,EAAE,CAChE,CAAC;IACJ,CAAC;IAED,0EAA0E;IAE1E,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,aAAa,UAAU,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,0EAA0E;IAE1E,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM,CACzD,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CACR,oEAAoE,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,kHAAkH,CAChN,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,0EAA0E;IAE1E,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM,CACzD,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CACR,kFAAkF,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,uCAAuC,CACnJ,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,0EAA0E;IAE1E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,GAAG,CAAC,CAAC;IAEzC,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CACzE,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,2BAA2B,WAAW,CAAC,YAAY,GAAG,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,6BAA6B,UAAU,GAAG,CAAC,CAAC;IAEvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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"}