agent-from-zero 0.34.2 → 0.35.0

package/dist/effort.js

@@ -0,0 +1,81 @@
+import { CONFIG } from "./config.js";
+const selections = new Map();
+const keyFor = (model) => `${CONFIG.baseURL}\n${model}`;
+export function effortProfile(model) {
+    const configured = CONFIG.effortProfiles[model];
+    if (configured) {
+        if (!Array.isArray(configured.levels) || !configured.levels.every((v) => typeof v === "string" && /^[a-z]+$/.test(v) && v !== "default")
+            || !["reasoning_effort", "deepseek"].includes(configured.parameter))
+            return undefined;
+        return configured;
+    }
+    let host = "";
+    try {
+        host = new URL(CONFIG.baseURL).hostname;
+    }
+    catch {
+        return undefined;
+    }
+    if (host === "api.deepseek.com" && ["deepseek-flash", "deepseek-v4-pro"].includes(model)) {
+        return { levels: ["none", "low", "high", "max"], parameter: "deepseek", default: "high" };
+    }
+    if (host === "api.openai.com") {
+        const name = model.replace(/-\d{4}-\d{2}-\d{2}$/, "");
+        const levels = {
+            "gpt-5": ["minimal", "low", "medium", "high"],
+            "gpt-5-mini": ["minimal", "low", "medium", "high"],
+            "gpt-5-nano": ["minimal", "low", "medium", "high"],
+            "gpt-5.1": ["none", "low", "medium", "high"],
+            "gpt-5.2": ["none", "low", "medium", "high", "xhigh"],
+            "o3": ["low", "medium", "high"], "o3-mini": ["low", "medium", "high"], "o4-mini": ["low", "medium", "high"],
+        };
+        if (levels[name])
+            return { levels: levels[name], parameter: "reasoning_effort" };
+    }
+    return undefined;
+}
+export function selectedEffort(model) {
+    const selected = selections.get(keyFor(model));
+    return selected && effortProfile(model)?.levels.includes(selected) ? selected : "default";
+}
+export function effortMenu(model) {
+    const profile = effortProfile(model);
+    const current = selectedEffort(model);
+    const values = profile?.levels.length ? ["default", ...profile.levels] : [];
+    return {
+        header: values.length ? `effort — ${model} · current: ${current}`
+            : `Effort capabilities unknown or not configurable for ${model} at this endpoint. Configure effortProfiles for a custom gateway.`,
+        values,
+        labels: values.map((v) => `${v}${v === "default" ? ` (provider default${profile?.default ? `: ${profile.default}` : ""})` : v === "none" ? " (thinking off)" : ""}${v === current ? " ✓" : ""}`),
+    };
+}
+export function setEffort(model, value) {
+    if (value === "default") {
+        selections.delete(keyFor(model));
+        return `effort: ${model} → provider default`;
+    }
+    const menu = effortMenu(model);
+    if (!menu.values.includes(value))
+        return menu.values.length ? `Unsupported effort '${value}' for ${model}. Choose: ${menu.values.join(", ")}` : menu.header;
+    selections.set(keyFor(model), value);
+    return `effort: ${model} → ${value} (this session)`;
+}
+export function effortParameters(model) {
+    const value = selectedEffort(model);
+    if (value === "default")
+        return {};
+    if (effortProfile(model)?.parameter === "deepseek") {
+        return value === "none" ? { thinking: { type: "disabled" } }
+            : { thinking: { type: "enabled" }, reasoning_effort: value };
+    }
+    return { reasoning_effort: value };
+}
+export function retainsReasoning(model) { return effortProfile(model)?.parameter === "deepseek"; }
+export function effortMessages(model, messages) {
+    return messages.map((message) => {
+        if (message.role !== "assistant")
+            return message;
+        const { reasoning_content, ...plain } = message;
+        return retainsReasoning(model) ? { ...plain, reasoning_content: reasoning_content ?? "" } : plain;
+    });
+}

package/dist/follow-up.js

@@ -0,0 +1,22 @@
+// Frontends enqueue; only the lead loop consumes, at a complete tool boundary.
+// No terminal, provider or permission policy lives in this queue.
+export class FollowUpQueue {
+    changed;
+    messages = [];
+    constructor(changed = () => { }) {
+        this.changed = changed;
+    }
+    get size() { return this.messages.length; }
+    get pending() { return this.messages; }
+    enqueue(message) {
+        this.messages.push(message);
+        this.changed();
+    }
+    drain() {
+        const messages = this.messages;
+        this.messages = [];
+        if (messages.length)
+            this.changed();
+        return messages;
+    }
+}

package/dist/form.js

@@ -1,8 +1,8 @@
 import chalk from "chalk"; // rendering only
