@femtomc/mu-agent 26.2.72 → 26.2.74

package/dist/extensions/operator-command.js

@@ -1,231 +0,0 @@
-/**
- * mu_command — Operator mutation tool.
- *
- * Single execution path:
- * - Requires MU_SERVER_URL.
- * - Always POSTs to /api/commands/submit.
- *
- * All command validation/execution must route through the server command pipeline.
- */
-import { StringEnum } from "@mariozechner/pi-ai";
-import { Type } from "@sinclair/typebox";
-export const MU_COMMAND_TOOL_NAME = "mu_command";
-const READONLY_COMMAND_KINDS = new Set([
-    "status",
-    "ready",
-    "issue_list",
-    "issue_get",
-    "forum_read",
-    "run_list",
-    "run_status",
-]);
-function trimOrNull(value) {
-    if (value == null)
-        return null;
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : null;
-}
-function normalizedLimit(value, fallback, min, max) {
-    if (value == null || !Number.isFinite(value)) {
-        return fallback;
-    }
-    return Math.max(min, Math.min(max, Math.trunc(value)));
-}
-async function fetchReadOnlyMirror(serverUrl, params) {
-    if (!READONLY_COMMAND_KINDS.has(params.kind)) {
-        return null;
-    }
-    const base = serverUrl.replace(/\/+$/, "");
-    const limit = normalizedLimit(params.limit, 20, 1, 200);
-    let path = null;
-    switch (params.kind) {
-        case "status":
-            path = "/api/status";
-            break;
-        case "ready":
-            path = `/api/issues/ready?limit=${limit}`;
-            break;
-        case "issue_list":
-            path = `/api/issues?status=open&limit=${limit}`;
-            break;
-        case "issue_get": {
-            const issueId = trimOrNull(params.issue_id);
-            if (!issueId)
-                return { error: "issue_id is required for issue_get mirror fetch" };
-            path = `/api/issues/${encodeURIComponent(issueId)}`;
-            break;
-        }
-        case "forum_read": {
-            const topic = trimOrNull(params.topic);
-            if (!topic)
-                return { error: "topic is required for forum_read mirror fetch" };
-            path = `/api/forum/read?topic=${encodeURIComponent(topic)}&limit=${limit}`;
-            break;
-        }
-        case "run_list":
-            path = `/api/runs?limit=${limit}`;
-            break;
-        case "run_status": {
-            const rootIssueId = trimOrNull(params.root_issue_id);
-            if (!rootIssueId)
-                return { error: "root_issue_id is required for run_status mirror fetch" };
-            path = `/api/runs/${encodeURIComponent(rootIssueId)}`;
-            break;
-        }
-        default:
-            return null;
-    }
-    if (!path) {
-        return null;
-    }
-    try {
-        const response = await fetch(`${base}${path}`);
-        const raw = await response.text();
-        let payload;
-        try {
-            payload = JSON.parse(raw);
-        }
-        catch {
-            payload = raw;
-        }
-        if (!response.ok) {
-            return { error: `mirror fetch failed (${response.status})`, path, payload };
-        }
-        return payload;
-    }
-    catch (err) {
-        return { error: err instanceof Error ? err.message : String(err), path };
-    }
-}
-async function executeViaServer(serverUrl, params) {
-    const url = `${serverUrl.replace(/\/+$/, "")}/api/commands/submit`;
-    const response = await fetch(url, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(params),
-    });
-    const contentType = response.headers.get("content-type") ?? "";
-    const raw = await response.text();
-    let body = null;
-    try {
-        body = JSON.parse(raw);
-    }
-    catch {
-        body = null;
-    }
-    if (!body) {
-        const preview = raw.slice(0, 200).replaceAll(/\s+/g, " ").trim();
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: [
-                        `Command API mismatch at ${url}.`,
-                        `Expected JSON response, got content-type ${contentType || "unknown"} (status ${response.status}).`,
-                        preview ? `Body preview: ${preview}` : "",
-                        "This usually means MU_SERVER_URL points at an outdated server or wrong base URL.",
-                    ]
-                        .filter(Boolean)
-                        .join("\n"),
-                },
-            ],
-            details: {
-                kind: params.kind,
-                error: "command_api_mismatch",
-                status: response.status,
-                content_type: contentType,
-                body_preview: preview,
-                url,
-            },
-        };
-    }
-    if (!response.ok) {
-        const error = typeof body.error === "string" ? body.error : `HTTP ${response.status}`;
-        return {
-            content: [{ type: "text", text: `Command failed: ${error}` }],
-            details: { kind: params.kind, error, status: response.status },
-        };
-    }
-    const result = body.result;
-    const resultKind = typeof result?.kind === "string" ? result.kind : "unknown";
-    let summary;
-    let readResult = null;
-    if (resultKind === "completed" || resultKind === "awaiting_confirmation") {
-        const command = result?.command;
-        summary = `Command ${resultKind}: ${params.kind}`;
-        if (command?.target_type) {
-            summary += ` (${command.target_type})`;
-        }
-        if (resultKind === "completed" && command?.result) {
-            summary += `\n${JSON.stringify(command.result, null, 2)}`;
-        }
-        if (resultKind === "completed" && READONLY_COMMAND_KINDS.has(params.kind)) {
-            readResult = await fetchReadOnlyMirror(serverUrl, params);
-            if (readResult != null) {
-                summary += `\n${JSON.stringify({ query_result: readResult }, null, 2)}`;
-            }
-        }
-    }
-    else if (resultKind === "denied" || resultKind === "invalid" || resultKind === "failed") {
-        const reason = result?.reason ?? "unknown";
-        summary = `Command ${resultKind}: ${reason}`;
-    }
-    else {
-        summary = `Command result: ${resultKind}`;
-    }
-    return {
-        content: [{ type: "text", text: summary }],
-        details: { kind: params.kind, pipeline_result: result, query_result: readResult },
-    };
-}
-export function operatorCommandExtension(pi) {
-    const CommandParams = Type.Object({
-        kind: StringEnum([
-            "status",
-            "ready",
-            "issue_list",
-            "issue_get",
-            "forum_read",
-            "run_list",
-            "run_status",
-            "run_start",
-            "run_resume",
-            "run_interrupt",
-            "reload",
-            "update",
-        ]),
-        prompt: Type.Optional(Type.String({ description: "Prompt for run_start" })),
-        issue_id: Type.Optional(Type.String({ description: "Issue ID for issue_get" })),
-        topic: Type.Optional(Type.String({ description: "Topic for forum_read" })),
-        limit: Type.Optional(Type.Number({ description: "Limit for forum_read / run_resume" })),
-        root_issue_id: Type.Optional(Type.String({ description: "Root issue ID for run_status / run_resume / run_interrupt" })),
-        max_steps: Type.Optional(Type.Number({ description: "Max steps for run_start / run_resume" })),
-    });
-    pi.registerTool({
-        name: MU_COMMAND_TOOL_NAME,
-        label: "Command",
-        description: [
-            "Propose an approved mu command for execution.",
-            "This is the ONLY way to trigger mutations (starting runs, resuming runs, interrupting runs).",
-            "Read-only queries (status, issue_list, etc.) can also be proposed here.",
-            "The command will be validated and executed through the control-plane pipeline.",
-        ].join(" "),
-        parameters: CommandParams,
-        async execute(_toolCallId, params) {
-            const serverUrl = process.env.MU_SERVER_URL;
-            if (serverUrl) {
-                return await executeViaServer(serverUrl, params);
-            }
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "No server running. Start with `mu serve` for command execution.",
-                    },
-                ],
-                details: { kind: params.kind, error: "no_server" },
-            };
-        },
-    });
-}
-export default operatorCommandExtension;

