min-agent 0.5.0 → 0.6.0

package/dist/tools/search-serper.js

@@ -1,189 +0,0 @@
-import { loadConfig } from "../config.js";
-import { truncateToolOutput } from "../tool-output.js";
-import { LANGUAGE_RE, MAX_BODY_BYTES, VALID_TIME_RANGES, clamp, collapse, dedupeByUrl, emptyResponse, fetchJsonOutcome, formatResults, hostOf, isString, resolveMaxResults, } from "./web_search.js";
-const SERPER_KEY_ENV = "MIN_AGENT_SERPER_API_KEY";
-const SERPER_API = "https://google.serper.dev/search";
-const SERPER_TIMEOUT_MS = 35000;
-export const DEFAULT_SERPER_API_KEY = "7913c19ae7a80320771b843ddffa152c9162c9f2";
-/** Google's tbs time filter for each supported time_range value. */
-const TBS_BY_RANGE = {
-    day: "qdr:d",
-    week: "qdr:w",
-    month: "qdr:m",
-    year: "qdr:y",
-};
-function serperKey() {
-    const env = process.env[SERPER_KEY_ENV];
-    if (env?.trim())
-        return env.trim();
-    const configured = loadConfig().serperApiKey;
-    if (configured?.trim())
-        return configured.trim();
-    return DEFAULT_SERPER_API_KEY.trim();
-}
-function serperHint() {
-    return `Set your Serper API key via "serperApiKey" in ~/.min-agent/config.json or the ${SERPER_KEY_ENV} env var, or configure a SearXNG instance via "webSearchURL" / MIN_AGENT_SEARXNG_URL.`;
-}
-function asSerperResult(r) {
-    if (typeof r !== "object" || r === null)
-        return null;
-    const o = r;
-    if (!isString(o.link) || o.link.trim() === "")
-        return null;
-    return {
-        title: isString(o.title) ? o.title : "",
-        url: o.link,
-        content: isString(o.snippet) ? o.snippet : "",
-        engine: hostOf(o.link),
-        score: 0,
-        publishedDate: isString(o.date) ? o.date : "",
-        imgSrc: "",
-    };
-}
-function emptySerper() {
-    return { ...emptyResponse(), questions: [] };
-}
-function stringList(v, key) {
-    return (Array.isArray(v) ? v : [])
-        .map((item) => {
-        if (typeof item === "object" && item !== null) {
-            const rec = item;
-            if (isString(rec[key]))
-                return rec[key];
-        }
-        return "";
-    })
-        .filter((s) => s.trim() !== "");
-}
-function parseSerper(data) {
-    if (typeof data !== "object" || data === null)
-        return emptySerper();
-    const o = data;
-    const results = (Array.isArray(o.organic) ? o.organic : [])
-        .map(asSerperResult)
-        .filter((r) => r !== null);
-    const answers = [];
-    const ab = o.answerBox;
-    if (typeof ab === "object" && ab !== null) {
-        const rec = ab;
-        for (const key of ["answer", "snippet", "title"]) {
-            if (isString(rec[key]) && rec[key].trim()) {
-                answers.push(collapse(rec[key]));
-                break;
-            }
-        }
-    }
-    const suggestions = stringList(o.relatedSearches, "query");
-    const questions = stringList(o.peopleAlsoAsk, "question");
-    const infoboxes = [];
-    const kg = o.knowledgeGraph;
-    if (typeof kg === "object" && kg !== null) {
-        const rec = kg;
-        const title = isString(rec.title) ? rec.title : "";
-        const description = isString(rec.description) ? rec.description : "";
-        if (title || description)
-            infoboxes.push({ infobox: title, content: description });
-    }
-    return { results, answers, suggestions, corrections: [], infoboxes, unresponsive_engines: [], questions };
-}
-async function serperSearch(payload, apiKey) {
-    return fetchJsonOutcome(SERPER_API, {
-        method: "POST",
-        headers: {
-            "X-API-KEY": apiKey,
-            "Content-Type": "application/json",
-            Accept: "application/json",
-        },
-        body: JSON.stringify(payload),
-        signal: AbortSignal.timeout(SERPER_TIMEOUT_MS),
-    }, parseSerper);
-}
-function renderSerperFailure(o) {
-    const hint = serperHint();
-    switch (o.kind) {
-        case "network":
-            return `Search error: could not reach the Serper search API (${o.message}). This is not a problem with the query.`;
-        case "invalid-json":
-            if (o.bodyTooLarge) {
-                return `Search error: the search API response exceeded ${MAX_BODY_BYTES / 1024 / 1024} MB and could not be parsed. Narrow the query or request fewer results.`;
-            }
-            return `Search error: the search API returned a non-JSON response${o.sample ? ` (starts with: ${o.sample})` : ""}.`;
-        case "http": {
-            const detail = o.backendMessage ? ` Backend message: ${o.backendMessage}.` : "";
-            if (o.status === 429) {
-                return `Search error: the search API is rate-limiting (HTTP 429).${detail} Wait a few seconds before retrying.`;
-            }
-            if (o.status === 401 || o.status === 403) {
-                return `Search error: the search API rejected the API key (HTTP ${o.status}).${detail} ${hint}`;
-            }
-            if (o.status === 400 || o.status === 422) {
-                return `Search error: the search API rejected these parameters (HTTP ${o.status}).${detail} Fix the arguments and retry; retrying with the same values will fail again.`;
-            }
-            if (o.status >= 500) {
-                return `Search error: the search API failed with HTTP ${o.status}.${detail} It may be temporarily overloaded — retry once.`;
-            }
-            return `Search error: HTTP ${o.status} from the search API.${detail}`;
-        }
-    }
-}
-function buildSerperPayload(input, notes, maxResults) {
-    const payload = { q: input.query, num: maxResults };
-    const lang = (input.language ?? "").trim().toLowerCase();
-    if (lang) {
-        if (LANGUAGE_RE.test(lang) && lang !== "all") {
-            payload.hl = lang.replace("_", "-");
-        }
-        else {
-            notes.push(`ignored invalid language "${input.language}"; use a code like "zh", "en" or "zh-CN"`);
-        }
-    }
-    const range = (input.time_range ?? "").trim().toLowerCase();
-    if (range) {
-        if (VALID_TIME_RANGES.has(range))
-            payload.tbs = TBS_BY_RANGE[range];
-        else
-            notes.push(`ignored invalid time_range "${range}"; valid values: day, week, month, year`);
-    }
-    return payload;
-}
-export async function runSerper(input, query, notes) {
-    const apiKey = serperKey();
-    if (!apiKey)
-        return `Search error: no Serper API key configured. ${serperHint()}`;
-    const maxResults = resolveMaxResults(input.max_results, notes);
-    const payload = buildSerperPayload(input, notes, maxResults);
-    const outcome = await serperSearch(payload, apiKey);
-    if (outcome.kind !== "ok")
-        return renderSerperFailure(outcome);
-    const data = outcome.data;
-    const results = dedupeByUrl(data.results).slice(0, maxResults);
-    const noteBlock = notes.map((n) => `Note: ${n}`).join("\n");
-    if (results.length === 0) {
-        const parts = [`No search results found for "${query}".`];
-        if (noteBlock)
-            parts.push(noteBlock);
-        if (data.questions.length > 0)
-            parts.push(`Related questions: ${data.questions.slice(0, 5).join(" · ")}`);
-        if (data.suggestions.length > 0)
-            parts.push(`Related searches: ${data.suggestions.slice(0, 8).join(" · ")}`);
-        if (data.questions.length === 0 && data.suggestions.length === 0) {
-            parts.push("Try a different query or a broader wording.");
-        }
-        return parts.join("\n\n");
-    }
-    const sections = [];
-    if (noteBlock)
-        sections.push(noteBlock);
-    for (const a of data.answers)
-        sections.push(`Answer: ${collapse(a)}`);
-    for (const b of data.infoboxes) {
-        sections.push(`Infobox${b.infobox ? ` (${collapse(b.infobox)})` : ""}: ${clamp(collapse(b.content), 600)}`);
-    }
-    sections.push(`Found ${results.length} result${results.length === 1 ? "" : "s"} for "${query}":`);
-    sections.push(formatResults(results));
-    if (data.questions.length > 0)
-        sections.push(`Related questions: ${data.questions.slice(0, 5).join(" · ")}`);
-    if (data.suggestions.length > 0)
-        sections.push(`Related searches: ${data.suggestions.slice(0, 8).join(" · ")}`);
-    return truncateToolOutput(sections.join("\n\n"), { direction: "head" }).content;
-}

