@samuelho-dev/coordinator 0.3.0-beta.3 → 0.3.0-beta.4

package/README.md

@@ -9,7 +9,7 @@ There are two parts: **one inspector service**, plus **native integrations on ea
 The API and setup CLI require Node >=22.19. Install the version-pinned release:
 
 ```sh
-npm install --global @samuelho-dev/coordinator@0.3.0-beta.3
+npm install --global @samuelho-dev/coordinator@0.3.0-beta.4
 ```
 
 For source development only, use a reviewed checkout with `pnpm install --frozen-lockfile && pnpm build` (pnpm 11.9.0). `coordinator-install --source` deliberately activates that exact local package; never source-link a native package manager's own `node_modules` directory.
@@ -100,8 +100,8 @@ The installer validates prerequisites and creates launchers/config fragments. `-
 
 | Target | Activation | Presence publisher |
 | --- | --- | --- |
-| OMP | `omp plugin install @samuelho-dev/coordinator@0.3.0-beta.3`; merge only the generated `mcp.json` coordinator entry into native MCP settings. `/coordinator list` needs no MCP registration. | In-session extension. |
-| Pi | `pi install npm:@samuelho-dev/coordinator@0.3.0-beta.3`; directly registers `coordinator_session_list` / `coordinator_session_inspect`, without an MCP bridge. | In-session extension. |
+| OMP | `omp plugin install @samuelho-dev/coordinator@0.3.0-beta.4`; merge only the generated `mcp.json` coordinator entry into native MCP settings. `/coordinator list` needs no MCP registration. | In-session extension. |
+| Pi | `pi install npm:@samuelho-dev/coordinator@0.3.0-beta.4`; directly registers `coordinator_session_list` / `coordinator_session_inspect`, without an MCP bridge. | In-session extension. |
 | Claude Code | `claude --plugin-dir "$PRIVATE/claude-host"`; approve generated hooks/MCP tools; preserve existing status-line configuration. | Separate `connector.sh`. |
 | Codex CLI | Merge generated `hooks/hooks.json` and coordinator `mcp.toml`; trust only Coordinator's handlers in native `/hooks`. | Separate `connector.sh`. |
 | Hermes | Merge generated hook entries and `mcp_servers.coordinator` from `mcp.yaml` into the selected profile; no Python plugin installation. | Separate `connector.sh`. |
@@ -118,7 +118,7 @@ Hook/status-line/notification capture is local and can initialize identity/cache
 
 ### Native session commands and Rex
 
-Pi/OMP register `/coordinator list`. It follows every API page visible to the owner key and displays full native session/agent IDs, machine names/installation IDs, harness and all reported metadata: model/provider, workspace, activity, connection liveness, process identity and Rex association. Missing metadata is omitted. It reads the API directly, with no model turn, per-session resource sampling or separate MCP registration.
+Pi/OMP register `/coordinator list`. It follows every API page visible to the owner key and returns pretty JSON (`{ "sessions": [...] }`) using Effect's JSON formatter, with native JSON syntax highlighting in the terminal. Each session preserves full native session/agent IDs, machine names/installation IDs, harness and all reported metadata: model/provider, workspace, activity, connection liveness, process identity and Rex association. Missing metadata is omitted; an empty listing returns `{ "sessions": [] }`. It reads the API directly, with no model turn, per-session resource sampling or separate MCP registration.
 
 Session JSON is Coordinator's fleet model, not an OSC wire payload. `rex` preserves `REX_SERVER` as `serverAddress` and the actual full `REX_SESSION`/`REX_BLOCK` IDs; these are separate from native agent IDs. Optional `programStatus` uses [Rex Program Status Protocol](https://www.superlogical.com/rex/docs/build/program-status) semantics: idle/working/done/error, or blocked with permission/question/auth kind. Agent `kind` remains separate. Tool/API waits are working; unknown outcomes are omitted, not inferred from disconnects or generic stops. API connection leases do not expire terminal status records.
 
@@ -133,13 +133,13 @@ This is a clean schema cutover, with no legacy aliases or compatibility shims. B
 
 ## Plugin publication
 
-The version-pinned beta is `@samuelho-dev/coordinator@0.3.0-beta.3`. The [npm workflow](.github/workflows/npm-release.yaml) promotes the exact-source CI-accepted tarball with owner authorization; [first-publication authentication and trust setup](#first-npm-publication) are prerequisites for a new publisher. The existing [release workflow](.github/workflows/release.yaml) publishes server/chart/GitHub artifacts, not native marketplace listings. Generated per-machine configuration is not a portable marketplace package.
+The version-pinned beta is `@samuelho-dev/coordinator@0.3.0-beta.4`. The [npm workflow](.github/workflows/npm-release.yaml) promotes the exact-source CI-accepted tarball with owner authorization; [first-publication authentication and trust setup](#first-npm-publication) are prerequisites for a new publisher. The existing [release workflow](.github/workflows/release.yaml) publishes server/chart/GitHub artifacts, not native marketplace listings. Generated per-machine configuration is not a portable marketplace package.
 
 For a version-pinned install, use your native package manager, then follow [configuration](#configuration) and [native host setup](#native-host-setup):
 
 ```sh
