@nexus-cortex/executors 4.26.0

package/dist/implementations/ui/TodoWriteTool.js

@@ -0,0 +1,315 @@
+/**
+ * Split-Tool Todo Executors — TodoCreate, TodoUpdate, TodoList
+ *
+ * Three targeted tools matching the TaskCreate/TaskUpdate/TaskList.
+ * Key design decisions:
+ * - TodoCreate/TodoUpdate return ONLY the affected task (compact output)
+ * - TodoList returns the full list (use it when you need the overview)
+ * - TodoUpdate accepts multiple taskIds for batch status changes
+ * - Shared in-memory state via module-level Map
+ */
+import { BaseTool } from '../../base/index.js';
+// ── Shared State ─────────────────────────────────────────────────────────────
+const todos = new Map();
+let nextId = 1;
+/** Reset state (for testing) */
+export function resetTodoState() {
+    todos.clear();
+    nextId = 1;
+}
+/** Get current todos (for SystemReminderInjector) */
+export function getCurrentTodos() {
+    return Array.from(todos.values()).sort((a, b) => parseInt(a.id) - parseInt(b.id));
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────
+const STATUS_ICON = {
+    pending: '○',
+    in_progress: '▶',
+    completed: '✓',
+};
+function formatTask(t) {
+    const icon = STATUS_ICON[t.status] ?? '?';
+    let line = `${icon} #${t.id} [${t.status}] ${t.content}`;
+    if (t.description)
+        line += `\n    ${t.description}`;
+    return line;
+}
+function formatSummary() {
+    const sorted = getCurrentTodos();
+    const pending = sorted.filter((t) => t.status === 'pending').length;
+    const inProgress = sorted.filter((t) => t.status === 'in_progress').length;
+    const completed = sorted.filter((t) => t.status === 'completed').length;
+    return `${completed}/${todos.size} completed, ${inProgress} in progress, ${pending} pending`;
+}
+function formatTodoList() {
+    if (todos.size === 0)
+        return 'No tasks.';
+    const sorted = getCurrentTodos();
+    const lines = sorted.map(formatTask);
+    lines.push('');
+    lines.push(`Summary: ${formatSummary()}`);
+    return lines.join('\n');
+}
+function cleanTaskId(raw) {
+    // Strip prefixes models commonly add: "#1" → "1"
+    return raw.replace(/^#/, '');
+}
+export class TodoCreateTool extends BaseTool {
+    constructor(config) {
+        super('TodoCreate', 'TodoCreate', `Create a task for tracking multi-step work. Call once per task. All start as pending.
+
+For each task you create, follow this lifecycle:
+  TodoUpdate(taskId, status="in_progress") -> do the work -> TodoUpdate(taskId, status="completed")
+
+WHEN TO USE: Tasks with 3+ steps. SKIP FOR: trivial single-step tasks.`, {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'Brief task title in imperative form (e.g., "Fix authentication bug")',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Detailed description of what needs to be done',
+                },
+                activeForm: {
+                    type: 'string',
+                    description: 'Present continuous form shown while in progress (e.g., "Fixing authentication bug")',
+                },
+            },
+            required: ['content'],
+        });
+    }
+    validateToolParams(params) {
+        if (!params.content || !params.content.trim()) {
+            return 'content is required';
+        }
+        return null;
+    }
+    getDescription(params) {
+        return `Creating task: ${params.content}`;
+    }
+    async execute(params, signal) {
+        const startTime = Date.now();
+        if (signal.aborted) {
+            return {
+                ...this.createErrorResult('Cancelled'),
+                metadata: { executionTime: Date.now() - startTime },
+            };
+        }
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            return {
+                ...this.createErrorResult(validationError),
+                metadata: { executionTime: Date.now() - startTime },
+            };
+        }
+        const id = String(nextId++);
+        const now = Date.now();
+        const item = {
+            id,
+            content: params.content.trim(),
+            description: params.description?.trim() ?? '',
+            activeForm: params.activeForm?.trim() ?? params.content.trim(),
+            status: 'pending',
+            createdAt: now,
+            updatedAt: now,
+        };
+        todos.set(id, item);
+        // Compact output: just the created task + summary line
+        const output = `Created task #${id}: ${item.content} [pending]\n${formatSummary()}`;
+        return {
+            ...this.createSuccessResult(output),
+            metadata: {
+                executionTime: Date.now() - startTime,
+                taskId: id,
+                todoCount: todos.size,
+            },
+        };
+    }
+}
+export class TodoUpdateTool extends BaseTool {
+    constructor(config) {
+        super('TodoUpdate', 'TodoUpdate', `Update task status or details by ID.
+
+LIFECYCLE — follow for every task:
+  TodoUpdate(taskId, status="in_progress")  <- before starting work
+  TodoUpdate(taskId, status="completed")    <- after finishing work
+
+Supports batch: pass comma-separated IDs (e.g., taskId="1,2,3") to update multiple tasks at once.
+Task IDs are plain numbers (e.g., "1", "2"). Do not include "#".`, {
+            type: 'object',
+            properties: {
+                taskId: {
+                    type: 'string',
+                    description: 'Task ID(s) to update. Single: "1". Batch: "1,2,3".',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['pending', 'in_progress', 'completed'],
+                    description: 'New status for the task(s)',
+                },
+                content: {
+                    type: 'string',
+                    description: 'New task title (single task only)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'New description (single task only)',
+                },
+                activeForm: {
+                    type: 'string',
+                    description: 'New active form (single task only)',
+                },
+            },
+            required: ['taskId'],
+        });
+    }
+    validateToolParams(params) {
+        if (!params.taskId) {
+            return 'taskId is required';
+        }
+        if (params.status &&
+            !['pending', 'in_progress', 'completed'].includes(params.status)) {
+            return `Invalid status: ${params.status}. Must be pending, in_progress, or completed.`;
+        }
+        return null;
+    }
+    getDescription(params) {
+        if (params.status) {
+            return `Updating task #${params.taskId} -> ${params.status}`;
+        }
+        return `Updating task #${params.taskId}`;
+    }
+    async execute(params, signal) {
+        const startTime = Date.now();
+        if (signal.aborted) {
+            return {
+                ...this.createErrorResult('Cancelled'),
+                metadata: { executionTime: Date.now() - startTime },
+            };
+        }
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            return {
+                ...this.createErrorResult(validationError),
+                metadata: { executionTime: Date.now() - startTime },
+            };
+        }
+        // Parse batch IDs: "1,2,3" or "#1, #2" or just "1"
+        const rawIds = params.taskId.split(',').map((s) => cleanTaskId(s.trim()));
+        const ids = rawIds.filter((id) => id.length > 0);
+        if (ids.length === 0) {
+            return {
+                ...this.createErrorResult('No valid task IDs provided.'),
+                metadata: { executionTime: Date.now() - startTime },
+            };
+        }
+        // Batch mode: only status updates
+        if (ids.length > 1) {
+            if (!params.status) {
+                return {
+                    ...this.createErrorResult('Batch update requires a status. Provide status to update multiple tasks.'),
+                    metadata: { executionTime: Date.now() - startTime },
+                };
+            }
+            const results = [];
+            const notFound = [];
+            for (const id of ids) {
+                const item = todos.get(id);
+                if (!item) {
+                    notFound.push(id);
+                    continue;
+                }
+                item.status = params.status;
+                item.updatedAt = Date.now();
+                results.push(`#${id}: ${item.content} -> ${params.status}`);
+            }
+            let output = `Updated ${results.length} task(s): ${params.status}`;
+            if (notFound.length > 0) {
+                output += `\nNot found: ${notFound.map((id) => '#' + id).join(', ')}`;
+            }
+            output += `\n${formatSummary()}`;
+            return {
+                ...this.createSuccessResult(output),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    updatedCount: results.length,
+                    todoCount: todos.size,
+                },
+            };
+        }
+        // Single task update
+        const taskId = ids[0];
+        const item = todos.get(taskId);
+        if (!item) {
+            return {
+                ...this.createErrorResult(`Task #${taskId} not found. Use TodoList to see all tasks.`),
+                metadata: { executionTime: Date.now() - startTime },
+            };
+        }
+        // Warn (don't reject) if setting multiple in_progress
+        let warning = '';
+        if (params.status === 'in_progress') {
+            const currentInProgress = Array.from(todos.values()).filter((t) => t.status === 'in_progress' && t.id !== taskId);
+            if (currentInProgress.length > 0) {
+                warning = ` (note: #${currentInProgress[0].id} also in_progress)`;
+            }
+        }
+        // Apply updates
+        if (params.status)
+            item.status = params.status;
+        if (params.content)
+            item.content = params.content.trim();
+        if (params.description !== undefined)
+            item.description = params.description.trim();
+        if (params.activeForm)
+            item.activeForm = params.activeForm.trim();
+        item.updatedAt = Date.now();
+        // Compact output: just the affected task + summary
+        const output = `${formatTask(item)}${warning}\n${formatSummary()}`;
+        return {
+            ...this.createSuccessResult(output),
+            metadata: {
+                executionTime: Date.now() - startTime,
+                taskId: item.id,
+                todoCount: todos.size,
+            },
+        };
+    }
+}
+export class TodoListTool extends BaseTool {
+    constructor(config) {
+        super('TodoList', 'TodoList', `List all tasks with their current status, IDs, and progress summary.`, {
+            type: 'object',
+            properties: {},
+            required: [],
+        });
+    }
+    validateToolParams(_params) {
+        return null;
+    }
+    getDescription(_params) {
+        return 'Listing tasks';
+    }
+    async execute(_params, signal) {
+        const startTime = Date.now();
+        if (signal.aborted) {
+            return {
+                ...this.createErrorResult('Cancelled'),
+                metadata: { executionTime: Date.now() - startTime },
+            };
+        }
+        return {
+            ...this.createSuccessResult(formatTodoList()),
+            metadata: {
+                executionTime: Date.now() - startTime,
+                todoCount: todos.size,
+                pendingCount: Array.from(todos.values()).filter((t) => t.status === 'pending').length,
+                inProgressCount: Array.from(todos.values()).filter((t) => t.status === 'in_progress').length,
+                completedCount: Array.from(todos.values()).filter((t) => t.status === 'completed').length,
+            },
+        };
+    }
+}
+//# sourceMappingURL=TodoWriteTool.js.map

