@femtomc/mu-agent 26.2.71 → 26.2.73

package/README.md

@@ -46,9 +46,9 @@ not anonymous inline factories).
 Current stack:
 
 - `brandingExtension` — mu compact header/footer branding + default theme
-- `serverToolsExtension` — status + issues/forum/events/control-plane tools
+- `queryExtension` — read-only retrieval (`query` tool)
+- `operatorCommandExtension` — approved mutation pathway (`command` tool)
 - `eventLogExtension` — event tail + watch widget
-- `messagingSetupExtension` — adapter diagnostics and setup guidance
 
 `mu serve` sets `MU_SERVER_URL` automatically for these extensions.
 
@@ -56,53 +56,43 @@ Default operator UI theme is `mu-gruvbox-dark`.
 
 ## Slash commands (operator-facing)
 
-- `/mu status` — concise server status
-- `/mu control` — active control-plane adapters and webhook routes
-- `/mu setup` — adapter preflight
-- `/mu setup plan <adapter>` — actionable wiring plan
-- `/mu setup apply <adapter>` — guided config apply + control-plane reload
-- `/mu setup verify [adapter]` — runtime verification for mounted routes
-- `/mu setup <adapter>` — sends adapter setup brief to mu agent (`--no-agent` prints local guide)
 - `/mu events [n]` / `/mu events tail [n]` — event log tail
 - `/mu events watch on|off` — toggle event watch widget
 - `/mu brand on|off|toggle` — enable/disable UI branding
+- `/mu help` — dispatcher catalog of registered `/mu` subcommands
 
 ## Tools (agent/operator-facing)
 
-- `mu_status()`
-  - High-level server status.
-- `mu_control_plane({ action })`
-  - `action`: `status | adapters | routes`
-- `mu_issues({ action, ... })`
-  - `action`: `list | get | ready`
-- `mu_forum({ action, ... })`
-  - `action`: `read | post | topics`
-- `mu_events({ action, ... })`
-  - `action`: `tail | query`
-- `mu_messaging_setup({ action, adapter?, public_base_url? })`
-  - `action`: `check | preflight | guide | plan | apply | verify`
-  - `adapter`: `slack | discord | telegram`
+- `query({ action, resource?, ... })`
+  - Read-only pathway.
+  - `action`: `describe | get | list | search | timeline | stats | trace`
+  - Use `action="describe"` for machine-readable capability discovery.
+- `command({ kind, ... })`
+  - Approved mutation pathway through `/api/commands/submit`.
+  - `kind` includes run lifecycle (`run_start|run_resume|run_interrupt`),
+    control-plane lifecycle (`reload|update`), issue lifecycle/dependency edits
+    (`issue_create|issue_update|issue_claim|issue_open|issue_close|issue_dep|issue_undep`),
+    forum posting (`forum_post`), heartbeat program lifecycle
+    (`heartbeat_create|heartbeat_update|heartbeat_delete|heartbeat_trigger|heartbeat_enable|heartbeat_disable`),
+    and cron program lifecycle
+    (`cron_create|cron_update|cron_delete|cron_trigger|cron_enable|cron_disable`).
 
 ### Query contract (context-safe by default)
 
-Read-heavy `mu_*` tools are designed to be summary-first, with explicit narrowing:
+The `query` tool is designed to be programmable + narrow-by-default:
 
-- `limit` controls result size (default is usually `20` for list/query/read actions).
-- `contains` performs case-insensitive content filtering where relevant.
-- `fields` (comma-separated paths) supports precise retrieval on targeted actions (`get`, `status`, `trace`, etc.).
+- `limit` bounds result size (default typically `20`).
+- `fields` (comma-separated paths) enables selective projection.
+- domain filters (`status`, `tag`, `source`, `issue_id`, `run_id`, `conversation_key`, etc.) avoid broad scans.
 
 Recommended flow:
 
-1. Discover with bounded list/query (`limit` + filters).
-2. Select a concrete ID.
-3. Retrieve only required fields via `fields`.
+1. `query(action="describe")` to discover capabilities.
+2. bounded `list`/`search` with focused filters.
+3. targeted `get`/`trace` with `fields` as needed.
 
-Tool `details` may still include richer payloads for diagnostics, but `content` is
-kept compact to reduce context pollution.
+## Control-plane config notes
 
-## Messaging setup notes
-
-- Runtime setup state comes from `GET /api/config` and `.mu/config.json`.
-- `slack`, `discord`, `telegram` are currently modeled as available adapters.
-- `mu_messaging_setup(action=preflight)` is the quickest health check during
-  onboarding.
+- Runtime config source of truth is `.mu/config.json`.
+- Inspect runtime state via `query(action="get", resource="status")` and related `query` reads.
+- Apply control-plane lifecycle mutations via `command(kind="reload")` / `command(kind="update")`.

