@seawork/server 1.0.0

package/dist/server/server/agent/mcp-server.js

@@ -0,0 +1,1279 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ensureValidJson } from "../json-utils.js";
+import { AgentPermissionRequestPayloadSchema, AgentPermissionResponseSchema, AgentSnapshotPayloadSchema, } from "../messages.js";
+import { toAgentPayload } from "./agent-projections.js";
+import { curateAgentActivity } from "./activity-curator.js";
+import { appendTimelineItemIfAgentKnown, emitLiveTimelineItemIfAgentKnown, } from "./timeline-append.js";
+import { WaitForAgentTracker } from "./wait-for-agent-tracker.js";
+import { scheduleAgentMetadataGeneration } from "./agent-metadata-generator.js";
+import { expandUserPath, resolvePathFromBase } from "../path-utils.js";
+import { captureTerminalLines } from "../../terminal/terminal.js";
+import { createAgentWorktree, runAsyncWorktreeBootstrap } from "../worktree-bootstrap.js";
+import { ScheduleSummarySchema, StoredScheduleSchema } from "../schedule/types.js";
+import { AGENT_PROVIDER_DEFINITIONS } from "./provider-registry.js";
+import { deleteSeaworkWorktree, listSeaworkWorktrees } from "../../utils/worktree.js";
+import { AgentModelSchema, AgentProviderEnum, AgentStatusEnum, ProviderSummarySchema, parseDurationString, sanitizePermissionRequest, setupFinishNotification, serializeSnapshotWithMetadata, startAgentRun, toScheduleSummary, waitForAgentWithTimeout, } from "./mcp-shared.js";
+const CLAUDE_TO_CODEX_MODE = {
+    plan: "read-only",
+    default: "auto",
+    acceptEdits: "auto",
+    bypassPermissions: "full-access",
+};
+const CODEX_TO_CLAUDE_MODE = {
+    "read-only": "plan",
+    auto: "default",
+    "full-access": "bypassPermissions",
+};
+function mapModeAcrossProviders(sourceMode, sourceProvider, targetProvider) {
+    if (sourceProvider === targetProvider) {
+        return sourceMode;
+    }
+    if (sourceProvider === "claude" && targetProvider === "codex") {
+        const mapped = CLAUDE_TO_CODEX_MODE[sourceMode];
+        if (mapped) {
+            return mapped;
+        }
+        return "auto";
+    }
+    if (sourceProvider === "codex" && targetProvider === "claude") {
+        const mapped = CODEX_TO_CLAUDE_MODE[sourceMode];
+        if (mapped) {
+            return mapped;
+        }
+        return "default";
+    }
+    return sourceMode;
+}
+function resolveChildAgentCwd(params) {
+    const lockedCwd = params.lockedCwd?.trim();
+    if (lockedCwd) {
+        return expandUserPath(lockedCwd);
+    }
+    const requestedCwd = params.requestedCwd?.trim();
+    if (!requestedCwd || !params.allowCustomCwd) {
+        return params.parentCwd;
+    }
+    return resolvePathFromBase(params.parentCwd, requestedCwd);
+}
+const TerminalSummarySchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    cwd: z.string(),
+});
+const WorktreeSummarySchema = z.object({
+    path: z.string(),
+    createdAt: z.string(),
+    branchName: z.string().optional(),
+    head: z.string().optional(),
+});
+function resolveTerminalKeyToken(key, literal) {
+    if (literal) {
+        return key;
+    }
+    switch (key) {
+        case "Enter":
+            return "\r";
+        case "Tab":
+            return "\t";
+        case "Escape":
+            return "\u001b";
+        case "Space":
+            return " ";
+        case "BSpace":
+            return "\u007f";
+        case "C-c":
+            return "\u0003";
+        case "C-d":
+            return "\u0004";
+        case "C-z":
+            return "\u001a";
+        case "C-l":
+            return "\u000c";
+        case "C-a":
+            return "\u0001";
+        case "C-e":
+            return "\u0005";
+        default:
+            return key;
+    }
+}
+export async function createAgentMcpServer(options) {
+    const { agentManager, agentStorage, terminalManager, scheduleService, providerRegistry, callerAgentId, resolveSpeakHandler, resolveCallerContext, logger, } = options;
+    const childLogger = logger.child({ module: "agent", component: "mcp-server" });
+    const waitTracker = new WaitForAgentTracker(logger);
+    const callerContext = callerAgentId ? (resolveCallerContext?.(callerAgentId) ?? null) : null;
+    const server = new McpServer({
+        name: "agent-mcp",
+        version: "2.0.0",
+    });
+    const resolveCallerAgent = () => {
+        if (!callerAgentId) {
+            return null;
+        }
+        const parentAgent = agentManager.getAgent(callerAgentId);
+        if (!parentAgent) {
+            throw new Error(`Parent agent ${callerAgentId} not found`);
+        }
+        return parentAgent;
+    };
+    const resolveScopedCwd = (requestedCwd, options) => {
+        const callerAgent = resolveCallerAgent();
+        if (callerAgent) {
+            return resolveChildAgentCwd({
+                parentCwd: callerAgent.cwd,
+                requestedCwd,
+                lockedCwd: callerContext?.lockedCwd,
+                allowCustomCwd: callerContext?.allowCustomCwd ?? true,
+            });
+        }
+        const trimmedCwd = requestedCwd?.trim();
+        if (!trimmedCwd) {
+            if (options?.required) {
+                throw new Error("cwd is required");
+            }
+            throw new Error("cwd is required when no caller agent is available");
+        }
+        return expandUserPath(trimmedCwd);
+    };
+    const resolveNewAgentScheduleTarget = () => {
+        const callerAgent = resolveCallerAgent();
+        if (callerAgent) {
+            return {
+                type: "new-agent",
+                config: {
+                    provider: callerAgent.provider,
+                    cwd: callerAgent.cwd,
+                    ...(callerAgent.currentModeId ? { modeId: callerAgent.currentModeId } : {}),
+                    ...(callerAgent.config.model ? { model: callerAgent.config.model } : {}),
+                    ...(callerAgent.config.thinkingOptionId
+                        ? { thinkingOptionId: callerAgent.config.thinkingOptionId }
+                        : {}),
+                    ...(callerAgent.config.approvalPolicy
+                        ? { approvalPolicy: callerAgent.config.approvalPolicy }
+                        : {}),
+                    ...(callerAgent.config.sandboxMode
+                        ? { sandboxMode: callerAgent.config.sandboxMode }
+                        : {}),
+                    ...(typeof callerAgent.config.networkAccess === "boolean"
+                        ? { networkAccess: callerAgent.config.networkAccess }
+                        : {}),
+                    ...(typeof callerAgent.config.webSearch === "boolean"
+                        ? { webSearch: callerAgent.config.webSearch }
+                        : {}),
+                    ...(callerAgent.config.title ? { title: callerAgent.config.title } : {}),
+                    ...(callerAgent.config.extra ? { extra: callerAgent.config.extra } : {}),
+                    ...(callerAgent.config.systemPrompt
+                        ? { systemPrompt: callerAgent.config.systemPrompt }
+                        : {}),
+                    ...(callerAgent.config.mcpServers ? { mcpServers: callerAgent.config.mcpServers } : {}),
+                },
+            };
+        }
+        return {
+            type: "new-agent",
+            config: {
+                provider: "claude",
+                cwd: process.cwd(),
+            },
+        };
+    };
+    const agentToAgentInputSchema = {
+        cwd: z
+            .string()
+            .optional()
+            .describe("Optional working directory. Defaults to the caller agent working directory."),
+        title: z
+            .string()
+            .trim()
+            .min(1, "Title is required")
+            .max(60, "Title must be 60 characters or fewer")
+            .describe("Short descriptive title (<= 60 chars) summarizing the agent's focus."),
+        provider: AgentProviderEnum.optional().describe("Optional agent implementation to spawn. Defaults to 'claude'."),
+        model: z.string().optional().describe("Model to use (e.g. claude-sonnet-4-20250514)"),
+        thinking: z.string().optional().describe("Thinking option ID"),
+        labels: z.record(z.string(), z.string()).optional().describe("Labels to set on the agent"),
+        initialPrompt: z
+            .string()
+            .trim()
+            .min(1, "initialPrompt is required")
+            .describe("Required first task to run immediately after creation."),
+        background: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Run agent in background. If false (default), waits for completion or permission request. If true, returns immediately."),
+        notifyOnFinish: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Send a notification prompt to the caller agent when this agent finishes, errors, or needs permission. Requires a caller agent context."),
+    };
+    const topLevelInputSchema = {
+        cwd: z
+            .string()
+            .describe("Required working directory for the agent (absolute, relative, or ~)."),
+        title: z
+            .string()
+            .trim()
+            .min(1, "Title is required")
+            .max(60, "Title must be 60 characters or fewer")
+            .describe("Short descriptive title (<= 60 chars) summarizing the agent's focus."),
+        provider: AgentProviderEnum.optional().describe("Optional agent implementation to spawn. Defaults to 'claude'."),
+        model: z.string().optional().describe("Model to use (e.g. claude-sonnet-4-20250514)"),
+        thinking: z.string().optional().describe("Thinking option ID"),
+        labels: z.record(z.string(), z.string()).optional().describe("Labels to set on the agent"),
+        initialPrompt: z
+            .string()
+            .trim()
+            .min(1, "initialPrompt is required")
+            .describe("Required first task to run immediately after creation."),
+        mode: z
+            .string()
+            .optional()
+            .describe("Optional session mode to configure before the first run."),
+        worktreeName: z
+            .string()
+            .optional()
+            .describe("Optional git worktree branch name (lowercase alphanumerics + hyphen)."),
+        baseBranch: z
+            .string()
+            .optional()
+            .describe("Required when worktreeName is set: the base branch to diff/merge against."),
+        background: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Run agent in background. If false (default), waits for completion or permission request. If true, returns immediately."),
+        notifyOnFinish: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Send a notification prompt to the caller agent when this agent finishes, errors, or needs permission. Requires a caller agent context."),
+    };
+    const createAgentInputSchema = callerAgentId ? agentToAgentInputSchema : topLevelInputSchema;
+    const agentToAgentCreateAgentArgsSchema = z.object(agentToAgentInputSchema);
+    const topLevelCreateAgentArgsSchema = z.object(topLevelInputSchema);
+    if (options.voiceOnly || options.enableVoiceTools || callerContext?.enableVoiceTools) {
+        server.registerTool("speak", {
+            title: "Speak",
+            description: "Speak text to the user via daemon-managed voice output. Blocks until playback completes.",
+            inputSchema: {
+                text: z
+                    .string()
+                    .trim()
+                    .min(1, "text is required")
+                    .max(4000, "text must be 4000 characters or fewer"),
+            },
+            outputSchema: {
+                ok: z.boolean(),
+            },
+        }, async (args, context) => {
+            if (!callerAgentId) {
+                throw new Error("speak is only available to agent-scoped MCP sessions");
+            }
+            const handler = resolveSpeakHandler?.(callerAgentId) ?? null;
+            if (!handler) {
+                throw new Error(`No speak handler registered for caller agent '${callerAgentId}'`);
+            }
+            await handler({
+                text: args.text,
+                callerAgentId,
+                signal: context?.signal,
+            });
+            return {
+                content: [],
+                structuredContent: ensureValidJson({ ok: true }),
+            };
+        });
+    }
+    if (options.voiceOnly) {
+        return server;
+    }
+    server.registerTool("create_agent", {
+        title: "Create agent",
+        description: "Create a new Claude or Codex agent tied to a working directory. Optionally run an initial prompt immediately or create a git worktree for the agent.",
+        inputSchema: createAgentInputSchema,
+        outputSchema: {
+            agentId: z.string(),
+            type: AgentProviderEnum,
+            status: AgentStatusEnum,
+            cwd: z.string(),
+            currentModeId: z.string().nullable(),
+            availableModes: z.array(z.object({
+                id: z.string(),
+                label: z.string(),
+                description: z.string().nullable().optional(),
+            })),
+            lastMessage: z.string().nullable().optional(),
+            permission: AgentPermissionRequestPayloadSchema.nullable().optional(),
+        },
+    }, async (args) => {
+        let provider;
+        let initialPrompt;
+        let background = false;
+        let normalizedTitle;
+        let model;
+        let thinking;
+        let labels;
+        let notifyOnFinish = false;
+        let resolvedCwd;
+        let resolvedMode;
+        let worktreeConfig;
+        if (callerAgentId) {
+            const callerArgs = agentToAgentCreateAgentArgsSchema.parse(args);
+            provider = callerArgs.provider ?? "claude";
+            initialPrompt = callerArgs.initialPrompt;
+            background = callerArgs.background ?? false;
+            normalizedTitle = callerArgs.title.trim();
+            model = callerArgs.model;
+            thinking = callerArgs.thinking;
+            labels = callerArgs.labels;
+            notifyOnFinish = callerArgs.notifyOnFinish ?? false;
+            const parentAgent = agentManager.getAgent(callerAgentId);
+            if (!parentAgent) {
+                throw new Error(`Parent agent ${callerAgentId} not found`);
+            }
+            resolvedCwd = resolveChildAgentCwd({
+                parentCwd: parentAgent.cwd,
+                requestedCwd: callerArgs.cwd,
+                lockedCwd: callerContext?.lockedCwd,
+                allowCustomCwd: callerContext?.allowCustomCwd ?? true,
+            });
+            const parentMode = parentAgent.currentModeId;
+            if (parentMode) {
+                resolvedMode = mapModeAcrossProviders(parentMode, parentAgent.provider, provider);
+            }
+        }
+        else {
+            const topLevelArgs = topLevelCreateAgentArgsSchema.parse(args);
+            provider = topLevelArgs.provider ?? "claude";
+            initialPrompt = topLevelArgs.initialPrompt;
+            background = topLevelArgs.background ?? false;
+            normalizedTitle = topLevelArgs.title.trim();
+            model = topLevelArgs.model;
+            thinking = topLevelArgs.thinking;
+            labels = topLevelArgs.labels;
+            notifyOnFinish = topLevelArgs.notifyOnFinish ?? false;
+            const { cwd, mode, worktreeName, baseBranch } = topLevelArgs;
+            resolvedCwd = expandUserPath(cwd);
+            if (worktreeName) {
+                if (!baseBranch) {
+                    throw new Error("baseBranch is required when creating a worktree");
+                }
+                const worktree = await createAgentWorktree({
+                    branchName: worktreeName,
+                    cwd: resolvedCwd,
+                    baseBranch,
+                    worktreeSlug: worktreeName,
+                    seaworkHome: options.seaworkHome,
+                });
+                resolvedCwd = worktree.worktreePath;
+                worktreeConfig = worktree;
+            }
+            resolvedMode = mode;
+        }
+        const childAgentDefaultLabels = callerContext?.childAgentDefaultLabels;
+        const mergedLabels = {
+            ...(callerAgentId ? { "seawork.parent-agent-id": callerAgentId } : {}),
+            ...(childAgentDefaultLabels ?? {}),
+            ...(labels ?? {}),
+        };
+        const snapshot = await agentManager.createAgent({
+            provider,
+            cwd: resolvedCwd,
+            modeId: resolvedMode,
+            title: normalizedTitle ?? undefined,
+            model,
+            thinkingOptionId: thinking,
+        }, undefined, Object.keys(mergedLabels).length > 0 ? { labels: mergedLabels } : undefined);
+        if (worktreeConfig) {
+            void runAsyncWorktreeBootstrap({
+                agentId: snapshot.id,
+                worktree: worktreeConfig,
+                terminalManager: terminalManager ?? null,
+                appendTimelineItem: (item) => appendTimelineItemIfAgentKnown({
+                    agentManager,
+                    agentId: snapshot.id,
+                    item,
+                }),
+                emitLiveTimelineItem: (item) => emitLiveTimelineItemIfAgentKnown({
+                    agentManager,
+                    agentId: snapshot.id,
+                    item,
+                }),
+                logger: childLogger,
+            });
+        }
+        const trimmedPrompt = initialPrompt.trim();
+        scheduleAgentMetadataGeneration({
+            agentManager,
+            agentId: snapshot.id,
+            cwd: snapshot.cwd,
+            initialPrompt: trimmedPrompt,
+            explicitTitle: snapshot.config.title,
+            seaworkHome: options.seaworkHome,
+            logger: childLogger,
+        });
+        try {
+            agentManager.recordUserMessage(snapshot.id, trimmedPrompt, {
+                emitState: false,
+            });
+        }
+        catch (error) {
+            childLogger.error({ err: error, agentId: snapshot.id }, "Failed to record initial prompt");
+        }
+        try {
+            startAgentRun(agentManager, snapshot.id, trimmedPrompt, childLogger);
+            if (notifyOnFinish && callerAgentId) {
+                setupFinishNotification({
+                    agentManager,
+                    childAgentId: snapshot.id,
+                    callerAgentId,
+                    logger: childLogger,
+                });
+            }
+            // If not running in background, wait for completion
+            if (!background) {
+                const result = await waitForAgentWithTimeout(agentManager, snapshot.id, {
+                    waitForActive: true,
+                });
+                const responseData = {
+                    agentId: snapshot.id,
+                    type: provider,
+                    status: result.status,
+                    cwd: snapshot.cwd,
+                    currentModeId: snapshot.currentModeId,
+                    availableModes: snapshot.availableModes,
+                    lastMessage: result.lastMessage,
+                    permission: sanitizePermissionRequest(result.permission),
+                };
+                const validJson = ensureValidJson(responseData);
+                const response = {
+                    content: [],
+                    structuredContent: validJson,
+                };
+                return response;
+            }
+        }
+        catch (error) {
+            childLogger.error({ err: error, agentId: snapshot.id }, "Failed to run initial prompt");
+        }
+        // Return immediately if background=true
+        const response = {
+            content: [],
+            structuredContent: ensureValidJson({
+                agentId: snapshot.id,
+                type: provider,
+                status: snapshot.lifecycle,
+                cwd: snapshot.cwd,
+                currentModeId: snapshot.currentModeId,
+                availableModes: snapshot.availableModes,
+                lastMessage: null,
+                permission: null,
+            }),
+        };
+        return response;
+    });
+    server.registerTool("wait_for_agent", {
+        title: "Wait for agent",
+        description: "Block until the agent requests permission or the current run completes. Returns the pending permission (if any) and recent activity summary.",
+        inputSchema: {
+            agentId: z.string().describe("Agent identifier returned by the create_agent tool"),
+        },
+        outputSchema: {
+            agentId: z.string(),
+            status: AgentStatusEnum,
+            permission: AgentPermissionRequestPayloadSchema.nullable(),
+            lastMessage: z.string().nullable(),
+        },
+    }, async ({ agentId }, { signal }) => {
+        const abortController = new AbortController();
+        const cleanupFns = [];
+        const cleanup = () => {
+            while (cleanupFns.length) {
+                const fn = cleanupFns.pop();
+                try {
+                    fn?.();
+                }
+                catch {
+                    // ignore cleanup errors
+                }
+            }
+        };
+        const forwardExternalAbort = () => {
+            if (!abortController.signal.aborted) {
+                const reason = signal?.reason ?? new Error("wait_for_agent aborted");
+                abortController.abort(reason);
+            }
+        };
+        if (signal) {
+            if (signal.aborted) {
+                forwardExternalAbort();
+            }
+            else {
+                signal.addEventListener("abort", forwardExternalAbort, { once: true });
+                cleanupFns.push(() => signal.removeEventListener("abort", forwardExternalAbort));
+            }
+        }
+        const unregister = waitTracker.register(agentId, (reason) => {
+            if (!abortController.signal.aborted) {
+                abortController.abort(new Error(reason ?? "wait_for_agent cancelled"));
+            }
+        });
+        cleanupFns.push(unregister);
+        try {
+            const result = await waitForAgentWithTimeout(agentManager, agentId, {
+                signal: abortController.signal,
+            });
+            const validJson = ensureValidJson({
+                agentId,
+                status: result.status,
+                permission: sanitizePermissionRequest(result.permission),
+                lastMessage: result.lastMessage,
+            });
+            const response = {
+                content: [],
+                structuredContent: validJson,
+            };
+            return response;
+        }
+        finally {
+            cleanup();
+        }
+    });
+    server.registerTool("send_agent_prompt", {
+        title: "Send agent prompt",
+        description: "Send a task to a running agent. Returns immediately after the agent begins processing.",
+        inputSchema: {
+            agentId: z.string(),
+            prompt: z.string(),
+            sessionMode: z
+                .string()
+                .optional()
+                .describe("Optional mode to set before running the prompt."),
+            background: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Run agent in background. If false (default), waits for completion or permission request. If true, returns immediately."),
+            notifyOnFinish: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Send a notification prompt to the caller agent when this agent finishes, errors, or needs permission."),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            status: AgentStatusEnum,
+            lastMessage: z.string().nullable().optional(),
+            permission: AgentPermissionRequestPayloadSchema.nullable().optional(),
+        },
+    }, async ({ agentId, prompt, sessionMode, background = false, notifyOnFinish = false }) => {
+        const snapshot = agentManager.getAgent(agentId);
+        if (!snapshot) {
+            throw new Error(`Agent ${agentId} not found`);
+        }
+        if (agentManager.hasInFlightRun(agentId)) {
+            waitTracker.cancel(agentId, "Agent run interrupted by new prompt");
+        }
+        if (sessionMode) {
+            await agentManager.setAgentMode(agentId, sessionMode);
+        }
+        try {
+            agentManager.recordUserMessage(agentId, prompt, {
+                emitState: false,
+            });
+        }
+        catch (error) {
+            childLogger.error({ err: error, agentId }, "Failed to record user message");
+        }
+        startAgentRun(agentManager, agentId, prompt, childLogger, {
+            replaceRunning: true,
+        });
+        if (notifyOnFinish && callerAgentId) {
+            setupFinishNotification({
+                agentManager,
+                childAgentId: agentId,
+                callerAgentId,
+                logger: childLogger,
+            });
+        }
+        // If not running in background, wait for completion
+        if (!background) {
+            const result = await waitForAgentWithTimeout(agentManager, agentId, {
+                waitForActive: true,
+            });
+            const responseData = {
+                success: true,
+                status: result.status,
+                lastMessage: result.lastMessage,
+                permission: sanitizePermissionRequest(result.permission),
+            };
+            const validJson = ensureValidJson(responseData);
+            const response = {
+                content: [],
+                structuredContent: validJson,
+            };
+            return response;
+        }
+        // Return immediately if background=true
+        // Re-fetch snapshot since the state may have changed
+        const currentSnapshot = agentManager.getAgent(agentId);
+        const responseData = {
+            success: true,
+            status: currentSnapshot?.lifecycle ?? "idle",
+            lastMessage: null,
+            permission: null,
+        };
+        const validJson = ensureValidJson(responseData);
+        const response = {
+            content: [],
+            structuredContent: validJson,
+        };
+        return response;
+    });
+    server.registerTool("get_agent_status", {
+        title: "Get agent status",
+        description: "Return the latest snapshot for an agent, including lifecycle state, capabilities, and pending permissions.",
+        inputSchema: {
+            agentId: z.string(),
+        },
+        outputSchema: {
+            status: AgentStatusEnum,
+            snapshot: AgentSnapshotPayloadSchema,
+        },
+    }, async ({ agentId }) => {
+        const snapshot = agentManager.getAgent(agentId);
+        if (!snapshot) {
+            throw new Error(`Agent ${agentId} not found`);
+        }
+        const structuredSnapshot = await serializeSnapshotWithMetadata(agentStorage, snapshot, childLogger);
+        return {
+            content: [],
+            structuredContent: ensureValidJson({
+                status: snapshot.lifecycle,
+                snapshot: structuredSnapshot,
+            }),
+        };
+    });
+    server.registerTool("list_agents", {
+        title: "List agents",
+        description: "List all live agents managed by the server.",
+        inputSchema: {},
+        outputSchema: {
+            agents: z.array(AgentSnapshotPayloadSchema),
+        },
+    }, async () => {
+        const snapshots = agentManager.listAgents();
+        const agents = await Promise.all(snapshots.map((snapshot) => serializeSnapshotWithMetadata(agentStorage, snapshot, childLogger)));
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ agents }),
+        };
+    });
+    server.registerTool("cancel_agent", {
+        title: "Cancel agent run",
+        description: "Abort the agent's current run but keep the agent alive for future tasks.",
+        inputSchema: {
+            agentId: z.string(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ agentId }) => {
+        const success = await agentManager.cancelAgentRun(agentId);
+        if (success) {
+            waitTracker.cancel(agentId, "Agent run cancelled");
+        }
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success }),
+        };
+    });
+    server.registerTool("archive_agent", {
+        title: "Archive agent",
+        description: "Archive an agent (soft-delete). The agent is interrupted if running and removed from the active list.",
+        inputSchema: {
+            agentId: z.string(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ agentId }) => {
+        await agentManager.archiveAgent(agentId);
+        waitTracker.cancel(agentId, "Agent archived");
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    server.registerTool("kill_agent", {
+        title: "Kill agent",
+        description: "Terminate an agent session permanently.",
+        inputSchema: {
+            agentId: z.string(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ agentId }) => {
+        await agentManager.closeAgent(agentId);
+        waitTracker.cancel(agentId, "Agent terminated");
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    server.registerTool("update_agent", {
+        title: "Update agent",
+        description: "Update an agent name and/or labels.",
+        inputSchema: {
+            agentId: z.string(),
+            name: z.string().optional(),
+            labels: z.record(z.string(), z.string()).optional().describe("Labels to set on the agent"),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ agentId, name, labels }) => {
+        const trimmedName = name?.trim();
+        if (trimmedName) {
+            const record = await agentStorage.get(agentId);
+            if (!record) {
+                throw new Error(`Agent ${agentId} not found`);
+            }
+            await agentStorage.upsert({
+                ...record,
+                title: trimmedName,
+                updatedAt: new Date().toISOString(),
+            });
+            agentManager.notifyAgentState(agentId);
+        }
+        if (labels) {
+            await agentManager.setLabels(agentId, labels);
+        }
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    server.registerTool("list_terminals", {
+        title: "List terminals",
+        description: "List terminals for a working directory or across all working directories.",
+        inputSchema: {
+            cwd: z
+                .string()
+                .optional()
+                .describe("Optional working directory. Defaults to the caller agent cwd."),
+            all: z.boolean().optional().describe("List terminals across all working directories."),
+        },
+        outputSchema: {
+            terminals: z.array(TerminalSummarySchema),
+        },
+    }, async ({ cwd, all }) => {
+        if (!terminalManager) {
+            throw new Error("Terminal manager is not configured");
+        }
+        const terminals = all
+            ? (await Promise.all(terminalManager.listDirectories().map(async (directory) => (await terminalManager.getTerminals(directory)).map((terminal) => ({
+                id: terminal.id,
+                name: terminal.name,
+                cwd: terminal.cwd,
+            }))))).flat()
+            : (await terminalManager.getTerminals(resolveScopedCwd(cwd, { required: true }))).map((terminal) => ({
+                id: terminal.id,
+                name: terminal.name,
+                cwd: terminal.cwd,
+            }));
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ terminals }),
+        };
+    });
+    server.registerTool("create_terminal", {
+        title: "Create terminal",
+        description: "Create a terminal session for a working directory.",
+        inputSchema: {
+            cwd: z
+                .string()
+                .optional()
+                .describe("Optional working directory. Defaults to the caller agent cwd."),
+            name: z.string().optional().describe("Optional terminal name."),
+        },
+        outputSchema: TerminalSummarySchema.shape,
+    }, async ({ cwd, name }) => {
+        if (!terminalManager) {
+            throw new Error("Terminal manager is not configured");
+        }
+        const terminal = await terminalManager.createTerminal({
+            cwd: resolveScopedCwd(cwd, { required: true }),
+            ...(name?.trim() ? { name: name.trim() } : {}),
+        });
+        return {
+            content: [],
+            structuredContent: ensureValidJson({
+                id: terminal.id,
+                name: terminal.name,
+                cwd: terminal.cwd,
+            }),
+        };
+    });
+    server.registerTool("kill_terminal", {
+        title: "Kill terminal",
+        description: "Kill an existing terminal session.",
+        inputSchema: {
+            terminalId: z.string(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ terminalId }) => {
+        if (!terminalManager) {
+            throw new Error("Terminal manager is not configured");
+        }
+        const terminal = terminalManager.getTerminal(terminalId);
+        if (!terminal) {
+            throw new Error(`Terminal ${terminalId} not found`);
+        }
+        terminal.kill();
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    server.registerTool("capture_terminal", {
+        title: "Capture terminal",
+        description: "Capture plain-text terminal output lines from a terminal session.",
+        inputSchema: {
+            terminalId: z.string(),
+            start: z.number().optional(),
+            end: z.number().optional(),
+            scrollback: z.boolean().optional(),
+            stripAnsi: z.boolean().optional().default(true),
+        },
+        outputSchema: {
+            terminalId: z.string(),
+            lines: z.array(z.string()),
+            totalLines: z.number().int().nonnegative(),
+        },
+    }, async ({ terminalId, start, end, scrollback, stripAnsi = true }) => {
+        if (!terminalManager) {
+            throw new Error("Terminal manager is not configured");
+        }
+        const terminal = terminalManager.getTerminal(terminalId);
+        if (!terminal) {
+            throw new Error(`Terminal ${terminalId} not found`);
+        }
+        const capture = captureTerminalLines(terminal, {
+            start: scrollback ? 0 : start,
+            end,
+            stripAnsi,
+        });
+        return {
+            content: [],
+            structuredContent: ensureValidJson({
+                terminalId,
+                lines: capture.lines,
+                totalLines: capture.totalLines,
+            }),
+        };
+    });
+    server.registerTool("send_terminal_keys", {
+        title: "Send terminal keys",
+        description: "Send literal text or special key tokens to a terminal session.",
+        inputSchema: {
+            terminalId: z.string(),
+            keys: z.string(),
+            literal: z.boolean().optional(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ terminalId, keys, literal = false }) => {
+        if (!terminalManager) {
+            throw new Error("Terminal manager is not configured");
+        }
+        const terminal = terminalManager.getTerminal(terminalId);
+        if (!terminal) {
+            throw new Error(`Terminal ${terminalId} not found`);
+        }
+        terminal.send({
+            type: "input",
+            data: resolveTerminalKeyToken(keys, literal),
+        });
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    server.registerTool("create_schedule", {
+        title: "Create schedule",
+        description: "Create a recurring schedule that runs on an agent or a new agent.",
+        inputSchema: {
+            prompt: z.string().trim().min(1, "prompt is required"),
+            every: z.string().optional(),
+            cron: z.string().optional(),
+            name: z.string().optional(),
+            target: z.enum(["self", "new-agent"]).optional(),
+            maxRuns: z.number().int().positive().optional(),
+            expiresIn: z.string().optional(),
+        },
+        outputSchema: ScheduleSummarySchema.shape,
+    }, async ({ prompt, every, cron, name, target, maxRuns, expiresIn }) => {
+        if (!scheduleService) {
+            throw new Error("Schedule service is not configured");
+        }
+        const cadenceCount = Number(every !== undefined) + Number(cron !== undefined);
+        if (cadenceCount !== 1) {
+            throw new Error("Specify exactly one of every or cron");
+        }
+        const scheduleTarget = target === "self"
+            ? (() => {
+                if (!callerAgentId) {
+                    throw new Error("target=self requires a caller agent");
+                }
+                return { type: "agent", agentId: callerAgentId };
+            })()
+            : resolveNewAgentScheduleTarget();
+        const schedule = await scheduleService.create({
+            prompt: prompt.trim(),
+            cadence: every
+                ? { type: "every", everyMs: parseDurationString(every) }
+                : { type: "cron", expression: cron.trim() },
+            target: scheduleTarget,
+            ...(name?.trim() ? { name: name.trim() } : {}),
+            ...(maxRuns === undefined ? {} : { maxRuns }),
+            ...(expiresIn === undefined
+                ? {}
+                : { expiresAt: new Date(Date.now() + parseDurationString(expiresIn)).toISOString() }),
+        });
+        return {
+            content: [],
+            structuredContent: ensureValidJson(toScheduleSummary(schedule)),
+        };
+    });
+    server.registerTool("list_schedules", {
+        title: "List schedules",
+        description: "List all schedules managed by the daemon.",
+        inputSchema: {},
+        outputSchema: {
+            schedules: z.array(ScheduleSummarySchema),
+        },
+    }, async () => {
+        if (!scheduleService) {
+            throw new Error("Schedule service is not configured");
+        }
+        const schedules = (await scheduleService.list()).map((schedule) => toScheduleSummary(schedule));
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ schedules }),
+        };
+    });
+    server.registerTool("inspect_schedule", {
+        title: "Inspect schedule",
+        description: "Inspect a schedule and its run history.",
+        inputSchema: {
+            id: z.string(),
+        },
+        outputSchema: StoredScheduleSchema.shape,
+    }, async ({ id }) => {
+        if (!scheduleService) {
+            throw new Error("Schedule service is not configured");
+        }
+        const schedule = await scheduleService.inspect(id);
+        return {
+            content: [],
+            structuredContent: ensureValidJson(schedule),
+        };
+    });
+    server.registerTool("pause_schedule", {
+        title: "Pause schedule",
+        description: "Pause an active schedule.",
+        inputSchema: {
+            id: z.string(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ id }) => {
+        if (!scheduleService) {
+            throw new Error("Schedule service is not configured");
+        }
+        await scheduleService.pause(id);
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    server.registerTool("resume_schedule", {
+        title: "Resume schedule",
+        description: "Resume a paused schedule.",
+        inputSchema: {
+            id: z.string(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ id }) => {
+        if (!scheduleService) {
+            throw new Error("Schedule service is not configured");
+        }
+        await scheduleService.resume(id);
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    server.registerTool("delete_schedule", {
+        title: "Delete schedule",
+        description: "Delete a schedule permanently.",
+        inputSchema: {
+            id: z.string(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ id }) => {
+        if (!scheduleService) {
+            throw new Error("Schedule service is not configured");
+        }
+        await scheduleService.delete(id);
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    server.registerTool("list_providers", {
+        title: "List providers",
+        description: "List available agent providers and their modes.",
+        inputSchema: {},
+        outputSchema: {
+            providers: z.array(ProviderSummarySchema),
+        },
+    }, async () => ({
+        content: [],
+        structuredContent: ensureValidJson({
+            providers: AGENT_PROVIDER_DEFINITIONS.map((provider) => ({
+                id: provider.id,
+                label: provider.label,
+                modes: provider.modes.map((mode) => ({
+                    id: mode.id,
+                    label: mode.label,
+                    ...(mode.description ? { description: mode.description } : {}),
+                })),
+            })),
+        }),
+    }));
+    server.registerTool("list_models", {
+        title: "List models",
+        description: "List models for an agent provider.",
+        inputSchema: {
+            provider: AgentProviderEnum,
+        },
+        outputSchema: {
+            provider: z.string(),
+            models: z.array(AgentModelSchema),
+        },
+    }, async ({ provider }) => {
+        if (!providerRegistry) {
+            throw new Error("Provider registry is not configured");
+        }
+        const definition = providerRegistry[provider];
+        if (!definition) {
+            throw new Error(`Provider ${provider} is not configured`);
+        }
+        const models = await definition.fetchModels();
+        return {
+            content: [],
+            structuredContent: ensureValidJson({
+                provider,
+                models,
+            }),
+        };
+    });
+    server.registerTool("list_worktrees", {
+        title: "List worktrees",
+        description: "List Seawork-managed git worktrees for a repository.",
+        inputSchema: {
+            cwd: z
+                .string()
+                .optional()
+                .describe("Optional repository cwd. Defaults to the caller agent cwd."),
+        },
+        outputSchema: {
+            worktrees: z.array(WorktreeSummarySchema),
+        },
+    }, async ({ cwd }) => {
+        const resolvedCwd = resolveScopedCwd(cwd, { required: true });
+        const worktrees = await listSeaworkWorktrees({
+            cwd: resolvedCwd,
+            seaworkHome: options.seaworkHome,
+        });
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ worktrees }),
+        };
+    });
+    server.registerTool("create_worktree", {
+        title: "Create worktree",
+        description: "Create a Seawork-managed git worktree.",
+        inputSchema: {
+            cwd: z
+                .string()
+                .optional()
+                .describe("Optional repository cwd. Defaults to the caller agent cwd."),
+            branchName: z.string(),
+            baseBranch: z.string(),
+        },
+        outputSchema: {
+            branchName: z.string(),
+            worktreePath: z.string(),
+        },
+    }, async ({ cwd, branchName, baseBranch }) => {
+        const worktree = await createAgentWorktree({
+            branchName,
+            cwd: resolveScopedCwd(cwd, { required: true }),
+            baseBranch,
+            worktreeSlug: branchName,
+            seaworkHome: options.seaworkHome,
+        });
+        return {
+            content: [],
+            structuredContent: ensureValidJson({
+                branchName,
+                worktreePath: worktree.worktreePath,
+            }),
+        };
+    });
+    server.registerTool("archive_worktree", {
+        title: "Archive worktree",
+        description: "Delete a Seawork-managed git worktree.",
+        inputSchema: {
+            cwd: z
+                .string()
+                .optional()
+                .describe("Optional repository cwd. Defaults to the caller agent cwd."),
+            worktreePath: z.string().optional(),
+            worktreeSlug: z.string().optional(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ cwd, worktreePath, worktreeSlug }) => {
+        await deleteSeaworkWorktree({
+            cwd: resolveScopedCwd(cwd, { required: true }),
+            worktreePath,
+            worktreeSlug,
+            seaworkHome: options.seaworkHome,
+        });
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    server.registerTool("get_agent_activity", {
+        title: "Get agent activity",
+        description: "Return recent agent timeline entries as a curated summary.",
+        inputSchema: {
+            agentId: z.string(),
+            limit: z
+                .number()
+                .optional()
+                .describe("Optional limit for number of activities to include (most recent first)."),
+        },
+        outputSchema: {
+            agentId: z.string(),
+            updateCount: z.number(),
+            currentModeId: z.string().nullable(),
+            content: z.string(),
+        },
+    }, async ({ agentId, limit }) => {
+        const timeline = agentManager.getTimeline(agentId);
+        const snapshot = agentManager.getAgent(agentId);
+        const activitiesToCurate = limit ? timeline.slice(-limit) : timeline;
+        const curatedContent = curateAgentActivity(activitiesToCurate);
+        const totalCount = timeline.length;
+        const shownCount = activitiesToCurate.length;
+        let countHeader;
+        if (limit && shownCount < totalCount) {
+            countHeader = `Showing ${shownCount} of ${totalCount} ${totalCount === 1 ? "activity" : "activities"} (limited to ${limit})`;
+        }
+        else {
+            countHeader = `Showing all ${totalCount} ${totalCount === 1 ? "activity" : "activities"}`;
+        }
+        const contentWithCount = `${countHeader}\n\n${curatedContent}`;
+        return {
+            content: [],
+            structuredContent: ensureValidJson({
+                agentId,
+                updateCount: timeline.length,
+                currentModeId: snapshot?.currentModeId ?? null,
+                content: contentWithCount,
+            }),
+        };
+    });
+    server.registerTool("set_agent_mode", {
+        title: "Set agent session mode",
+        description: "Switch the agent's session mode (plan, bypassPermissions, read-only, auto, etc.).",
+        inputSchema: {
+            agentId: z.string(),
+            modeId: z.string(),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            newMode: z.string(),
+        },
+    }, async ({ agentId, modeId }) => {
+        await agentManager.setAgentMode(agentId, modeId);
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true, newMode: modeId }),
+        };
+    });
+    server.registerTool("list_pending_permissions", {
+        title: "List pending permissions",
+        description: "Return all pending permission requests across all agents with the normalized payloads.",
+        inputSchema: {},
+        outputSchema: {
+            permissions: z.array(z.object({
+                agentId: z.string(),
+                status: AgentStatusEnum,
+                request: AgentPermissionRequestPayloadSchema,
+            })),
+        },
+    }, async () => {
+        const permissions = agentManager.listAgents().flatMap((agent) => {
+            const payload = toAgentPayload(agent);
+            return payload.pendingPermissions.map((request) => ({
+                agentId: agent.id,
+                status: payload.status,
+                request,
+            }));
+        });
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ permissions }),
+        };
+    });
+    server.registerTool("respond_to_permission", {
+        title: "Respond to permission",
+        description: "Approve or deny a pending permission request with an AgentManager-compatible response payload.",
+        inputSchema: {
+            agentId: z.string(),
+            requestId: z.string(),
+            response: AgentPermissionResponseSchema,
+        },
+        outputSchema: {
+            success: z.boolean(),
+        },
+    }, async ({ agentId, requestId, response }) => {
+        await agentManager.respondToPermission(agentId, requestId, response);
+        return {
+            content: [],
+            structuredContent: ensureValidJson({ success: true }),
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=mcp-server.js.map