@substrate-ai/factory 0.19.54

package/dist/agent/tools/profiles.js

@@ -0,0 +1,121 @@
+/**
+ * Provider profiles for Anthropic, OpenAI, and Gemini.
+ * Story 48-6: Provider-Aligned Tool Sets
+ */
+import { createSharedTools } from './shared.js';
+import { createEditFileTool } from './anthropic-tools.js';
+import { createApplyPatchTool } from './openai-tools.js';
+import { createReadManyFilesTool, createListDirTool, createGeminiEditFileTool } from './gemini-tools.js';
+/**
+ * Anthropic (Claude) provider profile.
+ * Uses edit_file for exact string search-and-replace.
+ */
+export class AnthropicProfile {
+    model;
+    id = 'anthropic';
+    supports_streaming = true;
+    context_window_size = 200_000;
+    supports_parallel_tool_calls = true;
+    constructor(model) {
+        this.model = model;
+    }
+    build_system_prompt() {
+        return [
+            'You are a coding agent. You have access to tools for reading and modifying files, running shell commands, and searching code.',
+            '',
+            'Available tools:',
+            '- read_file: Read file contents with optional line range (offset/limit)',
+            '- write_file: Write content to a file (creates parent dirs as needed)',
+            '- edit_file: Replace an exact string in a file (old_string must be unique)',
+            '- shell: Execute shell commands',
+            '- grep: Search for patterns in files',
+            '- glob: Find files matching a pattern',
+            '',
+            'Guidelines:',
+            '- Always read files before editing them to understand their current content',
+            '- Use edit_file for targeted changes, write_file for full rewrites',
+            '- Prefer targeted edits over full file rewrites when possible',
+        ].join('\n');
+    }
+    tools() {
+        return [...createSharedTools(120_000), createEditFileTool()];
+    }
+    provider_options() {
+        return { max_tokens: 4096 };
+    }
+}
+/**
+ * OpenAI provider profile.
+ * Uses apply_patch for v4a-format patch application.
+ * Does NOT include edit_file.
+ */
+export class OpenAIProfile {
+    model;
+    id = 'openai';
+    supports_streaming = true;
+    context_window_size = 128_000;
+    supports_parallel_tool_calls = true;
+    constructor(model) {
+        this.model = model;
+    }
+    build_system_prompt() {
+        return [
+            'You are a coding agent. You have access to tools for reading and modifying files, running shell commands, and searching code.',
+            '',
+            'Available tools:',
+            '- read_file: Read file contents with optional line range',
+            '- write_file: Write content to a file',
+            '- apply_patch: Apply a v4a-format patch to modify files',
+            '- shell: Execute shell commands',
+            '- grep: Search for patterns in files',
+            '- glob: Find files matching a pattern',
+        ].join('\n');
+    }
+    tools() {
+        return [...createSharedTools(10_000), createApplyPatchTool()];
+    }
+    provider_options() {
+        return {};
+    }
+}
+/**
+ * Gemini provider profile.
+ * Uses read_many_files, list_dir, and a Gemini-specific edit_file variant.
+ */
+export class GeminiProfile {
+    model;
+    id = 'gemini';
+    supports_streaming = true;
+    context_window_size = 1_000_000;
+    supports_parallel_tool_calls = true;
+    constructor(model) {
+        this.model = model;
+    }
+    build_system_prompt() {
+        return [
+            'You are a coding agent. You have access to tools for reading and modifying files, running shell commands, and searching code.',
+            '',
+            'Available tools:',
+            '- read_file: Read a single file with optional line range',
+            '- read_many_files: Read multiple files at once',
+            '- write_file: Write content to a file',
+            '- edit_file: Replace an exact string in a file',
+            '- list_dir: List directory contents',
+            '- shell: Execute shell commands',
+            '- grep: Search for patterns in files',
+            '- glob: Find files matching a pattern',
+        ].join('\n');
+    }
+    tools() {
+        return [
+            ...createSharedTools(10_000),
+            createReadManyFilesTool(),
+            createListDirTool(),
+            createGeminiEditFileTool(),
+        ];
+    }
+    provider_options() {
+        return {};
+    }
+}
+//# sourceMappingURL=profiles.js.map

