@zelari/core 0.7.9

package/dist/core/providerStream.d.ts

@@ -0,0 +1,61 @@
+import type { AgentMessage, AgentToolSpec, ProviderStreamFn } from './AgentHarness.js';
+/**
+ * Adapter that wraps a legacy LlmChatParams-based streaming call
+ * (streamMiniMax / streamGlm / streamGrok / streamCustom in llm.ts)
+ * into the new AgentHarness provider-stream interface.
+ *
+ * The adapter converts SSE chunks into ProviderDelta events:
+ *   text chunks → { kind: 'text', delta }
+ *   finish chunks → { kind: 'finish', reason }
+ *   errors → { kind: 'error', message } (or thrown)
+ */
+export interface LegacyStreamFn {
+    (params: {
+        apiKey: string;
+        model: string;
+        provider: string;
+        messages: {
+            role: string;
+            content: string;
+        }[];
+        tools?: Array<{
+            type: 'function';
+            function: {
+                name: string;
+                description: string;
+                parameters: object;
+            };
+        }>;
+        temperature?: number;
+        stream: true;
+        customBaseUrl?: string;
+        customAuthStyle?: 'openai' | 'anthropic';
+        onChunk: (chunk: string) => void;
+        onRequestId?: (requestId: string) => void;
+        signal?: AbortSignal;
+    }): Promise<{
+        content: string;
+        toolCalls: Array<{
+            id: string;
+            name: string;
+            args: Record<string, unknown>;
+        }>;
+    }>;
+}
+/**
+ * Wrap a legacy stream function into a ProviderStreamFn that yields
+ * provider-neutral deltas. Text chunks are forwarded; finish/end is detected
+ * by the legacy function's resolved result (content length is the sum of deltas).
+ *
+ * NOTE: This adapter does NOT yield tool_call deltas yet — it treats tool calls
+ * as a single 'finish' + tools-in-result pattern. Full tool-call streaming lands
+ * in a later task.
+ */
+export declare function wrapLegacyStream(legacyStream: LegacyStreamFn, params: {
+    apiKey: string;
+    model: string;
+    provider: string;
+    customBaseUrl?: string;
+    customAuthStyle?: 'openai' | 'anthropic';
+}, _messages: AgentMessage[], _tools: AgentToolSpec[]): ProviderStreamFn;
+//# sourceMappingURL=providerStream.d.ts.map

package/dist/core/providerStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerStream.d.ts","sourceRoot":"","sources":["../../src/core/providerStream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAiB,MAAM,mBAAmB,CAAC;AAEtG;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,CAAC,MAAM,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC9C,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,UAAU,CAAC;YAAC,QAAQ,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,WAAW,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;QACzG,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,IAAI,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;QACzC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;QAC1C,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACjH;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CAC1C,EACD,SAAS,EAAE,YAAY,EAAE,EACzB,MAAM,EAAE,aAAa,EAAE,GACtB,gBAAgB,CAyElB"}

package/dist/core/providerStream.js

