@zelari/core 0.7.9

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/builtin/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAyDzE;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB/C;AAID,QAAA,MAAM,kBAAkB;;;iBAKtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,YAAY,EAAE,cAAc,CAoCrE,CAAC;AAIF,QAAA,MAAM,mBAAmB;;;iBAKvB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CA8BpF;AA0CD,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,aAAa,EAAE,eAAe,CA6BxE,CAAC"}

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

@@ -0,0 +1,208 @@
+import { z } from 'zod';
+import { typedOk, typedErr } from '../toolTypes.js';
+/**
+ * web.ts — network tools: fetch_url + web_search (v0.7.5).
+ *
+ * Fills the CLI's biggest functional gap vs peer agents (opencode's
+ * webfetch/websearch, Hermes' web_search): until now the only network
+ * access was `bash` + curl, which is fragile on Windows and blocked by
+ * the non-interactive shell constraints.
+ *
+ * Design constraints:
+ *  - http(s) only; other schemes rejected before any I/O.
+ *  - Hard timeout via AbortController (default 15s) — a hung host must
+ *    not stall the whole agent turn.
+ *  - Output truncated (default 40k chars) — a 5MB page must not blow the
+ *    prompt budget.
+ *  - `web_search` needs no API key by default (DuckDuckGo HTML endpoint);
+ *    set TAVILY_API_KEY to switch to Tavily's JSON API for better results.
+ */
+const FETCH_TIMEOUT_MS = 15_000;
+const MAX_CHARS_DEFAULT = 40_000;
+const USER_AGENT = 'zelari-code (+https://github.com/N-THEM-Studio/zelari-code)';
+/** Reject anything that is not plain http/https BEFORE any network I/O. */
+function assertHttpUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new Error(`Invalid URL: ${raw}`);
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new Error(`Only http(s) URLs are allowed, got: ${url.protocol}//`);
+    }
+    return url;
+}
+/** Fetch with an AbortController timeout, propagating the tool ctx signal. */
+async function fetchWithTimeout(url, init, outerSignal, timeoutMs) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(new Error(`timeout after ${timeoutMs}ms`)), timeoutMs);
+    const onOuterAbort = () => ctrl.abort(outerSignal?.reason);
+    outerSignal?.addEventListener('abort', onOuterAbort, { once: true });
+    try {
+        return await fetch(url, { ...init, signal: ctrl.signal });
+    }
+    finally {
+        clearTimeout(timer);
+        outerSignal?.removeEventListener('abort', onOuterAbort);
+    }
+}
+/**
+ * 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 function htmlToText(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+        .replace(/<head[\s\S]*?<\/head>/gi, ' ')
+        .replace(/<!--[\s\S]*?-->/g, ' ')
+        .replace(/<br\s*\/?>(\s*)/gi, '\n')
+        .replace(/<\/(p|div|li|h[1-6]|tr|section|article)>/gi, '\n')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;|&apos;/g, "'")
+        .replace(/[ \t]+/g, ' ')
+        .replace(/\n\s*\n\s*\n+/g, '\n\n')
+        .trim();
+}
+// ── fetch_url ─────────────────────────────────────────────────────────
+const FetchUrlArgsSchema = z.object({
+    /** The http(s) URL to fetch. */
+    url: z.string().min(1),
+    /** Max characters of extracted text returned (default 40000). */
+    maxChars: z.number().int().positive().max(200_000).default(MAX_CHARS_DEFAULT),
+});
+export const fetchUrlTool = {
+    name: 'fetch_url',
+    description: 'Fetch an http(s) URL and return its readable text content (HTML is stripped to text). ' +
+        'Use for documentation pages, READMEs, API references, raw files. Not for binary content.',
+    permissions: ['network'],
+    inputSchema: FetchUrlArgsSchema,
+    timeoutMs: FETCH_TIMEOUT_MS + 5_000,
+    execute: async (args, ctx) => {
+        try {
+            const url = assertHttpUrl(args.url);
+            const res = await fetchWithTimeout(url.toString(), { headers: { 'user-agent': USER_AGENT, accept: 'text/html,text/plain,application/json,*/*' }, redirect: 'follow' }, ctx.signal, FETCH_TIMEOUT_MS);
+            const contentType = res.headers.get('content-type') ?? '';
+            if (/image|video|audio|octet-stream|zip|pdf/i.test(contentType)) {
+                return typedErr(`fetch_url: unsupported content-type "${contentType}" (binary). Only text content is supported.`);
+            }
+            const raw = await res.text();
+            const isHtml = /html/i.test(contentType) || /^\s*<(!doctype|html)/i.test(raw);
+            const text = isHtml ? htmlToText(raw) : raw;
+            const truncated = text.length > args.maxChars;
+            return typedOk({
+                url: res.url || url.toString(),
+                status: res.status,
+                contentType,
+                text: truncated ? text.slice(0, args.maxChars) + '\n…[truncated]' : text,
+                truncated,
+            });
+        }
+        catch (err) {
+            return typedErr(`fetch_url failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    },
+};
+// ── web_search ────────────────────────────────────────────────────────
+const WebSearchArgsSchema = z.object({
+    /** Search query. */
+    query: z.string().min(2),
+    /** Max results (default 5). */
+    maxResults: z.number().int().positive().max(10).default(5),
+});
+/** Parse the DuckDuckGo HTML SERP (html.duckduckgo.com) into hits. */
+export function parseDuckDuckGoHtml(html, maxResults) {
+    const hits = [];
+    // Each organic result renders as <a class="result__a" href="…">title</a>
+    // … <a class="result__snippet" …>snippet</a>. Attribute order is stable
+    // on the html.duckduckgo.com endpoint.
+    const linkRe = /<a[^>]*class="[^"]*result__a[^"]*"[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippetRe = /<a[^>]*class="[^"]*result__snippet[^"]*"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippets = [];
+    let sm;
+    while ((sm = snippetRe.exec(html)) !== null)
+        snippets.push(htmlToText(sm[1] ?? ''));
+    let m;
+    while ((m = linkRe.exec(html)) !== null && hits.length < maxResults) {
+        let href = m[1] ?? '';
+        // DDG wraps results as //duckduckgo.com/l/?uddg=<encoded-target>&rut=…
+        const uddg = /[?&]uddg=([^&]+)/.exec(href);
+        if (uddg?.[1]) {
+            try {
+                href = decodeURIComponent(uddg[1]);
+            }
+            catch {
+                // keep the wrapped URL — still clickable
+            }
+        }
+        if (href.startsWith('//'))
+            href = 'https:' + href;
+        hits.push({
+            title: htmlToText(m[2] ?? ''),
+            url: href,
+            snippet: snippets[hits.length] ?? '',
+        });
+    }
+    return hits;
+}
+async function searchTavily(query, maxResults, apiKey, signal) {
+    const res = await fetchWithTimeout('https://api.tavily.com/search', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ api_key: apiKey, query, max_results: maxResults }),
+    }, signal, FETCH_TIMEOUT_MS);
+    if (!res.ok)
+        throw new Error(`Tavily HTTP ${res.status}`);
+    const data = (await res.json());
+    return (data.results ?? []).slice(0, maxResults).map((r) => ({
+        title: r.title ?? '',
+        url: r.url ?? '',
+        snippet: (r.content ?? '').slice(0, 400),
+    }));
+}
+async function searchDuckDuckGo(query, maxResults, signal) {
+    const res = await fetchWithTimeout('https://html.duckduckgo.com/html/?q=' + encodeURIComponent(query), { headers: { 'user-agent': USER_AGENT, accept: 'text/html' } }, signal, FETCH_TIMEOUT_MS);
+    if (!res.ok)
+        throw new Error(`DuckDuckGo HTTP ${res.status}`);
+    return parseDuckDuckGoHtml(await res.text(), maxResults);
+}
+export const webSearchTool = {
+    name: 'web_search',
+    description: 'Search the web and return result titles, URLs, and snippets. ' +
+        'Follow up with fetch_url on the most promising result to read the page. ' +
+        'No API key needed (set TAVILY_API_KEY for higher-quality results).',
+    permissions: ['network'],
+    inputSchema: WebSearchArgsSchema,
+    timeoutMs: FETCH_TIMEOUT_MS + 5_000,
+    execute: async (args, ctx) => {
+        const tavilyKey = process.env['TAVILY_API_KEY'];
+        try {
+            if (tavilyKey) {
+                const results = await searchTavily(args.query, args.maxResults, tavilyKey, ctx.signal);
+                return typedOk({ provider: 'tavily', query: args.query, results });
+            }
+            const results = await searchDuckDuckGo(args.query, args.maxResults, ctx.signal);
+            if (results.length === 0) {
+                return typedOk({
+                    provider: 'duckduckgo',
+                    query: args.query,
+                    results: [],
+                });
+            }
+            return typedOk({ provider: 'duckduckgo', query: args.query, results });
+        }
+        catch (err) {
+            return typedErr(`web_search failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    },
+};
+//# sourceMappingURL=web.js.map

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

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

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

@@ -0,0 +1,31 @@
+import { type ToolDefinition, type TypedResult } from './toolTypes.js';
+export interface InvokeOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    cwd?: string;
+    sessionId?: string;
+}
+export declare class ToolRegistry {
+    private tools;
+    register<I, O>(def: ToolDefinition<I, O>): void;
+    get(name: string): ToolDefinition | undefined;
+    list(): string[];
+    /**
+     * Resolve a hallucinated tool name to a registered one, or null.
+     * Case/underscore-insensitive so `Read`, `list_dir`, `Search_RAG` all map.
+     */
+    private suggestFor;
+    /** Invoke a tool with validated input + timeout + audit + permissions check. */
+    invoke<O>(name: string, rawInput: unknown, options?: InvokeOptions): Promise<TypedResult<O>>;
+    /** Return all tool definitions in OpenAI function-calling format. */
+    toOpenAITools(): Array<{
+        type: 'function';
+        function: {
+            name: string;
+            description: string;
+            parameters: Record<string, unknown>;
+        };
+    }>;
+}
+export declare function getToolRegistry(): ToolRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/tools/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,cAAc,EAAoB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEnG,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmCD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqC;IAElD,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAI/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,IAAI,IAAI,MAAM,EAAE;IAIhB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAMlB,gFAAgF;IAC1E,MAAM,CAAC,CAAC,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IA8C1B,qEAAqE;IACrE,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;CAUnI;AAID,wBAAgB,eAAe,IAAI,YAAY,CAG9C"}

package/dist/core/tools/registry.js

@@ -0,0 +1,115 @@
+import { zodToJsonSchema } from './zodBridge.js';
+import { typedErr } from './toolTypes.js';
+/**
+ * Common hallucinated tool names → canonical registry names. Models trained
+ * on other agent stacks routinely call `Read`/`Glob` (Claude Code), `list_dir`
+ * (Cursor), or legacy Electron-era names (`searchRAG`) — each such call burns
+ * a per-turn tool-budget slot on a guaranteed failure (live test 2026-07-03).
+ * The alias map turns the failure into a one-step recovery: the error names
+ * the intended tool explicitly ("Did you mean …").
+ */
+const TOOL_NAME_ALIASES = {
+    read: 'read_file',
+    readfile: 'read_file',
+    cat: 'read_file',
+    write: 'write_file',
+    writefile: 'write_file',
+    edit: 'edit_file',
+    editfile: 'edit_file',
+    glob: 'list_files',
+    listdir: 'list_files',
+    listdirectory: 'list_files',
+    ls: 'list_files',
+    dir: 'list_files',
+    find: 'list_files',
+    grep: 'grep_content',
+    search: 'grep_content',
+    searchrag: 'searchDocuments',
+    rag: 'searchDocuments',
+    shell: 'bash',
+    terminal: 'bash',
+    cmd: 'bash',
+    run: 'bash',
+    exec: 'bash',
+};
+export class ToolRegistry {
+    tools = new Map();
+    register(def) {
+        this.tools.set(def.name, def);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    list() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Resolve a hallucinated tool name to a registered one, or null.
+     * Case/underscore-insensitive so `Read`, `list_dir`, `Search_RAG` all map.
+     */
+    suggestFor(name) {
+        const normalized = name.toLowerCase().replace(/[_-]/g, '');
+        const target = TOOL_NAME_ALIASES[normalized];
+        return target && this.tools.has(target) ? target : null;
+    }
+    /** Invoke a tool with validated input + timeout + audit + permissions check. */
+    async invoke(name, rawInput, options = {}) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            const suggestion = this.suggestFor(name);
+            return typedErr(`Tool "${name}" not found.` +
+                (suggestion ? ` Did you mean "${suggestion}"? Retry with that exact name.` : '') +
+                ` Available: ${this.list().join(', ')}`);
+        }
+        // Zod validation
+        const parsed = tool.inputSchema.safeParse(rawInput);
+        if (!parsed.success) {
+            return typedErr(`Invalid input: ${parsed.error.message}`);
+        }
+        // Timeout + cancellation
+        const timeoutMs = options.timeoutMs ?? tool.timeoutMs ?? 30000;
+        const signal = options.signal;
+        const ctx = {
+            signal: signal ?? new AbortController().signal,
+            cwd: options.cwd ?? process.cwd(),
+            audit: () => { },
+            sessionId: options.sessionId ?? 'default',
+        };
+        try {
+            const result = await Promise.race([
+                tool.execute(parsed.data, ctx),
+                new Promise((_, reject) => {
+                    const timer = setTimeout(() => reject(new Error(`Tool "${name}" timed out after ${timeoutMs}ms`)), timeoutMs);
+                    signal?.addEventListener('abort', () => {
+                        clearTimeout(timer);
+                        reject(new Error(`Tool "${name}" aborted`));
+                    });
+                }),
+            ]);
+            return result;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            return typedErr(error);
+        }
+    }
+    /** Return all tool definitions in OpenAI function-calling format. */
+    toOpenAITools() {
+        return Array.from(this.tools.values()).map((t) => ({
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.jsonSchema ?? zodToJsonSchema(t.inputSchema),
+            },
+        }));
+    }
+}
+/** Singleton instance (caller can override via setInstance). */
+let _instance = null;
+export function getToolRegistry() {
+    if (!_instance)
+        _instance = new ToolRegistry();
+    return _instance;
+}
+//# sourceMappingURL=registry.js.map

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

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

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