package/dist/implementations/ui/TodoWriteTool.js.map

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

package/dist/implementations/ui/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * UI/Planning Tool Implementations
+ *
+ * Tools for user interaction and task management
+ */
+export * from './TodoWriteTool.js';
+export * from './AskUserQuestionTool.js';
+export * from './ExitPlanModeTool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/implementations/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/implementations/ui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/implementations/ui/index.js

@@ -0,0 +1,9 @@
+/**
+ * UI/Planning Tool Implementations
+ *
+ * Tools for user interaction and task management
+ */
+export * from './TodoWriteTool.js'; // Now exports TodoCreateTool, TodoUpdateTool, TodoListTool
+export * from './AskUserQuestionTool.js';
+export * from './ExitPlanModeTool.js';
+//# sourceMappingURL=index.js.map

package/dist/implementations/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/implementations/ui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC,CAAE,2DAA2D;AAChG,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/implementations/web/BrowseTool.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Browse Tool — dispatches a nexus-browser subagent.
+ *
+ * Rationale: nexus-browser exposes 43 MCP tools (~12.5K input tokens). Injecting
+ * them into every request bloats the parent's context for sessions that never
+ * browse. Instead, `Browse` is a single small entry tool on the parent. When
+ * invoked, it spawns a subagent that — and only that — gets MCP_AUTO_INJECT
+ * enabled, picks up the full nexus-browser surface, completes the task, and
+ * returns a concise result to the parent.
+ *
+ * The parent's tool/context surface never grows. The subagent runs in its own
+ * forked process and its context window doesn't share with the parent.
+ *
+ * OSS boundary: nexus-browser is still reached only via MCP protocol with
+ * auth gating. The subagent uses the same MCP client + API key validation as
+ * any other MCP consumer; this tool just controls _when_ those tools are
+ * exposed (subagent-scoped, not parent-scoped).
+ */
+import { BaseTool } from '../../base/BaseTool.js';
+import type { ToolResult } from '../../base/ToolResult.js';
+/**
+ * Build a ToolResult that hands off to the orchestrator's subagent
+ * dispatcher, configured for the browse-agent + nexus-browser MCP.
+ *
+ * Exported so WebSearchTool/WebFetchTool can reuse it for `mode: 'interactive'`
+ * without duplicating the dispatch contract.
+ */
+export declare function buildBrowseSubagentDispatch(taskPrompt: string, startingUrl: string | undefined, llmDisplay: string, startTime?: number): ToolResult;
+export interface BrowseParams {
+    /** What the subagent should accomplish (e.g. "extract the top-5 stories from HN front page"). */
+    task: string;
+    /** Optional starting URL the subagent should browse to first. */
+    url?: string;
+    /** Optional model override (e.g. "sonnet"). Defaults to parent's current model. */
+    model?: string;
+}
+export declare class BrowseTool extends BaseTool<BrowseParams, ToolResult> {
+    constructor();
+    validateToolParams(params: BrowseParams): string | null;
+    getDescription(params: BrowseParams): string;
+    execute(params: BrowseParams): Promise<ToolResult>;
+}
+//# sourceMappingURL=BrowseTool.d.ts.map