package/dist/agent/tools/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../src/agent/tools/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAkBxG;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAMC;IALnB,EAAE,GAAG,WAAW,CAAA;IAChB,kBAAkB,GAAG,IAAI,CAAA;IACzB,mBAAmB,GAAG,OAAO,CAAA;IAC7B,4BAA4B,GAAG,IAAI,CAAA;IAE5C,YAA4B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE7C,mBAAmB;QACjB,OAAO;YACL,+HAA+H;YAC/H,EAAE;YACF,kBAAkB;YAClB,yEAAyE;YACzE,uEAAuE;YACvE,4EAA4E;YAC5E,iCAAiC;YACjC,sCAAsC;YACtC,uCAAuC;YACvC,EAAE;YACF,aAAa;YACb,6EAA6E;YAC7E,oEAAoE;YACpE,+DAA+D;SAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAoB,CAAC,CAAA;IAChF,CAAC;IAED,gBAAgB;QACd,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;IAC7B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAMI;IALnB,EAAE,GAAG,QAAQ,CAAA;IACb,kBAAkB,GAAG,IAAI,CAAA;IACzB,mBAAmB,GAAG,OAAO,CAAA;IAC7B,4BAA4B,GAAG,IAAI,CAAA;IAE5C,YAA4B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE7C,mBAAmB;QACjB,OAAO;YACL,+HAA+H;YAC/H,EAAE;YACF,kBAAkB;YAClB,0DAA0D;YAC1D,uCAAuC;YACvC,yDAAyD;YACzD,iCAAiC;YACjC,sCAAsC;YACtC,uCAAuC;SACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAoB,CAAC,CAAA;IACjF,CAAC;IAED,gBAAgB;QACd,OAAO,EAAE,CAAA;IACX,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IAMI;IALnB,EAAE,GAAG,QAAQ,CAAA;IACb,kBAAkB,GAAG,IAAI,CAAA;IACzB,mBAAmB,GAAG,SAAS,CAAA;IAC/B,4BAA4B,GAAG,IAAI,CAAA;IAE5C,YAA4B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE7C,mBAAmB;QACjB,OAAO;YACL,+HAA+H;YAC/H,EAAE;YACF,kBAAkB;YAClB,0DAA0D;YAC1D,gDAAgD;YAChD,uCAAuC;YACvC,gDAAgD;YAChD,qCAAqC;YACrC,iCAAiC;YACjC,sCAAsC;YACtC,uCAAuC;SACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;IAED,KAAK;QACH,OAAO;YACL,GAAG,iBAAiB,CAAC,MAAM,CAAC;YAC5B,uBAAuB,EAAoB;YAC3C,iBAAiB,EAAoB;YACrC,wBAAwB,EAAoB;SAC7C,CAAA;IACH,CAAC;IAED,gBAAgB;QACd,OAAO,EAAE,CAAA;IACX,CAAC;CACF"}