-// The rows are a flat list: every option of every question, then one submit row.
-// rowCount = total options + 1. The cursor walks this flat list.
+// The cursor walks a flat list of options. Multiple questions add a submit row;
+// with one question, explicitly choosing an option submits it immediately.
 export function formRowCount(questions) {
-    return questions.reduce((n, q) => n + q.options.length, 0) + 1; // +1 for "Submit"
+    return questions.reduce((n, q) => n + q.options.length, 0) + (questions.length > 1 ? 1 : 0);
 }
 // Map a flat cursor to either a question/option, or the submit row.
 export function rowAt(questions, cursor) {
@@ -43,7 +43,7 @@ export function reduceForm(questions, state, action) {
     }
     const selections = state.selections.slice();
     selections[row.q] = row.opt; // set this question's answer (single-select)
-    return { state: { ...state, selections } };
+    return { state: { ...state, selections }, ...(questions.length === 1 ? { done: true } : {}) };
 }
 // Turn a completed form into question→answer pairs for the model.
 export function collectAnswers(questions, state) {
@@ -71,8 +71,10 @@ export function renderForm(questions, state) {
     const onSubmit = state.cursor === flat; // the submit row is last
     const allAnswered = state.selections.every((s) => s >= 0);
     const submitText = allAnswered ? "▶ Submit answers" : "▶ Submit answers (answer every question first)";
-    lines.push(onSubmit ? chalk.green.bold(`❯ ${submitText}`) : chalk.dim(`  ${submitText}`));
-    lines.push("");
+    if (questions.length > 1) {
+        lines.push(onSubmit ? chalk.green.bold(`❯ ${submitText}`) : chalk.dim(`  ${submitText}`));
+        lines.push("");
+    }
     lines.push(FORM_HINT);
     return lines.join("\n");
 }

package/dist/images.js

@@ -0,0 +1,43 @@
+import { systemClipboard } from "./clipboard.js";
+export const MAX_IMAGES = 4;
+export const MAX_IMAGE_BYTES = 5 * 1024 * 1024;
+export const imageLabel = (id) => `[Image #${id}]`;
+export function imageFromBytes(data, id) {
+    if (data.length > MAX_IMAGE_BYTES)
+        throw new Error("Image exceeds 5 MB. Copy a smaller image.");
+    let mime;
+    if (data.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])))
+        mime = "image/png";
+    else if (data[0] === 255 && data[1] === 216 && data[2] === 255)
+        mime = "image/jpeg";
+    else if (["GIF87a", "GIF89a"].includes(data.subarray(0, 6).toString()))
+        mime = "image/gif";
+    else if (data.subarray(0, 4).toString() === "RIFF" && data.subarray(8, 12).toString() === "WEBP")
+        mime = "image/webp";
+    else
+        throw new Error("Clipboard does not contain a supported PNG, JPEG, GIF or WebP image.");
+    return { id, dataUrl: `data:${mime};base64,${data.toString("base64")}` };
+}
+// UI and attachment handling depend on this interface, never on an OS API.
+export async function readClipboard(id, source = systemClipboard()) {
+    const content = await source.read();
+    return content.image ? { image: imageFromBytes(content.image, id) } : { text: content.text ?? "" };
+}
+// The numbered text labels stay next to their image parts so multiple images
+// can be referenced unambiguously. Plain text remains a plain text message.
+export function userContent(text, images) {
+    if (!images.length)
+        return text;
+    return [
+        { type: "text", text },
+        ...images.flatMap((image) => [
+            { type: "text", text: imageLabel(image.id) },
+            { type: "image_url", image_url: { url: image.dataUrl } },
+        ]),
+    ];
+}
+// Deleting a label removes its attachment too; raw image bytes never enter
+// the editable buffer, terminal transcript, title generation or auto judge.
+export function imagesInInput(text, images) {
+    return images.filter((image) => text.includes(imageLabel(image.id)));
+}

package/dist/ink/activity.js

