@femtomc/mu-agent 26.2.41 → 26.2.43

package/README.md

@@ -10,6 +10,17 @@ This package provides reusable runtime pieces for chat, orchestration, and serve
 - pi CLI/SDK orchestration backends and resource loader helpers
 - Prompt/template helpers used by orchestration roles
 
+## Bundled default prompts
+
+Bundled defaults now live as markdown files under `packages/agent/prompts/`:
+
+- `operator.md`
+- `orchestrator.md`
+- `worker.md`
+- `soul.md` (shared tail appended to all role prompts)
+
+These are loaded by runtime code and are the single source of truth for default system prompts.
+
 ## Install
 
 ```bash

package/dist/command_context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command_context.d.ts","sourceRoot":"","sources":["../src/command_context.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,cAAc,GAAG,MAAM,CAAC;AAE3E,MAAM,MAAM,8BAA8B,GACvC,iBAAiB,GACjB,mBAAmB,GACnB,sBAAsB,GACtB,uBAAuB,CAAC;AAE3B,MAAM,MAAM,yBAAyB,GAClC;IACA,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,uBAAuB,CAAC;CAC/B,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,8BAA8B,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEL,MAAM,MAAM,0BAA0B,GAAG;IACxC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAsJF,qBAAa,sBAAsB;;gBAGf,IAAI,GAAE,0BAA+B;IAQjD,OAAO,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,GAAG,yBAAyB;CAqG7B"}
+{"version":3,"file":"command_context.d.ts","sourceRoot":"","sources":["../src/command_context.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,cAAc,GAAG,MAAM,CAAC;AAE3E,MAAM,MAAM,8BAA8B,GACvC,iBAAiB,GACjB,mBAAmB,GACnB,sBAAsB,GACtB,uBAAuB,CAAC;AAE3B,MAAM,MAAM,yBAAyB,GAClC;IACA,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,uBAAuB,CAAC;CAC/B,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,8BAA8B,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEL,MAAM,MAAM,0BAA0B,GAAG;IACxC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAwJF,qBAAa,sBAAsB;;gBAGf,IAAI,GAAE,0BAA+B;IAQjD,OAAO,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,GAAG,yBAAyB;CAqG7B"}

package/dist/command_context.js

@@ -8,6 +8,8 @@ const ISSUE_TARGET_COMMANDS = new Set([
     "issue claim",
     "issue close",
     "run resume",
+    "run status",
+    "run interrupt",
 ]);
 const TOPIC_TARGET_COMMANDS = new Set(["forum read", "forum post"]);
 const GENERIC_TARGET_COMMANDS = new Set(["audit get", "dlq inspect", "dlq replay"]);

package/dist/default_prompts.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Load a bundled markdown prompt from packages/agent/prompts.
+ *
+ * This is intentionally strict: bundled prompt markdown is the single source
+ * of truth for default system prompts.
+ */
+export declare function loadBundledPrompt(name: string): string;
+export declare function appendSharedSoul(basePrompt: string, soulPrompt: string): string;
+export declare const DEFAULT_SOUL_PROMPT: string;
+export declare const DEFAULT_ORCHESTRATOR_PROMPT: string;
+export declare const DEFAULT_WORKER_PROMPT: string;
+export declare const DEFAULT_OPERATOR_SYSTEM_PROMPT: string;
+//# sourceMappingURL=default_prompts.d.ts.map

package/dist/default_prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default_prompts.d.ts","sourceRoot":"","sources":["../src/default_prompts.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,eAAO,MAAM,mBAAmB,QAA+B,CAAC;AAMhE,eAAO,MAAM,2BAA2B,QAAkE,CAAC;AAC3G,eAAO,MAAM,qBAAqB,QAA4D,CAAC;AAC/F,eAAO,MAAM,8BAA8B,QAAqE,CAAC"}

package/dist/default_prompts.js

@@ -0,0 +1,39 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { splitFrontmatter } from "./prompt.js";
+function bundledPromptPath(name) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return join(here, "..", "prompts", name);
+}
+/**
+ * Load a bundled markdown prompt from packages/agent/prompts.
+ *
+ * This is intentionally strict: bundled prompt markdown is the single source
+ * of truth for default system prompts.
+ */
+export function loadBundledPrompt(name) {
+    const path = bundledPromptPath(name);
+    const raw = readFileSync(path, "utf8");
+    const { body } = splitFrontmatter(raw);
+    const prompt = body.trim();
+    if (prompt.length === 0) {
+        throw new Error(`bundled prompt is empty: ${name}`);
+    }
+    return prompt;
+}
+export function appendSharedSoul(basePrompt, soulPrompt) {
+    const base = basePrompt.trim();
+    const soul = soulPrompt.trim();
+    if (soul.length === 0) {
+        return base;
+    }
+    return `${base}\n\n${soul}`;
+}
+export const DEFAULT_SOUL_PROMPT = loadBundledPrompt("soul.md");
+const BASE_ORCHESTRATOR_PROMPT = loadBundledPrompt("orchestrator.md");
+const BASE_WORKER_PROMPT = loadBundledPrompt("worker.md");
+const BASE_OPERATOR_SYSTEM_PROMPT = loadBundledPrompt("operator.md");
+export const DEFAULT_ORCHESTRATOR_PROMPT = appendSharedSoul(BASE_ORCHESTRATOR_PROMPT, DEFAULT_SOUL_PROMPT);
+export const DEFAULT_WORKER_PROMPT = appendSharedSoul(BASE_WORKER_PROMPT, DEFAULT_SOUL_PROMPT);
+export const DEFAULT_OPERATOR_SYSTEM_PROMPT = appendSharedSoul(BASE_OPERATOR_SYSTEM_PROMPT, DEFAULT_SOUL_PROMPT);

package/dist/extensions/activities.d.ts

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

package/dist/extensions/activities.d.ts.map

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

package/dist/extensions/activities.js

@@ -0,0 +1,125 @@
+import { StringEnum } from "@mariozechner/pi-ai";
+import { Type } from "@sinclair/typebox";
+import { clampInt, fetchMuJson, textResult, toJsonText } from "./shared.js";
+function trimOrNull(value) {
+    if (value == null)
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+export function activitiesExtension(pi) {
+    const ActivitiesParams = Type.Object({
+        action: StringEnum(["list", "get", "start", "progress", "heartbeat", "complete", "fail", "cancel", "events"]),
+        activity_id: Type.Optional(Type.String({ description: "Activity ID" })),
+        title: Type.Optional(Type.String({ description: "Title for start" })),
+        kind: Type.Optional(Type.String({ description: "Activity kind for start/list filtering" })),
+        heartbeat_every_ms: Type.Optional(Type.Number({ description: "Heartbeat interval in ms for start" })),
+        status: Type.Optional(Type.String({ description: "Status filter for list" })),
+        message: Type.Optional(Type.String({ description: "Progress/final message" })),
+        reason: Type.Optional(Type.String({ description: "Heartbeat reason" })),
+        limit: Type.Optional(Type.Number({ description: "Optional limit for list/events" })),
+    });
+    pi.registerTool({
+        name: "mu_activities",
+        label: "Activities",
+        description: "Manage generic long-running activities. Actions: list, get, start, progress, heartbeat, complete, fail, cancel, events.",
+        parameters: ActivitiesParams,
+        async execute(_toolCallId, params) {
+            switch (params.action) {
+                case "list": {
+                    const query = new URLSearchParams();
+                    const status = trimOrNull(params.status);
+                    const kind = trimOrNull(params.kind);
+                    const limit = clampInt(params.limit, 50, 1, 500);
+                    if (status)
+                        query.set("status", status);
+                    if (kind)
+                        query.set("kind", kind);
+                    query.set("limit", String(limit));
+                    const payload = await fetchMuJson(`/api/activities?${query.toString()}`);
+                    return textResult(toJsonText(payload), { action: "list", status, kind, limit });
+                }
+                case "get": {
+                    const activityId = trimOrNull(params.activity_id);
+                    if (!activityId)
+                        return textResult("get requires activity_id");
+                    const payload = await fetchMuJson(`/api/activities/${encodeURIComponent(activityId)}`);
+                    return textResult(toJsonText(payload), { action: "get", activityId });
+                }
+                case "events": {
+                    const activityId = trimOrNull(params.activity_id);
+                    if (!activityId)
+                        return textResult("events requires activity_id");
+                    const limit = clampInt(params.limit, 200, 1, 2_000);
+                    const payload = await fetchMuJson(`/api/activities/${encodeURIComponent(activityId)}/events?limit=${limit}`);
+                    return textResult(toJsonText(payload), { action: "events", activityId, limit });
+                }
+                case "start": {
+                    const title = trimOrNull(params.title);
+                    if (!title)
+                        return textResult("start requires title");
+                    const kind = trimOrNull(params.kind);
+                    const heartbeatEveryMs = params.heartbeat_every_ms != null && Number.isFinite(params.heartbeat_every_ms)
+                        ? Math.max(0, Math.trunc(params.heartbeat_every_ms))
+                        : undefined;
+                    const payload = await fetchMuJson("/api/activities/start", {
+                        method: "POST",
+                        body: {
+                            title,
+                            kind,
+                            heartbeat_every_ms: heartbeatEveryMs,
+                        },
+                    });
+                    return textResult(toJsonText(payload), { action: "start", title, kind, heartbeatEveryMs });
+                }
+                case "progress": {
+                    const activityId = trimOrNull(params.activity_id);
+                    if (!activityId)
+                        return textResult("progress requires activity_id");
+                    const message = trimOrNull(params.message) ?? "progress updated";
+                    const payload = await fetchMuJson("/api/activities/progress", {
+                        method: "POST",
+                        body: {
+                            activity_id: activityId,
+                            message,
+                        },
+                    });
+                    return textResult(toJsonText(payload), { action: "progress", activityId, message });
+                }
+                case "heartbeat": {
+                    const activityId = trimOrNull(params.activity_id);
+                    if (!activityId)
+                        return textResult("heartbeat requires activity_id");
+                    const reason = trimOrNull(params.reason) ?? "manual";
+                    const payload = await fetchMuJson("/api/activities/heartbeat", {
+                        method: "POST",
+                        body: {
+                            activity_id: activityId,
+                            reason,
+                        },
+                    });
+                    return textResult(toJsonText(payload), { action: "heartbeat", activityId, reason });
+                }
+                case "complete":
+                case "fail":
+                case "cancel": {
+                    const activityId = trimOrNull(params.activity_id);
+                    if (!activityId)
+                        return textResult(`${params.action} requires activity_id`);
+                    const message = trimOrNull(params.message);
+                    const payload = await fetchMuJson(`/api/activities/${params.action}`, {
+                        method: "POST",
+                        body: {
+                            activity_id: activityId,
+                            message,
+                        },
+                    });
+                    return textResult(toJsonText(payload), { action: params.action, activityId, message });
+                }
+                default:
+                    return textResult(`unknown action: ${params.action}`);
+            }
+        },
+    });
+}
+export default activitiesExtension;

package/dist/extensions/heartbeats.d.ts

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

package/dist/extensions/heartbeats.d.ts.map

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

package/dist/extensions/heartbeats.js

@@ -0,0 +1,149 @@
+import { StringEnum } from "@mariozechner/pi-ai";
+import { Type } from "@sinclair/typebox";
+import { clampInt, fetchMuJson, textResult, toJsonText } from "./shared.js";
+function trimOrNull(value) {
+    if (value == null)
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+export function heartbeatsExtension(pi) {
+    const Params = Type.Object({
+        action: StringEnum(["list", "get", "create", "update", "delete", "trigger", "enable", "disable"]),
+        program_id: Type.Optional(Type.String({ description: "Heartbeat program ID" })),
+        title: Type.Optional(Type.String({ description: "Program title" })),
+        target_kind: Type.Optional(Type.String({ description: "Target kind (run|activity)" })),
+        run_job_id: Type.Optional(Type.String({ description: "Run job ID target" })),
+        run_root_issue_id: Type.Optional(Type.String({ description: "Run root issue ID target" })),
+        activity_id: Type.Optional(Type.String({ description: "Activity ID target" })),
+        every_ms: Type.Optional(Type.Number({ description: "Heartbeat interval in ms" })),
+        reason: Type.Optional(Type.String({ description: "Heartbeat reason" })),
+        enabled: Type.Optional(Type.Boolean({ description: "Enabled state" })),
+        limit: Type.Optional(Type.Number({ description: "Max returned items for list" })),
+    });
+    pi.registerTool({
+        name: "mu_heartbeats",
+        label: "Heartbeats",
+        description: "Program and manage persistent heartbeat schedules. Actions: list, get, create, update, delete, trigger, enable, disable.",
+        parameters: Params,
+        async execute(_toolCallId, params) {
+            switch (params.action) {
+                case "list": {
+                    const query = new URLSearchParams();
+                    const targetKind = trimOrNull(params.target_kind);
+                    if (targetKind) {
+                        query.set("target_kind", targetKind);
+                    }
+                    if (typeof params.enabled === "boolean") {
+                        query.set("enabled", params.enabled ? "true" : "false");
+                    }
+                    query.set("limit", String(clampInt(params.limit, 50, 1, 500)));
+                    const payload = await fetchMuJson(`/api/heartbeats?${query.toString()}`);
+                    return textResult(toJsonText(payload), {
+                        action: "list",
+                        targetKind,
+                        enabled: params.enabled,
+                    });
+                }
+                case "get": {
+                    const programId = trimOrNull(params.program_id);
+                    if (!programId)
+                        return textResult("get requires program_id");
+                    const payload = await fetchMuJson(`/api/heartbeats/${encodeURIComponent(programId)}`);
+                    return textResult(toJsonText(payload), { action: "get", programId });
+                }
+                case "create": {
+                    const title = trimOrNull(params.title);
+                    const targetKind = trimOrNull(params.target_kind);
+                    if (!title)
+                        return textResult("create requires title");
+                    if (!targetKind)
+                        return textResult("create requires target_kind (run|activity)");
+                    const payload = await fetchMuJson("/api/heartbeats/create", {
+                        method: "POST",
+                        body: {
+                            title,
+                            target_kind: targetKind,
+                            run_job_id: trimOrNull(params.run_job_id),
+                            run_root_issue_id: trimOrNull(params.run_root_issue_id),
+                            activity_id: trimOrNull(params.activity_id),
+                            every_ms: params.every_ms != null && Number.isFinite(params.every_ms)
+                                ? Math.max(0, Math.trunc(params.every_ms))
+                                : undefined,
+                            reason: trimOrNull(params.reason),
+                            enabled: typeof params.enabled === "boolean" ? params.enabled : undefined,
+                        },
+                    });
+                    return textResult(toJsonText(payload), { action: "create", title, targetKind });
+                }
+                case "update": {
+                    const programId = trimOrNull(params.program_id);
+                    if (!programId)
+                        return textResult("update requires program_id");
+                    const payload = await fetchMuJson("/api/heartbeats/update", {
+                        method: "POST",
+                        body: {
+                            program_id: programId,
+                            title: trimOrNull(params.title),
+                            target_kind: trimOrNull(params.target_kind),
+                            run_job_id: trimOrNull(params.run_job_id),
+                            run_root_issue_id: trimOrNull(params.run_root_issue_id),
+                            activity_id: trimOrNull(params.activity_id),
+                            every_ms: params.every_ms != null && Number.isFinite(params.every_ms)
+                                ? Math.max(0, Math.trunc(params.every_ms))
+                                : undefined,
+                            reason: trimOrNull(params.reason),
+                            enabled: typeof params.enabled === "boolean" ? params.enabled : undefined,
+                        },
+                    });
+                    return textResult(toJsonText(payload), { action: "update", programId });
+                }
+                case "delete": {
+                    const programId = trimOrNull(params.program_id);
+                    if (!programId)
+                        return textResult("delete requires program_id");
+                    const payload = await fetchMuJson("/api/heartbeats/delete", {
+                        method: "POST",
+                        body: {
+                            program_id: programId,
+                        },
+                    });
+                    return textResult(toJsonText(payload), { action: "delete", programId });
+                }
+                case "trigger": {
+                    const programId = trimOrNull(params.program_id);
+                    if (!programId)
+                        return textResult("trigger requires program_id");
+                    const payload = await fetchMuJson("/api/heartbeats/trigger", {
+                        method: "POST",
+                        body: {
+                            program_id: programId,
+                            reason: trimOrNull(params.reason),
+                        },
+                    });
+                    return textResult(toJsonText(payload), { action: "trigger", programId });
+                }
+                case "enable":
+                case "disable": {
+                    const programId = trimOrNull(params.program_id);
+                    if (!programId)
+                        return textResult(`${params.action} requires program_id`);
+                    const payload = await fetchMuJson("/api/heartbeats/update", {
+                        method: "POST",
+                        body: {
+                            program_id: programId,
+                            enabled: params.action === "enable",
+                        },
+                    });
+                    return textResult(toJsonText(payload), {
+                        action: params.action,
+                        programId,
+                    });
+                }
+                default:
+                    return textResult(`unknown action: ${params.action}`);
+            }
+        },
+    });
+}
+export default heartbeatsExtension;

package/dist/extensions/index.d.ts

@@ -1,7 +1,12 @@
+export { activitiesExtension } from "./activities.js";
 export { brandingExtension } from "./branding.js";
 export { eventLogExtension } from "./event-log.js";
+export { heartbeatsExtension } from "./heartbeats.js";
 export { messagingSetupExtension } from "./messaging-setup.js";
-export { serverToolsExtension } from "./server-tools.js";
+export { orchestrationRunsExtension } from "./orchestration-runs.js";
+export { orchestrationRunsReadOnlyExtension } from "./orchestration-runs-readonly.js";
+export { serverToolsExtension, serverToolsReadOnlyExtension } from "./server-tools.js";
+export { serverToolsReadonlyExtension } from "./server-tools-readonly.js";
 /**
  * Serve-mode extension module paths.
  *
@@ -10,4 +15,11 @@ export { serverToolsExtension } from "./server-tools.js";
  * anonymous inline factories.
  */
 export declare const serveExtensionPaths: string[];
+/**
+ * Control-plane operator extension module paths.
+ *
+ * This set is intentionally read-only for tool-invoked actions so all
+ * mutations flow through approved `/mu ...` command proposals and policy.
+ */
+export declare const operatorExtensionPaths: string[];
 //# sourceMappingURL=index.d.ts.map

package/dist/extensions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AASzD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAE/B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAyB1E;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAE/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,UAElC,CAAC"}

package/dist/extensions/index.js

@@ -1,8 +1,28 @@
+export { activitiesExtension } from "./activities.js";
 export { brandingExtension } from "./branding.js";
 export { eventLogExtension } from "./event-log.js";
+export { heartbeatsExtension } from "./heartbeats.js";
 export { messagingSetupExtension } from "./messaging-setup.js";
-export { serverToolsExtension } from "./server-tools.js";
-const SERVE_EXTENSION_MODULE_BASENAMES = ["branding", "server-tools", "event-log", "messaging-setup"];
+export { orchestrationRunsExtension } from "./orchestration-runs.js";
+export { orchestrationRunsReadOnlyExtension } from "./orchestration-runs-readonly.js";
+export { serverToolsExtension, serverToolsReadOnlyExtension } from "./server-tools.js";
+export { serverToolsReadonlyExtension } from "./server-tools-readonly.js";
+const SERVE_EXTENSION_MODULE_BASENAMES = [
+    "branding",
+    "server-tools",
+    "event-log",
+    "messaging-setup",
+    "orchestration-runs",
+    "activities",
+    "heartbeats",
+];
+const OPERATOR_EXTENSION_MODULE_BASENAMES = [
+    "branding",
+    "server-tools-readonly",
+    "event-log",
+    "messaging-setup",
+    "orchestration-runs-readonly",
+];
 const RUNTIME_EXTENSION = import.meta.url.endsWith(".ts") ? "ts" : "js";
 function resolveBundledExtensionPath(moduleBasename) {
     return new URL(`./${moduleBasename}.${RUNTIME_EXTENSION}`, import.meta.url).pathname;
@@ -15,3 +35,10 @@ function resolveBundledExtensionPath(moduleBasename) {
  * anonymous inline factories.
  */
 export const serveExtensionPaths = SERVE_EXTENSION_MODULE_BASENAMES.map((moduleBasename) => resolveBundledExtensionPath(moduleBasename));
+/**
+ * Control-plane operator extension module paths.
+ *
+ * This set is intentionally read-only for tool-invoked actions so all
+ * mutations flow through approved `/mu ...` command proposals and policy.
+ */
+export const operatorExtensionPaths = OPERATOR_EXTENSION_MODULE_BASENAMES.map((moduleBasename) => resolveBundledExtensionPath(moduleBasename));

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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1 @@
+{"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;AAUlE,wBAAgB,kCAAkC,CAAC,EAAE,EAAE,YAAY,QA8ClE;AAED,eAAe,kCAAkC,CAAC"}

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

@@ -0,0 +1,56 @@
+import { StringEnum } from "@mariozechner/pi-ai";
+import { Type } from "@sinclair/typebox";
+import { clampInt, fetchMuJson, textResult, toJsonText } from "./shared.js";
+function trimOrNull(value) {
+    if (value == null)
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+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)" })),
+        status: Type.Optional(Type.String({ description: "Optional status filter for list" })),
+    });
+    pi.registerTool({
+        name: "mu_runs",
+        label: "Runs",
+        description: "Read-only run inspection. Actions: list, status, trace. Mutating actions are disabled in operator mode.",
+        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, 50, 1, 500);
+                    query.set("limit", String(limit));
+                    const payload = await fetchMuJson(`/api/runs?${query.toString()}`);
+                    return textResult(toJsonText(payload), { action: "list", status, limit });
+                }
+                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 });
+                }
+                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 });
+                }
+                default:
+                    return textResult(`unknown action: ${params.action}`);
+            }
+        },
+    });
+}
+export default orchestrationRunsReadOnlyExtension;

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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1 @@
+{"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;AAUlE,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,YAAY,QAiH1D;AAED,eAAe,0BAA0B,CAAC"}