@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/runtime/adapter/tool/builtin-middleware-tools.js

@@ -1,627 +1,6 @@
-import path from "node:path";
-import { z } from "zod";
-import { isSandboxBackend } from "deepagents";
-import { isRecord } from "../../../utils/object.js";
-import { formatBuiltinTodoSnapshot, summarizeBuiltinWriteTodosArgs, truncateLines } from "../runtime-adapter-support.js";
-import { maybePersistLargeToolOutput, resolveToolRuntimeContext } from "./tool-output-artifacts.js";
-function buildTaskToolDescription(subagents) {
-    const lines = [
-        "Delegate a bounded task to the subagent whose declared description best matches the task.",
-        "Use this only when a subagent is a better fit than the current agent. Set subagent_type to exactly one listed subagent name.",
-    ];
-    const available = (subagents ?? [])
-        .filter((subagent) => subagent.name.trim().length > 0)
-        .map((subagent) => {
-        const description = subagent.description.trim() || "No description provided.";
-        return `- ${subagent.name}: ${description}`;
-    });
-    return available.length > 0
-        ? [...lines, "", "Available subagents:", ...available].join("\n")
-        : lines.join(" ");
-}
-function buildTaskToolSchema(subagents) {
-    const names = (subagents ?? [])
-        .map((subagent) => subagent.name.trim())
-        .filter((name) => name.length > 0);
-    const subagentTypeSchema = names.length > 0
-        ? z.enum(names)
-        : z.string();
-    return z.object({
-        description: z.string().describe("Concrete bounded task for the selected subagent to perform."),
-        subagent_type: subagentTypeSchema.describe("Exact name of the selected subagent."),
-    }).passthrough();
-}
-export const BUILTIN_MIDDLEWARE_TOOL_DESCRIPTORS = [
-    { name: "write_todos", description: "Create and update the runtime todo board for multi-step work." },
-    { name: "read_todos", description: "Read the current runtime todo board." },
-    { name: "ls", description: "List files in a directory." },
-    { name: "read_file", description: "Read a file from the workspace filesystem." },
-    { name: "write_file", description: "Write a file in the workspace filesystem." },
-    { name: "edit_file", description: "Replace exact text inside a workspace file." },
-    { name: "glob", description: "Find files matching a glob pattern." },
-    { name: "grep", description: "Search for text across workspace files." },
-    { name: "execute", description: "Run a shell command in the workspace sandbox." },
-    { name: "fetch_url", description: "Fetch a URL and return the response body." },
-    { name: "http_request", description: "Send a structured HTTP request." },
-    { name: "send_message", description: "Send a message through the configured backend." },
-    { name: "request_approval", description: "Request an approval decision from the runtime." },
-    { name: "schedule_task", description: "Create, inspect, update, list, and delete system-level scheduled tasks." },
-    { name: "task", description: "Delegate a bounded task to a subagent." },
-];
-export function filterBuiltinMiddlewareToolDescriptors(options) {
-    const modelExposedNames = new Set([
-        "fetch_url",
-        "http_request",
-        "send_message",
-        "request_approval",
-        "schedule_task",
-    ]);
-    const allowedModelExposedNames = Array.isArray(options?.modelExposed)
-        ? new Set(options.modelExposed)
-        : undefined;
-    return BUILTIN_MIDDLEWARE_TOOL_DESCRIPTORS.filter((descriptor) => {
-        if (options?.todos === false
-            && (descriptor.name === "write_todos" || descriptor.name === "read_todos")) {
-            return false;
-        }
-        if (options?.filesystem === false
-            && [
-                "ls",
-                "read_file",
-                "write_file",
-                "edit_file",
-                "glob",
-                "grep",
-                "execute",
-            ].includes(descriptor.name)) {
-            return false;
-        }
-        if (modelExposedNames.has(descriptor.name)) {
-            if (options?.modelExposed === false) {
-                return false;
-            }
-            if (allowedModelExposedNames && !allowedModelExposedNames.has(descriptor.name)) {
-                return false;
-            }
-        }
-        return true;
-    }).map((descriptor) => ({ ...descriptor }));
-}
-function toDisplayContent(content) {
-    if (typeof content === "string") {
-        return content;
-    }
-    if (content instanceof Uint8Array) {
-        return new TextDecoder().decode(content);
-    }
-    return "";
-}
-function notAvailable(toolName, capability) {
-    return `Error: ${toolName} is not available. This backend does not support ${capability}.`;
-}
-function shellQuote(value) {
-    return `'${value.replace(/'/g, `'\"'\"'`)}'`;
-}
-async function tryExecuteShallowDirectoryListing(backend, targetPath) {
-    if (typeof backend.execute !== "function" || process.platform === "win32") {
-        return undefined;
-    }
-    const quotedPath = shellQuote(targetPath);
-    const command = [
-        "set -f",
-        `dir=${quotedPath}`,
-        'if [ ! -d "$dir" ]; then exit 0; fi',
-        "count=0",
-        'for entry in "$dir"/* "$dir"/.[!.]* "$dir"/..?*; do',
-        '  [ -e "$entry" ] || continue',
-        '  if [ -d "$entry" ]; then',
-        '    printf \'%s (directory)\\n\' \"$entry\"',
-        "  else",
-        '    printf \'%s\\n\' \"$entry\"',
-        "  fi",
-        "  count=$((count + 1))",
-        '  if [ "$count" -ge 400 ]; then',
-        "    printf '...[truncated]\\n'",
-        "    break",
-        "  fi",
-        "done",
-    ].join("; ");
-    try {
-        const result = await Promise.resolve(backend.execute(command));
-        const output = typeof result?.output === "string" ? result.output.trim() : "";
-        if (!output) {
-            return undefined;
-        }
-        return output;
-    }
-    catch {
-        return undefined;
-    }
-}
-function resolveWorkspaceRoot(backend) {
-    const typed = backend;
-    if (typeof typed.rootDir === "string" && typed.rootDir.trim().length > 0) {
-        return typed.rootDir.trim();
-    }
-    if (typeof typed.root === "string" && typed.root.trim().length > 0) {
-        return typed.root.trim();
-    }
-    if (typeof typed.cwd === "string" && typed.cwd.trim().length > 0) {
-        return typed.cwd.trim();
-    }
-    return undefined;
-}
-function normalizeWorkspacePathOrThrow(backend, inputPath) {
-    if (!inputPath) {
-        return inputPath;
-    }
-    const workspaceRoot = resolveWorkspaceRoot(backend);
-    if (!workspaceRoot || !path.isAbsolute(inputPath)) {
-        return inputPath;
-    }
-    if (inputPath.startsWith("/large_tool_results/")) {
-        throw new Error(`Path '${inputPath}' is an internal runtime spill path, not a workspace file. Do not read internal runtime spill files such as '/large_tool_results/...'. Use the preview already in context, rerun the producing tool with narrower output, or write the needed data to a workspace-relative file instead.`);
-    }
-    const normalizedWorkspaceRoot = path.resolve(workspaceRoot);
-    const normalizedInputPath = path.resolve(inputPath);
-    if (normalizedInputPath === normalizedWorkspaceRoot || normalizedInputPath.startsWith(`${normalizedWorkspaceRoot}${path.sep}`)) {
-        return path.relative(normalizedWorkspaceRoot, normalizedInputPath) || ".";
-    }
-    throw new Error(`Path '${inputPath}' is outside the workspace root '${normalizedWorkspaceRoot}'. Use a workspace-relative path instead.`);
-}
-function formatHttpResponse(result) {
-    if (result?.error) {
-        return result.error;
-    }
-    const content = toDisplayContent(result?.body ?? result?.content);
-    const status = typeof result?.status === "number" ? `${result.status}${result.statusText ? ` ${result.statusText}` : ""}` : null;
-    const headerLines = result?.headers ? Object.entries(result.headers).map(([key, value]) => `${key}: ${value}`) : [];
-    const lines = [
-        ...(status ? [`Status: ${status}`] : []),
-        ...(headerLines.length > 0 ? ["Headers:", ...headerLines] : []),
-        ...(content ? ["Body:", content] : []),
-    ];
-    return lines.length > 0 ? lines.join("\n") : "Request completed.";
-}
-async function fetchUrlWithRuntimeFallback(backend, url) {
-    if (typeof backend.fetchUrl === "function") {
-        try {
-            const result = await Promise.resolve(backend.fetchUrl(url));
-            if (typeof result === "string") {
-                return result;
-            }
-            return formatHttpResponse(result);
-        }
-        catch {
-            // Fall through to the runtime-owned network fetch below.
-        }
-    }
-    const response = await fetch(url);
-    return formatHttpResponse({
-        status: response.status,
-        statusText: response.statusText,
-        headers: Object.fromEntries(response.headers.entries()),
-        body: await response.text(),
-    });
-}
-function parseScheduleWhen(value) {
-    const normalized = value.trim().toLowerCase();
-    if (!normalized) {
-        return undefined;
-    }
-    const intervalMatch = /^every\s+(\d+)\s*(minute|minutes|min|mins|hour|hours|hr|hrs)$/u.exec(normalized);
-    if (intervalMatch) {
-        const quantity = Number.parseInt(intervalMatch[1], 10);
-        const unit = intervalMatch[2];
-        return {
-            type: "interval",
-            everyMinutes: unit.startsWith("h") ? quantity * 60 : quantity,
-        };
-    }
-    if (normalized === "hourly" || normalized === "every hour") {
-        return {
-            type: "interval",
-            everyMinutes: 60,
-        };
-    }
-    return {
-        type: "cron",
-        expression: value,
-    };
-}
-export async function createBuiltinMiddlewareTools(backend, options) {
-    const tools = new Map();
-    const pathScopedBackend = options.workspaceRoot
-        ? { ...backend, rootDir: options.workspaceRoot }
-        : backend;
-    let todoSnapshot = {
-        items: [],
-        summary: {
-            total: 0,
-            pending: 0,
-            inProgress: 0,
-            completed: 0,
-            failed: 0,
-            cancelled: 0,
-        },
-    };
-    const finalizeOutput = async (toolName, output, toolConfig) => maybePersistLargeToolOutput({
-        toolName,
-        output,
-        toolRuntimeContext: resolveToolRuntimeContext(toolConfig, options.toolRuntimeContext),
-    });
-    tools.set("write_todos", {
-        name: "write_todos",
-        description: "Create and update the runtime todo board for multi-step work.",
-        schema: z.object({
-            todos: z.array(z.object({
-                id: z.union([z.string(), z.number()]).optional(),
-                content: z.string().optional(),
-                description: z.string().optional(),
-                title: z.string().optional(),
-                name: z.string().optional(),
-                text: z.string().optional(),
-                status: z.enum(["pending", "in_progress", "completed", "failed", "cancelled"]).optional(),
-                ownerAgentId: z.string().optional(),
-                startedAt: z.string().optional(),
-                endedAt: z.string().optional(),
-                result: z.unknown().optional(),
-                metadata: z.record(z.string(), z.unknown()).optional(),
-            }).passthrough()).optional(),
-        }).passthrough(),
-        invoke: async (input) => {
-            const args = isRecord(input) ? input : {};
-            const summary = summarizeBuiltinWriteTodosArgs(args);
-            todoSnapshot = summary;
-            return {
-                ok: true,
-                tool: "write_todos",
-                message: `Tracked ${summary.summary.total} todo item(s).`,
-                summary,
-            };
-        },
-    });
-    tools.set("read_todos", {
-        name: "read_todos",
-        description: "Read the current runtime todo board.",
-        schema: z.object({}).passthrough(),
-        invoke: async () => ({
-            ok: true,
-            tool: "read_todos",
-            message: formatBuiltinTodoSnapshot(todoSnapshot),
-            summary: todoSnapshot,
-        }),
-    });
-    tools.set("ls", {
-        name: "ls",
-        description: "List files in a directory.",
-        schema: z.object({ path: z.string().optional().default("/") }).passthrough(),
-        invoke: async (input, toolConfig) => {
-            const targetPath = normalizeWorkspacePathOrThrow(pathScopedBackend, isRecord(input) && typeof input.path === "string" ? input.path : "/");
-            const shallowListing = await tryExecuteShallowDirectoryListing(pathScopedBackend, targetPath);
-            if (typeof shallowListing === "string") {
-                return finalizeOutput("ls", shallowListing.length > 0 ? shallowListing : `No files found in ${targetPath}`, toolConfig);
-            }
-            const legacyInfos = (await Promise.resolve(backend.lsInfo?.(targetPath))) ?? [];
-            const infos = legacyInfos.length > 0
-                ? legacyInfos
-                : ((await Promise.resolve(backend.ls?.(targetPath)))?.files ?? []).map((info) => ({
-                    path: info.path,
-                    is_dir: info.isDir,
-                    size: info.size,
-                }));
-            if (infos.length === 0) {
-                return `No files found in ${targetPath}`;
-            }
-            return finalizeOutput("ls", truncateLines(infos.map((info) => info.is_dir ? `${info.path} (directory)` : `${info.path}${info.size ? ` (${info.size} bytes)` : ""}`)), toolConfig);
-        },
-    });
-    tools.set("read_file", {
-        name: "read_file",
-        description: "Read a file from the workspace filesystem.",
-        schema: z.object({
-            file_path: z.string(),
-            offset: z.number().optional(),
-            limit: z.number().optional(),
-        }).passthrough(),
-        invoke: async (input) => {
-            const typed = isRecord(input) ? input : {};
-            const filePath = normalizeWorkspacePathOrThrow(pathScopedBackend, typeof typed.file_path === "string" ? typed.file_path : "");
-            const offset = typeof typed.offset === "number" ? typed.offset : 0;
-            const limit = typeof typed.limit === "number" ? typed.limit : 500;
-            const result = await Promise.resolve(backend.read?.(filePath, offset, limit));
-            if (typeof result === "string") {
-                return result;
-            }
-            return result?.error ?? toDisplayContent(result?.content);
-        },
-    });
-    tools.set("write_file", {
-        name: "write_file",
-        description: "Write a file in the workspace filesystem.",
-        schema: z.object({ file_path: z.string(), content: z.string().optional() }).passthrough(),
-        invoke: async (input) => {
-            const typed = isRecord(input) ? input : {};
-            const filePath = normalizeWorkspacePathOrThrow(pathScopedBackend, typeof typed.file_path === "string" ? typed.file_path : "");
-            const result = await Promise.resolve(backend.write?.(filePath, typeof typed.content === "string" ? typed.content : ""));
-            return result?.error ?? `Successfully wrote to '${result?.path ?? filePath}'`;
-        },
-    });
-    tools.set("edit_file", {
-        name: "edit_file",
-        description: "Replace exact text inside a workspace file.",
-        schema: z.object({
-            file_path: z.string(),
-            old_string: z.string(),
-            new_string: z.string(),
-            replace_all: z.boolean().optional(),
-        }).passthrough(),
-        invoke: async (input) => {
-            const typed = isRecord(input) ? input : {};
-            const filePath = normalizeWorkspacePathOrThrow(pathScopedBackend, typeof typed.file_path === "string" ? typed.file_path : "");
-            const result = await Promise.resolve(backend.edit?.(filePath, typeof typed.old_string === "string" ? typed.old_string : "", typeof typed.new_string === "string" ? typed.new_string : "", typed.replace_all === true));
-            return result?.error ?? `Successfully replaced ${result?.occurrences ?? 0} occurrence(s) in '${result?.path ?? filePath}'`;
-        },
-    });
-    tools.set("glob", {
-        name: "glob",
-        description: "Find files matching a glob pattern.",
-        schema: z.object({ pattern: z.string(), path: z.string().optional().default("/") }).passthrough(),
-        invoke: async (input) => {
-            const typed = isRecord(input) ? input : {};
-            const pattern = typeof typed.pattern === "string" ? typed.pattern : "";
-            const targetPath = normalizeWorkspacePathOrThrow(pathScopedBackend, typeof typed.path === "string" ? typed.path : "/");
-            const legacyInfos = (await Promise.resolve(backend.globInfo?.(pattern, targetPath))) ?? [];
-            const infos = legacyInfos.length > 0
-                ? legacyInfos
-                : ((await Promise.resolve(backend.glob?.(pattern, targetPath)))?.files ?? []);
-            if (infos.length === 0) {
-                return `No files found matching pattern '${pattern}'`;
-            }
-            return truncateLines(infos.map((info) => info.path));
-        },
-    });
-    tools.set("grep", {
-        name: "grep",
-        description: "Search for text across workspace files.",
-        schema: z.object({
-            pattern: z.string(),
-            path: z.string().optional().default("/"),
-            glob: z.string().nullable().optional(),
-        }).passthrough(),
-        invoke: async (input) => {
-            const typed = isRecord(input) ? input : {};
-            const targetPath = normalizeWorkspacePathOrThrow(pathScopedBackend, typeof typed.path === "string" ? typed.path : "/");
-            const legacyResult = await Promise.resolve(backend.grepRaw?.(typeof typed.pattern === "string" ? typed.pattern : "", targetPath, typeof typed.glob === "string" ? typed.glob : null));
-            const structuredResult = await Promise.resolve(backend.grep?.(typeof typed.pattern === "string" ? typed.pattern : "", targetPath, typeof typed.glob === "string" ? typed.glob : null));
-            const normalizedStructuredMatches = structuredResult?.matches?.map((match) => ({
-                path: match.path,
-                line: match.lineNumber ?? match.line_number ?? match.line ?? 0,
-                text: match.content ?? match.text ?? "",
-            }));
-            const normalizedResult = legacyResult ?? normalizedStructuredMatches;
-            if (typeof normalizedResult === "string") {
-                return normalizedResult;
-            }
-            if (!normalizedResult || normalizedResult.length === 0) {
-                return `No matches found for pattern '${typeof typed.pattern === "string" ? typed.pattern : ""}'`;
-            }
-            const lines = [];
-            let currentFile = "";
-            for (const match of normalizedResult) {
-                if (match.path !== currentFile) {
-                    currentFile = match.path;
-                    lines.push(`\n${currentFile}:`);
-                }
-                lines.push(`  ${match.line}: ${match.text}`);
-            }
-            return truncateLines(lines);
-        },
-    });
-    tools.set("execute", {
-        name: "execute",
-        description: "Run a shell command in the workspace sandbox.",
-        schema: z.object({ command: z.string() }).passthrough(),
-        invoke: async (input, toolConfig) => {
-            if (!isSandboxBackend(backend) || typeof backend.execute !== "function") {
-                return "Error: Execution not available. This agent's backend does not support command execution (SandboxBackendProtocol).";
-            }
-            const typed = isRecord(input) ? input : {};
-            const result = await Promise.resolve(backend.execute(typeof typed.command === "string" ? typed.command : ""));
-            const parts = [result.output];
-            if (result.exitCode !== null) {
-                parts.push(`\n[Command ${result.exitCode === 0 ? "succeeded" : "failed"} with exit code ${result.exitCode}]`);
-            }
-            if (result.truncated) {
-                parts.push("\n[Output was truncated due to size limits]");
-            }
-            return finalizeOutput("execute", parts.join(""), toolConfig);
-        },
-    });
-    tools.set("fetch_url", {
-        name: "fetch_url",
-        description: "Fetch a URL and return the response body.",
-        schema: z.object({ url: z.string() }).passthrough(),
-        invoke: async (input, toolConfig) => {
-            const typed = isRecord(input) ? input : {};
-            return finalizeOutput("fetch_url", await fetchUrlWithRuntimeFallback(backend, typeof typed.url === "string" ? typed.url : ""), toolConfig);
-        },
-    });
-    tools.set("http_request", {
-        name: "http_request",
-        description: "Send a structured HTTP request.",
-        schema: z.object({
-            url: z.string(),
-            method: z.string().optional(),
-            headers: z.record(z.string(), z.string()).optional(),
-            body: z.string().optional(),
-        }).passthrough(),
-        invoke: async (input, toolConfig) => {
-            if (typeof backend.httpRequest !== "function") {
-                return notAvailable("http_request", "structured HTTP requests");
-            }
-            const typed = isRecord(input) ? input : {};
-            const result = await Promise.resolve(backend.httpRequest({
-                url: typeof typed.url === "string" ? typed.url : "",
-                method: typeof typed.method === "string" ? typed.method : undefined,
-                headers: typed.headers && typeof typed.headers === "object" && !Array.isArray(typed.headers)
-                    ? Object.fromEntries(Object.entries(typed.headers).filter(([, value]) => typeof value === "string"))
-                    : undefined,
-                body: typeof typed.body === "string" ? typed.body : undefined,
-            }));
-            if (typeof result === "string") {
-                return finalizeOutput("http_request", result, toolConfig);
-            }
-            return finalizeOutput("http_request", formatHttpResponse(result), toolConfig);
-        },
-    });
-    tools.set("send_message", {
-        name: "send_message",
-        description: "Send a message through the configured backend.",
-        schema: z.object({
-            destination: z.string(),
-            message: z.string(),
-            subject: z.string().optional(),
-            metadata: z.record(z.string(), z.unknown()).optional(),
-        }).passthrough(),
-        invoke: async (input) => {
-            if (typeof backend.sendMessage !== "function") {
-                return notAvailable("send_message", "message delivery");
-            }
-            const typed = isRecord(input) ? input : {};
-            const result = await Promise.resolve(backend.sendMessage({
-                destination: typeof typed.destination === "string" ? typed.destination : "",
-                message: typeof typed.message === "string" ? typed.message : "",
-                subject: typeof typed.subject === "string" ? typed.subject : undefined,
-                metadata: isRecord(typed.metadata) ? typed.metadata : undefined,
-            }));
-            if (typeof result === "string") {
-                return result;
-            }
-            return result?.error ?? `Message sent to '${typeof typed.destination === "string" ? typed.destination : ""}'${result?.id ? ` (id: ${result.id})` : ""}.`;
-        },
-    });
-    tools.set("request_approval", {
-        name: "request_approval",
-        description: "Request an approval decision from the runtime.",
-        schema: z.object({
-            action: z.string(),
-            reason: z.string().optional(),
-            details: z.record(z.string(), z.unknown()).optional(),
-        }).passthrough(),
-        invoke: async (input) => {
-            if (typeof backend.requestApproval !== "function") {
-                return notAvailable("request_approval", "approval requests");
-            }
-            const typed = isRecord(input) ? input : {};
-            const result = await Promise.resolve(backend.requestApproval({
-                action: typeof typed.action === "string" ? typed.action : "",
-                reason: typeof typed.reason === "string" ? typed.reason : undefined,
-                details: isRecord(typed.details) ? typed.details : undefined,
-            }));
-            if (typeof result === "string") {
-                return result;
-            }
-            if (result?.error) {
-                return result.error;
-            }
-            return result?.approved === true
-                ? `Approval granted for '${typeof typed.action === "string" ? typed.action : ""}'${result.id ? ` (id: ${result.id})` : ""}.`
-                : `Approval requested for '${typeof typed.action === "string" ? typed.action : ""}'${result?.id ? ` (id: ${result.id})` : ""}.`;
-        },
-    });
-    tools.set("schedule_task", {
-        name: "schedule_task",
-        description: "Create, inspect, update, list, and delete system-level scheduled tasks.",
-        schema: z.object({
-            operation: z.enum(["create", "list", "get", "update", "delete"]).optional(),
-            scheduleId: z.string().optional(),
-            name: z.string().optional(),
-            instruction: z.string().optional(),
-            agentId: z.string().optional(),
-            when: z.string().optional(),
-            schedule: z.object({
-                type: z.enum(["cron", "interval", "daily", "weekly"]),
-                expression: z.string().optional(),
-                everyMinutes: z.number().int().positive().optional(),
-                time: z.string().optional(),
-                days: z.array(z.string()).optional(),
-            }).optional(),
-            filters: z.object({
-                scheduleId: z.string().optional(),
-                name: z.string().optional(),
-                agentId: z.string().optional(),
-                source: z.enum(["crontab", "schtasks"]).optional(),
-                status: z.enum(["active", "missing"]).optional(),
-                query: z.string().optional(),
-            }).optional(),
-            metadata: z.record(z.string(), z.unknown()).optional(),
-        }).passthrough(),
-        invoke: async (input) => {
-            const typed = isRecord(input) ? input : {};
-            const operation = typeof typed.operation === "string" ? typed.operation : "create";
-            const normalizedSchedule = isRecord(typed.schedule) && typeof typed.schedule.type === "string"
-                ? {
-                    type: typed.schedule.type,
-                    ...(typeof typed.schedule.expression === "string" ? { expression: typed.schedule.expression } : {}),
-                    ...(typeof typed.schedule.everyMinutes === "number" ? { everyMinutes: typed.schedule.everyMinutes } : {}),
-                    ...(typeof typed.schedule.time === "string" ? { time: typed.schedule.time } : {}),
-                    ...(Array.isArray(typed.schedule.days)
-                        ? {
-                            days: typed.schedule.days.filter((day) => typeof day === "string"),
-                        }
-                        : {}),
-                }
-                : typeof typed.when === "string"
-                    ? parseScheduleWhen(typed.when)
-                    : undefined;
-            if (typeof backend.manageSchedule === "function") {
-                return backend.manageSchedule({
-                    operation: operation,
-                    scheduleId: typeof typed.scheduleId === "string" ? typed.scheduleId : undefined,
-                    name: typeof typed.name === "string" ? typed.name : undefined,
-                    instruction: typeof typed.instruction === "string" ? typed.instruction : undefined,
-                    agentId: typeof typed.agentId === "string" ? typed.agentId : undefined,
-                    schedule: normalizedSchedule,
-                    filters: isRecord(typed.filters)
-                        ? {
-                            ...(typeof typed.filters.scheduleId === "string" ? { scheduleId: typed.filters.scheduleId } : {}),
-                            ...(typeof typed.filters.name === "string" ? { name: typed.filters.name } : {}),
-                            ...(typeof typed.filters.agentId === "string" ? { agentId: typed.filters.agentId } : {}),
-                            ...(typed.filters.source === "crontab" || typed.filters.source === "schtasks" ? { source: typed.filters.source } : {}),
-                            ...(typed.filters.status === "active" || typed.filters.status === "missing" ? { status: typed.filters.status } : {}),
-                            ...(typeof typed.filters.query === "string" ? { query: typed.filters.query } : {}),
-                        }
-                        : undefined,
-                    metadata: isRecord(typed.metadata) ? typed.metadata : undefined,
-                });
-            }
-            if (typeof backend.scheduleTask !== "function") {
-                return notAvailable("schedule_task", "task scheduling");
-            }
-            if (operation !== "create") {
-                return "Error: schedule_task only supports create on this backend.";
-            }
-            const result = await Promise.resolve(backend.scheduleTask({
-                instruction: typeof typed.instruction === "string" ? typed.instruction : "",
-                when: typeof typed.when === "string" ? typed.when : "",
-                name: typeof typed.name === "string" ? typed.name : undefined,
-                metadata: isRecord(typed.metadata) ? typed.metadata : undefined,
-            }));
-            if (typeof result === "string") {
-                return result;
-            }
-            return result?.error ?? `Scheduled task '${typeof typed.name === "string" ? typed.name : typeof typed.instruction === "string" ? typed.instruction : ""}' for ${typeof typed.when === "string" ? typed.when : ""}${result?.id ? ` (id: ${result.id})` : ""}.`;
-        },
-    });
-    if (options.includeTaskTool && options.invokeTaskTool) {
-        const description = buildTaskToolDescription(options.taskSubagents);
-        tools.set("task", {
-            name: "task",
-            description,
-            schema: buildTaskToolSchema(options.taskSubagents),
-            invoke: async (input) => options.invokeTaskTool(input),
-        });
-    }
-    return tools;
-}
+import y from"node:path";import{z as t}from"zod";import{isSandboxBackend as x}from"deepagents";import{isRecord as d}from"../../../utils/object.js";import{formatBuiltinTodoSnapshot as T,summarizeBuiltinWriteTodosArgs as R,truncateLines as v}from"../runtime-adapter-support.js";import{maybePersistLargeToolOutput as j,resolveToolRuntimeContext as q}from"./tool-output-artifacts.js";function S(n){const s=["Delegate a bounded task to the subagent whose declared description best matches the task.","Use this only when a subagent is a better fit than the current agent. Set subagent_type to exactly one listed subagent name."],a=(n??[]).filter(i=>i.name.trim().length>0).map(i=>{const p=i.description.trim()||"No description provided.";return`- ${i.name}: ${p}`});return a.length>0?[...s,"","Available subagents:",...a].join(`
+`):s.join(" ")}function P(n){const s=(n??[]).map(i=>i.name.trim()).filter(i=>i.length>0),a=s.length>0?t.enum(s):t.string();return t.object({description:t.string().describe("Concrete bounded task for the selected subagent to perform."),subagent_type:a.describe("Exact name of the selected subagent.")}).passthrough()}const I=[{name:"write_todos",description:"Create and update the runtime todo board for multi-step work."},{name:"read_todos",description:"Read the current runtime todo board."},{name:"ls",description:"List files in a directory."},{name:"read_file",description:"Read a file from the workspace filesystem."},{name:"write_file",description:"Write a file in the workspace filesystem."},{name:"edit_file",description:"Replace exact text inside a workspace file."},{name:"glob",description:"Find files matching a glob pattern."},{name:"grep",description:"Search for text across workspace files."},{name:"execute",description:"Run a shell command in the workspace sandbox."},{name:"fetch_url",description:"Fetch a URL and return the response body."},{name:"http_request",description:"Send a structured HTTP request."},{name:"send_message",description:"Send a message through the configured backend."},{name:"request_approval",description:"Request an approval decision from the runtime."},{name:"schedule_task",description:"Create, inspect, update, list, and delete system-level scheduled tasks."},{name:"task",description:"Delegate a bounded task to a subagent."}];function B(n){const s=new Set(["fetch_url","http_request","send_message","request_approval","schedule_task"]),a=Array.isArray(n?.modelExposed)?new Set(n.modelExposed):void 0;return I.filter(i=>!(n?.todos===!1&&(i.name==="write_todos"||i.name==="read_todos")||n?.filesystem===!1&&["ls","read_file","write_file","edit_file","glob","grep","execute"].includes(i.name)||s.has(i.name)&&(n?.modelExposed===!1||a&&!a.has(i.name)))).map(i=>({...i}))}function $(n){return typeof n=="string"?n:n instanceof Uint8Array?new TextDecoder().decode(n):""}function w(n,s){return`Error: ${n} is not available. This backend does not support ${s}.`}function A(n){return`'${n.replace(/'/g,`'"'"'`)}'`}async function E(n,s){if(typeof n.execute!="function"||process.platform==="win32")return;const i=["set -f",`dir=${A(s)}`,'if [ ! -d "$dir" ]; then exit 0; fi',"count=0",'for entry in "$dir"/* "$dir"/.[!.]* "$dir"/..?*; do','  [ -e "$entry" ] || continue','  if [ -d "$entry" ]; then',`    printf '%s (directory)\\n' "$entry"`,"  else",`    printf '%s\\n' "$entry"`,"  fi","  count=$((count + 1))",'  if [ "$count" -ge 400 ]; then',"    printf '...[truncated]\\n'","    break","  fi","done"].join("; ");try{const p=await Promise.resolve(n.execute(i)),h=typeof p?.output=="string"?p.output.trim():"";return h||void 0}catch{return}}function D(n){const s=n;if(typeof s.rootDir=="string"&&s.rootDir.trim().length>0)return s.rootDir.trim();if(typeof s.root=="string"&&s.root.trim().length>0)return s.root.trim();if(typeof s.cwd=="string"&&s.cwd.trim().length>0)return s.cwd.trim()}function g(n,s){if(!s)return s;const a=D(n);if(!a||!y.isAbsolute(s))return s;if(s.startsWith("/large_tool_results/"))throw new Error(`Path '${s}' is an internal runtime spill path, not a workspace file. Do not read internal runtime spill files such as '/large_tool_results/...'. Use the preview already in context, rerun the producing tool with narrower output, or write the needed data to a workspace-relative file instead.`);const i=y.resolve(a),p=y.resolve(s);if(p===i||p.startsWith(`${i}${y.sep}`))return y.relative(i,p)||".";throw new Error(`Path '${s}' is outside the workspace root '${i}'. Use a workspace-relative path instead.`)}function k(n){if(n?.error)return n.error;const s=$(n?.body??n?.content),a=typeof n?.status=="number"?`${n.status}${n.statusText?` ${n.statusText}`:""}`:null,i=n?.headers?Object.entries(n.headers).map(([h,o])=>`${h}: ${o}`):[],p=[...a?[`Status: ${a}`]:[],...i.length>0?["Headers:",...i]:[],...s?["Body:",s]:[]];return p.length>0?p.join(`
+`):"Request completed."}async function M(n,s){if(typeof n.fetchUrl=="function")try{const i=await Promise.resolve(n.fetchUrl(s));return typeof i=="string"?i:k(i)}catch{}const a=await fetch(s);return k({status:a.status,statusText:a.statusText,headers:Object.fromEntries(a.headers.entries()),body:await a.text()})}function z(n){const s=n.trim().toLowerCase();if(!s)return;const a=/^every\s+(\d+)\s*(minute|minutes|min|mins|hour|hours|hr|hrs)$/u.exec(s);if(a){const i=Number.parseInt(a[1],10);return{type:"interval",everyMinutes:a[2].startsWith("h")?i*60:i}}return s==="hourly"||s==="every hour"?{type:"interval",everyMinutes:60}:{type:"cron",expression:n}}async function F(n,s){const a=new Map,i=s.workspaceRoot?{...n,rootDir:s.workspaceRoot}:n;let p={items:[],summary:{total:0,pending:0,inProgress:0,completed:0,failed:0,cancelled:0}};const h=async(o,e,r)=>j({toolName:o,output:e,toolRuntimeContext:q(r,s.toolRuntimeContext)});if(a.set("write_todos",{name:"write_todos",description:"Create and update the runtime todo board for multi-step work.",schema:t.object({todos:t.array(t.object({id:t.union([t.string(),t.number()]).optional(),content:t.string().optional(),description:t.string().optional(),title:t.string().optional(),name:t.string().optional(),text:t.string().optional(),status:t.enum(["pending","in_progress","completed","failed","cancelled"]).optional(),ownerAgentId:t.string().optional(),startedAt:t.string().optional(),endedAt:t.string().optional(),result:t.unknown().optional(),metadata:t.record(t.string(),t.unknown()).optional()}).passthrough()).optional()}).passthrough(),invoke:async o=>{const e=d(o)?o:{},r=R(e);return p=r,{ok:!0,tool:"write_todos",message:`Tracked ${r.summary.total} todo item(s).`,summary:r}}}),a.set("read_todos",{name:"read_todos",description:"Read the current runtime todo board.",schema:t.object({}).passthrough(),invoke:async()=>({ok:!0,tool:"read_todos",message:T(p),summary:p})}),a.set("ls",{name:"ls",description:"List files in a directory.",schema:t.object({path:t.string().optional().default("/")}).passthrough(),invoke:async(o,e)=>{const r=g(i,d(o)&&typeof o.path=="string"?o.path:"/"),l=await E(i,r);if(typeof l=="string")return h("ls",l.length>0?l:`No files found in ${r}`,e);const u=await Promise.resolve(n.lsInfo?.(r))??[],f=u.length>0?u:((await Promise.resolve(n.ls?.(r)))?.files??[]).map(c=>({path:c.path,is_dir:c.isDir,size:c.size}));return f.length===0?`No files found in ${r}`:h("ls",v(f.map(c=>c.is_dir?`${c.path} (directory)`:`${c.path}${c.size?` (${c.size} bytes)`:""}`)),e)}}),a.set("read_file",{name:"read_file",description:"Read a file from the workspace filesystem.",schema:t.object({file_path:t.string(),offset:t.number().optional(),limit:t.number().optional()}).passthrough(),invoke:async o=>{const e=d(o)?o:{},r=g(i,typeof e.file_path=="string"?e.file_path:""),l=typeof e.offset=="number"?e.offset:0,u=typeof e.limit=="number"?e.limit:500,f=await Promise.resolve(n.read?.(r,l,u));return typeof f=="string"?f:f?.error??$(f?.content)}}),a.set("write_file",{name:"write_file",description:"Write a file in the workspace filesystem.",schema:t.object({file_path:t.string(),content:t.string().optional()}).passthrough(),invoke:async o=>{const e=d(o)?o:{},r=g(i,typeof e.file_path=="string"?e.file_path:""),l=await Promise.resolve(n.write?.(r,typeof e.content=="string"?e.content:""));return l?.error??`Successfully wrote to '${l?.path??r}'`}}),a.set("edit_file",{name:"edit_file",description:"Replace exact text inside a workspace file.",schema:t.object({file_path:t.string(),old_string:t.string(),new_string:t.string(),replace_all:t.boolean().optional()}).passthrough(),invoke:async o=>{const e=d(o)?o:{},r=g(i,typeof e.file_path=="string"?e.file_path:""),l=await Promise.resolve(n.edit?.(r,typeof e.old_string=="string"?e.old_string:"",typeof e.new_string=="string"?e.new_string:"",e.replace_all===!0));return l?.error??`Successfully replaced ${l?.occurrences??0} occurrence(s) in '${l?.path??r}'`}}),a.set("glob",{name:"glob",description:"Find files matching a glob pattern.",schema:t.object({pattern:t.string(),path:t.string().optional().default("/")}).passthrough(),invoke:async o=>{const e=d(o)?o:{},r=typeof e.pattern=="string"?e.pattern:"",l=g(i,typeof e.path=="string"?e.path:"/"),u=await Promise.resolve(n.globInfo?.(r,l))??[],f=u.length>0?u:(await Promise.resolve(n.glob?.(r,l)))?.files??[];return f.length===0?`No files found matching pattern '${r}'`:v(f.map(c=>c.path))}}),a.set("grep",{name:"grep",description:"Search for text across workspace files.",schema:t.object({pattern:t.string(),path:t.string().optional().default("/"),glob:t.string().nullable().optional()}).passthrough(),invoke:async o=>{const e=d(o)?o:{},r=g(i,typeof e.path=="string"?e.path:"/"),l=await Promise.resolve(n.grepRaw?.(typeof e.pattern=="string"?e.pattern:"",r,typeof e.glob=="string"?e.glob:null)),f=(await Promise.resolve(n.grep?.(typeof e.pattern=="string"?e.pattern:"",r,typeof e.glob=="string"?e.glob:null)))?.matches?.map(m=>({path:m.path,line:m.lineNumber??m.line_number??m.line??0,text:m.content??m.text??""})),c=l??f;if(typeof c=="string")return c;if(!c||c.length===0)return`No matches found for pattern '${typeof e.pattern=="string"?e.pattern:""}'`;const b=[];let _="";for(const m of c)m.path!==_&&(_=m.path,b.push(`
+${_}:`)),b.push(`  ${m.line}: ${m.text}`);return v(b)}}),a.set("execute",{name:"execute",description:"Run a shell command in the workspace sandbox.",schema:t.object({command:t.string()}).passthrough(),invoke:async(o,e)=>{if(!x(n)||typeof n.execute!="function")return"Error: Execution not available. This agent's backend does not support command execution (SandboxBackendProtocol).";const r=d(o)?o:{},l=await Promise.resolve(n.execute(typeof r.command=="string"?r.command:"")),u=[l.output];return l.exitCode!==null&&u.push(`
+[Command ${l.exitCode===0?"succeeded":"failed"} with exit code ${l.exitCode}]`),l.truncated&&u.push(`
+[Output was truncated due to size limits]`),h("execute",u.join(""),e)}}),a.set("fetch_url",{name:"fetch_url",description:"Fetch a URL and return the response body.",schema:t.object({url:t.string()}).passthrough(),invoke:async(o,e)=>{const r=d(o)?o:{};return h("fetch_url",await M(n,typeof r.url=="string"?r.url:""),e)}}),a.set("http_request",{name:"http_request",description:"Send a structured HTTP request.",schema:t.object({url:t.string(),method:t.string().optional(),headers:t.record(t.string(),t.string()).optional(),body:t.string().optional()}).passthrough(),invoke:async(o,e)=>{if(typeof n.httpRequest!="function")return w("http_request","structured HTTP requests");const r=d(o)?o:{},l=await Promise.resolve(n.httpRequest({url:typeof r.url=="string"?r.url:"",method:typeof r.method=="string"?r.method:void 0,headers:r.headers&&typeof r.headers=="object"&&!Array.isArray(r.headers)?Object.fromEntries(Object.entries(r.headers).filter(([,u])=>typeof u=="string")):void 0,body:typeof r.body=="string"?r.body:void 0}));return typeof l=="string"?h("http_request",l,e):h("http_request",k(l),e)}}),a.set("send_message",{name:"send_message",description:"Send a message through the configured backend.",schema:t.object({destination:t.string(),message:t.string(),subject:t.string().optional(),metadata:t.record(t.string(),t.unknown()).optional()}).passthrough(),invoke:async o=>{if(typeof n.sendMessage!="function")return w("send_message","message delivery");const e=d(o)?o:{},r=await Promise.resolve(n.sendMessage({destination:typeof e.destination=="string"?e.destination:"",message:typeof e.message=="string"?e.message:"",subject:typeof e.subject=="string"?e.subject:void 0,metadata:d(e.metadata)?e.metadata:void 0}));return typeof r=="string"?r:r?.error??`Message sent to '${typeof e.destination=="string"?e.destination:""}'${r?.id?` (id: ${r.id})`:""}.`}}),a.set("request_approval",{name:"request_approval",description:"Request an approval decision from the runtime.",schema:t.object({action:t.string(),reason:t.string().optional(),details:t.record(t.string(),t.unknown()).optional()}).passthrough(),invoke:async o=>{if(typeof n.requestApproval!="function")return w("request_approval","approval requests");const e=d(o)?o:{},r=await Promise.resolve(n.requestApproval({action:typeof e.action=="string"?e.action:"",reason:typeof e.reason=="string"?e.reason:void 0,details:d(e.details)?e.details:void 0}));return typeof r=="string"?r:r?.error?r.error:r?.approved===!0?`Approval granted for '${typeof e.action=="string"?e.action:""}'${r.id?` (id: ${r.id})`:""}.`:`Approval requested for '${typeof e.action=="string"?e.action:""}'${r?.id?` (id: ${r.id})`:""}.`}}),a.set("schedule_task",{name:"schedule_task",description:"Create, inspect, update, list, and delete system-level scheduled tasks.",schema:t.object({operation:t.enum(["create","list","get","update","delete"]).optional(),scheduleId:t.string().optional(),name:t.string().optional(),instruction:t.string().optional(),agentId:t.string().optional(),when:t.string().optional(),schedule:t.object({type:t.enum(["cron","interval","daily","weekly"]),expression:t.string().optional(),everyMinutes:t.number().int().positive().optional(),time:t.string().optional(),days:t.array(t.string()).optional()}).optional(),filters:t.object({scheduleId:t.string().optional(),name:t.string().optional(),agentId:t.string().optional(),source:t.enum(["crontab","schtasks"]).optional(),status:t.enum(["active","missing"]).optional(),query:t.string().optional()}).optional(),metadata:t.record(t.string(),t.unknown()).optional()}).passthrough(),invoke:async o=>{const e=d(o)?o:{},r=typeof e.operation=="string"?e.operation:"create",l=d(e.schedule)&&typeof e.schedule.type=="string"?{type:e.schedule.type,...typeof e.schedule.expression=="string"?{expression:e.schedule.expression}:{},...typeof e.schedule.everyMinutes=="number"?{everyMinutes:e.schedule.everyMinutes}:{},...typeof e.schedule.time=="string"?{time:e.schedule.time}:{},...Array.isArray(e.schedule.days)?{days:e.schedule.days.filter(f=>typeof f=="string")}:{}}:typeof e.when=="string"?z(e.when):void 0;if(typeof n.manageSchedule=="function")return n.manageSchedule({operation:r,scheduleId:typeof e.scheduleId=="string"?e.scheduleId:void 0,name:typeof e.name=="string"?e.name:void 0,instruction:typeof e.instruction=="string"?e.instruction:void 0,agentId:typeof e.agentId=="string"?e.agentId:void 0,schedule:l,filters:d(e.filters)?{...typeof e.filters.scheduleId=="string"?{scheduleId:e.filters.scheduleId}:{},...typeof e.filters.name=="string"?{name:e.filters.name}:{},...typeof e.filters.agentId=="string"?{agentId:e.filters.agentId}:{},...e.filters.source==="crontab"||e.filters.source==="schtasks"?{source:e.filters.source}:{},...e.filters.status==="active"||e.filters.status==="missing"?{status:e.filters.status}:{},...typeof e.filters.query=="string"?{query:e.filters.query}:{}}:void 0,metadata:d(e.metadata)?e.metadata:void 0});if(typeof n.scheduleTask!="function")return w("schedule_task","task scheduling");if(r!=="create")return"Error: schedule_task only supports create on this backend.";const u=await Promise.resolve(n.scheduleTask({instruction:typeof e.instruction=="string"?e.instruction:"",when:typeof e.when=="string"?e.when:"",name:typeof e.name=="string"?e.name:void 0,metadata:d(e.metadata)?e.metadata:void 0}));return typeof u=="string"?u:u?.error??`Scheduled task '${typeof e.name=="string"?e.name:typeof e.instruction=="string"?e.instruction:""}' for ${typeof e.when=="string"?e.when:""}${u?.id?` (id: ${u.id})`:""}.`}}),s.includeTaskTool&&s.invokeTaskTool){const o=S(s.taskSubagents);a.set("task",{name:"task",description:o,schema:P(s.taskSubagents),invoke:async e=>s.invokeTaskTool(e)})}return a}export{I as BUILTIN_MIDDLEWARE_TOOL_DESCRIPTORS,F as createBuiltinMiddlewareTools,B as filterBuiltinMiddlewareToolDescriptors};