package/dist/extensions/branding.d.ts

@@ -1,7 +1,7 @@
 /**
  * mu-branding — Custom serve-mode TUI chrome for mu.
  *
- * Defaults to a minimal, information-dense layout:
+ * Defaults to a compact, information-dense layout:
  * - Compact header + footer
  * - Terminal title and working message branding
  * - Lightweight periodic status refresh (open/ready/control-plane)

package/dist/extensions/branding.js

@@ -1,7 +1,7 @@
 /**
  * mu-branding — Custom serve-mode TUI chrome for mu.
  *
- * Defaults to a minimal, information-dense layout:
+ * Defaults to a compact, information-dense layout:
  * - Compact header + footer
  * - Terminal title and working message branding
  * - Lightweight periodic status refresh (open/ready/control-plane)

package/dist/extensions/index.d.ts

@@ -1,33 +1,25 @@
-export { activitiesExtension } from "./activities.js";
 export { brandingExtension } from "./branding.js";
-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 { muToolsExtension } from "./mu-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, serverToolsIssueForumExtension, serverToolsReadOnlyExtension } from "./server-tools.js";
-export { serverToolsReadonlyExtension } from "./server-tools-readonly.js";
+export { queryExtension } from "./query.js";
 /**
  * Serve-mode extension — single facade that bundles all serve extensions.
  */
 export declare const serveExtensionPaths: string[];
 /**
  * Operator-mode extension — single facade that bundles operator UI +
- * full mu tools + approved `/mu` command flow.
+ * query/command tool pathways.
  */
 export declare const operatorExtensionPaths: string[];
 /**
- * Tool-only extension bundle for orchestrator sessions (full tool surface).
+ * Tool-only extension bundle for orchestrator sessions.
  */
 export declare const orchestratorToolExtensionPaths: string[];
 /**
- * Tool-only extension bundle for worker sessions (issue/forum coordination only).
+ * Tool-only extension bundle for worker sessions.
  */
 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,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"}
+{"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,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,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,cAAc,EAAE,MAAM,YAAY,CAAC;AAQ5C;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAA4C,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,UAA+C,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,8BAA8B,UAA4C,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAA4C,CAAC"}

package/dist/extensions/index.js

@@ -1,18 +1,10 @@
-export { activitiesExtension } from "./activities.js";
 export { brandingExtension } from "./branding.js";