@@ -0,0 +1,60 @@
+import type { ZodSchema } from 'zod';
+/** Discriminated union for tool execution results. */
+export type TypedResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+};
+/** Tool permission categories. The CLI prompts the user before invoking
+ *  tools with write/execute/network permissions. */
+export type ToolPermission = 'read' | 'write' | 'execute' | 'network';
+export interface ToolDefinition<I = unknown, O = unknown> {
+    /** Stable tool name (used by LLM function-calling). */
+    name: string;
+    /** Human-readable description (shown to LLM in prompt). */
+    description: string;
+    /** Permissions required to invoke. Empty array = no permissions. */
+    permissions: ToolPermission[];
+    /** Timeout in ms (default 30000 if not specified). */
+    timeoutMs?: number;
+    /** Zod schema for input validation. */
+    inputSchema: ZodSchema<I>;
+    /** Async executor. Receives validated input + context, returns TypedResult. */
+    execute: (input: I, ctx: ToolContext) => Promise<TypedResult<O>>;
+    /**
+     * Optional raw JSON Schema for the tool parameters. When present it is
+     * forwarded to the provider VERBATIM instead of converting inputSchema
+     * (used by MCP tools, whose servers publish JSON Schema directly and
+     * validate their own inputs — the local zod gate stays permissive).
+     */
+    jsonSchema?: Record<string, unknown>;
+    /** Optional related tools (for discovery in UI). */
+    relatedTools?: string[];
+}
+export interface ToolContext {
+    /** Per-tool-call timeout + cancellation signal. */
+    signal: AbortSignal;
+    /** Working directory (defaults to process.cwd()). */
+    cwd: string;
+    /** Audit logger. Tools should call audit() for every invocation. */
+    audit: (entry: AuditEntry) => void;
+    /** Session id (for audit grouping). */
+    sessionId: string;
+}
+export interface AuditEntry {
+    tool: string;
+    args: unknown;
+    result: {
+        ok: boolean;
+        durationMs: number;
+        sizeBytes?: number;
+    };
+    ts: number;
+    sessionId: string;
+}
+/** Helper: wrap a thrown error into TypedResult. */
+export declare function typedOk<T>(value: T): TypedResult<T>;
+export declare function typedErr<T = never>(error: string): TypedResult<T>;
+//# sourceMappingURL=toolTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolTypes.d.ts","sourceRoot":"","sources":["../../../src/core/tools/toolTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGrC,sDAAsD;AACtD,MAAM,MAAM,WAAW,CAAC,CAAC,IACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;oDACoD;AACpD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACtD,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1B,+EAA+E;IAC/E,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,MAAM,EAAE,WAAW,CAAC;IACpB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACnC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAEnD;AAED,wBAAgB,QAAQ,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAEjE"}

