@overmux/pi 0.0.1

package/README.md

@@ -0,0 +1,118 @@
+# @overmux/pi
+
+The Pi extension and private Unix-socket protocol used by Overmux. It exposes live conversation events, structured inbound messages, and parent/delegate completion notifications over a private Unix socket. It registers no tools or commands.
+
+This package was migrated from a standalone Pi extension at commit `52fb1712f205c939d3f58b84619c1fb4e0aab972` and is now owned and versioned by Overmux.
+
+## Integration
+
+Install the extension through Pi:
+
+```sh
+pi install npm:@overmux/pi
+```
+
+For development, run `pnpm --filter @overmux/pi build`, then `pi install /absolute/path/to/packages/ecosystem/pi` to use the local package directly. Pi loads the package's built JavaScript extension. Load `@overmux/pi` in every parent and child Pi through the global Pi `settings.json`. A launcher starts a child with `PI_CHILD=1`, `PI_PARENT_SESSION_ID="$PI_SESSION_ID"`, and `PI_TASK_SLUG=<task-slug>`. `PI_TASK_SLUG` is required whenever `PI_CHILD=1`; it must match `[a-z0-9](?:[a-z0-9-]{0,11}[a-z0-9])?`. `PI_PARENT_SESSION_ID` is optional; omitting it disables callbacks to the parent. Parent Pi processes do not need a task slug. The extension captures the inherited parent ID and task slug at load time. It derives the parent's short Unix socket path from the ID; no socket path is passed through the environment.
+
+Because the tmux server is an environment boundary, launchers must pass these values explicitly when creating the child. Supervision should react to the model-visible `overmux-pi.delegate-settled` message. Pi runs the configured inspection command, renders its output under `[<task-slug> finished]`, and includes it in model context.
+
+## Configure
+
+Create `overmux-pi.jsonc` in `~/.pi/agent`, or in `$PI_EXTENSION_CONFIG_DIR` when set:
+
+```jsonc
+{
+  "inspectionCommand": [
+    "pi-jq",
+    "{{childSessionId}}",
+    "--messages",
+    "3",
+    "--role",
+    "assistant",
+  ],
+  "inspectionTimeoutMs": 5000,
+  "supervisionPrompt": "Continue supervision.",
+  "liveEventsDir": null,
+}
+```
+
+`inspectionCommand` is executed directly with `pi.exec`, never through a shell. It must contain exactly one `{{childSessionId}}` placeholder, its only permitted template variable. `inspectionTimeoutMs` must be a positive integer no greater than 60000.
+
+## Inbound user messages
+
+The per-session private socket also accepts versioned `user_message` requests. `requestId` is required and bounded; retries with the same ID return the original response without delivering twice. Requests have non-empty `message`, `deliverAs: "steer" | "followUp"`, and optional `expandPromptTemplates`, which defaults to `true`.
+
+Install the sender CLI with npm, then send from the command line:
+
+```sh
+npm install -g @overmux/pi
+overmux-pi-send <sessionId> [--after-turn|--follow-up] <message>
+printf 'Review the changes.' | overmux-pi-send <sessionId>
+```
+
+`--after-turn` is the default and sends a `steer`; `--follow-up` queues until the current agent run finishes. It prints the JSON response and exits nonzero when delivery is unavailable.
+
+Use the exported sender API rather than deriving socket paths. It has native Node.js JavaScript and declaration exports:
+
+```ts
+import { sendUserMessage } from "@overmux/pi/protocol";
+
+const response = await sendUserMessage(sessionId, {
+  requestId: crypto.randomUUID(),
+  message: "Review the changes.",
+  deliverAs: "steer",
+});
+```
+
+Successful responses include `delivery: "immediate" | "steer" | "followUp"`. Idle sessions deliver immediately; busy sessions use `steer` after the current assistant turn and tools, or `followUp` after the current agent run. Malformed or oversized frames are disconnected without a response. Delegate notifications retain their existing `ACK` response.
+
+## Live event stream
+
+Set `liveEventsDir` to an absolute directory to enable the sidecar. It defaults to `null` because the stream contains conversation and tool data and grows without rotation. The directory must be outside Pi's session directory tree.
+
+```jsonc
+{
+  "liveEventsDir": "/home/me/.local/state/overmux/pi/events",
+}
+```
+
+Each session runtime writes one append-only stream:
+
+```text
+<liveEventsDir>/<sessionId>/<streamId>.jsonl
+```
+
+Reloads and session replacements close the old stream and create a new `streamId`. Every complete JSONL record has this envelope:
+
+```json
+{
+  "version": 1,
+  "sessionId": "...",
+  "processInstanceId": "<pid>-<uuid>",
+  "streamId": "...",
+  "sequence": 1,
+  "timestamp": 1700000000000,
+  "event": {
+    "type": "session_start",
+    "reason": "startup",
+    "cwd": "/project",
+    "pid": 1234
+  }
+}
+```
+
+`sequence` starts at 1 and increases within a stream. A tailer should checkpoint `(sessionId, streamId, sequence)` or its byte offset, process only newline-terminated records, and retain an incomplete final line until the next read. `processInstanceId` is stable across extension reloads in one Pi process; `streamId` distinguishes each session runtime.
+
+The stream includes session metadata/compaction/tree events, agent and turn boundaries, message lifecycle events, tool execution start/end, and model/thinking changes. `message_start` and `message_end` contain message snapshots. `message_update` deliberately contains only a compact `assistantMessageEvent`: cumulative `message` and `partial` snapshots plus final block content are omitted, while text, thinking, and tool-call deltas retain `contentIndex`. The complete finalized message remains on `message_end`. Generated `messageId` and `messageSequence` correlate each message lifecycle within the stream.
+
+Writes are serialized and each record is appended with its newline in one operation. Normal event handlers never await filesystem I/O. Shutdown waits for queued records, including `session_shutdown`; a write or serialization failure disables that stream without notifying, blocking, or changing the TUI. The exported `LiveEventRecord`, `CompactAssistantMessageEvent`, `liveEventSessionDir`, and `liveEventStreamPath` APIs are the supported tailer seam.
+
+## Manual smoke test
+
+From the repository root, load only this extension:
+
+```bash
+pi --no-extensions -e ./packages/ecosystem/pi
+```
+
+Launch children through tmux with the parent's current Pi session ID, for example `tmux new-session -e PI_CHILD=1 -e PI_PARENT_SESSION_ID="$PI_SESSION_ID" -e PI_TASK_SLUG=<task-slug> ...`. A child launching a grandchild passes its own `PI_SESSION_ID` the same way. Omit `PI_PARENT_SESSION_ID` when the child should not call back. The extension sends a bounded, acknowledged notification once per settled child leaf, deduplicating receipts by the child session ID and leaf ID; a later leaf produces a new notification.

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/cli.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { sendUserMessage } from "./protocol.js";
+import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+//#region src/cli.ts
+const usage = () => "Usage: overmux-pi-send <sessionId> [--after-turn|--follow-up] <message>\n";
+const parseInput = (args) => {
+	const [sessionId, ...rest] = args;
+	if (!sessionId) return;
+	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) => message || (process.stdin.isTTY ? "" : (await readFile("/dev/stdin", "utf8")).trim());
+const main = async () => {
+	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`);
+};
+main().catch((error) => {
+	process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+	process.exitCode = 1;
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { randomUUID } from \"node:crypto\";\nimport { readFile } from \"node:fs/promises\";\n\nimport { sendUserMessage } from \"./protocol.js\";\n\ntype CliInput = {\n  sessionId: string;\n  deliverAs: \"steer\" | \"followUp\";\n  message: string;\n};\n\nconst usage = (): string =>\n  \"Usage: overmux-pi-send <sessionId> [--after-turn|--follow-up] <message>\\n\";\n\nconst parseInput = (args: string[]): CliInput | undefined => {\n  const [sessionId, ...rest] = args;\n  if (!sessionId) {\n    return undefined;\n  }\n  const followUp = rest.at(0) === \"--follow-up\";\n  const afterTurn = rest.at(0) === \"--after-turn\";\n  const message = rest\n    .slice(followUp || afterTurn ? 1 : 0)\n    .join(\" \")\n    .trim();\n  return { sessionId, deliverAs: followUp ? \"followUp\" : \"steer\", message };\n};\n\nconst readMessage = async (message: string): Promise<string> =>\n  message ||\n  (process.stdin.isTTY ? \"\" : (await readFile(\"/dev/stdin\", \"utf8\")).trim());\n\nconst main = async (): Promise<void> => {\n  const input = parseInput(process.argv.slice(2));\n  if (!input) {\n    throw new Error(usage());\n  }\n  const message = await readMessage(input.message);\n  if (!message) {\n    throw new Error(usage());\n  }\n  const response = await sendUserMessage(input.sessionId, {\n    requestId: randomUUID(),\n    message,\n    deliverAs: input.deliverAs,\n  });\n  if (!response?.ok) {\n    throw new Error(JSON.stringify(response ?? { error: \"unavailable\" }));\n  }\n  process.stdout.write(`${JSON.stringify(response)}\\n`);\n};\n\nvoid main().catch((error: unknown) => {\n  process.stderr.write(\n    `${error instanceof Error ? error.message : String(error)}\\n`,\n  );\n  process.exitCode = 1;\n});\n"],"mappings":";;;;;AAYA,MAAM,cACJ;AAEF,MAAM,cAAc,SAAyC;CAC3D,MAAM,CAAC,WAAW,GAAG,QAAQ;CAC7B,IAAI,CAAC,WACH;CAEF,MAAM,WAAW,KAAK,GAAG,CAAC,MAAM;CAChC,MAAM,YAAY,KAAK,GAAG,CAAC,MAAM;CACjC,MAAM,UAAU,KACb,MAAM,YAAY,YAAY,IAAI,CAAC,CAAC,CACpC,KAAK,GAAG,CAAC,CACT,KAAK;CACR,OAAO;EAAE;EAAW,WAAW,WAAW,aAAa;EAAS;CAAQ;AAC1E;AAEA,MAAM,cAAc,OAAO,YACzB,YACC,QAAQ,MAAM,QAAQ,MAAM,MAAM,SAAS,cAAc,MAAM,EAAA,CAAG,KAAK;AAE1E,MAAM,OAAO,YAA2B;CACtC,MAAM,QAAQ,WAAW,QAAQ,KAAK,MAAM,CAAC,CAAC;CAC9C,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,MAAM,CAAC;CAEzB,MAAM,UAAU,MAAM,YAAY,MAAM,OAAO;CAC/C,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,MAAM,CAAC;CAEzB,MAAM,WAAW,MAAM,gBAAgB,MAAM,WAAW;EACtD,WAAW,WAAW;EACtB;EACA,WAAW,MAAM;CACnB,CAAC;CACD,IAAI,CAAC,UAAU,IACb,MAAM,IAAI,MAAM,KAAK,UAAU,YAAY,EAAE,OAAO,cAAc,CAAC,CAAC;CAEtE,QAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,QAAQ,EAAE,GAAG;AACtD;AAEK,KAAK,CAAC,CAAC,OAAO,UAAmB;CACpC,QAAQ,OAAO,MACb,GAAG,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE,GAC5D;CACA,QAAQ,WAAW;AACrB,CAAC"}

package/dist/config-2jNv4tol.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+//#region src/config.d.ts
+declare const DEFAULT_OVERMUX_PI_CONFIG: {
+  inspectionCommand: string[];
+  inspectionTimeoutMs: number;
+  supervisionPrompt: string;
+  liveEventsDir: null;
+};
+declare const OvermuxPiConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
+  inspectionCommand: z.ZodArray<z.ZodString>;
+  inspectionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+  supervisionPrompt: z.ZodDefault<z.ZodString>;
+  liveEventsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>, z.ZodPipe<z.ZodObject<{
+  inspectionCommand: z.ZodOptional<z.ZodUndefined>;
+  inspectionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+  supervisionPrompt: z.ZodOptional<z.ZodString>;
+  liveEventsDir: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>, z.ZodTransform<{
+  inspectionCommand: string[];
+  inspectionTimeoutMs: number;
+  supervisionPrompt: string;
+  liveEventsDir: string | null;
+}, {
+  inspectionCommand?: undefined;
+  inspectionTimeoutMs?: number | undefined;
+  supervisionPrompt?: string | undefined;
+  liveEventsDir?: string | null | undefined;
+}>>]>;
+type OvermuxPiConfig = z.output<typeof OvermuxPiConfigSchema>;
+type OvermuxPiConfigInput = z.input<typeof OvermuxPiConfigSchema>;
+//#endregion
+export { OvermuxPiConfigSchema as i, OvermuxPiConfig as n, OvermuxPiConfigInput as r, DEFAULT_OVERMUX_PI_CONFIG as t };
+//# sourceMappingURL=config-2jNv4tol.d.ts.map

package/dist/config-2jNv4tol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-2jNv4tol.d.ts","names":[],"sources":["../src/config.ts"],"mappings":";;cAKa;;;;;;cA2EA,uBAAqB,EAAA,mBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;KAKtB,kBAAkB,EAAE,cAAc;KAClC,uBAAuB,EAAE,aAAa"}

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+import { i as OvermuxPiConfigSchema, n as OvermuxPiConfig, r as OvermuxPiConfigInput, t as DEFAULT_OVERMUX_PI_CONFIG } from "./config-2jNv4tol.js";
+export { DEFAULT_OVERMUX_PI_CONFIG, OvermuxPiConfig, OvermuxPiConfigInput, OvermuxPiConfigSchema };

package/dist/config.js

@@ -0,0 +1,47 @@
+import { isAbsolute } from "node:path";
+import { templatedString } from "@richardgill/pi-config";
+import { z } from "zod";
+//#region src/config.ts
+const DEFAULT_OVERMUX_PI_CONFIG = {
+	inspectionCommand: [
+		"pi-jq",
+		"{{childSessionId}}",
+		"--messages",
+		"3",
+		"--role",
+		"assistant"
+	],
+	inspectionTimeoutMs: 5e3,
+	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(6e4);
+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
+}));
+const OvermuxPiConfigSchema = z.union([ConfigSchema, DefaultConfigSchema]);
+//#endregion
+export { DEFAULT_OVERMUX_PI_CONFIG, OvermuxPiConfigSchema };
+
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { isAbsolute } from \"node:path\";\n\nimport { templatedString } from \"@richardgill/pi-config\";\nimport { z } from \"zod\";\n\nexport const DEFAULT_OVERMUX_PI_CONFIG = {\n  inspectionCommand: [\n    \"pi-jq\",\n    \"{{childSessionId}}\",\n    \"--messages\",\n    \"3\",\n    \"--role\",\n    \"assistant\",\n  ],\n  inspectionTimeoutMs: 5000,\n  supervisionPrompt: \"Continue supervision.\",\n  liveEventsDir: null,\n};\n\nconst InspectionArgumentSchema = templatedString({\n  variables: [\"childSessionId\"],\n  missing: \"keep\",\n});\n\nconst InspectionCommandSchema = z\n  .array(InspectionArgumentSchema)\n  .min(1)\n  .refine(\n    (command) =>\n      command.reduce(\n        (count, argument) =>\n          count + argument.split(\"{{childSessionId}}\").length - 1,\n        0,\n      ) === 1,\n    \"must contain exactly one {{childSessionId}} placeholder\",\n  );\n\nconst InspectionTimeoutSchema = z.number().int().positive().max(60_000);\nconst SupervisionPromptSchema = z.string();\nconst LiveEventsDirSchema = z\n  .string()\n  .trim()\n  .min(1)\n  .refine(isAbsolute, \"must be an absolute path\")\n  .nullable();\n\nconst ConfigSchema = z\n  .object({\n    inspectionCommand: InspectionCommandSchema,\n    inspectionTimeoutMs: InspectionTimeoutSchema.default(\n      DEFAULT_OVERMUX_PI_CONFIG.inspectionTimeoutMs,\n    ),\n    supervisionPrompt: SupervisionPromptSchema.default(\n      DEFAULT_OVERMUX_PI_CONFIG.supervisionPrompt,\n    ),\n    liveEventsDir: LiveEventsDirSchema.default(\n      DEFAULT_OVERMUX_PI_CONFIG.liveEventsDir,\n    ),\n  })\n  .strict();\n\nconst DefaultConfigSchema = z\n  .object({\n    inspectionCommand: z.undefined().optional(),\n    inspectionTimeoutMs: InspectionTimeoutSchema.optional(),\n    supervisionPrompt: SupervisionPromptSchema.optional(),\n    liveEventsDir: LiveEventsDirSchema.optional(),\n  })\n  .strict()\n  .transform((config) => ({\n    inspectionCommand: [...DEFAULT_OVERMUX_PI_CONFIG.inspectionCommand],\n    inspectionTimeoutMs:\n      config.inspectionTimeoutMs ??\n      DEFAULT_OVERMUX_PI_CONFIG.inspectionTimeoutMs,\n    supervisionPrompt:\n      config.supervisionPrompt ?? DEFAULT_OVERMUX_PI_CONFIG.supervisionPrompt,\n    liveEventsDir:\n      config.liveEventsDir ?? DEFAULT_OVERMUX_PI_CONFIG.liveEventsDir,\n  }));\n\nexport const OvermuxPiConfigSchema = z.union([\n  ConfigSchema,\n  DefaultConfigSchema,\n]);\n\nexport type OvermuxPiConfig = z.output<typeof OvermuxPiConfigSchema>;\nexport type OvermuxPiConfigInput = z.input<typeof OvermuxPiConfigSchema>;\n"],"mappings":";;;;AAKA,MAAa,4BAA4B;CACvC,mBAAmB;EACjB;EACA;EACA;EACA;EACA;EACA;CACF;CACA,qBAAqB;CACrB,mBAAmB;CACnB,eAAe;AACjB;AAEA,MAAM,2BAA2B,gBAAgB;CAC/C,WAAW,CAAC,gBAAgB;CAC5B,SAAS;AACX,CAAC;AAED,MAAM,0BAA0B,EAC7B,MAAM,wBAAwB,CAAC,CAC/B,IAAI,CAAC,CAAC,CACN,QACE,YACC,QAAQ,QACL,OAAO,aACN,QAAQ,SAAS,MAAM,oBAAoB,CAAC,CAAC,SAAS,GACxD,CACF,MAAM,GACR,yDACF;AAEF,MAAM,0BAA0B,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,GAAM;AACtE,MAAM,0BAA0B,EAAE,OAAO;AACzC,MAAM,sBAAsB,EACzB,OAAO,CAAC,CACR,KAAK,CAAC,CACN,IAAI,CAAC,CAAC,CACN,OAAO,YAAY,0BAA0B,CAAC,CAC9C,SAAS;AAEZ,MAAM,eAAe,EAClB,OAAO;CACN,mBAAmB;CACnB,qBAAqB,wBAAwB,QAC3C,0BAA0B,mBAC5B;CACA,mBAAmB,wBAAwB,QACzC,0BAA0B,iBAC5B;CACA,eAAe,oBAAoB,QACjC,0BAA0B,aAC5B;AACF,CAAC,CAAC,CACD,OAAO;AAEV,MAAM,sBAAsB,EACzB,OAAO;CACN,mBAAmB,EAAE,UAAU,CAAC,CAAC,SAAS;CAC1C,qBAAqB,wBAAwB,SAAS;CACtD,mBAAmB,wBAAwB,SAAS;CACpD,eAAe,oBAAoB,SAAS;AAC9C,CAAC,CAAC,CACD,OAAO,CAAC,CACR,WAAW,YAAY;CACtB,mBAAmB,CAAC,GAAG,0BAA0B,iBAAiB;CAClE,qBACE,OAAO,uBACP,0BAA0B;CAC5B,mBACE,OAAO,qBAAqB,0BAA0B;CACxD,eACE,OAAO,iBAAiB,0BAA0B;AACtD,EAAE;AAEJ,MAAa,wBAAwB,EAAE,MAAM,CAC3C,cACA,mBACF,CAAC"}

package/dist/extension.d.ts

@@ -0,0 +1,19 @@
+import { r as OvermuxPiConfigInput } from "./config-2jNv4tol.js";
+import { A as probePiSession, E as parseEnvelope, F as sendUserMessage, I as socketPathForSession, L as startReceiver, M as sendEnvelope, S as UserMessageResponse, b as UserMessageInput, c as ProbeOptions, d as SenderOptions, i as CHILD_ENV, k as parseUserMessageRequest, l as Receiver, o as DelegateSettledEnvelope, s as PARENT_SESSION_ENV, u as ReceiverOptions, v as TASK_SLUG_ENV, w as eventKey, x as UserMessageRequest } from "./protocol-CsrnSPOv.js";
+import { n as OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE, o as truncatePiJqOutput } from "./notification-DzOd9cRc.js";
+import { d as piSessionStatusSchema, i as PiSessionStatusWriter, l as parsePiSessionStatus, o as createPiSessionStatusWriter, r as PiSessionStatusUpdate, s as isLocalPidAlive, t as PiSessionStatus, u as piSessionStatusPath } from "./session-status-CZLTo8Km.js";
+import { a as LiveEventWireRecord, c as compactAssistantMessageEvent, d as liveEventStreamPath, f as parseLiveEventRecord, i as LiveEventRecord, l as createLiveEventWriter, n as LiveEventEnvelope, o as LiveEventWriter, r as LiveEventPayload, s as PROCESS_INSTANCE_ID, t as CompactAssistantMessageEvent, u as liveEventSessionDir } from "./live-events-DAmf6RRx.js";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/extension.d.ts
+declare const OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE = "overmux-pi.delegate-settled-receipt";
+type OvermuxPiOptions = OvermuxPiConfigInput & {
+  env?: NodeJS.ProcessEnv;
+  runtimeDir?: string;
+  ackTimeoutMs?: number;
+  retryDelaysMs?: readonly number[];
+  onLiveEventError?: (error: unknown) => void;
+};
+declare const overmuxPi: (pi: ExtensionAPI, options?: OvermuxPiOptions) => void;
+//#endregion
+export { CHILD_ENV, type CompactAssistantMessageEvent, type DelegateSettledEnvelope, type LiveEventEnvelope, type LiveEventPayload, type LiveEventRecord, type LiveEventWireRecord, type LiveEventWriter, OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE, OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE, OvermuxPiOptions, PARENT_SESSION_ENV, PROCESS_INSTANCE_ID, type PiSessionStatus, type PiSessionStatusUpdate, type PiSessionStatusWriter, type ProbeOptions, type Receiver, type ReceiverOptions, type SenderOptions, TASK_SLUG_ENV, type UserMessageInput, type UserMessageRequest, type UserMessageResponse, compactAssistantMessageEvent, createLiveEventWriter, createPiSessionStatusWriter, eventKey, isLocalPidAlive, liveEventSessionDir, liveEventStreamPath, overmuxPi, parseEnvelope, parseLiveEventRecord, parsePiSessionStatus, parseUserMessageRequest, piSessionStatusPath, piSessionStatusSchema, probePiSession, sendEnvelope, sendUserMessage, socketPathForSession, startReceiver, truncatePiJqOutput };
+//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","names":[],"sources":["../src/extension.ts"],"mappings":";;;;;;;cAyGa;KAGD,mBAAmB;EAC7B,MAAM,OAAO;EACb;EACA;EACA;EACA,oBAAoB;;cAwFT,YACX,IAAI,cACJ,UAAS"}

package/dist/extension.js

@@ -0,0 +1,265 @@
+import { CHILD_ENV, DEFAULT_OVERMUX_PI_RUNTIME_DIR, PARENT_SESSION_ENV, TASK_SLUG_ENV, TASK_SLUG_PATTERN, ensureRuntimeDir, eventKey, parseEnvelope, parseUserMessageRequest, probePiSession, sendEnvelope, sendUserMessage, socketPathForSession, startReceiver } from "./protocol.js";
+import { OvermuxPiConfigSchema } from "./config.js";
+import { a as liveEventStreamPath, f as parsePiSessionStatus, i as liveEventSessionDir, l as createPiSessionStatusWriter, m as piSessionStatusSchema, n as compactAssistantMessageEvent, o as parseLiveEventRecord, p as piSessionStatusPath, r as createLiveEventWriter, s as registerLiveEventCapture, t as PROCESS_INSTANCE_ID, u as isLocalPidAlive } from "./live-events-ClhFOMGW.js";
+import { OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE, inspectDelegate, notificationMessage, notificationRenderer, truncatePiJqOutput } from "./notification.js";
+//#region src/extension.ts
+const OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE = "overmux-pi.delegate-settled-receipt";
+const notificationEnvelope = (details) => {
+	if (typeof details !== "object" || details === null) return;
+	const value = details;
+	return parseEnvelope(JSON.stringify({
+		childSessionId: value.childSessionId,
+		taskSlug: value.taskSlug,
+		leafId: value.leafId,
+		cwd: value.cwd,
+		timestamp: value.timestamp
+	}));
+};
+const restoreReceipts = (ctx) => {
+	const receipts = /* @__PURE__ */ new Map();
+	const delivered = /* @__PURE__ */ new Set();
+	ctx.sessionManager.getEntries().forEach((entry) => {
+		if (entry.type === "custom" && entry.customType === "overmux-pi.delegate-settled-receipt") {
+			const envelope = parseEnvelope(JSON.stringify(entry.data));
+			if (envelope) receipts.set(eventKey(envelope), envelope);
+		}
+		if (entry.type === "custom_message" && entry.customType === "overmux-pi.delegate-settled") {
+			const envelope = notificationEnvelope(entry.details);
+			if (envelope) delivered.add(eventKey(envelope));
+		}
+	});
+	return {
+		eventKeys: new Set(receipts.keys()),
+		pending: [...receipts.values()].filter((envelope) => !delivered.has(eventKey(envelope)))
+	};
+};
+const requiredTaskSlug = (taskSlug) => {
+	if (!taskSlug || !TASK_SLUG_PATTERN.test(taskSlug)) throw new Error(`Child Pi requires a valid ${TASK_SLUG_ENV}`);
+	return taskSlug;
+};
+const rememberResponse = (responses, response) => {
+	responses.set(response.requestId, response);
+	if (responses.size > 128) responses.delete(responses.keys().next().value);
+	return response;
+};
+const injectNotification = async (pi, ctx, envelope, signal, config) => {
+	if (signal.aborted) return;
+	const details = await inspectDelegate(pi, envelope, signal, config);
+	if (signal.aborted) return;
+	pi.sendMessage(notificationMessage(envelope, details, config), ctx.isIdle() ? { triggerTurn: true } : { deliverAs: "steer" });
+};
+const overmuxPi = (pi, options = {}) => {
+	pi.registerMessageRenderer(OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE, notificationRenderer);
+	const { inspectionCommand, inspectionTimeoutMs, supervisionPrompt, liveEventsDir } = options;
+	const config = OvermuxPiConfigSchema.parse({
+		inspectionCommand,
+		inspectionTimeoutMs,
+		supervisionPrompt,
+		liveEventsDir
+	});
+	const env = options.env ?? process.env;
+	const isChild = env[CHILD_ENV] === "1";
+	const parentSessionId = isChild ? env[PARENT_SESSION_ENV] : void 0;
+	const childTaskSlug = isChild ? requiredTaskSlug(env[TASK_SLUG_ENV]) : void 0;
+	const runtimeDir = options.runtimeDir ?? DEFAULT_OVERMUX_PI_RUNTIME_DIR;
+	const parentSocket = parentSessionId ? socketPathForSession(parentSessionId, runtimeDir) : void 0;
+	let receiver;
+	let activeSessionId;
+	let sessionController;
+	let eventKeys = /* @__PURE__ */ new Set();
+	let abortResponses = /* @__PURE__ */ new Map();
+	let modelResponses = /* @__PURE__ */ new Map();
+	let thinkingResponses = /* @__PURE__ */ new Map();
+	let userMessageResponses = /* @__PURE__ */ new Map();
+	const liveEvents = registerLiveEventCapture(pi, {
+		rootDir: config.liveEventsDir,
+		env,
+		onError: options.onLiveEventError
+	});
+	pi.on("session_start", async (event, ctx) => {
+		await liveEvents.start(event, ctx);
+		const previousReceiver = receiver;
+		receiver = void 0;
+		sessionController?.abort();
+		const controller = new AbortController();
+		sessionController = controller;
+		abortResponses = /* @__PURE__ */ new Map();
+		modelResponses = /* @__PURE__ */ new Map();
+		thinkingResponses = /* @__PURE__ */ new Map();
+		userMessageResponses = /* @__PURE__ */ new Map();
+		await previousReceiver?.close();
+		const ownSessionId = ctx.sessionManager.getSessionId();
+		activeSessionId = ownSessionId;
+		const restored = restoreReceipts(ctx);
+		eventKeys = restored.eventKeys;
+		await ensureRuntimeDir(runtimeDir);
+		const startedReceiver = await startReceiver(socketPathForSession(ownSessionId, runtimeDir), (envelope) => {
+			if (controller.signal.aborted || sessionController !== controller) return;
+			const key = eventKey(envelope);
+			if (eventKeys.has(key)) return;
+			pi.appendEntry(OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE, envelope);
+			eventKeys.add(key);
+			injectNotification(pi, ctx, envelope, controller.signal, config).catch(() => void 0);
+		}, {
+			onSetModel: async (request) => {
+				const previous = modelResponses.get(request.requestId);
+				if (previous) return previous;
+				if (controller.signal.aborted || sessionController !== controller) return rememberResponse(modelResponses, {
+					version: 1,
+					requestId: request.requestId,
+					ok: false,
+					error: "shutting_down"
+				});
+				const model = ctx.modelRegistry.find(request.provider, request.id);
+				if (!model) return rememberResponse(modelResponses, {
+					version: 1,
+					requestId: request.requestId,
+					ok: false,
+					error: "not_found"
+				});
+				try {
+					if (!await pi.setModel(model)) return rememberResponse(modelResponses, {
+						version: 1,
+						requestId: request.requestId,
+						ok: false,
+						error: "no_key"
+					});
+					return rememberResponse(modelResponses, {
+						version: 1,
+						requestId: request.requestId,
+						ok: true
+					});
+				} catch {
+					return rememberResponse(modelResponses, {
+						version: 1,
+						requestId: request.requestId,
+						ok: false,
+						error: "unavailable"
+					});
+				}
+			},
+			onSetThinkingLevel: (request) => {
+				const previous = thinkingResponses.get(request.requestId);
+				if (previous) return previous;
+				if (controller.signal.aborted || sessionController !== controller) return rememberResponse(thinkingResponses, {
+					version: 1,
+					requestId: request.requestId,
+					ok: false,
+					error: "shutting_down"
+				});
+				try {
+					pi.setThinkingLevel(request.level);
+					return rememberResponse(thinkingResponses, {
+						version: 1,
+						requestId: request.requestId,
+						ok: true
+					});
+				} catch {
+					return rememberResponse(thinkingResponses, {
+						version: 1,
+						requestId: request.requestId,
+						ok: false,
+						error: "unavailable"
+					});
+				}
+			},
+			onAbort: (request) => {
+				const previous = abortResponses.get(request.requestId);
+				if (previous) return previous;
+				if (controller.signal.aborted || sessionController !== controller) return rememberResponse(abortResponses, {
+					version: 1,
+					requestId: request.requestId,
+					ok: false,
+					error: "shutting_down"
+				});
+				if (ctx.isIdle()) return rememberResponse(abortResponses, {
+					version: 1,
+					requestId: request.requestId,
+					ok: false,
+					error: "unavailable"
+				});
+				try {
+					ctx.abort();
+					return rememberResponse(abortResponses, {
+						version: 1,
+						requestId: request.requestId,
+						ok: true
+					});
+				} catch {
+					return rememberResponse(abortResponses, {
+						version: 1,
+						requestId: request.requestId,
+						ok: false,
+						error: "unavailable"
+					});
+				}
+			},
+			onUserMessage: (request) => {
+				const previous = userMessageResponses.get(request.requestId);
+				if (previous) return previous;
+				if (controller.signal.aborted || sessionController !== controller) return rememberResponse(userMessageResponses, {
+					version: 1,
+					requestId: request.requestId,
+					ok: false,
+					error: "shutting_down"
+				});
+				const isIdle = ctx.isIdle();
+				const delivery = isIdle ? "immediate" : request.deliverAs;
+				const userMessageOptions = isIdle ? { expandPromptTemplates: request.expandPromptTemplates } : {
+					deliverAs: request.deliverAs,
+					expandPromptTemplates: request.expandPromptTemplates
+				};
+				try {
+					pi.sendUserMessage(request.message, userMessageOptions);
+					return rememberResponse(userMessageResponses, {
+						version: 1,
+						requestId: request.requestId,
+						ok: true,
+						delivery
+					});
+				} catch {
+					return rememberResponse(userMessageResponses, {
+						version: 1,
+						requestId: request.requestId,
+						ok: false,
+						error: "unavailable"
+					});
+				}
+			}
+		});
+		if (controller.signal.aborted || sessionController !== controller) {
+			await startedReceiver.close();
+			return;
+		}
+		receiver = startedReceiver;
+		await Promise.all(restored.pending.map((envelope) => injectNotification(pi, ctx, envelope, controller.signal, config)));
+	});
+	pi.on("agent_settled", async (_event, ctx) => {
+		const childSessionId = ctx.sessionManager.getSessionId();
+		const leafId = ctx.sessionManager.getLeafId();
+		if (!parentSocket || !leafId || !childTaskSlug) return;
+		await sendEnvelope(parentSocket, {
+			childSessionId,
+			taskSlug: childTaskSlug,
+			leafId,
+			cwd: ctx.cwd,
+			timestamp: Date.now()
+		}, {
+			ackTimeoutMs: options.ackTimeoutMs,
+			retryDelaysMs: options.retryDelaysMs
+		});
+	});
+	pi.on("session_shutdown", async (event, ctx) => {
+		if (ctx.sessionManager.getSessionId() !== activeSessionId) return;
+		const ownedReceiver = receiver;
+		receiver = void 0;
+		activeSessionId = void 0;
+		sessionController?.abort();
+		sessionController = void 0;
+		await Promise.all([ownedReceiver?.close(), liveEvents.stop(event)]);
+	});
+};
+//#endregion
+export { CHILD_ENV, OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE, OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE, PARENT_SESSION_ENV, PROCESS_INSTANCE_ID, TASK_SLUG_ENV, compactAssistantMessageEvent, createLiveEventWriter, createPiSessionStatusWriter, eventKey, isLocalPidAlive, liveEventSessionDir, liveEventStreamPath, overmuxPi, parseEnvelope, parseLiveEventRecord, parsePiSessionStatus, parseUserMessageRequest, piSessionStatusPath, piSessionStatusSchema, probePiSession, sendEnvelope, sendUserMessage, socketPathForSession, startReceiver, truncatePiJqOutput };
+
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","names":[],"sources":["../src/extension.ts"],"sourcesContent":["import type {\n  ExtensionAPI,\n  ExtensionContext,\n} from \"@earendil-works/pi-coding-agent\";\n\nimport {\n  OvermuxPiConfigSchema,\n  type OvermuxPiConfig,\n  type OvermuxPiConfigInput,\n} from \"./config.js\";\nimport {\n  compactAssistantMessageEvent,\n  createLiveEventWriter,\n  liveEventSessionDir,\n  liveEventStreamPath,\n  PROCESS_INSTANCE_ID,\n  registerLiveEventCapture,\n  type CompactAssistantMessageEvent,\n  type LiveEventPayload,\n  type LiveEventRecord,\n  type LiveEventWriter,\n} from \"./live-events.js\";\nimport {\n  inspectDelegate,\n  OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE,\n  notificationMessage,\n  notificationRenderer,\n  type DelegateNotificationDetails,\n} from \"./notification.js\";\nimport {\n  CHILD_ENV,\n  DEFAULT_OVERMUX_PI_RUNTIME_DIR,\n  ensureRuntimeDir,\n  eventKey,\n  PARENT_SESSION_ENV,\n  parseEnvelope,\n  sendEnvelope,\n  sendUserMessage,\n  socketPathForSession,\n  startReceiver,\n  TASK_SLUG_ENV,\n  TASK_SLUG_PATTERN,\n  type AbortRequest,\n  type AbortResponse,\n  type DelegateSettledEnvelope,\n  type SetModelRequest,\n  type SetModelResponse,\n  type SetThinkingLevelRequest,\n  type SetThinkingLevelResponse,\n  type UserMessageRequest,\n  type UserMessageResponse,\n} from \"./protocol.js\";\n\nexport {\n  CHILD_ENV,\n  eventKey,\n  PARENT_SESSION_ENV,\n  TASK_SLUG_ENV,\n} from \"./protocol.js\";\nexport {\n  OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE,\n  truncatePiJqOutput,\n} from \"./notification.js\";\nexport {\n  createPiSessionStatusWriter,\n  isLocalPidAlive,\n  piSessionStatusPath,\n  piSessionStatusSchema,\n  parsePiSessionStatus,\n  type PiSessionStatus,\n  type PiSessionStatusUpdate,\n  type PiSessionStatusWriter,\n} from \"./session-status.js\";\nexport {\n  compactAssistantMessageEvent,\n  createLiveEventWriter,\n  liveEventSessionDir,\n  liveEventStreamPath,\n  parseLiveEventRecord,\n  PROCESS_INSTANCE_ID,\n  type CompactAssistantMessageEvent,\n  type LiveEventEnvelope,\n  type LiveEventPayload,\n  type LiveEventRecord,\n  type LiveEventWireRecord,\n  type LiveEventWriter,\n} from \"./live-events.js\";\nexport {\n  parseEnvelope,\n  probePiSession,\n  sendEnvelope,\n  sendUserMessage,\n  socketPathForSession,\n  startReceiver,\n  parseUserMessageRequest,\n  type DelegateSettledEnvelope,\n  type ProbeOptions,\n  type Receiver,\n  type ReceiverOptions,\n  type SenderOptions,\n  type UserMessageInput,\n  type UserMessageRequest,\n  type UserMessageResponse,\n} from \"./protocol.js\";\n\nexport const OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE =\n  \"overmux-pi.delegate-settled-receipt\";\n\nexport type OvermuxPiOptions = OvermuxPiConfigInput & {\n  env?: NodeJS.ProcessEnv;\n  runtimeDir?: string;\n  ackTimeoutMs?: number;\n  retryDelaysMs?: readonly number[];\n  onLiveEventError?: (error: unknown) => void;\n};\n\nconst notificationEnvelope = (details: unknown) => {\n  if (typeof details !== \"object\" || details === null) {\n    return undefined;\n  }\n  const value = details as Record<string, unknown>;\n  return parseEnvelope(\n    JSON.stringify({\n      childSessionId: value.childSessionId,\n      taskSlug: value.taskSlug,\n      leafId: value.leafId,\n      cwd: value.cwd,\n      timestamp: value.timestamp,\n    }),\n  );\n};\n\nconst restoreReceipts = (ctx: ExtensionContext) => {\n  const receipts = new Map<string, DelegateSettledEnvelope>();\n  const delivered = new Set<string>();\n  ctx.sessionManager.getEntries().forEach((entry) => {\n    if (\n      entry.type === \"custom\" &&\n      entry.customType === OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE\n    ) {\n      const envelope = parseEnvelope(JSON.stringify(entry.data));\n      if (envelope) {\n        receipts.set(eventKey(envelope), envelope);\n      }\n    }\n    if (\n      entry.type === \"custom_message\" &&\n      entry.customType === OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE\n    ) {\n      const envelope = notificationEnvelope(entry.details);\n      if (envelope) {\n        delivered.add(eventKey(envelope));\n      }\n    }\n  });\n  return {\n    eventKeys: new Set(receipts.keys()),\n    pending: [...receipts.values()].filter(\n      (envelope) => !delivered.has(eventKey(envelope)),\n    ),\n  };\n};\n\nconst requiredTaskSlug = (taskSlug: string | undefined): string => {\n  if (!taskSlug || !TASK_SLUG_PATTERN.test(taskSlug)) {\n    throw new Error(`Child Pi requires a valid ${TASK_SLUG_ENV}`);\n  }\n  return taskSlug;\n};\n\nconst rememberResponse = <Response extends { requestId: string }>(\n  responses: Map<string, Response>,\n  response: Response,\n): Response => {\n  responses.set(response.requestId, response);\n  if (responses.size > 128) {\n    responses.delete(responses.keys().next().value!);\n  }\n  return response;\n};\n\nconst injectNotification = async (\n  pi: ExtensionAPI,\n  ctx: ExtensionContext,\n  envelope: DelegateSettledEnvelope,\n  signal: AbortSignal,\n  config: OvermuxPiConfig,\n): Promise<void> => {\n  if (signal.aborted) {\n    return;\n  }\n  const details = await inspectDelegate(pi, envelope, signal, config);\n  if (signal.aborted) {\n    return;\n  }\n  pi.sendMessage(\n    notificationMessage(envelope, details, config),\n    ctx.isIdle() ? { triggerTurn: true } : { deliverAs: \"steer\" },\n  );\n};\n\nexport const overmuxPi = (\n  pi: ExtensionAPI,\n  options: OvermuxPiOptions = {},\n): void => {\n  pi.registerMessageRenderer<DelegateNotificationDetails>(\n    OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE,\n    notificationRenderer,\n  );\n\n  const {\n    inspectionCommand,\n    inspectionTimeoutMs,\n    supervisionPrompt,\n    liveEventsDir,\n  } = options;\n  const config = OvermuxPiConfigSchema.parse({\n    inspectionCommand,\n    inspectionTimeoutMs,\n    supervisionPrompt,\n    liveEventsDir,\n  });\n  const env = options.env ?? process.env;\n  const isChild = env[CHILD_ENV] === \"1\";\n  const parentSessionId = isChild ? env[PARENT_SESSION_ENV] : undefined;\n  const childTaskSlug = isChild\n    ? requiredTaskSlug(env[TASK_SLUG_ENV])\n    : undefined;\n  const runtimeDir = options.runtimeDir ?? DEFAULT_OVERMUX_PI_RUNTIME_DIR;\n  const parentSocket = parentSessionId\n    ? socketPathForSession(parentSessionId, runtimeDir)\n    : undefined;\n  let receiver: Awaited<ReturnType<typeof startReceiver>> | undefined;\n  let activeSessionId: string | undefined;\n  let sessionController: AbortController | undefined;\n  let eventKeys = new Set<string>();\n  let abortResponses = new Map<string, AbortResponse>();\n  let modelResponses = new Map<string, SetModelResponse>();\n  let thinkingResponses = new Map<string, SetThinkingLevelResponse>();\n  let userMessageResponses = new Map<string, UserMessageResponse>();\n  const liveEvents = registerLiveEventCapture(pi, {\n    rootDir: config.liveEventsDir,\n    env,\n    onError: options.onLiveEventError,\n  });\n\n  pi.on(\"session_start\", async (event, ctx) => {\n    await liveEvents.start(event, ctx);\n    const previousReceiver = receiver;\n    receiver = undefined;\n    sessionController?.abort();\n    const controller = new AbortController();\n    sessionController = controller;\n    abortResponses = new Map();\n    modelResponses = new Map();\n    thinkingResponses = new Map();\n    userMessageResponses = new Map();\n    await previousReceiver?.close();\n    const ownSessionId = ctx.sessionManager.getSessionId();\n    activeSessionId = ownSessionId;\n    const restored = restoreReceipts(ctx);\n    eventKeys = restored.eventKeys;\n    await ensureRuntimeDir(runtimeDir);\n    const startedReceiver = await startReceiver(\n      socketPathForSession(ownSessionId, runtimeDir),\n      (envelope) => {\n        if (controller.signal.aborted || sessionController !== controller) {\n          return;\n        }\n        const key = eventKey(envelope);\n        if (eventKeys.has(key)) {\n          return;\n        }\n        pi.appendEntry(OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE, envelope);\n        eventKeys.add(key);\n        void injectNotification(\n          pi,\n          ctx,\n          envelope,\n          controller.signal,\n          config,\n        ).catch(() => undefined);\n      },\n      {\n        onSetModel: async (\n          request: SetModelRequest,\n        ): Promise<SetModelResponse> => {\n          const previous = modelResponses.get(request.requestId);\n          if (previous) {\n            return previous;\n          }\n          if (controller.signal.aborted || sessionController !== controller) {\n            return rememberResponse(modelResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"shutting_down\",\n            });\n          }\n          const model = ctx.modelRegistry.find(request.provider, request.id);\n          if (!model) {\n            return rememberResponse(modelResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"not_found\",\n            });\n          }\n          try {\n            if (!(await pi.setModel(model))) {\n              return rememberResponse(modelResponses, {\n                version: 1,\n                requestId: request.requestId,\n                ok: false,\n                error: \"no_key\",\n              });\n            }\n            return rememberResponse(modelResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: true,\n            });\n          } catch {\n            return rememberResponse(modelResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"unavailable\",\n            });\n          }\n        },\n        onSetThinkingLevel: (\n          request: SetThinkingLevelRequest,\n        ): SetThinkingLevelResponse => {\n          const previous = thinkingResponses.get(request.requestId);\n          if (previous) {\n            return previous;\n          }\n          if (controller.signal.aborted || sessionController !== controller) {\n            return rememberResponse(thinkingResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"shutting_down\",\n            });\n          }\n          try {\n            pi.setThinkingLevel(request.level);\n            return rememberResponse(thinkingResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: true,\n            });\n          } catch {\n            return rememberResponse(thinkingResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"unavailable\",\n            });\n          }\n        },\n        onAbort: (request: AbortRequest): AbortResponse => {\n          const previous = abortResponses.get(request.requestId);\n          if (previous) {\n            return previous;\n          }\n          if (controller.signal.aborted || sessionController !== controller) {\n            return rememberResponse(abortResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"shutting_down\",\n            });\n          }\n          if (ctx.isIdle()) {\n            return rememberResponse(abortResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"unavailable\",\n            });\n          }\n          try {\n            ctx.abort();\n            return rememberResponse(abortResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: true,\n            });\n          } catch {\n            return rememberResponse(abortResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"unavailable\",\n            });\n          }\n        },\n        onUserMessage: (request: UserMessageRequest): UserMessageResponse => {\n          const previous = userMessageResponses.get(request.requestId);\n          if (previous) {\n            return previous;\n          }\n          if (controller.signal.aborted || sessionController !== controller) {\n            return rememberResponse(userMessageResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"shutting_down\",\n            });\n          }\n          const isIdle = ctx.isIdle();\n          const delivery = isIdle ? \"immediate\" : request.deliverAs;\n          const userMessageOptions = isIdle\n            ? { expandPromptTemplates: request.expandPromptTemplates }\n            : {\n                deliverAs: request.deliverAs,\n                expandPromptTemplates: request.expandPromptTemplates,\n              };\n          try {\n            pi.sendUserMessage(request.message, userMessageOptions);\n            return rememberResponse(userMessageResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: true,\n              delivery,\n            });\n          } catch {\n            return rememberResponse(userMessageResponses, {\n              version: 1,\n              requestId: request.requestId,\n              ok: false,\n              error: \"unavailable\",\n            });\n          }\n        },\n      },\n    );\n    if (controller.signal.aborted || sessionController !== controller) {\n      await startedReceiver.close();\n      return;\n    }\n    receiver = startedReceiver;\n    await Promise.all(\n      restored.pending.map((envelope) =>\n        injectNotification(pi, ctx, envelope, controller.signal, config),\n      ),\n    );\n  });\n\n  pi.on(\"agent_settled\", async (_event, ctx) => {\n    const childSessionId = ctx.sessionManager.getSessionId();\n    const leafId = ctx.sessionManager.getLeafId();\n    if (!parentSocket || !leafId || !childTaskSlug) {\n      return;\n    }\n\n    await sendEnvelope(\n      parentSocket,\n      {\n        childSessionId,\n        taskSlug: childTaskSlug,\n        leafId,\n        cwd: ctx.cwd,\n        timestamp: Date.now(),\n      },\n      {\n        ackTimeoutMs: options.ackTimeoutMs,\n        retryDelaysMs: options.retryDelaysMs,\n      },\n    );\n  });\n\n  pi.on(\"session_shutdown\", async (event, ctx) => {\n    if (ctx.sessionManager.getSessionId() !== activeSessionId) {\n      return;\n    }\n    const ownedReceiver = receiver;\n    receiver = undefined;\n    activeSessionId = undefined;\n    sessionController?.abort();\n    sessionController = undefined;\n    await Promise.all([ownedReceiver?.close(), liveEvents.stop(event)]);\n  });\n};\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { A as probePiSession, E as parseEnvelope, F as sendUserMessage, I as socketPathForSession, L as startReceiver, M as sendEnvelope, S as UserMessageResponse, b as UserMessageInput, c as ProbeOptions, d as SenderOptions, i as CHILD_ENV, k as parseUserMessageRequest, l as Receiver, o as DelegateSettledEnvelope, s as PARENT_SESSION_ENV, u as ReceiverOptions, v as TASK_SLUG_ENV, w as eventKey, x as UserMessageRequest } from "./protocol-CsrnSPOv.js";
+import { n as OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE, o as truncatePiJqOutput } from "./notification-DzOd9cRc.js";
+import { d as piSessionStatusSchema, i as PiSessionStatusWriter, l as parsePiSessionStatus, o as createPiSessionStatusWriter, r as PiSessionStatusUpdate, s as isLocalPidAlive, t as PiSessionStatus, u as piSessionStatusPath } from "./session-status-CZLTo8Km.js";
+import { a as LiveEventWireRecord, c as compactAssistantMessageEvent, d as liveEventStreamPath, f as parseLiveEventRecord, i as LiveEventRecord, l as createLiveEventWriter, n as LiveEventEnvelope, o as LiveEventWriter, r as LiveEventPayload, s as PROCESS_INSTANCE_ID, t as CompactAssistantMessageEvent, u as liveEventSessionDir } from "./live-events-DAmf6RRx.js";
+import { OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE, OvermuxPiOptions, overmuxPi } from "./extension.js";
+//#region src/index.d.ts
+declare const _default: (pi: Parameters<typeof overmuxPi>[0]) => void;
+//#endregion
+export { CHILD_ENV, type CompactAssistantMessageEvent, type DelegateSettledEnvelope, type LiveEventEnvelope, type LiveEventPayload, type LiveEventRecord, type LiveEventWireRecord, type LiveEventWriter, OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE, OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE, OvermuxPiOptions, PARENT_SESSION_ENV, PROCESS_INSTANCE_ID, type PiSessionStatus, type PiSessionStatusUpdate, type PiSessionStatusWriter, type ProbeOptions, type Receiver, type ReceiverOptions, type SenderOptions, TASK_SLUG_ENV, type UserMessageInput, type UserMessageRequest, type UserMessageResponse, compactAssistantMessageEvent, createLiveEventWriter, createPiSessionStatusWriter, _default as default, eventKey, isLocalPidAlive, liveEventSessionDir, liveEventStreamPath, overmuxPi, parseEnvelope, parseLiveEventRecord, parsePiSessionStatus, parseUserMessageRequest, piSessionStatusPath, piSessionStatusSchema, probePiSession, sendEnvelope, sendUserMessage, socketPathForSession, startReceiver, truncatePiJqOutput };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;cAYgB,WAAA,IAAI,kBAAkB"}

package/dist/index.js

@@ -0,0 +1,16 @@
+import { CHILD_ENV, PARENT_SESSION_ENV, TASK_SLUG_ENV, eventKey, parseEnvelope, parseUserMessageRequest, probePiSession, sendEnvelope, sendUserMessage, socketPathForSession, startReceiver } from "./protocol.js";
+import { OvermuxPiConfigSchema } from "./config.js";
+import { a as liveEventStreamPath, f as parsePiSessionStatus, i as liveEventSessionDir, l as createPiSessionStatusWriter, m as piSessionStatusSchema, n as compactAssistantMessageEvent, o as parseLiveEventRecord, p as piSessionStatusPath, r as createLiveEventWriter, t as PROCESS_INSTANCE_ID, u as isLocalPidAlive } from "./live-events-ClhFOMGW.js";
+import { OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE, truncatePiJqOutput } from "./notification.js";
+import { OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE, overmuxPi } from "./extension.js";
+import { loadConfigOrDefault } from "@richardgill/pi-config";
+//#region src/index.ts
+const config = loadConfigOrDefault({
+	filename: "overmux-pi.jsonc",
+	schema: OvermuxPiConfigSchema
+});
+var src_default = (pi) => overmuxPi(pi, config);
+//#endregion
+export { CHILD_ENV, OVERMUX_PI_DELEGATE_SETTLED_MESSAGE_TYPE, OVERMUX_PI_DELEGATE_SETTLED_RECEIPT_TYPE, PARENT_SESSION_ENV, PROCESS_INSTANCE_ID, TASK_SLUG_ENV, compactAssistantMessageEvent, createLiveEventWriter, createPiSessionStatusWriter, src_default as default, eventKey, isLocalPidAlive, liveEventSessionDir, liveEventStreamPath, overmuxPi, parseEnvelope, parseLiveEventRecord, parsePiSessionStatus, parseUserMessageRequest, piSessionStatusPath, piSessionStatusSchema, probePiSession, sendEnvelope, sendUserMessage, socketPathForSession, startReceiver, truncatePiJqOutput };
+
+//# sourceMappingURL=index.js.map