@fraziym/axoniz 0.1.0

package/dist/core/downloader.js

@@ -0,0 +1,180 @@
+/**
+ * Axoniz-Zero Model Downloader
+ * Fetches GGUF models from HuggingFace directly.
+ * Port of axoniz/core/downloader.py (huggingface_hub -> @huggingface/hub + undici).
+ *
+ * Downloads are streamed to disk with HTTP Range resume so multi-GB GGUFs
+ * survive a dropped connection. `@huggingface/hub`'s listModels/listFiles are
+ * used for discovery.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
+import { listFiles, listModels } from "@huggingface/hub";
+import { request } from "undici";
+import { MODELS_DIR } from "./config.js";
+import { debug, error, info } from "./debug.js";
+/** Track download progress: filename -> percent (0-100, or -1 on failure). */
+const downloads = new Map();
+/** Search HuggingFace for GGUF models. */
+export async function searchModels(query = "gguf", limit = 10) {
+    try {
+        const results = [];
+        for await (const m of listModels({ search: { query }, limit })) {
+            const model = m;
+            const id = String(model.name ?? model.id ?? "");
+            results.push({
+                id,
+                author: id.includes("/") ? id.split("/")[0] : null,
+                lastModified: model.updatedAt ?? null,
+                downloads: model.downloads ?? null,
+                likes: model.likes ?? null,
+            });
+        }
+        return results;
+    }
+    catch (e) {
+        error(`[Downloader] search failed: ${errMsg(e)}`);
+        return [];
+    }
+}
+/** List available GGUF files in a repo. */
+export async function listRemoteGgufs(repoId) {
+    try {
+        const files = [];
+        for await (const f of listFiles({ repo: repoId })) {
+            const p = f.path ?? "";
+            if (p.endsWith(".gguf"))
+                files.push(p);
+        }
+        return files;
+    }
+    catch {
+        return [];
+    }
+}
+function errMsg(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+/**
+ * Stream a URL to `dest`, resuming a partial file via HTTP Range requests.
+ * Returns the resolved destination path.
+ *
+ * Correctness notes (each of these bites in practice):
+ *  - 416 means the local file is already complete.
+ *  - A server that ignores Range answers 200 with the FULL body; appending then
+ *    silently corrupts the file, so we restart from zero.
+ *  - Never buffer the body in memory; multi-GB GGUFs must stream to disk.
+ */
+export async function resumableDownload(url, dest, onProgress, maxAttempts = 6, extraHeaders = {}) {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    let offset = 0;
+    try {
+        offset = fs.statSync(dest).size;
+    }
+    catch {
+        offset = 0;
+    }
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        const headers = { ...extraHeaders };
+        if (offset > 0)
+            headers.range = `bytes=${offset}-`;
+        let res;
+        try {
+            res = await request(url, {
+                method: "GET",
+                headers,
+                headersTimeout: 120_000,
+                bodyTimeout: 0,
+            });
+        }
+        catch (e) {
+            debug(`[Downloader] attempt ${attempt} connect failed: ${errMsg(e)}`);
+            continue;
+        }
+        // Already complete.
+        if (res.statusCode === 416) {
+            await res.body.dump();
+            return dest;
+        }
+        if (offset > 0 && res.statusCode !== 206) {
+            await res.body.dump();
+            fs.rmSync(dest, { force: true });
+            offset = 0;
+            continue;
+        }
+        if (res.statusCode !== 200 && res.statusCode !== 206) {
+            await res.body.dump();
+            throw new Error(`HTTP ${res.statusCode} downloading ${url}`);
+        }
+        const len = Number(res.headers["content-length"] ?? 0);
+        const total = offset + len;
+        let got = offset;
+        const out = fs.createWriteStream(dest, { flags: offset > 0 ? "a" : "w" });
+        const source = Readable.from(res.body);
+        source.on("data", (chunk) => {
+            got += chunk.length;
+            onProgress?.(got, total);
+        });
+        try {
+            await pipeline(source, out);
+        }
+        catch (e) {
+            debug(`[Downloader] attempt ${attempt} transfer interrupted: ${errMsg(e)} (${got} bytes)`);
+            offset = got;
+            continue;
+        }
+        if (len === 0 || got >= total)
+            return dest;
+        offset = got; // Socket closed early — resume from where we stopped.
+    }
+    throw new Error(`[Downloader] giving up after ${maxAttempts} attempts: ${dest}`);
+}
+/** Run a download in the background (fire and forget). */
+export function downloadModelAsync(repoId, filename, token) {
+    void (async () => {
+        downloads.set(filename, 0);
+        try {
+            const dest = await downloadModel(repoId, filename, token);
+            downloads.set(filename, dest ? 100 : -1);
+            if (dest)
+                info(`[Downloader] finished: ${dest}`);
+        }
+        catch (e) {
+            error(`[Downloader] ${filename} failed: ${errMsg(e)}`);
+            downloads.set(filename, -1);
+        }
+    })();
+    return `Started download of ${filename}`;
+}
+export function getDownloadStatus() {
+    return Object.fromEntries(downloads);
+}
+/**
+ * Download a GGUF model from HuggingFace.
+ * `filename` is required; returns the destination path or "" on failure.
+ */
+export async function downloadModel(repoId, filename, token) {
+    info(`[Downloader] repo=${repoId} | target=${filename ?? "auto"}`);
+    try {
+        if (!filename) {
+            error("Filename is required (e.g. 'Llama-3.2-3B-Instruct-Q4_K_M.gguf')");
+            return "";
+        }
+        const url = `https://huggingface.co/${repoId}/resolve/main/${encodeURIComponent(filename)}`;
+        const dest = path.join(MODELS_DIR, path.basename(filename));
+        const auth = token ? { authorization: `Bearer ${token}` } : {};
+        await resumableDownload(url, dest, (got, total) => {
+            if (total > 0)
+                downloads.set(filename, Math.floor((got / total) * 100));
+        }, 6, auth);
+        info(`[Downloader] success -> ${dest}`);
+        return dest;
+    }
+    catch (e) {
+        error(`[Downloader] failed: ${errMsg(e)}`);
+        return "";
+    }
+}
+//# sourceMappingURL=downloader.js.map