package/dist/implementations/web/BrowseTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowseTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/web/BrowseTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,UAAU,CAgBZ;AAED,MAAM,WAAW,YAAY;IAC3B,iGAAiG;IACjG,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgED,qBAAa,UAAW,SAAQ,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;;IAuChE,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAwBvD,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAKtC,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;CAwBzD"}

package/dist/implementations/web/BrowseTool.js

@@ -0,0 +1,181 @@
+/**
+ * Browse Tool — dispatches a nexus-browser subagent.
+ *
+ * Rationale: nexus-browser exposes 43 MCP tools (~12.5K input tokens). Injecting
+ * them into every request bloats the parent's context for sessions that never
+ * browse. Instead, `Browse` is a single small entry tool on the parent. When
+ * invoked, it spawns a subagent that — and only that — gets MCP_AUTO_INJECT
+ * enabled, picks up the full nexus-browser surface, completes the task, and
+ * returns a concise result to the parent.
+ *
+ * The parent's tool/context surface never grows. The subagent runs in its own
+ * forked process and its context window doesn't share with the parent.
+ *
+ * OSS boundary: nexus-browser is still reached only via MCP protocol with
+ * auth gating. The subagent uses the same MCP client + API key validation as
+ * any other MCP consumer; this tool just controls _when_ those tools are
+ * exposed (subagent-scoped, not parent-scoped).
+ */
+import { BaseTool } from '../../base/BaseTool.js';
+/**
+ * Build a ToolResult that hands off to the orchestrator's subagent
+ * dispatcher, configured for the browse-agent + nexus-browser MCP.
+ *
+ * Exported so WebSearchTool/WebFetchTool can reuse it for `mode: 'interactive'`
+ * without duplicating the dispatch contract.
+ */
+export function buildBrowseSubagentDispatch(taskPrompt, startingUrl, llmDisplay, startTime) {
+    const fullPrompt = startingUrl ? `Start at: ${startingUrl}\n\n${taskPrompt}` : taskPrompt;
+    return {
+        llmContent: llmDisplay,
+        returnDisplay: llmDisplay,
+        success: true,
+        metadata: {
+            agentDefinition: INLINE_BROWSE_AGENT,
+            agentName: INLINE_BROWSE_AGENT.name,
+            taskPrompt: fullPrompt,
+            shouldSpawnSubAgent: true,
+            envOverrides: { MCP_AUTO_INJECT: 'true' },
+            description: llmDisplay.slice(0, 200),
+            ...(startTime !== undefined ? { executionTime: Date.now() - startTime } : {}),
+        },
+    };
+}
+/**
+ * Inline agent definition used when no `.cortex/agents/browse-agent.md`
+ * override is present on disk. Users can drop a file with the same name to
+ * customize the system prompt or tool whitelist; the lookup happens through
+ * AgentStore at dispatch time.
+ *
+ * Tool whitelist intentionally omits filesystem writers so the subagent can't
+ * be coerced into writing to the parent's workspace. Read tools stay so the
+ * subagent can save scraped content as artifacts via CreateArtifactTool.
+ */
+const INLINE_BROWSE_AGENT = {
+    name: 'browse-agent',
+    description: 'Headless-browser subagent — drives nexus-browser MCP tools to complete a web task.',
+    systemPrompt: `You are a browser automation subagent. You have access to the nexus-browser MCP server,
+which provides a full headless Chrome controlled through ~43 tools (browse, scan, click, type,
+fill_form, extract_table, screenshot, etc.).
+
+## How to work
+
+1. Read the task carefully. Identify the success criterion — what result the parent agent needs back.
+2. Open the starting URL (if provided) with \`nexus-browser__browse\`. Otherwise pick a starting page yourself.
+3. Use the Scan → Act → Scan loop:
+   - \`nexus-browser__scan({ filter: { isInteractive: true } })\` to find elements with CSS selectors
+   - \`nexus-browser__click\` / \`nexus-browser__type\` / \`nexus-browser__select\` using the returned cssSelector
+   - \`nexus-browser__scan\` again to verify
+4. To read text from the page prefer \`nexus-browser__grab\` (cheap) over \`nexus-browser__screenshot\` (expensive).
+5. For lists / structured data use \`nexus-browser__extract_table\`, \`nexus-browser__extract_links\`,
+   or \`nexus-browser__scroll_and_collect\`.
+6. If you hit a CAPTCHA or interstitial, \`nexus-browser__detect_challenge\` then \`nexus-browser__solve_challenge\`.
+7. Always \`nexus-browser__close_session\` when done so the headless tab is released.
+
+## Output discipline
+
+Return ONE concise text reply to the parent containing exactly the information requested. Do not
+narrate the steps you took. Do not include screenshots unless they are the requested output. If the
+task asked for structured data, return it as a small JSON object or markdown table — not prose
+describing the data.
+
+## Failure modes
+
+- If the page never loads, or stays blocked behind a challenge you cannot solve, return a one-line
+  failure summary so the parent can decide whether to retry with a different approach.
+- Don't browse off-task. If the page links somewhere irrelevant, don't follow it.
+- Don't loop. If three consecutive scan/act cycles produce no new information, you're done.
+`,
+    // Whitelist: only browser tools + read/grep/glob for searching captured content. No write/edit/bash.
+    tools: [
+        'Read',
+        'Grep',
+        'Glob',
+        'TodoCreate',
+        'TodoUpdate',
+        'TodoList',
+        // nexus-browser tools are auto-injected by the subagent's MCP_AUTO_INJECT=true override;
+        // the agent definition's tool list is a soft preference, the actual exposure is governed
+        // by which MCP server is connected at fork time.
+    ],
+    model: 'inherit',
+    location: 'project',
+    filePath: '<inline:browse-agent>',
+};
+export class BrowseTool extends BaseTool {
+    constructor() {
+        super('Browse', 'Browse', `Drives a headless browser via a subagent. Use when you need to:
+- interact with a page (click, fill forms, log in)
+- scrape JS-rendered SPA content that plain HTTP fetch can't see
+- bypass simple bot-protection or CAPTCHA
+- collect data across multiple pages
+
+The subagent runs in its own forked process with the full nexus-browser MCP toolset
+(~43 tools). The parent's context stays clean — only this single tool definition is
+visible here, not the 43-tool browser surface.
+
+For static text search use WebSearch (faster, cheaper). For simple URL reads use WebFetch.
+Reach for Browse only when those two won't work.`, {
+            type: 'object',
+            properties: {
+                task: {
+                    type: 'string',
+                    description: 'What the browser subagent should accomplish. Be specific about the success criterion — what data or outcome should it return?',
+                },
+                url: {
+                    type: 'string',
+                    description: 'Optional starting URL. If omitted, the subagent picks a starting page based on the task.',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Optional model override (sonnet, opus, haiku). Defaults to parent\'s current model.',
+                },
+            },
+            required: ['task'],
+        });
+    }
+    validateToolParams(params) {
+        if (typeof params.task !== 'string' || params.task.trim().length === 0) {
+            return 'task must be a non-empty string';
+        }
+        if (params.task.length > 4000) {
+            return 'task must be 4000 characters or less';
+        }
+        if (params.url !== undefined) {
+            if (typeof params.url !== 'string' || params.url.trim().length === 0) {
+                return 'url, if provided, must be a non-empty string';
+            }
+            // Light validation — let the subagent handle proto-less URLs etc.
+            if (params.url.length > 2048) {
+                return 'url must be 2048 characters or less';
+            }
+        }
+        if (params.model !== undefined) {
+            if (!['sonnet', 'opus', 'haiku', 'inherit'].includes(params.model)) {
+                return 'model must be one of: sonnet, opus, haiku, inherit';
+            }
+        }
+        return null;
+    }
+    getDescription(params) {
+        const target = params.url ? ` at ${params.url}` : '';
+        return `Dispatching browser subagent: ${params.task.slice(0, 80)}${target}`;
+    }
+    async execute(params) {
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            return this.createErrorResult(validationError);
+        }
+        // Recursion guard: subagents must never spawn a child Browse subagent.
+        // Without this, the browse-agent gets the parent's Browse tool definition,
+        // calls it, spawns another browse-agent, and burns time + tokens. The
+        // subagent already has the full nexus-browser MCP toolset via the fork's
+        // env override — it should use those directly.
+        if ((process.env.CORTEX_AGENT_MODE) === 'true') {
+            return this.createErrorResult('Browse is a parent-only tool. You are already running inside a subagent with direct access to nexus-browser__* tools. ' +
+                'Use `nexus-browser__browse({ url })` to open a page, then `nexus-browser__scan` / `nexus-browser__grab` etc. to interact with it.');
+        }
+        return buildBrowseSubagentDispatch(params.task, params.url, `Dispatching Browse subagent: ${params.task.slice(0, 160)}`);
+    }
+}
+//# sourceMappingURL=BrowseTool.js.map