@@ -0,0 +1,99 @@
+/**
+ * Convert AgentHarness AgentMessage[] → legacy {role, content}[].
+ * Tool messages pass through their content (renderer fills these).
+ */
+function toLegacyMessages(messages) {
+    return messages.map((m) => ({ role: m.role, content: m.content }));
+}
+/**
+ * Convert AgentHarness AgentToolSpec[] → legacy OpenAI-shaped tool descriptors.
+ */
+function toLegacyTools(tools) {
+    return tools.map((t) => ({
+        type: 'function',
+        function: { name: t.name, description: t.description, parameters: t.parameters },
+    }));
+}
+/**
+ * Wrap a legacy stream function into a ProviderStreamFn that yields
+ * provider-neutral deltas. Text chunks are forwarded; finish/end is detected
+ * by the legacy function's resolved result (content length is the sum of deltas).
+ *
+ * NOTE: This adapter does NOT yield tool_call deltas yet — it treats tool calls
+ * as a single 'finish' + tools-in-result pattern. Full tool-call streaming lands
+ * in a later task.
+ */
+export function wrapLegacyStream(legacyStream, params, _messages, _tools) {
+    return async function* (providerParams) {
+        const accumulatedChunks = [];
+        const legacyParams = {
+            apiKey: params.apiKey,
+            model: providerParams.model,
+            provider: providerParams.provider,
+            messages: toLegacyMessages(providerParams.messages),
+            tools: toLegacyTools(providerParams.tools),
+            temperature: 0.7,
+            stream: true,
+            customBaseUrl: params.customBaseUrl,
+            customAuthStyle: params.customAuthStyle,
+            onChunk: (chunk) => {
+                accumulatedChunks.push(chunk);
+            },
+            onRequestId: undefined,
+            signal: providerParams.signal,
+        };
+        // Fire the legacy stream and yield chunks as they arrive.
+        // We can't await the whole result before yielding — we need to yield
+        // chunks incrementally. Use a small async queue.
+        const queue = [];
+        let resolveNext = null;
+        let done = false;
+        let error = null;
+        const promise = legacyStream(legacyParams)
+            .then((result) => {
+            // After legacy stream completes, emit a tool_call event for each tool
+            // it returned (AgentHarness will then schedule tool execution in 12.6).
+            for (const tc of result.toolCalls) {
+                queue.push({ kind: 'tool_call', toolCallId: tc.id, toolName: tc.name, args: tc.args });
+            }
+            queue.push({ kind: 'finish', reason: 'stop' });
+        })
+            .catch((err) => {
+            error = err;
+        })
+            .finally(() => {
+            done = true;
+            if (resolveNext) {
+                resolveNext();
+                resolveNext = null;
+            }
+        });
+        // Pump chunks from accumulatedChunks every microtask
+        let lastEmittedIndex = 0;
+        while (!done || queue.length > 0 || lastEmittedIndex < accumulatedChunks.length) {
+            // Emit any new chunks
+            while (lastEmittedIndex < accumulatedChunks.length) {
+                yield { kind: 'text', delta: accumulatedChunks[lastEmittedIndex] };
+                lastEmittedIndex++;
+            }
+            // Emit any queued deltas
+            while (queue.length > 0) {
+                const d = queue.shift();
+                yield d;
+            }
+            // If error, throw
+            if (error) {
+                throw error;
+            }
+            // If done but nothing left, exit
+            if (done)
+                break;
+            // Wait for next microtask
+            await new Promise((resolve) => {
+                resolveNext = resolve;
+            });
+        }
+        await promise; // Ensure the legacy promise resolves (catches final errors)
+    };
+}
+//# sourceMappingURL=providerStream.js.map

package/dist/core/providerStream.js.map

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

package/dist/core/sessionJsonl.d.ts

@@ -0,0 +1,50 @@
+/**
+ * sessionJsonl — append-only JSONL sidecar writer for a single agent session.
+ *
+ * Every {@link BrainEvent} is appended as one JSON object per line so the raw
+ * session transcript can be inspected with `cat`, `jq`, or any text editor.
+ * Each session gets its own file under `<baseDir>/<sessionId>.jsonl`.
+ *
+ * Pure `node:fs` — zero Electron deps, so this module is browser-importable
+ * for jsdom tests. The main-process caller passes `<userData>/sessions` as
+ * `baseDir`; tests pass a temp dir.
+ *
+ * @see docs/plans/2026-06-28-zelari-code.md (Task 12.3)
+ */
+import type { BrainEvent } from '../shared/events.js';
+export interface SessionJsonlOptions {
+    /** Base directory for session files. Defaults to `<userData>/sessions/`
+     *  in main process; tests can pass a temp dir explicitly. */
+    baseDir?: string;
+    /** Optional logger callback (defaults to console.error). */
+    onError?: (message: string) => void;
+}
+/**
+ * Append-only JSONL writer for a single session.
+ *
+ * One JSON object per line, shape:
+ *   {"ts": <epoch-ms>, "sessionId": "<uuid>", "event": { ...BrainEvent }}
+ *
+ * The writer is line-buffered: every `append()` flushes synchronously
+ * to ensure no events are lost on crash. Uses O_APPEND for atomicity.
+ *
+ * Malformed lines on read are skipped (with a warning) so the file is
+ * always recoverable via `readSession()`.
+ */
+export declare class SessionJsonlWriter {
+    private readonly filePath;
+    private readonly onError;
+    constructor(sessionId: string, options?: SessionJsonlOptions);
+    /** Absolute path to the session JSONL file. */
+    get path(): string;
+    /** Append a BrainEvent as one JSON line. Creates the file + parent dirs if missing. */
+    append(event: BrainEvent): Promise<void>;
+    /** Close the writer (no-op currently, but reserved for future buffered mode). */
+    close(): Promise<void>;
+}
+/**
+ * Read all events from a session JSONL file. Malformed lines are skipped.
+ * Returns an empty array if the file does not exist.
+ */
+export declare function readSession(filePath: string): Promise<BrainEvent[]>;
+//# sourceMappingURL=sessionJsonl.d.ts.map

