@femtomc/mu-agent 26.2.69 → 26.2.70

package/dist/extensions/cron.js

@@ -1,6 +1,6 @@
 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, previewText, selectFields, textResult, toJsonText, } from "./shared.js";
 function trimOrNull(value) {
     if (value == null)
         return null;
@@ -13,9 +13,40 @@ function normalizedNumber(value) {
     }
     return Math.trunc(value);
 }
-export function cronExtension(pi) {
+function summarizeCronProgram(program) {
+    const target = asRecord(program.target);
+    const schedule = asRecord(program.schedule);
+    return {
+        program_id: asString(program.program_id),
+        title: previewText(program.title, 120),
+        enabled: program.enabled ?? null,
+        target_kind: target ? asString(target.kind) : asString(program.target_kind),
+        target_job_id: target ? asString(target.job_id) : asString(program.run_job_id),
+        target_root_issue_id: target ? asString(target.root_issue_id) : asString(program.run_root_issue_id),
+        target_activity_id: target ? asString(target.activity_id) : asString(program.activity_id),
+        schedule_kind: schedule ? asString(schedule.kind) : asString(program.schedule_kind),
+        schedule_preview: previewText(schedule ?? program, 180),
+        reason: asString(program.reason),
+        wake_mode: asString(program.wake_mode),
+        last_result: asString(program.last_result),
+        updated_at_ms: asNumber(program.updated_at_ms),
+    };
+}
+function summarizeCronMutation(payload) {
+    const program = asRecord(payload.program);
+    return {
+        ok: payload.ok ?? null,
+        reason: asString(payload.reason),
+        program: program ? summarizeCronProgram(program) : null,
+    };
+}
+export function cronExtension(pi, opts = {}) {
+    const allowMutations = opts.allowMutations ?? true;
+    const cronActions = allowMutations
+        ? ["status", "list", "get", "create", "update", "delete", "trigger", "enable", "disable"]
+        : ["status", "list", "get"];
     const Params = Type.Object({
-        action: StringEnum(["status", "list", "get", "create", "update", "delete", "trigger", "enable", "disable"]),
+        action: StringEnum(cronActions),
         program_id: Type.Optional(Type.String({ description: "Cron program ID" })),
         title: Type.Optional(Type.String({ description: "Program title" })),
         target_kind: Type.Optional(Type.String({ description: "Target kind (run|activity)" })),
@@ -32,18 +63,34 @@ export function cronExtension(pi) {
         reason: Type.Optional(Type.String({ description: "Execution reason" })),
         enabled: Type.Optional(Type.Boolean({ description: "Enabled state" })),
         schedule_filter: Type.Optional(Type.String({ description: "Filter list by schedule kind" })),
-        limit: Type.Optional(Type.Number({ description: "Max returned items for list" })),
+        fields: Type.Optional(Type.String({ description: "Comma-separated fields for get selection" })),
+        limit: Type.Optional(Type.Number({ description: "Max returned items for list (default: 20)" })),
     });
     pi.registerTool({
         name: "mu_cron",
         label: "Cron",
-        description: "Manage persistent cron programs. Actions: status, list, get, create, update, delete, trigger, enable, disable.",
+        description: allowMutations
+            ? "Manage persistent cron programs. Actions: status, list, get, create, update, delete, trigger, enable, disable. Summary-first output; use fields for precise retrieval."
+            : "Read cron programs. Actions: status, list, get. Query-only mode excludes mutations.",
         parameters: Params,
         async execute(_toolCallId, params) {
             switch (params.action) {
                 case "status": {
                     const payload = await fetchMuJson("/api/cron/status");
-                    return textResult(toJsonText(payload), { action: "status" });
+                    const status = {
+                        count: asNumber(payload.count) ?? 0,
+                        enabled_count: asNumber(payload.enabled_count),
+                        armed_count: asNumber(payload.armed_count),
+                        running_count: asNumber(payload.running_count) ?? asNumber(payload.count_running) ?? null,
+                        armed: asArray(payload.armed)
+                            .map((entry) => asRecord(entry))
+                            .filter((entry) => entry != null)
+                            .map((entry) => ({
+                            program_id: asString(entry.program_id),
+                            due_at_ms: asNumber(entry.due_at_ms),
+                        })),
+                    };
+                    return textResult(toJsonText(status), { action: "status", payload });
                 }
                 case "list": {
                     const query = new URLSearchParams();
@@ -58,13 +105,20 @@ export function cronExtension(pi) {
                     if (scheduleFilter) {
                         query.set("schedule_kind", scheduleFilter);
                     }
-                    query.set("limit", String(clampInt(params.limit, 50, 1, 500)));
+                    const limit = clampInt(params.limit, 20, 1, 500);
+                    query.set("limit", String(limit));
                     const payload = await fetchMuJson(`/api/cron?${query.toString()}`);
-                    return textResult(toJsonText(payload), {
+                    const programs = asArray(payload.programs)
+                        .map((program) => asRecord(program))
+                        .filter((program) => program != null)
+                        .map((program) => summarizeCronProgram(program));
+                    return textResult(toJsonText({ count: programs.length, programs }), {
                         action: "list",
                         targetKind,
                         enabled: params.enabled,
                         scheduleFilter,
+                        limit,
+                        payload,
                     });
                 }
                 case "get": {
@@ -72,7 +126,11 @@ export function cronExtension(pi) {
                     if (!programId)
                         return textResult("get requires program_id");
                     const payload = await fetchMuJson(`/api/cron/${encodeURIComponent(programId)}`);
-                    return textResult(toJsonText(payload), { action: "get", programId });
+                    const fields = parseFieldPaths(trimOrNull(params.fields) ?? undefined);
+                    const content = fields.length > 0
+                        ? { program_id: programId, selected: selectFields(payload, fields) }
+                        : { program: summarizeCronProgram(payload) };
+                    return textResult(toJsonText(content), { action: "get", programId, fields, payload });
                 }
                 case "create": {
                     const title = trimOrNull(params.title);
@@ -103,11 +161,12 @@ export function cronExtension(pi) {
                             enabled: typeof params.enabled === "boolean" ? params.enabled : undefined,
                         },
                     });
-                    return textResult(toJsonText(payload), {
+                    return textResult(toJsonText(summarizeCronMutation(payload)), {
                         action: "create",
                         title,
                         targetKind,
                         scheduleKind,
+                        payload,
                     });
                 }
                 case "update": {
@@ -134,7 +193,7 @@ export function cronExtension(pi) {
                             enabled: typeof params.enabled === "boolean" ? params.enabled : undefined,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "update", programId });
+                    return textResult(toJsonText(summarizeCronMutation(payload)), { action: "update", programId, payload });
                 }
                 case "delete": {
                     const programId = trimOrNull(params.program_id);
@@ -146,7 +205,7 @@ export function cronExtension(pi) {
                             program_id: programId,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "delete", programId });
+                    return textResult(toJsonText(summarizeCronMutation(payload)), { action: "delete", programId, payload });
                 }
                 case "trigger": {
                     const programId = trimOrNull(params.program_id);
@@ -159,7 +218,7 @@ export function cronExtension(pi) {
                             reason: trimOrNull(params.reason),
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "trigger", programId });
+                    return textResult(toJsonText(summarizeCronMutation(payload)), { action: "trigger", programId, payload });
                 }
                 case "enable":
                 case "disable": {
@@ -173,9 +232,10 @@ export function cronExtension(pi) {
                             enabled: params.action === "enable",
                         },
                     });
-                    return textResult(toJsonText(payload), {
+                    return textResult(toJsonText(summarizeCronMutation(payload)), {
                         action: params.action,
                         programId,
+                        payload,
                     });
                 }
                 default:

package/dist/extensions/heartbeats.d.ts

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

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

@@ -1 +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"}
+{"version":3,"file":"heartbeats.d.ts","sourceRoot":"","sources":["../../src/extensions/heartbeats.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAiDlE,MAAM,MAAM,uBAAuB,GAAG;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,GAAE,uBAA4B,QA8JvF;AAED,eAAe,mBAAmB,CAAC"}

package/dist/extensions/heartbeats.js

@@ -1,15 +1,44 @@
 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, 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;
 }
-export function heartbeatsExtension(pi) {
+function summarizeHeartbeatProgram(program) {
+    const target = asRecord(program.target);
+    return {
+        program_id: asString(program.program_id),
+        title: previewText(program.title, 120),
+        enabled: program.enabled ?? null,
+        every_ms: asNumber(program.every_ms),
+        reason: asString(program.reason),
+        wake_mode: asString(program.wake_mode),
+        target_kind: target ? asString(target.kind) : asString(program.target_kind),
+        target_job_id: target ? asString(target.job_id) : asString(program.run_job_id),
+        target_root_issue_id: target ? asString(target.root_issue_id) : asString(program.run_root_issue_id),
+        target_activity_id: target ? asString(target.activity_id) : asString(program.activity_id),
+        last_result: asString(program.last_result),
+        updated_at_ms: asNumber(program.updated_at_ms),
+    };
+}
+function summarizeHeartbeatMutation(payload) {
+    const program = asRecord(payload.program);
+    return {
+        ok: payload.ok ?? null,
+        reason: asString(payload.reason),
+        program: program ? summarizeHeartbeatProgram(program) : null,
+    };
+}
+export function heartbeatsExtension(pi, opts = {}) {
+    const allowMutations = opts.allowMutations ?? true;
+    const heartbeatActions = allowMutations
+        ? ["list", "get", "create", "update", "delete", "trigger", "enable", "disable"]
+        : ["list", "get"];
     const Params = Type.Object({
-        action: StringEnum(["list", "get", "create", "update", "delete", "trigger", "enable", "disable"]),
+        action: StringEnum(heartbeatActions),
         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)" })),
@@ -19,12 +48,15 @@ export function heartbeatsExtension(pi) {
         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" })),
+        fields: Type.Optional(Type.String({ description: "Comma-separated fields for get selection" })),
+        limit: Type.Optional(Type.Number({ description: "Max returned items for list (default: 20)" })),
     });
     pi.registerTool({
         name: "mu_heartbeats",
         label: "Heartbeats",
-        description: "Program and manage persistent heartbeat schedules. Actions: list, get, create, update, delete, trigger, enable, disable.",
+        description: allowMutations
+            ? "Program and manage persistent heartbeat schedules. Actions: list, get, create, update, delete, trigger, enable, disable. Summary-first output; use fields for precise retrieval."
+            : "Read heartbeat programs. Actions: list, get. Query-only mode excludes mutations.",
         parameters: Params,
         async execute(_toolCallId, params) {
             switch (params.action) {
@@ -37,20 +69,25 @@ export function heartbeatsExtension(pi) {
                     if (typeof params.enabled === "boolean") {
                         query.set("enabled", params.enabled ? "true" : "false");
                     }
-                    query.set("limit", String(clampInt(params.limit, 50, 1, 500)));
+                    const limit = clampInt(params.limit, 20, 1, 500);
+                    query.set("limit", String(limit));
                     const payload = await fetchMuJson(`/api/heartbeats?${query.toString()}`);
-                    return textResult(toJsonText(payload), {
-                        action: "list",
-                        targetKind,
-                        enabled: params.enabled,
-                    });
+                    const programs = asArray(payload.programs)
+                        .map((program) => asRecord(program))
+                        .filter((program) => program != null)
+                        .map((program) => summarizeHeartbeatProgram(program));
+                    return textResult(toJsonText({ count: programs.length, programs }), { action: "list", targetKind, enabled: params.enabled, limit, payload });
                 }
                 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 });
+                    const fields = parseFieldPaths(trimOrNull(params.fields) ?? undefined);
+                    const content = fields.length > 0
+                        ? { program_id: programId, selected: selectFields(payload, fields) }
+                        : { program: summarizeHeartbeatProgram(payload) };
+                    return textResult(toJsonText(content), { action: "get", programId, fields, payload });
                 }
                 case "create": {
                     const title = trimOrNull(params.title);
@@ -74,7 +111,12 @@ export function heartbeatsExtension(pi) {
                             enabled: typeof params.enabled === "boolean" ? params.enabled : undefined,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "create", title, targetKind });
+                    return textResult(toJsonText(summarizeHeartbeatMutation(payload)), {
+                        action: "create",
+                        title,
+                        targetKind,
+                        payload,
+                    });
                 }
                 case "update": {
                     const programId = trimOrNull(params.program_id);
@@ -96,7 +138,7 @@ export function heartbeatsExtension(pi) {
                             enabled: typeof params.enabled === "boolean" ? params.enabled : undefined,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "update", programId });
+                    return textResult(toJsonText(summarizeHeartbeatMutation(payload)), { action: "update", programId, payload });
                 }
                 case "delete": {
                     const programId = trimOrNull(params.program_id);
@@ -108,7 +150,7 @@ export function heartbeatsExtension(pi) {
                             program_id: programId,
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "delete", programId });
+                    return textResult(toJsonText(summarizeHeartbeatMutation(payload)), { action: "delete", programId, payload });
                 }
                 case "trigger": {
                     const programId = trimOrNull(params.program_id);
@@ -121,7 +163,7 @@ export function heartbeatsExtension(pi) {
                             reason: trimOrNull(params.reason),
                         },
                     });
-                    return textResult(toJsonText(payload), { action: "trigger", programId });
+                    return textResult(toJsonText(summarizeHeartbeatMutation(payload)), { action: "trigger", programId, payload });
                 }
                 case "enable":
                 case "disable": {
@@ -135,9 +177,10 @@ export function heartbeatsExtension(pi) {
                             enabled: params.action === "enable",
                         },
                     });
-                    return textResult(toJsonText(payload), {
+                    return textResult(toJsonText(summarizeHeartbeatMutation(payload)), {
                         action: params.action,
                         programId,
+                        payload,
                     });
                 }
                 default:

package/dist/extensions/index.d.ts

@@ -4,20 +4,30 @@ export { cronExtension } from "./cron.js";
 export { eventLogExtension } from "./event-log.js";
 export { heartbeatsExtension } from "./heartbeats.js";
 export { messagingSetupExtension } from "./messaging-setup.js";
+export { muFullToolsExtension } from "./mu-full-tools.js";
 export { muOperatorExtension } from "./mu-operator.js";
+export { muQueryToolsExtension } from "./mu-query-tools.js";
 export { muServeExtension } from "./mu-serve.js";
 export { operatorCommandExtension } from "./operator-command.js";
 export { orchestrationRunsExtension } from "./orchestration-runs.js";
 export { orchestrationRunsReadOnlyExtension } from "./orchestration-runs-readonly.js";
-export { serverToolsExtension, serverToolsReadOnlyExtension } from "./server-tools.js";
+export { serverToolsExtension, serverToolsIssueForumExtension, serverToolsReadOnlyExtension } from "./server-tools.js";
 export { serverToolsReadonlyExtension } from "./server-tools-readonly.js";
 /**
  * Serve-mode extension — single facade that bundles all serve extensions.
  */
 export declare const serveExtensionPaths: string[];
 /**
- * Operator-mode extension — single facade that bundles all operator
- * extensions (read-only tools, approved `/mu` command flow).
+ * Operator-mode extension — single facade that bundles operator UI +
+ * full mu tools + approved `/mu` command flow.
  */
 export declare const operatorExtensionPaths: string[];
+/**
+ * Tool-only extension bundle for orchestrator sessions (full tool surface).
+ */
+export declare const orchestratorToolExtensionPaths: string[];
+/**
+ * Tool-only extension bundle for worker sessions (issue/forum coordination only).
+ */
+export declare const workerToolExtensionPaths: 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,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,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,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,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;AAQ1E;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAA4C,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,UAA+C,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,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,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,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACvH,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAQ1E;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAA4C,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,UAA+C,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,8BAA8B,UAAiD,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAAkD,CAAC"}

package/dist/extensions/index.js

@@ -4,12 +4,14 @@ export { cronExtension } from "./cron.js";
 export { eventLogExtension } from "./event-log.js";
 export { heartbeatsExtension } from "./heartbeats.js";
 export { messagingSetupExtension } from "./messaging-setup.js";
+export { muFullToolsExtension } from "./mu-full-tools.js";
 export { muOperatorExtension } from "./mu-operator.js";
+export { muQueryToolsExtension } from "./mu-query-tools.js";
 export { muServeExtension } from "./mu-serve.js";
 export { operatorCommandExtension } from "./operator-command.js";
 export { orchestrationRunsExtension } from "./orchestration-runs.js";
 export { orchestrationRunsReadOnlyExtension } from "./orchestration-runs-readonly.js";
-export { serverToolsExtension, serverToolsReadOnlyExtension } from "./server-tools.js";
+export { serverToolsExtension, serverToolsIssueForumExtension, serverToolsReadOnlyExtension } from "./server-tools.js";
 export { serverToolsReadonlyExtension } from "./server-tools-readonly.js";
 const RUNTIME_EXTENSION = import.meta.url.endsWith(".ts") ? "ts" : "js";
 function resolveBundledExtensionPath(moduleBasename) {
@@ -20,7 +22,15 @@ function resolveBundledExtensionPath(moduleBasename) {
  */
 export const serveExtensionPaths = [resolveBundledExtensionPath("mu-serve")];
 /**
- * Operator-mode extension — single facade that bundles all operator
- * extensions (read-only tools, approved `/mu` command flow).
+ * Operator-mode extension — single facade that bundles operator UI +
+ * full mu tools + approved `/mu` command flow.
  */
 export const operatorExtensionPaths = [resolveBundledExtensionPath("mu-operator")];
+/**
+ * Tool-only extension bundle for orchestrator sessions (full tool surface).
+ */
+export const orchestratorToolExtensionPaths = [resolveBundledExtensionPath("mu-full-tools")];
+/**
+ * Tool-only extension bundle for worker sessions (issue/forum coordination only).
+ */
+export const workerToolExtensionPaths = [resolveBundledExtensionPath("mu-query-tools")];

package/dist/extensions/messaging-setup.d.ts

@@ -7,6 +7,9 @@
  * - Support plan/apply/verify workflow with in-process control-plane reload.
  */
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-export declare function messagingSetupExtension(pi: ExtensionAPI): void;
+export type MessagingSetupExtensionOpts = {
+    allowApply?: boolean;
+};
+export declare function messagingSetupExtension(pi: ExtensionAPI, opts?: MessagingSetupExtensionOpts): void;
 export default messagingSetupExtension;
 //# sourceMappingURL=messaging-setup.d.ts.map

package/dist/extensions/messaging-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging-setup.d.ts","sourceRoot":"","sources":["../../src/extensions/messaging-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA6C,MAAM,+BAA+B,CAAC;AAypC7G,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,QAyPvD;AAED,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"messaging-setup.d.ts","sourceRoot":"","sources":["../../src/extensions/messaging-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA6C,MAAM,+BAA+B,CAAC;AAoqC7G,MAAM,MAAM,2BAA2B,GAAG;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,GAAE,2BAAgC,QAsR/F;AAED,eAAe,uBAAuB,CAAC"}

package/dist/extensions/messaging-setup.js

@@ -334,6 +334,9 @@ function summarizeChecks(checks) {
 }
 function preflightSummary(checks, runtime) {
     const lines = ["Messaging adapter preflight:", ""];
+    if (checks.length === 0) {
+        lines.push("(no matching adapters)");
+    }
     for (const check of checks) {
         const route = check.route ? ` · route ${check.route}` : "";
         const missing = check.missing.length > 0 ? ` · missing ${check.missing.join(", ")}` : "";
@@ -867,6 +870,13 @@ function dispatchSetupPromptToAgent(pi, ctx, prompt) {
 function findCheckByAdapter(checks, adapterId) {
     return checks.find((check) => check.id === adapterId) ?? null;
 }
+function checksForAdapter(checks, adapterId) {
+    if (!adapterId) {
+        return checks;
+    }
+    const match = checks.find((check) => check.id === adapterId);
+    return match ? [match] : [];
+}
 async function maybeDispatchAgentSetupBrief(opts) {
     if (!opts.parsed.adapterId)
         return false;
@@ -934,7 +944,8 @@ async function runInteractiveApply(ctx, adapterId) {
     ];
     return lines.join("\n");
 }
-export function messagingSetupExtension(pi) {
+export function messagingSetupExtension(pi, opts = {}) {
+    const allowApply = opts.allowApply ?? true;
     pi.on("before_agent_start", async (event) => {
         const { checks } = await collectChecksCached();
         const summary = summarizeChecks(checks);
@@ -942,7 +953,9 @@ export function messagingSetupExtension(pi) {
             "",
             "[MU MESSAGING]",
             summary.length > 0 ? summary : "no adapter status available",
-            "Use mu_messaging_setup(action=preflight|plan|apply|verify|guide) for operator workflow.",
+            allowApply
+                ? "Use mu_messaging_setup(action=preflight|plan|apply|verify|guide) for operator workflow."
+                : "Use mu_messaging_setup(action=preflight|plan|verify|guide) for query workflow.",
         ];
         return {
             systemPrompt: `${event.systemPrompt}${lines.join("\n")}`,
@@ -951,8 +964,11 @@ export function messagingSetupExtension(pi) {
     pi.on("session_start", async (_event, ctx) => {
         await refreshMessagingStatus(ctx);
     });
+    const setupActions = allowApply
+        ? ["check", "preflight", "guide", "plan", "apply", "verify"]
+        : ["check", "preflight", "guide", "plan", "verify"];
     const SetupParams = Type.Object({
-        action: StringEnum(["check", "preflight", "guide", "plan", "apply", "verify"]),
+        action: StringEnum(setupActions),
         adapter: Type.Optional(Type.String({ description: "Adapter name: slack, discord, telegram, gmail" })),
         public_base_url: Type.Optional(Type.String({
             description: "Optional public base URL used to compute expected webhook endpoints (e.g. https://example.ngrok.app)",
@@ -964,9 +980,11 @@ export function messagingSetupExtension(pi) {
     pi.registerTool({
         name: "mu_messaging_setup",
         label: "Messaging Setup",
-        description: "Messaging setup workflow. Actions: check/preflight/guide/plan/apply/verify. For apply, pass field values via the fields parameter (e.g. fields={bot_token:'...', webhook_secret:'...'}).",
+        description: allowApply
+            ? "Messaging setup workflow. Actions: check/preflight/guide/plan/apply/verify. For apply, pass field values via the fields parameter (e.g. fields={bot_token:'...', webhook_secret:'...'})."
+            : "Messaging setup query workflow. Actions: check/preflight/guide/plan/verify. Apply is disabled in query-only mode.",
         parameters: SetupParams,
-        async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
             const adapterId = params.adapter ? normalizeAdapterId(params.adapter) : null;
             if (params.adapter && !adapterId) {
                 return textResult(`Unknown adapter: ${params.adapter}. Available: ${ADAPTERS.map((adapter) => adapter.id).join(", ")}`);
@@ -974,17 +992,24 @@ export function messagingSetupExtension(pi) {
             switch (params.action) {
                 case "check": {
                     const { checks, runtime } = await collectChecksCached();
+                    const filteredChecks = checksForAdapter(checks, adapterId);
                     return textResult(toJsonText({
-                        checks,
+                        checks: filteredChecks,
                         runtime: { ...runtime, routesByAdapter: Object.fromEntries(runtime.routesByAdapter) },
                     }), {
-                        checks,
+                        checks: filteredChecks,
                         runtime,
+                        adapter: adapterId,
                     });
                 }
                 case "preflight": {
                     const { checks, runtime } = await collectChecksCached();
-                    return textResult(preflightSummary(checks, runtime), { checks, runtime });
+                    const filteredChecks = checksForAdapter(checks, adapterId);
+                    return textResult(preflightSummary(filteredChecks, runtime), {
+                        checks: filteredChecks,
+                        runtime,
+                        adapter: adapterId,
+                    });
                 }
                 case "guide":
                 case "plan": {
@@ -1010,6 +1035,12 @@ export function messagingSetupExtension(pi) {
                     return textResult(planSummary(plans), { plans, runtime, adapter: null });
                 }
                 case "apply": {
+                    if (!allowApply) {
+                        return textResult("apply is disabled in query-only mode. Use plan/guide/verify actions.", {
+                            blocked: true,
+                            reason: "messaging_setup_query_only_mode",
+                        });
+                    }
                     if (!adapterId) {
                         return textResult("apply requires adapter (slack|discord|telegram)");
                     }
@@ -1071,8 +1102,9 @@ export function messagingSetupExtension(pi) {
             switch (parsed.action) {
                 case "check": {
                     const { checks, runtime } = await collectChecksCached(0);
+                    const filteredChecks = checksForAdapter(checks, parsed.adapterId);
                     ctx.ui.notify(toJsonText({
-                        checks,
+                        checks: filteredChecks,
                         runtime: { ...runtime, routesByAdapter: Object.fromEntries(runtime.routesByAdapter) },
                     }), "info");
                     await refreshMessagingStatus(ctx);
@@ -1087,7 +1119,8 @@ export function messagingSetupExtension(pi) {
                         await refreshMessagingStatus(ctx);
                         return;
                     }
-                    ctx.ui.notify(preflightSummary(checks, runtime), "info");
+                    const filteredChecks = checksForAdapter(checks, parsed.adapterId);
+                    ctx.ui.notify(preflightSummary(filteredChecks, runtime), "info");
                     await refreshMessagingStatus(ctx);
                     return;
                 }
@@ -1123,6 +1156,10 @@ export function messagingSetupExtension(pi) {
                     return;
                 }
                 case "apply": {
+                    if (!allowApply) {
+                        ctx.ui.notify("apply is disabled in query-only mode. Use /mu setup plan and /mu setup verify.", "warning");
+                        return;
+                    }
                     if (!parsed.adapterId) {
                         ctx.ui.notify("apply requires adapter. Example: /mu setup apply slack", "error");
                         return;

package/dist/extensions/mu-full-tools.d.ts

@@ -0,0 +1,10 @@
+/**
+ * mu-full-tools — Tool-only extension bundle with full mu tool surface.
+ *
+ * Intended for orchestrator/operator contexts that should have the complete
+ * server-backed tool set (including mutation-capable tool actions).
+ */
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+export declare function muFullToolsExtension(pi: ExtensionAPI): void;
+export default muFullToolsExtension;
+//# sourceMappingURL=mu-full-tools.d.ts.map

package/dist/extensions/mu-full-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mu-full-tools.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-full-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAQlE,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,QAYpD;AAED,eAAe,oBAAoB,CAAC"}

package/dist/extensions/mu-full-tools.js

@@ -0,0 +1,25 @@
+/**
+ * mu-full-tools — Tool-only extension bundle with full mu tool surface.
+ *
+ * Intended for orchestrator/operator contexts that should have the complete
+ * server-backed tool set (including mutation-capable tool actions).
+ */
+import { activitiesExtension } from "./activities.js";
+import { cronExtension } from "./cron.js";
+import { heartbeatsExtension } from "./heartbeats.js";
+import { messagingSetupExtension } from "./messaging-setup.js";
+import { orchestrationRunsExtension } from "./orchestration-runs.js";
+import { serverToolsExtension } from "./server-tools.js";
+export function muFullToolsExtension(pi) {
+    serverToolsExtension(pi, {
+        allowForumPost: true,
+        allowIdentityMutations: true,
+        toolIntroLine: "Tools: mu_status, mu_control_plane, mu_issues, mu_forum, mu_events, mu_runs, mu_activities, mu_heartbeats, mu_cron, mu_messaging_setup, mu_identity.",
+    });
+    messagingSetupExtension(pi, { allowApply: true });
+    orchestrationRunsExtension(pi);
+    activitiesExtension(pi, { allowMutations: true });
+    heartbeatsExtension(pi, { allowMutations: true });
+    cronExtension(pi, { allowMutations: true });
+}
+export default muFullToolsExtension;

package/dist/extensions/mu-operator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mu-operator.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-operator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAQlE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,QAOnD;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"mu-operator.d.ts","sourceRoot":"","sources":["../../src/extensions/mu-operator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAMlE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,QAKnD;AAED,eAAe,mBAAmB,CAAC"}