The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat: agent description compression with lazy loading (#696)
Affaan Mustafabea68549c5f9
diff --git a/scripts/lib/agent-compress.js b/scripts/lib/agent-compress.jsindex c605a053e..d2abebee6 100644--- a/scripts/lib/agent-compress.js+++ b/scripts/lib/agent-compress.js@@ -8,7 +8,7 @@ const path = require('path');* Returns { frontmatter: {}, body: string }.*/function parseFrontmatter(content) {- const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);+ const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n([\s\S]*))?$/);if (!match) {return { frontmatter: {}, body: content };}@@ -38,21 +38,29 @@ function parseFrontmatter(content) {frontmatter[key] = value;}- return { frontmatter, body: match[2] };+ return { frontmatter, body: match[2] || '' };}/*** Extract the first meaningful paragraph from agent body as a summary.- * Skips headings and blank lines, returns up to maxSentences sentences.+ * Skips headings, list items, code blocks, and table rows.*/function extractSummary(body, maxSentences = 1) {const lines = body.split('\n');const paragraphs = [];let current = [];+ let inCodeBlock = false;for (const line of lines) {const trimmed = line.trim();+ // Track fenced code blocks+ if (trimmed.startsWith('```')) {+ inCodeBlock = !inCodeBlock;+ continue;+ }+ if (inCodeBlock) continue;+if (trimmed === '') {if (current.length > 0) {paragraphs.push(current.join(' '));@@ -61,8 +69,14 @@ function extractSummary(body, maxSentences = 1) {continue;}- // Skip headings- if (trimmed.startsWith('#')) {+ // Skip headings, list items (bold, plain, asterisk), numbered lists, table rows+ if (+ trimmed.startsWith('#') ||+ trimmed.startsWith('- ') ||+ trimmed.startsWith('* ') ||+ /^\d+\.\s/.test(trimmed) ||+ trimmed.startsWith('|')+ ) {if (current.length > 0) {paragraphs.push(current.join(' '));current = [];@@ -70,31 +84,21 @@ function extractSummary(body, maxSentences = 1) {continue;}- // Skip list items, code blocks, etc.- if (trimmed.startsWith('```') || trimmed.startsWith('- **') || trimmed.startsWith('|')) {- continue;- }-current.push(trimmed);}if (current.length > 0) {paragraphs.push(current.join(' '));}- // Find first non-empty paragraphconst firstParagraph = paragraphs.find(p => p.length > 0);- if (!firstParagraph) {- return '';- }+ if (!firstParagraph) return '';- // Extract up to maxSentences sentencesconst sentences = firstParagraph.match(/[^.!?]+[.!?]+/g) || [firstParagraph];- return sentences.slice(0, maxSentences).join(' ').trim();+ return sentences.slice(0, maxSentences).map(s => s.trim()).join(' ').trim();}/*** Load and parse a single agent file.- * Returns the full agent object with frontmatter and body.*/function loadAgent(filePath) {const content = fs.readFileSync(filePath, 'utf8');@@ -116,9 +120,7 @@ function loadAgent(filePath) {* Load all agents from a directory.*/function loadAgents(agentsDir) {- if (!fs.existsSync(agentsDir)) {- return [];- }+ if (!fs.existsSync(agentsDir)) return [];return fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'))@@ -127,8 +129,7 @@ function loadAgents(agentsDir) {}/**- * Compress an agent to its catalog entry (metadata only).- * This is the minimal representation needed for agent selection.+ * Compress an agent to catalog entry (metadata only).*/function compressToCatalog(agent) {return {@@ -140,31 +141,34 @@ function compressToCatalog(agent) {}/**- * Compress an agent to a summary entry (metadata + first paragraph).- * More context than catalog, less than full body.+ * Compress an agent to summary entry (metadata + first paragraph).*/function compressToSummary(agent) {return {- name: agent.name,- description: agent.description,- tools: agent.tools,- model: agent.model,+ ...compressToCatalog(agent),summary: extractSummary(agent.body),};}+const allowedModes = ['catalog', 'summary', 'full'];+/**- * Build a full compressed catalog from a directory of agents.+ * Build a compressed catalog from a directory of agents.** Modes:* - 'catalog': name, description, tools, model only (~2-3k tokens for 27 agents)* - 'summary': catalog + first paragraph summary (~4-5k tokens)* - 'full': no compression, full body included*- * Returns { agents: [], stats: { totalAgents, originalBytes, compressedTokenEstimate } }+ * Returns { agents: [], stats: { totalAgents, originalBytes, compressedBytes, compressedTokenEstimate, mode } }*/function buildAgentCatalog(agentsDir, options = {}) {const mode = options.mode || 'catalog';++ if (!allowedModes.includes(mode)) {+ throw new Error(`Invalid mode "${mode}". Allowed modes: ${allowedModes.join(', ')}`);+ }+const filter = options.filter || null;let agents = loadAgents(agentsDir);@@ -207,14 +211,24 @@ function buildAgentCatalog(agentsDir, options = {}) {}/**- * Lazy-load a single agent's full content by name from a directory.+ * Lazy-load a single agent's full content by name.* Returns null if not found.*/function lazyLoadAgent(agentsDir, agentName) {- const filePath = path.join(agentsDir, `${agentName}.md`);- if (!fs.existsSync(filePath)) {+ // Validate agentName: only allow alphanumeric, hyphen, underscore+ if (!/^[\w-]+$/.test(agentName)) {return null;}++ const filePath = path.resolve(agentsDir, `${agentName}.md`);++ // Verify the resolved path is still within agentsDir+ const resolvedAgentsDir = path.resolve(agentsDir);+ if (!filePath.startsWith(resolvedAgentsDir + path.sep)) {+ return null;+ }++ if (!fs.existsSync(filePath)) return null;return loadAgent(filePath);}diff --git a/tests/lib/agent-compress.test.js b/tests/lib/agent-compress.test.jsindex 45da6668f..b1384f2c4 100644--- a/tests/lib/agent-compress.test.js+++ b/tests/lib/agent-compress.test.js@@ -1,11 +1,13 @@/**- * Tests for agent description compression and lazy loading.+ * Tests for scripts/lib/agent-compress.js+ *+ * Run with: node tests/lib/agent-compress.test.js*/const assert = require('assert');+const path = require('path');const fs = require('fs');const os = require('os');-const path = require('path');const {parseFrontmatter,@@ -18,273 +20,249 @@ const {lazyLoadAgent,} = require('../../scripts/lib/agent-compress');-function createTempDir(prefix) {- return fs.mkdtempSync(path.join(os.tmpdir(), prefix));-}--function cleanupTempDir(dirPath) {- fs.rmSync(dirPath, { recursive: true, force: true });-}--function writeAgent(dir, name, content) {- fs.writeFileSync(path.join(dir, `${name}.md`), content, 'utf8');-}--const SAMPLE_AGENT = `----name: test-agent-description: A test agent for unit testing purposes.-tools: ["Read", "Grep", "Glob"]-model: sonnet------You are a test agent that validates compression logic.--## Your Role--- Run unit tests-- Validate compression output-- Ensure correctness--## Process--### 1. Setup-- Prepare test fixtures-- Load agent files--### 2. Validate-Check the output format and content.-`;--const MINIMAL_AGENT = `----name: minimal-description: Minimal agent.-tools: ["Read"]-model: haiku------Short body.-`;--async function test(name, fn) {+function test(name, fn) {try {- await fn();+ fn();console.log(` \u2713 ${name}`);return true;- } catch (error) {+ } catch (err) {console.log(` \u2717 ${name}`);- console.log(` Error: ${error.message}`);+ console.log(` Error: ${err.message}`);return false;}}-async function runTests() {+function runTests() {console.log('\n=== Testing agent-compress ===\n');let passed = 0;let failed = 0;- if (await test('parseFrontmatter extracts YAML frontmatter and body', async () => {- const { frontmatter, body } = parseFrontmatter(SAMPLE_AGENT);+ // --- parseFrontmatter ---++ if (test('parseFrontmatter extracts YAML frontmatter and body', () => {+ const content = '---\nname: test-agent\ndescription: A test\ntools: ["Read", "Grep"]\nmodel: sonnet\n---\n\nBody text here.';+ const { frontmatter, body } = parseFrontmatter(content);assert.strictEqual(frontmatter.name, 'test-agent');- assert.strictEqual(frontmatter.description, 'A test agent for unit testing purposes.');- assert.deepStrictEqual(frontmatter.tools, ['Read', 'Grep', 'Glob']);+ assert.strictEqual(frontmatter.description, 'A test');+ assert.deepStrictEqual(frontmatter.tools, ['Read', 'Grep']);assert.strictEqual(frontmatter.model, 'sonnet');- assert.ok(body.includes('You are a test agent'));- })) passed += 1; else failed += 1;+ assert.ok(body.includes('Body text here.'));+ })) passed++; else failed++;- if (await test('parseFrontmatter handles content without frontmatter', async () => {- const { frontmatter, body } = parseFrontmatter('Just a plain document.');+ if (test('parseFrontmatter handles content without frontmatter', () => {+ const content = 'Just a regular markdown file.';+ const { frontmatter, body } = parseFrontmatter(content);assert.deepStrictEqual(frontmatter, {});- assert.strictEqual(body, 'Just a plain document.');- })) passed += 1; else failed += 1;-- if (await test('extractSummary returns the first paragraph of the body', async () => {- const { body } = parseFrontmatter(SAMPLE_AGENT);+ assert.strictEqual(body, content);+ })) passed++; else failed++;++ if (test('parseFrontmatter handles colons in values', () => {+ const content = '---\nname: test\ndescription: Use this: it works\n---\n\nBody.';+ const { frontmatter } = parseFrontmatter(content);+ assert.strictEqual(frontmatter.description, 'Use this: it works');+ })) passed++; else failed++;++ if (test('parseFrontmatter strips surrounding quotes', () => {+ const content = '---\nname: "quoted-name"\n---\n\nBody.';+ const { frontmatter } = parseFrontmatter(content);+ assert.strictEqual(frontmatter.name, 'quoted-name');+ })) passed++; else failed++;++ if (test('parseFrontmatter handles content ending right after closing ---', () => {+ const content = '---\nname: test\ndescription: No body\n---';+ const { frontmatter, body } = parseFrontmatter(content);+ assert.strictEqual(frontmatter.name, 'test');+ assert.strictEqual(frontmatter.description, 'No body');+ assert.strictEqual(body, '');+ })) passed++; else failed++;++ // --- extractSummary ---++ if (test('extractSummary returns the first paragraph of the body', () => {+ const body = '# Heading\n\nThis is the first paragraph. It has two sentences.\n\nSecond paragraph.';const summary = extractSummary(body);- assert.ok(summary.includes('test agent'));- assert.ok(summary.includes('compression logic'));- })) passed += 1; else failed += 1;+ assert.strictEqual(summary, 'This is the first paragraph.');+ })) passed++; else failed++;- if (await test('extractSummary returns empty string for empty body', async () => {+ if (test('extractSummary returns empty string for empty body', () => {assert.strictEqual(extractSummary(''), '');- assert.strictEqual(extractSummary('# Just a heading'), '');- })) passed += 1; else failed += 1;-- if (await test('loadAgent reads and parses a single agent file', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- writeAgent(tmpDir, 'test-agent', SAMPLE_AGENT);- const agent = loadAgent(path.join(tmpDir, 'test-agent.md'));- assert.strictEqual(agent.name, 'test-agent');- assert.strictEqual(agent.fileName, 'test-agent');- assert.deepStrictEqual(agent.tools, ['Read', 'Grep', 'Glob']);- assert.strictEqual(agent.model, 'sonnet');- assert.ok(agent.byteSize > 0);- assert.ok(agent.body.includes('You are a test agent'));- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('loadAgents reads all .md files from a directory', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- writeAgent(tmpDir, 'agent-a', SAMPLE_AGENT);- writeAgent(tmpDir, 'agent-b', MINIMAL_AGENT);- const agents = loadAgents(tmpDir);- assert.strictEqual(agents.length, 2);- assert.strictEqual(agents[0].fileName, 'agent-a');- assert.strictEqual(agents[1].fileName, 'agent-b');- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('loadAgents returns empty array for non-existent directory', async () => {- const agents = loadAgents('/tmp/nonexistent-ecc-dir-12345');+ assert.strictEqual(extractSummary('# Only Headings\n\n## Another'), '');+ })) passed++; else failed++;++ if (test('extractSummary skips code blocks', () => {+ const body = '```\ncode here\n```\n\nActual summary sentence.';+ const summary = extractSummary(body);+ assert.strictEqual(summary, 'Actual summary sentence.');+ })) passed++; else failed++;++ if (test('extractSummary respects maxSentences', () => {+ const body = 'First sentence. Second sentence. Third sentence.';+ const one = extractSummary(body, 1);+ const two = extractSummary(body, 2);+ assert.strictEqual(one, 'First sentence.');+ assert.strictEqual(two, 'First sentence. Second sentence.');+ })) passed++; else failed++;++ if (test('extractSummary skips plain bullet items', () => {+ const body = '- plain bullet\n- another bullet\n\nActual paragraph here.';+ const summary = extractSummary(body);+ assert.strictEqual(summary, 'Actual paragraph here.');+ })) passed++; else failed++;++ if (test('extractSummary skips asterisk bullets and numbered lists', () => {+ const body = '* star bullet\n1. numbered item\n2. second item\n\nReal paragraph.';+ const summary = extractSummary(body);+ assert.strictEqual(summary, 'Real paragraph.');+ })) passed++; else failed++;++ // --- loadAgent / loadAgents ---++ // Create a temp directory with test agent files+ const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-compress-test-'));+ const agentContent = '---\nname: test-agent\ndescription: A test agent\ntools: ["Read"]\nmodel: haiku\n---\n\nTest agent body paragraph.\n\n## Details\nMore info.';+ fs.writeFileSync(path.join(tmpDir, 'test-agent.md'), agentContent);+ fs.writeFileSync(path.join(tmpDir, 'not-an-agent.txt'), 'ignored');++ if (test('loadAgent reads and parses a single agent file', () => {+ const agent = loadAgent(path.join(tmpDir, 'test-agent.md'));+ assert.strictEqual(agent.name, 'test-agent');+ assert.strictEqual(agent.description, 'A test agent');+ assert.deepStrictEqual(agent.tools, ['Read']);+ assert.strictEqual(agent.model, 'haiku');+ assert.ok(agent.body.includes('Test agent body paragraph'));+ assert.strictEqual(agent.fileName, 'test-agent');+ assert.ok(agent.byteSize > 0);+ })) passed++; else failed++;++ if (test('loadAgents reads all .md files from a directory', () => {+ const agents = loadAgents(tmpDir);+ assert.strictEqual(agents.length, 1);+ assert.strictEqual(agents[0].name, 'test-agent');+ })) passed++; else failed++;++ if (test('loadAgents returns empty array for non-existent directory', () => {+ const agents = loadAgents(path.join(os.tmpdir(), 'does-not-exist-agent-compress-test'));assert.deepStrictEqual(agents, []);- })) passed += 1; else failed += 1;-- if (await test('compressToCatalog strips body and keeps only metadata', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- writeAgent(tmpDir, 'test-agent', SAMPLE_AGENT);- const agent = loadAgent(path.join(tmpDir, 'test-agent.md'));- const catalog = compressToCatalog(agent);-- assert.strictEqual(catalog.name, 'test-agent');- assert.strictEqual(catalog.description, 'A test agent for unit testing purposes.');- assert.deepStrictEqual(catalog.tools, ['Read', 'Grep', 'Glob']);- assert.strictEqual(catalog.model, 'sonnet');- assert.strictEqual(catalog.body, undefined);- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('compressToSummary includes first paragraph summary', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- writeAgent(tmpDir, 'test-agent', SAMPLE_AGENT);- const agent = loadAgent(path.join(tmpDir, 'test-agent.md'));- const summary = compressToSummary(agent);-- assert.strictEqual(summary.name, 'test-agent');- assert.ok(summary.summary.length > 0);- assert.strictEqual(summary.body, undefined);- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('buildAgentCatalog in catalog mode produces minimal output with stats', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- writeAgent(tmpDir, 'agent-a', SAMPLE_AGENT);- writeAgent(tmpDir, 'agent-b', MINIMAL_AGENT);-- const result = buildAgentCatalog(tmpDir, { mode: 'catalog' });- assert.strictEqual(result.agents.length, 2);- assert.strictEqual(result.stats.totalAgents, 2);- assert.strictEqual(result.stats.mode, 'catalog');- assert.ok(result.stats.originalBytes > 0);- assert.ok(result.stats.compressedBytes > 0);- assert.ok(result.stats.compressedBytes < result.stats.originalBytes);- assert.ok(result.stats.compressedTokenEstimate > 0);-- // Catalog entries should not have body- for (const agent of result.agents) {- assert.strictEqual(agent.body, undefined);- assert.ok(agent.name);- assert.ok(agent.description);- }- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('buildAgentCatalog in summary mode includes summaries', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- writeAgent(tmpDir, 'agent-a', SAMPLE_AGENT);-- const result = buildAgentCatalog(tmpDir, { mode: 'summary' });- assert.strictEqual(result.agents.length, 1);- assert.ok(result.agents[0].summary);- assert.strictEqual(result.agents[0].body, undefined);- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('buildAgentCatalog in full mode preserves body', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- writeAgent(tmpDir, 'agent-a', SAMPLE_AGENT);-- const result = buildAgentCatalog(tmpDir, { mode: 'full' });- assert.strictEqual(result.agents.length, 1);- assert.ok(result.agents[0].body.includes('You are a test agent'));- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('buildAgentCatalog supports filter function', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- writeAgent(tmpDir, 'agent-a', SAMPLE_AGENT);- writeAgent(tmpDir, 'agent-b', MINIMAL_AGENT);-- const result = buildAgentCatalog(tmpDir, {- mode: 'catalog',- filter: agent => agent.model === 'haiku',- });- assert.strictEqual(result.agents.length, 1);- assert.strictEqual(result.agents[0].name, 'minimal');- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('lazyLoadAgent loads a single agent by name', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- writeAgent(tmpDir, 'test-agent', SAMPLE_AGENT);- writeAgent(tmpDir, 'other', MINIMAL_AGENT);-- const agent = lazyLoadAgent(tmpDir, 'test-agent');- assert.ok(agent);- assert.strictEqual(agent.name, 'test-agent');- assert.ok(agent.body.includes('You are a test agent'));- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('lazyLoadAgent returns null for non-existent agent', async () => {- const tmpDir = createTempDir('ecc-agent-compress-');- try {- const agent = lazyLoadAgent(tmpDir, 'nonexistent');- assert.strictEqual(agent, null);- } finally {- cleanupTempDir(tmpDir);- }- })) passed += 1; else failed += 1;-- if (await test('buildAgentCatalog works with real agents directory', async () => {- const agentsDir = path.join(__dirname, '..', '..', 'agents');- if (!fs.existsSync(agentsDir)) {- // Skip if agents dir doesn't exist (shouldn't happen in this repo)- return;- }-- const result = buildAgentCatalog(agentsDir, { mode: 'catalog' });- assert.ok(result.agents.length > 0, 'Should find at least one agent');+ })) passed++; else failed++;++ // --- compressToCatalog / compressToSummary ---++ const sampleAgent = loadAgent(path.join(tmpDir, 'test-agent.md'));++ if (test('compressToCatalog strips body and keeps only metadata', () => {+ const catalog = compressToCatalog(sampleAgent);+ assert.strictEqual(catalog.name, 'test-agent');+ assert.strictEqual(catalog.description, 'A test agent');+ assert.deepStrictEqual(catalog.tools, ['Read']);+ assert.strictEqual(catalog.model, 'haiku');+ assert.strictEqual(catalog.body, undefined);+ assert.strictEqual(catalog.byteSize, undefined);+ })) passed++; else failed++;++ if (test('compressToSummary includes first paragraph summary', () => {+ const summary = compressToSummary(sampleAgent);+ assert.strictEqual(summary.name, 'test-agent');+ assert.ok(summary.summary.includes('Test agent body paragraph'));+ assert.strictEqual(summary.body, undefined);+ })) passed++; else failed++;++ // --- buildAgentCatalog ---++ if (test('buildAgentCatalog in catalog mode produces minimal output with stats', () => {+ const result = buildAgentCatalog(tmpDir, { mode: 'catalog' });+ assert.strictEqual(result.agents.length, 1);+ assert.strictEqual(result.agents[0].body, undefined);+ assert.strictEqual(result.stats.totalAgents, 1);+ assert.strictEqual(result.stats.mode, 'catalog');assert.ok(result.stats.originalBytes > 0);- assert.ok(result.stats.compressedBytes < result.stats.originalBytes,- 'Catalog mode should be smaller than full agent files');- })) passed += 1; else failed += 1;+ assert.ok(result.stats.compressedBytes < result.stats.originalBytes);+ assert.ok(result.stats.compressedTokenEstimate > 0);+ })) passed++; else failed++;++ if (test('buildAgentCatalog in summary mode includes summaries', () => {+ const result = buildAgentCatalog(tmpDir, { mode: 'summary' });+ assert.ok(result.agents[0].summary);+ assert.strictEqual(result.agents[0].body, undefined);+ })) passed++; else failed++;++ if (test('buildAgentCatalog in full mode preserves body', () => {+ const result = buildAgentCatalog(tmpDir, { mode: 'full' });+ assert.ok(result.agents[0].body);+ })) passed++; else failed++;++ if (test('buildAgentCatalog throws on invalid mode', () => {+ assert.throws(+ () => buildAgentCatalog(tmpDir, { mode: 'invalid' }),+ /Invalid mode "invalid"/+ );+ })) passed++; else failed++;++ if (test('buildAgentCatalog supports filter function', () => {+ // Add a second agent+ fs.writeFileSync(+ path.join(tmpDir, 'other-agent.md'),+ '---\nname: other\ndescription: Other agent\ntools: ["Bash"]\nmodel: opus\n---\n\nOther body.'+ );+ const result = buildAgentCatalog(tmpDir, {+ filter: a => a.model === 'opus',+ });+ assert.strictEqual(result.agents.length, 1);+ assert.strictEqual(result.agents[0].name, 'other');+ // Clean up+ fs.unlinkSync(path.join(tmpDir, 'other-agent.md'));+ })) passed++; else failed++;++ // --- lazyLoadAgent ---++ if (test('lazyLoadAgent loads a single agent by name', () => {+ const agent = lazyLoadAgent(tmpDir, 'test-agent');+ assert.ok(agent);+ assert.strictEqual(agent.name, 'test-agent');+ assert.ok(agent.body.includes('Test agent body paragraph'));+ })) passed++; else failed++;++ if (test('lazyLoadAgent returns null for non-existent agent', () => {+ const agent = lazyLoadAgent(tmpDir, 'does-not-exist');+ assert.strictEqual(agent, null);+ })) passed++; else failed++;++ if (test('lazyLoadAgent rejects path traversal attempts', () => {+ const agent = lazyLoadAgent(tmpDir, '../etc/passwd');+ assert.strictEqual(agent, null);+ })) passed++; else failed++;++ if (test('lazyLoadAgent rejects names with invalid characters', () => {+ const agent = lazyLoadAgent(tmpDir, 'foo/bar');+ assert.strictEqual(agent, null);+ const agent2 = lazyLoadAgent(tmpDir, 'foo bar');+ assert.strictEqual(agent2, null);+ })) passed++; else failed++;++ // --- Real agents directory ---++ const realAgentsDir = path.resolve(__dirname, '../../agents');+ if (test('buildAgentCatalog works with real agents directory', () => {+ if (!fs.existsSync(realAgentsDir)) return; // skip if not present+ const result = buildAgentCatalog(realAgentsDir, { mode: 'catalog' });+ assert.ok(result.agents.length > 0, 'Should find at least one agent');+ assert.ok(result.stats.compressedBytes < result.stats.originalBytes, 'Catalog should be smaller than original');+ // Verify significant compression ratio+ const ratio = result.stats.compressedBytes / result.stats.originalBytes;+ assert.ok(ratio < 0.5, `Compression ratio ${ratio.toFixed(2)} should be < 0.5`);+ })) passed++; else failed++;++ if (test('catalog mode token estimate is under 5000 for real agents', () => {+ if (!fs.existsSync(realAgentsDir)) return;+ const result = buildAgentCatalog(realAgentsDir, { mode: 'catalog' });+ assert.ok(+ result.stats.compressedTokenEstimate < 5000,+ `Token estimate ${result.stats.compressedTokenEstimate} exceeds 5000`+ );+ })) passed++; else failed++;++ // Cleanup+ fs.rmSync(tmpDir, { recursive: true, force: true });console.log(`\nResults: Passed: ${passed}, Failed: ${failed}`);process.exit(failed > 0 ? 1 : 0);