package/dist/tools/task.js

@@ -1,165 +0,0 @@
-import { tool, jsonSchema, streamText, stepCountIs } from "ai";
-import { resolveModel } from "../provider.js";
-import { createTools } from "./index.js";
-import { getMcpTools, getMcpCatalogTools } from "../mcp.js";
-import { attachSkills } from "../skills.js";
-import { loadPluginTools } from "../plugins.js";
-import { DoomLoopDetector } from "../doom-loop.js";
-import { log } from "../logger.js";
-import { getEffectiveConfig } from "../config.js";
-import { stripThinkingFromAssistantText } from "../assistant-stream.js";
-import { unwrapXmlSearchTags } from "../xml-search.js";
-import { truncateToolOutput } from "../tool-output.js";
-import { createTodoTool } from "./todo.js";
-const SUB_AGENT_MAX_STEPS = 15;
-function resolveSubAgentSteps(explicit) {
-    const configured = getEffectiveConfig().agent?.subAgentMaxSteps;
-    const value = explicit ?? configured ?? SUB_AGENT_MAX_STEPS;
-    return Number.isFinite(value) && value >= 1 ? Math.floor(value) : SUB_AGENT_MAX_STEPS;
-}
-function subAgentSystem() {
-    return `You are a focused sub-agent executing a specific task. Complete the task thoroughly and return a clear result.
-
-Rules:
-- Focus only on the assigned task
-- Be thorough but concise
-- Use tools as needed to complete the task
-- Return a clear summary of what you did and the result
-
-Working directory: ${process.cwd()}
-Platform: ${process.platform}
-Date: ${new Date().toDateString()}`;
-}
-let listener = null;
-export function setSubAgentListener(fn) {
-    listener = fn;
-}
-function logSub(line) {
-    if (!listener)
-        console.error(line);
-}
-export function createTaskTool(modelId, abortSignal, onUsage, context = {}) {
-    return tool({
-        description: `Launch a sub-agent to execute a task independently. The sub-agent has its own context and tools. Use this for:
-- Parallel execution: call multiple tasks at once for independent work
-- Context isolation: keep the main conversation clean while the sub-agent explores
-- Delegation: hand off well-defined subtasks (search, analysis, file operations)
-
-The sub-agent can read/write files, run commands, search, and use all available tools.
-Call multiple tasks in parallel when the work is independent.`,
-        inputSchema: jsonSchema({
-            type: "object",
-            properties: {
-                description: { type: "string", description: "Short description of the task (shown to user)" },
-                prompt: { type: "string", description: "Detailed instructions for the sub-agent" },
-            },
-            required: ["description", "prompt"],
-        }),
-        execute: async ({ description, prompt }, options) => {
-            const parentToolCallId = options?.toolCallId;
-            logSub(`\x1b[90m  ┌─ Sub-agent: ${description}\x1b[0m`);
-            try {
-                const result = await runSubAgent(prompt, modelId, abortSignal, parentToolCallId, context);
-                if (result.usage)
-                    onUsage?.(result.usage);
-                logSub(`\x1b[90m  └─ ✓ Done\x1b[0m`);
-                return truncateToolOutput(result.text, { direction: "tail" }).content;
-            }
-            catch (err) {
-                if (abortSignal?.aborted)
-                    return "Sub-agent cancelled by user.";
-                const message = err instanceof Error ? err.message : String(err);
-                log("error", `sub-agent failed: ${message}`);
-                logSub(`\x1b[90m  └─ ✗ Failed: ${message}\x1b[0m`);
-                return `Sub-agent error: ${message}`;
-            }
-        },
-    });
-}
-async function runSubAgent(prompt, modelId, abortSignal, parentToolCallId, context = {}) {
-    const model = resolveModel(modelId);
-    const builtinTools = createTools();
-    builtinTools.todo = createTodoTool({ silent: true });
-    const mcpTools = getMcpTools();
-    const catalogTools = getMcpCatalogTools();
-    const pluginTools = await loadPluginTools();
-    const allTools = { ...builtinTools, ...pluginTools, ...mcpTools, ...catalogTools };
-    const skillsPrompt = attachSkills(allTools);
-    // Remove task/explore tools from sub-agent to prevent infinite recursion
-    delete allTools.task;
-    delete allTools.explore;
-    const messages = [{ role: "user", content: prompt }];
-    // Sharing the parent guard means the child cannot restart the research budget.
-    const doomLoop = context.loopGuard ?? new DoomLoopDetector();
-    const maxSteps = resolveSubAgentSteps(context.maxSteps);
-    const controller = new AbortController();
-    const signal = abortSignal ? AbortSignal.any([abortSignal, controller.signal]) : controller.signal;
-    const result = streamText({
-        model,
-        system: skillsPrompt ? `${subAgentSystem()}\n\n${skillsPrompt}` : subAgentSystem(),
-        messages,
-        tools: allTools,
-        stopWhen: stepCountIs(maxSteps),
-        maxRetries: 2,
-        abortSignal: signal,
-        onError({ error }) {
-            log("warn", `sub-agent step failed (will retry): ${String(error)}`);
-        },
-    });
-    let assistantText = "";
-    for await (const event of result.fullStream) {
-        switch (event.type) {
-            case "text-delta":
-                assistantText += event.text;
-                break;
-            case "tool-call": {
-                const action = doomLoop.observe(event.toolName, event.input);
-                if (action === "halt" || action === "cap") {
-                    controller.abort();
-                    const note = action === "halt"
-                        ? "[Sub-agent stopped: repeated the same action too many times]"
-                        : "[Sub-agent stopped: too many web searches. Summarize what was found.]";
-                    return { text: unwrapXmlSearchTags(assistantText) + "\n\n" + note };
-                }
-                listener?.({ parentToolCallId, name: event.toolName, input: event.input, phase: "call" });
-                logSub(`\x1b[90m  │ ⚡ ${event.toolName}\x1b[0m`);
-                break;
-            }
-            case "tool-result": {
-                listener?.({
-                    parentToolCallId,
-                    name: event.toolName,
-                    output: event.output,
-                    phase: "result",
-                });
-                const action = doomLoop.observeResult(event.toolName, event.output);
-                if (action === "cap") {
-                    controller.abort();
-                    return {
-                        text: unwrapXmlSearchTags(assistantText) +
-                            "\n\n[Sub-agent stopped: research budget spent. Summarize what was found.]",
-                    };
-                }
-                if (context.shouldStop?.()) {
-                    log("warn", "sub-agent stopped: parent budget reached");
-                    controller.abort();
-                    return {
-                        text: unwrapXmlSearchTags(assistantText) + "\n\n[Sub-agent stopped: run budget reached]",
-                    };
-                }
-                break;
-            }
-            case "error":
-                log("error", `sub-agent stream error: ${String(event.error)}`);
-                controller.abort();
-                return { text: unwrapXmlSearchTags(assistantText) + `\n\n[Sub-agent error: ${event.error}]` };
-        }
-    }
-    const cleaned = unwrapXmlSearchTags(stripThinkingFromAssistantText(assistantText));
-    let usage;
-    try {
-        usage = await result.usage;
-    }
-    catch { }
-    return { text: cleaned || "(sub-agent produced no output)", usage };
-}