package/dist/core/downloader.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,80 @@
+/**
+ * AXONIZ-ZERO Error Hierarchy
+ * Production-grade typed errors for clear error handling throughout the system.
+ */
+export interface ErrorDetails {
+    [key: string]: unknown;
+}
+/** Base class for all AXONIZ-ZERO errors. */
+export declare class AxonizError extends Error {
+    code: string;
+    details: ErrorDetails;
+    constructor(message: string, code?: string, details?: ErrorDetails);
+    toDict(): {
+        error: string;
+        message: string;
+        details: ErrorDetails;
+    };
+}
+export declare class BackendError extends AxonizError {
+    backend: string;
+    constructor(message: string, backend?: string, details?: ErrorDetails);
+}
+/** Backend server is not reachable. */
+export declare class BackendNotAvailableError extends BackendError {
+    constructor(backend: string, url?: string);
+}
+/** Requested model does not exist on the backend. */
+export declare class ModelNotFoundError extends BackendError {
+    constructor(model: string, backend?: string);
+}
+/** API key is required but not configured. */
+export declare class ApiKeyMissingError extends BackendError {
+    constructor(backend: string);
+}
+/** Backend did not respond within the allowed time. */
+export declare class BackendTimeoutError extends BackendError {
+    constructor(backend: string, timeout: number);
+}
+/** API rate limit was hit. */
+export declare class RateLimitError extends BackendError {
+    constructor(backend: string, retryAfter?: number);
+}
+export declare class ToolError extends AxonizError {
+    tool: string;
+    constructor(message: string, tool?: string, details?: ErrorDetails);
+}
+/** Tool exceeded its time budget. */
+export declare class ToolTimeoutError extends ToolError {
+    constructor(tool: string, timeout: number);
+}
+/** Tool attempted a disallowed operation. */
+export declare class ToolSecurityError extends ToolError {
+    constructor(tool: string, reason: string);
+}
+/** File operation attempted outside the allowed workspace. */
+export declare class WorkspaceViolationError extends ToolError {
+    constructor(path: string, workspace: string);
+}
+/** File size exceeds the allowed limit. */
+export declare class FileTooLargeError extends ToolError {
+    constructor(path: string, size: number, limit: number);
+}
+export declare class AgentError extends AxonizError {
+    constructor(message: string, details?: ErrorDetails);
+}
+/** Agent detected an infinite loop. */
+export declare class AgentLoopError extends AgentError {
+    constructor(tool: string, count: number);
+}
+/** Agent exhausted its step budget. */
+export declare class AgentMaxStepsError extends AgentError {
+    constructor(steps: number);
+}
+export declare class ConfigError extends AxonizError {
+    constructor(message: string, key?: string);
+}
+export declare class NetworkError extends AxonizError {
+    constructor(message: string, url?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,6CAA6C;AAC7C,qBAAa,WAAY,SAAQ,KAAK;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IAEtB,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,SAAiB,EAAE,OAAO,GAAE,YAAiB,EAM7E;IAED,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAElE;CACF;AAID,qBAAa,YAAa,SAAQ,WAAW;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,SAAK,EAAE,OAAO,GAAE,YAAiB,EAGpE;CACF;AAED,uCAAuC;AACvC,qBAAa,wBAAyB,SAAQ,YAAY;IACxD,YAAY,OAAO,EAAE,MAAM,EAAE,GAAG,SAAK,EAGpC;CACF;AAED,qDAAqD;AACrD,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,YAAY,KAAK,EAAE,MAAM,EAAE,OAAO,SAAK,EAGtC;CACF;AAED,8CAA8C;AAC9C,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,uDAAuD;AACvD,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAO3C;CACF;AAED,8BAA8B;AAC9B,qBAAa,cAAe,SAAQ,YAAY;IAC9C,YAAY,OAAO,EAAE,MAAM,EAAE,UAAU,SAAI,EAO1C;CACF;AAID,qBAAa,SAAU,SAAQ,WAAW;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,SAAK,EAAE,OAAO,GAAE,YAAiB,EAGjE;CACF;AAED,qCAAqC;AACrC,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAGxC;CACF;AAED,6CAA6C;AAC7C,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAGvC;CACF;AAED,8DAA8D;AAC9D,qBAAa,uBAAwB,SAAQ,SAAS;IACpD,YAAY,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAO1C;CACF;AAED,2CAA2C;AAC3C,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAOpD;CACF;AAID,qBAAa,UAAW,SAAQ,WAAW;IACzC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,EAEtD;CACF;AAED,uCAAuC;AACvC,qBAAa,cAAe,SAAQ,UAAU;IAC5C,YAAY,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAMtC;CACF;AAED,uCAAuC;AACvC,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,YAAY,KAAK,EAAE,MAAM,EAGxB;CACF;AAID,qBAAa,WAAY,SAAQ,WAAW;IAC1C,YAAY,OAAO,EAAE,MAAM,EAAE,GAAG,SAAK,EAEpC;CACF;AAID,qBAAa,YAAa,SAAQ,WAAW;IAC3C,YAAY,OAAO,EAAE,MAAM,EAAE,GAAG,SAAK,EAEpC;CACF"}

package/dist/core/errors.js

@@ -0,0 +1,134 @@
+/**
+ * AXONIZ-ZERO Error Hierarchy
+ * Production-grade typed errors for clear error handling throughout the system.
+ */
+/** Base class for all AXONIZ-ZERO errors. */
+export class AxonizError extends Error {
+    code;
+    details;
+    constructor(message, code = "AXONIZ_ERROR", details = {}) {
+        super(message);
+        this.name = new.target.name;
+        this.code = code;
+        this.details = details;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toDict() {
+        return { error: this.code, message: this.message, details: this.details };
+    }
+}
+/* ── Backend errors ───────────────────────────────────────────────────────── */
+export class BackendError extends AxonizError {
+    backend;
+    constructor(message, backend = "", details = {}) {
+        super(message, "BACKEND_ERROR", details);
+        this.backend = backend;
+    }
+}
+/** Backend server is not reachable. */
+export class BackendNotAvailableError extends BackendError {
+    constructor(backend, url = "") {
+        super(`Backend '${backend}' is not available${url ? ` at ${url}` : ""}`, backend, { url });
+        this.code = "BACKEND_NOT_AVAILABLE";
+    }
+}
+/** Requested model does not exist on the backend. */
+export class ModelNotFoundError extends BackendError {
+    constructor(model, backend = "") {
+        super(`Model '${model}' not found`, backend, { model });
+        this.code = "MODEL_NOT_FOUND";
+    }
+}
+/** API key is required but not configured. */
+export class ApiKeyMissingError extends BackendError {
+    constructor(backend) {
+        super(`API key not set for '${backend}'`, backend);
+        this.code = "API_KEY_MISSING";
+    }
+}
+/** Backend did not respond within the allowed time. */
+export class BackendTimeoutError extends BackendError {
+    constructor(backend, timeout) {
+        super(`Backend '${backend}' timed out after ${timeout.toFixed(1)}s`, backend, { timeout });
+        this.code = "BACKEND_TIMEOUT";
+    }
+}
+/** API rate limit was hit. */
+export class RateLimitError extends BackendError {
+    constructor(backend, retryAfter = 0) {
+        super(`Rate limit hit on '${backend}'${retryAfter ? `, retry after ${retryAfter}s` : ""}`, backend, { retry_after: retryAfter });
+        this.code = "RATE_LIMIT";
+    }
+}
+/* ── Tool errors ──────────────────────────────────────────────────────────── */
+export class ToolError extends AxonizError {
+    tool;
+    constructor(message, tool = "", details = {}) {
+        super(message, "TOOL_ERROR", details);
+        this.tool = tool;
+    }
+}
+/** Tool exceeded its time budget. */
+export class ToolTimeoutError extends ToolError {
+    constructor(tool, timeout) {
+        super(`Tool '${tool}' timed out after ${timeout.toFixed(1)}s`, tool, { timeout });
+        this.code = "TOOL_TIMEOUT";
+    }
+}
+/** Tool attempted a disallowed operation. */
+export class ToolSecurityError extends ToolError {
+    constructor(tool, reason) {
+        super(`Security violation in '${tool}': ${reason}`, tool, { reason });
+        this.code = "TOOL_SECURITY";
+    }
+}
+/** File operation attempted outside the allowed workspace. */
+export class WorkspaceViolationError extends ToolError {
+    constructor(path, workspace) {
+        super(`Path '${path}' is outside the workspace '${workspace}'`, "file", { path, workspace });
+        this.code = "WORKSPACE_VIOLATION";
+    }
+}
+/** File size exceeds the allowed limit. */
+export class FileTooLargeError extends ToolError {
+    constructor(path, size, limit) {
+        super(`File '${path}' is ${size.toLocaleString()} bytes, limit is ${limit.toLocaleString()} bytes`, "file", { path, size, limit });
+        this.code = "FILE_TOO_LARGE";
+    }
+}
+/* ── Agent errors ─────────────────────────────────────────────────────────── */
+export class AgentError extends AxonizError {
+    constructor(message, details = {}) {
+        super(message, "AGENT_ERROR", details);
+    }
+}
+/** Agent detected an infinite loop. */
+export class AgentLoopError extends AgentError {
+    constructor(tool, count) {
+        super(`Infinite loop: '${tool}' called ${count} times with identical args`, {
+            tool,
+            count,
+        });
+        this.code = "AGENT_LOOP";
+    }
+}
+/** Agent exhausted its step budget. */
+export class AgentMaxStepsError extends AgentError {
+    constructor(steps) {
+        super(`Exhausted maximum ${steps} steps`, { steps });
+        this.code = "AGENT_MAX_STEPS";
+    }
+}
+/* ── Config errors ────────────────────────────────────────────────────────── */
+export class ConfigError extends AxonizError {
+    constructor(message, key = "") {
+        super(message, "CONFIG_ERROR", { key });
+    }
+}
+/* ── Network errors ───────────────────────────────────────────────────────── */
+export class NetworkError extends AxonizError {
+    constructor(message, url = "") {
+        super(message, "NETWORK_ERROR", { url });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/extras.d.ts

@@ -0,0 +1,160 @@
+export interface ChatMessageLike {
+    role?: string;
+    content?: string | null;
+    [key: string]: unknown;
+}
+/** Anything exposing a Python-style `chat(messages)` returning text or an object. */
+export interface ChatLike {
+    chat(messages: ChatMessageLike[]): unknown;
+}
+/**
+ * Axoniz tool maps follow the Python kwargs convention, so the agent dispatches
+ * them as `fn(argsObject)` (see `adapt()` in src/core/agent.ts). These helpers
+ * accept both that single-object form and plain positional calls.
+ */
+export declare function toolArgs(args: unknown[], names: readonly string[]): Record<string, unknown>;
+/** `undefined`/`null`-tolerant string coercion for optional tool args. */
+export declare function optStr(v: unknown): string | undefined;
+/** `undefined`/`null`-tolerant number coercion for optional tool args. */
+export declare function optNum(v: unknown): number | undefined;
+/** `undefined`/`null`-tolerant boolean coercion for optional tool args. */
+export declare function optBool(v: unknown, dflt?: boolean): boolean;
+/** Rough token estimator: ~4 chars per token (GPT convention). */
+export declare class TokenCounter {
+    static count(text: string): number;
+    static count_messages(messages: ChatMessageLike[]): number;
+    static fits(messages: ChatMessageLike[], maxTokens?: number): boolean;
+    static countMessages(messages: ChatMessageLike[]): number;
+}
+/**
+ * Compresses long conversation histories to stay within context limits.
+ * Strategy:
+ *   - Always keep system prompt(s)
+ *   - Always keep the last `keep_tail` messages verbatim
+ *   - Summarize middle messages into a single summary message
+ */
+export declare class ContextCompressor {
+    max_tokens: number;
+    keep_tail: number;
+    constructor(maxTokens?: number, keepTail?: number);
+    /**
+     * Compress messages if over budget.
+     * `llm` is an optional backend with `.chat(messages)` for summarization.
+     */
+    compress(messages: ChatMessageLike[], llm?: ChatLike | null): Promise<ChatMessageLike[]>;
+    /** Use the LLM to summarize the messages. */
+    _summarize(messages: ChatMessageLike[], llm: ChatLike): Promise<string>;
+    /** Fallback: extract key lines without the LLM. */
+    _extractive_summary(messages: ChatMessageLike[]): string;
+}
+export interface EvaluationResult {
+    score: number;
+    reason: string;
+    improvements?: string;
+    pass: boolean;
+}
+/**
+ * After each agent response, optionally ask the same LLM to score it.
+ * If the score is below the threshold, retry with a stronger prompt.
+ */
+export declare class SelfEvaluator {
+    static readonly EVAL_PROMPT = "You are a strict code and task reviewer.\nRate the following agent response on a scale of 0-10 based on:\n- Completeness (did it fully address the task?)\n- Correctness (is the code/answer correct?)\n- Clarity (is it well-explained?)\n\nRespond with ONLY a JSON object: {\"score\": 7, \"reason\": \"brief explanation\", \"improvements\": \"what to fix\"}\n";
+    threshold: number;
+    llm: ChatLike | null;
+    constructor(threshold?: number, llm?: ChatLike | null);
+    /** Returns {score, reason, pass} (+ improvements when the model supplied it). */
+    evaluate(task: string, response: string): Promise<EvaluationResult>;
+    /** Build a retry prompt when the score is too low. */
+    retry_prompt(task: string, response: string, reason: string): string;
+    /** camelCase alias. */
+    retryPrompt(task: string, response: string, reason: string): string;
+}
+export interface SymbolEntry {
+    name: string;
+    file: string;
+}
+export interface ImportEntry {
+    module: string;
+    file: string;
+}
+export interface WorkspaceIndex {
+    files: number;
+    classes: SymbolEntry[];
+    functions: SymbolEntry[];
+    imports: ImportEntry[];
+}
+interface ParsedFile {
+    classes: string[];
+    functions: string[];
+    imports: string[];
+}
+/**
+ * Indexes a workspace directory for fast symbol lookup.
+ * Extracts: file paths, Python classes/functions/imports.
+ */
+export declare class WorkspaceIndexer {
+    workspace: string;
+    protected _cache: Map<string, ParsedFile>;
+    protected _mtime: Map<string, number>;
+    constructor(workspace: string);
+    /** Build/refresh the index. Returns a summary object. */
+    index(maxFiles?: number): WorkspaceIndex;
+    /** Recursive `.py` discovery with the same pruned directories as `os.walk`. */
+    protected _walkPythonFiles(root: string, out?: string[]): string[];
+    /** Regex-based stand-in for Python's `ast` symbol extraction. */
+    _parse_python(fpath: string): ParsedFile;
+    /** Find where a class/function is defined (substring, case-insensitive). */
+    find_symbol(name: string): SymbolEntry[];
+    /** One-line project summary. */
+    summary(): string;
+    findSymbol(name: string): SymbolEntry[];
+}
+export type GitToolFn = (...args: unknown[]) => string;
+/** Git operations for the agent. Requires `git` in PATH. */
+export declare class GitTools {
+    workspace: string;
+    constructor(workspace: string);
+    /**
+     * Run `git <args>` in the workspace. Returns stdout, or the exact Python
+     * error strings: "[git error] <stderr>", "[ERROR] git not found in PATH",
+     * "[ERROR] git timed out", "[ERROR] <e>", or "(no output)".
+     */
+    _git(args: string[], timeout?: number): string;
+    status(): string;
+    diff(filePath?: string | null, staged?: boolean): string;
+    log(n?: number, oneline?: boolean): string;
+    add(p?: string): string;
+    commit(message: string): string;
+    branch(): string;
+    checkout(branchName: string, create?: boolean): string;
+    push(remote?: string, branchName?: string | null): string;
+    pull(): string;
+    stash(): string;
+    stash_pop(): string;
+    is_repo(): boolean;
+    init(): string;
+    current_branch(): string;
+    as_tool_map(): Record<string, GitToolFn>;
+    isRepo(): boolean;
+    currentBranch(): string;
+    stashPop(): string;
+    asToolMap(): Record<string, GitToolFn>;
+}
+export declare const PLANNER_PROMPT = "You are a precise task planner for a coding agent.\nGiven a high-level goal, produce a step-by-step execution plan.\n\nRules:\n- Each step must be a single, concrete, verifiable action\n- Steps must be ordered by dependency\n- Maximum 10 steps\n- Each step has: id, action (what to do), verify (how to confirm it worked), tool_hint (which tool to use)\n\nRespond ONLY with a JSON array:\n[\n  {\"id\": 1, \"action\": \"Create src/ directory\", \"verify\": \"src/ exists\", \"tool_hint\": \"file_list\"},\n  {\"id\": 2, \"action\": \"Write main.py with FastAPI skeleton\", \"verify\": \"main.py contains 'from fastapi'\", \"tool_hint\": \"file_write\"}\n]";
+export interface PlanStep {
+    id: number;
+    action: string;
+    verify: string;
+    tool_hint?: string;
+    [key: string]: unknown;
+}
+/** Breaks a goal into verified steps. Uses the agent's LLM. */
+export declare class SmartPlanner {
+    llm: ChatLike | null;
+    constructor(llm?: ChatLike | null);
+    plan(goal: string, workspaceSummary?: string): Promise<PlanStep[]>;
+    format_plan(steps: PlanStep[]): string;
+    formatPlan(steps: PlanStep[]): string;
+}
+export {};
+//# sourceMappingURL=extras.d.ts.map

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

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