remote-pi 0.1.0

package/dist/session/peer.d.ts

@@ -0,0 +1,80 @@
+import { type Envelope } from "./envelope.js";
+/**
+ * Symmetric peer-in-session API. Hides whether you are leader or follower;
+ * `send`, `request`, `onMessage`, `rename`, `leave` all work the same.
+ *
+ * Pending map demuxes parallel `request()` calls by message `id` → `re`.
+ *
+ * Failover: when the leader dies, follower socket emits `close`. Remaining
+ * peers re-run `joinOrLead`. One becomes the new leader; others reconnect.
+ */
+export type MessageHandler = (env: Envelope) => void;
+export type ReconnectHandler = () => void;
+export interface SessionPeerOptions {
+    sockPath: string;
+    name: string;
+    auditPath?: string;
+    /** Per-request default timeout (ms). Override per call if needed. */
+    defaultTimeoutMs?: number;
+}
+export declare class SessionPeer {
+    private readonly opts;
+    /** Name actually assigned by the broker (may differ via #N collision suffix). */
+    private assignedName;
+    private role;
+    private broker;
+    private socket;
+    private buf;
+    /** Map of in-flight request ids → resolver. */
+    private readonly pending;
+    private readonly handlers;
+    private readonly reconnectHandlers;
+    private leftFlag;
+    constructor(opts: SessionPeerOptions);
+    /** Joins or leads the session at `sockPath`. Resolves with the assigned name. */
+    start(): Promise<string>;
+    /** Returns the name as assigned by the broker (after collision suffix). */
+    name(): string;
+    /** Returns "leader" or "follower" — current role. */
+    currentRole(): "leader" | "follower";
+    /**
+     * Fire-and-forget send. Doesn't await a reply.
+     *
+     * `re` (optional) lets the caller correlate this message as a reply to a
+     * previous request — when an LLM peer is *answering* a question from
+     * another agent, it must echo the original `id` here so the requester's
+     * pending map can resolve. Without `re`, the requester treats this as a
+     * new unsolicited message and its `request()` call times out.
+     */
+    send(to: string | string[], body: unknown, re?: string | null): Promise<void>;
+    /**
+     * Send + await reply. Resolves with the first inbound envelope whose `re`
+     * matches the outbound `id`. Rejects on timeout.
+     */
+    request(to: string, body: unknown, timeoutMs?: number): Promise<Envelope>;
+    onMessage(handler: MessageHandler): () => void;
+    /**
+     * Fires after the peer successfully (re)joins following a failover —
+     * leader died and we re-elected. NOT called for the initial `start()`,
+     * only for post-drop reconnects. Consumers use this to re-query state
+     * the broker may have lost in the transition (e.g., peer list).
+     */
+    onReconnect(handler: ReconnectHandler): () => void;
+    /**
+     * Requests a different display name from the broker. Returns the name
+     * actually assigned (may carry a #N suffix on collision). Implemented as
+     * a soft rejoin: leaves & rejoins with the new name.
+     */
+    rename(newName: string): Promise<string>;
+    leave(): Promise<void>;
+    private _joinOrLead;
+    private _registerAsClient;
+    private _wireSocket;
+    private _registerOver;
+    private _preAckListener;
+    private _onData;
+    private _handleLine;
+    private _writeEnvelope;
+    private _onSocketClose;
+    private _teardownConn;
+}

package/dist/session/peer.js

