@femtomc/mu-agent 26.2.69 → 26.2.70

package/dist/extensions/orchestration-runs.js

@@ -1,12 +1,138 @@
 import { StringEnum } from "@mariozechner/pi-ai";
 import { Type } from "@sinclair/typebox";
-import { clampInt, fetchMuJson, textResult, toJsonText } from "./shared.js";
+import { asArray, asNumber, asRecord, asString, clampInt, fetchMuJson, parseFieldPaths, previewLines, previewText, selectFields, textResult, toJsonText, } from "./shared.js";
 function trimOrNull(value) {
     if (value == null)
         return null;
     const trimmed = value.trim();
     return trimmed.length > 0 ? trimmed : null;
 }
+function summarizeRun(run) {
+    return {
+        job_id: asString(run.job_id),
+        root_issue_id: asString(run.root_issue_id),
+        status: asString(run.status),
+        source: asString(run.source),
+        started_at_ms: asNumber(run.started_at_ms),
+        finished_at_ms: asNumber(run.finished_at_ms),
+        exit_code: asNumber(run.exit_code),
+        provider: asString(run.provider),
+        model: asString(run.model),
+        reasoning: asString(run.reasoning),
+        prompt_preview: previewText(run.prompt, 140),
+    };
+}
+function summarizeTrace(trace, lineLimit) {
+    const run = asRecord(trace.run);
+    return {
+        run: run ? summarizeRun(run) : null,
+        stdout: previewLines(trace.stdout, { maxLines: lineLimit, maxCharsPerLine: 220 }),
+        stderr: previewLines(trace.stderr, { maxLines: lineLimit, maxCharsPerLine: 220 }),
+        log_hints: asArray(trace.log_hints).slice(0, 20),
+        trace_files: asArray(trace.trace_files).slice(0, 20),
+    };
+}
+function runFromStartEvent(event) {
+    const runId = asString(event.run_id);
+    if (!runId) {
+        return null;
+    }
+    const payload = asRecord(event.payload);
+    const issueId = asString(event.issue_id);
+    const role = payload ? asString(payload.role) : null;
+    const explicitRoot = payload ? asString(payload.root_issue_id) : null;
+    const rootIssueId = explicitRoot ?? (role === "orchestrator" ? issueId : null);
+    return {
+        job_id: runId,
+        root_issue_id: rootIssueId,
+        issue_id: issueId,
+        role,
+        status: "history",
+        source: "event_log",
+        started_at_ms: asNumber(event.ts_ms),
+        finished_at_ms: null,
+        exit_code: null,
+        provider: payload ? asString(payload.provider) : null,
+        model: payload ? asString(payload.model) : null,
+        reasoning: payload ? asString(payload.reasoning) : null,
+        prompt: payload ? asString(payload.prompt) : null,
+    };
+}
+async function fetchHistoricalRuns(limit) {
+    const payload = await fetchMuJson(`/api/events?type=backend.run.start&limit=${Math.max(limit * 4, 80)}`);
+    const payloadRecord = asRecord(payload);
+    const events = Array.isArray(payload) ? payload : asArray(payloadRecord?.events);
+    const runIndex = new Map();
+    const runs = [];
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = asRecord(events[index]);
+        if (!event) {
+            continue;
+        }
+        const run = runFromStartEvent(event);
+        if (!run) {
+            continue;
+        }
+        const runId = asString(run.job_id);
+        if (!runId) {
+            continue;
+        }
+        const existingIdx = runIndex.get(runId);
+        if (existingIdx == null) {
+            if (runs.length >= limit) {
+                continue;
+            }
+            runIndex.set(runId, runs.length);
+            runs.push(run);
+            continue;
+        }
+        const existing = runs[existingIdx];
+        if (!asString(existing.root_issue_id)) {
+            existing.root_issue_id = asString(run.root_issue_id) ?? asString(run.issue_id);
+        }
+        if (!asString(existing.provider)) {
+            existing.provider = asString(run.provider);
+        }
+        if (!asString(existing.model)) {
+            existing.model = asString(run.model);
+        }
+        if (!asString(existing.reasoning)) {
+            existing.reasoning = asString(run.reasoning);
+        }
+        if (!asString(existing.prompt)) {
+            existing.prompt = asString(run.prompt);
+        }
+    }
+    return runs;
+}
+async function findHistoricalRun(idOrRoot) {
+    const payload = await fetchMuJson("/api/events?type=backend.run.start&limit=200");
+    const payloadRecord = asRecord(payload);
+    const events = Array.isArray(payload) ? payload : asArray(payloadRecord?.events);
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = asRecord(events[index]);
+        if (!event) {
+            continue;
+        }
+        const run = runFromStartEvent(event);
+        if (!run) {
+            continue;
+        }
+        const runId = asString(run.job_id);
+        const rootIssueId = asString(run.root_issue_id);
+        if (runId === idOrRoot || rootIssueId === idOrRoot) {
+            return run;
+        }
+    }
+    return null;
+}
+function isRunNotFoundError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const message = error.message.toLowerCase();
+    return message.includes("mu server 404") || message.includes("run not found");
+}
 export function orchestrationRunsExtension(pi) {
     const RunsParams = Type.Object({
         action: StringEnum(["list", "status", "start", "resume", "interrupt", "heartbeat", "trace"]),
@@ -14,14 +140,17 @@ export function orchestrationRunsExtension(pi) {
         root_issue_id: Type.Optional(Type.String({ description: "Run root issue ID (mu-...)" })),
         prompt: Type.Optional(Type.String({ description: "Prompt for run start" })),
         max_steps: Type.Optional(Type.Number({ description: "Optional max steps for start/resume" })),
-        limit: Type.Optional(Type.Number({ description: "Optional limit (list/trace)" })),
+        limit: Type.Optional(Type.Number({ description: "Optional limit (list/trace). Defaults to 20 for list and 40 lines for trace." })),
         status: Type.Optional(Type.String({ description: "Optional status filter for list" })),
+        fields: Type.Optional(Type.String({
+            description: "Comma-separated fields for status/trace selection (e.g. status,exit_code,prompt)",
+        })),
         reason: Type.Optional(Type.String({ description: "Optional heartbeat reason (default: manual)" })),
     });
     pi.registerTool({
         name: "mu_runs",
         label: "Runs",
-        description: "Manage orchestration runs. Actions: list, status, start, resume, interrupt, heartbeat, trace (stdout/stderr + .mu/log hints).",
+        description: "Manage orchestration runs. Actions: list, status, start, resume, interrupt, heartbeat, trace. List/trace return compact summaries; use fields for precise retrieval.",
         parameters: RunsParams,
         async execute(_toolCallId, params) {
             switch (params.action) {
@@ -30,17 +159,54 @@ export function orchestrationRunsExtension(pi) {
                     const status = trimOrNull(params.status);
                     if (status)
                         query.set("status", status);
-                    const limit = clampInt(params.limit, 50, 1, 500);
+                    const limit = clampInt(params.limit, 20, 1, 500);
                     query.set("limit", String(limit));
                     const payload = await fetchMuJson(`/api/runs?${query.toString()}`);
-                    return textResult(toJsonText(payload), { action: "list", status, limit });
+                    let records = asArray(payload.runs)
+                        .map((run) => asRecord(run))
+                        .filter((run) => run != null);
+                    let source = "run_supervisor";
+                    if (records.length === 0 && (status == null || status === "history")) {
+                        records = await fetchHistoricalRuns(limit);
+                        source = "event_log";
+                    }
+                    const runs = records.map((run) => summarizeRun(run));
+                    return textResult(toJsonText({ count: runs.length, source, runs }), {
+                        action: "list",
+                        status,
+                        limit,
+                        source,
+                        payload,
+                        runs: records,
+                    });
                 }
                 case "status": {
                     const id = trimOrNull(params.job_id) ?? trimOrNull(params.root_issue_id);
                     if (!id)
                         return textResult("status requires job_id or root_issue_id");
-                    const payload = await fetchMuJson(`/api/runs/${encodeURIComponent(id)}`);
-                    return textResult(toJsonText(payload), { action: "status", id });
+                    let payload = null;
+                    let source = "run_supervisor";
+                    try {
+                        payload = await fetchMuJson(`/api/runs/${encodeURIComponent(id)}`);
+                    }
+                    catch (err) {
+                        if (!isRunNotFoundError(err)) {
+                            throw err;
+                        }
+                        payload = await findHistoricalRun(id);
+                        source = "event_log";
+                        if (!payload) {
+                            throw err;
+                        }
+                    }
+                    if (!payload) {
+                        return textResult(`run not found: ${id}`);
+                    }
+                    const fields = parseFieldPaths(trimOrNull(params.fields) ?? undefined);
+                    const content = fields.length > 0
+                        ? { id, source, selected: selectFields(payload, fields) }
+                        : { source, run: summarizeRun(payload) };
+                    return textResult(toJsonText(content), { action: "status", id, source, fields, payload });
                 }
                 case "start": {
                     const prompt = trimOrNull(params.prompt);
@@ -56,7 +222,13 @@ export function orchestrationRunsExtension(pi) {
                             max_steps: maxSteps,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "start", prompt, maxSteps });
+                    const run = asRecord(payload.run);
+                    return textResult(toJsonText({ ok: payload.ok ?? true, run: run ? summarizeRun(run) : null }), {
+                        action: "start",
+                        prompt,
+                        maxSteps,
+                        payload,
+                    });
                 }
                 case "resume": {
                     const rootIssueId = trimOrNull(params.root_issue_id);
@@ -72,7 +244,13 @@ export function orchestrationRunsExtension(pi) {
                             max_steps: maxSteps,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "resume", rootIssueId, maxSteps });
+                    const run = asRecord(payload.run);
+                    return textResult(toJsonText({ ok: payload.ok ?? true, run: run ? summarizeRun(run) : null }), {
+                        action: "resume",
+                        rootIssueId,
+                        maxSteps,
+                        payload,
+                    });
                 }
                 case "interrupt": {
                     const jobId = trimOrNull(params.job_id);
@@ -87,7 +265,12 @@ export function orchestrationRunsExtension(pi) {
                             root_issue_id: rootIssueId,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "interrupt", jobId, rootIssueId });
+                    const run = asRecord(payload.run);
+                    return textResult(toJsonText({
+                        ok: payload.ok ?? null,
+                        reason: payload.reason ?? null,
+                        run: run ? summarizeRun(run) : null,
+                    }), { action: "interrupt", jobId, rootIssueId, payload });
                 }
                 case "heartbeat": {
                     const jobId = trimOrNull(params.job_id);
@@ -104,15 +287,24 @@ export function orchestrationRunsExtension(pi) {
                             reason,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "heartbeat", jobId, rootIssueId, reason });
+                    const run = asRecord(payload.run);
+                    return textResult(toJsonText({
+                        ok: payload.ok ?? null,
+                        reason: payload.reason ?? null,
+                        run: run ? summarizeRun(run) : null,
+                    }), { action: "heartbeat", jobId, rootIssueId, reason, payload });
                 }
                 case "trace": {
                     const id = trimOrNull(params.job_id) ?? trimOrNull(params.root_issue_id);
                     if (!id)
                         return textResult("trace requires job_id or root_issue_id");
-                    const limit = clampInt(params.limit, 200, 1, 2_000);
-                    const payload = await fetchMuJson(`/api/runs/${encodeURIComponent(id)}/trace?limit=${limit}`);
-                    return textResult(toJsonText(payload), { action: "trace", id, limit });
+                    const lineLimit = clampInt(params.limit, 40, 1, 200);
+                    const payload = await fetchMuJson(`/api/runs/${encodeURIComponent(id)}/trace?limit=${Math.max(lineLimit, 80)}`);
+                    const fields = parseFieldPaths(trimOrNull(params.fields) ?? undefined);
+                    const content = fields.length > 0
+                        ? { id, selected: selectFields(payload, fields) }
+                        : summarizeTrace(payload, lineLimit);
+                    return textResult(toJsonText(content), { action: "trace", id, lineLimit, fields, payload });
                 }
                 default:
                     return textResult(`unknown action: ${params.action}`);

package/dist/extensions/server-tools.d.ts

@@ -6,10 +6,20 @@
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 export type ServerToolsExtensionOpts = {
     allowForumPost?: boolean;
+    allowIssueMutations?: boolean;
+    allowIdentityMutations?: boolean;
+    includeStatusTool?: boolean;
+    includeControlPlaneTool?: boolean;
+    includeIssuesTool?: boolean;
+    includeForumTool?: boolean;
+    includeEventsTool?: boolean;
+    includeIdentityTool?: boolean;
     toolIntroLine?: string;
+    usageLine?: string;
     extraSystemPromptLines?: string[];
 };
 export declare function serverToolsExtension(pi: ExtensionAPI, opts?: ServerToolsExtensionOpts): void;
 export declare function serverToolsReadOnlyExtension(pi: ExtensionAPI): void;
+export declare function serverToolsIssueForumExtension(pi: ExtensionAPI): void;
 export default serverToolsExtension;
 //# sourceMappingURL=server-tools.d.ts.map

package/dist/extensions/server-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-tools.d.ts","sourceRoot":"","sources":["../../src/extensions/server-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAqFlE,MAAM,MAAM,wBAAwB,GAAG;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC,CAAC;AA2XF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,GAAE,wBAA6B,QAQzF;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,YAAY,QAS5D;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"server-tools.d.ts","sourceRoot":"","sources":["../../src/extensions/server-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAqMlE,MAAM,MAAM,wBAAwB,GAAG;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC,CAAC;AAmqBF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,GAAE,wBAA6B,QAmBzF;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,YAAY,QAkB5D;AAED,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,YAAY,QAe9D;AAED,eAAe,oBAAoB,CAAC"}