package/dist/extensions/orchestration-runs-readonly.d.ts

@@ -1,4 +0,0 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-export declare function orchestrationRunsReadOnlyExtension(pi: ExtensionAPI): void;
-export default orchestrationRunsReadOnlyExtension;
-//# sourceMappingURL=orchestration-runs-readonly.d.ts.map

package/dist/extensions/orchestration-runs-readonly.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orchestration-runs-readonly.d.ts","sourceRoot":"","sources":["../../src/extensions/orchestration-runs-readonly.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA2JlE,wBAAgB,kCAAkC,CAAC,EAAE,EAAE,YAAY,QA+FlE;AAED,eAAe,kCAAkC,CAAC"}

package/dist/extensions/orchestration-runs-readonly.js

@@ -1,226 +0,0 @@
-import { StringEnum } from "@mariozechner/pi-ai";
-import { Type } from "@sinclair/typebox";
-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 orchestrationRunsReadOnlyExtension(pi) {
-    const RunsParams = Type.Object({
-        action: StringEnum(["list", "status", "trace"]),
-        job_id: Type.Optional(Type.String({ description: "Run job ID" })),
-        root_issue_id: Type.Optional(Type.String({ description: "Run root issue ID (mu-...)" })),
-        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)",
-        })),
-    });
-    pi.registerTool({
-        name: "mu_runs",
-        label: "Runs",
-        description: "Read-only run inspection. Actions: list, status, trace. Returns compact summaries; use fields for precise retrieval.",
-        parameters: RunsParams,
-        async execute(_toolCallId, params) {
-            switch (params.action) {
-                case "list": {
-                    const query = new URLSearchParams();
-                    const status = trimOrNull(params.status);
-                    if (status)
-                        query.set("status", status);
-                    const limit = clampInt(params.limit, 20, 1, 500);
-                    query.set("limit", String(limit));
-                    const payload = await fetchMuJson(`/api/runs?${query.toString()}`);
-                    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");
-                    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 "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 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}`);
-            }
-        },
-    });
-}
-export default orchestrationRunsReadOnlyExtension;

package/dist/extensions/orchestration-runs.d.ts

@@ -1,4 +0,0 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-export declare function orchestrationRunsExtension(pi: ExtensionAPI): void;
-export default orchestrationRunsExtension;
-//# sourceMappingURL=orchestration-runs.d.ts.map

package/dist/extensions/orchestration-runs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orchestration-runs.d.ts","sourceRoot":"","sources":["../../src/extensions/orchestration-runs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA2JlE,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,YAAY,QA8L1D;AAED,eAAe,0BAA0B,CAAC"}