codebase-cli 2.0.0-pre.0

package/dist/tools/shell.js.map

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

package/dist/tools/task-store.js

@@ -0,0 +1,70 @@
+/**
+ * Per-agent-instance task store. Holds the in-flight checklist the model
+ * uses to plan multi-step work. UI listeners receive a snapshot of the
+ * full list on every mutation so they can re-render.
+ */
+export class TaskStore {
+    tasks = new Map();
+    listeners = new Set();
+    counter = 0;
+    create(input) {
+        const id = `task-${++this.counter}`;
+        const now = Date.now();
+        const task = {
+            id,
+            title: input.title,
+            description: input.description ?? null,
+            activeForm: input.activeForm ?? null,
+            status: "pending",
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.tasks.set(id, task);
+        this.emit();
+        return task;
+    }
+    update(id, patch) {
+        const existing = this.tasks.get(id);
+        if (!existing) {
+            throw new Error(`Task ${id} not found.`);
+        }
+        const next = {
+            ...existing,
+            title: patch.title ?? existing.title,
+            description: patch.description !== undefined ? patch.description : existing.description,
+            activeForm: patch.activeForm !== undefined ? patch.activeForm : existing.activeForm,
+            status: patch.status ?? existing.status,
+            updatedAt: Date.now(),
+        };
+        this.tasks.set(id, next);
+        this.emit();
+        return next;
+    }
+    get(id) {
+        return this.tasks.get(id);
+    }
+    list(filter) {
+        const all = Array.from(this.tasks.values());
+        if (filter?.status)
+            return all.filter((t) => t.status === filter.status);
+        return all;
+    }
+    clear() {
+        this.tasks.clear();
+        this.counter = 0;
+        this.emit();
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    emit() {
+        const snapshot = this.list();
+        for (const listener of this.listeners) {
+            listener(snapshot);
+        }
+    }
+}
+//# sourceMappingURL=task-store.js.map

package/dist/tools/task-store.js.map

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

package/dist/tools/tasks.js

@@ -0,0 +1,131 @@
+import { Type } from "typebox";
+const StatusSchema = Type.Union([
+    Type.Literal("pending"),
+    Type.Literal("in_progress"),
+    Type.Literal("completed"),
+    Type.Literal("cancelled"),
+]);
+// ─── create_task ─────────────────────────────────────────────
+const CreateParams = Type.Object({
+    title: Type.String({
+        minLength: 1,
+        maxLength: 200,
+        description: "Short task name. Imperative form (e.g. 'Add OAuth refresh token').",
+    }),
+    description: Type.Optional(Type.String({ description: "Free-form longer description." })),
+    active_form: Type.Optional(Type.String({
+        description: "Verb-ing form for live display while task is in progress (e.g. 'Adding OAuth refresh token').",
+    })),
+});
+export function createCreateTask(ctx) {
+    return {
+        name: "create_task",
+        label: "New task",
+        description: "Add a task to the agent's checklist. Returns the task with an assigned id. Status starts as 'pending'.",
+        parameters: CreateParams,
+        executionMode: "sequential",
+        execute: async (_id, params) => {
+            const task = ctx.tasks.create({
+                title: params.title,
+                description: params.description ?? null,
+                activeForm: params.active_form ?? null,
+            });
+            return {
+                content: [{ type: "text", text: `Created ${task.id}: ${task.title}` }],
+                details: task,
+            };
+        },
+    };
+}
+// ─── update_task ─────────────────────────────────────────────
+const UpdateParams = Type.Object({
+    id: Type.String({ description: "Task id returned from create_task (e.g. 'task-3')." }),
+    status: Type.Optional(Type.Union([StatusSchema], {
+        description: "New status: pending | in_progress | completed | cancelled.",
+    })),
+    title: Type.Optional(Type.String({ minLength: 1, maxLength: 200 })),
+    description: Type.Optional(Type.String()),
+    active_form: Type.Optional(Type.String()),
+});
+export function createUpdateTask(ctx) {
+    return {
+        name: "update_task",
+        label: "Update task",
+        description: "Change a task's status or fields. Move tasks to 'in_progress' when you start them and 'completed' when done.",
+        parameters: UpdateParams,
+        executionMode: "sequential",
+        execute: async (_id, params) => {
+            const task = ctx.tasks.update(params.id, {
+                status: params.status,
+                title: params.title,
+                description: params.description,
+                activeForm: params.active_form,
+            });
+            return {
+                content: [{ type: "text", text: `${task.id} → ${task.status}: ${task.title}` }],
+                details: task,
+            };
+        },
+    };
+}
+// ─── list_tasks ──────────────────────────────────────────────
+const ListParams = Type.Object({
+    status: Type.Optional(Type.Union([StatusSchema], {
+        description: "Filter to one status. Omit to see all tasks.",
+    })),
+});
+export function createListTasks(ctx) {
+    return {
+        name: "list_tasks",
+        label: "Tasks",
+        description: "List all tasks, optionally filtered by status.",
+        parameters: ListParams,
+        executionMode: "parallel",
+        execute: async (_id, params) => {
+            const filter = {};
+            if (params.status)
+                filter.status = params.status;
+            const tasks = ctx.tasks.list(filter);
+            const text = tasks.length === 0
+                ? params.status
+                    ? `No tasks with status ${params.status}.`
+                    : "No tasks."
+                : tasks.map(formatLine).join("\n");
+            return {
+                content: [{ type: "text", text }],
+                details: { tasks, count: tasks.length },
+            };
+        },
+    };
+}
+// ─── get_task ────────────────────────────────────────────────
+const GetParams = Type.Object({
+    id: Type.String({ description: "Task id." }),
+});
+export function createGetTask(ctx) {
+    return {
+        name: "get_task",
+        label: "Get task",
+        description: "Fetch a single task by id. Errors if the id is unknown.",
+        parameters: GetParams,
+        executionMode: "parallel",
+        execute: async (_id, params) => {
+            const task = ctx.tasks.get(params.id);
+            if (!task)
+                throw new Error(`Task ${params.id} not found.`);
+            return {
+                content: [{ type: "text", text: formatLine(task) }],
+                details: task,
+            };
+        },
+    };
+}
+function formatLine(task) {
+    const tag = task.status === "in_progress" ? "▶" : task.status === "completed" ? "✓" : task.status === "cancelled" ? "✗" : "○";
+    return `${tag} ${task.id} ${task.title}${task.description ? ` — ${task.description}` : ""}`;
+}
+// ─── factory bundle ──────────────────────────────────────────
+export function createTaskTools(ctx) {
+    return [createCreateTask(ctx), createUpdateTask(ctx), createListTasks(ctx), createGetTask(ctx)];
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/tasks.js.map

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

package/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/dist/tools/web-fetch.js

@@ -0,0 +1,152 @@
+import { Type } from "typebox";
+const Params = Type.Object({
+    url: Type.String({
+        description: "Absolute http(s) URL.",
+    }),
+    method: Type.Optional(Type.Union([Type.Literal("GET"), Type.Literal("HEAD")], {
+        description: "GET (default) or HEAD.",
+    })),
+    headers: Type.Optional(Type.Record(Type.String(), Type.String(), {
+        description: "Extra request headers (e.g. Authorization, User-Agent).",
+    })),
+    timeout_ms: Type.Optional(Type.Integer({
+        minimum: 100,
+        maximum: 60_000,
+        description: "Abort after this many ms. Default 15000, max 60000.",
+    })),
+    max_bytes: Type.Optional(Type.Integer({
+        minimum: 1024,
+        maximum: 1_000_000,
+        description: "Cap on bytes returned. Default 100000, max 1000000.",
+    })),
+});
+const DEFAULT_TIMEOUT_MS = 15_000;
+const DEFAULT_MAX_BYTES = 100_000;
+const DESCRIPTION = `Fetch an http(s) URL and return the response body as text.
+
+Behavior:
+- GET by default; HEAD for header-only checks.
+- Default timeout 15s (max 60s); aborts cleanly on the agent's abort signal.
+- Body is decoded as UTF-8 and capped at 100 KB by default; truncation reported in details.
+- Redirects are followed automatically. The final URL is reported in details.
+- Errors (DNS, connect, TLS) bubble up with the underlying message — they do not retry.
+
+Use this for documentation/spec lookups when you have a URL. For discovery use web_search.`;
+export function createWebFetch(_ctx) {
+    return {
+        name: "web_fetch",
+        label: "Fetch",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "parallel",
+        execute: async (_id, params, signal) => {
+            validateUrl(params.url);
+            const method = params.method ?? "GET";
+            const timeoutMs = params.timeout_ms ?? DEFAULT_TIMEOUT_MS;
+            const maxBytes = params.max_bytes ?? DEFAULT_MAX_BYTES;
+            const startedAt = Date.now();
+            const controller = new AbortController();
+            const onUpstreamAbort = () => controller.abort();
+            signal?.addEventListener("abort", onUpstreamAbort);
+            const timer = setTimeout(() => controller.abort(new Error("timeout")), timeoutMs);
+            let response;
+            try {
+                response = await fetch(params.url, {
+                    method,
+                    headers: params.headers,
+                    redirect: "follow",
+                    signal: controller.signal,
+                });
+            }
+            catch (err) {
+                clearTimeout(timer);
+                signal?.removeEventListener("abort", onUpstreamAbort);
+                const reason = err instanceof Error ? err.message : String(err);
+                if (reason.toLowerCase().includes("timeout")) {
+                    throw new Error(`web_fetch timed out after ${Math.round(timeoutMs / 1000)}s.`);
+                }
+                throw new Error(`web_fetch failed: ${reason}`);
+            }
+            let body = "";
+            let truncated = false;
+            let bytes = 0;
+            if (method === "GET" && response.body) {
+                const reader = response.body.getReader();
+                const chunks = [];
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        bytes += value.byteLength;
+                        if (bytes > maxBytes) {
+                            truncated = true;
+                            const room = maxBytes - (bytes - value.byteLength);
+                            if (room > 0)
+                                chunks.push(value.subarray(0, room));
+                            controller.abort();
+                            break;
+                        }
+                        chunks.push(value);
+                    }
+                }
+                finally {
+                    try {
+                        reader.releaseLock();
+                    }
+                    catch {
+                        // already released
+                    }
+                    clearTimeout(timer);
+                    signal?.removeEventListener("abort", onUpstreamAbort);
+                }
+                body = Buffer.concat(chunks.map((c) => Buffer.from(c))).toString("utf8");
+            }
+            else {
+                clearTimeout(timer);
+                signal?.removeEventListener("abort", onUpstreamAbort);
+            }
+            const durationMs = Date.now() - startedAt;
+            const contentType = response.headers.get("content-type");
+            const summary = formatSummary(params.url, response, contentType, bytes, truncated, durationMs, body);
+            return {
+                content: [{ type: "text", text: summary }],
+                details: {
+                    url: params.url,
+                    finalUrl: response.url,
+                    status: response.status,
+                    statusText: response.statusText,
+                    contentType,
+                    bytes,
+                    truncated,
+                    durationMs,
+                },
+            };
+        },
+    };
+}
+function validateUrl(raw) {
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new Error(`Invalid URL: ${raw}`);
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`URL must be http or https; got ${parsed.protocol}`);
+    }
+}
+function formatSummary(url, response, contentType, bytes, truncated, durationMs, body) {
+    const lines = [];
+    const finalUrl = response.url && response.url !== url ? `\nFinal: ${response.url}` : "";
+    lines.push(`${response.status} ${response.statusText} (${durationMs}ms, ${bytes} bytes${truncated ? ", truncated" : ""})${finalUrl}`);
+    if (contentType)
+        lines.push(`Content-Type: ${contentType}`);
+    if (body) {
+        lines.push("");
+        lines.push(body);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

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

package/dist/tools/web-search.js

@@ -0,0 +1,169 @@
+import { Type } from "typebox";
+const Params = Type.Object({
+    query: Type.String({
+        minLength: 1,
+        maxLength: 500,
+        description: "Search query.",
+    }),
+    max_results: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 20,
+        description: "Number of results to return. Default 5, max 20.",
+    })),
+    timeout_ms: Type.Optional(Type.Integer({
+        minimum: 500,
+        maximum: 60_000,
+        description: "Abort the search after this many ms. Default 15000.",
+    })),
+});
+const DEFAULT_RESULTS = 5;
+const DEFAULT_TIMEOUT_MS = 15_000;
+const DESCRIPTION = `Search the web. Returns title + url + snippet for each result, formatted so the model can pick a URL and pass it to web_fetch.
+
+Provider auto-detected from env (highest-priority match wins):
+- TAVILY_API_KEY  → Tavily (recommended; free tier available)
+- BRAVE_API_KEY   → Brave Search
+- SEARXNG_URL     → self-hosted SearXNG instance
+
+If none are set, this tool errors with onboarding instructions instead of attempting an unauthenticated fallback. Default 5 results, max 20.`;
+export function createWebSearch(_ctx) {
+    return {
+        name: "web_search",
+        label: "Search",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "parallel",
+        execute: async (_id, params, signal) => {
+            const provider = pickProvider(process.env);
+            const max = params.max_results ?? DEFAULT_RESULTS;
+            const timeout = params.timeout_ms ?? DEFAULT_TIMEOUT_MS;
+            const controller = new AbortController();
+            const onUpstreamAbort = () => controller.abort();
+            signal?.addEventListener("abort", onUpstreamAbort);
+            const timer = setTimeout(() => controller.abort(new Error("timeout")), timeout);
+            const startedAt = Date.now();
+            let results;
+            try {
+                results = await provider.search(params.query, max, controller.signal);
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                if (controller.signal.aborted && !signal?.aborted) {
+                    throw new Error(`web_search timed out after ${Math.round(timeout / 1000)}s.`);
+                }
+                throw new Error(`web_search (${provider.name}) failed: ${reason}`);
+            }
+            finally {
+                clearTimeout(timer);
+                signal?.removeEventListener("abort", onUpstreamAbort);
+            }
+            const durationMs = Date.now() - startedAt;
+            return {
+                content: [{ type: "text", text: formatResults(provider.name, params.query, results) }],
+                details: { query: params.query, provider: provider.name, results, durationMs },
+            };
+        },
+    };
+}
+export function pickProvider(env) {
+    if (env.TAVILY_API_KEY) {
+        return tavilyProvider(env.TAVILY_API_KEY, env.TAVILY_BASE_URL);
+    }
+    if (env.BRAVE_API_KEY) {
+        return braveProvider(env.BRAVE_API_KEY, env.BRAVE_BASE_URL);
+    }
+    if (env.SEARXNG_URL) {
+        return searxngProvider(env.SEARXNG_URL);
+    }
+    throw new Error("web_search has no provider configured. Set one of TAVILY_API_KEY (recommended), BRAVE_API_KEY, " +
+        "or SEARXNG_URL. Tavily offers a free tier at https://tavily.com.");
+}
+function tavilyProvider(apiKey, baseUrl) {
+    const url = `${baseUrl ?? "https://api.tavily.com"}/search`;
+    return {
+        name: "tavily",
+        search: async (query, max, signal) => {
+            const res = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    api_key: apiKey,
+                    query,
+                    max_results: max,
+                    search_depth: "basic",
+                    include_answer: false,
+                }),
+                signal,
+            });
+            if (!res.ok)
+                throw new Error(`tavily ${res.status} ${res.statusText}`);
+            const json = (await res.json());
+            return (json.results ?? []).map((r) => ({
+                title: r.title,
+                url: r.url,
+                snippet: r.content,
+            }));
+        },
+    };
+}
+function braveProvider(apiKey, baseUrl) {
+    const url = baseUrl ?? "https://api.search.brave.com/res/v1/web/search";
+    return {
+        name: "brave",
+        search: async (query, max, signal) => {
+            const u = new URL(url);
+            u.searchParams.set("q", query);
+            u.searchParams.set("count", String(max));
+            const res = await fetch(u, {
+                headers: { "X-Subscription-Token": apiKey, Accept: "application/json" },
+                signal,
+            });
+            if (!res.ok)
+                throw new Error(`brave ${res.status} ${res.statusText}`);
+            const json = (await res.json());
+            return (json.web?.results ?? []).map((r) => ({
+                title: r.title,
+                url: r.url,
+                snippet: r.description,
+            }));
+        },
+    };
+}
+function searxngProvider(baseUrl) {
+    const root = baseUrl.replace(/\/+$/, "");
+    return {
+        name: "searxng",
+        search: async (query, max, signal) => {
+            const u = new URL(`${root}/search`);
+            u.searchParams.set("q", query);
+            u.searchParams.set("format", "json");
+            const res = await fetch(u, { signal });
+            if (!res.ok)
+                throw new Error(`searxng ${res.status} ${res.statusText}`);
+            const json = (await res.json());
+            return (json.results ?? []).slice(0, max).map((r) => ({
+                title: r.title,
+                url: r.url,
+                snippet: r.content ?? "",
+            }));
+        },
+    };
+}
+function formatResults(provider, query, results) {
+    if (results.length === 0) {
+        return `No results for "${query}" via ${provider}.`;
+    }
+    const lines = [`${results.length} results from ${provider} for "${query}":`, ""];
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        lines.push(`${i + 1}. ${r.title}`);
+        lines.push(`   ${r.url}`);
+        if (r.snippet) {
+            const trimmed = r.snippet.length > 300 ? `${r.snippet.slice(0, 300)}…` : r.snippet;
+            lines.push(`   ${trimmed}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+}
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

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

package/dist/tools/write-file.js

@@ -0,0 +1,70 @@
+import { statSync } from "node:fs";
+import { Type } from "typebox";
+import { atomicWrite, detectEol, pathExists, resolveInsideCwd, validateForOverwrite } from "./file-ops.js";
+const Params = Type.Object({
+    path: Type.String({
+        description: "File path (absolute or relative to the project root). Parent directories are created automatically.",
+    }),
+    content: Type.String({
+        description: "File contents. Line endings in the content are normalized to the file's existing style on overwrite.",
+    }),
+});
+const DESCRIPTION = `Create a new file or overwrite an existing one.
+
+Hard rules:
+- To OVERWRITE an existing file, you must read it with read_file first in the current turn. Otherwise this errors with "not read first".
+- If the file changed on disk between the last read and this write, this errors with "file unexpectedly modified" — read it again.
+- To CREATE a new file, no prior read is required. Parent directories are created.
+- On overwrite, BOM and line endings are preserved from the original file. On create, the encoding follows the supplied content (LF inferred from content; BOM inferred from a leading 0xEF 0xBB 0xBF in the supplied bytes).
+- File permissions are preserved on overwrite; new files default to 0644.
+
+Use edit_file when you only need to change part of a file — it's safer because it won't accidentally truncate context the model didn't fully read.`;
+export function createWriteFile(ctx) {
+    return {
+        name: "write_file",
+        label: "Write",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "sequential",
+        execute: async (_toolCallId, params) => {
+            const absPath = resolveInsideCwd(ctx.cwd, params.path);
+            const exists = pathExists(absPath);
+            let hasBOM = false;
+            let eol = detectEol(params.content);
+            let mode = 0o644;
+            if (exists) {
+                const snap = validateForOverwrite(absPath, ctx.fileStateCache);
+                hasBOM = snap.hasBOM;
+                eol = snap.eol;
+                mode = statSync(absPath).mode & 0o777;
+            }
+            else {
+                // Bare-bytes hint: a new file's content may already start with BOM characters.
+                if (params.content.charCodeAt(0) === 0xfeff) {
+                    hasBOM = true;
+                }
+            }
+            const written = atomicWrite(absPath, params.content, { hasBOM, eol, mode });
+            ctx.fileStateCache.record({
+                path: absPath,
+                content: params.content.charCodeAt(0) === 0xfeff ? params.content.slice(1) : params.content,
+                mtimeMs: written.mtimeMs,
+                size: written.size,
+                hasBOM,
+                eol,
+                isPartialView: false,
+                storedAt: Date.now(),
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: exists ? `Overwrote ${params.path} (${written.size} bytes).` : `Created ${params.path}.`,
+                    },
+                ],
+                details: { path: absPath, created: !exists, bytes: written.size },
+            };
+        },
+    };
+}
+//# sourceMappingURL=write-file.js.map