-omp plugin install @samuelho-dev/coordinator@0.3.0-beta.3
-pi install npm:@samuelho-dev/coordinator@0.3.0-beta.3
+omp plugin install @samuelho-dev/coordinator@0.3.0-beta.4
+pi install npm:@samuelho-dev/coordinator@0.3.0-beta.4
 ```
 
 Stock OMP 18.12.6 does not automatically update npm plugins. Until upstream fixes its channel handling and dry-run behavior, use explicit versioned installs for updates; avoid `omp plugin upgrade` and `upgrade --dry-run` for beta releases.
@@ -148,6 +148,8 @@ Stock OMP 18.12.6 does not automatically update npm plugins. Until upstream fixe
 
 `0.3.0-beta.3` adds native `/coordinator list`, secure self-host bootstrap/authenticated client setup, and Rex references/status normalization without an OMP fork. Runtime dependency pins are unchanged.
 
+`0.3.0-beta.4` fixes `/coordinator list` output: Effect-formatted, indented JSON with native syntax highlighting instead of hand-built text and literal fences. Native UI imports are static and selected at build time; the renderer registers once at startup. The session wire format and runtime dependencies are unchanged, so the existing beta.3 API needs no redeployment.
+
 | Host | Publication route |
 | --- | --- |
 | [OMP](https://github.com/can1357/oh-my-pi/blob/main/docs/marketplace.md) | Publish a Git-backed `.omp-plugin/marketplace.json` catalog and runnable plugin tree with `package.json` `omp.extensions`. Claude-compatible `.claude-plugin/marketplace.json` is a fallback. npm catalog sources are not supported; ordinary `omp plugin install PACKAGE` is a separate npm route. |

package/dist/plugins/omp.js

@@ -72327,6 +72327,8 @@ var Cache = Schema_exports.Struct({ version: Schema_exports.Literal(2), kind: Sc
 var ClaudeRoster = Schema_exports.Array(Schema_exports.Struct({ sessionId: Schema_exports.optional(Id2), id: Schema_exports.optional(Id2), pid: Schema_exports.optional(Schema_exports.Int), cwd: Schema_exports.optional(Schema_exports.String), kind: Schema_exports.optional(Id2), status: Schema_exports.optional(Schema_exports.Literals(["busy", "waiting", "idle"])), waitingFor: Schema_exports.optional(Schema_exports.String) })).check(Schema_exports.isMaxLength(256));
 
 // src/plugin.ts
+import { highlightCode } from "@oh-my-pi/pi-coding-agent";
+import { Text } from "@oh-my-pi/pi-tui";
 var provenance = (source, scope3, scopeDescription, observedAt, nativeUpdatedAt = null) => ({
   source,
   scope: scope3,
@@ -72550,23 +72552,6 @@ var registerCoordinateKeyword = Effect_exports.gen(function* () {
   const { isMagicKeyword, setMagicKeywords } = yield* Effect_exports.tryPromise({ try: () => import("@oh-my-pi/pi-tui/prompt/magic-keywords"), catch: () => new NativeError({ operation: "Load native keyword highlighter" }) });
   setMagicKeywords([...MAGIC_KEYWORDS.filter(({ word }) => isMagicKeyword(word)), { word: "coordinate", hue: [190, 260] }]);
 });
-var formatSessionList = (sessions) => {
-  if (sessions.length === 0) return "No sessions are currently visible to this API key.";
-  const lines = [`Coordinator: ${sessions.length} sessions visible to this API key.`, "", "~~~text"];
-  for (const session of sessions) {
-    lines.push(
-      `Machine: ${JSON.stringify(session.machineName ?? "unavailable")} (${JSON.stringify(session.ref.machineId)})`,
-      `Session: ${session.ref.harness} ${JSON.stringify(session.ref.nativeSessionId)}`
-    );
-    if (session.ref.nativeAgentId !== void 0) lines.push(`Agent ID: ${JSON.stringify(session.ref.nativeAgentId)}`);
-    for (const [field, value5] of Object.entries(session)) {
-      if (field !== "ref" && field !== "machineName" && value5 !== void 0) lines.push(`${field}: ${JSON.stringify(value5)}`);
-    }
-    lines.push("");
-  }
-  lines.push("~~~");
-  return lines.join("\n");
-};
 function plugin(host) {
   const harness = "omp";
   const runtime2 = ManagedRuntime_exports.make(Layer_exports.mergeAll(NodeServices_exports.layer, Host2.layer, Mcp.layer, Layer_exports.succeed(Logger_exports.LogToStderr, true)));
@@ -72576,6 +72561,10 @@ function plugin(host) {
   let stopped = false;
   const rexReporter = harness === "pi" ? createRexReporter((sequence) => process.stdout.write(sequence)) : void 0;
   let terminal = false;
+  host.registerMessageRenderer("coordinator-list", (message) => {
+    if (typeof message.content !== "string") return void 0;
+    return new Text(message.details === void 0 ? message.content : highlightCode(message.content, "json").join("\n"), 0, 0);
+  });
   host.registerCommand("coordinator", {
     description: "List visible sessions, their machines, and native metadata",
     handler: async (args2) => {
@@ -72608,11 +72597,12 @@ function plugin(host) {
         }, { triggerTurn: false });
         return;
       }
+      const result5 = { sessions: exit3.value };
       host.sendMessage({
         customType: "coordinator-list",
-        content: formatSessionList(exit3.value),
+        content: Formatter_exports.formatJson(result5, { space: 2 }),
         display: true,
-        details: { sessions: exit3.value }
+        details: result5
       }, { triggerTurn: false });
     }
   });

package/dist/plugins/pi.js

@@ -1,6 +1,6 @@
 // src/plugin.ts
 import { NodeServices } from "@effect/platform-node";
-import { Cause as Cause3, Clock as Clock3, Console as Console2, Effect as Effect7, Layer as Layer3, Logger, ManagedRuntime, Schema as Schema5 } from "effect";
+import { Cause as Cause3, Clock as Clock3, Console as Console2, Effect as Effect7, Formatter as Formatter2, Layer as Layer3, Logger, ManagedRuntime, Schema as Schema5 } from "effect";
 
 // src/inspection.ts
 import { Effect, Option, Path as PlatformPath, Schema, SchemaParser } from "effect";
@@ -1191,6 +1191,8 @@ var Cache = Schema4.Struct({ version: Schema4.Literal(2), kind: Schema4.Literal(
 var ClaudeRoster = Schema4.Array(Schema4.Struct({ sessionId: Schema4.optional(Id2), id: Schema4.optional(Id2), pid: Schema4.optional(Schema4.Int), cwd: Schema4.optional(Schema4.String), kind: Schema4.optional(Id2), status: Schema4.optional(Schema4.Literals(["busy", "waiting", "idle"])), waitingFor: Schema4.optional(Schema4.String) })).check(Schema4.isMaxLength(256));
 
 // src/plugin.ts
+import { highlightCode } from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
 var provenance = (source, scope, scopeDescription, observedAt, nativeUpdatedAt = null) => ({
   source,
   scope,
@@ -1414,23 +1416,6 @@ var registerCoordinateKeyword = Effect7.gen(function* () {
   const { isMagicKeyword, setMagicKeywords } = yield* Effect7.tryPromise({ try: () => import("@oh-my-pi/pi-tui/prompt/magic-keywords"), catch: () => new NativeError({ operation: "Load native keyword highlighter" }) });
   setMagicKeywords([...MAGIC_KEYWORDS.filter(({ word }) => isMagicKeyword(word)), { word: "coordinate", hue: [190, 260] }]);
 });
-var formatSessionList = (sessions) => {
-  if (sessions.length === 0) return "No sessions are currently visible to this API key.";
-  const lines = [`Coordinator: ${sessions.length} sessions visible to this API key.`, "", "~~~text"];
-  for (const session of sessions) {
-    lines.push(
-      `Machine: ${JSON.stringify(session.machineName ?? "unavailable")} (${JSON.stringify(session.ref.machineId)})`,
-      `Session: ${session.ref.harness} ${JSON.stringify(session.ref.nativeSessionId)}`
-    );
-    if (session.ref.nativeAgentId !== void 0) lines.push(`Agent ID: ${JSON.stringify(session.ref.nativeAgentId)}`);
-    for (const [field, value] of Object.entries(session)) {
-      if (field !== "ref" && field !== "machineName" && value !== void 0) lines.push(`${field}: ${JSON.stringify(value)}`);
-    }
-    lines.push("");
-  }
-  lines.push("~~~");
-  return lines.join("\n");
-};
 function plugin(host) {
   const harness = "pi";
   const runtime = ManagedRuntime.make(Layer3.mergeAll(NodeServices.layer, Host.layer, Mcp.layer, Layer3.succeed(Logger.LogToStderr, true)));
@@ -1440,6 +1425,10 @@ function plugin(host) {
   let stopped = false;
   const rexReporter = harness === "pi" ? createRexReporter((sequence) => process.stdout.write(sequence)) : void 0;
   let terminal = false;
+  host.registerMessageRenderer("coordinator-list", (message) => {
+    if (typeof message.content !== "string") return void 0;
+    return new Text(message.details === void 0 ? message.content : highlightCode(message.content, "json").join("\n"), 0, 0);
+  });
   host.registerCommand("coordinator", {
     description: "List visible sessions, their machines, and native metadata",
     handler: async (args) => {
@@ -1472,11 +1461,12 @@ function plugin(host) {
         }, { triggerTurn: false });
         return;
       }
+      const result = { sessions: exit.value };
       host.sendMessage({
         customType: "coordinator-list",
-        content: formatSessionList(exit.value),
+        content: Formatter2.formatJson(result, { space: 2 }),
         display: true,
-        details: { sessions: exit.value }
+        details: result
       }, { triggerTurn: false });
     }
   });

package/dist/src/plugin.js

@@ -1,11 +1,13 @@
 import { NodeServices } from "@effect/platform-node";
-import { Cause, Clock, Console, Effect, Layer, Logger, ManagedRuntime, Schema } from "effect";
+import { Cause, Clock, Console, Effect, Formatter, Layer, Logger, ManagedRuntime, Schema } from "effect";
 import { createInspection, HttpError, InspectionTools, metric, sessionRefKey, unavailableMetric } from "./inspection.js";
 import { Mcp } from "./mcp.js";
 import { connectNative, loadConnectorConfig, NativeError, readConnectorToken, resolveNativeConfig, withProcessResources } from "./native.js";
 import { identifyProcess } from "./resources.js";
 import { Host as PlatformHost } from "./platform.js";
 import { createRexReporter, readRexContext } from "./rex.js";
+import { highlightCode } from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
 const provenance = (source, scope, scopeDescription, observedAt, nativeUpdatedAt = null) => ({
     source, scope, scopeDescription, observedAt, nativeUpdatedAt, estimated: false, derived: false, shared: false, partial: false, stale: false,
 });
@@ -197,23 +199,6 @@ export const registerCoordinateKeyword = Effect.gen(function* () {
     // ponytail: native exposes no registry getter/append; only known core keywords can be preserved.
     setMagicKeywords([...MAGIC_KEYWORDS.filter(({ word }) => isMagicKeyword(word)), { word: "coordinate", hue: [190, 260] }]);
 });
-const formatSessionList = (sessions) => {
-    if (sessions.length === 0)
-        return "No sessions are currently visible to this API key.";
-    const lines = [`Coordinator: ${sessions.length} sessions visible to this API key.`, "", "~~~text"];
-    for (const session of sessions) {
-        lines.push(`Machine: ${JSON.stringify(session.machineName ?? "unavailable")} (${JSON.stringify(session.ref.machineId)})`, `Session: ${session.ref.harness} ${JSON.stringify(session.ref.nativeSessionId)}`);
-        if (session.ref.nativeAgentId !== undefined)
-            lines.push(`Agent ID: ${JSON.stringify(session.ref.nativeAgentId)}`);
-        for (const [field, value] of Object.entries(session)) {
-            if (field !== "ref" && field !== "machineName" && value !== undefined)
-                lines.push(`${field}: ${JSON.stringify(value)}`);
-        }
-        lines.push("");
-    }
-    lines.push("~~~");
-    return lines.join("\n");
-};
 export default function plugin(host) {
     const harness = COORDINATOR_HARNESS;
     const runtime = ManagedRuntime.make(Layer.mergeAll(NodeServices.layer, PlatformHost.layer, Mcp.layer, Layer.succeed(Logger.LogToStderr, true)));
@@ -224,6 +209,11 @@ export default function plugin(host) {
     // Stock OMP owns OSC 7501 (terminal.programStatus); never duplicate or override it.
     const rexReporter = harness === "pi" ? createRexReporter((sequence) => process.stdout.write(sequence)) : undefined;
     let terminal = false;
+    host.registerMessageRenderer("coordinator-list", (message) => {
+        if (typeof message.content !== "string")
+            return undefined;
+        return new Text(message.details === undefined ? message.content : highlightCode(message.content, "json").join("\n"), 0, 0);
+    });
     host.registerCommand("coordinator", {
         description: "List visible sessions, their machines, and native metadata",
         handler: async (args) => {
@@ -259,9 +249,10 @@ export default function plugin(host) {
                 }, { triggerTurn: false });
                 return;
             }
+            const result = { sessions: exit.value };
             host.sendMessage({
-                customType: "coordinator-list", content: formatSessionList(exit.value), display: true,
-                details: { sessions: exit.value },
+                customType: "coordinator-list", content: Formatter.formatJson(result, { space: 2 }), display: true,
+                details: result,
             }, { triggerTurn: false });
         },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samuelho-dev/coordinator",
-  "version": "0.3.0-beta.3",
+  "version": "0.3.0-beta.4",
   "type": "module",
   "description": "Read-only native agent session inspection across self-hosted machines",
   "license": "MIT",
@@ -53,6 +53,7 @@
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "1.0.4",
+    "@earendil-works/pi-tui": "1.0.4",
     "@effect/tsgo": "0.49.0",
     "@effect/vitest": "4.0.3",
     "@oh-my-pi/pi-coding-agent": "18.6.1",