@@ -0,0 +1,62 @@
+import { stripVTControlCharacters } from "node:util";
+import wrapAnsi from "wrap-ansi";
+import { formatElapsed } from "../ui.js";
+function plain(text) {
+    return stripVTControlCharacters(text).replace(/[\x00-\x08\x0b-\x1f\x7f]/g, "");
+}
+function oneLine(text) { return plain(text).replace(/\s+/g, " ").trim().slice(0, 180); }
+function title(call) {
+    const labels = {
+        read_file: "Read", search: "Search", run_bash: "Run", run_bash_background: "Start background task",
+        bash_output: "Check background task", write_file: "Write", edit_file: "Edit",
+    };
+    let target = "";
+    try {
+        const args = JSON.parse(call.args ?? "{}");
+        target = [call.name === "search" ? args.pattern : undefined, args.path, args.command, args.task_id].find((v) => typeof v === "string") ?? "";
+    }
+    catch { /* malformed input is shown in full in the details */ }
+    return oneLine(`${labels[call.name ?? ""] ?? call.name ?? "Tool"}${target ? ` (${target})` : ""}`);
+}
+// Consecutive calls of the same type share one card. Polling 100 times still
+// takes two lines; only the most recent groups occupy the transient viewport.
+export function summarizeActivity(calls, now = Date.now(), limit = 2) {
+    const groups = [];
+    for (const call of calls) {
+        const previous = groups.at(-1);
+        if (previous && previous[0].name === call.name)
+            previous.push(call);
+        else
+            groups.push([call]);
+    }
+    return groups.slice(-limit).map((group) => {
+        const last = group.at(-1);
+        const running = group.some((c) => c.endedAt === undefined);
+        const failed = group.some((c) => /^\[(?:error|permission|hook)\]/.test(c.result ?? ""));
+        const completed = group.filter((c) => c.endedAt !== undefined).length;
+        const duration = formatElapsed((running ? now : Math.max(...group.map((c) => c.endedAt))) - group[0].startedAt);
+        let result = last.result === undefined ? "In progress" : "Completed";
+        if (last.result !== undefined) {
+            if (/^\[(?:error|permission|hook)\]/.test(last.result))
+                result = oneLine(last.result);
+            else if (last.name === "read_file")
+                result = `Read ${last.result === "(empty file)" ? 0 : last.result.split("\n").length} lines`;
+            else if (last.name === "search")
+                result = last.result.startsWith("No matches.") ? "No matches" : `Found ${last.result.split("\n").filter((line) => /:\d+:/.test(line)).length} matches`;
+            else
+                result = oneLine(last.result.split("\n")[0]) || "Completed (no output)";
+        }
+        const count = group.length > 1 ? `${completed}/${group.length} calls · ` : "";
+        return { title: title(last), detail: `${count}${result} · ${duration}${failed ? " · needs attention" : ""}`, running, failed };
+    });
+}
+// Page from the end so opening a trace shows the latest action. Wrapping before
+// slicing bounds physical terminal rows, including CJK and long JSON strings.
+export function detailPage(text, page, rows, columns) {
+    const height = Math.max(1, rows);
+    const lines = wrapAnsi(plain(text), Math.max(1, columns), { hard: true, trim: false }).split("\n");
+    const pages = Math.max(1, Math.ceil(lines.length / height));
+    const selected = Math.max(0, Math.min(page, pages - 1));
+    const end = lines.length - selected * height;
+    return { text: lines.slice(Math.max(0, end - height), end).join("\n"), page: selected, pages };
+}

package/dist/ink/agents.js

@@ -0,0 +1,24 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { formatElapsed, formatTokens } from "../ui.js";
+// Use stable IDs so a newly spawned worker cannot move keyboard focus.
+export function moveAgentFocus(ids, current, delta) {
+    const index = current === null ? -1 : ids.indexOf(current);
+    const next = index + delta;
+    return next < 0 ? null : ids[Math.min(next, ids.length - 1)] ?? null;
+}
+export function AgentList({ agents, focus, viewing, mainBusy, maxRows = 5 }) {
+    if (!agents.length)
+        return null;
+    const rows = [{ id: "main", name: "main", description: "", right: mainBusy ? "working" : "idle", failed: false }, ...agents.map((a) => ({
+            id: a.id, name: a.name, description: a.description, failed: a.status === "failed",
+            right: `${a.status === "running" ? a.activity : a.status} · ${formatElapsed(a.elapsedMs)} · ↓ ${a.estimated ? "~" : ""}${formatTokens(a.tokens)} tokens`,
+        }))];
+    const selected = Math.max(0, rows.findIndex((r) => r.id === (focus ?? viewing ?? "main")));
+    const start = Math.max(0, Math.min(selected - maxRows + 1, rows.length - maxRows));
+    return _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["agents \u00B7 Tab/\u2190 select \u00B7 \u2191\u2193 switch \u00B7 Enter view \u00B7 Esc back", rows.length > maxRows ? ` · ${start + 1}–${Math.min(rows.length, start + maxRows)}/${rows.length}` : ""] }), rows.slice(start, start + maxRows).map((row) => {
+                const highlighted = focus === row.id;
+                const active = (viewing ?? "main") === row.id;
+                return _jsxs(Box, { children: [_jsx(Box, { flexGrow: 1, flexShrink: 1, minWidth: 0, children: _jsxs(Text, { wrap: "truncate-end", color: highlighted ? "cyan" : row.failed ? "yellow" : undefined, bold: active || highlighted, dimColor: !active && !highlighted, children: [highlighted ? "❯" : active ? "●" : "○", " ", row.name, row.description ? ` · ${row.description}` : ""] }) }), _jsx(Box, { flexShrink: 0, marginLeft: 1, children: _jsx(Text, { dimColor: true, color: row.failed ? "yellow" : undefined, children: row.right }) })] }, row.id);
+            })] });
+}