@gonzih/cc-agent 0.15.11 → 0.15.16

package/dist/index.js

@@ -687,6 +687,42 @@ 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"],
+            },
+        },
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (req) => {
@@ -695,7 +731,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 +822,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 +858,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 +894,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 +914,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 +932,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 +944,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 +958,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 +991,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 +1018,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 +1032,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 +1046,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 +1074,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 +1170,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 +1193,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 +1210,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 +1232,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 +1276,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 +1289,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 +1305,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 +1322,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 +1333,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 +1343,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 +1353,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 +1374,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 +1391,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 +1410,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 +1420,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 +1467,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 +1495,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 +1517,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 +1539,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 +1549,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 +1570,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 +1583,137 @@ 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 }),
+                    }],
+            };
+        }
         default:
             throw new Error(`Unknown tool: ${name}`);
     }
@@ -1569,6 +1736,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);