package/dist/tools/todo.js

@@ -1,213 +0,0 @@
-import { tool, jsonSchema } from "ai";
-import { isSyntheticMessage } from "../synthetic.js";
-export const TODO_STATUSES = ["pending", "in_progress", "done", "cancelled"];
-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");
-}
-const CHITCHAT_RE = /^(你好|您好|嗨|哈喽|哈罗|哈囉|在吗|在嗎|早上好|晚上好|早安|午安|hello|hi|hey|yo|sup|thanks|thankyou|thx|ty|谢谢|谢谢你|多谢|感谢|ok|okay|好的|收到)$/i;
-/** Greetings / acknowledgements are not a durable task. "你好，帮我修 bug" is. */
-export function isChitchatUserText(text) {
-    const stripped = text.trim().replace(/[\s\p{P}\p{S}\p{Emoji_Presentation}\p{Extended_Pictographic}]/gu, "");
-    return stripped.length === 0 || CHITCHAT_RE.test(stripped);
-}
-function durableGoal(text) {
-    const trimmed = text.trim();
-    if (!trimmed || isChitchatUserText(trimmed))
-        return undefined;
-    return trimmed.slice(0, GOAL_MAX_CHARS);
-}
-/** Keep the first real user request so compaction cannot drop the original goal. */
-export function captureGoal(state, messages) {
-    if (state.goal.trim() && !isChitchatUserText(state.goal))
-        return;
-    for (const msg of messages) {
-        if (msg.role !== "user")
-            continue;
-        if (isSyntheticMessage(msg))
-            continue;
-        const goal = durableGoal(messageText(msg));
-        if (!goal)
-            continue;
-        state.goal = goal;
-        return;
-    }
-}
-export function formatTaskStatePrompt(state) {
-    const goal = state.goal.trim() && !isChitchatUserText(state.goal) ? state.goal : "";
-    if (!goal && state.todos.length === 0)
-        return "";
-    const icons = {
-        pending: "pending",
-        in_progress: "in_progress",
-        done: "done",
-        cancelled: "cancelled",
-    };
-    const lines = [
-        "## Current Task",
-        "This block tracks progress for the current user request. It is not a reason to start extra work.",
-        "If the task list is missing or empty, there is no pending work to resume. Follow the current user message only. Keep the list accurate with the todo tool.",
-    ];
-    if (goal) {
-        lines.push("", "### Original goal", 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;
-    const store = opts?.store ?? emptyTaskState();
-    const formatTodos = () => {
-        if (store.todos.length === 0)
-            return "No tasks.";
-        const icons = {
-            pending: "○",
-            in_progress: "◐",
-            done: "●",
-            cancelled: "✕",
-        };
-        return store.todos.map((t) => `  ${icons[t.status]} #${t.id} ${t.text}`).join("\n");
-    };
-    const printTodos = () => {
-        if (silent || store.todos.length === 0)
-            return;
-        console.log(`\x1b[90m  ┌─ Tasks${"─".repeat(36)}\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" : "";
-            console.log(`\x1b[90m  │\x1b[0m ${icon} ${dim}#${t.id} ${t.text}${reset}`);
-        }
-        console.log(`\x1b[90m  └${"─".repeat(44)}\x1b[0m`);
-    };
-    return tool({
-        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
-
-To create new tasks: provide items with "text" and optionally "status" (defaults to "pending").
-To update existing tasks: provide items with "id" and "status".
-You can mix creates and updates in one call.`,
-        inputSchema: jsonSchema({
-            type: "object",
-            properties: {
-                todos: {
-                    type: "array",
-                    description: "List of tasks to create or update",
-                    items: {
-                        type: "object",
-                        properties: {
-                            text: { type: "string", description: "Task description (for new tasks)" },
-                            status: { type: "string", description: "Status: pending, in_progress, done, cancelled" },
-                            id: { type: "number", description: "Task ID (for updating existing tasks)" },
-                        },
-                    },
-                },
-            },
-            required: ["todos"],
-        }),
-        execute: async ({ todos: items }) => {
-            const errors = [];
-            for (const item of items) {
-                if (item.id != null) {
-                    const existing = store.todos.find((t) => t.id === item.id);
-                    if (!existing) {
-                        errors.push(`task #${item.id} not found`);
-                        continue;
-                    }
-                    if (item.status) {
-                        if (!TODO_STATUSES.includes(item.status)) {
-                            errors.push(`invalid status "${item.status}" for task #${item.id}`);
-                            continue;
-                        }
-                        existing.status = item.status;
-                    }
-                    if (item.text)
-                        existing.text = item.text;
-                }
-                else if (item.text) {
-                    store.todos.push({
-                        id: store.nextId++,
-                        text: item.text,
-                        status: TODO_STATUSES.includes(item.status) ? item.status : "pending",
-                    });
-                }
-                else {
-                    errors.push("item needs either an id (update) or text (create)");
-                }
-            }
-            printTodos();
-            return errors.length > 0 ? `${formatTodos()}\n\nWarnings: ${errors.join("; ")}` : formatTodos();
-        },
-    });
-}