@selesai/code 0.13.38 → 0.13.39

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to `@selesai/code` will be documented in this file.
 
+## [0.13.39] - 2026-10-02
+
+### Changed
+- **`/tokenin usage` shows the account balance.** It queries `/tokenin/account/me/balance` and shows available credit (plan, PAYG, debt), active plan credit used, and plan expiry; a 404 falls back to the LiteLLM `/key/info` quota view.
+- **The `researcher` subagent uses `web_explore`** from the bundled `pi-web-agent` extension instead of `pi-web-access` tools; `pi-web-agent` registers a builtin-agent augmentation so foreground `researcher` children load it.
+- **Graft CLI floor raised to 0.21** (`MIN_GRAFT_VERSION` 0.21.0, install spec `@nanonets/graft@^0.21`).
+
 ## [0.13.38] - 2026-10-01
 
 ### Changed

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/tokenin-onboarding.ts

@@ -791,9 +791,141 @@ export function formatTokenInUsage(usage: TokenInUsage): string {
 	].join("\n");
 }
 
+export interface TokenInBalanceBucket {
+	kind: string;
+	planId?: string;
+	amountUsd: number;
+	usedUsd: number;
+	remainingUsd: number;
+	state: "active" | "upcoming" | "expired";
+	expiresAt?: string;
+}
+
+export interface TokenInBalance {
+	availableUsd: number;
+	fixedAvailableUsd: number;
+	paygAvailableUsd: number;
+	debtUsd: number;
+	asOf?: string;
+	buckets: TokenInBalanceBucket[];
+}
+
+const finiteNumber = (value: unknown): number | undefined => {
+	const n = typeof value === "number" ? value : Number.NaN;
+	return Number.isFinite(n) ? n : undefined;
+};
+
+/** Parse a /tokenin/account/me/balance payload. Exported for tests. */
+export function parseTokenInBalance(payload: unknown): TokenInBalance | undefined {
+	if (!payload || typeof payload !== "object" || Array.isArray(payload)) return undefined;
+	const obj = payload as Record<string, unknown>;
+	const availableUsd = finiteNumber(obj.available_usd);
+	if (availableUsd === undefined || !Array.isArray(obj.buckets)) return undefined;
+	const buckets: TokenInBalanceBucket[] = [];
+	for (const raw of obj.buckets) {
+		if (!raw || typeof raw !== "object") continue;
+		const b = raw as Record<string, unknown>;
+		const state = b.state;
+		if (state !== "active" && state !== "upcoming" && state !== "expired") continue;
+		const bucket: TokenInBalanceBucket = {
+			kind: typeof b.kind === "string" ? b.kind : "unknown",
+			amountUsd: finiteNumber(b.amount_usd) ?? 0,
+			usedUsd: finiteNumber(b.used_usd) ?? 0,
+			remainingUsd: finiteNumber(b.remaining_usd) ?? 0,
+			state,
+		};
+		if (typeof b.plan_id === "string") bucket.planId = b.plan_id;
+		if (typeof b.expires_at === "string") bucket.expiresAt = b.expires_at;
+		buckets.push(bucket);
+	}
+	const balance: TokenInBalance = {
+		availableUsd,
+		fixedAvailableUsd: finiteNumber(obj.fixed_available_usd) ?? 0,
+		paygAvailableUsd: finiteNumber(obj.payg_available_usd) ?? 0,
+		debtUsd: finiteNumber(obj.debt_usd) ?? 0,
+		buckets,
+	};
+	if (typeof obj.as_of === "string") balance.asOf = obj.as_of;
+	return balance;
+}
+
+function formatTimeUntil(iso: string): string | undefined {
+	const d = new Date(iso);
+	if (Number.isNaN(d.getTime())) return undefined;
+	const ms = d.getTime() - Date.now();
+	if (ms <= 0) return undefined;
+	const days = Math.floor(ms / 86_400_000);
+	const hours = Math.floor((ms % 86_400_000) / 3_600_000);
+	return days > 0 ? `${days}d ${hours}h` : `${Math.max(1, Math.ceil(ms / 3_600_000))}h`;
+}
+
+/** Format an account balance as a boxed display. Exported for tests. */
+export function formatTokenInBalance(balance: TokenInBalance): string {
+	const money = (v: number) => `$${v.toFixed(2)}`;
+	const active = balance.buckets.filter((b) => b.state === "active");
+	const total = active.reduce((sum, b) => sum + b.amountUsd, 0);
+	const used = active.reduce((sum, b) => sum + b.usedUsd, 0);
+	const pct = total > 0 ? Math.min(100, (used / total) * 100) : 0;
+	const barWidth = 40;
+	const filled = total > 0 ? Math.min(barWidth, Math.round((pct / 100) * barWidth)) : 0;
+	const bar = "█".repeat(filled) + "░".repeat(barWidth - filled);
+	const pctText = total > 0 ? `${pct.toFixed(1)}%` : "—";
+
+	const summary = `Available ${money(balance.availableUsd)}`;
+	let split = `Plan ${money(balance.fixedAvailableUsd)} · PAYG ${money(balance.paygAvailableUsd)}`;
+	if (balance.debtUsd > 0) split += ` · Debt ${money(balance.debtUsd)}`;
+	const usedLine = total > 0 ? `Used ${money(used)} of ${money(total)} active credit` : "No active credit";
+
+	const expiries = active
+		.map((b) => b.expiresAt)
+		.filter((v): v is string => typeof v === "string")
+		.sort((a, b) => new Date(a).getTime() - new Date(b).getTime());
+	const until = expiries.length > 0 ? formatTimeUntil(expiries[0]) : undefined;
+	const footer = until ? `Plan credit expires in ${until}` : "";
+
+	const W = 50;
+	const inner = W - 4;
+	const pad = (s: string) => s + " ".repeat(Math.max(0, inner - s.length));
+	const title = "╭─ Token-In balance ";
+	const top = `${title}${"─".repeat(W - title.length - 1)}╮`;
+	const bottom = `╰${"─".repeat(W - 2)}╯`;
+	const lines = [top, `│ ${pad(summary)} │`, `│ ${pad(split)} │`, `│ ${pad(usedLine)} │`, `│ ${bar} ${pctText.padStart(5)} │`];
+	if (footer) lines.push(`│ ${pad(footer)} │`);
+	lines.push(bottom);
+	return lines.join("\n");
+}
+
+function tokenInProxyRoot(baseUrl: string): string {
+	return baseUrl.replace(/\/v1\/?$/, "");
+}
+
+/**
+ * Query the self-scoped account balance with the user's own key. Returns undefined when
+ * the gateway has no account balance for this key (404: older gateway, accounts disabled,
+ * or a legacy key) or answers with something that is not a balance, so callers can fall
+ * back to /key/info. Other errors throw. Exported for tests.
+ */
+export async function fetchTokenInBalance(apiKey: string, baseUrl: string): Promise<TokenInBalance | undefined> {
+	const response = await fetch(`${tokenInProxyRoot(baseUrl)}/tokenin/account/me/balance`, {
+		headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+		signal: AbortSignal.timeout(5_000),
+	});
+	if (response.status === 404) return undefined;
+	if (!response.ok) {
+		throw new Error(`Token-In usage endpoint returned HTTP ${response.status}`);
+	}
+	let payload: unknown;
+	try {
+		payload = await response.json();
+	} catch {
+		return undefined;
+	}
+	return parseTokenInBalance(payload);
+}
+
 /** Query LiteLLM /key/info at the proxy root with the account key. Exported for tests. */
 export async function fetchTokenInUsage(apiKey: string, baseUrl: string): Promise<TokenInUsage> {
-	const root = baseUrl.replace(/\/v1\/?$/, "");
+	const root = tokenInProxyRoot(baseUrl);
 	const response = await fetch(`${root}/key/info`, {
 		headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
 		signal: AbortSignal.timeout(5_000),
@@ -906,6 +1038,11 @@ async function handleTokenInUsage(ctx: ExtensionCommandContext): Promise<void> {
 	const account = auth.accounts.find((a) => a.id === activeId);
 	const baseUrl = account?.baseUrl ?? getTokenInBaseUrl(readModelsJson()) ?? TOKEN_IN_DEFAULT_BASE_URL;
 	try {
+		const balance = await fetchTokenInBalance(apiKey, baseUrl);
+		if (balance) {
+			ctx.ui.notify(formatTokenInBalance(balance), "info");
+			return;
+		}
 		const usage = await fetchTokenInUsage(apiKey, baseUrl);
 		ctx.ui.notify(formatTokenInUsage(usage), "info");
 	} catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selesai/code",
-  "version": "0.13.38",
+  "version": "0.13.39",
   "description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
   "type": "module",
   "engines": {