@overmux/pi 0.0.1

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@overmux/pi",
+  "version": "0.0.1",
+  "description": "Pi extension and private Unix-socket protocol for Overmux",
+  "keywords": [
+    "overmux",
+    "pi-package"
+  ],
+  "homepage": "https://github.com/richardgill/overmux/tree/main/packages/ecosystem/pi",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/richardgill/overmux",
+    "directory": "packages/ecosystem/pi"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=24.20.0"
+  },
+  "bin": {
+    "overmux-pi-send": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    },
+    "./extension": {
+      "types": "./dist/extension.d.ts",
+      "import": "./dist/extension.js"
+    },
+    "./live-events": {
+      "types": "./dist/live-events.d.ts",
+      "import": "./dist/live-events.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "src",
+    "!src/**/*.test.*",
+    "!src/**/fixtures",
+    "!src/**/testing",
+    "README.md"
+  ],
+  "dependencies": {
+    "@richardgill/pi-config": "0.0.8",
+    "@shikijs/langs": "4.4.3",
+    "@shikijs/themes": "4.4.3",
+    "jsonc-parser": "3.3.1",
+    "lucide-react": "1.32.0",
+    "react-markdown": "10.1.0",
+    "shiki": "4.4.3",
+    "zod": "4.4.3",
+    "@overmux/git": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "happy-dom": "20.11.6",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "vitest": "4.1.10",
+    "overmux": "0.0.1"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "overmux": "^0.0.1",
+    "react": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
+  },
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && vp pack && cp src/styles.css dist/styles.css",
+    "overmux-pi-send": "node dist/cli.js",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+
+import { sendUserMessage } from "./protocol.js";
+
+type CliInput = {
+  sessionId: string;
+  deliverAs: "steer" | "followUp";
+  message: string;
+};
+
+const usage = (): string =>
+  "Usage: overmux-pi-send <sessionId> [--after-turn|--follow-up] <message>\n";
+
+const parseInput = (args: string[]): CliInput | undefined => {
+  const [sessionId, ...rest] = args;
+  if (!sessionId) {
+    return undefined;
+  }
+  const followUp = rest.at(0) === "--follow-up";
+  const afterTurn = rest.at(0) === "--after-turn";
+  const message = rest
+    .slice(followUp || afterTurn ? 1 : 0)
+    .join(" ")
+    .trim();
+  return { sessionId, deliverAs: followUp ? "followUp" : "steer", message };
+};
+
+const readMessage = async (message: string): Promise<string> =>
+  message ||
+  (process.stdin.isTTY ? "" : (await readFile("/dev/stdin", "utf8")).trim());
+
+const main = async (): Promise<void> => {
+  const input = parseInput(process.argv.slice(2));
+  if (!input) {
+    throw new Error(usage());
+  }
+  const message = await readMessage(input.message);
+  if (!message) {
+    throw new Error(usage());
+  }
+  const response = await sendUserMessage(input.sessionId, {
+    requestId: randomUUID(),
+    message,
+    deliverAs: input.deliverAs,
+  });
+  if (!response?.ok) {
+    throw new Error(JSON.stringify(response ?? { error: "unavailable" }));
+  }
+  process.stdout.write(`${JSON.stringify(response)}\n`);
+};
+
+void main().catch((error: unknown) => {
+  process.stderr.write(
+    `${error instanceof Error ? error.message : String(error)}\n`,
+  );
+  process.exitCode = 1;
+});

package/src/config.ts

@@ -0,0 +1,87 @@
+import { isAbsolute } from "node:path";
+
+import { templatedString } from "@richardgill/pi-config";
+import { z } from "zod";
+
+export const DEFAULT_OVERMUX_PI_CONFIG = {
+  inspectionCommand: [
+    "pi-jq",
+    "{{childSessionId}}",
+    "--messages",
+    "3",
+    "--role",
+    "assistant",
+  ],
+  inspectionTimeoutMs: 5000,
+  supervisionPrompt: "Continue supervision.",
+  liveEventsDir: null,
+};
+
+const InspectionArgumentSchema = templatedString({
+  variables: ["childSessionId"],
+  missing: "keep",
+});
+
+const InspectionCommandSchema = z
+  .array(InspectionArgumentSchema)
+  .min(1)
+  .refine(
+    (command) =>
+      command.reduce(
+        (count, argument) =>
+          count + argument.split("{{childSessionId}}").length - 1,
+        0,
+      ) === 1,
+    "must contain exactly one {{childSessionId}} placeholder",
+  );
+
+const InspectionTimeoutSchema = z.number().int().positive().max(60_000);
+const SupervisionPromptSchema = z.string();
+const LiveEventsDirSchema = z
+  .string()
+  .trim()
+  .min(1)
+  .refine(isAbsolute, "must be an absolute path")
+  .nullable();
+
+const ConfigSchema = z
+  .object({
+    inspectionCommand: InspectionCommandSchema,
+    inspectionTimeoutMs: InspectionTimeoutSchema.default(
+      DEFAULT_OVERMUX_PI_CONFIG.inspectionTimeoutMs,
+    ),
+    supervisionPrompt: SupervisionPromptSchema.default(
+      DEFAULT_OVERMUX_PI_CONFIG.supervisionPrompt,
+    ),
+    liveEventsDir: LiveEventsDirSchema.default(
+      DEFAULT_OVERMUX_PI_CONFIG.liveEventsDir,
+    ),
+  })
+  .strict();
+
+const DefaultConfigSchema = z
+  .object({
+    inspectionCommand: z.undefined().optional(),
+    inspectionTimeoutMs: InspectionTimeoutSchema.optional(),
+    supervisionPrompt: SupervisionPromptSchema.optional(),
+    liveEventsDir: LiveEventsDirSchema.optional(),
+  })
+  .strict()
+  .transform((config) => ({
+    inspectionCommand: [...DEFAULT_OVERMUX_PI_CONFIG.inspectionCommand],
+    inspectionTimeoutMs:
+      config.inspectionTimeoutMs ??
+      DEFAULT_OVERMUX_PI_CONFIG.inspectionTimeoutMs,
+    supervisionPrompt:
+      config.supervisionPrompt ?? DEFAULT_OVERMUX_PI_CONFIG.supervisionPrompt,
+    liveEventsDir:
+      config.liveEventsDir ?? DEFAULT_OVERMUX_PI_CONFIG.liveEventsDir,
+  }));
+
+export const OvermuxPiConfigSchema = z.union([
+  ConfigSchema,
+  DefaultConfigSchema,
+]);
+
+export type OvermuxPiConfig = z.output<typeof OvermuxPiConfigSchema>;
+export type OvermuxPiConfigInput = z.input<typeof OvermuxPiConfigSchema>;