package/dist/core/tools/toolTypes.js

@@ -0,0 +1,8 @@
+/** Helper: wrap a thrown error into TypedResult. */
+export function typedOk(value) {
+    return { ok: true, value };
+}
+export function typedErr(error) {
+    return { ok: false, error };
+}
+//# sourceMappingURL=toolTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolTypes.js","sourceRoot":"","sources":["../../../src/core/tools/toolTypes.ts"],"names":[],"mappings":"AAuDA,oDAAoD;AACpD,MAAM,UAAU,OAAO,CAAI,KAAQ;IACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAY,KAAa;IAC/C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { ZodSchema } from 'zod';
+/** Convert a Zod schema into a JSON Schema-like object suitable for LLM
+ *  function-calling definitions. Best-effort: handles primitives, objects,
+ *  arrays, unions, optionals. Does not handle refinements beyond type. */
+export declare function zodToJsonSchema(schema: ZodSchema): Record<string, unknown>;
+//# sourceMappingURL=zodBridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zodBridge.d.ts","sourceRoot":"","sources":["../../../src/core/tools/zodBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,KAAK,CAAC;AAEjD;;0EAE0E;AAC1E,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU1E"}

package/dist/core/tools/zodBridge.js

@@ -0,0 +1,56 @@
+/** Convert a Zod schema into a JSON Schema-like object suitable for LLM
+ *  function-calling definitions. Best-effort: handles primitives, objects,
+ *  arrays, unions, optionals. Does not handle refinements beyond type. */
+export function zodToJsonSchema(schema) {
+    if (typeof schema.toJSONSchema === 'function') {
+        const res = schema.toJSONSchema();
+        if (res && typeof res === 'object') {
+            const copy = { ...res };
+            delete copy['$schema'];
+            return copy;
+        }
+    }
+    return _convert(schema);
+}
+function _convert(schema) {
+    const def = schema._def;
+    if (!def)
+        return {};
+    switch (def.typeName) {
+        case 'ZodString': return { type: 'string' };
+        case 'ZodNumber': return { type: 'number' };
+        case 'ZodBoolean': return { type: 'boolean' };
+        case 'ZodObject': {
+            const shape = schema.shape;
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape)) {
+                properties[key] = _convert(value);
+                // If inner type is not ZodOptional, mark required
+                const vDef = value._def;
+                if (vDef?.typeName !== 'ZodOptional') {
+                    required.push(key);
+                }
+            }
+            return { type: 'object', properties, required };
+        }
+        case 'ZodArray': {
+            const inner = def.innerType;
+            return { type: 'array', items: _convert(inner) };
+        }
+        case 'ZodOptional': {
+            const inner = def.innerType;
+            return _convert(inner);
+        }
+        case 'ZodUnion': {
+            const options = def.options ?? [];
+            return { anyOf: options.map(_convert) };
+        }
+        case 'ZodEnum': {
+            const values = schema.options;
+            return { type: 'string', enum: values };
+        }
+        default: return {};
+    }
+}
+//# sourceMappingURL=zodBridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zodBridge.js","sourceRoot":"","sources":["../../../src/core/tools/zodBridge.ts"],"names":[],"mappings":"AAEA;;0EAE0E;AAC1E,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,IAAI,OAAQ,MAAc,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QACvD,MAAM,GAAG,GAAI,MAAc,CAAC,YAAY,EAAE,CAAC;QAC3C,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,MAAoB,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,QAAQ,CAAC,MAAkB;IAClC,MAAM,GAAG,GAAI,MAAgH,CAAC,IAAI,CAAC;IACnI,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,WAAW,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5C,KAAK,WAAW,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5C,KAAK,YAAY,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAI,MAA2D,CAAC,KAAK,CAAC;YACjF,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,UAAU,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClC,kDAAkD;gBAClD,MAAM,IAAI,GAAI,KAAkE,CAAC,IAAI,CAAC;gBACtF,IAAI,IAAI,EAAE,QAAQ,KAAK,aAAa,EAAE,CAAC;oBACrC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;QAClD,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAuB,CAAC;YAC1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAuB,CAAC;YAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,OAAO,GAAI,GAAG,CAAC,OAAwB,IAAI,EAAE,CAAC;YACpD,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,MAAM,GAAI,MAAoD,CAAC,OAAO,CAAC;YAC7E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/council/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Council — multi-agent orchestration primitives.
+ * The 6 dantesche roles (Caronte, Nettuno, Gerione, Plutone, Minosse, Lucifero)
+ * coordinate via a feedback loop driven by the `runCouncilPure` generator.
+ */
+export * from '../agents/councilApi.js';
+export * from './runMode.js';
+export * from './modeBanners.js';
+export * from '../agents/roles.js';
+export * from '../agents/promoteMember.js';
+export * from '../agents/councilDirectives.js';
+export * from '../agents/systemPromptBuilder.js';
+export * from '../agents/promptModules.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/council/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/council/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC"}

