@selesai/code 0.9.10 → 0.9.12

package/dist/extensions/pi-intercom/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-intercom",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "license": "MIT",
   "type": "module",
   "main": "index.ts",

package/dist/extensions/pi-intercom/project-agent.ts

@@ -242,7 +242,7 @@ export async function openProjectPane(input: {
   const paneId = extractPaneId(split.data);
   if (!paneId) throw new Error("Herdr project pane error (PANE_GONE): pane split returned no pane id.");
 
-  const command = shellQuote(process.env.PI_INTERCOM_PI_BIN?.trim() || process.env.PI_BIN?.trim() || "pi");
+  const command = shellQuote(process.env.SELESAI_INTERCOM_BINARY?.trim() || process.env.SELESAI_BIN?.trim() || "selesai");
   const started = await client.run(["pane", "run", paneId, command], { timeoutMs: 15_000, signal: input.signal });
   if (started.ok === false) {
     await client.run(["pane", "close", paneId], { timeoutMs: 5_000 });
@@ -292,7 +292,7 @@ export async function waitForProjectSession(client: ListSessionsClient, input: {
     await sleep(pollMs, input.signal);
   }
 
-  throw new Error(`Timed out waiting for a Pi intercom session to register in ${input.projectRoot}. The Herdr pane may still be starting, or pi-intercom may not be loaded there.`);
+  throw new Error(`Timed out waiting for a Selesai intercom session to register in ${input.projectRoot}. The Herdr pane may still be starting, or  pi-intercom may not be loaded there.`);
 }
 
 function formatSessionRefs(sessions: SessionInfo[]): string {

package/dist/extensions/pi-intercom/skills/pi-intercom/SKILL.md

@@ -10,7 +10,7 @@ description: |
 # Selesai Intercom Skill
 
 Use this skill when you need to coordinate work across multiple Selesai sessions
-running on the same machine. pi-intercom enables direct 1:1 messaging between
+running on the same machine. Selesai-intercom enables direct 1:1 messaging between
 sessions for delegation, context sharing, and collaborative workflows.
 
 When you are supervising `pi-subagents`, delegated child agents can escalate to
@@ -238,99 +238,14 @@ new visible project panes should go through the supervisor.
 | `list` | Returns all sessions with live status | You need to discover targets or choose an idle peer |
 | `status` | Returns your connection state | Troubleshooting |
 
-## Optional: Visible Peer Sessions via cmux or tmux
+## Visible Peer Sessions
 
-If no suitable intercom-connected peer session already exists and the task benefits from a long-lived visible conversation, you may spawn a new `pi` session.
+For bounded cross-codebase work, prefer `pi-subagents` with an explicit `cwd`.
+Use `intercom({ action: "send", cwd: "/path", openProjectPaneIfMissing: true, ... })`
+only when a long-lived visible peer session is useful.
 
-Prefer `cmux new-split right` over new surfaces or workspaces so both sessions are visible side by side.
-
-If `cmux` is unavailable, `tmux` is an optional fallback when it is installed and relevant. Use it with a private socket so the session is isolated and observable.
-
-Use spawned peer sessions only for:
-- same-codebase worker/planner splits
-- reference-codebase scouting
-- long-lived visible conversations where the user benefits from watching both sides
-
-Do not use this for unrelated repos, trivial questions, or work you can finish cleanly in the current session.
-
-### Preferred: cmux Worker or Scout Session
-
-Same codebase:
-
-```bash
-cmux new-split right
-sleep 0.5
-cmux send --surface right 'cd /path/to/current/repo && pi\n'
-```
-
-Reference codebase:
-
-```bash
-cmux new-split right
-sleep 0.5
-cmux send --surface right 'cd /path/to/reference/repo && pi\n'
-```
-
-### Optional Fallback: tmux Worker or Scout Session
-
-Same codebase:
-
-```bash
-SOCKET_DIR=${TMPDIR:-/tmp}/pi-tmux-sockets
-mkdir -p "$SOCKET_DIR"
-SOCKET="$SOCKET_DIR/pi.sock"
-SESSION=pi-worker
-tmux -S "$SOCKET" new -d -s "$SESSION" -c "/path/to/current/repo" 'pi'
-```
-
-Reference codebase:
-
-```bash
-SOCKET_DIR=${TMPDIR:-/tmp}/pi-tmux-sockets
-mkdir -p "$SOCKET_DIR"
-SOCKET="$SOCKET_DIR/pi.sock"
-SESSION=pi-reference-auth
-tmux -S "$SOCKET" new -d -s "$SESSION" -c "/path/to/reference/repo" 'pi'
-```
-
-When you use `tmux`, tell the user how to watch it:
-
-```bash
-tmux -S "$SOCKET" attach -t "$SESSION"
-```
-
-After launch, name the new session clearly so it is easy to target:
-
-```text
-/name worker
-/name reference-auth
-```
-
-Then coordinate from the current session:
-
-```typescript
-intercom({
-  action: "send",
-  to: "worker",
-  message: "Take task X. Ask if blocked."
-})
-
-intercom({
-  action: "ask",
-  to: "reference-auth",
-  message: "How does this repo structure token refresh retries?"
-})
-```
-
-### Spawn Decision Rule
-
-Spawn a visible peer session only when all of these are true:
-- no existing intercom-connected session already fits the need
-- the work benefits from a long-lived visible peer session
-- the peer session is either in the same codebase or in an intentional reference codebase
-- `cmux` is available, or `tmux` is available as an intentional fallback
-
-If neither `cmux` nor `tmux` is available, skip this path and use normal `intercom` workflows.
+If Herdr is unavailable, do not invent a terminal fallback inside this workflow.
+Ask the user before opening another visible surface manually.
 
 ## Important Constraints
 
@@ -387,23 +302,6 @@ intercom({
 // Continue immediately, don't wait
 ```
 
-### Include reply hints in messages
-
-Make it easy for recipients to respond. Busy recipients receive your message
-through Selesai's steering queue at the next safe model boundary without aborting
-their active turn, so a reply hint keeps the conversation actionable:
-
-```typescript
-// GOOD: Recipient sees exact command to reply
-intercom({
-  action: "send",
-  to: "worker",
-  message: `Found the issue in auth.ts:142. Use getUserById() instead of getUser().
-
-Reply with: intercom({ action: "reply", message: "..." })`
-});
-```
-
 ### Name sessions meaningfully
 
 Use `/name` so others can target you easily:
@@ -472,7 +370,7 @@ if (!result.delivered) {
 
 ### Connection lost
 
-Sessions automatically reconnect if the broker restarts. A liveness heartbeat round-trips a lightweight request and tears down half-open sockets (for example after the broker is killed without a clean shutdown), so the `disconnected` → reconnect path fires within a bounded window. If persistently disconnected:
+Sessions automatically reconnect if the broker restarts. If persistently disconnected:
 
 ```typescript
 intercom({ action: "status" })

package/dist/extensions/pi-intercom/test/overlay-width.test.ts

@@ -1,66 +1,66 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-
-import { visibleWidth } from "@earendil-works/pi-tui";
-import { ComposeOverlay } from "../ui/compose.ts";
-import { SessionListOverlay } from "../ui/session-list.ts";
-import type { SessionInfo } from "../types.ts";
-
-const theme = {
-  fg(_name: string, text: string): string {
-    return text;
-  },
-  bold(text: string): string {
-    return text;
-  },
-};
-
-const keybindings = {
-  matches(): boolean {
-    return false;
-  },
-  getKeys(id: string): string[] {
-    return id.includes("confirm") ? ["enter"] : ["escape", "ctrl+c"];
-  },
-};
-
-const session: SessionInfo = {
-  id: "session-12345678",
-  name: "subagent-chat-019ecaf6",
-  cwd: "/Users/envvar/.config/ghostty",
-  model: "bsy-deepseek-v4-pro",
-  pid: 1,
-  startedAt: 0,
-  lastActivity: 0,
-};
-
-function assertLineWidths(label: string, lines: string[], expectedWidth: number): void {
-  assert.ok(lines.length > 0, `${label} should render lines`);
-  for (const [index, line] of lines.entries()) {
-    assert.equal(visibleWidth(line), expectedWidth, `${label} line ${index} should match overlay width`);
-  }
-}
-
-test("compose overlay renders lines at the declared overlay width", () => {
-  const overlay = new ComposeOverlay(
-    { requestRender() {} } as any,
-    theme as any,
-    keybindings as any,
-    session,
-    "subagent-chat-019ecaf6",
-    { send: async () => ({ delivered: true, id: "message-1" }) } as any,
-    () => {},
-  );
-
-  for (const width of [1, 2, 20, 40, 72]) {
-    assertLineWidths("compose overlay", overlay.render(width), width);
-  }
-});
-
-test("session list overlay renders lines at the declared overlay width", () => {
-  const overlay = new SessionListOverlay(theme as any, keybindings as any, session, [session], () => {});
-
-  for (const width of [1, 2, 20, 50, 88]) {
-    assertLineWidths("session list overlay", overlay.render(width), width);
-  }
-});
+import test from "node:test";
+import assert from "node:assert/strict";
+
+import { visibleWidth } from "@earendil-works/pi-tui";
+import { ComposeOverlay } from "../ui/compose.ts";
+import { SessionListOverlay } from "../ui/session-list.ts";
+import type { SessionInfo } from "../types.ts";
+
+const theme = {
+  fg(_name: string, text: string): string {
+    return text;
+  },
+  bold(text: string): string {
+    return text;
+  },
+};
+
+const keybindings = {
+  matches(): boolean {
+    return false;
+  },
+  getKeys(id: string): string[] {
+    return id.includes("confirm") ? ["enter"] : ["escape", "ctrl+c"];
+  },
+};
+
+const session: SessionInfo = {
+  id: "session-12345678",
+  name: "subagent-chat-019ecaf6",
+  cwd: "/Users/envvar/.config/ghostty",
+  model: "bsy-deepseek-v4-pro",
+  pid: 1,
+  startedAt: 0,
+  lastActivity: 0,
+};
+
+function assertLineWidths(label: string, lines: string[], expectedWidth: number): void {
+  assert.ok(lines.length > 0, `${label} should render lines`);
+  for (const [index, line] of lines.entries()) {
+    assert.equal(visibleWidth(line), expectedWidth, `${label} line ${index} should match overlay width`);
+  }
+}
+
+test("compose overlay renders lines at the declared overlay width", () => {
+  const overlay = new ComposeOverlay(
+    { requestRender() {} } as any,
+    theme as any,
+    keybindings as any,
+    session,
+    "subagent-chat-019ecaf6",
+    { send: async () => ({ delivered: true, id: "message-1" }) } as any,
+    () => {},
+  );
+
+  for (const width of [1, 2, 20, 40, 72]) {
+    assertLineWidths("compose overlay", overlay.render(width), width);
+  }
+});
+
+test("session list overlay renders lines at the declared overlay width", () => {
+  const overlay = new SessionListOverlay(theme as any, keybindings as any, session, [session], () => {});
+
+  for (const width of [1, 2, 20, 50, 88]) {
+    assertLineWidths("session list overlay", overlay.render(width), width);
+  }
+});

package/dist/extensions/pi-intercom/types.ts

@@ -1,7 +1,19 @@
 export const EXTENSION_BUS_FEATURE = "extension-bus-v1";
+export const EXACT_SEND_FEATURE = "exact-send-v1";
+
+export type DeliveryState = "socket_delivered" | "queued" | "failed" | "unknown";
+
+export interface DeliveryDetails {
+  delivery: DeliveryState;
+  code?: string;
+  retryable: boolean;
+  outcomeKnown: boolean;
+}
 
 export interface SessionInfo {
   id: string;
+  /** Broker-owned lifetime of this live endpoint. */
+  endpointEpoch?: string;
   name?: string;
   /** True only when the extension synthesized name for an unnamed runtime. */
   runtimeFallbackAlias?: boolean;
@@ -21,6 +33,13 @@ export interface SessionInfo {
   contextPct?: number;
   contextTokens?: number;
   contextWindow?: number;
+  /** tmux pane id (e.g. "%212") of the session's terminal, read from
+   *  $TMUX_PANE at registration. Present only when the session runs inside a
+   *  tmux pane; absent for cloud, headless, IDE-embedded, or Herdr sessions.
+   *  The pane id is immutable for the process lifetime — unlike the window
+   *  name, which is mutable — so a peer can live-resolve the current window
+   *  from it via tmux when it needs to introspect or drive that pane. */
+  tmuxPane?: string;
 }
 
 export interface Message {
@@ -35,12 +54,20 @@ export interface Message {
   retryOf?: string;
   replyTo?: string;
   expectsReply?: boolean;
+  provenance?: MessageProvenance;
   content: {
     text: string;
     attachments?: Attachment[];
   };
 }
 
+export interface MessageProvenance {
+  type: "extension_outbox";
+  extensionId: string;
+  extensionName: string;
+  requestId: string;
+}
+
 export interface Attachment {
   type: "file" | "snippet" | "context";
   name: string;
@@ -72,16 +99,16 @@ export interface ExtensionCapability {
   ownerEligible: boolean;
 }
 
-export type SessionRegistration = Omit<SessionInfo, "id" | "peerUid" | "trustedLocal"> & {
+export type SessionRegistration = Omit<SessionInfo, "id" | "endpointEpoch" | "peerUid" | "trustedLocal"> & {
   extensions?: ExtensionCapability[];
 };
 
 export type ClientMessage =
-  | { type: "register"; session: SessionRegistration; sessionId?: string; stateId?: string }
+  | { type: "register"; session: SessionRegistration; sessionId?: string; stateId?: string; scopeId?: string }
   | { type: "unregister" }
   | { type: "extension_capabilities_update"; extensions: ExtensionCapability[] }
   | { type: "list"; requestId: string }
-  | { type: "send"; to: string; message: Message }
+  | { type: "send"; to: string; message: Message; targetId?: string; targetEpoch?: string }
   | { type: "message_receipt"; receipt: MessageReceipt }
   | { type: "cancel_message"; messageId: string }
   | { type: "cancel_ask"; messageId: string }
@@ -110,8 +137,8 @@ export type BrokerMessage =
   | { type: "session_joined"; session: SessionInfo }
   | { type: "session_left"; sessionId: string }
   | { type: "error"; error: string }
-  | { type: "delivered"; messageId: string }
-  | { type: "delivery_failed"; messageId: string; reason: string }
+  | ({ type: "delivered"; messageId: string } & DeliveryDetails)
+  | ({ type: "delivery_failed"; messageId: string; reason: string } & DeliveryDetails)
   | { type: "message_receipt"; from: SessionInfo; receipt: MessageReceipt }
   | { type: "message_control"; from: SessionInfo; control: MessageControl }
   | { type: "extension_owner"; namespace: string; ownerId?: string; ownerEpoch?: string }

package/dist/extensions/pi-intercom/ui/compose.ts

@@ -1,143 +1,143 @@
-import type { Component, TUI } from "@earendil-works/pi-tui";
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import type { KeybindingsManager, Theme } from "@selesai/code";
-import type { IntercomClient } from "../broker/client.ts";
-import type { SessionInfo } from "../types.ts";
-
-export interface ComposeResult {
-  sent: boolean;
-  messageId?: string;
-  text?: string;
-}
-
-export class ComposeOverlay implements Component {
-  private tui: TUI;
-  private theme: Theme;
-  private keybindings: KeybindingsManager;
-  private target: SessionInfo;
-  private targetLabel: string;
-  private client: IntercomClient;
-  private done: (result: ComposeResult) => void;
-  private inputBuffer: string = "";
-  private sending: boolean = false;
-  private error: string | null = null;
-
-  constructor(
-    tui: TUI,
-    theme: Theme,
-    keybindings: KeybindingsManager,
-    target: SessionInfo,
-    targetLabel: string,
-    client: IntercomClient,
-    done: (result: ComposeResult) => void,
-  ) {
-    this.tui = tui;
-    this.theme = theme;
-    this.keybindings = keybindings;
-    this.target = target;
-    this.targetLabel = targetLabel;
-    this.client = client;
-    this.done = done;
-  }
-
-  invalidate(): void {}
-
-  handleInput(data: string): void {
-    if (this.sending) return;
-    if (this.keybindings.matches(data, "tui.select.cancel")) {
-      this.done({ sent: false });
-      return;
-    }
-
-    if (data.startsWith("\x1b")) {
-      return;
-    }
-
-    if (this.keybindings.matches(data, "tui.select.confirm")) {
-      if (this.inputBuffer.trim()) {
-        this.sendMessage();
-      }
-      return;
-    }
-
-    if (this.keybindings.matches(data, "tui.editor.deleteCharBackward")) {
-      this.inputBuffer = [...this.inputBuffer].slice(0, -1).join("");
-      this.tui.requestRender();
-      return;
-    }
-
-    const printable = [...data].filter(c => c >= " ").join("");
-    if (printable) {
-      this.inputBuffer += printable;
-      this.tui.requestRender();
-    }
-  }
-
-  private async sendMessage(): Promise<void> {
-    this.sending = true;
-    this.error = null;
-    this.tui.requestRender();
-
-    try {
-      const result = await this.client.send(this.target.id, {
-        text: this.inputBuffer.trim(),
-      });
-      
-      if (!result.delivered) {
-        this.error = result.reason ?? "Message not delivered. Session may not exist or has disconnected.";
-        this.sending = false;
-        this.tui.requestRender();
-        return;
-      }
-      
-      this.done({
-        sent: true,
-        messageId: result.id,
-        text: this.inputBuffer.trim(),
-      });
-    } catch (error) {
-      this.error = error instanceof Error ? error.message : String(error);
-      this.sending = false;
-      this.tui.requestRender();
-    }
-  }
-
-  render(width: number): string[] {
-    const innerWidth = Math.max(1, Math.min(width, 72));
-    if (innerWidth === 1) {
-      return [this.theme.fg("accent", "│")];
-    }
-
-    const contentWidth = Math.max(0, innerWidth - 2);
-    const footer = `${this.keybindings.getKeys("tui.select.confirm").join("/")}: Send • ${this.keybindings.getKeys("tui.select.cancel").join("/")}: Close`;
-    const border = (text: string) => this.theme.fg("accent", text);
-    const row = (text = "") => {
-      const clipped = truncateToWidth(text, contentWidth, "", true);
-      return `${border("│")}${clipped}${" ".repeat(Math.max(0, contentWidth - visibleWidth(clipped)))}${border("│")}`;
-    };
-
-    const lines: string[] = [];
-    lines.push(border(`╭${"─".repeat(contentWidth)}╮`));
-    lines.push(row(this.theme.bold(` Send to: ${this.targetLabel}`)));
-    lines.push(row(this.theme.fg("dim", ` ${this.target.cwd} • ${this.target.model}`)));
-    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
-    lines.push(row());
-
-    if (this.sending) {
-      lines.push(row(this.theme.fg("dim", " Sending...")));
-    } else if (this.error) {
-      lines.push(row(this.theme.fg("error", ` Error: ${this.error}`)));
-      lines.push(row());
-      lines.push(row(` > ${this.inputBuffer}█`));
-    } else {
-      lines.push(row(` > ${this.inputBuffer}█`));
-    }
-
-    lines.push(row());
-    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
-    lines.push(row(this.theme.fg("dim", ` ${footer}`)));
-    lines.push(border(`╰${"─".repeat(contentWidth)}╯`));
-
-    return lines;
-  }
-}
+import type { Component, TUI } from "@earendil-works/pi-tui";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import type { KeybindingsManager, Theme } from "@selesai/code";
+import type { IntercomClient } from "../broker/client.ts";
+import type { SessionInfo } from "../types.ts";
+
+export interface ComposeResult {
+  sent: boolean;
+  messageId?: string;
+  text?: string;
+}
+
+export class ComposeOverlay implements Component {
+  private tui: TUI;
+  private theme: Theme;
+  private keybindings: KeybindingsManager;
+  private target: SessionInfo;
+  private targetLabel: string;
+  private client: IntercomClient;
+  private done: (result: ComposeResult) => void;
+  private inputBuffer: string = "";
+  private sending: boolean = false;
+  private error: string | null = null;
+
+  constructor(
+    tui: TUI,
+    theme: Theme,
+    keybindings: KeybindingsManager,
+    target: SessionInfo,
+    targetLabel: string,
+    client: IntercomClient,
+    done: (result: ComposeResult) => void,
+  ) {
+    this.tui = tui;
+    this.theme = theme;
+    this.keybindings = keybindings;
+    this.target = target;
+    this.targetLabel = targetLabel;
+    this.client = client;
+    this.done = done;
+  }
+
+  invalidate(): void {}
+
+  handleInput(data: string): void {
+    if (this.sending) return;
+    if (this.keybindings.matches(data, "tui.select.cancel")) {
+      this.done({ sent: false });
+      return;
+    }
+
+    if (data.startsWith("\x1b")) {
+      return;
+    }
+
+    if (this.keybindings.matches(data, "tui.select.confirm")) {
+      if (this.inputBuffer.trim()) {
+        this.sendMessage();
+      }
+      return;
+    }
+
+    if (this.keybindings.matches(data, "tui.editor.deleteCharBackward")) {
+      this.inputBuffer = [...this.inputBuffer].slice(0, -1).join("");
+      this.tui.requestRender();
+      return;
+    }
+
+    const printable = [...data].filter(c => c >= " ").join("");
+    if (printable) {
+      this.inputBuffer += printable;
+      this.tui.requestRender();
+    }
+  }
+
+  private async sendMessage(): Promise<void> {
+    this.sending = true;
+    this.error = null;
+    this.tui.requestRender();
+
+    try {
+      const result = await this.client.send(this.target.id, {
+        text: this.inputBuffer.trim(),
+      });
+      
+      if (!result.delivered) {
+        this.error = result.reason ?? "Message not delivered. Session may not exist or has disconnected.";
+        this.sending = false;
+        this.tui.requestRender();
+        return;
+      }
+      
+      this.done({
+        sent: true,
+        messageId: result.id,
+        text: this.inputBuffer.trim(),
+      });
+    } catch (error) {
+      this.error = error instanceof Error ? error.message : String(error);
+      this.sending = false;
+      this.tui.requestRender();
+    }
+  }
+
+  render(width: number): string[] {
+    const innerWidth = Math.max(1, Math.min(width, 72));
+    if (innerWidth === 1) {
+      return [this.theme.fg("accent", "│")];
+    }
+
+    const contentWidth = Math.max(0, innerWidth - 2);
+    const footer = `${this.keybindings.getKeys("tui.select.confirm").join("/")}: Send • ${this.keybindings.getKeys("tui.select.cancel").join("/")}: Close`;
+    const border = (text: string) => this.theme.fg("accent", text);
+    const row = (text = "") => {
+      const clipped = truncateToWidth(text, contentWidth, "", true);
+      return `${border("│")}${clipped}${" ".repeat(Math.max(0, contentWidth - visibleWidth(clipped)))}${border("│")}`;
+    };
+
+    const lines: string[] = [];
+    lines.push(border(`╭${"─".repeat(contentWidth)}╮`));
+    lines.push(row(this.theme.bold(` Send to: ${this.targetLabel}`)));
+    lines.push(row(this.theme.fg("dim", ` ${this.target.cwd} • ${this.target.model}`)));
+    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
+    lines.push(row());
+
+    if (this.sending) {
+      lines.push(row(this.theme.fg("dim", " Sending...")));
+    } else if (this.error) {
+      lines.push(row(this.theme.fg("error", ` Error: ${this.error}`)));
+      lines.push(row());
+      lines.push(row(` > ${this.inputBuffer}█`));
+    } else {
+      lines.push(row(` > ${this.inputBuffer}█`));
+    }
+
+    lines.push(row());
+    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
+    lines.push(row(this.theme.fg("dim", ` ${footer}`)));
+    lines.push(border(`╰${"─".repeat(contentWidth)}╯`));
+
+    return lines;
+  }
+}