min-agent 0.3.0 → 0.4.0

package/dist/tools/todo.js

@@ -1,12 +1,111 @@
 import { tool, jsonSchema } from "ai";
+import { isSyntheticMessage } from "../synthetic.js";
 export const TODO_STATUSES = ["pending", "in_progress", "done", "cancelled"];
-/** Create an isolated todo tool for one agent run. */
+const GOAL_MAX_CHARS = 4000;
+export function emptyTaskState() {
+    return { goal: "", todos: [], nextId: 1 };
+}
+export function resetTaskState(state) {
+    state.goal = "";
+    state.todos.length = 0;
+    state.nextId = 1;
+}
+export function copyTaskState(from, into) {
+    if (!from) {
+        resetTaskState(into);
+        return;
+    }
+    into.goal = from.goal;
+    into.todos = from.todos.map((t) => ({ ...t }));
+    into.nextId = from.nextId;
+}
+function isTodoStatus(value) {
+    return typeof value === "string" && TODO_STATUSES.includes(value);
+}
+export function parseTaskState(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const rec = raw;
+    const todos = [];
+    if (Array.isArray(rec.todos)) {
+        for (const item of rec.todos) {
+            if (!item || typeof item !== "object")
+                continue;
+            const t = item;
+            if (typeof t.id !== "number" || typeof t.text !== "string")
+                continue;
+            todos.push({
+                id: t.id,
+                text: t.text,
+                status: isTodoStatus(t.status) ? t.status : "pending",
+            });
+        }
+    }
+    const maxId = todos.reduce((m, t) => Math.max(m, t.id), 0);
+    const nextId = typeof rec.nextId === "number" && Number.isFinite(rec.nextId) && rec.nextId > maxId
+        ? Math.floor(rec.nextId)
+        : maxId + 1;
+    return {
+        goal: typeof rec.goal === "string" ? rec.goal : "",
+        todos,
+        nextId,
+    };
+}
+function messageText(msg) {
+    if (typeof msg.content === "string")
+        return msg.content;
+    if (!Array.isArray(msg.content))
+        return "";
+    return msg.content
+        .filter((p) => p.type === "text" && typeof p.text === "string")
+        .map((p) => p.text)
+        .join("\n");
+}
+/** Keep the first real user request so compaction cannot drop the original goal. */
+export function captureGoal(state, messages) {
+    if (state.goal.trim())
+        return;
+    for (const msg of messages) {
+        if (msg.role !== "user")
+            continue;
+        if (isSyntheticMessage(msg))
+            continue;
+        const text = messageText(msg).trim();
+        if (!text)
+            continue;
+        state.goal = text.slice(0, GOAL_MAX_CHARS);
+        return;
+    }
+}
+export function formatTaskStatePrompt(state) {
+    if (!state.goal && state.todos.length === 0)
+        return "";
+    const icons = {
+        pending: "pending",
+        in_progress: "in_progress",
+        done: "done",
+        cancelled: "cancelled",
+    };
+    const lines = [
+        "## Current Task",
+        "This block is the durable task state. It survives context compaction. Keep it accurate with the todo tool.",
+    ];
+    if (state.goal) {
+        lines.push("", "### Original goal", state.goal);
+    }
+    if (state.todos.length > 0) {
+        lines.push("", "### Task list");
+        for (const t of state.todos) {
+            lines.push(`- [${icons[t.status]}] #${t.id} ${t.text}`);
+        }
+    }
+    return lines.join("\n");
+}
 export function createTodoTool(opts) {
     const silent = opts?.silent ?? false;
-    let todos = [];
-    let nextId = 1;
+    const store = opts?.store ?? emptyTaskState();
     const formatTodos = () => {
-        if (todos.length === 0)
+        if (store.todos.length === 0)
             return "No tasks.";
         const icons = {
             pending: "○",
@@ -14,18 +113,19 @@ export function createTodoTool(opts) {
             done: "●",
             cancelled: "✕",
         };
-        return todos
-            .map((t) => `  ${icons[t.status]} #${t.id} ${t.text}`)
-            .join("\n");
+        return store.todos.map((t) => `  ${icons[t.status]} #${t.id} ${t.text}`).join("\n");
     };
     const printTodos = () => {
-        if (silent || todos.length === 0)
+        if (silent || store.todos.length === 0)
             return;
         console.log(`\x1b[90m  ┌─ Tasks${"─".repeat(36)}\x1b[0m`);
-        for (const t of todos) {
-            const icon = t.status === "done" ? "\x1b[32m●\x1b[0m"
-                : t.status === "in_progress" ? "\x1b[33m◐\x1b[0m"
-                    : t.status === "cancelled" ? "\x1b[90m✕\x1b[0m"
+        for (const t of store.todos) {
+            const icon = t.status === "done"
+                ? "\x1b[32m●\x1b[0m"
+                : t.status === "in_progress"
+                    ? "\x1b[33m◐\x1b[0m"
+                    : t.status === "cancelled"
+                        ? "\x1b[90m✕\x1b[0m"
                         : "\x1b[90m○\x1b[0m";
             const dim = t.status === "done" || t.status === "cancelled" ? "\x1b[90m" : "";
             const reset = dim ? "\x1b[0m" : "";
@@ -34,8 +134,9 @@ export function createTodoTool(opts) {
         console.log(`\x1b[90m  └${"─".repeat(44)}\x1b[0m`);
     };
     return tool({
-        description: `Create or update tasks to track progress. Use this FREQUENTLY to:
-- Plan multi-step work by creating tasks upfront
+        description: `Create or update tasks to track progress. The list persists across context compaction and auto-continue. Use this FREQUENTLY to:
+- Plan multi-step work by creating tasks upfront (research, then the deliverable)
+- Mark research tasks done before more searching — then write the output
 - Mark tasks as in_progress when starting them
 - Mark tasks as done when completed
 - Give the user visibility into your progress
@@ -65,7 +166,7 @@ You can mix creates and updates in one call.`,
             const errors = [];
             for (const item of items) {
                 if (item.id != null) {
-                    const existing = todos.find((t) => t.id === item.id);
+                    const existing = store.todos.find((t) => t.id === item.id);
                     if (!existing) {
                         errors.push(`task #${item.id} not found`);
                         continue;
@@ -77,10 +178,12 @@ You can mix creates and updates in one call.`,
                         }
                         existing.status = item.status;
                     }
+                    if (item.text)
+                        existing.text = item.text;
                 }
                 else if (item.text) {
-                    todos.push({
-                        id: nextId++,
+                    store.todos.push({
+                        id: store.nextId++,
                         text: item.text,
                         status: TODO_STATUSES.includes(item.status) ? item.status : "pending",
                     });
@@ -94,5 +197,3 @@ You can mix creates and updates in one call.`,
         },
     });
 }
-/** Shared placeholder — callers in code mode replace it with a per-run instance. */
-export const todoTool = createTodoTool();

package/dist/tools/web_fetch.js

@@ -3,6 +3,7 @@ import { truncateToolOutput } from "../tool-output.js";
 import { assertSafeUrl, readBodyLimited } from "../http.js";
 import { loadConfig } from "../config.js";
 import { configHint, describeFetchError, resolveBackendBase } from "./backend.js";
+import { getEffectiveSandboxPolicy, networkDeniedMessage } from "../sandbox.js";
 export const FIRECRAWL_BACKEND = {
     envName: "MIN_AGENT_FIRECRAWL_URL",
     configKey: "webFetchURL",
@@ -13,7 +14,7 @@ const DIRECT_TIMEOUT_MS = 8000;
 const SCRAPE_TIMEOUT_MS = 35000;
 const BROWSER_UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
 export const webFetchTool = tool({
-    description: "Fetch content from a URL. Use this to access web pages, APIs, or any HTTP resource. Returns the response body as text, or markdown for HTML pages (JavaScript-rendered pages go through a scrape backend).",
+    description: "Fetch content from a URL. Use this to access web pages, APIs, or any HTTP resource. Returns the response body as text, or markdown for HTML pages (JavaScript-rendered pages go through a scrape backend). Do not re-fetch URLs you already have; extract what you need and produce the user's deliverable.",
     inputSchema: jsonSchema({
         type: "object",
         properties: {
@@ -23,6 +24,8 @@ export const webFetchTool = tool({
         required: ["url"],
     }),
     execute: async ({ url, method }) => {
+        if (getEffectiveSandboxPolicy().network === "deny")
+            return `Error: ${networkDeniedMessage()}`;
         const target = (url ?? "").trim();
         if (!target)
             return 'Error: "url" must be a non-empty string.';
@@ -160,13 +163,18 @@ async function firecrawlFetch(url) {
     catch {
         return {
             kind: "unavailable",
-            reason: response.ok ? "the scrape backend returned a non-JSON response" : `HTTP ${response.status} from the scrape backend`,
+            reason: response.ok
+                ? "the scrape backend returned a non-JSON response"
+                : `HTTP ${response.status} from the scrape backend`,
         };
     }
     const record = typeof data === "object" && data !== null ? data : {};
     if (!response.ok) {
         const message = typeof record.error === "string" ? record.error : response.statusText;
-        return { kind: "unavailable", reason: `HTTP ${response.status} from the scrape backend${message ? ` (${message})` : ""}` };
+        return {
+            kind: "unavailable",
+            reason: `HTTP ${response.status} from the scrape backend${message ? ` (${message})` : ""}`,
+        };
     }
     const payload = typeof record.data === "object" && record.data !== null ? record.data : {};
     const markdown = typeof payload.markdown === "string" ? payload.markdown : typeof payload.content === "string" ? payload.content : "";