package/dist/core/sessionJsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionJsonl.d.ts","sourceRoot":"","sources":["../../src/core/sessionJsonl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC;iEAC6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEpC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;IAMhE,+CAA+C;IAC/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uFAAuF;IACjF,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9C,iFAAiF;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAqBzE"}

package/dist/core/sessionJsonl.js

@@ -0,0 +1,99 @@
+/**
+ * sessionJsonl — append-only JSONL sidecar writer for a single agent session.
+ *
+ * Every {@link BrainEvent} is appended as one JSON object per line so the raw
+ * session transcript can be inspected with `cat`, `jq`, or any text editor.
+ * Each session gets its own file under `<baseDir>/<sessionId>.jsonl`.
+ *
+ * Pure `node:fs` — zero Electron deps, so this module is browser-importable
+ * for jsdom tests. The main-process caller passes `<userData>/sessions` as
+ * `baseDir`; tests pass a temp dir.
+ *
+ * @see docs/plans/2026-06-28-zelari-code.md (Task 12.3)
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+/**
+ * Append-only JSONL writer for a single session.
+ *
+ * One JSON object per line, shape:
+ *   {"ts": <epoch-ms>, "sessionId": "<uuid>", "event": { ...BrainEvent }}
+ *
+ * The writer is line-buffered: every `append()` flushes synchronously
+ * to ensure no events are lost on crash. Uses O_APPEND for atomicity.
+ *
+ * Malformed lines on read are skipped (with a warning) so the file is
+ * always recoverable via `readSession()`.
+ */
+export class SessionJsonlWriter {
+    filePath;
+    onError;
+    constructor(sessionId, options = {}) {
+        const baseDir = options.baseDir ?? defaultBaseDir();
+        this.filePath = path.join(baseDir, `${sessionId}.jsonl`);
+        this.onError = options.onError ?? console.error;
+    }
+    /** Absolute path to the session JSONL file. */
+    get path() {
+        return this.filePath;
+    }
+    /** Append a BrainEvent as one JSON line. Creates the file + parent dirs if missing. */
+    async append(event) {
+        try {
+            await fs.mkdir(path.dirname(this.filePath), { recursive: true });
+            const line = JSON.stringify({
+                ts: event.ts,
+                sessionId: event.sessionId,
+                event,
+            }) + '\n';
+            await fs.appendFile(this.filePath, line, { encoding: 'utf-8', mode: 0o644 });
+        }
+        catch (err) {
+            this.onError(`[sessionJsonl] failed to append event to ${this.filePath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** Close the writer (no-op currently, but reserved for future buffered mode). */
+    async close() {
+        // No buffered state to flush yet.
+    }
+}
+/**
+ * Read all events from a session JSONL file. Malformed lines are skipped.
+ * Returns an empty array if the file does not exist.
+ */
+export async function readSession(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const events = [];
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (parsed && typeof parsed === 'object' && 'event' in parsed) {
+                    events.push(parsed.event);
+                }
+            }
+            catch {
+                // Skip malformed lines silently.
+            }
+        }
+        return events;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+}
+/** Default base directory: `<userData>/sessions/` (resolved at runtime via electron.app).
+ *  In test environments, override via `new SessionJsonlWriter(id, { baseDir: '/tmp/test' })`. */
+function defaultBaseDir() {
+    // We can't import 'electron' here (this module is browser-importable for tests).
+    // The caller must pass baseDir explicitly OR we use a sensible fallback.
+    // In main process, the AgentHarness caller will pass `<userData>/sessions`.
+    return path.join(os.tmpdir(), 'zelari-code', 'sessions');
+}
+//# sourceMappingURL=sessionJsonl.js.map

package/dist/core/sessionJsonl.js.map

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

package/dist/core/tools/auditLog.d.ts

@@ -0,0 +1,14 @@
+import type { AuditEntry } from './toolTypes.js';
+/** In-memory audit log (last N entries). Persisting to disk is a follow-up. */
+export declare class AuditLog {
+    private entries;
+    private maxEntries;
+    constructor(maxEntries?: number);
+    record(entry: AuditEntry): void;
+    /** Return the last N entries (most recent last). */
+    recent(n?: number): AuditEntry[];
+    /** Filter by sessionId. */
+    bySession(sessionId: string): AuditEntry[];
+    clear(): void;
+}
+//# sourceMappingURL=auditLog.d.ts.map

package/dist/core/tools/auditLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditLog.d.ts","sourceRoot":"","sources":["../../../src/core/tools/auditLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,+EAA+E;AAC/E,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,SAAO;IAI7B,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAO/B,oDAAoD;IACpD,MAAM,CAAC,CAAC,SAAK,GAAG,UAAU,EAAE;IAI5B,2BAA2B;IAC3B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IAI1C,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/tools/auditLog.js

@@ -0,0 +1,26 @@
+/** In-memory audit log (last N entries). Persisting to disk is a follow-up. */
+export class AuditLog {
+    entries = [];
+    maxEntries;
+    constructor(maxEntries = 1000) {
+        this.maxEntries = maxEntries;
+    }
+    record(entry) {
+        this.entries.push(entry);
+        if (this.entries.length > this.maxEntries) {
+            this.entries.shift();
+        }
+    }
+    /** Return the last N entries (most recent last). */
+    recent(n = 50) {
+        return this.entries.slice(-n);
+    }
+    /** Filter by sessionId. */
+    bySession(sessionId) {
+        return this.entries.filter((e) => e.sessionId === sessionId);
+    }
+    clear() {
+        this.entries = [];
+    }
+}
+//# sourceMappingURL=auditLog.js.map

package/dist/core/tools/auditLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditLog.js","sourceRoot":"","sources":["../../../src/core/tools/auditLog.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,OAAO,QAAQ;IACX,OAAO,GAAiB,EAAE,CAAC;IAC3B,UAAU,CAAS;IAE3B,YAAY,UAAU,GAAG,IAAI;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,KAAiB;QACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,MAAM,CAAC,CAAC,GAAG,EAAE;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,2BAA2B;IAC3B,SAAS,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF"}

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

@@ -0,0 +1,40 @@
+/**
+ * _walk — Shared directory walker used by list_files and grep_content.
+ *
+ * Walks a directory recursively up to {@link maxDepth} and yields
+ * {@link FileEntry} objects (path relative to the walked directory + type).
+ * Honors {@link exclude} glob patterns and skips unreadable subdirectories
+ * silently. Honors {@link signal} for cancellation.
+ *
+ * Glob syntax (intentionally minimal — no external deps):
+ *   - `*`  → any sequence of non-/ characters
+ *   - `?`  → any single non-/ character
+ *   - `[abc]` → char class
+ *   - Everything else is a literal (special regex chars auto-escaped)
+ *
+ * @internal Exported for tests + sibling tools in `builtin/`.
+ */
+export interface FileEntry {
+    /** Path relative to the listed directory. */
+    name: string;
+    /** 'file' | 'directory' | 'other' (symlink, socket, etc.). */
+    type: 'file' | 'directory' | 'other';
+}
+export declare function matchesAny(name: string, patterns: string[]): boolean;
+export declare const DEFAULT_EXCLUDES: string[];
+/**
+ * Walk a directory tree, collecting file/dir entries.
+ * Mutates {@link entries} in place (avoids large array allocations on deep trees).
+ *
+ * Depth semantics: depth=0 means "do NOT descend into subdirectories" (root
+ * entries only). depth=N means "descend at most N levels below root".
+ *
+ * The root directory itself is NOT added as an entry.
+ */
+export declare function walk(dir: string, baseRel: string, depth: number, maxDepth: number, exclude: string[], entries: FileEntry[], signal: AbortSignal | undefined): Promise<void>;
+/**
+ * Filter a flat list of FileEntry to those whose relative path matches at
+ * least one of {@link include} globs (matched against forward-slash paths).
+ */
+export declare function filterByInclude(entries: FileEntry[], include: string[]): FileEntry[];
+//# sourceMappingURL=_walk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_walk.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/builtin/_walk.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;CACtC;AAoDD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAMpE;AAED,eAAO,MAAM,gBAAgB,UAY5B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,SAAS,EAAE,EACpB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CASpF"}

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

@@ -0,0 +1,129 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+const REGEX_ESCAPE = /[.+^${}()|[\]\\]/g;
+function escapeRegex(p) {
+    return p.replace(REGEX_ESCAPE, '\\$&');
+}
+function globToRegex(glob) {
+    // Convert glob pattern to anchored RegExp.
+    // Semantics:
+    //   - `*`        → any chars except `/` (one segment)
+    //   - `**`       → any chars including `/` (zero or more segments)
+    //   - `**/`      → zero or more dirs (must be followed by something or end)
+    //   - `?`        → any single char except `/`
+    //   - `[abc]`    → char class
+    //   - everything else is literal (regex special chars auto-escaped)
+    let re = '';
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i];
+        if (c === '*') {
+            if (glob[i + 1] === '*') {
+                if (glob[i + 2] === '/') {
+                    // **/ → zero or more dirs. Skip both stars AND the slash.
+                    re += '(?:.*/)?';
+                    i += 2; // skip second * AND trailing /
+                }
+                else {
+                    // ** at end (or **<not-slash>) → match anything
+                    re += '.*';
+                    i++; // skip second *
+                }
+            }
+            else {
+                // single * → match within one segment
+                re += '[^/]*';
+            }
+        }
+        else if (c === '?') {
+            re += '[^/]';
+        }
+        else if (c === '[') {
+            const end = glob.indexOf(']', i);
+            if (end === -1) {
+                re += escapeRegex(c);
+            }
+            else {
+                re += glob.slice(i, end + 1);
+                i = end;
+            }
+        }
+        else {
+            re += escapeRegex(c);
+        }
+    }
+    return new RegExp('^' + re + '$');
+}
+export function matchesAny(name, patterns) {
+    for (const p of patterns) {
+        const re = globToRegex(p);
+        if (re.test(name))
+            return true;
+    }
+    return false;
+}
+export const DEFAULT_EXCLUDES = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    '__pycache__',
+    '.cache',
+    '.zelari', // v3-W workspace storage (never inspect)
+    '.venv',
+    'coverage',
+    '.nyc_output',
+];
+/**
+ * Walk a directory tree, collecting file/dir entries.
+ * Mutates {@link entries} in place (avoids large array allocations on deep trees).
+ *
+ * Depth semantics: depth=0 means "do NOT descend into subdirectories" (root
+ * entries only). depth=N means "descend at most N levels below root".
+ *
+ * The root directory itself is NOT added as an entry.
+ */
+export async function walk(dir, baseRel, depth, maxDepth, exclude, entries, signal) {
+    if (depth > maxDepth)
+        return;
+    if (signal?.aborted)
+        return;
+    let dirents;
+    try {
+        dirents = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return; // unreadable subdirectory — skip silently
+    }
+    if (signal?.aborted)
+        return;
+    for (const dirent of dirents) {
+        if (matchesAny(dirent.name, exclude))
+            continue;
+        const rel = baseRel ? `${baseRel}/${dirent.name}` : dirent.name;
+        const isDir = dirent.isDirectory();
+        entries.push({
+            name: rel,
+            type: isDir ? 'directory' : dirent.isFile() ? 'file' : 'other',
+        });
+        if (isDir && depth < maxDepth) {
+            await walk(path.join(dir, dirent.name), rel, depth + 1, maxDepth, exclude, entries, signal);
+        }
+    }
+}
+/**
+ * Filter a flat list of FileEntry to those whose relative path matches at
+ * least one of {@link include} globs (matched against forward-slash paths).
+ */
+export function filterByInclude(entries, include) {
+    if (include.length === 0 || (include.length === 1 && include[0] === '*')) {
+        return entries.filter(e => e.type === 'file');
+    }
+    const regexes = include.map(globToRegex);
+    return entries.filter(e => {
+        if (e.type !== 'file')
+            return false;
+        return regexes.some(re => re.test(e.name));
+    });
+}
+//# sourceMappingURL=_walk.js.map

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

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

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

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { type ToolDefinition } from '../toolTypes.js';
+interface DiffHunkSummary {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    added: number;
+    removed: number;
+}
+declare const ShowDiffArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+    proposedContent: z.ZodString;
+    contextLines: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export { ShowDiffArgsSchema };
+type ShowDiffArgs = z.infer<typeof ShowDiffArgsSchema>;
+interface ShowDiffResult {
+    path: string;
+    diff: string;
+    hunks: DiffHunkSummary[];
+    added: number;
+    removed: number;
+    unchanged: boolean;
+}
+export declare const showDiffTool: ToolDefinition<ShowDiffArgs, ShowDiffResult>;
+declare const ApplyDiffArgsSchema: z.ZodObject<{
+    path: z.ZodString;
+    diff: z.ZodString;
+    fuzzyMatch: z.ZodDefault<z.ZodBoolean>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export { ApplyDiffArgsSchema };
+type ApplyDiffArgs = z.infer<typeof ApplyDiffArgsSchema>;
+interface ApplyDiffResult {
+    path: string;
+    applied: boolean;
+    hunksApplied: number;
+    hunksSkipped: number;
+    finalContent: string;
+    dryRun: boolean;
+    reason?: string;
+}
+export declare const applyDiffTool: ToolDefinition<ApplyDiffArgs, ApplyDiffResult>;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/builtin/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAuBzE,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AA0QD,QAAA,MAAM,kBAAkB;;;;iBAItB,CAAC;AAEH,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEvD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,YAAY,EAAE,cAAc,CAwGrE,CAAC;AAMF,QAAA,MAAM,mBAAmB;;;;;iBAKvB,CAAC;AAEH,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,aAAa,EAAE,eAAe,CAsDxE,CAAC"}