@selesai/code 0.13.38 → 0.13.40

package/dist/extensions/pi-graft/cli.test.ts

@@ -68,8 +68,8 @@ describe("installGraft", () => {
 	it("runs the compatible global npm install without a shell off Windows", async () => {
 		const { pi } = makePi(async () => execReturning(OK));
 		const run = await installGraft(pi.exec as never, "/repo");
-		expect(GRAFT_INSTALL_SPEC).toBe("@nanonets/graft@^0.18");
-		expect(INSTALL_COMMAND).toBe("npm install -g @nanonets/graft@^0.18");
+		expect(GRAFT_INSTALL_SPEC).toBe("@nanonets/graft@^0.21");
+		expect(INSTALL_COMMAND).toBe("npm install -g @nanonets/graft@^0.21");
 		const [command, args, options] = pi.exec.mock.calls[0] as [string, string[], { cwd: string; timeout: number }];
 		expect(command).toBe(process.platform === "win32" ? "cmd" : "npm");
 		expect(args).toContain("install");
@@ -118,7 +118,7 @@ describe("version handling", () => {
 
 	it("accepts the verified range and rejects the boundaries", () => {
 		expect(isCompatibleVersion(MIN_GRAFT_VERSION)).toBe(true);
-		expect(isCompatibleVersion("0.18.4")).toBe(true);
+		expect(isCompatibleVersion("0.21.1")).toBe(true);
 		expect(isCompatibleVersion("0.99.0")).toBe(true);
 		expect(isCompatibleVersion("0.17.9")).toBe(false);
 		expect(isCompatibleVersion(MAX_GRAFT_VERSION_EXCLUSIVE)).toBe(false);
@@ -128,9 +128,9 @@ describe("version handling", () => {
 
 describe("probeGraft", () => {
 	it("accepts a supported version and reports it", async () => {
-		const { pi } = makePi(async () => execReturning({ ...OK, stdout: "0.18.0\n" }));
+		const { pi } = makePi(async () => execReturning({ ...OK, stdout: "0.21.1\n" }));
 		const probe = await probeGraft(pi.exec as never, "/repo");
-		expect(probe).toMatchObject({ kind: "ok", version: "0.18.0" });
+		expect(probe).toMatchObject({ kind: "ok", version: "0.21.1" });
 		if (probe.kind === "ok") expect(probe.argv.at(-1)).toBe("--version");
 	});
 

package/dist/extensions/pi-graft/cli.ts

@@ -15,7 +15,7 @@
  *   Selesai model for deep enrichment, otherwise stay structural and local.
  * - Extension-spawned commands default to telemetry opt-out (`DO_NOT_TRACK=1`).
  *
- * Verified against @nanonets/graft 0.18.0 (see {@link MIN_GRAFT_VERSION}).
+ * Verified against @nanonets/graft 0.21.1 (see {@link MIN_GRAFT_VERSION}).
  */
 
 import { truncateHead, type ExecOptions, type ExecResult } from "@selesai/code";
@@ -27,8 +27,13 @@ export const GRAFT_PACKAGE = "@nanonets/graft";
  * Lowest Graft CLI whose documented surface this adapter was verified against:
  * `ask --source/--json`, `skeleton`, `callers --direction/-d`, `grep --in/-i/--fixed`,
  * `map --max-dirs`, `check --json`, `build [--deep]`, and `--version`.
+ *
+ * The floor sits on the 0.21 minor line this adapter is verified against
+ * (0.21.1). Upgrades are deliberate: an executable below the floor reports
+ * `incompatible`, and the adapter never overwrites it — the user upgrades with
+ * {@link INSTALL_COMMAND}.
  */
-export const MIN_GRAFT_VERSION = "0.18.0";
+export const MIN_GRAFT_VERSION = "0.21.0";
 /** Upper bound is exclusive: a 1.x CLI is allowed to change its contract. */
 export const MAX_GRAFT_VERSION_EXCLUSIVE = "1.0.0";
 
@@ -45,8 +50,8 @@ export const DEEP_BUILD_TIMEOUT_MS = 1_800_000;
 /** Global npm installs can be slow on a cold cache. */
 export const INSTALL_TIMEOUT_MS = 180_000;
 
-/** Kept on the verified 0.18 minor line; never install a floating latest CLI. */
-export const GRAFT_INSTALL_SPEC = `${GRAFT_PACKAGE}@^0.18`;
+/** Kept on the verified 0.21 minor line; never install a floating latest CLI. */
+export const GRAFT_INSTALL_SPEC = `${GRAFT_PACKAGE}@^0.21`;
 export const INSTALL_COMMAND = `npm install -g ${GRAFT_INSTALL_SPEC}`;
 export const TELEMETRY_ENV = "DO_NOT_TRACK";
 
@@ -399,7 +404,7 @@ export interface AskHit {
 }
 
 /**
- * `graft ask --json` result, as emitted by `AskResult` upstream (0.18.0).
+ * `graft ask --json` result, as emitted by `AskResult` upstream (0.21.1).
  *
  * Every field is optional on read: a CLI that changes shape degrades to raw
  * text rather than to a wrong summary, and callers must never treat the parse

package/dist/extensions/pi-graft/commands.test.ts

@@ -15,11 +15,11 @@ import {
 import { MODE_ENTRY_TYPE, type GraftState } from "./state.ts";
 import { notified, makeCtx, makePi, type CtxStub } from "./test-support.ts";
 
-const HEALTHY: GraftState = { name: "fresh-structural", version: "0.18.0" };
+const HEALTHY: GraftState = { name: "fresh-structural", version: "0.21.1" };
 
 function installOf(overrides: Partial<GraftInstallRun> = {}): GraftInstallRun {
 	return {
-		argv: ["npm", "install", "-g", "@nanonets/graft@^0.18"],
+		argv: ["npm", "install", "-g", "@nanonets/graft@^0.21"],
 		cwd: "/repo",
 		code: 0,
 		stdout: "",
@@ -75,7 +75,7 @@ function makeRuntime(
 	const recheck = vi.fn(async () => {});
 	const installCli = vi.fn(async () => {
 		const result = overrides.installResult ?? installOf();
-		if (result.code === 0 && !result.killed) state = overrides.postInstallState ?? { name: "unbuilt", version: "0.18.0" };
+		if (result.code === 0 && !result.killed) state = overrides.postInstallState ?? { name: "unbuilt", version: "0.21.1" };
 		return result;
 	});
 	const runBuild = vi.fn(async () => overrides.buildResult ?? runOf());
@@ -134,7 +134,7 @@ describe("formatDoctor", () => {
 	it("reports repository, executable, graph, state, mode, telemetry and provider boundary", () => {
 		const text = formatDoctor(base);
 		expect(text).toContain("/repo (git ✓)");
-		expect(text).toContain("graft 0.18.0");
+		expect(text).toContain("graft 0.21.1");
 		expect(text).toContain("structural only");
 		expect(text).toContain("fresh-structural");
 		expect(text).toContain("nothing is injected");
@@ -188,7 +188,7 @@ describe("formatStatus", () => {
 			providerEnv: [],
 		});
 		expect(text.split("\n")).toHaveLength(4);
-		expect(text).toContain("graft: ● structural v0.18.0");
+		expect(text).toContain("graft: ● structural v0.21.1");
 		expect(text).toContain("hybrid");
 		expect(text).toContain("root: /repo");
 	});

package/dist/extensions/pi-graft/graft.integration.test.ts

@@ -6,7 +6,7 @@
  * adapter against the real executable, and it skips itself when no compatible
  * Graft CLI is on PATH — which is the state of ordinary CI.
  *
- * To run it for real: `npm install -g @nanonets/graft@^0.18` then
+ * To run it for real: `npm install -g @nanonets/graft@^0.21` then
  *   npx vitest run src/extensions/pi-graft/graft.integration.test.ts
  *
  * A structural build is tree-sitter only: no model, no API key, no network. The

package/dist/extensions/pi-graft/lifecycle.test.ts

@@ -39,7 +39,7 @@ function writeProjectSettings(value: unknown): void {
 function exec(graftOutput = ASK_JSON) {
 	return async (command: string, args: string[]) => {
 		if (command === "git" && args.includes("--show-toplevel")) return { ...OK, stdout: `${repo}\n` };
-		if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+		if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 		return { ...OK, stdout: graftOutput };
 	};
 }
@@ -88,7 +88,7 @@ describe("session start", () => {
 	it("resolves the Git working tree, probes the executable, and publishes a status line", async () => {
 		const session = await bootSession();
 		expect(session.commandsRun()).toEqual(["git rev-parse --show-toplevel", "graft --version"]);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1");
 		await session.reset();
 	});
 
@@ -163,7 +163,7 @@ describe("session start", () => {
 			}
 			if (args.includes("--version")) {
 				if (!installed) throw new Error("spawn graft ENOENT");
-				return { ...OK, stdout: "0.18.0\n" };
+				return { ...OK, stdout: "0.21.1\n" };
 			}
 			return { ...OK };
 		});
@@ -171,8 +171,8 @@ describe("session start", () => {
 		const ctx = makeCtx({ cwd: repo });
 		const start = handlerFor(harness, "session_start") as (e: unknown, c: unknown) => Promise<void>;
 		await start({ type: "session_start", reason: "startup" }, ctx);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0"));
-		expect(harness.commandsRun()).toContain("npm install -g @nanonets/graft@^0.18");
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
+		expect(harness.commandsRun()).toContain("npm install -g @nanonets/graft@^0.21");
 
 		await start({ type: "session_start", reason: "reload" }, ctx);
 		expect(harness.commandsRun().filter((command) => command.startsWith("npm install"))).toHaveLength(1);
@@ -202,7 +202,7 @@ describe("session start", () => {
 		writeProjectSettings({});
 		const harness = makePi(async (command: string) => {
 			if (command === "git") return { code: 128, stdout: "", stderr: "not a git repository", killed: false };
-			return { ...OK, stdout: "0.18.0\n" };
+			return { ...OK, stdout: "0.21.1\n" };
 		});
 		graftExtension(harness.pi as never);
 		const ctx = makeCtx({ cwd: repo });
@@ -233,14 +233,14 @@ describe("mutation awareness", () => {
 	it("marks the graph changed after a successful edit", async () => {
 		const session = await bootSession();
 		await onToolResult(session, "edit", { path: "src/a.ts" });
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.21.1");
 		await session.reset();
 	});
 
 	it("marks the graph changed after a clearly mutating bash command", async () => {
 		const session = await bootSession();
 		await onToolResult(session, "bash", { command: "rm -rf dist" });
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.21.1");
 		await session.reset();
 	});
 
@@ -249,7 +249,7 @@ describe("mutation awareness", () => {
 		await onToolResult(session, "read", { path: "src/a.ts" });
 		await onToolResult(session, "bash", { command: "git status" });
 		await onToolResult(session, "edit", { path: "src/a.ts" }, true);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1");
 		await session.reset();
 	});
 });
@@ -270,7 +270,7 @@ describe("proactive refresh", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: {} }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -283,7 +283,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
 		expect(harness.commandsRun()).toContain("graft build");
 	});
 
@@ -294,7 +294,7 @@ describe("proactive refresh", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: {} }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -314,7 +314,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.21.1"));
 		const build = harness.exec.mock.calls.find((call) => (call[1] as string[]).includes("build"))!;
 		expect(build[1]).toEqual(["build", "--deep"]);
 		expect(build[2]).toMatchObject({
@@ -335,7 +335,7 @@ describe("proactive refresh", () => {
 		const models: string[] = [];
 		const harness = makePi(async (command: string, args: string[], options?: unknown) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				const model = (options as { env?: Record<string, string> }).env?.GRAFT_MODEL ?? "";
 				models.push(model);
@@ -359,7 +359,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● deep v0.21.1"));
 		expect(models).toEqual(["deepseek-v4.1-flash", "glm-5.3-flash"]);
 		expect(notified(ctx)).toContain("retrying the deep pass");
 	});
@@ -371,7 +371,7 @@ describe("proactive refresh", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: {} }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -388,7 +388,7 @@ describe("proactive refresh", () => {
 			{ type: "session_start", reason: "startup" },
 			ctx,
 		);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
 		const build = harness.exec.mock.calls.find((call) => (call[1] as string[]).includes("build"))!;
 		expect(build[1]).toEqual(["build"]);
 	});
@@ -403,11 +403,11 @@ describe("proactive refresh", () => {
 			{ type: "tool_result", toolName: "write", toolCallId: "c1", input: {}, content: [], isError: false },
 			session.ctx,
 		);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.18.0");
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ◐ changed v0.21.1");
 
 		await (handlerFor(session, "agent_end") as (e: unknown, c: unknown) => Promise<void>)({}, session.ctx);
-		expect(session.ctx.statuses.get("graft")).toBe("graft: ⚙ syncing v0.18.0");
-		await vi.waitFor(() => expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.18.0"));
+		expect(session.ctx.statuses.get("graft")).toBe("graft: ⚙ syncing v0.21.1");
+		await vi.waitFor(() => expect(session.ctx.statuses.get("graft")).toBe("graft: ● structural v0.21.1"));
 		expect(session.commandsRun()).toContain("graft build");
 		await session.reset();
 	});
@@ -434,7 +434,7 @@ describe("proactive refresh", () => {
 		writeProjectSettings({ refreshDebounceSeconds: 0 });
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${repo}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) return { code: 1, stdout: "", stderr: "✗ index failed", killed: false };
 			return { ...OK, stdout: ASK_JSON };
 		});
@@ -449,7 +449,7 @@ describe("proactive refresh", () => {
 			ctx,
 		);
 		await (handlerFor(harness, "agent_end") as (e: unknown, c: unknown) => Promise<void>)({}, ctx);
-		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ✕ failed v0.18.0"));
+		await vi.waitFor(() => expect(ctx.statuses.get("graft")).toBe("graft: ✕ failed v0.21.1"));
 	});
 });
 
@@ -541,7 +541,7 @@ describe("retrieval strategy", () => {
 		writeProjectSettings({ mode: "push" });
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${repo}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			return { code: 1, stdout: "", stderr: "✗ graph missing", killed: false };
 		});
 		graftExtension(harness.pi as never);
@@ -565,7 +565,7 @@ describe("retrieval strategy", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: { mode: "push" } }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -642,7 +642,7 @@ describe("tool readiness", () => {
 		writeFileSync(join(bare, ".selesai", "settings.json"), JSON.stringify({ graft: {} }), "utf-8");
 		const harness = makePi(async (command: string, args: string[]) => {
 			if (command === "git") return { ...OK, stdout: `${bare}\n` };
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			if (args.includes("build")) {
 				mkdirSync(join(bare, "graft", ".graph"), { recursive: true });
 				writeFileSync(join(bare, "graft", ".graph", "wiring.json"), "{}", "utf-8");
@@ -671,7 +671,7 @@ describe("tool readiness", () => {
 				gitCalls += 1;
 				return { code: 128, stdout: "", stderr: "not a git repository", killed: false };
 			}
-			if (args.includes("--version")) return { ...OK, stdout: "0.18.0\n" };
+			if (args.includes("--version")) return { ...OK, stdout: "0.21.1\n" };
 			return { ...OK, stdout: ASK_JSON };
 		});
 		graftExtension(harness.pi as never);

package/dist/extensions/pi-graft/prompt.test.ts

@@ -13,7 +13,7 @@ import {
 } from "./prompt.ts";
 import { DEFAULT_MIN_COVERAGE, type GraftState } from "./state.ts";
 
-const FRESH: GraftState = { name: "fresh-structural", version: "0.18.0" };
+const FRESH: GraftState = { name: "fresh-structural", version: "0.21.1" };
 
 function payload(overrides: Partial<AskPayload> = {}): AskPayload {
 	return {

package/dist/extensions/pi-graft/state.test.ts

@@ -22,8 +22,8 @@ import {
 } from "./state.ts";
 
 const UNBUILT: GraftState = { name: "unbuilt", detail: "no graph yet" };
-const FRESH: GraftState = { name: "fresh-structural", version: "0.18.0", deep: false };
-const DEEP: GraftState = { name: "fresh-deep", version: "0.18.0", deep: true };
+const FRESH: GraftState = { name: "fresh-structural", version: "0.21.1", deep: false };
+const DEEP: GraftState = { name: "fresh-deep", version: "0.21.1", deep: true };
 
 describe("reduceGraftState", () => {
 	it("only claims a repository once root resolution says there is a Git working tree", () => {
@@ -36,16 +36,16 @@ describe("reduceGraftState", () => {
 	});
 
 	it("derives built/fresh/deep from what is actually on disk", () => {
-		expect(reduceGraftState(gitState(), { type: "probe-ok", version: "0.18.0", graph: ABSENT_GRAPH })).toEqual({
+		expect(reduceGraftState(gitState(), { type: "probe-ok", version: "0.21.1", graph: ABSENT_GRAPH })).toEqual({
 			name: "unbuilt",
-			version: "0.18.0",
+			version: "0.21.1",
 			detail: expect.stringContaining("/graft build"),
 		});
 		expect(
-			reduceGraftState(gitState(), { type: "probe-ok", version: "0.18.0", graph: { built: true, deep: false } }),
+			reduceGraftState(gitState(), { type: "probe-ok", version: "0.21.1", graph: { built: true, deep: false } }),
 		).toEqual(FRESH);
 		expect(
-			reduceGraftState(gitState(), { type: "probe-ok", version: "0.18.0", graph: { built: true, deep: true } }),
+			reduceGraftState(gitState(), { type: "probe-ok", version: "0.21.1", graph: { built: true, deep: true } }),
 		).toMatchObject({ name: "fresh-deep", deep: true });
 	});
 
@@ -91,7 +91,7 @@ describe("reduceGraftState", () => {
 		expect(reduceGraftState(FRESH, { type: "build-started", deep: true })).toMatchObject({
 			name: "building",
 			deep: true,
-			version: "0.18.0",
+			version: "0.21.1",
 		});
 	});
 
@@ -140,8 +140,8 @@ describe("state predicates and rendering", () => {
 	});
 
 	it("renders a compact status line with the version when it is known", () => {
-		expect(statusText(FRESH)).toBe("graft: ● structural v0.18.0");
-		expect(statusText(DEEP)).toBe("graft: ● deep v0.18.0");
+		expect(statusText(FRESH)).toBe("graft: ● structural v0.21.1");
+		expect(statusText(DEEP)).toBe("graft: ● deep v0.21.1");
 		expect(statusText({ name: "unavailable" })).toBe("graft: ✕ no cli");
 		expect(statusText({ name: "changed" })).toBe("graft: ◐ changed");
 	});

package/dist/extensions/pi-graft/test-support.ts

@@ -190,7 +190,7 @@ export function makeCtx(
  */
 export function healthyExec(overrides: { gitRoot?: string; version?: string; queryOutput?: string } = {}): ExecImpl {
 	const gitRoot = overrides.gitRoot ?? "/repo";
-	const version = overrides.version ?? "0.18.0";
+	const version = overrides.version ?? "0.21.1";
 	return async (command, args) => {
 		if (command === "git" && args.includes("--show-toplevel")) return { ...OK, stdout: `${gitRoot}\n` };
 		if (args.includes("--version")) return { ...OK, stdout: `${version}\n` };

package/dist/extensions/pi-graft/tools.test.ts

@@ -64,7 +64,7 @@ function makeHarness(
 	const runtime: GraftToolRuntime = {
 		run: run as never,
 		settings: () => options.settings ?? {},
-		state: () => options.state ?? { name: "fresh-structural", version: "0.18.0" },
+		state: () => options.state ?? { name: "fresh-structural", version: "0.21.1" },
 		noteQuery: ((_ctx: unknown, result: GraftRun) => {
 			noted.push(result);
 		}) as never,

package/dist/extensions/pi-intercom/README.md

@@ -143,6 +143,19 @@ See auth.ts:142-156.
 
 The reply hint (enabled by default) points to `intercom({ action: "reply", ... })`, so recipients do not need raw sender or `replyTo` IDs. Idle recipients get a new turn immediately; busy interactive recipients receive the message through Selesai's steering queue at the next safe model boundary without aborting the active turn. Attachment content is included in the agent-visible body, and messages are rendered inline and stored in Selesai session history.
 
+## Desktop / RPC clients
+
+RPC clients can use typed `intercom_status`, `intercom_list`, `intercom_send`, `intercom_ask`, `intercom_reply`, and `intercom_pending` commands directly, without a model turn or the TUI-only `/intercom` overlay. They reuse this extension's broker connection, reply tracker, scope, and consent policy. Ordinary/inferred sends honor `confirmSend`; explicit replies and asks skip confirmation as in the tool. Missing/disabled extensions fail explicitly.
+
+```json
+{"id":"peers","type":"intercom_list"}
+{"id":"send","type":"intercom_send","to":"peer-full-id","message":"Build finished."}
+{"id":"ask","type":"intercom_ask","to":"peer-full-id","message":"Approve?","timeoutMs":60000}
+{"id":"reply","type":"intercom_reply","replyTo":"question-id","message":"Approved."}
+```
+
+Structured connection, peer join/leave, presence, incoming message, delivery, and receipt events stream while idle or busy. Command `id` correlates responses; Intercom `messageId`/`replyTo` correlate messages and receipts. An ask timeout does not cancel delivered work. See [the RPC protocol](../../../docs/rpc.md#intercom-desktop--headless-clients) for response shapes, event examples, timeout limits, confirmation dialogs, and typed client helpers.
+
 ## Workflow: Planner-Worker Coordination
 
 The most natural use of pi-intercom is splitting a task between two sessions — one holds the big picture, the other does the hands-on work. When the worker hits an ambiguity ("should I optimize for readability or performance here?"), they ask without losing context.
@@ -610,3 +623,5 @@ Use pi-messenger for multi-agent swarms working on a shared task. Use pi-interco
 - **No attachments UI** — `file`, `snippet`, and `context` attachments are supported in the protocol, but not in the compose overlay
 - **Only connected sessions appear** — The list shows Selesai sessions that have loaded `pi-intercom` and successfully registered with the broker, not every open Selesai process on the machine
 - **Broker lifecycle** — The broker auto-spawns on first use and exits when idle; sessions reconnect automatically if the broker restarts
+
+All Intercom events and `intercom_status.data` carry `scope: {version:1,sessionId,epoch}`. `scope.sessionId` is the host parent SDK session ID, not a path or broker endpoint. Existing top-level `sessionId` still identifies broker self (status/connection) or departing peer (leave). The epoch is shared with subagent snapshots and rotates on rebind/reload; discard obsolete scope pairs. Broker reconnect within a binding keeps the epoch.