@zelari/core 0.7.9

package/dist/core/tools/builtin/filesystem.js.map

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

package/dist/core/tools/builtin/listFiles.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { type ToolDefinition } from '../toolTypes.js';
+import { type FileEntry } from './_walk.js';
+declare const ListFilesArgsSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    maxDepth: z.ZodDefault<z.ZodNumber>;
+    exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type ListFilesArgs = z.infer<typeof ListFilesArgsSchema>;
+interface ListFilesResult {
+    /** The directory that was listed (absolute). */
+    dir: string;
+    entries: FileEntry[];
+    truncated: boolean;
+}
+export declare const listFilesTool: ToolDefinition<ListFilesArgs, ListFilesResult>;
+export {};
+//# sourceMappingURL=listFiles.d.ts.map

package/dist/core/tools/builtin/listFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listFiles.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/builtin/listFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB,QAAA,MAAM,mBAAmB;;;;iBAOvB,CAAC;AAEH,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzD,UAAU,eAAe;IACvB,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,aAAa,EAAE,eAAe,CAgCxE,CAAC"}

package/dist/core/tools/builtin/listFiles.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import path from 'node:path';
+import { typedOk, typedErr } from '../toolTypes.js';
+import { walk, DEFAULT_EXCLUDES, } from './_walk.js';
+const ListFilesArgsSchema = z.object({
+    /** Directory to list (relative to cwd or absolute). Defaults to cwd. */
+    path: z.string().optional(),
+    /** Max traversal depth. 1 = immediate children only (default). */
+    maxDepth: z.number().int().positive().max(10).default(1),
+    /** Glob-style patterns to exclude (matched against each entry name). */
+    exclude: z.array(z.string()).default(DEFAULT_EXCLUDES),
+});
+export const listFilesTool = {
+    name: 'list_files',
+    description: 'List files and directories in the given path (defaults to the working directory). ' +
+        'Returns names with types (file/directory). Use this to discover the project structure ' +
+        'before reading specific files. Supports a maxDepth for recursive listing and excludes ' +
+        'common dependency/build directories by default.',
+    permissions: ['read'],
+    timeoutMs: 15000,
+    inputSchema: ListFilesArgsSchema,
+    execute: async (args, ctx) => {
+        try {
+            const target = args.path
+                ? (path.isAbsolute(args.path) ? args.path : path.join(ctx.cwd, args.path))
+                : ctx.cwd;
+            const entries = [];
+            // API: maxDepth=1 means "root only". Internally: depth=0 at root,
+            // so we subtract 1 from the user-facing maxDepth.
+            await walk(target, '', 0, args.maxDepth - 1, args.exclude, entries, ctx.signal);
+            // Sort: directories first, then files, alphabetically.
+            entries.sort((a, b) => {
+                if (a.type === 'directory' && b.type !== 'directory')
+                    return -1;
+                if (a.type !== 'directory' && b.type === 'directory')
+                    return 1;
+                return a.name.localeCompare(b.name);
+            });
+            const MAX_ENTRIES = 500;
+            const truncated = entries.length > MAX_ENTRIES;
+            return typedOk({ dir: target, entries: truncated ? entries.slice(0, MAX_ENTRIES) : entries, truncated });
+        }
+        catch (err) {
+            return typedErr(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+//# sourceMappingURL=listFiles.js.map

package/dist/core/tools/builtin/listFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listFiles.js","sourceRoot":"","sources":["../../../../src/core/tools/builtin/listFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAuB,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,IAAI,EACJ,gBAAgB,GAEjB,MAAM,YAAY,CAAC;AAEpB,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,wEAAwE;IACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,kEAAkE;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,wEAAwE;IACxE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;CACvD,CAAC,CAAC;AAWH,MAAM,CAAC,MAAM,aAAa,GAAmD;IAC3E,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,oFAAoF;QACpF,wFAAwF;QACxF,wFAAwF;QACxF,iDAAiD;IACnD,WAAW,EAAE,CAAC,MAAM,CAAC;IACrB,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,mBAAmB;IAChC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI;gBACtB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1E,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;YACZ,MAAM,OAAO,GAAgB,EAAE,CAAC;YAChC,kEAAkE;YAClE,kDAAkD;YAClD,MAAM,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAChF,uDAAuD;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACpB,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;oBAAE,OAAO,CAAC,CAAC,CAAC;gBAChE,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;oBAAE,OAAO,CAAC,CAAC;gBAC/D,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;YACH,MAAM,WAAW,GAAG,GAAG,CAAC;YACxB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC;YAC/C,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3G,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/core/tools/builtin/search.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { type ToolDefinition } from '../toolTypes.js';
+/**
+ * grep_content — Regex search across one file OR a directory tree.
+ *
+ * Two modes:
+ *   1. Single-file: `path` is a regular file → search it.
+ *   2. Recursive: `path` is a directory → walk it (respecting `include` /
+ *      `exclude` globs and `maxDepth`) and search each matched file.
+ *
+ * Backward-compatible: existing callers passing a single-file `path`
+ * keep the v0.3.x behavior unchanged.
+ *
+ * Glob syntax: `*`, `?`, `[abc]`, `**` (recursive). See _walk.ts.
+ */
+declare const GrepContentArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+    pattern: z.ZodString;
+    contextLines: z.ZodDefault<z.ZodNumber>;
+    maxMatches: z.ZodDefault<z.ZodNumber>;
+    include: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    maxDepth: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export { GrepContentArgsSchema };
+type GrepContentArgs = z.infer<typeof GrepContentArgsSchema>;
+interface GrepMatch {
+    /** File path (absolute). */
+    file: string;
+    /** Relative path (vs the searched directory or single file). */
+    relPath: string;
+    line: number;
+    text: string;
+    context: {
+        before: string[];
+        after: string[];
+    };
+}
+interface GrepResult {
+    matches: GrepMatch[];
+    totalMatches: number;
+    truncated: boolean;
+    /** Number of files actually searched (1 for single-file mode). */
+    filesSearched: number;
+    /** Total files in tree (for recursive mode; 1 for single-file). */
+    filesInTree: number;
+}
+export declare const grepContentTool: ToolDefinition<GrepContentArgs, GrepResult>;
+//# sourceMappingURL=search.d.ts.map

package/dist/core/tools/builtin/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/builtin/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQzE;;;;;;;;;;;;GAYG;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;iBAqBzB,CAAC;AAEH,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,UAAU,SAAS;IACjB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAChD;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAqDD,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,eAAe,EAAE,UAAU,CAoEvE,CAAC"}

package/dist/core/tools/builtin/search.js

@@ -0,0 +1,148 @@
+import { z } from 'zod';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { typedOk, typedErr } from '../toolTypes.js';
+import { walk, filterByInclude, DEFAULT_EXCLUDES, } from './_walk.js';
+/**
+ * grep_content — Regex search across one file OR a directory tree.
+ *
+ * Two modes:
+ *   1. Single-file: `path` is a regular file → search it.
+ *   2. Recursive: `path` is a directory → walk it (respecting `include` /
+ *      `exclude` globs and `maxDepth`) and search each matched file.
+ *
+ * Backward-compatible: existing callers passing a single-file `path`
+ * keep the v0.3.x behavior unchanged.
+ *
+ * Glob syntax: `*`, `?`, `[abc]`, `**` (recursive). See _walk.ts.
+ */
+const GrepContentArgsSchema = z.object({
+    /** File OR directory to search (relative to cwd or absolute). */
+    path: z.string().min(1),
+    /** Regex pattern (no flags — gm is hardcoded). */
+    pattern: z.string().min(1),
+    /** Context lines before/after each match. */
+    contextLines: z.number().int().nonnegative().default(2),
+    /** Max matches returned (total matches still counted). */
+    maxMatches: z.number().int().positive().max(1000).default(50),
+    /**
+     * Glob patterns to INCLUDE when path is a directory (e.g. ['*.ts', '*.tsx']).
+     * Default ['*'] = all files. Ignored when path is a file.
+     */
+    include: z.array(z.string()).default(['*']),
+    /**
+     * Glob patterns to EXCLUDE when path is a directory (e.g. ['*.test.ts']).
+     * Defaults to common noise dirs. Ignored when path is a file.
+     */
+    exclude: z.array(z.string()).default(DEFAULT_EXCLUDES),
+    /** Max recursion depth when path is a directory (default 8). */
+    maxDepth: z.number().int().positive().max(15).default(8),
+});
+export { GrepContentArgsSchema };
+async function searchFile(absPath, relPath, regex, contextLines, remainingSlots) {
+    let buf;
+    try {
+        buf = await fs.readFile(absPath, 'utf-8');
+    }
+    catch {
+        return { matches: [], total: 0, truncated: false }; // unreadable file → skip
+    }
+    const lines = buf.split('\n');
+    const matches = [];
+    let total = 0;
+    let truncated = false;
+    for (let i = 0; i < lines.length; i++) {
+        regex.lastIndex = 0;
+        if (regex.test(lines[i])) {
+            total++;
+            if (matches.length < remainingSlots) {
+                const startBefore = Math.max(0, i - contextLines);
+                const endAfter = Math.min(lines.length - 1, i + contextLines);
+                matches.push({
+                    file: absPath,
+                    relPath,
+                    line: i + 1,
+                    text: lines[i],
+                    context: {
+                        before: lines.slice(startBefore, i),
+                        after: lines.slice(i + 1, endAfter + 1),
+                    },
+                });
+            }
+            else {
+                truncated = true;
+            }
+        }
+    }
+    return { matches, total, truncated };
+}
+async function isDirectory(p) {
+    try {
+        const stat = await fs.stat(p);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export const grepContentTool = {
+    name: 'grep_content',
+    description: 'Regex search for content in a file OR recursively in a directory. ' +
+        'When path is a directory, include/exclude globs filter which files are searched ' +
+        '(default: all files, excluding node_modules/dist/.git/etc.). Returns matches with ' +
+        'line numbers and surrounding context. Single-file mode preserves v0.3.x behavior.',
+    permissions: ['read'],
+    timeoutMs: 30000,
+    inputSchema: GrepContentArgsSchema,
+    execute: async (args, ctx) => {
+        try {
+            const absRoot = path.isAbsolute(args.path) ? args.path : path.join(ctx.cwd, args.path);
+            const regex = new RegExp(args.pattern, 'gm');
+            // ── Single-file mode ────────────────────────────────────────
+            if (!(await isDirectory(absRoot))) {
+                const single = await searchFile(absRoot, args.path, regex, args.contextLines, args.maxMatches);
+                return typedOk({
+                    matches: single.matches,
+                    totalMatches: single.total,
+                    truncated: single.truncated,
+                    filesSearched: 1,
+                    filesInTree: 1,
+                });
+            }
+            // ── Recursive (directory) mode ──────────────────────────────
+            const allEntries = [];
+            await walk(absRoot, '', 0, args.maxDepth, args.exclude, allEntries, ctx.signal);
+            const matchedFiles = filterByInclude(allEntries, args.include);
+            const allMatches = [];
+            let totalMatches = 0;
+            let truncated = false;
+            let filesSearched = 0;
+            for (const entry of matchedFiles) {
+                if (ctx.signal?.aborted)
+                    break;
+                if (allMatches.length >= args.maxMatches) {
+                    truncated = true;
+                    break;
+                }
+                const absFile = path.join(absRoot, entry.name);
+                const result = await searchFile(absFile, entry.name, regex, args.contextLines, args.maxMatches - allMatches.length);
+                filesSearched++;
+                totalMatches += result.total;
+                if (result.truncated)
+                    truncated = true;
+                allMatches.push(...result.matches);
+            }
+            return typedOk({
+                matches: allMatches,
+                totalMatches,
+                truncated,
+                filesSearched,
+                filesInTree: matchedFiles.length,
+            });
+        }
+        catch (err) {
+            return typedErr(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+//# sourceMappingURL=search.js.map

package/dist/core/tools/builtin/search.js.map

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

package/dist/core/tools/builtin/shell.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { type ToolDefinition } from '../toolTypes.js';
+declare const BashArgsSchema: z.ZodObject<{
+    command: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type BashArgs = z.infer<typeof BashArgsSchema>;
+interface BashResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    durationMs: number;
+    /** Which shell executed the command (v0.7.2), e.g. "bash (D:\\Git\\bin\\bash.exe)" or "cmd.exe". */
+    shellVia: string;
+    /**
+     * Actionable hint injected when the output matches an interactive-prompt
+     * cancellation (v0.7.3). Scaffolders built on prompts/@clack print
+     * "Operation cancelled" and often exit 0, so the model sees a "success"
+     * that did nothing and retries variants of the same command forever
+     * (live test 2026-07-02: 6× `npm create vite` in a non-empty dir).
+     */
+    hint?: string;
+}
+export declare const bashTool: ToolDefinition<BashArgs, BashResult>;
+export {};
+//# sourceMappingURL=shell.d.ts.map

package/dist/core/tools/builtin/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/builtin/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGzE,QAAA,MAAM,cAAc;;;;iBAIlB,CAAC;AAEH,KAAK,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE/C,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAYD,eAAO,MAAM,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,UAAU,CAoFzD,CAAC"}

package/dist/core/tools/builtin/shell.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { spawn } from 'node:child_process';
+import { typedOk, typedErr } from '../toolTypes.js';
+import { resolveShell } from './shellResolver.js';
+const BashArgsSchema = z.object({
+    command: z.string().min(1),
+    cwd: z.string().optional(),
+    timeoutMs: z.number().int().positive().max(600_000).default(30_000),
+});
+/** Output signatures of an interactive prompt dying on our closed stdin. */
+const INTERACTIVE_CANCEL_RE = /operation cancell?ed|stdin is not a tty|the input device is not a tty/i;
+const INTERACTIVE_HINT = 'This command tried to PROMPT for input, but stdin is closed (non-interactive shell). ' +
+    'Do NOT retry it — every variant will be cancelled the same way. Instead: ' +
+    'scaffold into a fresh EMPTY subdirectory (e.g. `npm create vite@latest scaffold-tmp -- --template react-ts`, ' +
+    'then move its contents here with `mv`/`cp`), or write package.json, configs and sources directly ' +
+    'with write_file and then run `npm install`.';
+export const bashTool = {
+    name: 'bash',
+    description: 'Run a shell command. On Windows uses Git Bash when available (POSIX semantics: ls, $VAR, && work); falls back to cmd.exe otherwise. Streams stdout/stderr. Respects timeout and cancellation. Returns exit code. ' +
+        'stdin is CLOSED (non-interactive): any command that prompts for input will fail or be cancelled — always pass non-interactive flags (--yes, -y, --template), and if a scaffolder insists on prompting (e.g. create-vite in a non-empty directory), create the files manually with write_file instead.',
+    permissions: ['execute'],
+    timeoutMs: 60000,
+    inputSchema: BashArgsSchema,
+    execute: async (args, ctx) => {
+        return new Promise((resolve) => {
+            const start = Date.now();
+            const cwd = args.cwd ?? ctx.cwd;
+            const resolved = resolveShell();
+            // win32 + real bash: spawn the binary directly with `-c` and shell:false
+            // so there is no cmd.exe indirection (npm, &&, $VAR, ls all work because
+            // Git Bash's PATH resolves shims and `-c` runs a true POSIX string).
+            // POSIX / fallback: keep the historical `shell: true` (Node picks /bin/sh
+            // on posix, cmd.exe on win32-fallback — already warned by the resolver).
+            let child;
+            // v0.7.3: CI=1 pushes well-behaved CLIs (npm, scaffolders, test runners)
+            // into non-interactive mode; stdin 'ignore' makes the rest fail FAST
+            // with EOF instead of hanging on a prompt until the timeout (live test:
+            // `npm create vite` in a non-empty dir prompted → "Operation cancelled").
+            const baseEnv = { ...process.env, CI: process.env.CI ?? '1' };
+            const env = resolved.isBash
+                ? { ...baseEnv, MSYSTEM: process.env.MSYSTEM ?? 'MINGW64' }
+                : baseEnv;
+            if (resolved.isBash) {
+                child = spawn(resolved.shell, ['-c', args.command], {
+                    cwd,
+                    signal: ctx.signal,
+                    shell: false,
+                    env,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+            }
+            else {
+                child = spawn(args.command, {
+                    shell: resolved.shell,
+                    cwd,
+                    signal: ctx.signal,
+                    env,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+            }
+            let stdout = '';
+            let stderr = '';
+            const maxBuffer = 1024 * 1024; // 1MB cap on each stream
+            child.stdout?.on('data', (data) => {
+                if (stdout.length < maxBuffer)
+                    stdout += data.toString('utf-8');
+            });
+            child.stderr?.on('data', (data) => {
+                if (stderr.length < maxBuffer)
+                    stderr += data.toString('utf-8');
+            });
+            const timer = setTimeout(() => {
+                child.kill('SIGTERM');
+                resolve(typedErr(`Bash command timed out after ${args.timeoutMs}ms. ` +
+                    'If it was waiting for interactive input: stdin is closed — pass non-interactive flags or create the files directly instead of retrying.'));
+            }, args.timeoutMs);
+            child.on('close', (code) => {
+                clearTimeout(timer);
+                const cappedStdout = stdout.slice(0, maxBuffer);
+                const cappedStderr = stderr.slice(0, maxBuffer);
+                const interactive = INTERACTIVE_CANCEL_RE.test(cappedStdout) || INTERACTIVE_CANCEL_RE.test(cappedStderr);
+                resolve(typedOk({
+                    stdout: cappedStdout,
+                    stderr: cappedStderr,
+                    exitCode: code ?? -1,
+                    durationMs: Date.now() - start,
+                    shellVia: resolved.via,
+                    ...(interactive ? { hint: INTERACTIVE_HINT } : {}),
+                }));
+            });
+            child.on('error', (err) => {
+                clearTimeout(timer);
+                resolve(typedErr(err.message));
+            });
+        });
+    },
+};
+//# sourceMappingURL=shell.js.map

package/dist/core/tools/builtin/shell.js.map

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

package/dist/core/tools/builtin/shellResolver.d.ts

@@ -0,0 +1,25 @@
+export interface ResolvedShell {
+    /**
+     * The value to pass to `spawn`'s `shell` option, OR a bash binary path to
+     * spawn directly via `spawn(path, ['-c', cmd], { shell: false })`.
+     *
+     * - When `isBash` is true, `shell` is an absolute path string; spawn it
+     *   directly with `-c`.
+     * - When `isBash` is false, `shell` is `true` (let Node pick cmd.exe on
+     *   win32, /bin/sh on POSIX).
+     */
+    shell: string | true;
+    /** Human-readable label for logs / the model, e.g. "bash (D:\\Git\\bin\\bash.exe)". */
+    via: string;
+    /** True when `shell` is a real bash binary (spawn via `-c`, POSIX semantics). */
+    isBash: boolean;
+}
+/**
+ * Resolve the shell to use for command execution. Memoized per-process.
+ *
+ * @param forceReResolve bypass the memo (for tests).
+ */
+export declare function resolveShell(forceReResolve?: boolean): ResolvedShell;
+/** Test-only: reset memo + warning flag. */
+export declare function _resetShellResolverForTests(): void;
+//# sourceMappingURL=shellResolver.d.ts.map

package/dist/core/tools/builtin/shellResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellResolver.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/builtin/shellResolver.ts"],"names":[],"mappings":"AAgCA,MAAM,WAAW,aAAa;IAC5B;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,MAAM,EAAE,OAAO,CAAC;CACjB;AAaD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,cAAc,UAAQ,GAAG,aAAa,CA4BlE;AA6CD,4CAA4C;AAC5C,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/dist/core/tools/builtin/shellResolver.js

@@ -0,0 +1,117 @@
+/**
+ * shellResolver — v0.7.2 cross-platform shell selection for the `bash` tool.
+ *
+ * Problem: `spawn(cmd, { shell: true })` on win32 uses cmd.exe (via ComSpec),
+ * which breaks npm (needs `npm.cmd`), mis-handles `&&` / quoting, and doesn't
+ * understand POSIX commands (`ls`, `which`, `$VAR`). The tool is named `bash`
+ * but historically ran cmd.exe on Windows — a misleading and broken state.
+ *
+ * Resolution: when Git Bash / MSYS2 bash is available, spawn it directly via
+ * `spawn(bashPath, ['-c', cmd], { shell: false })` so real POSIX semantics
+ * apply. Detection order (most reliable first):
+ *
+ *   1. `ZELARI_SHELL` env var — explicit user override (the knob that was
+ *      missing; lets users point at any shell they want).
+ *   2. `SHELL` env var on win32 — set automatically by Git Bash / MSYS2
+ *      sessions (e.g. `D:\Git\bin\bash.exe`). The most reliable automatic
+ *      signal when the CLI is launched from Git Bash.
+ *   3. Standard Git for Windows install paths (probed with existsSync).
+ *   4. `where bash` — last-ditch PATH lookup.
+ *   5. Fallback: cmd.exe (`shell: true`) with a one-time stderr warning so
+ *      the user knows POSIX commands may fail and can install Git for Windows
+ *      or set ZELARI_SHELL.
+ *
+ * On POSIX the resolver is a no-op: `shell: true` already means /bin/sh,
+ * which is bash-compatible enough.
+ *
+ * Idempotent: the resolved shell is memoized per-process. The warning is
+ * emitted at most once per process (guarded by a module-level flag).
+ */
+import { existsSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+/** Standard Git for Windows bash locations (probed in order). */
+const STANDARD_BASH_PATHS = [
+    'C:\\Program Files\\Git\\bin\\bash.exe',
+    'C:\\Program Files\\Git\\usr\\bin\\bash.exe',
+    'C:\\Program Files (x86)\\Git\\bin\\bash.exe',
+    'C:\\Program Files (x86)\\Git\\usr\\bin\\bash.exe',
+];
+let memoized = null;
+let warnedFallback = false;
+/**
+ * Resolve the shell to use for command execution. Memoized per-process.
+ *
+ * @param forceReResolve bypass the memo (for tests).
+ */
+export function resolveShell(forceReResolve = false) {
+    if (memoized && !forceReResolve)
+        return memoized;
+    // POSIX: Node's `shell: true` already uses /bin/sh — no work needed.
+    if (process.platform !== 'win32') {
+        memoized = { shell: true, via: '/bin/sh', isBash: false };
+        return memoized;
+    }
+    // win32: try to find a real bash.
+    const found = resolveBashWindows();
+    if (found) {
+        memoized = { shell: found, via: `bash (${found})`, isBash: true };
+        return memoized;
+    }
+    // Fallback: cmd.exe. Warn once so the user knows POSIX commands may fail.
+    if (!warnedFallback) {
+        warnedFallback = true;
+        // eslint-disable-next-line no-console
+        console.error('[zelari-code] bash tool: Git Bash not found — falling back to cmd.exe. ' +
+            'POSIX commands (ls, which, $VAR, &&) may fail. Install Git for Windows ' +
+            'or set ZELARI_SHELL to your bash binary for proper POSIX support.');
+    }
+    memoized = { shell: true, via: 'cmd.exe', isBash: false };
+    return memoized;
+}
+/** Detection chain for a bash binary on win32. Returns the path or null. */
+function resolveBashWindows() {
+    // 1. Explicit override.
+    const envShell = process.env.ZELARI_SHELL;
+    if (envShell && envShell.trim().length > 0 && existsSyncSafe(envShell)) {
+        return envShell;
+    }
+    // 2. SHELL env var (set by Git Bash / MSYS2 sessions).
+    const sessionShell = process.env.SHELL;
+    if (sessionShell && sessionShell.trim().length > 0 && existsSyncSafe(sessionShell)) {
+        return sessionShell;
+    }
+    // 3. Standard install paths.
+    for (const p of STANDARD_BASH_PATHS) {
+        if (existsSyncSafe(p))
+            return p;
+    }
+    // 4. `where bash` — PATH lookup. `where` ships with Windows (a real .exe,
+    // so no shell needed — and shell:true + args array is deprecated, DEP0190).
+    try {
+        const result = spawnSync('where', ['bash'], { encoding: 'utf-8', windowsHide: true });
+        if (result.status === 0 && result.stdout) {
+            const first = result.stdout.split(/\r?\n/).find((l) => l.trim().length > 0);
+            if (first && existsSyncSafe(first))
+                return first.trim();
+        }
+    }
+    catch {
+        // `where` not available or failed — fall through to null.
+    }
+    return null;
+}
+/** existsSync that swallows edge-case errors (e.g. invalid chars on win32). */
+function existsSyncSafe(p) {
+    try {
+        return existsSync(p);
+    }
+    catch {
+        return false;
+    }
+}
+/** Test-only: reset memo + warning flag. */
+export function _resetShellResolverForTests() {
+    memoized = null;
+    warnedFallback = false;
+}
+//# sourceMappingURL=shellResolver.js.map

package/dist/core/tools/builtin/shellResolver.js.map

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

package/dist/core/tools/builtin/web.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { type ToolDefinition } from '../toolTypes.js';
+/**
+ * Reduce an HTML document to readable text: drop script/style/head noise,
+ * convert tags to whitespace, decode the handful of entities that matter.
+ * Deliberately dependency-free — good enough for LLM consumption, not for
+ * rendering.
+ */
+export declare function htmlToText(html: string): string;
+declare const FetchUrlArgsSchema: z.ZodObject<{
+    url: z.ZodString;
+    maxChars: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type FetchUrlArgs = z.infer<typeof FetchUrlArgsSchema>;
+export interface FetchUrlResult {
+    url: string;
+    status: number;
+    contentType: string;
+    /** Extracted text (HTML stripped) or raw body for non-HTML text types. */
+    text: string;
+    truncated: boolean;
+}
+export declare const fetchUrlTool: ToolDefinition<FetchUrlArgs, FetchUrlResult>;
+declare const WebSearchArgsSchema: z.ZodObject<{
+    query: z.ZodString;
+    maxResults: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type WebSearchArgs = z.infer<typeof WebSearchArgsSchema>;
+export interface WebSearchHit {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export interface WebSearchResult {
+    provider: 'tavily' | 'duckduckgo';
+    query: string;
+    results: WebSearchHit[];
+}
+/** Parse the DuckDuckGo HTML SERP (html.duckduckgo.com) into hits. */
+export declare function parseDuckDuckGoHtml(html: string, maxResults: number): WebSearchHit[];
+export declare const webSearchTool: ToolDefinition<WebSearchArgs, WebSearchResult>;
+export {};
+//# sourceMappingURL=web.d.ts.map