package/dist/council/index.js

@@ -0,0 +1,14 @@
+/**
+ * Council — multi-agent orchestration primitives.
+ * The 6 dantesche roles (Caronte, Nettuno, Gerione, Plutone, Minosse, Lucifero)
+ * coordinate via a feedback loop driven by the `runCouncilPure` generator.
+ */
+export * from '../agents/councilApi.js';
+export * from './runMode.js';
+export * from './modeBanners.js';
+export * from '../agents/roles.js';
+export * from '../agents/promoteMember.js';
+export * from '../agents/councilDirectives.js';
+export * from '../agents/systemPromptBuilder.js';
+export * from '../agents/promptModules.js';
+//# sourceMappingURL=index.js.map

package/dist/council/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/council/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC"}

package/dist/council/modeBanners.d.ts

@@ -0,0 +1,5 @@
+import type { CouncilRunMode } from './runMode.js';
+export declare const DESIGN_PHASE_MODE_BANNER = "COUNCIL RUN MODE: design-phase.\nWorkspace tool emissions described in your role prompt are MANDATORY in this run \u2014 prose alone does not count as a deliverable. Persist artifacts via the workspace tools listed in your AVAILABLE TOOLS section.";
+export declare const IMPLEMENTATION_MODE_BANNER = "COUNCIL RUN MODE: implementation.\nPrefer write_file, edit_file, and bash for code changes. Design-phase mandatory workspace blocks in your role prompt are INACTIVE in this run \u2014 only call workspace tools when they add durable project value.";
+export declare function councilModeBanner(runMode: CouncilRunMode): string;
+//# sourceMappingURL=modeBanners.d.ts.map