-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 { muToolsExtension } from "./mu-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, serverToolsIssueForumExtension, serverToolsReadOnlyExtension } from "./server-tools.js";
-export { serverToolsReadonlyExtension } from "./server-tools-readonly.js";
+export { queryExtension } from "./query.js";
 const RUNTIME_EXTENSION = import.meta.url.endsWith(".ts") ? "ts" : "js";
 function resolveBundledExtensionPath(moduleBasename) {
     return new URL(`./${moduleBasename}.${RUNTIME_EXTENSION}`, import.meta.url).pathname;
@@ -23,14 +15,14 @@ function resolveBundledExtensionPath(moduleBasename) {
 export const serveExtensionPaths = [resolveBundledExtensionPath("mu-serve")];
 /**
  * Operator-mode extension — single facade that bundles operator UI +
- * full mu tools + approved `/mu` command flow.
+ * query/command tool pathways.
  */
 export const operatorExtensionPaths = [resolveBundledExtensionPath("mu-operator")];
 /**
- * Tool-only extension bundle for orchestrator sessions (full tool surface).
+ * Tool-only extension bundle for orchestrator sessions.
  */
-export const orchestratorToolExtensionPaths = [resolveBundledExtensionPath("mu-full-tools")];
+export const orchestratorToolExtensionPaths = [resolveBundledExtensionPath("mu-tools")];
 /**
- * Tool-only extension bundle for worker sessions (issue/forum coordination only).
+ * Tool-only extension bundle for worker sessions.
  */
-export const workerToolExtensionPaths = [resolveBundledExtensionPath("mu-query-tools")];
+export const workerToolExtensionPaths = [resolveBundledExtensionPath("mu-tools")];

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

@@ -1,7 +1,7 @@
 /**
- * mu-operator — Unified operator-mode extension facade.
+ * mu-operator — Operator-mode extension facade.
  *
- * Bundles all mu operator extensions behind a single extension entry so
+ * Bundles operator extensions behind a single extension entry so
  * pi-coding-agent shows one "[Extensions] mu-operator" line instead of many.
  */
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";

package/dist/extensions/mu-operator.js

@@ -1,16 +1,16 @@
 /**
- * mu-operator — Unified operator-mode extension facade.
+ * mu-operator — Operator-mode extension facade.
  *
- * Bundles all mu operator extensions behind a single extension entry so
+ * Bundles operator extensions behind a single extension entry so
  * pi-coding-agent shows one "[Extensions] mu-operator" line instead of many.
  */
 import { brandingExtension } from "./branding.js";
 import { eventLogExtension } from "./event-log.js";
-import { muFullToolsExtension } from "./mu-full-tools.js";
 import { operatorCommandExtension } from "./operator-command.js";
+import { queryExtension } from "./query.js";
 export function muOperatorExtension(pi) {
     brandingExtension(pi);
-    muFullToolsExtension(pi);
+    queryExtension(pi);
     eventLogExtension(pi);
     operatorCommandExtension(pi);
 }

package/dist/extensions/mu-serve.d.ts

@@ -1,7 +1,7 @@
 /**
- * mu-serve — Unified serve-mode extension facade.
+ * mu-serve — Serve-mode extension facade.
  *
- * Bundles all mu serve extensions behind a single extension entry so
+ * Bundles serve extensions behind a single extension entry so
  * pi-coding-agent shows one "[Extensions] mu-serve" line instead of many.
  */
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";

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

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

package/dist/extensions/mu-serve.js

@@ -1,25 +1,17 @@
 /**
- * mu-serve — Unified serve-mode extension facade.
+ * mu-serve — Serve-mode extension facade.
  *
- * Bundles all mu serve extensions behind a single extension entry so
+ * Bundles serve extensions behind a single extension entry so
  * pi-coding-agent shows one "[Extensions] mu-serve" line instead of many.
  */
 import { brandingExtension } from "./branding.js";
-import { serverToolsExtension } from "./server-tools.js";
 import { eventLogExtension } from "./event-log.js";
-import { messagingSetupExtension } from "./messaging-setup.js";
-import { orchestrationRunsExtension } from "./orchestration-runs.js";
-import { activitiesExtension } from "./activities.js";
-import { heartbeatsExtension } from "./heartbeats.js";
-import { cronExtension } from "./cron.js";
+import { operatorCommandExtension } from "./operator-command.js";
+import { queryExtension } from "./query.js";
 export function muServeExtension(pi) {
     brandingExtension(pi);
-    serverToolsExtension(pi);
+    queryExtension(pi);
     eventLogExtension(pi);
-    messagingSetupExtension(pi);
-    orchestrationRunsExtension(pi);
-    activitiesExtension(pi);
-    heartbeatsExtension(pi);
-    cronExtension(pi);
+    operatorCommandExtension(pi);
 }
 export default muServeExtension;

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

@@ -0,0 +1,9 @@
+/**
+ * mu-tools — Tool-only extension bundle for non-interactive roles.
+ *
+ * Registers `query` (read) and `command` (mutation).
+ */
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+export declare function muToolsExtension(pi: ExtensionAPI): void;
+export default muToolsExtension;
+//# sourceMappingURL=mu-tools.d.ts.map

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

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

package/dist/extensions/mu-tools.js

@@ -0,0 +1,12 @@
+/**
+ * mu-tools — Tool-only extension bundle for non-interactive roles.
+ *
+ * Registers `query` (read) and `command` (mutation).
+ */
+import { operatorCommandExtension } from "./operator-command.js";
+import { queryExtension } from "./query.js";
+export function muToolsExtension(pi) {
+    queryExtension(pi);
+    operatorCommandExtension(pi);
+}
+export default muToolsExtension;

package/dist/extensions/operator-command.d.ts

@@ -1,14 +1,13 @@
 /**
- * mu_command — Operator mutation tool.
+ * command — Approved 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.
+ * - Supports mutation-capable command kinds only.
  */
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-export declare const MU_COMMAND_TOOL_NAME = "mu_command";
+export declare const COMMAND_TOOL_NAME = "command";
 export declare function operatorCommandExtension(pi: ExtensionAPI): void;
 export default operatorCommandExtension;
 //# sourceMappingURL=operator-command.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"operator-command.d.ts","sourceRoot":"","sources":["../../src/extensions/operator-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAgMjD,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,QAqDxD;AAED,eAAe,wBAAwB,CAAC"}
+{"version":3,"file":"operator-command.d.ts","sourceRoot":"","sources":["../../src/extensions/operator-command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,eAAO,MAAM,iBAAiB,YAAY,CAAC;AA2H3C,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,QA6FxD;AAED,eAAe,wBAAwB,CAAC"}

package/dist/extensions/operator-command.js

@@ -1,102 +1,14 @@
 /**
- * mu_command — Operator mutation tool.
+ * command — Approved 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.
+ * - Supports mutation-capable command kinds only.
  */
 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 };
-    }
-}
+export const COMMAND_TOOL_NAME = "command";
 async function executeViaServer(serverUrl, params) {
     const url = `${serverUrl.replace(/\/+$/, "")}/api/commands/submit`;
     const response = await fetch(url, {
@@ -149,7 +61,6 @@ async function executeViaServer(serverUrl, params) {
     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}`;
@@ -159,12 +70,6 @@ async function executeViaServer(serverUrl, params) {
         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";
@@ -175,40 +80,78 @@ async function executeViaServer(serverUrl, params) {
     }
     return {
         content: [{ type: "text", text: summary }],
-        details: { kind: params.kind, pipeline_result: result, query_result: readResult },
+        details: { kind: params.kind, pipeline_result: result },
     };
 }
 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",
+            "issue_create",
+            "issue_update",
+            "issue_claim",
+            "issue_open",
+            "issue_close",
+            "issue_dep",
+            "issue_undep",
+            "forum_post",
+            "heartbeat_create",
+            "heartbeat_update",
+            "heartbeat_delete",
+            "heartbeat_trigger",
+            "heartbeat_enable",
+            "heartbeat_disable",
+            "cron_create",
+            "cron_update",
+            "cron_delete",
+            "cron_trigger",
+            "cron_enable",
+            "cron_disable",
         ]),
         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" })),
+        root_issue_id: Type.Optional(Type.String({ description: "Root issue ID for run_resume / run_interrupt" })),
         max_steps: Type.Optional(Type.Number({ description: "Max steps for run_start / run_resume" })),
+        id: Type.Optional(Type.String({ description: "Issue ID for issue_update/issue_claim/issue_open/issue_close" })),
+        title: Type.Optional(Type.String({ description: "Issue title for issue_create" })),
+        body: Type.Optional(Type.String({ description: "Issue/forum body text (issue_create, issue_update, forum_post)" })),
+        topic: Type.Optional(Type.String({ description: "Forum topic for forum_post" })),
+        author: Type.Optional(Type.String({ description: "Forum author for forum_post (default: operator)" })),
+        tags: Type.Optional(Type.String({ description: "Comma-separated tags for issue_create/issue_update" })),
+        add_tags: Type.Optional(Type.String({ description: "Comma-separated tags to add for issue_update" })),
+        remove_tags: Type.Optional(Type.String({ description: "Comma-separated tags to remove for issue_update" })),
+        priority: Type.Optional(Type.Number({ description: "Issue priority for issue_create/issue_update" })),
+        status: Type.Optional(Type.String({ description: "Issue status for issue_update" })),
+        outcome: Type.Optional(Type.String({ description: "Outcome for issue_update/issue_close" })),
+        parent_id: Type.Optional(Type.String({ description: "Optional parent issue id for issue_create" })),
+        src_id: Type.Optional(Type.String({ description: "Source issue id for issue_dep/issue_undep" })),
+        dst_id: Type.Optional(Type.String({ description: "Destination issue id for issue_dep/issue_undep" })),
+        dep_type: Type.Optional(Type.String({ description: "Dependency type: blocks|parent" })),
+        program_id: Type.Optional(Type.String({ description: "Program ID for heartbeat/cron update|delete|trigger|enable|disable" })),
+        target_kind: Type.Optional(Type.String({ description: "Program target kind: run|activity" })),
+        run_job_id: Type.Optional(Type.String({ description: "Run target job ID for heartbeat/cron program mutations" })),
+        run_root_issue_id: Type.Optional(Type.String({ description: "Run target root issue ID for heartbeat/cron program mutations" })),
+        activity_id: Type.Optional(Type.String({ description: "Activity target ID for heartbeat/cron program mutations" })),
+        every_ms: Type.Optional(Type.Number({ description: "Heartbeat interval ms, or cron every schedule interval ms" })),
+        reason: Type.Optional(Type.String({ description: "Heartbeat/cron execution reason" })),
+        wake_mode: Type.Optional(Type.String({ description: "Wake mode for run targets: immediate|next_heartbeat" })),
+        enabled: Type.Optional(Type.Boolean({ description: "Program enabled state" })),
+        schedule_kind: Type.Optional(Type.String({ description: "Cron schedule kind: at|every|cron" })),
+        at_ms: Type.Optional(Type.Number({ description: "Cron one-shot timestamp epoch ms" })),
+        at: Type.Optional(Type.String({ description: "Cron one-shot timestamp ISO-8601" })),
+        anchor_ms: Type.Optional(Type.Number({ description: "Cron every schedule anchor epoch ms" })),
+        expr: Type.Optional(Type.String({ description: "Cron expression (5-field)" })),
+        tz: Type.Optional(Type.String({ description: "Cron expression timezone (IANA)" })),
     });
     pi.registerTool({
-        name: MU_COMMAND_TOOL_NAME,
+        name: 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.",
+            "Execute approved mutation commands through the command API.",
+            "Supports run lifecycle, control-plane lifecycle, issue/forum mutations, and heartbeat/cron program management.",
         ].join(" "),
         parameters: CommandParams,
         async execute(_toolCallId, params) {

package/dist/extensions/query.d.ts

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

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

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