@@ -0,0 +1,268 @@
+import { setTimeout as delay } from "node:timers/promises";
+import { envelope, parse, serialize, EnvelopeError } from "./envelope.js";
+import { joinOrLead } from "./leader_election.js";
+import { Broker } from "./broker.js";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const FAILOVER_RETRY_MS = 100;
+export class SessionPeer {
+    opts;
+    /** Name actually assigned by the broker (may differ via #N collision suffix). */
+    assignedName;
+    role = "follower";
+    broker = null;
+    socket = null;
+    buf = "";
+    /** Map of in-flight request ids → resolver. */
+    pending = new Map();
+    handlers = new Set();
+    reconnectHandlers = new Set();
+    leftFlag = false;
+    constructor(opts) {
+        this.opts = opts;
+        this.assignedName = opts.name;
+    }
+    // ── public API ────────────────────────────────────────────────────────────
+    /** Joins or leads the session at `sockPath`. Resolves with the assigned name. */
+    async start() {
+        return this._joinOrLead();
+    }
+    /** Returns the name as assigned by the broker (after collision suffix). */
+    name() {
+        return this.assignedName;
+    }
+    /** Returns "leader" or "follower" — current role. */
+    currentRole() {
+        return this.role;
+    }
+    /**
+     * Fire-and-forget send. Doesn't await a reply.
+     *
+     * `re` (optional) lets the caller correlate this message as a reply to a
+     * previous request — when an LLM peer is *answering* a question from
+     * another agent, it must echo the original `id` here so the requester's
+     * pending map can resolve. Without `re`, the requester treats this as a
+     * new unsolicited message and its `request()` call times out.
+     */
+    async send(to, body, re = null) {
+        const env = envelope(this.assignedName, to, body, re);
+        await this._writeEnvelope(env);
+    }
+    /**
+     * Send + await reply. Resolves with the first inbound envelope whose `re`
+     * matches the outbound `id`. Rejects on timeout.
+     */
+    async request(to, body, timeoutMs = this.opts.defaultTimeoutMs ?? DEFAULT_TIMEOUT_MS) {
+        const env = envelope(this.assignedName, to, body, null);
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(env.id);
+                reject(new Error(`request to ${to} timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(env.id, { resolve, reject, timer });
+            this._writeEnvelope(env).catch((err) => {
+                const slot = this.pending.get(env.id);
+                if (!slot)
+                    return;
+                clearTimeout(slot.timer);
+                this.pending.delete(env.id);
+                reject(err);
+            });
+        });
+    }
+    onMessage(handler) {
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    /**
+     * Fires after the peer successfully (re)joins following a failover —
+     * leader died and we re-elected. NOT called for the initial `start()`,
+     * only for post-drop reconnects. Consumers use this to re-query state
+     * the broker may have lost in the transition (e.g., peer list).
+     */
+    onReconnect(handler) {
+        this.reconnectHandlers.add(handler);
+        return () => this.reconnectHandlers.delete(handler);
+    }
+    /**
+     * Requests a different display name from the broker. Returns the name
+     * actually assigned (may carry a #N suffix on collision). Implemented as
+     * a soft rejoin: leaves & rejoins with the new name.
+     */
+    async rename(newName) {
+        await this._teardownConn();
+        this.opts.name = newName;
+        this.assignedName = newName;
+        return this._joinOrLead();
+    }
+    async leave() {
+        this.leftFlag = true;
+        await this._teardownConn();
+    }
+    // ── join / failover loop ──────────────────────────────────────────────────
+    async _joinOrLead() {
+        const result = await joinOrLead(this.opts.sockPath);
+        if (result.role === "leader") {
+            this.role = "leader";
+            this.broker = new Broker({
+                server: result.server,
+                auditPath: this.opts.auditPath,
+            });
+            // Leader also registers itself as a peer so other followers see it +
+            // can address it. We create a self-loopback socket via the broker's
+            // internal API: easiest is to open a real client connection back to
+            // our own server.
+            return this._registerAsClient();
+        }
+        else {
+            this.role = "follower";
+            this._wireSocket(result.socket);
+            return this._registerOver(result.socket);
+        }
+    }
+    async _registerAsClient() {
+        const { createConnection } = await import("node:net");
+        const sock = createConnection(this.opts.sockPath);
+        await new Promise((resolve, reject) => {
+            sock.once("connect", () => resolve());
+            sock.once("error", reject);
+        });
+        this._wireSocket(sock);
+        return this._registerOver(sock);
+    }
+    _wireSocket(sock) {
+        this.socket = sock;
+        this.buf = "";
+        sock.setEncoding("utf8");
+        sock.on("data", (chunk) => this._onData(chunk));
+        sock.on("close", () => this._onSocketClose());
+        sock.on("error", () => { });
+    }
+    _registerOver(sock) {
+        return new Promise((resolve, reject) => {
+            // The first inbound line MUST be the register_ack. Buffer-aware.
+            const wait = setTimeout(() => reject(new Error("register_ack timeout")), 5_000);
+            const onceListener = (raw) => {
+                clearTimeout(wait);
+                const ack = raw;
+                if (ack && ack.type === "register_ack" && typeof ack.name_assigned === "string") {
+                    this.assignedName = ack.name_assigned;
+                    this._preAckListener = null;
+                    resolve(ack.name_assigned);
+                }
+                else {
+                    reject(new Error(`expected register_ack, got: ${JSON.stringify(raw)}`));
+                }
+            };
+            this._preAckListener = onceListener;
+            const req = JSON.stringify({ type: "register", name: this.opts.name }) + "\n";
+            try {
+                sock.write(req);
+            }
+            catch (e) {
+                clearTimeout(wait);
+                reject(e);
+            }
+        });
+    }
+    _preAckListener = null;
+    _onData(chunk) {
+        this.buf += chunk;
+        let nl;
+        while ((nl = this.buf.indexOf("\n")) >= 0) {
+            const line = this.buf.slice(0, nl);
+            this.buf = this.buf.slice(nl + 1);
+            if (!line)
+                continue;
+            this._handleLine(line);
+        }
+    }
+    _handleLine(line) {
+        // Before register_ack: parse loosely as an ack control message.
+        if (this._preAckListener) {
+            try {
+                const parsed = JSON.parse(line);
+                this._preAckListener(parsed);
+            }
+            catch {
+                // Garbage during register window — ignore.
+            }
+            return;
+        }
+        // Regular envelope.
+        let env;
+        try {
+            env = parse(line);
+        }
+        catch (e) {
+            if (e instanceof EnvelopeError)
+                return;
+            throw e;
+        }
+        // Correlate replies first.
+        if (env.re) {
+            const slot = this.pending.get(env.re);
+            if (slot) {
+                clearTimeout(slot.timer);
+                this.pending.delete(env.re);
+                slot.resolve(env);
+                return;
+            }
+        }
+        // Otherwise dispatch to subscribers.
+        for (const h of this.handlers) {
+            try {
+                h(env);
+            }
+            catch { /* handler errors don't break peer */ }
+        }
+    }
+    async _writeEnvelope(env) {
+        if (!this.socket || this.socket.destroyed) {
+            throw new Error("session peer not connected");
+        }
+        this.socket.write(serialize(env));
+    }
+    async _onSocketClose() {
+        if (this.leftFlag)
+            return; // intentional leave
+        // Attempt to re-elect once. New leader will bind sockPath; we either
+        // become leader ourselves or rejoin as follower.
+        await delay(FAILOVER_RETRY_MS);
+        if (this.leftFlag)
+            return;
+        try {
+            await this._joinOrLead();
+            // The new broker's peers map starts fresh — consumers must re-query
+            // any cached state (peer count, etc.) that depended on the old broker.
+            for (const h of this.reconnectHandlers) {
+                try {
+                    h();
+                }
+                catch { /* handler errors don't break peer */ }
+            }
+        }
+        catch { /* election failed; peer stuck in disconnected state */ }
+    }
+    async _teardownConn() {
+        if (this.socket) {
+            try {
+                this.socket.destroy();
+            }
+            catch { /* ignored */ }
+            this.socket = null;
+        }
+        if (this.broker) {
+            try {
+                await this.broker.close();
+            }
+            catch { /* ignored */ }
+            this.broker = null;
+        }
+        for (const slot of this.pending.values()) {
+            clearTimeout(slot.timer);
+            slot.reject(new Error("peer leaving"));
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=peer.js.map

package/dist/session/peer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer.js","sourceRoot":"","sources":["../../src/session/peer.ts"],"names":[],"mappings":"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"}

package/dist/session/setup_wizard.d.ts

@@ -0,0 +1,32 @@
+import type { LocalConfig } from "./local_config.js";
+/**
+ * Pi SDK UI surface needed by the wizard. Subset of `ExtensionUIContext` —
+ * declared inline so tests can mock cleanly without dragging the full
+ * ExtensionContext shape.
+ */
+export interface WizardUI {
+    /** Free-text prompt. Returns the entered string, or undefined if cancelled. */
+    input?: (title: string, options?: {
+        defaultValue?: string;
+    }) => Promise<string | undefined>;
+    /** Picker. Returns the picked option, or undefined if cancelled. */
+    select: (title: string, options: string[]) => Promise<string | undefined>;
+    /** Non-blocking notification. Used for inline validation feedback. */
+    notify?: (msg: string, kind: "info" | "warning" | "error") => void;
+}
+export interface WizardDefaults {
+    agent_name: string;
+    session_name: string;
+    auto_start_relay: boolean;
+}
+/**
+ * Runs the 3-question setup wizard. Returns the chosen config on confirm,
+ * or null when the user cancels any prompt.
+ *
+ * Prompts:
+ *   1. Agent name (default: basename of cwd)
+ *   2. Session name (default: basename of cwd)
+ *   3. Auto-start relay? (yes/no) — relay lets the mobile app connect to this Pi
+ *   Final: review + confirm "Save and activate?" yes/no
+ */
+export declare function runSetupWizard(ui: WizardUI, defaults: WizardDefaults): Promise<LocalConfig | null>;

package/dist/session/setup_wizard.js

@@ -0,0 +1,60 @@
+const YES = "Yes";
+const NO = "No";
+const CANCEL_TOKEN = "__cancel__";
+/**
+ * Runs the 3-question setup wizard. Returns the chosen config on confirm,
+ * or null when the user cancels any prompt.
+ *
+ * Prompts:
+ *   1. Agent name (default: basename of cwd)
+ *   2. Session name (default: basename of cwd)
+ *   3. Auto-start relay? (yes/no) — relay lets the mobile app connect to this Pi
+ *   Final: review + confirm "Save and activate?" yes/no
+ */
+export async function runSetupWizard(ui, defaults) {
+    const agent_name = await _askText(ui, "Agent name:", defaults.agent_name);
+    if (agent_name === null)
+        return null;
+    const session_name = await _askText(ui, "Default session:", defaults.session_name);
+    if (session_name === null)
+        return null;
+    ui.notify?.("The relay lets the Remote Pi mobile app connect to this Pi over the network. Enable it to allow the app to send prompts and receive responses; disable for local-only use.", "info");
+    const autoChoice = await ui.select("Auto-start the relay (for mobile app access)?", defaults.auto_start_relay ? [YES, NO] : [NO, YES]);
+    if (!autoChoice)
+        return null;
+    const auto_start_relay = autoChoice === YES;
+    // Review + confirm
+    const summary = [
+        `  Agent name:       ${agent_name}`,
+        `  Default session:  ${session_name}`,
+        `  Auto-start relay: ${auto_start_relay ? YES : NO}`,
+    ].join("\n");
+    ui.notify?.(`Summary:\n${summary}`, "info");
+    const confirm = await ui.select("Save and activate?", [YES, NO]);
+    if (confirm !== YES)
+        return null;
+    return { agent_name, session_name, auto_start_relay };
+}
+/**
+ * Asks the user for free text. Falls back to `select` with the default as the
+ * only option when the SDK doesn't expose `input` (some Pi modes). Re-prompts
+ * once on empty/whitespace input; second blank counts as cancel.
+ */
+async function _askText(ui, title, defaultValue) {
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const raw = ui.input
+            ? await ui.input(title, { defaultValue })
+            : await ui.select(`${title} (default: ${defaultValue})`, [defaultValue, CANCEL_TOKEN]);
+        if (raw === undefined)
+            return null;
+        if (raw === CANCEL_TOKEN)
+            return null;
+        const trimmed = raw.trim();
+        if (trimmed.length > 0)
+            return trimmed;
+        ui.notify?.("Value required — cannot be empty.", "warning");
+    }
+    // 2 blanks in a row → treat as cancel
+    return null;
+}
+//# sourceMappingURL=setup_wizard.js.map

package/dist/session/setup_wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup_wizard.js","sourceRoot":"","sources":["../../src/session/setup_wizard.ts"],"names":[],"mappings":"AAsBA,MAAM,GAAG,GAAG,KAAK,CAAC;AAClB,MAAM,EAAE,GAAG,IAAI,CAAC;AAChB,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAY,EACZ,QAAwB;IAExB,MAAM,UAAU,GAAG,MAAM,QAAQ,CAC/B,EAAE,EACF,aAAa,EACb,QAAQ,CAAC,UAAU,CACpB,CAAC;IACF,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,YAAY,GAAG,MAAM,QAAQ,CACjC,EAAE,EACF,kBAAkB,EAClB,QAAQ,CAAC,YAAY,CACtB,CAAC;IACF,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvC,EAAE,CAAC,MAAM,EAAE,CACT,4KAA4K,EAC5K,MAAM,CACP,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,MAAM,CAChC,+CAA+C,EAC/C,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAClD,CAAC;IACF,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,gBAAgB,GAAG,UAAU,KAAK,GAAG,CAAC;IAE5C,mBAAmB;IACnB,MAAM,OAAO,GAAG;QACd,uBAAuB,UAAU,EAAE;QACnC,uBAAuB,YAAY,EAAE;QACrC,uBAAuB,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;KACrD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,EAAE,CAAC,MAAM,EAAE,CAAC,aAAa,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IACjE,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,QAAQ,CACrB,EAAY,EACZ,KAAa,EACb,YAAoB;IAEpB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK;YAClB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC;YACzC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,cAAc,YAAY,GAAG,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;QACzF,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,GAAG,KAAK,YAAY;YAAE,OAAO,IAAI,CAAC;QACtC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC;QACvC,EAAE,CAAC,MAAM,EAAE,CAAC,mCAAmC,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;IACD,sCAAsC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/session/tool_gate.d.ts

@@ -0,0 +1,5 @@
+/** Tool names that execute automatically without prompting the user. */
+export declare const AUTO_APPROVE_TOOLS: ReadonlySet<string>;
+export type ApprovalDecision = "auto" | "ask";
+/** Returns 'auto' for read-only tools, 'ask' for everything else. */
+export declare function decide(toolName: string): ApprovalDecision;

package/dist/session/tool_gate.js

@@ -0,0 +1,11 @@
+/** Tool names that execute automatically without prompting the user. */
+export const AUTO_APPROVE_TOOLS = new Set([
+    "Read",
+    "Glob",
+    "Grep",
+]);
+/** Returns 'auto' for read-only tools, 'ask' for everything else. */
+export function decide(toolName) {
+    return AUTO_APPROVE_TOOLS.has(toolName) ? "auto" : "ask";
+}
+//# sourceMappingURL=tool_gate.js.map

package/dist/session/tool_gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_gate.js","sourceRoot":"","sources":["../../src/session/tool_gate.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC;IAC7D,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AAIH,qEAAqE;AACrE,MAAM,UAAU,MAAM,CAAC,QAAgB;IACrC,OAAO,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3D,CAAC"}

package/dist/session/tools.d.ts

@@ -0,0 +1,16 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { SessionPeer } from "./peer.js";
+/**
+ * Registers two native tools the Pi LLM can invoke to talk to other agents
+ * in the same UDS session (plano 19 transport):
+ *   - `agent_send`     — fire-and-forget delivery
+ *   - `agent_request`  — request/reply with `re` correlation + timeout
+ *
+ * Both tools are registered unconditionally. When this Pi is not currently
+ * joined to a session, the tool returns a structured error string instead
+ * of throwing, so the LLM can react and tell the user.
+ *
+ * `getSessionPeer` is a getter (not a captured value) so changes to the
+ * underlying `_sessionPeer` module variable are observed live.
+ */
+export declare function registerAgentTools(pi: ExtensionAPI, getSessionPeer: () => SessionPeer | null): void;

package/dist/session/tools.js

@@ -0,0 +1,123 @@
+import { Type } from "typebox";
+const NOT_IN_SESSION = "Not in a session. Run /remote-pi join first";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Registers two native tools the Pi LLM can invoke to talk to other agents
+ * in the same UDS session (plano 19 transport):
+ *   - `agent_send`     — fire-and-forget delivery
+ *   - `agent_request`  — request/reply with `re` correlation + timeout
+ *
+ * Both tools are registered unconditionally. When this Pi is not currently
+ * joined to a session, the tool returns a structured error string instead
+ * of throwing, so the LLM can react and tell the user.
+ *
+ * `getSessionPeer` is a getter (not a captured value) so changes to the
+ * underlying `_sessionPeer` module variable are observed live.
+ */
+export function registerAgentTools(pi, getSessionPeer) {
+    const SendParams = Type.Object({
+        to: Type.String({ description: "Recipient agent name (e.g. 'backend'), 'broadcast', or array of names." }),
+        body: Type.Unknown({ description: "Free-form JSON payload. String or object — your choice." }),
+        re: Type.Optional(Type.String({
+            description: "When you are REPLYING to a message from another agent, set this to that " +
+                "message's `id`. Required for `agent_request` correlation on the other side — " +
+                "without it, the sender's pending request times out. Skip for unsolicited sends.",
+        })),
+    });
+    const RequestParams = Type.Object({
+        to: Type.String({ description: "Recipient agent name. Must be a single peer (not broadcast)." }),
+        body: Type.Unknown({ description: "Free-form JSON payload to send." }),
+        timeout_ms: Type.Optional(Type.Number({
+            description: "Optional override of the default 30s reply timeout. Per-request.",
+        })),
+    });
+    pi.registerTool({
+        name: "agent_send",
+        label: "Agent Send",
+        description: "Send a message to another Pi agent in the current local session. " +
+            "Two uses: (1) fire-and-forget announcements, status updates, or anything " +
+            "that doesn't need a reply — call without `re`. (2) REPLYING to a question " +
+            "another agent sent you via `agent_request` — call with `re` set to the " +
+            "incoming message's `id`. Without `re`, the requester times out.",
+        promptSnippet: "agent_send({to, body, re?}): send/reply to peers. Set `re` to incoming message id when answering an agent_request.",
+        parameters: SendParams,
+        execute: async (_toolCallId, params) => {
+            const peer = getSessionPeer();
+            if (!peer) {
+                return {
+                    content: [{ type: "text", text: NOT_IN_SESSION }],
+                    details: { ok: false, error: NOT_IN_SESSION },
+                };
+            }
+            const { to, body, re } = params;
+            if (to === peer.name()) {
+                const msg = `Refused: cannot agent_send to yourself ("${to}"). Just do the work directly.`;
+                return {
+                    content: [{ type: "text", text: msg }],
+                    details: { ok: false, error: msg },
+                };
+            }
+            try {
+                await peer.send(to, body, re ?? null);
+                return {
+                    content: [{ type: "text", text: `Sent to ${to}${re ? ` (re=${re})` : ""}.` }],
+                    details: { ok: true },
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `Failed to send: ${msg}` }],
+                    details: { ok: false, error: msg },
+                };
+            }
+        },
+    });
+    pi.registerTool({
+        name: "agent_request",
+        label: "Agent Request",
+        description: "Send a message to another Pi agent and wait for the reply. Resolves to the responder's " +
+            "body field. Use when you need an answer from a peer before continuing your turn. " +
+            "Default timeout 30s; override with `timeout_ms`.",
+        promptSnippet: "agent_request({to, body, timeout_ms?}): synchronous request/reply with a peer (returns peer's body or {error}).",
+        parameters: RequestParams,
+        execute: async (_toolCallId, params) => {
+            const peer = getSessionPeer();
+            if (!peer) {
+                return {
+                    content: [{ type: "text", text: NOT_IN_SESSION }],
+                    details: { error: NOT_IN_SESSION },
+                };
+            }
+            const { to, body, timeout_ms } = params;
+            if (to === peer.name()) {
+                const msg = `Refused: cannot agent_request to yourself ("${to}"). Just do the work directly.`;
+                return {
+                    content: [{ type: "text", text: msg }],
+                    details: { error: msg },
+                };
+            }
+            const timeout = typeof timeout_ms === "number" && timeout_ms > 0
+                ? timeout_ms
+                : DEFAULT_TIMEOUT_MS;
+            try {
+                const reply = await peer.request(to, body, timeout);
+                const text = typeof reply.body === "string"
+                    ? reply.body
+                    : JSON.stringify(reply.body);
+                return {
+                    content: [{ type: "text", text }],
+                    details: reply.body,
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `Request failed: ${msg}` }],
+                    details: { error: msg },
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/session/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/session/tools.ts"],"names":[],"mappings":"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"}

package/dist/session/wizard.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Minimal wizard for `/remote-pi join` with no argument.
+ *
+ * The Pi SDK `ExtensionUIContext.select` accepts a title and string options
+ * and returns the chosen option. Wizard offers existing sessions + an "explicit
+ * create" sentinel. If user picks the sentinel, prompts for a fresh name via
+ * `select`-with-option-other (Pi's "Other" escape hatch). Returns the picked
+ * session name, or null if user cancelled.
+ */
+export interface WizardUI {
+    select(title: string, options: string[]): Promise<string | undefined>;
+}
+export declare function joinWizard(ui: WizardUI, defaultName: string): Promise<string | null>;