package/dist/council/modeBanners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modeBanners.d.ts","sourceRoot":"","sources":["../../src/council/modeBanners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,wBAAwB,4PAC6K,CAAC;AAEnN,eAAO,MAAM,0BAA0B,2PACwK,CAAC;AAEhN,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAIjE"}

package/dist/council/modeBanners.js

@@ -0,0 +1,10 @@
+export const DESIGN_PHASE_MODE_BANNER = `COUNCIL RUN MODE: design-phase.
+Workspace tool emissions described in your role prompt are MANDATORY in this run — prose alone does not count as a deliverable. Persist artifacts via the workspace tools listed in your AVAILABLE TOOLS section.`;
+export const IMPLEMENTATION_MODE_BANNER = `COUNCIL RUN MODE: implementation.
+Prefer write_file, edit_file, and bash for code changes. Design-phase mandatory workspace blocks in your role prompt are INACTIVE in this run — only call workspace tools when they add durable project value.`;
+export function councilModeBanner(runMode) {
+    return runMode === 'design-phase'
+        ? DESIGN_PHASE_MODE_BANNER
+        : IMPLEMENTATION_MODE_BANNER;
+}
+//# sourceMappingURL=modeBanners.js.map

package/dist/council/modeBanners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modeBanners.js","sourceRoot":"","sources":["../../src/council/modeBanners.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAG;kNAC0K,CAAC;AAEnN,MAAM,CAAC,MAAM,0BAA0B,GAAG;+MACqK,CAAC;AAEhN,MAAM,UAAU,iBAAiB,CAAC,OAAuB;IACvD,OAAO,OAAO,KAAK,cAAc;QAC/B,CAAC,CAAC,wBAAwB;QAC1B,CAAC,CAAC,0BAA0B,CAAC;AACjC,CAAC"}

package/dist/council/runMode.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Council run-mode detection — implementation vs design-phase.
+ *
+ * Drives gated tool-emission enforcement, mode banners in member prompts,
+ * and the complete-design post-processor skip in implementation runs.
+ */
+export type CouncilRunMode = 'implementation' | 'design-phase';
+export interface CouncilRunModeInput {
+    userMessage: string;
+    /** True when `.zelari/plan.json` exists with at least one phase. */
+    hasExistingPlan?: boolean;
+    forceMode?: CouncilRunMode;
+    env?: {
+        ZELARI_COUNCIL_MODE?: string;
+    };
+}
+/**
+ * Resolve how this council run should behave.
+ *
+ * Override order: `forceMode` → `ZELARI_COUNCIL_MODE` env → heuristics →
+ * default `implementation`.
+ */
+export declare function resolveCouncilRunMode(input: CouncilRunModeInput): CouncilRunMode;
+export declare function councilTierFromSize(councilSize: number): 'lite' | 'full';
+//# sourceMappingURL=runMode.d.ts.map

package/dist/council/runMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runMode.d.ts","sourceRoot":"","sources":["../../src/council/runMode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,GAAG,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAWD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAyBhF;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAExE"}