@gonzih/cc-agent 0.15.11 → 0.15.17

package/dist/index.js

@@ -22,6 +22,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { JobManager, normalizeRepoUrl } from "./agent.js";
 import { listDrivers, getDriverStatus } from "./drivers/index.js";
+import { runSwarm, getSwarmStatus, SWARM_MAX_AGENTS_HARD_CAP } from "./swarm.js";
 import { MetaAgentManager } from "./meta-agent.js";
 import { buildEvaluatorTask } from "./evaluator.js";
 import { loadProfiles, upsertProfile, deleteProfile, getProfile, interpolate } from "./profiles.js";
@@ -687,6 +688,95 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             description: "List all available agent drivers and their status (binary found / API key configured). Use this to check which drivers are ready to use before calling spawn_agent with agent_driver.",
             inputSchema: { type: "object", properties: {} },
         },
+        {
+            name: "export_jobs",
+            description: "Export all job records as JSONL or JSON for statistical analysis. Each record includes id, status, repo_url, task (truncated to 500 chars), started_at, finished_at, exit_code, output_lines count, score, and duration_seconds. Use this to pull job traces, compute success rates, and study failure modes.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    days: { type: "number", description: "How many days back to export (default: 7)" },
+                    format: { type: "string", description: "Output format: 'jsonl' (one record per line) or 'json' (array). Default: 'jsonl'" },
+                    status: { type: "string", description: "Filter by status: 'done' | 'failed' | 'cancelled' | 'running' (optional)" },
+                },
+            },
+        },
+        {
+            name: "get_cost_report",
+            description: "Longitudinal cost breakdown for research budget tracking. Returns grouped cost summary with total USD spent, job count, avg cost per job, and avg score. Useful for tracking spending by repo, day, or outcome.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    days: { type: "number", description: "How many days back to include (default: 30)" },
+                    group_by: { type: "string", description: "Group by 'repo' | 'day' | 'status' (default: 'repo')" },
+                },
+            },
+        },
+        {
+            name: "search_jobs",
+            description: "Find jobs by content of task prompt. Returns matching jobs with a task snippet showing match context. Useful for finding all jobs that involved a specific tool, repo, or task type.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Search term to look for in task prompts (case-insensitive)" },
+                    days: { type: "number", description: "How many days back to search (default: 30)" },
+                    status: { type: "string", description: "Filter by status: 'done' | 'failed' | 'cancelled' | 'running' (optional)" },
+                },
+                required: ["query"],
+            },
+        },
+        {
+            name: "swarm_task",
+            description: "Auto-decompose a high-level goal into N parallel sub-tasks, fan out agents across all of them, then run a synthesis agent that produces one unified deliverable. Returns immediately with swarm_id and sub_job_ids. Use get_swarm_status to poll progress.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    repo_url: {
+                        type: "string",
+                        description: "GitHub repo URL for all sub-agents and the synthesis agent",
+                    },
+                    goal: {
+                        type: "string",
+                        description: "High-level goal to decompose and execute across parallel agents",
+                    },
+                    max_agents: {
+                        type: "number",
+                        description: `Maximum number of parallel sub-agents (default 10, hard cap ${SWARM_MAX_AGENTS_HARD_CAP})`,
+                    },
+                    synthesis_output: {
+                        type: "string",
+                        description: "Path in the repo where the synthesis agent writes its deliverable (default: swarm-synthesis.md)",
+                    },
+                    synthesis_prompt: {
+                        type: "string",
+                        description: "Custom instruction for the synthesis agent. Defaults to: review all outputs and write a unified deliverable.",
+                    },
+                    max_budget_per_agent: {
+                        type: "number",
+                        description: "Max USD budget per agent (sub-agents and synthesis). Default 5.",
+                    },
+                    agent_model: {
+                        type: "string",
+                        description: "Model override for all spawned agents (optional)",
+                    },
+                    agent_driver: {
+                        type: "string",
+                        description: "Driver for all spawned agents (optional, default: claude)",
+                    },
+                },
+                required: ["repo_url", "goal"],
+            },
+        },
+        {
+            name: "get_swarm_status",
+            description: "Poll the status of a swarm created by swarm_task. Returns goal, status (running_subs | synthesizing | done | failed), sub_job counts, and synthesis_job_id once spawned.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    swarm_id: { type: "string", description: "Swarm ID returned by swarm_task" },
+                },
+                required: ["swarm_id"],
+            },
+        },
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (req) => {
@@ -695,7 +785,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
     switch (name) {
         case "spawn_agent": {
             const repoUrl = normalizeRepoUrl(a.repo_url);
-            logger.info("tool:spawn_agent", { repo_url: repoUrl, task: a.task?.slice(0, 80) });
+            logger.info("[mcp] spawn_agent", { repo_url: repoUrl, task: a.task?.slice(0, 80) });
             const owner = extractGithubOwner(repoUrl);
             const isTrusted = !owner || TRUSTED_OWNERS.includes(owner);
             const jobId = await manager.spawn({
@@ -786,7 +876,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "get_job_status": {
-            logger.info("tool:get_job_status", { job_id: a.job_id });
+            logger.info("[mcp] get_job_status", { job_id: a.job_id });
             const job = manager.getJob(a.job_id);
             if (!job) {
                 return { content: [{ type: "text", text: JSON.stringify({ error: "Job not found" }) }] };
@@ -822,7 +912,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         case "wait_for_job": {
             const waitJobId = a.job_id;
             const timeoutSeconds = typeof a.timeout_seconds === "number" ? a.timeout_seconds : 300;
-            logger.info("tool:wait_for_job", { job_id: waitJobId, timeout_seconds: timeoutSeconds });
+            logger.info("[mcp] wait_for_job", { job_id: waitJobId, timeout_seconds: timeoutSeconds });
             const TERMINAL_STATUSES = new Set(["done", "failed", "cancelled", "rejected", "interrupted"]);
             const deadlineMs = Date.now() + timeoutSeconds * 1000;
             let waitRecord = await jobStore.getJob(waitJobId);
@@ -858,7 +948,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "get_job_output": {
-            logger.info("tool:get_job_output", { job_id: a.job_id, offset: a.offset });
+            logger.info("[mcp] get_job_output", { job_id: a.job_id, offset: a.offset });
             const offset = typeof a.offset === "number" ? a.offset : 0;
             const { lines, done, toolCalls } = await manager.getOutput(a.job_id, offset);
             return {
@@ -878,7 +968,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "list_jobs": {
-            logger.info("tool:list_jobs");
+            logger.info("[mcp] list_jobs");
             const minScore = typeof a.min_score === "number" ? a.min_score : undefined;
             let jobs = (await jobStore.listJobs()) ?? [];
             if (minScore !== undefined) {
@@ -896,7 +986,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "cancel_job": {
-            logger.info("tool:cancel_job", { job_id: a.job_id });
+            logger.info("[mcp] cancel_job", { job_id: a.job_id });
             const cancelled = manager.cancel(a.job_id);
             return {
                 content: [
@@ -908,7 +998,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "send_message": {
-            logger.info("tool:send_message", { job_id: a.job_id });
+            logger.info("[mcp] send_message", { job_id: a.job_id });
             const result = await manager.sendMessage(a.job_id, a.message);
             return {
                 content: [
@@ -922,7 +1012,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "cost_summary": {
-            logger.info("tool:cost_summary");
+            logger.info("[mcp] cost_summary");
             // Use jobStore (Redis/disk) to include all persisted jobs, not just in-memory ones
             const allRecords = await jobStore.listJobs();
             let totalCostUsd = 0;
@@ -955,12 +1045,12 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "get_version":
-            logger.info("tool:get_version");
+            logger.info("[mcp] get_version");
             return {
                 content: [{ type: "text", text: JSON.stringify({ version: PKG_VERSION }) }],
             };
         case "create_profile": {
-            logger.info("tool:create_profile", { name: a.name });
+            logger.info("[mcp] create_profile", { name: a.name });
             const profileName = a.name;
             if (!/^[\w-]+$/.test(profileName)) {
                 return {
@@ -982,7 +1072,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "list_profiles": {
-            logger.info("tool:list_profiles");
+            logger.info("[mcp] list_profiles");
             const profiles = (await loadProfiles()).map(({ name, repoUrl, description, defaultBudgetUsd, builtin }) => ({
                 name,
                 repoUrl,
@@ -996,7 +1086,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "delete_profile": {
-            logger.info("tool:delete_profile", { name: a.name });
+            logger.info("[mcp] delete_profile", { name: a.name });
             const deleted = await deleteProfile(a.name);
             return {
                 content: [
@@ -1010,7 +1100,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "spawn_from_profile": {
-            logger.info("tool:spawn_from_profile", { profile_name: a.profile_name });
+            logger.info("[mcp] spawn_from_profile", { profile_name: a.profile_name });
             const profile = await getProfile(a.profile_name);
             if (!profile) {
                 return {
@@ -1038,7 +1128,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "create_plan": {
-            logger.info("tool:create_plan", { goal: a.goal?.slice(0, 80) });
+            logger.info("[mcp] create_plan", { goal: a.goal?.slice(0, 80) });
             const goal = a.goal;
             const steps = a.steps;
             const stepIdToJobId = new Map();
@@ -1134,14 +1224,14 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "wake_job": {
-            logger.info("tool:wake_job", { job_id: a.job_id });
+            logger.info("[mcp] wake_job", { job_id: a.job_id });
             const result = await manager.wakeJob(a.job_id);
             return {
                 content: [{ type: "text", text: JSON.stringify(result) }],
             };
         }
         case "list_model_ratings": {
-            logger.info("tool:list_model_ratings");
+            logger.info("[mcp] list_model_ratings");
             const ratingsFile = join(homedir(), ".cc-agent", "model-ratings.jsonl");
             let ratings = [];
             try {
@@ -1157,7 +1247,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "get_logs": {
-            logger.info("tool:get_logs", { lines: a.lines });
+            logger.info("[mcp] get_logs", { lines: a.lines });
             const n = Math.min(typeof a.lines === "number" ? a.lines : 100, 500);
             const logFile = join(homedir(), ".cc-agent", "logs", "cc-agent.log");
             let lines = [];
@@ -1174,7 +1264,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "list_project_issues": {
-            logger.info("tool:list_project_issues", { repo: a.repo });
+            logger.info("[mcp] list_project_issues", { repo: a.repo });
             const repo = a.repo;
             const state = a.state ?? "open";
             const labels = a.labels;
@@ -1196,7 +1286,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             }
         }
         case "work_on_issue": {
-            logger.info("tool:work_on_issue", { repo: a.repo, issue_number: a.issue_number });
+            logger.info("[mcp] work_on_issue", { repo: a.repo, issue_number: a.issue_number });
             const repo = a.repo;
             const issueNumber = a.issue_number;
             const extraContext = a.extra_context;
@@ -1240,7 +1330,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "comment_on_issue": {
-            logger.info("tool:comment_on_issue", { repo: a.repo, issue_number: a.issue_number });
+            logger.info("[mcp] comment_on_issue", { repo: a.repo, issue_number: a.issue_number });
             const repo = a.repo;
             const issueNumber = a.issue_number;
             const body = a.body;
@@ -1253,7 +1343,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             }
         }
         case "close_issue": {
-            logger.info("tool:close_issue", { repo: a.repo, issue_number: a.issue_number });
+            logger.info("[mcp] close_issue", { repo: a.repo, issue_number: a.issue_number });
             const repo = a.repo;
             const issueNumber = a.issue_number;
             const comment = a.comment;
@@ -1269,14 +1359,14 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             }
         }
         case "approve_job": {
-            logger.info("tool:approve_job", { job_id: a.job_id });
+            logger.info("[mcp] approve_job", { job_id: a.job_id });
             const result = await manager.approveJob(a.job_id);
             return {
                 content: [{ type: "text", text: JSON.stringify(result) }],
             };
         }
         case "set_job_score": {
-            logger.info("tool:set_job_score", { job_id: a.job_id, score: a.score });
+            logger.info("[mcp] set_job_score", { job_id: a.job_id, score: a.score });
             const result = manager.setJobScore(a.job_id, a.score, a.reason);
             return {
                 content: [{ type: "text", text: JSON.stringify(result) }],
@@ -1286,7 +1376,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             const repoParam = a.repo;
             const ns = repoParam ?? a.namespace ?? getNamespace();
             const limit = typeof a.limit === "number" ? a.limit : 10;
-            logger.info("tool:get_learnings", { key: ns, limit });
+            logger.info("[mcp] get_learnings", { key: ns, limit });
             const learnings = await learningsStore.getLearnings(ns, limit);
             return {
                 content: [{
@@ -1297,7 +1387,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         }
         case "clear_learnings": {
             const ns = a.namespace ?? getNamespace();
-            logger.info("tool:clear_learnings", { namespace: ns });
+            logger.info("[mcp] clear_learnings", { namespace: ns });
             await learningsStore.clearLearnings(ns);
             return {
                 content: [{
@@ -1307,7 +1397,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "docker_ps": {
-            logger.info("tool:docker_ps");
+            logger.info("[mcp] docker_ps");
             const containers = await listCcAgentContainers();
             return {
                 content: [{
@@ -1317,7 +1407,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "list_token_status": {
-            logger.info("tool:list_token_status");
+            logger.info("[mcp] list_token_status");
             const tokens = loadTokens();
             const status = await getTokenStatus();
             const tokenList = tokens.map((t, i) => ({
@@ -1338,12 +1428,12 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "list_crons": {
-            logger.info("tool:list_crons");
+            logger.info("[mcp] list_crons");
             const crons = await cronEngine.listCrons();
             return { content: [{ type: "text", text: JSON.stringify({ crons, total: crons.length }) }] };
         }
         case "create_cron": {
-            logger.info("tool:create_cron", { schedule: a.schedule });
+            logger.info("[mcp] create_cron", { schedule: a.schedule });
             const cron = await cronEngine.addCron({
                 chatId: typeof a.chat_id === "number" ? a.chat_id : 0,
                 intervalMs: a.interval_ms,
@@ -1355,12 +1445,12 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             return { content: [{ type: "text", text: JSON.stringify(cron) }] };
         }
         case "delete_cron": {
-            logger.info("tool:delete_cron", { cron_id: a.cron_id });
+            logger.info("[mcp] delete_cron", { cron_id: a.cron_id });
             const deleted = await cronEngine.deleteCron(a.cron_id);
             return { content: [{ type: "text", text: JSON.stringify({ deleted, cron_id: a.cron_id }) }] };
         }
         case "update_cron": {
-            logger.info("tool:update_cron", { cron_id: a.cron_id });
+            logger.info("[mcp] update_cron", { cron_id: a.cron_id });
             const updates = {};
             if (typeof a.interval_ms === "number")
                 updates.intervalMs = a.interval_ms;
@@ -1374,7 +1464,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             return { content: [{ type: "text", text: JSON.stringify(updated ?? { error: "cron not found" }) }] };
         }
         case "list_notifications": {
-            logger.info("tool:list_notifications");
+            logger.info("[mcp] list_notifications");
             const ns = getNamespace();
             const redis = getRedis();
             let messages = [];
@@ -1384,7 +1474,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             return { content: [{ type: "text", text: JSON.stringify({ messages, total: messages.length, namespace: ns }) }] };
         }
         case "list_active_repos": {
-            logger.info("tool:list_active_repos");
+            logger.info("[mcp] list_active_repos");
             const redis = getRedis();
             if (!redis)
                 return { content: [{ type: "text", text: "Redis unavailable" }] };
@@ -1431,7 +1521,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "get_pubsub_status": {
-            logger.info("tool:get_pubsub_status");
+            logger.info("[mcp] get_pubsub_status");
             const redis = getRedis();
             if (!redis)
                 return { content: [{ type: "text", text: "Redis unavailable" }] };
@@ -1459,7 +1549,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "start_meta_agent": {
-            logger.info("tool:start_meta_agent", { namespace: a.namespace });
+            logger.info("[mcp] start_meta_agent", { namespace: a.namespace });
             const ns = a.namespace;
             const repoUrl = a.repo_url;
             try {
@@ -1481,7 +1571,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             }
         }
         case "message_meta_agent": {
-            logger.info("tool:message_meta_agent", { namespace: a.namespace });
+            logger.info("[mcp] message_meta_agent", { namespace: a.namespace });
             const ns = a.namespace;
             const message = a.message;
             try {
@@ -1503,7 +1593,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             }
         }
         case "list_meta_agents": {
-            logger.info("tool:list_meta_agents");
+            logger.info("[mcp] list_meta_agents");
             const agents = await metaAgentManager.listMetaAgents();
             return {
                 content: [{
@@ -1513,7 +1603,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             };
         }
         case "stop_meta_agent": {
-            logger.info("tool:stop_meta_agent", { namespace: a.namespace });
+            logger.info("[mcp] stop_meta_agent", { namespace: a.namespace });
             const ns = a.namespace;
             try {
                 await metaAgentManager.stopMetaAgent(ns);
@@ -1534,7 +1624,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             }
         }
         case "list_drivers": {
-            logger.info("tool:list_drivers");
+            logger.info("[mcp] list_drivers");
             const drivers = getDriverStatus();
             return {
                 content: [{
@@ -1547,6 +1637,220 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
                     }],
             };
         }
+        case "export_jobs": {
+            logger.info("[mcp] export_jobs");
+            const days = typeof a.days === "number" ? a.days : 7;
+            const format = a.format === "json" ? "json" : "jsonl";
+            const statusFilter = typeof a.status === "string" ? a.status : undefined;
+            const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+            const allRecords = await jobStore.listJobs();
+            const filtered = allRecords.filter((r) => {
+                if (r.startedAt && new Date(r.startedAt).getTime() < cutoff)
+                    return false;
+                if (!r.startedAt)
+                    return false;
+                if (statusFilter && r.status !== statusFilter)
+                    return false;
+                return true;
+            });
+            const records = filtered.map((r) => {
+                let durationSeconds = null;
+                if (r.startedAt && r.finishedAt) {
+                    durationSeconds = Math.round((new Date(r.finishedAt).getTime() - new Date(r.startedAt).getTime()) / 1000);
+                }
+                return {
+                    id: r.id,
+                    status: r.status,
+                    repo_url: r.repoUrl,
+                    task: (r.task ?? "").slice(0, 500),
+                    started_at: r.startedAt ?? null,
+                    finished_at: r.finishedAt ?? null,
+                    exit_code: r.exitCode ?? null,
+                    output_lines: r.outputLineCount ?? 0,
+                    score: r.score ?? null,
+                    duration_seconds: durationSeconds,
+                };
+            });
+            const text = format === "json"
+                ? JSON.stringify(records)
+                : records.map((r) => JSON.stringify(r)).join("\n");
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        case "get_cost_report": {
+            logger.info("[mcp] get_cost_report");
+            const days = typeof a.days === "number" ? a.days : 30;
+            const groupBy = a.group_by === "day" ? "day" : a.group_by === "status" ? "status" : "repo";
+            const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+            const allRecords = await jobStore.listJobs();
+            const filtered = allRecords.filter((r) => {
+                if (!r.startedAt)
+                    return false;
+                return new Date(r.startedAt).getTime() >= cutoff;
+            });
+            const groups = new Map();
+            for (const r of filtered) {
+                let key;
+                if (groupBy === "day") {
+                    key = r.startedAt ? r.startedAt.slice(0, 10) : "unknown";
+                }
+                else if (groupBy === "status") {
+                    key = r.status;
+                }
+                else {
+                    key = r.repoUrl;
+                }
+                const g = groups.get(key) ?? { total_usd: 0, job_count: 0, scores: [] };
+                g.total_usd += r.costUsd ?? 0;
+                g.job_count += 1;
+                if (r.score != null)
+                    g.scores.push(r.score);
+                groups.set(key, g);
+            }
+            const summary = Array.from(groups.entries())
+                .map(([key, g]) => ({
+                group: key,
+                total_usd: Math.round(g.total_usd * 10000) / 10000,
+                job_count: g.job_count,
+                avg_cost_usd: g.job_count > 0 ? Math.round((g.total_usd / g.job_count) * 10000) / 10000 : 0,
+                avg_score: g.scores.length > 0 ? Math.round((g.scores.reduce((s, v) => s + v, 0) / g.scores.length) * 1000) / 1000 : null,
+            }))
+                .sort((a, b) => b.total_usd - a.total_usd);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ group_by: groupBy, days, total_groups: summary.length, summary }),
+                    }],
+            };
+        }
+        case "search_jobs": {
+            logger.info("[mcp] search_jobs", { query: a.query });
+            const query = (a.query ?? "").toLowerCase();
+            const days = typeof a.days === "number" ? a.days : 30;
+            const statusFilter = typeof a.status === "string" ? a.status : undefined;
+            const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+            if (!query) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: "query is required" }) }],
+                };
+            }
+            const allRecords = await jobStore.listJobs();
+            const matches = allRecords
+                .filter((r) => {
+                if (!r.startedAt)
+                    return false;
+                if (new Date(r.startedAt).getTime() < cutoff)
+                    return false;
+                if (statusFilter && r.status !== statusFilter)
+                    return false;
+                return (r.task ?? "").toLowerCase().includes(query);
+            })
+                .map((r) => {
+                const task = r.task ?? "";
+                const idx = task.toLowerCase().indexOf(query);
+                const start = Math.max(0, idx - 50);
+                const end = Math.min(task.length, idx + query.length + 50);
+                const snippet = (start > 0 ? "…" : "") + task.slice(start, end) + (end < task.length ? "…" : "");
+                return {
+                    id: r.id,
+                    status: r.status,
+                    repo_url: r.repoUrl,
+                    started_at: r.startedAt ?? null,
+                    score: r.score ?? null,
+                    task_snippet: snippet,
+                };
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ query: a.query, days, total: matches.length, matches }),
+                    }],
+            };
+        }
+        case "swarm_task": {
+            const repoUrl = normalizeRepoUrl(a.repo_url);
+            const goal = a.goal;
+            const maxAgents = typeof a.max_agents === "number" ? a.max_agents : 10;
+            if (maxAgents > SWARM_MAX_AGENTS_HARD_CAP) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({ error: `max_agents ${maxAgents} exceeds hard cap of ${SWARM_MAX_AGENTS_HARD_CAP}` }),
+                        }],
+                };
+            }
+            logger.info("[mcp] swarm_task", { repo_url: repoUrl, goal: goal.slice(0, 80), max_agents: maxAgents });
+            try {
+                const result = await runSwarm({
+                    repoUrl,
+                    goal,
+                    maxAgents,
+                    synthesisOutput: a.synthesis_output,
+                    synthesisPrompt: a.synthesis_prompt,
+                    maxBudgetPerAgent: typeof a.max_budget_per_agent === "number" ? a.max_budget_per_agent : 5,
+                    agentModel: a.agent_model,
+                    agentDriver: a.agent_driver,
+                    manager,
+                    redis: getRedis(),
+                    getJobOutput: (id, offset) => jobStore.getOutput(id, offset),
+                });
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                swarm_id: result.swarm_id,
+                                sub_job_ids: result.sub_job_ids,
+                                decomposed_tasks: result.decomposed_tasks,
+                                status: result.status,
+                                message: `Swarm started with ${result.sub_job_ids.length} sub-agents. Use get_swarm_status to poll progress.`,
+                            }),
+                        }],
+                };
+            }
+            catch (err) {
+                logger.error("[mcp] swarm_task failed", { err: String(err) });
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({ error: String(err) }),
+                        }],
+                };
+            }
+        }
+        case "get_swarm_status": {
+            const swarmId = a.swarm_id;
+            logger.info("[mcp] get_swarm_status", { swarm_id: swarmId });
+            const record = await getSwarmStatus(swarmId, getRedis());
+            if (!record) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({ error: `Swarm '${swarmId}' not found` }),
+                        }],
+                };
+            }
+            const subJobsDone = record.sub_job_ids.length;
+            const subJobsFailed = 0; // detailed counts require Redis lookup; status field covers this
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            swarm_id: record.swarm_id,
+                            goal: record.goal,
+                            status: record.status,
+                            sub_job_ids: record.sub_job_ids,
+                            sub_jobs_total: record.sub_job_ids.length,
+                            synthesis_job_id: record.synthesis_job_id ?? null,
+                            synthesis_output: record.synthesis_output,
+                            decomposed_tasks: record.decomposed_tasks,
+                            created_at: record.created_at,
+                            completed_at: record.completed_at ?? null,
+                            error: record.error ?? null,
+                        }),
+                    }],
+            };
+        }
         default:
             throw new Error(`Unknown tool: ${name}`);
     }
@@ -1569,6 +1873,18 @@ await manager.init();
 await seedBuiltinProfiles(profileStore);
 await coordinator.start();
 await cronEngine.start();
+// Startup summary — logged after all engines are initialized
+logger.info("[cc-agent] started", { version: PKG_VERSION, namespace });
+const _startupJobs = manager.list();
+const _jobCounts = {};
+for (const j of _startupJobs)
+    _jobCounts[j.status] = (_jobCounts[j.status] ?? 0) + 1;
+logger.info("[cc-agent] startup", { jobs_total: _startupJobs.length, ..._jobCounts });
+const _startupCrons = await cronEngine.listCrons();
+logger.info("[cc-agent] startup", { crons_loaded: _startupCrons.length });
+for (const _cron of _startupCrons) {
+    logger.info("[cron] registered", { id: _cron.id, schedule: _cron.schedule, intervalMs: _cron.intervalMs });
+}
 metaAgentManager.startPoller();
 const transport = new StdioServerTransport();
 await server.connect(transport);