@animus-labs/cortex 0.2.0

package/dist/tools/read.js

@@ -0,0 +1,459 @@
+/**
+ * Read tool: read file contents from the local filesystem.
+ *
+ * Returns file content with line numbers in `cat -n` format.
+ * Handles text files, images (base64 ImageContent), and
+ * detects binary files.
+ *
+ * Reference: docs/cortex/tools/read.md
+ */
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { Type } from 'typebox';
+import { attachRuntimeAwareTool } from './runtime.js';
+import { estimateTokens } from '../token-estimator.js';
+import { extractPdfText } from './shared/pdf-extractor.js';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+export const ReadParams = Type.Object({
+    file_path: Type.String({ description: 'Absolute path to the file to read' }),
+    offset: Type.Optional(Type.Number({ description: 'Line number to start reading from (1-based). Only provide if the file is too large to read at once.' })),
+    limit: Type.Optional(Type.Number({ description: 'Maximum number of lines to read. Only provide if the file is too large to read at once.' })),
+    pages: Type.Optional(Type.String({ description: 'Page range for PDF files (e.g., "1-5", "3", "10-20"). Only applicable to PDF files. Max 20 pages per request.' })),
+});
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_LIMIT = 2000;
+const MAX_LINE_LENGTH = 2000;
+/** Pre-read gate for full reads (no offset/limit provided). */
+const MAX_FULL_READ_BYTES = 256 * 1024; // 256 KB
+/** Hard ceiling even with offset/limit. Beyond this, use Bash. */
+const MAX_READABLE_BYTES = 10 * 1024 * 1024; // 10 MB
+/** Post-read token ceiling on formatted output. */
+const MAX_OUTPUT_TOKENS = 25_000;
+const IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp']);
+const IMAGE_MIME_TYPES = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+};
+/**
+ * Device files that would hang the process: infinite output or blocking input.
+ * Checked by path only (no I/O).
+ */
+const BLOCKED_DEVICE_PATHS = new Set([
+    // Infinite output
+    '/dev/zero',
+    '/dev/random',
+    '/dev/urandom',
+    '/dev/full',
+    // Blocks waiting for input
+    '/dev/stdin',
+    '/dev/tty',
+    '/dev/console',
+    // Nonsensical to read
+    '/dev/stdout',
+    '/dev/stderr',
+    // fd aliases for stdin/stdout/stderr
+    '/dev/fd/0',
+    '/dev/fd/1',
+    '/dev/fd/2',
+]);
+function isBlockedDevicePath(filePath) {
+    if (BLOCKED_DEVICE_PATHS.has(filePath))
+        return true;
+    // /proc/self/fd/0-2 and /proc/<pid>/fd/0-2 are Linux aliases for stdio
+    if (filePath.startsWith('/proc/') &&
+        (filePath.endsWith('/fd/0') ||
+            filePath.endsWith('/fd/1') ||
+            filePath.endsWith('/fd/2')))
+        return true;
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Detect if a buffer contains binary content.
+ * A file is considered binary if it contains null bytes in the first 8KB.
+ */
+function isBinaryBuffer(buffer) {
+    const checkLength = Math.min(buffer.length, 8192);
+    for (let i = 0; i < checkLength; i++) {
+        if (buffer[i] === 0) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Try to detect and decode file content with common encodings.
+ * Handles UTF-8, UTF-16 LE/BE (via BOM), and falls back to Latin-1.
+ */
+function decodeFileContent(buffer) {
+    // Check for UTF-16 BOM
+    if (buffer.length >= 2) {
+        if (buffer[0] === 0xff && buffer[1] === 0xfe) {
+            return buffer.toString('utf16le');
+        }
+        if (buffer[0] === 0xfe && buffer[1] === 0xff) {
+            // UTF-16 BE: swap bytes and decode as UTF-16 LE
+            const swapped = Buffer.alloc(buffer.length);
+            for (let i = 0; i < buffer.length - 1; i += 2) {
+                swapped[i] = buffer[i + 1];
+                swapped[i + 1] = buffer[i];
+            }
+            return swapped.toString('utf16le');
+        }
+    }
+    // Check for UTF-8 BOM
+    if (buffer.length >= 3 && buffer[0] === 0xef && buffer[1] === 0xbb && buffer[2] === 0xbf) {
+        return buffer.toString('utf8').slice(1); // Skip the BOM character
+    }
+    // Try UTF-8 first (most common)
+    const utf8 = buffer.toString('utf8');
+    // Check for replacement characters that suggest bad UTF-8 decoding
+    // Only fall back to Latin-1 if there are many replacement chars
+    const replacementCount = (utf8.match(/\ufffd/g) ?? []).length;
+    if (replacementCount > 0 && replacementCount > buffer.length * 0.01) {
+        return buffer.toString('latin1');
+    }
+    return utf8;
+}
+/**
+ * Format lines with `cat -n` style line numbers.
+ * Format: spaces + line_number + tab + content
+ */
+function formatWithLineNumbers(lines, startLine) {
+    const maxLineNum = startLine + lines.length - 1;
+    const width = String(maxLineNum).length;
+    return lines
+        .map((line, i) => {
+        const lineNum = startLine + i;
+        const paddedNum = String(lineNum).padStart(width + 2);
+        // Truncate long lines
+        const truncatedLine = line.length > MAX_LINE_LENGTH
+            ? line.slice(0, MAX_LINE_LENGTH) + '... [truncated]'
+            : line;
+        return `${paddedNum}\t${truncatedLine}`;
+    })
+        .join('\n');
+}
+/**
+ * Format byte count as a human-readable string (KB or MB).
+ */
+function formatBytes(bytes) {
+    if (bytes >= 1024 * 1024) {
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    }
+    return `${Math.round(bytes / 1024)} KB`;
+}
+/**
+ * Build a rejection result for size/token gate failures.
+ * Returns an error message as tool content with `rejected: true` in details.
+ */
+function makeRejection(filePath, byteSize, message) {
+    return {
+        content: [{ type: 'text', text: message }],
+        details: {
+            filePath,
+            totalLines: 0,
+            byteSize,
+            truncated: false,
+            truncatedLines: false,
+            truncatedChars: false,
+            startLine: 1,
+            rejected: true,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Tool factory
+// ---------------------------------------------------------------------------
+export function createReadTool(config) {
+    const readRegistry = config.runtime?.readRegistry ?? config.readRegistry;
+    if (!readRegistry) {
+        throw new Error('createReadTool requires either runtime or readRegistry');
+    }
+    const tool = {
+        name: 'Read',
+        description: [
+            'Read file contents from the local filesystem.',
+            'Returns content with line numbers in cat -n format.',
+            '',
+            'Size limits:',
+            `- Files up to ${formatBytes(MAX_FULL_READ_BYTES)}: read in full (no offset/limit needed)`,
+            `- Files ${formatBytes(MAX_FULL_READ_BYTES)} to ${formatBytes(MAX_READABLE_BYTES)}: must provide offset and limit`,
+            `- Files over ${formatBytes(MAX_READABLE_BYTES)}: use Bash (head, tail, sed) instead`,
+            `- Output capped at ~${MAX_OUTPUT_TOKENS.toLocaleString()} tokens; reduce limit if exceeded`,
+            '',
+            'For searching file contents, use Grep instead of reading the whole file.',
+        ].join('\n'),
+        parameters: ReadParams,
+        async execute(params) {
+            const filePath = path.resolve(params.file_path);
+            const offset = params.offset ?? 1;
+            const limit = params.limit ?? DEFAULT_LIMIT;
+            // Block device paths that would hang (infinite output or blocking input)
+            if (isBlockedDevicePath(filePath)) {
+                return {
+                    content: [{ type: 'text', text: `Cannot read '${params.file_path}': this device file would block or produce infinite output.` }],
+                    details: {
+                        filePath,
+                        totalLines: 0,
+                        byteSize: 0,
+                        truncated: false,
+                        truncatedLines: false,
+                        truncatedChars: false,
+                        startLine: 1,
+                    },
+                };
+            }
+            // Check if path exists
+            let stat;
+            try {
+                stat = await fs.promises.stat(filePath);
+            }
+            catch (err) {
+                const code = err.code;
+                if (code === 'ENOENT') {
+                    return {
+                        content: [{ type: 'text', text: `File does not exist: ${filePath}` }],
+                        details: {
+                            filePath,
+                            totalLines: 0,
+                            byteSize: 0,
+                            truncated: false,
+                            truncatedLines: false,
+                            truncatedChars: false,
+                            startLine: 1,
+                        },
+                    };
+                }
+                if (code === 'EACCES') {
+                    return {
+                        content: [{ type: 'text', text: `Permission denied: ${filePath}` }],
+                        details: {
+                            filePath,
+                            totalLines: 0,
+                            byteSize: 0,
+                            truncated: false,
+                            truncatedLines: false,
+                            truncatedChars: false,
+                            startLine: 1,
+                        },
+                    };
+                }
+                throw err;
+            }
+            // Cannot read directories
+            if (stat.isDirectory()) {
+                return {
+                    content: [{ type: 'text', text: 'Cannot read a directory. Use `ls` via Bash.' }],
+                    details: {
+                        filePath,
+                        totalLines: 0,
+                        byteSize: 0,
+                        truncated: false,
+                        truncatedLines: false,
+                        truncatedChars: false,
+                        startLine: 1,
+                    },
+                };
+            }
+            // Gate 1: Absolute size ceiling - reject files > 10 MB entirely
+            if (stat.size > MAX_READABLE_BYTES) {
+                return makeRejection(filePath, stat.size, `File is too large to read (${formatBytes(stat.size)}, limit ${formatBytes(MAX_READABLE_BYTES)}). Use Bash with head, tail, or sed to extract specific sections.`);
+            }
+            const ext = path.extname(filePath).toLowerCase();
+            // Handle image files
+            if (IMAGE_EXTENSIONS.has(ext)) {
+                const buffer = await fs.promises.readFile(filePath);
+                const mimeType = IMAGE_MIME_TYPES[ext] ?? 'application/octet-stream';
+                const base64 = buffer.toString('base64');
+                readRegistry.markRead(filePath, { timestamp: stat.mtimeMs });
+                return {
+                    content: [{ type: 'image', data: base64, mimeType }],
+                    details: {
+                        filePath,
+                        totalLines: 0,
+                        byteSize: stat.size,
+                        truncated: false,
+                        truncatedLines: false,
+                        truncatedChars: false,
+                        startLine: 1,
+                    },
+                };
+            }
+            // Handle PDF files. The extractor (shared/pdf-extractor.ts) wraps
+            // unpdf and returns a structured result: the Read tool's only
+            // responsibility is to decide how to surface each outcome.
+            if (ext === '.pdf') {
+                const pdfBuffer = await fs.promises.readFile(filePath);
+                const extraction = await extractPdfText({
+                    data: pdfBuffer,
+                    pagesSpec: params.pages,
+                });
+                if (extraction.kind === 'error' ||
+                    extraction.kind === 'invalid-range' ||
+                    extraction.kind === 'empty') {
+                    // All three are read failures from the caller's perspective:
+                    // there is no usable content to hand to the model. Flag as
+                    // rejected so consumers can surface them uniformly and the
+                    // model can retry (with a different pages spec, OCR, etc.).
+                    return makeRejection(filePath, stat.size, extraction.message);
+                }
+                // Line-number the rendered output to match the cat -n style
+                // used for text files. Line numbers reset to 1 per call; PDFs
+                // don't map cleanly to the file-wide offset/limit model.
+                const renderedLines = extraction.rendered.split('\n');
+                const formatted = formatWithLineNumbers(renderedLines, 1);
+                // Gate 3: token ceiling on the formatted output.
+                const pdfTokenCount = estimateTokens(formatted);
+                if (pdfTokenCount > MAX_OUTPUT_TOKENS) {
+                    const requestedPages = extraction.lastPage - extraction.firstPage + 1;
+                    const suggestedPages = Math.max(1, Math.floor(requestedPages * MAX_OUTPUT_TOKENS / pdfTokenCount));
+                    return makeRejection(filePath, stat.size, `PDF extraction too large (estimated ~${pdfTokenCount.toLocaleString()} tokens, limit ${MAX_OUTPUT_TOKENS.toLocaleString()}). ` +
+                        `Narrow the \`pages\` range (try ~${suggestedPages} page${suggestedPages === 1 ? '' : 's'} per call).`);
+                }
+                readRegistry.markRead(filePath, { timestamp: stat.mtimeMs });
+                return {
+                    content: [{ type: 'text', text: formatted }],
+                    details: {
+                        filePath,
+                        totalLines: renderedLines.length,
+                        byteSize: stat.size,
+                        truncated: false,
+                        truncatedLines: false,
+                        truncatedChars: false,
+                        startLine: 1,
+                    },
+                };
+            }
+            // Gate 2: Full-read size gate - reject full reads of files > 256 KB
+            const hasExplicitRange = params.offset !== undefined || params.limit !== undefined;
+            if (!hasExplicitRange && stat.size > MAX_FULL_READ_BYTES) {
+                return makeRejection(filePath, stat.size, `File is too large to read in full (${formatBytes(stat.size)}, limit ${formatBytes(MAX_FULL_READ_BYTES)}). Provide offset and limit to read a specific range, or use Grep to search for specific content.`);
+            }
+            // File-unchanged dedup: if we already read this exact range and the
+            // file hasn't changed on disk, return a stub. The earlier Read result
+            // is still in context, so re-sending wastes tokens.
+            const existingState = readRegistry.getState(filePath);
+            if (existingState && existingState.offset !== undefined) {
+                const rangeMatch = existingState.offset === offset && existingState.limit === limit;
+                if (rangeMatch && stat.mtimeMs === existingState.timestamp) {
+                    return {
+                        content: [{ type: 'text', text: `[File unchanged since last read: ${filePath}]` }],
+                        details: {
+                            filePath,
+                            totalLines: 0,
+                            byteSize: stat.size,
+                            truncated: false,
+                            truncatedLines: false,
+                            truncatedChars: false,
+                            startLine: 1,
+                        },
+                    };
+                }
+            }
+            // Read the raw buffer
+            const buffer = await fs.promises.readFile(filePath);
+            // Binary detection (not image, not PDF)
+            if (isBinaryBuffer(buffer)) {
+                return {
+                    content: [{ type: 'text', text: 'Binary file detected. Cannot display as text.' }],
+                    details: {
+                        filePath,
+                        totalLines: 0,
+                        byteSize: stat.size,
+                        truncated: false,
+                        truncatedLines: false,
+                        truncatedChars: false,
+                        startLine: 1,
+                    },
+                };
+            }
+            // Decode and split into lines
+            const content = decodeFileContent(buffer);
+            const allLines = content.split('\n');
+            const totalLines = allLines.length;
+            // Handle empty file
+            if (totalLines === 0 || (totalLines === 1 && allLines[0] === '')) {
+                readRegistry.markRead(filePath, { timestamp: stat.mtimeMs, offset, limit });
+                return {
+                    content: [{ type: 'text', text: `[File is empty: ${filePath}]` }],
+                    details: {
+                        filePath,
+                        totalLines: 0,
+                        byteSize: stat.size,
+                        truncated: false,
+                        truncatedLines: false,
+                        truncatedChars: false,
+                        startLine: 1,
+                    },
+                };
+            }
+            // Apply offset and limit
+            const startIdx = Math.max(0, offset - 1); // Convert 1-based to 0-based
+            const endIdx = Math.min(totalLines, startIdx + limit);
+            const selectedLines = allLines.slice(startIdx, endIdx);
+            const truncatedLines = endIdx < totalLines;
+            const truncatedChars = selectedLines.some((line) => line.length > MAX_LINE_LENGTH);
+            // Format with line numbers
+            const formatted = formatWithLineNumbers(selectedLines, startIdx + 1);
+            // Gate 3: Post-read token estimation
+            const estimatedTokenCount = estimateTokens(formatted);
+            if (estimatedTokenCount > MAX_OUTPUT_TOKENS) {
+                const suggestedLimit = Math.floor(limit * MAX_OUTPUT_TOKENS / estimatedTokenCount);
+                return makeRejection(filePath, stat.size, `Read result too large (estimated ~${estimatedTokenCount.toLocaleString()} tokens, limit ${MAX_OUTPUT_TOKENS.toLocaleString()}). ` +
+                    `The file has ${totalLines} lines. Use a smaller limit (try limit: ${Math.max(1, suggestedLimit)}) ` +
+                    `or use Grep to find the specific content you need.`);
+            }
+            // Only mark as read after passing all gates, so rejected reads
+            // can be retried without hitting the dedup stub.
+            // For full, non-truncated reads, record a content hash so the
+            // Edit/Write tools can distinguish real file modifications from
+            // mtime-only changes (formatters, cloud sync, antivirus, etc.).
+            const isFullRead = !hasExplicitRange && !truncatedLines;
+            const contentHash = isFullRead
+                ? crypto.createHash('sha256').update(buffer).digest('hex')
+                : undefined;
+            readRegistry.markRead(filePath, {
+                timestamp: stat.mtimeMs,
+                offset,
+                limit,
+                ...(contentHash !== undefined ? { contentHash } : {}),
+            });
+            let text = formatted;
+            if (truncatedLines) {
+                text += `\n\n[Showing lines ${startIdx + 1}-${endIdx} of ${totalLines} total. Use offset/limit to read more.]`;
+            }
+            return {
+                content: [{ type: 'text', text }],
+                details: {
+                    filePath,
+                    totalLines,
+                    byteSize: stat.size,
+                    truncated: truncatedLines || truncatedChars,
+                    truncatedLines,
+                    truncatedChars,
+                    startLine: offset,
+                },
+            };
+        },
+    };
+    return attachRuntimeAwareTool(tool, {
+        toolKind: 'Read',
+        cloneForRuntime: (runtime) => createReadTool({
+            ...config,
+            runtime,
+            readRegistry: runtime.readRegistry,
+        }),
+    });
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/runtime.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Per-agent runtime state for mutable built-in tool behavior.
+ *
+ * Cortex clones runtime-aware built-in tools into a fresh runtime for each
+ * agent so parent and child agents do not share mutable closures.
+ */
+import type * as child_process from 'node:child_process';
+import { CwdTracker } from './shared/cwd-tracker.js';
+import { EditHistory } from './shared/edit-history.js';
+import { FileMutationLock } from './shared/file-mutation-lock.js';
+import { ReadRegistry } from './shared/read-registry.js';
+import { WebFetchCache } from './web-fetch/cache.js';
+export interface BackgroundTask {
+    id: string;
+    /** The command that was executed (for status display). */
+    command: string;
+    process: child_process.ChildProcess;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    completed: boolean;
+    startTime: number;
+}
+export declare class BackgroundTaskStore {
+    private readonly tasks;
+    private taskIdCounter;
+    nextTaskId(): string;
+    set(task: BackgroundTask): void;
+    get(taskId: string): BackgroundTask | undefined;
+    getAll(): Map<string, BackgroundTask>;
+    cleanupCompletedTasks(maxAgeMs?: number): void;
+    clear(): void;
+}
+export declare const globalBackgroundTaskStore: BackgroundTaskStore;
+export declare class WebFetchRuntimeState {
+    private readonly cache;
+    private fetchesThisLoop;
+    getCache(): WebFetchCache;
+    get fetchCount(): number;
+    incrementFetchCount(): void;
+    resetLoop(): void;
+    destroy(): void;
+}
+export declare class CortexToolRuntime {
+    readonly cwdTracker: CwdTracker;
+    readonly readRegistry: ReadRegistry;
+    readonly fileMutationLock: FileMutationLock;
+    readonly editHistory: EditHistory;
+    readonly backgroundTasks: BackgroundTaskStore;
+    readonly webFetch: WebFetchRuntimeState;
+    constructor(workingDirectory: string);
+    resetForLoop(): void;
+    destroy(): void;
+}
+export interface RuntimeAwareToolMetadata<TTool> {
+    readonly toolKind: string;
+    cloneForRuntime: (runtime: CortexToolRuntime) => TTool;
+}
+export declare function attachRuntimeAwareTool<TTool extends object>(tool: TTool, metadata: RuntimeAwareToolMetadata<TTool>): TTool;
+export declare function getRuntimeAwareToolMetadata<TTool>(tool: TTool): RuntimeAwareToolMetadata<TTool> | undefined;
+export declare function cloneRuntimeAwareTool<TTool>(tool: TTool, runtime: CortexToolRuntime): TTool | null;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/tools/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/tools/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMrD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,aAAa,CAAK;IAE1B,UAAU,IAAI,MAAM;IAKpB,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAI/B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/C,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAIrC,qBAAqB,CAAC,QAAQ,SAAiB,GAAG,IAAI;IAStD,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,yBAAyB,qBAA4B,CAAC;AAMnE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,eAAe,CAAK;IAE5B,QAAQ,IAAI,aAAa;IAIzB,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,mBAAmB,IAAI,IAAI;IAI3B,SAAS,IAAI,IAAI;IAIjB,OAAO,IAAI,IAAI;CAGhB;AAMD,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;gBAE5B,gBAAgB,EAAE,MAAM;IASpC,YAAY,IAAI,IAAI;IAQpB,OAAO,IAAI,IAAI;CAOhB;AAMD,MAAM,WAAW,wBAAwB,CAAC,KAAK;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,KAAK,CAAC;CACxD;AAID,wBAAgB,sBAAsB,CAAC,KAAK,SAAS,MAAM,EACzD,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,wBAAwB,CAAC,KAAK,CAAC,GACxC,KAAK,CAQP;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAC/C,IAAI,EAAE,KAAK,GACV,wBAAwB,CAAC,KAAK,CAAC,GAAG,SAAS,CAI7C;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EACzC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,iBAAiB,GACzB,KAAK,GAAG,IAAI,CAGd"}

package/dist/tools/runtime.js

@@ -0,0 +1,116 @@
+/**
+ * Per-agent runtime state for mutable built-in tool behavior.
+ *
+ * Cortex clones runtime-aware built-in tools into a fresh runtime for each
+ * agent so parent and child agents do not share mutable closures.
+ */
+import { CwdTracker } from './shared/cwd-tracker.js';
+import { EditHistory } from './shared/edit-history.js';
+import { FileMutationLock } from './shared/file-mutation-lock.js';
+import { ReadRegistry } from './shared/read-registry.js';
+import { WebFetchCache } from './web-fetch/cache.js';
+export class BackgroundTaskStore {
+    tasks = new Map();
+    taskIdCounter = 0;
+    nextTaskId() {
+        this.taskIdCounter += 1;
+        return `task_${this.taskIdCounter}`;
+    }
+    set(task) {
+        this.tasks.set(task.id, task);
+    }
+    get(taskId) {
+        return this.tasks.get(taskId);
+    }
+    getAll() {
+        return this.tasks;
+    }
+    cleanupCompletedTasks(maxAgeMs = 30 * 60 * 1000) {
+        const now = Date.now();
+        for (const [id, task] of this.tasks) {
+            if (task.completed && now - task.startTime > maxAgeMs) {
+                this.tasks.delete(id);
+            }
+        }
+    }
+    clear() {
+        this.tasks.clear();
+    }
+}
+export const globalBackgroundTaskStore = new BackgroundTaskStore();
+// ---------------------------------------------------------------------------
+// WebFetch runtime state
+// ---------------------------------------------------------------------------
+export class WebFetchRuntimeState {
+    cache = new WebFetchCache();
+    fetchesThisLoop = 0;
+    getCache() {
+        return this.cache;
+    }
+    get fetchCount() {
+        return this.fetchesThisLoop;
+    }
+    incrementFetchCount() {
+        this.fetchesThisLoop += 1;
+    }
+    resetLoop() {
+        this.fetchesThisLoop = 0;
+    }
+    destroy() {
+        this.cache.destroy();
+    }
+}
+// ---------------------------------------------------------------------------
+// Per-agent runtime container
+// ---------------------------------------------------------------------------
+export class CortexToolRuntime {
+    cwdTracker;
+    readRegistry;
+    fileMutationLock;
+    editHistory;
+    backgroundTasks;
+    webFetch;
+    constructor(workingDirectory) {
+        this.cwdTracker = new CwdTracker(workingDirectory);
+        this.readRegistry = new ReadRegistry();
+        this.fileMutationLock = new FileMutationLock();
+        this.editHistory = new EditHistory();
+        this.backgroundTasks = new BackgroundTaskStore();
+        this.webFetch = new WebFetchRuntimeState();
+    }
+    resetForLoop() {
+        this.cwdTracker.reset();
+        this.readRegistry.clear();
+        this.fileMutationLock.clear();
+        this.editHistory.clear();
+        this.webFetch.resetLoop();
+    }
+    destroy() {
+        this.readRegistry.clear();
+        this.fileMutationLock.clear();
+        this.editHistory.clear();
+        this.backgroundTasks.clear();
+        this.webFetch.destroy();
+    }
+}
+const RUNTIME_AWARE_TOOL = Symbol.for('cortex.runtimeAwareTool');
+export function attachRuntimeAwareTool(tool, metadata) {
+    Object.defineProperty(tool, RUNTIME_AWARE_TOOL, {
+        value: metadata,
+        enumerable: false,
+        configurable: false,
+        writable: false,
+    });
+    return tool;
+}
+export function getRuntimeAwareToolMetadata(tool) {
+    if (!tool || typeof tool !== 'object')
+        return undefined;
+    const record = tool;
+    return record[RUNTIME_AWARE_TOOL];
+}
+export function cloneRuntimeAwareTool(tool, runtime) {
+    const metadata = getRuntimeAwareToolMetadata(tool);
+    return metadata ? metadata.cloneForRuntime(runtime) : null;
+}
+//# sourceMappingURL=runtime.js.map