package/dist/agent/tools/registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ToolRegistry implementation.
+ * Story 48-6: Provider-Aligned Tool Sets
+ */
+import type { ToolDefinition, ToolResult, ExecutionEnvironment, IToolRegistry } from './types.js';
+/**
+ * Registry for tool definitions. Provides lookup, validation, and execution.
+ */
+export declare class ToolRegistry implements IToolRegistry {
+    private readonly _tools;
+    register(tool: ToolDefinition): void;
+    execute(name: string, args: unknown, env: ExecutionEnvironment): Promise<ToolResult>;
+    get(name: string): ToolDefinition | undefined;
+    getDefinitions(): ToolDefinition[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/agent/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAcjG;;GAEG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAI9B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAiC1F,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,cAAc,IAAI,cAAc,EAAE;CAGnC"}

package/dist/agent/tools/registry.js

@@ -0,0 +1,55 @@
+/**
+ * ToolRegistry implementation.
+ * Story 48-6: Provider-Aligned Tool Sets
+ */
+// ajv v6 — use require-style import for CJS compatibility under NodeNext
+// The ajv package.json has "main": "lib/ajv.js" (CJS) without ESM exports,
+// but TypeScript with NodeNext can still import it via the types.
+import Ajv from 'ajv';
+const ajv = new Ajv({ allErrors: true, coerceTypes: false });
+/**
+ * Registry for tool definitions. Provides lookup, validation, and execution.
+ */
+export class ToolRegistry {
+    _tools = new Map();
+    register(tool) {
+        this._tools.set(tool.name, tool);
+    }
+    async execute(name, args, env) {
+        const tool = this._tools.get(name);
+        if (!tool) {
+            return { content: `Unknown tool: ${name}`, isError: true };
+        }
+        // Validate args against inputSchema
+        const validate = ajv.compile(tool.inputSchema);
+        const valid = validate(args);
+        if (!valid) {
+            const errors = validate.errors ?? [];
+            const messages = errors
+                .map(e => {
+                const path = e.instancePath ?? e.dataPath ?? '';
+                return `${path} ${e.message ?? ''}`.trim();
+            })
+                .join(', ');
+            return { content: `Validation failed for tool '${name}': ${messages}`, isError: true };
+        }
+        try {
+            const result = await tool.executor(args, env);
+            const content = tool.outputTruncation !== undefined && result.length > tool.outputTruncation
+                ? result.slice(0, tool.outputTruncation) + '\n[truncated]'
+                : result;
+            return { content, isError: false };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { content: message, isError: true };
+        }
+    }
+    get(name) {
+        return this._tools.get(name);
+    }
+    getDefinitions() {
+        return Array.from(this._tools.values());
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/agent/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/agent/tools/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,yEAAyE;AACzE,2EAA2E;AAC3E,kEAAkE;AAClE,OAAO,GAAG,MAAM,KAAK,CAAA;AAOrB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;AAE5D;;GAEG;AACH,MAAM,OAAO,YAAY;IACN,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAA;IAE3D,QAAQ,CAAC,IAAoB;QAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAa,EAAE,GAAyB;QAClE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,iBAAiB,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAC5D,CAAC;QAED,oCAAoC;QACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAwB,CAAA;QACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAA;YACpC,MAAM,QAAQ,GAAG,MAAM;iBACpB,GAAG,CAAC,CAAC,CAAC,EAAE;gBACP,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAA;gBAC/C,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAA;YAC5C,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAA;YACb,OAAO,EAAE,OAAO,EAAE,+BAA+B,IAAI,MAAM,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACxF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YAC7C,MAAM,OAAO,GACX,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB;gBAC1E,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,eAAe;gBAC1D,CAAC,CAAC,MAAM,CAAA;YACZ,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAChE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAC5C,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IACzC,CAAC;CACF"}

package/dist/agent/tools/shared.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared tools available to all provider profiles.
+ * Story 48-6: Provider-Aligned Tool Sets
+ */
+import type { ToolDefinition } from './types.js';
+/**
+ * Creates the five shared tools: read_file, write_file, shell, grep, glob.
+ */
+export declare function createSharedTools(shellTimeoutMs?: number): ToolDefinition[];
+//# sourceMappingURL=shared.d.ts.map

package/dist/agent/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,YAAY,CAAA;AAEtE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,SAAS,GAAG,cAAc,EAAE,CAQ3E"}

package/dist/agent/tools/shared.js

@@ -0,0 +1,207 @@
+/**
+ * Shared tools available to all provider profiles.
+ * Story 48-6: Provider-Aligned Tool Sets
+ */
+import { readFile, writeFile, mkdir, readdir } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+/**
+ * Creates the five shared tools: read_file, write_file, shell, grep, glob.
+ */
+export function createSharedTools(shellTimeoutMs = 10_000) {
+    return [
+        createReadFileTool(),
+        createWriteFileTool(),
+        createShellTool(shellTimeoutMs),
+        createGrepTool(shellTimeoutMs),
+        createGlobTool(),
+    ];
+}
+function createReadFileTool() {
+    return {
+        name: 'read_file',
+        description: 'Read a file from the filesystem, with optional offset and limit for line ranges. Returns content with 1-based line numbers.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Path to the file to read' },
+                offset: { type: 'number', minimum: 1, description: 'Line number to start reading from (1-based, optional)' },
+                limit: { type: 'number', minimum: 1, description: 'Maximum number of lines to read (optional)' },
+            },
+            required: ['path'],
+        },
+        outputTruncation: 50_000,
+        async executor(args, _env) {
+            const raw = await readFile(args.path, 'utf-8');
+            const lines = raw.split('\n');
+            const offset = args.offset !== undefined ? args.offset - 1 : 0;
+            const slice = args.limit !== undefined ? lines.slice(offset, offset + args.limit) : lines.slice(offset);
+            const numbered = slice.map((line, i) => {
+                const lineNum = offset + i + 1;
+                return `${String(lineNum).padStart(3)}\t${line}`;
+            });
+            return numbered.join('\n');
+        },
+    };
+}
+function createWriteFileTool() {
+    return {
+        name: 'write_file',
+        description: 'Write content to a file, creating parent directories if needed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Path to the file to write' },
+                content: { type: 'string', description: 'Content to write to the file' },
+            },
+            required: ['path', 'content'],
+        },
+        async executor(args, _env) {
+            const dir = dirname(args.path);
+            await mkdir(dir, { recursive: true });
+            const bytes = Buffer.byteLength(args.content, 'utf-8');
+            await writeFile(args.path, args.content, 'utf-8');
+            return `Wrote ${bytes} bytes to ${args.path}`;
+        },
+    };
+}
+function createShellTool(shellTimeoutMs) {
+    return {
+        name: 'shell',
+        description: 'Execute a shell command and return its output.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: 'Shell command to execute' },
+                timeout_ms: { type: 'number', description: 'Timeout in milliseconds (optional)' },
+            },
+            required: ['command'],
+        },
+        outputTruncation: 10_000,
+        async executor(args, env) {
+            const timeout = args.timeout_ms !== undefined ? args.timeout_ms : shellTimeoutMs;
+            const result = await env.exec(args.command, timeout);
+            if (result.exitCode !== 0) {
+                throw new Error([result.stdout, result.stderr].filter(Boolean).join('\n') ||
+                    `Command failed with exit code ${result.exitCode}`);
+            }
+            const combined = [result.stdout, result.stderr].filter(Boolean).join('\n');
+            return combined || `(exit code ${result.exitCode})`;
+        },
+    };
+}
+function createGrepTool(shellTimeoutMs) {
+    return {
+        name: 'grep',
+        description: 'Search for a regex pattern in files. Returns matching lines with filenames and line numbers.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                pattern: { type: 'string', description: 'Regex pattern to search for' },
+                paths: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'File paths or directories to search in',
+                },
+            },
+            required: ['pattern', 'paths'],
+        },
+        outputTruncation: 10_000,
+        async executor(args, env) {
+            // Sanitize pattern and paths to prevent shell injection.
+            // Reject patterns containing shell metacharacters that could escape quoting.
+            if (/[`$\\]/.test(args.pattern) && /[`$]/.test(args.pattern)) {
+                // Fall back to safe Node.js regex scan for suspicious patterns
+                return nodeGrepFallback(args.pattern, args.paths);
+            }
+            // Escape double quotes and use -- to separate options from arguments
+            const escapedPattern = args.pattern.replace(/"/g, '\\"');
+            const escapedPaths = args.paths.map(p => `"${p.replace(/"/g, '\\"')}"`).join(' ');
+            const cmd = `rg --no-heading -n -- "${escapedPattern}" ${escapedPaths} 2>&1`;
+            try {
+                const result = await env.exec(cmd, shellTimeoutMs);
+                if (result.exitCode === 0 || result.stdout.trim() !== '') {
+                    return result.stdout || result.stderr;
+                }
+                if (result.exitCode === 1) {
+                    // rg exits 1 when no matches found
+                    return result.stdout;
+                }
+                // rg might not be available, fall back
+                throw new Error('rg not available');
+            }
+            catch (_err) {
+                // Fall back to Node regex line scan
+                return nodeGrepFallback(args.pattern, args.paths);
+            }
+        },
+    };
+}
+async function nodeGrepFallback(pattern, paths) {
+    const regex = new RegExp(pattern);
+    const results = [];
+    async function scanFile(filePath) {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i] ?? '';
+                if (regex.test(line)) {
+                    results.push(`${filePath}:${i + 1}:${line}`);
+                }
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    async function scanPath(p) {
+        try {
+            const entries = await readdir(p, { withFileTypes: true });
+            for (const entry of entries) {
+                const full = join(p, entry.name);
+                if (entry.isDirectory()) {
+                    await scanPath(full);
+                }
+                else {
+                    await scanFile(full);
+                }
+            }
+        }
+        catch {
+            // treat as file
+            await scanFile(p);
+        }
+    }
+    for (const p of paths) {
+        await scanPath(resolve(p));
+    }
+    return results.join('\n');
+}
+function createGlobTool() {
+    return {
+        name: 'glob',
+        description: 'Find files matching a glob pattern. Returns newline-separated matching paths.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                pattern: { type: 'string', description: 'Glob pattern to match files against' },
+            },
+            required: ['pattern'],
+        },
+        outputTruncation: 5_000,
+        async executor(args, env) {
+            return manualGlob(args.pattern, env);
+        },
+    };
+}
+async function manualGlob(pattern, env) {
+    // Route through env.exec so workdir is respected and sandboxing applies
+    try {
+        const result = await env.exec(`find . -path "./${pattern}" 2>/dev/null || true`, 5_000);
+        return result.stdout.trim();
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/agent/tools/shared.js.map

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

package/dist/agent/tools/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Core type definitions for the agent tool system.
+ * Story 48-6: Provider-Aligned Tool Sets
+ */
+/**
+ * Represents the execution environment for tools.
+ * Interface (not a class) to enable test mocking.
+ */
+export interface ExecutionEnvironment {
+    workdir: string;
+    exec(command: string, timeoutMs: number): Promise<ShellResult>;
+}
+/**
+ * Result of a shell command execution.
+ */
+export interface ShellResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Result returned from a tool execution.
+ */
+export interface ToolResult {
+    content: string;
+    isError: boolean;
+}
+/**
+ * Error thrown when tool argument validation fails.
+ */
+export declare class ToolValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Definition of a tool that can be registered with the ToolRegistry.
+ * The executor uses `any` for args to avoid covariance/contravariance issues
+ * when collecting tools of different arg types into a single array.
+ */
+export interface ToolDefinition<TArgs = any> {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    outputTruncation?: number;
+    executor: (args: TArgs, env: ExecutionEnvironment) => Promise<string>;
+}
+/**
+ * Interface for the ToolRegistry.
+ */
+export interface IToolRegistry {
+    register(tool: ToolDefinition): void;
+    execute(name: string, args: unknown, env: ExecutionEnvironment): Promise<ToolResult>;
+    get(name: string): ToolDefinition | undefined;
+    getDefinitions(): ToolDefinition[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AAEH,MAAM,WAAW,cAAc,CAAC,KAAK,GAAG,GAAG;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;IACpC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACpF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;IAC7C,cAAc,IAAI,cAAc,EAAE,CAAA;CACnC"}

package/dist/agent/tools/types.js

@@ -0,0 +1,14 @@
+/**
+ * Core type definitions for the agent tool system.
+ * Story 48-6: Provider-Aligned Tool Sets
+ */
+/**
+ * Error thrown when tool argument validation fails.
+ */
+export class ToolValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ToolValidationError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/agent/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/tools/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}

package/dist/agent/truncation.d.ts

@@ -0,0 +1,29 @@
+import type { SessionConfig } from './types.js';
+/**
+ * Default per-tool character output limits.
+ * Tools not listed here fall back to DEFAULT_FALLBACK_CHAR_LIMIT (10,000).
+ *
+ * Note: shell is 30K (not 10K as in the AC) — shell output often contains build logs,
+ * test results, and compiler errors that need more context for effective debugging.
+ * The 10K AC value was based on interactive shell use; 30K reflects agentic workloads.
+ */
+export declare const DEFAULT_TOOL_LIMITS: {
+    readonly read_file: 50000;
+    readonly shell: 30000;
+    readonly grep: 20000;
+    readonly glob: 20000;
+};
+/** Fallback character limit for tools not in DEFAULT_TOOL_LIMITS */
+export declare const DEFAULT_FALLBACK_CHAR_LIMIT = 10000;
+/** Maximum lines before Phase 2 line-based truncation is applied */
+export declare const DEFAULT_LINE_LIMIT = 500;
+/**
+ * Truncates tool output to fit within LLM context windows using a two-phase pipeline.
+ *
+ * Phase 1 (character-based): Applies per-tool character limits in head_tail or tail mode.
+ * Phase 2 (line-based): Applies max_output_lines limit in head_tail or tail mode.
+ *
+ * If output is within both limits, returns the original string unchanged.
+ */
+export declare function truncateToolOutput(output: string, toolName: string, config: SessionConfig): string;
+//# sourceMappingURL=truncation.d.ts.map

package/dist/agent/truncation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../../src/agent/truncation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAM/C;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAA;AAEV,oEAAoE;AACpE,eAAO,MAAM,2BAA2B,QAAS,CAAA;AAEjD,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAwCrC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,GACpB,MAAM,CAWR"}

package/dist/agent/truncation.js

@@ -0,0 +1,76 @@
+// packages/factory/src/agent/truncation.ts
+// Output truncation utilities for the agentic loop.
+// Story 48-7: Coding Agent Loop — Core Agentic Loop
+// Story 48-9: Output Truncation — Two-Phase Algorithm
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Default per-tool character output limits.
+ * Tools not listed here fall back to DEFAULT_FALLBACK_CHAR_LIMIT (10,000).
+ *
+ * Note: shell is 30K (not 10K as in the AC) — shell output often contains build logs,
+ * test results, and compiler errors that need more context for effective debugging.
+ * The 10K AC value was based on interactive shell use; 30K reflects agentic workloads.
+ */
+export const DEFAULT_TOOL_LIMITS = {
+    read_file: 50_000,
+    shell: 30_000,
+    grep: 20_000,
+    glob: 20_000,
+};
+/** Fallback character limit for tools not in DEFAULT_TOOL_LIMITS */
+export const DEFAULT_FALLBACK_CHAR_LIMIT = 10_000;
+/** Maximum lines before Phase 2 line-based truncation is applied */
+export const DEFAULT_LINE_LIMIT = 500;
+// ---------------------------------------------------------------------------
+// Phase 1: Character-based truncation
+// ---------------------------------------------------------------------------
+function truncateByChars(output, limit, mode) {
+    if (output.length <= limit)
+        return output;
+    if (mode === 'tail')
+        return output.slice(-limit);
+    const half = Math.floor(limit / 2);
+    const removed = output.length - limit;
+    return (output.slice(0, half) +
+        `\n\n[... ${removed} characters truncated from middle. Full output available in event stream.]\n\n` +
+        output.slice(-half));
+}
+// ---------------------------------------------------------------------------
+// Phase 2: Line-based truncation
+// ---------------------------------------------------------------------------
+function truncateByLines(output, maxLines, mode) {
+    const lines = output.split('\n');
+    if (lines.length <= maxLines)
+        return output;
+    if (mode === 'tail')
+        return lines.slice(-maxLines).join('\n');
+    const headCount = Math.ceil(maxLines / 2);
+    const tailCount = Math.floor(maxLines / 2);
+    const removed = lines.length - maxLines;
+    return (lines.slice(0, headCount).join('\n') +
+        `\n[... ${removed} lines truncated from middle ...]\n` +
+        lines.slice(-tailCount).join('\n'));
+}
+// ---------------------------------------------------------------------------
+// Composed two-phase pipeline
+// ---------------------------------------------------------------------------
+/**
+ * Truncates tool output to fit within LLM context windows using a two-phase pipeline.
+ *
+ * Phase 1 (character-based): Applies per-tool character limits in head_tail or tail mode.
+ * Phase 2 (line-based): Applies max_output_lines limit in head_tail or tail mode.
+ *
+ * If output is within both limits, returns the original string unchanged.
+ */
+export function truncateToolOutput(output, toolName, config) {
+    const charLimit = config.tool_output_limits.get(toolName) ??
+        DEFAULT_TOOL_LIMITS[toolName] ??
+        DEFAULT_FALLBACK_CHAR_LIMIT;
+    const mode = config.truncation_mode ?? 'head_tail';
+    const maxLines = config.max_output_lines ?? DEFAULT_LINE_LIMIT;
+    const afterPhase1 = truncateByChars(output, charLimit, mode);
+    return truncateByLines(afterPhase1, maxLines, mode);
+}
+//# sourceMappingURL=truncation.js.map

package/dist/agent/truncation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.js","sourceRoot":"","sources":["../../src/agent/truncation.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,oDAAoD;AACpD,oDAAoD;AACpD,sDAAsD;AAItD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACJ,CAAA;AAEV,oEAAoE;AACpE,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAA;AAEjD,oEAAoE;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAErC,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E,SAAS,eAAe,CAAC,MAAc,EAAE,KAAa,EAAE,IAA0B;IAChF,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,MAAM,CAAA;IACzC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAA;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IAClC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,KAAK,CAAA;IACrC,OAAO,CACL,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QACrB,YAAY,OAAO,gFAAgF;QACnG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CACpB,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E,SAAS,eAAe,CAAC,MAAc,EAAE,QAAgB,EAAE,IAA0B;IACnF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,MAAM,CAAA;IAC3C,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAA;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAA;IACvC,OAAO,CACL,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACpC,UAAU,OAAO,qCAAqC;QACtD,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACnC,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,QAAgB,EAChB,MAAqB;IAErB,MAAM,SAAS,GACb,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACvC,mBAAmB,CAAC,QAA4C,CAAC;QACjE,2BAA2B,CAAA;IAE7B,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,IAAI,WAAW,CAAA;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,IAAI,kBAAkB,CAAA;IAE9D,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;IAC5D,OAAO,eAAe,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;AACrD,CAAC"}