@nexrall/code-core 1.0.0

package/dist/tools/sandbox.d.ts

@@ -0,0 +1,13 @@
+export interface SandboxConfig {
+    enabled: boolean;
+    network: boolean;
+    writePaths: string[];
+}
+export declare function parseSandboxConfig(raw: unknown): SandboxConfig | null;
+export interface WrapResult {
+    command: string;
+    sandboxed: boolean;
+    note?: string;
+}
+export declare function wrapCommandForSandbox(command: string, workDir: string, cfg: SandboxConfig): WrapResult;
+//# sourceMappingURL=sandbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/tools/sandbox.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAarE;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiCD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,UAAU,CAoDtG"}

package/dist/tools/sandbox.js

@@ -0,0 +1,140 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSandboxConfig = parseSandboxConfig;
+exports.wrapCommandForSandbox = wrapCommandForSandbox;
+const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
+function parseSandboxConfig(raw) {
+    if (raw === undefined || raw === null || raw === false || raw === 'off')
+        return null;
+    if (raw === true || raw === 'workspace-write')
+        return { enabled: true, network: false, writePaths: [] };
+    if (typeof raw === 'object') {
+        const o = raw;
+        if (o.enabled === false)
+            return null;
+        return {
+            enabled: true,
+            network: o.network === true,
+            writePaths: Array.isArray(o.writePaths) ? o.writePaths.filter((x) => typeof x === 'string') : [],
+        };
+    }
+    return null;
+}
+let _bwrapChecked = false;
+let _bwrapAvailable = false;
+function commandExists(cmd) {
+    try {
+        (0, child_process_1.execSync)(`command -v ${cmd}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function shQuote(s) {
+    return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+function buildSeatbeltProfile(writePaths, allowNetwork) {
+    // Seatbelt evaluates rules top-down, last match wins:
+    // allow everything, revoke all writes, then re-grant writes to specific roots.
+    const writeRules = writePaths.map((p) => `(subpath ${JSON.stringify(p)})`).join(' ');
+    const lines = [
+        '(version 1)',
+        '(allow default)',
+        '(deny file-write*)',
+        `(allow file-write* ${writeRules})`,
+        '(allow file-write-data (literal "/dev/null") (literal "/dev/stdout") (literal "/dev/stderr") (literal "/dev/dtracehelper") (literal "/dev/tty"))',
+    ];
+    if (!allowNetwork)
+        lines.push('(deny network*)');
+    return lines.join('\n');
+}
+function wrapCommandForSandbox(command, workDir, cfg) {
+    const platform = os.platform();
+    if (platform === 'darwin') {
+        const writePaths = Array.from(new Set([workDir, '/tmp', '/private/tmp', '/private/var/folders', os.tmpdir(), ...cfg.writePaths]));
+        const profile = buildSeatbeltProfile(writePaths, cfg.network);
+        return {
+            command: `sandbox-exec -p ${shQuote(profile)} /bin/sh -c ${shQuote(command)}`,
+            sandboxed: true,
+        };
+    }
+    if (platform === 'linux') {
+        if (!_bwrapChecked) {
+            _bwrapAvailable = commandExists('bwrap');
+            _bwrapChecked = true;
+        }
+        if (!_bwrapAvailable) {
+            return { command, sandboxed: false, note: 'sandbox requested but bubblewrap (bwrap) is not installed — running unsandboxed.' };
+        }
+        const args = [
+            '--ro-bind / /',
+            '--dev /dev',
+            '--proc /proc',
+            '--tmpfs /tmp',
+            `--bind ${shQuote(workDir)} ${shQuote(workDir)}`,
+        ];
+        for (const p of cfg.writePaths)
+            args.push(`--bind ${shQuote(p)} ${shQuote(p)}`);
+        if (!cfg.network)
+            args.push('--unshare-net');
+        args.push('--die-with-parent', `--chdir ${shQuote(workDir)}`);
+        return {
+            command: `bwrap ${args.join(' ')} /bin/sh -c ${shQuote(command)}`,
+            sandboxed: true,
+        };
+    }
+    if (platform === 'win32') {
+        // Windows has no lightweight in-process sandbox primitive equivalent to
+        // Seatbelt (macOS) or bubblewrap (Linux):
+        //  - AppContainer / job objects need native code + token manipulation, not
+        //    something we can wrap a shell string with.
+        //  - Windows Sandbox (WSB) is full-VM, per-invocation boot ≈ seconds, and
+        //    is unavailable on Home editions — unusable per bash call.
+        // Claude Code has the same limitation (no sandbox on Windows).
+        // Practical guidance: run inside WSL where bwrap works, so tell the user.
+        return {
+            command,
+            sandboxed: false,
+            note: 'sandbox requested but Windows has no supported OS sandbox — running unsandboxed. ' +
+                'Tip: run Nexrall Code inside WSL to get bubblewrap sandboxing, and rely on ' +
+                'permission rules (.nexrall/settings.json) for command gating on native Windows.',
+        };
+    }
+    return { command, sandboxed: false, note: `sandbox not supported on ${platform} — running unsandboxed.` };
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/tools/symbols.d.ts

@@ -0,0 +1,13 @@
+import type { ToolResult } from '../types';
+interface SymbolHit {
+    name: string;
+    kind: string;
+    line: number;
+}
+export declare function supportedSymbolExts(): Set<string>;
+/** Extract top-level-ish symbols from source text. Regex-based, best-effort. */
+export declare function extractSymbols(filePath: string, source: string): SymbolHit[];
+export declare function getSymbols(input: Record<string, unknown>, workDir?: string): Promise<ToolResult>;
+export declare function getWorkspaceSymbols(input: Record<string, unknown>, workDir?: string): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=symbols.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/tools/symbols.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAY3C,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAuGD,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,MAAM,CAAC,CAEjD;AAID,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CA6B5E;AASD,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAoBtG;AAQD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAmD/G"}

package/dist/tools/symbols.js

@@ -0,0 +1,279 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.supportedSymbolExts = supportedSymbolExts;
+exports.extractSymbols = extractSymbols;
+exports.getSymbols = getSymbols;
+exports.getWorkspaceSymbols = getWorkspaceSymbols;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// NOTE: patterns are matched per-line against trimmed lines; ^ anchors the
+// trimmed line start, so indented (nested/exported) declarations still match.
+const LANGS = [
+    {
+        exts: ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts'],
+        patterns: [
+            { re: /^export\s+default\s+(?:async\s+)?function\s*\*?\s*([A-Za-z_$][\w$]*)/, kind: 'function' },
+            { re: /^(?:export\s+)?(?:async\s+)?function\s*\*?\s*([A-Za-z_$][\w$]*)/, kind: 'function' },
+            { re: /^(?:export\s+)?(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)/, kind: 'class' },
+            { re: /^(?:export\s+)?interface\s+([A-Za-z_$][\w$]*)/, kind: 'interface' },
+            { re: /^(?:export\s+)?type\s+([A-Za-z_$][\w$]*)\s*=/, kind: 'type' },
+            { re: /^(?:export\s+)?(?:const\s+)?enum\s+([A-Za-z_$][\w$]*)/, kind: 'enum' },
+            { re: /^(?:export\s+)?const\s+([A-Za-z_$][\w$]*)\s*(?::[^=]+)?=\s*(?:async\s*)?\(/, kind: 'function' },
+            { re: /^(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)/, kind: 'variable' },
+        ],
+    },
+    {
+        exts: ['.py'],
+        patterns: [
+            { re: /^(?:async\s+)?def\s+([A-Za-z_]\w*)/, kind: 'function' },
+            { re: /^class\s+([A-Za-z_]\w*)/, kind: 'class' },
+            { re: /^([A-Z][A-Z0-9_]*)\s*(?::[^=]+)?=/, kind: 'constant' },
+        ],
+    },
+    {
+        exts: ['.go'],
+        patterns: [
+            { re: /^func\s+(?:\([^)]*\)\s*)?([A-Za-z_]\w*)/, kind: 'function' },
+            { re: /^type\s+([A-Za-z_]\w*)\s+struct\b/, kind: 'struct' },
+            { re: /^type\s+([A-Za-z_]\w*)\s+interface\b/, kind: 'interface' },
+            { re: /^type\s+([A-Za-z_]\w*)/, kind: 'type' },
+            { re: /^(?:var|const)\s+([A-Za-z_]\w*)/, kind: 'variable' },
+        ],
+    },
+    {
+        exts: ['.rs'],
+        patterns: [
+            { re: /^(?:pub(?:\([^)]*\))?\s+)?(?:async\s+)?fn\s+([A-Za-z_]\w*)/, kind: 'function' },
+            { re: /^(?:pub(?:\([^)]*\))?\s+)?struct\s+([A-Za-z_]\w*)/, kind: 'struct' },
+            { re: /^(?:pub(?:\([^)]*\))?\s+)?enum\s+([A-Za-z_]\w*)/, kind: 'enum' },
+            { re: /^(?:pub(?:\([^)]*\))?\s+)?trait\s+([A-Za-z_]\w*)/, kind: 'trait' },
+            { re: /^impl(?:<[^>]*>)?\s+(?:[\w:]+\s+for\s+)?([A-Za-z_]\w*)/, kind: 'impl' },
+            { re: /^(?:pub(?:\([^)]*\))?\s+)?(?:const|static)\s+([A-Za-z_]\w*)/, kind: 'constant' },
+        ],
+    },
+    {
+        exts: ['.java', '.kt', '.kts', '.scala'],
+        patterns: [
+            { re: /^(?:public|private|protected|internal)?\s*(?:static\s+)?(?:abstract\s+)?(?:final\s+)?(?:data\s+)?class\s+([A-Za-z_]\w*)/, kind: 'class' },
+            { re: /^(?:public|private|protected|internal)?\s*interface\s+([A-Za-z_]\w*)/, kind: 'interface' },
+            { re: /^(?:public|private|protected|internal)?\s*enum(?:\s+class)?\s+([A-Za-z_]\w*)/, kind: 'enum' },
+            { re: /^(?:public|private|protected|internal)?\s*(?:suspend\s+)?fun\s+([A-Za-z_]\w*)/, kind: 'function' },
+            { re: /^(?:public|private|protected|internal)?\s*(?:object|trait)\s+([A-Za-z_]\w*)/, kind: 'object' },
+            { re: /^def\s+([A-Za-z_]\w*)/, kind: 'function' },
+        ],
+    },
+    {
+        exts: ['.rb'],
+        patterns: [
+            { re: /^(?:def\s+(?:self\.)?)([A-Za-z_]\w*[?!=]?)/, kind: 'method' },
+            { re: /^class\s+([A-Z]\w*)/, kind: 'class' },
+            { re: /^module\s+([A-Z]\w*)/, kind: 'module' },
+        ],
+    },
+    {
+        exts: ['.php'],
+        patterns: [
+            { re: /^(?:abstract\s+|final\s+)?class\s+([A-Za-z_]\w*)/, kind: 'class' },
+            { re: /^interface\s+([A-Za-z_]\w*)/, kind: 'interface' },
+            { re: /^trait\s+([A-Za-z_]\w*)/, kind: 'trait' },
+            { re: /^(?:public\s+|private\s+|protected\s+|static\s+)*function\s+([A-Za-z_]\w*)/, kind: 'function' },
+        ],
+    },
+    {
+        exts: ['.c', '.h', '.cpp', '.hpp', '.cc', '.hh', '.m', '.mm'],
+        patterns: [
+            { re: /^(?:typedef\s+)?struct\s+([A-Za-z_]\w*)/, kind: 'struct' },
+            { re: /^(?:typedef\s+)?enum\s+([A-Za-z_]\w*)/, kind: 'enum' },
+            { re: /^class\s+([A-Za-z_]\w*)/, kind: 'class' },
+            { re: /^namespace\s+([A-Za-z_]\w*)/, kind: 'namespace' },
+            { re: /^#define\s+([A-Za-z_]\w*)/, kind: 'macro' },
+            // Function definitions: return-type + name + ( … no trailing ; on the line
+            { re: /^(?:static\s+|inline\s+|extern\s+|virtual\s+)*[A-Za-z_][\w:<>*&\s]*[\s*&]([A-Za-z_]\w*)\s*\([^;]*$/, kind: 'function' },
+        ],
+    },
+    {
+        exts: ['.sh', '.bash', '.zsh'],
+        patterns: [
+            { re: /^(?:function\s+)?([A-Za-z_][\w-]*)\s*\(\)\s*\{?/, kind: 'function' },
+        ],
+    },
+];
+const EXT_TO_LANG = new Map();
+for (const lang of LANGS)
+    for (const ext of lang.exts)
+        EXT_TO_LANG.set(ext, lang);
+function supportedSymbolExts() {
+    return new Set(EXT_TO_LANG.keys());
+}
+const MAX_FILE_BYTES = 1024 * 1024; // 1 MB — bigger files are skipped in workspace scan
+/** Extract top-level-ish symbols from source text. Regex-based, best-effort. */
+function extractSymbols(filePath, source) {
+    const lang = EXT_TO_LANG.get(path.extname(filePath).toLowerCase());
+    if (!lang)
+        return [];
+    const hits = [];
+    const lines = source.split('\n');
+    let inBlockComment = false;
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (!trimmed)
+            continue;
+        // Cheap comment skipping (good enough for symbol scanning)
+        if (inBlockComment) {
+            if (trimmed.includes('*/'))
+                inBlockComment = false;
+            continue;
+        }
+        if (trimmed.startsWith('/*')) {
+            if (!trimmed.includes('*/'))
+                inBlockComment = true;
+            continue;
+        }
+        // Skip line comments. '#' is a comment in py/rb/sh, but their declaration
+        // patterns all start with keywords (def/class/module/function) so '#' lines
+        // never match anyway — only '//' and doc-block continuation need skipping.
+        // '#define' must pass through for the C macro pattern.
+        if (trimmed.startsWith('//') || trimmed.startsWith('* '))
+            continue;
+        for (const { re, kind } of lang.patterns) {
+            const m = re.exec(trimmed);
+            if (m && m[1]) {
+                hits.push({ name: m[1], kind, line: i + 1 });
+                break; // first matching pattern wins for a line
+            }
+        }
+    }
+    return hits;
+}
+function resolveIn(workDir, p) {
+    const base = workDir ?? process.cwd();
+    return path.isAbsolute(p) ? p : path.resolve(base, p);
+}
+// ─── get_symbols (single file) ────────────────────────────────────────────────
+async function getSymbols(input, workDir) {
+    const rel = typeof input.path === 'string' ? input.path : '';
+    if (!rel)
+        return { error: 'path is required' };
+    const abs = resolveIn(workDir, rel);
+    let source;
+    try {
+        const st = fs.statSync(abs);
+        if (!st.isFile())
+            return { error: `Not a file: ${rel}` };
+        if (st.size > MAX_FILE_BYTES)
+            return { error: `File too large for symbol scan (${Math.round(st.size / 1024)} KB > 1024 KB)` };
+        source = fs.readFileSync(abs, 'utf-8');
+    }
+    catch (err) {
+        return { error: `Cannot read ${rel}: ${err.message}` };
+    }
+    if (!EXT_TO_LANG.has(path.extname(abs).toLowerCase())) {
+        return { output: `No symbol support for ${path.extname(abs) || 'this file type'} (regex-based scanner). Use search_files instead.` };
+    }
+    const hits = extractSymbols(abs, source);
+    if (!hits.length)
+        return { output: `No symbols found in ${rel}.` };
+    const lines = hits.map((h) => `${h.kind.padEnd(10)} ${h.name}  (line ${h.line})`);
+    return { output: `Symbols in ${rel} (${hits.length}):\n${lines.join('\n')}` };
+}
+// ─── get_workspace_symbols (project-wide) ─────────────────────────────────────
+const SKIP_DIRS = new Set(['.git', 'node_modules', 'dist', 'build', 'out', '.next', '__pycache__', '.turbo', 'coverage', 'vendor', 'target', '.venv', 'venv']);
+const MAX_RESULTS = 100;
+const MAX_FILES_SCANNED = 20000;
+async function getWorkspaceSymbols(input, workDir) {
+    const query = typeof input.query === 'string' ? input.query.trim() : '';
+    if (!query)
+        return { error: 'query is required' };
+    const root = workDir ?? process.cwd();
+    const q = query.toLowerCase();
+    const exts = supportedSymbolExts();
+    const results = [];
+    let scanned = 0;
+    const walk = (dir) => {
+        if (results.length >= MAX_RESULTS || scanned >= MAX_FILES_SCANNED)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (results.length >= MAX_RESULTS || scanned >= MAX_FILES_SCANNED)
+                return;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (SKIP_DIRS.has(entry.name) || entry.name.startsWith('.'))
+                    continue;
+                walk(full);
+            }
+            else if (entry.isFile() && exts.has(path.extname(entry.name).toLowerCase())) {
+                scanned++;
+                try {
+                    const st = fs.statSync(full);
+                    if (st.size > MAX_FILE_BYTES)
+                        continue;
+                    const source = fs.readFileSync(full, 'utf-8');
+                    // Cheap pre-filter: skip files that don't even contain the query text
+                    if (!source.toLowerCase().includes(q))
+                        continue;
+                    for (const h of extractSymbols(full, source)) {
+                        if (h.name.toLowerCase().includes(q)) {
+                            results.push({ ...h, file: path.relative(root, full) });
+                            if (results.length >= MAX_RESULTS)
+                                break;
+                        }
+                    }
+                }
+                catch { /* unreadable file — skip */ }
+            }
+        }
+    };
+    walk(root);
+    if (!results.length)
+        return { output: `No symbols matching "${query}" found (regex-based scan).` };
+    // Exact-name matches first, then partial, alphabetical within groups.
+    results.sort((a, b) => {
+        const aExact = a.name.toLowerCase() === q ? 0 : 1;
+        const bExact = b.name.toLowerCase() === q ? 0 : 1;
+        return aExact - bExact || a.name.localeCompare(b.name);
+    });
+    const lines = results.map((r) => `${r.kind.padEnd(10)} ${r.name}  ${r.file}:${r.line}`);
+    const capNote = results.length >= MAX_RESULTS ? `\n[Capped at ${MAX_RESULTS} results]` : '';
+    return { output: `Symbols matching "${query}" (${results.length}):\n${lines.join('\n')}${capNote}` };
+}
+//# sourceMappingURL=symbols.js.map

package/dist/types.d.ts

@@ -0,0 +1,186 @@
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export interface ToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+export type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock;
+export interface Message {
+    role: 'user' | 'assistant';
+    content: ContentBlock[];
+}
+export interface SSETextEvent {
+    type: 'text';
+    text: string;
+}
+export interface SSEToolUseEvent {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface SSEMessageCompleteEvent {
+    type: 'message_complete';
+    message: Message;
+}
+export interface SSEUsageEvent {
+    type: 'usage';
+    usage: UsageInfo;
+}
+export interface SSEDoneEvent {
+    type: 'done';
+}
+export interface SSEErrorEvent {
+    type: 'error';
+    message: string;
+}
+export interface SSEThinkingEvent {
+    type: 'thinking';
+    text: string;
+}
+export interface SSEThinkingProgressEvent {
+    type: 'thinking_progress';
+    tokens: number;
+}
+export interface SSEThinkingDeltaEvent {
+    type: 'thinking_delta';
+    text: string;
+}
+export type SSEEvent = SSETextEvent | SSEToolUseEvent | SSEMessageCompleteEvent | SSEUsageEvent | SSEDoneEvent | SSEErrorEvent | SSEThinkingEvent | SSEThinkingProgressEvent | SSEThinkingDeltaEvent;
+export interface UsageInfo {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+export interface ToolResult {
+    output?: string;
+    error?: string;
+    interrupted?: boolean;
+}
+export interface AuthConfig {
+    token: string;
+    email?: string;
+}
+export interface PermissionRequest {
+    tool: string;
+    input: Record<string, unknown>;
+    description: string;
+}
+export interface EnvContext {
+    cwd?: string;
+    platform?: string;
+    shell?: string;
+    gitBranch?: string;
+    gitStatus?: string;
+    gitDiff?: string;
+    date?: string;
+    recentCommits?: string;
+}
+export interface EditorContext {
+    activeFile?: string;
+    selectedText?: string;
+    cursorLine?: number;
+    openTabs?: string[];
+    /** Diagnostics for the active file only (errors + warnings). */
+    diagnostics?: Array<{
+        severity: string;
+        file: string;
+        line: number;
+        message: string;
+    }>;
+    /** Workspace-wide diagnostics aggregated across all files. */
+    workspaceDiagnostics?: Array<{
+        severity: string;
+        file: string;
+        line: number;
+        column: number;
+        message: string;
+    }>;
+    /** Shallow project file tree (2 levels, noise-filtered). */
+    projectTree?: string;
+    /** Symbols (functions, classes, etc.) in the currently active file. */
+    currentFileSymbols?: string;
+}
+export interface AgentLoopOptions {
+    workDir: string;
+    abortSignal?: {
+        aborted: boolean;
+    };
+    onText: (t: string) => void;
+    onThinking?: (text: string) => void;
+    onThinkingDelta?: (text: string) => void;
+    onThinkingProgress?: (tokens: number) => void;
+    onToolUse: (name: string, input: Record<string, unknown>, isSubTask?: boolean) => void;
+    onToolResult: (name: string, result: ToolResult, isSubTask?: boolean) => void;
+    onUsage: (u: UsageInfo) => void;
+    model?: 'turbo' | 'pro' | 'ultra';
+    mode?: string;
+    effort?: string;
+    requestPermission: (req: PermissionRequest) => Promise<boolean>;
+    env?: EnvContext;
+    editorContext?: EditorContext | null;
+    nexrallMd?: string;
+    /** Client type — controls which tools Claude is told about. */
+    clientType?: string;
+    /**
+     * Optional executor for platform-specific tools (e.g. VS Code semantic tools).
+     * Return null to fall through to the default executor.
+     */
+    executeExternalTool?: (name: string, input: Record<string, unknown>) => Promise<ToolResult | null>;
+    /** MCP manager — provides extra tool definitions + executes MCP tool calls. */
+    mcpManager?: import('./mcp/manager').McpManager;
+    /** Checkpoint manager — snapshots files before mutations so the user can /rewind. */
+    checkpointManager?: import('./checkpoint/manager').CheckpointManager;
+    /**
+     * Drain follow-up messages the user queued WHILE the agent was working (Claude-Code
+     * style). Called at turn boundaries inside the loop; returned strings are folded into
+     * the conversation so the agent picks them up at the next step — mid-task, without
+     * waiting for the whole turn to finish. Return [] when nothing is queued.
+     */
+    takePendingInput?: () => string[];
+    /** Notify that a queued follow-up was injected into the conversation (for UI echo/logging). */
+    onInjectedInput?: (text: string) => void;
+    /**
+     * Max agent iterations (model response + tool round) before the runaway-loop
+     * backstop trips. Overrides the NEXRALL_MAX_ITERATIONS env var and the
+     * `maxIterations` setting in .nexrall/settings.json. Defaults to 500 (capped
+     * at 1000). Not a task-size budget — large tasks legitimately need many rounds.
+     */
+    maxIterations?: number;
+    /**
+     * When the soft `maxIterations` budget runs out with work still pending, keep
+     * going (extend the budget in segments up to an absolute 2000-step ceiling)
+     * instead of stopping, so long tasks finish without the user typing "continue".
+     * A stall guard stops it if consecutive tool rounds all fail. Overrides the
+     * NEXRALL_AUTO_CONTINUE env var and `autoContinue` in .nexrall/settings.json.
+     * Defaults to true.
+     */
+    autoContinue?: boolean;
+    /**
+     * Automatically summarise older conversation history when the prompt exceeds
+     * ~80% of the model's context window, so long sessions never hit the wall.
+     * Overrides NEXRALL_AUTO_COMPACT env var and `autoCompact` in settings.json.
+     * Defaults to true.
+     */
+    autoCompact?: boolean;
+    /** Internal: recursion depth for sub-agents. Main agent = 0. */
+    _depth?: number;
+    /**
+     * Internal: isolation key for per-agent tool state (todo lists). The main
+     * agent uses 'root'; each sub-agent gets a unique key so concurrent
+     * sub-agents don't clobber each other's todo lists.
+     */
+    _agentScope?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ─── Content Blocks ───────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map