package/dist/implementations/web/BrowseTool.js.map

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

package/dist/implementations/web/SandboxTransferTool.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SandboxTransfer Tool Executor
+ *
+ * Runs a command in a remote sandbox (via MCP run_command), captures its
+ * stdout, and writes the output to the local filesystem.  Closes the loop
+ * between sandbox-generated artifacts (PDFs, images, data) and local files.
+ *
+ * Uses late-bound mcpManagerGetter injected into ExecutorConfig by
+ * OrchestratorFactory after MCP initialisation.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+export interface SandboxTransferParams {
+    command: string;
+    local_path: string;
+    encoding?: 'base64' | 'utf8';
+    mime_type?: string;
+    timeout?: number;
+    server?: string;
+}
+export declare class SandboxTransferTool extends BaseTool<SandboxTransferParams, ToolResult> {
+    private config;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: SandboxTransferParams): string | null;
+    getDescription(params: SandboxTransferParams): string;
+    execute(params: SandboxTransferParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    private extractStdout;
+    private extractField;
+}
+//# sourceMappingURL=SandboxTransferTool.d.ts.map

package/dist/implementations/web/SandboxTransferTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxTransferTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/web/SandboxTransferTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAsBjE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,mBAAoB,SAAQ,QAAQ,CAAC,qBAAqB,EAAE,UAAU,CAAC;IACtE,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IA6C1C,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI;IAqBhE,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM;IAQ/C,OAAO,CACX,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IAkJtB,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,YAAY;CAiBrB"}