@norman-else/dsh-claude 0.1.25 → 0.1.27

package/lib/index.mjs

@@ -1,10 +1,10 @@
-import { C as CLAUDE_REVIEW_COMMENT_PATH, D as TASK_TOOL_NAMES, S as CLAUDE_REPOSITORY_STATUS_PATH, T as CLAUDE_UPDATE_PATH, _ as CLAUDE_JIRA_PATH, a as latestClaudeTasks, b as CLAUDE_REPOSITORY_FEEDBACK_PATH, c as normalizeTasksEvent, d as CLAUDE_ACTIVITY_EVENT, f as CLAUDE_CODE_PRESET_ID, g as CLAUDE_GLOBAL_SETTINGS_PATH, h as CLAUDE_DOCTOR_PATH, i as latestClaudeSessionBinding, l as redactText, m as CLAUDE_CODE_PROVIDER_IDS, n as currentClaudeActivityCursor, o as normalizeActivity, p as CLAUDE_CODE_PROVIDER, r as latestClaudeContextUsage, s as normalizeContextUsage, t as boundText, u as safeDetail, v as CLAUDE_PROJECTION_PATH, w as CLAUDE_UPDATE_CHECK_PATH, x as CLAUDE_REPOSITORY_SETUP_PATH, y as CLAUDE_REPOSITORY_ACTION_PATH } from "./events-BhU0iJUi.mjs";
-import { n as projectClaudeCommands, t as CLAUDE_COMMANDS_SERVICE } from "./command-bridge-B48egrCr.mjs";
-import { a as resolveClaudeExecutable, n as ensureManagedPreset, o as runClaudeDoctor, t as ManagedPresetConflictError } from "./preset-installer-Bzw8tuGI.mjs";
+import { A as TASK_TOOL_NAMES, C as CLAUDE_REPOSITORY_SETUP_PATH, D as CLAUDE_UPDATE_PATH, E as CLAUDE_UPDATE_CHECK_PATH, O as CLAUDE_USAGE_PATH, S as CLAUDE_REPOSITORY_FILE_PATH, T as CLAUDE_REVIEW_COMMENT_PATH, _ as CLAUDE_GLOBAL_SETTINGS_PATH, a as latestClaudeTasks, b as CLAUDE_REPOSITORY_ACTION_PATH, c as normalizeTasksEvent, d as CLAUDE_ACTIVITY_EVENT, f as CLAUDE_ASK_PATH, g as CLAUDE_DOCTOR_PATH, h as CLAUDE_CODE_PROVIDER_IDS, i as latestClaudeSessionBinding, l as redactText, m as CLAUDE_CODE_PROVIDER, n as currentClaudeActivityCursor, o as normalizeActivity, p as CLAUDE_CODE_PRESET_ID, r as latestClaudeContextUsage, s as normalizeContextUsage, t as boundText, u as safeDetail, v as CLAUDE_JIRA_PATH, w as CLAUDE_REPOSITORY_STATUS_PATH, x as CLAUDE_REPOSITORY_FEEDBACK_PATH, y as CLAUDE_PROJECTION_PATH } from "./events-lDt9nTUw.mjs";
+import { n as projectClaudeCommands, t as CLAUDE_COMMANDS_SERVICE } from "./command-bridge-BYj0VF4J.mjs";
+import { a as resolveClaudeExecutable, n as ensureManagedPreset, o as runClaudeDoctor, t as ManagedPresetConflictError } from "./preset-installer-CPOH9lAr.mjs";
 import z from "@deepseek-ai/schemastery";
 import { createHash, randomUUID } from "node:crypto";
 import { chmod, mkdir, opendir, readFile, realpath, rename, rm, stat, writeFile } from "node:fs/promises";
-import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
+import { basename, dirname, extname, isAbsolute, join, resolve, sep } from "node:path";
 import { dshHomePath, resolveDshHome } from "@deepseek-ai/dsh-home-paths";
 import { homedir } from "node:os";
 import { query } from "@anthropic-ai/claude-agent-sdk";
@@ -12,6 +12,7 @@ import { EventEmitter } from "node:events";
 import { DSH_ENV_PREFIX, SENSITIVE_ENV_PATTERN } from "@deepseek-ai/dsh-subprocess";
 import { LlmAdapter, ReasoningEffortId } from "@deepseek-ai/dsh-llm";
 import { fileURLToPath } from "node:url";
+import { StringDecoder } from "node:string_decoder";
 //#region src/sidecar.ts
 const SIDECAR_SCHEMA_VERSION = 1;
 const MAX_ACTIVITIES = 1e4;
@@ -25,7 +26,7 @@ function emptyProjection() {
 		activities: []
 	};
 }
-function record$8(value) {
+function record$11(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
 function finiteInteger(value) {
@@ -35,7 +36,7 @@ function string$4(value, max) {
 	return typeof value === "string" && value.length > 0 && value.length <= max;
 }
 function binding(value) {
-	const input = record$8(value);
+	const input = record$11(value);
 	if (input === void 0 || !string$4(input.claudeSessionId, 512) || !string$4(input.sdkVersion, 128) || !string$4(input.cwd, 4096) || input.cliVersion !== void 0 && !string$4(input.cliVersion, 128)) return void 0;
 	return {
 		claudeSessionId: input.claudeSessionId,
@@ -65,22 +66,22 @@ const ACTIVITY_PHASES = /* @__PURE__ */ new Set([
 	"failed"
 ]);
 function activity(value) {
-	const input = record$8(value);
+	const input = record$11(value);
 	if (input === void 0 || !finiteInteger(input.turn) || !finiteInteger(input.step) || !finiteInteger(input.ordinal) || typeof input.kind !== "string" || !ACTIVITY_KINDS.has(input.kind) || input.phase !== void 0 && (typeof input.phase !== "string" || !ACTIVITY_PHASES.has(input.phase))) return void 0;
 	return normalizeActivity(input);
 }
 function contextUsage(value) {
-	const input = record$8(value);
+	const input = record$11(value);
 	if (input === void 0 || !Array.isArray(input.categories)) return void 0;
 	return normalizeContextUsage(input);
 }
 function tasks(value) {
-	const input = record$8(value);
+	const input = record$11(value);
 	if (input === void 0 || !Array.isArray(input.tasks)) return void 0;
 	return normalizeTasksEvent(input.tasks);
 }
 function parseClaudeSidecar(value) {
-	const input = record$8(value);
+	const input = record$11(value);
 	if (input === void 0 || input.schemaVersion !== SIDECAR_SCHEMA_VERSION || !finiteInteger(input.revision) || !Array.isArray(input.activities) || input.activities.length > MAX_ACTIVITIES) throw new Error("dsh-claude: invalid sidecar document");
 	const activities = input.activities.map(activity);
 	if (activities.some((item) => item === void 0)) throw new Error("dsh-claude: invalid sidecar activity");
@@ -111,7 +112,7 @@ function mergeActivities(existing, additions) {
 function normalizeBinding(input) {
 	return {
 		claudeSessionId: redactText(input.claudeSessionId, 512),
-		sdkVersion: redactText(input.sdkVersion ?? "0.3.233", 128),
+		sdkVersion: redactText(input.sdkVersion ?? "0.3.247", 128),
 		cwd: redactText(input.cwd, 4096),
 		...input.cliVersion === void 0 ? {} : { cliVersion: redactText(input.cliVersion, 128) }
 	};
@@ -653,7 +654,7 @@ function createUserQuestionBridge(userQuestions, activeContext) {
 }
 //#endregion
 //#region src/sdk-messages.ts
-function record$7(value) {
+function record$10(value) {
 	return value !== null && typeof value === "object" ? value : void 0;
 }
 function string$3(value) {
@@ -668,7 +669,7 @@ function taskUsageOf(usage) {
 	return Object.keys(normalized).length === 0 ? void 0 : normalized;
 }
 function resultUsage(message) {
-	const usage = record$7(message.usage);
+	const usage = record$10(message.usage);
 	const normalized = {};
 	if (usage !== void 0) {
 		if (typeof usage.input_tokens === "number") normalized.inputTokens = usage.input_tokens;
@@ -680,7 +681,7 @@ function resultUsage(message) {
 	return normalized;
 }
 function normalizeAssistant(message) {
-	const content = record$7(message.message)?.content;
+	const content = record$10(message.message)?.content;
 	if (!Array.isArray(content)) return [{
 		kind: "protocol-error",
 		title: "Malformed Claude assistant message",
@@ -689,7 +690,7 @@ function normalizeAssistant(message) {
 	const parentToolUseId = string$3(message.parent_tool_use_id);
 	const normalized = [];
 	for (const item of content) {
-		const block = record$7(item);
+		const block = record$10(item);
 		if (block === void 0) continue;
 		if (block.type === "text") {
 			const text = string$3(block.text);
@@ -722,7 +723,7 @@ function normalizeAssistant(message) {
 }
 function normalizeUser(message) {
 	if (message.isReplay === true) return [];
-	const content = record$7(message.message)?.content;
+	const content = record$10(message.message)?.content;
 	if (typeof content === "string") return [];
 	if (!Array.isArray(content)) return [{
 		kind: "protocol-error",
@@ -732,7 +733,7 @@ function normalizeUser(message) {
 	const parentToolUseId = string$3(message.parent_tool_use_id);
 	const normalized = [];
 	for (const item of content) {
-		const block = record$7(item);
+		const block = record$10(item);
 		if (block?.type !== "tool_result") continue;
 		const toolUseId = string$3(block.tool_use_id);
 		if (toolUseId === void 0) continue;
@@ -813,7 +814,7 @@ function normalizeSystem(message) {
 		const summary = string$3(message.summary);
 		const subagentType = string$3(message.subagent_type);
 		const lastToolName = string$3(message.last_tool_name);
-		const usage = taskUsageOf(record$7(message.usage));
+		const usage = taskUsageOf(record$10(message.usage));
 		return [{
 			kind: "subagent",
 			title: summary ?? description ?? "Claude subagent update",
@@ -829,7 +830,7 @@ function normalizeSystem(message) {
 		}];
 	}
 	if (subtype === "task_updated") {
-		const patch = record$7(message.patch);
+		const patch = record$10(message.patch);
 		const status = string$3(patch?.status);
 		const taskId = string$3(message.task_id);
 		const description = string$3(patch?.description);
@@ -852,7 +853,7 @@ function normalizeSystem(message) {
 		const taskId = string$3(message.task_id);
 		const summary = string$3(message.summary);
 		const taskStatus = failed ? "failed" : stopped ? "stopped" : "completed";
-		const usage = taskUsageOf(record$7(message.usage));
+		const usage = taskUsageOf(record$10(message.usage));
 		return [{
 			kind: "subagent",
 			title: summary ?? taskId ?? "Claude subagent finished",
@@ -867,7 +868,7 @@ function normalizeSystem(message) {
 	if (subtype === "background_tasks_changed") return [{
 		kind: "background-tasks",
 		tasks: (Array.isArray(message.tasks) ? message.tasks : []).flatMap((item) => {
-			const entry = record$7(item);
+			const entry = record$10(item);
 			const taskId = string$3(entry?.task_id);
 			const description = string$3(entry?.description);
 			const taskType = string$3(entry?.task_type);
@@ -910,10 +911,10 @@ const RESULT_ERROR_SUBTYPES = /* @__PURE__ */ new Set([
 function normalizeSdkMessage(message) {
 	const value = message;
 	if (value.type === "stream_event") {
-		const event = record$7(value.event);
+		const event = record$10(value.event);
 		const parentToolUseId = string$3(value.parent_tool_use_id);
 		if (event?.type === "content_block_delta") {
-			const delta = record$7(event.delta);
+			const delta = record$10(event.delta);
 			if (delta?.type === "text_delta") {
 				const text = string$3(delta.text);
 				return text === void 0 ? [] : [{
@@ -948,7 +949,7 @@ function normalizeSdkMessage(message) {
 		const errors = Array.isArray(value.errors) ? value.errors.filter((item) => typeof item === "string") : void 0;
 		const terminalReason = string$3(value.terminal_reason);
 		const userMessageUuid = string$3(value.user_message_uuid);
-		const permissionDenials = Array.isArray(value.permission_denials) ? value.permission_denials.map((item) => record$7(item)).filter((item) => item !== void 0).map((item) => {
+		const permissionDenials = Array.isArray(value.permission_denials) ? value.permission_denials.map((item) => record$10(item)).filter((item) => item !== void 0).map((item) => {
 			const toolName = string$3(item.tool_name);
 			const toolUseId = string$3(item.tool_use_id);
 			return toolName === void 0 || toolUseId === void 0 ? void 0 : {
@@ -974,7 +975,7 @@ function normalizeSdkMessage(message) {
 		detail: value.error ?? value.output
 	}];
 	if (value.type === "rate_limit_event") {
-		const status = string$3(record$7(value.rate_limit_info)?.status);
+		const status = string$3(record$10(value.rate_limit_info)?.status);
 		return [{
 			kind: "status",
 			title: status !== void 0 && status !== "allowed" ? "Claude rate limit is blocking requests" : "Claude rate limit status changed",
@@ -988,6 +989,117 @@ function normalizeSdkMessage(message) {
 	}];
 }
 //#endregion
+//#region src/plan-usage.ts
+/** Claude.ai plan rate-limit windows behind the CLI's `/usage` panel.
+*
+*  The Agent SDK exposes them through an experimental query method whose name
+*  advertises its own instability, so every read is guarded: a missing method,
+*  a shape change, or an API-key session all degrade to `available: false`
+*  instead of breaking the settings page. */
+/** The SDK's own name for the unstable `/usage` control request; it is
+*  documented to change when the API stabilizes, so it lives in one place. */
+const PLAN_USAGE_METHOD = "usage_EXPERIMENTAL_MAY_CHANGE_DO_NOT_RELY_ON_THIS_API_YET";
+/** A throwaway probe should not outlive a wedged control request. */
+const PLAN_USAGE_TIMEOUT_MS = 2e4;
+/** Invoke the experimental usage control request, or say why we cannot. */
+function readPlanUsageFrom(query) {
+	const read = query[PLAN_USAGE_METHOD];
+	if (typeof read !== "function") throw new Error("dsh-claude: this Claude Agent SDK build exposes no plan usage API");
+	return read.call(query);
+}
+/** Fixed windows in display order; the SDK omits the ones a plan does not have. */
+const FIXED_WINDOWS = [
+	"five_hour",
+	"seven_day",
+	"seven_day_opus",
+	"seven_day_sonnet"
+];
+function record$9(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+/** Utilization is documented as 0-100; clamp so a server glitch cannot render
+*  a bar wider than its track or a negative width. */
+function utilization(value) {
+	return typeof value === "number" && Number.isFinite(value) ? Math.min(100, Math.max(0, value)) : void 0;
+}
+function resetsAt(value) {
+	return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function window(id, source, label) {
+	const entry = record$9(source);
+	if (entry === void 0) return void 0;
+	const used = utilization(entry.utilization);
+	const reset = resetsAt(entry.resets_at);
+	if (used === void 0 && reset === void 0) return void 0;
+	return {
+		id,
+		...label === void 0 ? {} : { label },
+		...used === void 0 ? {} : { utilization: used },
+		...reset === void 0 ? {} : { resetsAt: reset }
+	};
+}
+/** Project the SDK's `/usage` response onto the windows the settings card shows. */
+function normalizePlanUsage(value, fetchedAt) {
+	const response = record$9(value);
+	const subscription = typeof response?.subscription_type === "string" ? response.subscription_type : void 0;
+	const limits = record$9(response?.rate_limits);
+	if (response?.rate_limits_available !== true || limits === void 0) return {
+		available: false,
+		...subscription === void 0 ? {} : { subscription },
+		windows: [],
+		fetchedAt
+	};
+	const windows = [...FIXED_WINDOWS.map((id) => window(id, limits[id])), ...(Array.isArray(limits.model_scoped) ? limits.model_scoped : []).map((entry, index) => {
+		const name = record$9(entry)?.display_name;
+		return window(`model:${typeof name === "string" ? name : index}`, entry, typeof name === "string" ? name : void 0);
+	})].filter((entry) => entry !== void 0);
+	return {
+		available: windows.length > 0,
+		...subscription === void 0 ? {} : { subscription },
+		windows,
+		fetchedAt
+	};
+}
+/** Read plan limits from a throwaway Claude process.
+*
+*  Deliberately NOT routed through the supervisor. Borrowing a session's
+*  process fails outright while that session is mid-turn, and for a session
+*  with no process yet it would resume the whole conversation — and possibly
+*  evict another idle session to make room — just to read three numbers. This
+*  query carries no tools, no permission bridge, and no session binding: it
+*  starts, answers one control request, and is killed. */
+async function probePlanUsage(executablePath, fetchedAt, factory = query) {
+	const lifetime = new AbortController();
+	const timer = setTimeout(() => lifetime.abort(), PLAN_USAGE_TIMEOUT_MS);
+	timer.unref?.();
+	const query$1 = factory({
+		prompt: (async function* () {
+			await new Promise(() => {});
+		})(),
+		options: {
+			cwd: process.cwd(),
+			abortController: lifetime,
+			...executablePath.length === 0 ? {} : { pathToClaudeCodeExecutable: executablePath }
+		}
+	});
+	try {
+		(async () => {
+			for await (const _ of query$1);
+		})().catch(() => void 0);
+		return normalizePlanUsage(await readPlanUsageFrom(query$1), fetchedAt);
+	} finally {
+		clearTimeout(timer);
+		lifetime.abort();
+	}
+}
+let latest;
+function recordPlanUsage(report) {
+	latest = report;
+}
+function latestPlanUsage() {
+	return latest;
+}
+//#endregion
 //#region src/spawn.ts
 const CLAUDE_PROCESS_GRACE_MS = 2e3;
 const CLAUDE_STDERR_TAIL_BYTES = 32768;
@@ -1141,11 +1253,6 @@ const BACKGROUND_TASK_REPORT_PROMPT = [
 	"Report their final completed or failed outcomes concisely to the user.",
 	"Do not start new tools or tasks, and do not repeat the earlier progress update."
 ].join(" ");
-/** CLI ≥ 2.1.235 emits system/init only after its first stdin input, while
-*  the supervisor must see init before submitting any real turn. A local
-*  slash command nudges startup without costing a model call; its lifecycle
-*  messages are ignored because no DSH turn is active while they arrive. */
-const CLAUDE_HANDSHAKE_PROMPT = "/status";
 function usageSummary(usage) {
 	return `${usage.inputTokens ?? 0} input / ${usage.outputTokens ?? 0} output tokens${usage.cumulativeCostUsd === void 0 ? "" : ` · $${usage.cumulativeCostUsd.toFixed(4)} cumulative`}`;
 }
@@ -1210,6 +1317,12 @@ var ClaudeSupervisor = class {
 	contextWindow(model) {
 		return this.#contextWindows.get(model);
 	}
+	/** Raw `/usage` payload, read over a session's existing process. Only the
+	*  idle-time metadata bridge uses this; a user-triggered refresh runs
+	*  probePlanUsage instead so it never waits on, or perturbs, a session. */
+	planUsage(agent, model = this.#config.defaultModel) {
+		return this.#runMetadata(agent, model, (query) => readPlanUsageFrom(query));
+	}
 	runTurn(request) {
 		const interruption = this.#interruptions.get(request.agent.id);
 		if (interruption !== void 0) return interruption.then(() => this.runTurn(request));
@@ -1231,10 +1344,10 @@ var ClaudeSupervisor = class {
 			await this.#makeRoom();
 			entry = await this.#createEntry(request.agent, request.model ?? this.#config.defaultModel, request.thinkingMode);
 			this.#entries.set(sessionId, entry);
-			this.#armInitializationTimer(entry);
 		}
 		if (entry.ownerAgent !== request.agent) throw new Error(`dsh-claude: live agent identity changed for session ${sessionId}`);
 		if (entry.active !== void 0 || entry.state === "interrupting") throw new ClaudeTurnBusyError(sessionId);
+		await entry.sdkInitialization;
 		if (entry.idleTimer !== void 0) {
 			clearTimeout(entry.idleTimer);
 			entry.idleTimer = void 0;
@@ -1245,7 +1358,7 @@ var ClaudeSupervisor = class {
 			await this.#disposeEntry(entry);
 			entry = await this.#createEntry(request.agent, model, request.thinkingMode);
 			this.#entries.set(sessionId, entry);
-			this.#armInitializationTimer(entry);
+			await entry.sdkInitialization;
 		} else {
 			await this.#syncPermissionMode(entry);
 			if (model !== entry.model) {
@@ -1318,7 +1431,7 @@ var ClaudeSupervisor = class {
 			if (this.#disposed) throw new Error("dsh-claude: supervisor is disposed");
 			const entry = await this.#metadataEntry(agent, model);
 			try {
-				await withTimeout(this.#whenInitialized(entry), CLAUDE_INITIALIZATION_TIMEOUT_MS, "Claude metadata initialization");
+				await entry.sdkInitialization;
 				return await withTimeout(operation(entry.query, entry), CLAUDE_METADATA_TIMEOUT_MS, "Claude metadata request");
 			} finally {
 				entry.lastUsedAt = Date.now();
@@ -1328,13 +1441,6 @@ var ClaudeSupervisor = class {
 		this.#admissionGate = admitted.then(() => void 0, () => void 0);
 		return admitted;
 	}
-	#whenInitialized(entry) {
-		if (entry.initialized) return Promise.resolve();
-		if (entry.state === "disposed" || entry.state === "disconnected" || entry.state === "outcome-unknown") return Promise.reject(/* @__PURE__ */ new Error(`dsh-claude: session ${entry.sessionId} is ${entry.state}`));
-		return new Promise((resolve, reject) => {
-			entry.initWaiters.push((error) => error === void 0 ? resolve() : reject(error instanceof Error ? error : new Error(String(error))));
-		});
-	}
 	async #metadataEntry(agent, model) {
 		const sessionId = agent.id;
 		let entry = this.#entries.get(sessionId);
@@ -1347,7 +1453,6 @@ var ClaudeSupervisor = class {
 			await this.#makeRoom();
 			entry = await this.#createEntry(agent, model);
 			this.#entries.set(sessionId, entry);
-			this.#armInitializationTimer(entry);
 		}
 		if (entry.ownerAgent !== agent) throw new Error(`dsh-claude: live agent identity changed for session ${sessionId}`);
 		if (entry.active !== void 0 || entry.state === "interrupting") throw new ClaudeTurnBusyError(sessionId);
@@ -1408,11 +1513,7 @@ var ClaudeSupervisor = class {
 			lifetime,
 			claudeSessionId: binding?.claudeSessionId,
 			expectedResume: binding?.claudeSessionId,
-			handshakeUuid: randomUUID(),
-			handshakePending: true,
 			initialized: false,
-			initWaiters: [],
-			initTimer: void 0,
 			idleTimer: void 0,
 			tasks: /* @__PURE__ */ new Map(),
 			taskSnapshotAt: 0,
@@ -1470,8 +1571,11 @@ var ClaudeSupervisor = class {
 			prompt: input,
 			options
 		});
-		entry.input.push(sdkUserMessage(CLAUDE_HANDSHAKE_PROMPT, entry.handshakeUuid));
 		entry.pump = this.#runDetached(() => this.#pump(entry));
+		entry.sdkInitialization = withTimeout(entry.query.initializationResult(), CLAUDE_INITIALIZATION_TIMEOUT_MS, "Claude SDK initialization").then(() => {
+			if (entry.state === "starting") entry.state = "idle";
+		});
+		entry.sdkInitialization.catch((error) => this.#handleDisconnect(entry, error));
 		return entry;
 	}
 	async #pump(entry) {
@@ -1487,14 +1591,9 @@ var ClaudeSupervisor = class {
 			const firstInitialization = !entry.initialized;
 			if (entry.expectedResume !== void 0 && message.sessionId !== entry.expectedResume) throw new ClaudeProtocolError(`Claude Code resumed unexpected session ${message.sessionId}; expected ${entry.expectedResume}`);
 			if (message.cwd !== entry.cwd) throw new ClaudeProtocolError(`Claude Code initialized in unexpected cwd ${message.cwd}; expected ${entry.cwd}`);
-			if (entry.initTimer !== void 0) {
-				clearTimeout(entry.initTimer);
-				entry.initTimer = void 0;
-			}
 			entry.initialized = true;
 			entry.claudeSessionId = message.sessionId;
 			entry.state = entry.active === void 0 ? "idle" : "running";
-			for (const waiter of entry.initWaiters.splice(0)) waiter(void 0);
 			if (firstInitialization && entry.tasks.size > 0) {
 				entry.tasks.clear();
 				await this.#flushTasksSnapshot(entry);
@@ -1509,15 +1608,9 @@ var ClaudeSupervisor = class {
 		const taskId = message.kind === "subagent" ? message.taskId : void 0;
 		if (message.kind === "subagent" && taskId !== void 0) await this.#trackTask(entry, message, taskId, entry.active?.cursor.turn);
 		else if (message.kind === "background-tasks") await this.#trackBackgroundLevel(entry, message.tasks, entry.active?.cursor.turn);
-		if (entry.handshakePending) {
-			if (message.kind === "protocol-error") throw new ClaudeProtocolError(`${message.title}: ${JSON.stringify(message.detail).slice(0, 1e3)}`);
-			if (message.kind === "result") entry.handshakePending = false;
-			return;
-		}
 		const active = entry.active;
 		if (active === void 0) return;
 		if (message.kind === "result") {
-			if (message.userMessageUuid !== void 0 && message.userMessageUuid === entry.handshakeUuid) return;
 			if (entry.claudeSessionId === void 0) throw new ClaudeProtocolError("Claude Code sent a result before initialization");
 			if (message.sessionId !== entry.claudeSessionId) throw new ClaudeProtocolError(`Claude Code result session ${message.sessionId} does not match ${entry.claudeSessionId}`);
 			if (active.phase === "waiting-tasks") {
@@ -1957,20 +2050,9 @@ var ClaudeSupervisor = class {
 			active.output.fail(failure);
 			entry.active = void 0;
 		} else entry.state = "disconnected";
-		const waiters = entry.initWaiters.splice(0);
-		const waiterError = error instanceof Error ? error : new Error(String(error));
-		for (const waiter of waiters) waiter(waiterError);
 		this.#entries.delete(entry.sessionId);
 		await this.#disposeEntry(entry);
 	}
-	#armInitializationTimer(entry) {
-		const timer = setTimeout(() => {
-			if (entry.state !== "starting" || entry.initialized) return;
-			this.#handleDisconnect(entry, /* @__PURE__ */ new Error("Claude Code initialization timed out"));
-		}, CLAUDE_INITIALIZATION_TIMEOUT_MS);
-		timer.unref?.();
-		entry.initTimer = timer;
-	}
 	#armIdleTimer(entry) {
 		if (this.#config.idleTimeoutMs <= 0) return;
 		const timer = setTimeout(() => {
@@ -1984,7 +2066,6 @@ var ClaudeSupervisor = class {
 	async #disposeEntry(entry) {
 		if (entry.state === "disposed") return;
 		if (entry.idleTimer !== void 0) clearTimeout(entry.idleTimer);
-		if (entry.initTimer !== void 0) clearTimeout(entry.initTimer);
 		entry.state = "disposed";
 		entry.input.discard(abortFailure());
 		entry.query.close();
@@ -2000,7 +2081,7 @@ var ClaudeSupervisor = class {
 //#region src/review-comments.ts
 const MAX_COMMENTS_PER_SESSION = 50;
 const MAX_TEXT_CHARS$1 = 2e3;
-const MAX_PATH_CHARS$2 = 1024;
+const MAX_PATH_CHARS$3 = 1024;
 const MAX_LINE = 1e7;
 var ReviewCommentError = class extends Error {
 	code;
@@ -2019,16 +2100,19 @@ var ReviewCommentStore = class {
 	add(sessionId, input) {
 		const path = typeof input.path === "string" ? input.path.trim() : "";
 		const text = typeof input.text === "string" ? input.text.trim() : "";
-		if (path.length === 0 || path.length > MAX_PATH_CHARS$2 || /[\0\r\n]/u.test(path)) throw new ReviewCommentError("invalid-request", "The comment path is invalid.");
+		if (path.length === 0 || path.length > MAX_PATH_CHARS$3 || /[\0\r\n]/u.test(path)) throw new ReviewCommentError("invalid-request", "The comment path is invalid.");
 		if (text.length === 0 || text.length > MAX_TEXT_CHARS$1 || text.includes("\0")) throw new ReviewCommentError("invalid-request", "The comment text is invalid.");
 		if (typeof input.line !== "number" || !Number.isSafeInteger(input.line) || input.line < 1 || input.line > MAX_LINE) throw new ReviewCommentError("invalid-request", "The comment line is invalid.");
 		if (!validSide(input.side)) throw new ReviewCommentError("invalid-request", "The comment side is invalid.");
+		const startLine = input.startLine === void 0 || input.startLine === null ? void 0 : input.startLine;
+		if (startLine !== void 0 && (typeof startLine !== "number" || !Number.isSafeInteger(startLine) || startLine < 1 || startLine > input.line)) throw new ReviewCommentError("invalid-request", "The comment start line is invalid.");
 		const existing = this.#comments.get(sessionId) ?? [];
 		if (existing.length >= MAX_COMMENTS_PER_SESSION) throw new ReviewCommentError("too-many-comments", "Too many pending review comments. Remove one before adding another.");
 		const comment = {
 			id: randomUUID(),
 			path,
 			line: input.line,
+			...startLine === void 0 || startLine === input.line ? {} : { startLine },
 			side: input.side,
 			text
 		};
@@ -2064,8 +2148,8 @@ var ReviewCommentStore = class {
 function formatReviewComments(comments) {
 	return [
 		"<user-review-comments>",
-		"The user attached these code review comments to this message. Each references a file and line from the current working tree diff:",
-		...comments.map((comment, index) => `${index + 1}. ${comment.path}:${comment.line}${comment.side === "old" ? " (old side)" : ""} — ${comment.text}`),
+		"The user attached these code review comments to this message. Each references a file and line (or line range) from the current working tree diff:",
+		...comments.map((comment, index) => `${index + 1}. ${comment.path}:${comment.startLine === void 0 ? comment.line : `${comment.startLine}-${comment.line}`}${comment.side === "old" ? " (old side)" : ""} — ${comment.text}`),
 		"</user-review-comments>"
 	].join("\n");
 }
@@ -2418,7 +2502,7 @@ function json(res, status, value) {
 //#region src/doctor-routes.ts
 const CLAUDE_DOCTOR_PROBE_TIMEOUT_MS = 15e3;
 const claudeBridgeDiagnostics = /* @__PURE__ */ new WeakMap();
-function safeMessage$1(error) {
+function safeMessage$2(error) {
 	return redactText(error instanceof Error ? error.message : String(error), 1e3);
 }
 /** Live command-bridge diagnostics: which agents exist, their presets, and how
@@ -2434,14 +2518,14 @@ function commandDiagnostics(ctx) {
 					const preset = ctx.agentPresets.composedPreset(agent.ctx);
 					if (preset !== void 0) info.preset = preset;
 				} catch (error) {
-					info.error = safeMessage$1(error);
+					info.error = safeMessage$2(error);
 				}
 				try {
 					const list = ctx.commands.list(agent);
 					info.commandCount = list.length;
 					info.sample = list.slice(0, 10).map((command) => command.name);
 				} catch (error) {
-					info.error = info.error === void 0 ? safeMessage$1(error) : `${info.error}; ${safeMessage$1(error)}`;
+					info.error = info.error === void 0 ? safeMessage$2(error) : `${info.error}; ${safeMessage$2(error)}`;
 				}
 				const bridge = claudeBridgeDiagnostics.get(agent);
 				if (bridge !== void 0) info.bridge = bridge;
@@ -2449,7 +2533,7 @@ function commandDiagnostics(ctx) {
 			})
 		};
 	} catch (error) {
-		return { error: safeMessage$1(error) };
+		return { error: safeMessage$2(error) };
 	}
 }
 function registerClaudeDoctorRoutes(ctx, runtime, supervisor, config, resolutionError) {
@@ -2473,7 +2557,7 @@ function registerClaudeDoctorRoutes(ctx, runtime, supervisor, config, resolution
 					version: { status: "not-run" },
 					authentication: { status: "not-run" },
 					handshake: "not-run",
-					message: safeMessage$1(resolutionError),
+					message: safeMessage$2(resolutionError),
 					limits: {
 						idleTimeoutMs: config.idleTimeoutMs,
 						maxProcesses: config.maxProcesses
@@ -2503,14 +2587,14 @@ function registerClaudeDoctorRoutes(ctx, runtime, supervisor, config, resolution
 					commandBridge: commandDiagnostics(ctx)
 				});
 			} catch (error) {
-				json(res, 500, { error: safeMessage$1(error) });
+				json(res, 500, { error: safeMessage$2(error) });
 			}
 		}
 	}), "dsh-claude: Doctor route");
 }
 //#endregion
 //#region src/projection-routes.ts
-const MAX_SESSION_ID_CHARS$3 = 1024;
+const MAX_SESSION_ID_CHARS$4 = 1024;
 /** Slow-moving metadata refresh and stream heartbeat cadence; deliberately off
 *  the transcript hot path so git/gh latency never delays visible text. */
 const META_REFRESH_MS = 5e3;
@@ -2524,7 +2608,7 @@ function targetFromUrl(rawUrl) {
 		if (stream) encoded = encoded.slice(0, -7);
 		if (encoded.length === 0 || encoded.includes("/")) return void 0;
 		const sessionId = decodeURIComponent(encoded);
-		if (sessionId.length === 0 || sessionId.length > MAX_SESSION_ID_CHARS$3) return void 0;
+		if (sessionId.length === 0 || sessionId.length > MAX_SESSION_ID_CHARS$4) return void 0;
 		return {
 			sessionId,
 			stream
@@ -2686,6 +2770,7 @@ function registerClaudeProjectionRoute(ctx, sidecar, ownsSession, commandsForSes
 //#region src/repository-status.ts
 const MAX_OUTPUT_BYTES$3 = 65536;
 const MAX_DIFF_BYTES = 262144;
+const MAX_FILE_BYTES = 8388608;
 const MAX_UNTRACKED_DIFFS = 50;
 const GIT_TIMEOUT_MS$3 = 5e3;
 const GH_TIMEOUT_MS$1 = 8e3;
@@ -2781,14 +2866,14 @@ function parseGitHubRemote(value) {
 	if (match?.[1] === void 0 || match[2] === void 0) return void 0;
 	return `${match[1]}/${match[2]}`;
 }
-function record$6(value) {
+function record$8(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
 function aggregateChecks(value) {
 	if (!Array.isArray(value) || value.length === 0) return "none";
 	let pending = false;
 	for (const item of value) {
-		const check = record$6(item);
+		const check = record$8(item);
 		if (check === void 0) continue;
 		const conclusion = typeof check.conclusion === "string" ? check.conclusion.toUpperCase() : void 0;
 		const status = typeof check.status === "string" ? check.status.toUpperCase() : void 0;
@@ -2812,7 +2897,7 @@ function reviewState(value) {
 	return "none";
 }
 function parsePullRequest(value) {
-	const input = record$6(value);
+	const input = record$8(value);
 	if (input === void 0 || !Number.isSafeInteger(input.number) || Number(input.number) <= 0 || typeof input.title !== "string" || typeof input.url !== "string") return void 0;
 	let url;
 	try {
@@ -2833,12 +2918,20 @@ function parsePullRequest(value) {
 		review: reviewState(input.reviewDecision),
 		checks: aggregateChecks(input.statusCheckRollup),
 		...typeof input.mergeStateStatus === "string" ? { mergeState: bounded(input.mergeStateStatus) } : {},
-		...typeof record$6(input.author)?.login === "string" ? { author: bounded(String(record$6(input.author)?.login)) } : {},
+		...typeof record$8(input.author)?.login === "string" ? { author: bounded(String(record$8(input.author)?.login)) } : {},
 		...typeof input.createdAt === "string" && Number.isFinite(Date.parse(input.createdAt)) ? { createdAt: new Date(input.createdAt).toISOString() } : {},
 		...typeof input.mergedAt === "string" && Number.isFinite(Date.parse(input.mergedAt)) ? { mergedAt: new Date(input.mergedAt).toISOString() } : {},
 		...typeof input.baseRefName === "string" && bounded(input.baseRefName).length > 0 ? { baseBranch: bounded(input.baseRefName) } : {}
 	};
 }
+var RepositoryFileError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "RepositoryFileError";
+		this.code = code;
+	}
+};
 var RepositoryStatusService = class {
 	#runtime;
 	#cacheTtlMs;
@@ -2880,6 +2973,29 @@ var RepositoryStatusService = class {
 		this.#lastReady.set(cwd, stable);
 		return stable;
 	}
+	/** Lines [from, to] of a working-tree file, used to expand unmodified context around diff hunks. */
+	async fileLines(cwd, relativePath, from, to) {
+		if (relativePath.length === 0 || isAbsolute(relativePath) || relativePath.includes("\0") || relativePath.split(/[\\/]/u).includes("..")) throw new RepositoryFileError("invalid-request", "The file path must be relative to the repository.");
+		if (!Number.isSafeInteger(from) || !Number.isSafeInteger(to) || from < 1 || to < from || to - from >= 500) throw new RepositoryFileError("invalid-request", "The requested line range is invalid.");
+		const git = await this.#git();
+		const top = await run(this.#runtime, git, [
+			"rev-parse",
+			"--path-format=absolute",
+			"--show-toplevel"
+		], cwd, GIT_TIMEOUT_MS$3);
+		if (top.exitCode !== 0) throw new RepositoryFileError("not-repository", "The directory is not inside a git repository.");
+		const root = resolve(top.stdout.trim());
+		const target = resolve(root, relativePath);
+		if (target !== root && !target.startsWith(root + sep)) throw new RepositoryFileError("invalid-request", "The file path escapes the repository.");
+		const content = await readFile(target, "utf8");
+		if (content.length > MAX_FILE_BYTES) throw new RepositoryFileError("too-large", "The file is too large to expand.");
+		const all = content.split(/\r?\n/u);
+		if (all.at(-1) === "") all.pop();
+		return {
+			lines: all.slice(from - 1, to),
+			total: all.length
+		};
+	}
 	async #git() {
 		this.#gitExecutable ??= this.#runtime.resolveExecutable("git");
 		return this.#gitExecutable;
@@ -3099,7 +3215,7 @@ var RepositoryStatusService = class {
 const MAX_OUTPUT_BYTES$2 = 131072;
 const GIT_TIMEOUT_MS$2 = 1e4;
 const GIT_FETCH_TIMEOUT_MS = 6e4;
-const MAX_PATH_CHARS$1 = 4096;
+const MAX_PATH_CHARS$2 = 4096;
 const MAX_BRANCH_CHARS = 512;
 const LEASE_SCHEMA_VERSION = 1;
 const CLEANUP_GRACE_MS = 12e4;
@@ -3123,7 +3239,7 @@ async function collect$2(handle) {
 	};
 }
 function safePath(value) {
-	if (value.length === 0 || value.length > MAX_PATH_CHARS$1 || !isAbsolute(value) || value.includes("\0")) throw new RepositorySetupError("invalid-path", "The workspace path is invalid.");
+	if (value.length === 0 || value.length > MAX_PATH_CHARS$2 || !isAbsolute(value) || value.includes("\0")) throw new RepositorySetupError("invalid-path", "The workspace path is invalid.");
 	return resolve(value);
 }
 function safeBranch(value) {
@@ -3508,7 +3624,10 @@ var RepositorySetupService = class {
 		return resolve(root);
 	}
 	#git() {
-		this.#gitPath ??= this.#runtime.resolveExecutable("git");
+		this.#gitPath ??= this.#runtime.resolveExecutable("git", void 0, AbortSignal.timeout(GIT_TIMEOUT_MS$2)).catch((error) => {
+			this.#gitPath = void 0;
+			throw error;
+		});
 		return this.#gitPath;
 	}
 	async #run(executable, args, cwd, timeoutMs = GIT_TIMEOUT_MS$2) {
@@ -4000,20 +4119,20 @@ var RepositoryActionService = class {
 };
 //#endregion
 //#region src/repository-setup-routes.ts
-const MAX_BODY_BYTES$3 = 16384;
-function record$5(value) {
+const MAX_BODY_BYTES$4 = 16384;
+function record$7(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
-async function readJson$3(req) {
+async function readJson$4(req) {
 	const chunks = [];
 	let size = 0;
 	for await (const chunk of req) {
 		const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
 		size += buffer.length;
-		if (size > MAX_BODY_BYTES$3) throw new RepositorySetupError("body-too-large", "The request body is too large.");
+		if (size > MAX_BODY_BYTES$4) throw new RepositorySetupError("body-too-large", "The request body is too large.");
 		chunks.push(buffer);
 	}
-	const value = record$5(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+	const value = record$7(JSON.parse(Buffer.concat(chunks).toString("utf8")));
 	if (value === void 0) throw new RepositorySetupError("invalid-request", "The request body is invalid.");
 	return value;
 }
@@ -4036,17 +4155,17 @@ function ndjsonHeaders(res) {
 	});
 	res.flushHeaders?.();
 }
-function ndjson(res, value) {
+function ndjson$1(res, value) {
 	res.write(`${JSON.stringify(value)}\n`);
 }
 async function streamSetup(res, service, input) {
 	ndjsonHeaders(res);
 	let ended = false;
 	try {
-		ndjson(res, {
+		ndjson$1(res, {
 			type: "complete",
 			result: await service.setup(string$2(input, "cwd"), string$2(input, "branch"), input.worktree, optionalString$1(input, "branchName"), (stage) => {
-				if (!ended) ndjson(res, {
+				if (!ended) ndjson$1(res, {
 					type: "progress",
 					stage
 				});
@@ -4054,7 +4173,7 @@ async function streamSetup(res, service, input) {
 		});
 	} catch (error) {
 		const setupError = error instanceof RepositorySetupError ? error : void 0;
-		ndjson(res, {
+		ndjson$1(res, {
 			type: "error",
 			code: setupError?.code ?? "repository-setup-unavailable",
 			message: setupError?.message ?? "Repository setup is unavailable."
@@ -4081,19 +4200,19 @@ function registerRepositorySetupRoute(ctx, service) {
 				}
 				if (pathname === "/plugins/dsh-claude/repository/setup") {
 					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
-					const input = await readJson$3(req);
+					const input = await readJson$4(req);
 					if (typeof input.worktree !== "boolean") throw new RepositorySetupError("invalid-request", "The worktree field is required.");
 					await streamSetup(res, service, input);
 					return;
 				}
 				if (pathname === `/plugins/dsh-claude/repository/setup/cleanup`) {
 					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
-					const input = await readJson$3(req);
+					const input = await readJson$4(req);
 					return json(res, 200, await service.cleanupMerged(string$2(input, "path"), string$2(input, "baseBranch")));
 				}
 				if (pathname === `/plugins/dsh-claude/repository/setup/bind`) {
 					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
-					const input = await readJson$3(req);
+					const input = await readJson$4(req);
 					await service.bindLease(string$2(input, "leaseId"), string$2(input, "sessionId"));
 					return json(res, 200, { ok: true });
 				}
@@ -4111,8 +4230,8 @@ function registerRepositorySetupRoute(ctx, service) {
 }
 //#endregion
 //#region src/repository-action-routes.ts
-const MAX_BODY_BYTES$2 = 16384;
-const MAX_SESSION_ID_CHARS$2 = 1024;
+const MAX_BODY_BYTES$3 = 16384;
+const MAX_SESSION_ID_CHARS$3 = 1024;
 const ACTIONS = /* @__PURE__ */ new Set([
 	"commit",
 	"commit-push",
@@ -4121,25 +4240,25 @@ const ACTIONS = /* @__PURE__ */ new Set([
 	"merge-pr",
 	"update-branch"
 ]);
-function record$4(value) {
+function record$6(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
-async function readJson$2(req) {
+async function readJson$3(req) {
 	const chunks = [];
 	let size = 0;
 	for await (const chunk of req) {
 		const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
 		size += buffer.length;
-		if (size > MAX_BODY_BYTES$2) throw new RepositoryActionError("body-too-large", "The request body is too large.");
+		if (size > MAX_BODY_BYTES$3) throw new RepositoryActionError("body-too-large", "The request body is too large.");
 		chunks.push(buffer);
 	}
-	const value = record$4(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+	const value = record$6(JSON.parse(Buffer.concat(chunks).toString("utf8")));
 	if (value === void 0) throw new RepositoryActionError("invalid-request", "The request body is invalid.");
 	return value;
 }
 function sessionId$1(url) {
 	const value = url.searchParams.get("sessionId");
-	if (value === null || value.length === 0 || value.length > MAX_SESSION_ID_CHARS$2) throw new RepositoryActionError("invalid-session", "The session is invalid.");
+	if (value === null || value.length === 0 || value.length > MAX_SESSION_ID_CHARS$3) throw new RepositoryActionError("invalid-session", "The session is invalid.");
 	return value;
 }
 function string$1(input, key) {
@@ -4188,12 +4307,12 @@ function registerRepositoryActionRoute(ctx, service, cwdForSession) {
 				}
 				if (url.pathname === `/plugins/dsh-claude/repository/action/message`) {
 					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
-					const input = await readJson$2(req);
+					const input = await readJson$3(req);
 					return json(res, 200, { message: await service.generateMessage(cwd, string$1(input, "fingerprint")) });
 				}
 				if (url.pathname === "/plugins/dsh-claude/repository/action") {
 					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
-					return json(res, 200, await service.execute(cwd, actionRequest(await readJson$2(req))));
+					return json(res, 200, await service.execute(cwd, actionRequest(await readJson$3(req))));
 				}
 				return json(res, 404, { error: "not found" });
 			} catch (error) {
@@ -4237,14 +4356,14 @@ async function collect(handle) {
 		lossy: stdout?.lossy === true
 	};
 }
-function record$3(value) {
+function record$5(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
 function parseReviewComments(value) {
 	if (!Array.isArray(value)) return [];
 	const comments = [];
 	for (const item of value) {
-		const input = record$3(item);
+		const input = record$5(item);
 		if (input === void 0 || !Number.isSafeInteger(input.id)) continue;
 		const body = typeof input.body === "string" ? input.body.trim() : "";
 		const path = typeof input.path === "string" ? input.path : "";
@@ -4256,7 +4375,7 @@ function parseReviewComments(value) {
 			path,
 			...line === void 0 ? {} : { line },
 			side: input.side === "LEFT" ? "old" : "new",
-			author: typeof record$3(input.user)?.login === "string" ? String(record$3(input.user)?.login) : "unknown",
+			author: typeof record$5(input.user)?.login === "string" ? String(record$5(input.user)?.login) : "unknown",
 			body: body.slice(0, MAX_COMMENT_CHARS),
 			url
 		});
@@ -4273,7 +4392,7 @@ function parseFailingChecks(value) {
 	if (!Array.isArray(value)) return [];
 	const failing = [];
 	for (const item of value) {
-		const input = record$3(item);
+		const input = record$5(item);
 		if (input === void 0 || input.bucket !== "fail" || typeof input.name !== "string") continue;
 		failing.push({
 			name: input.name,
@@ -4385,10 +4504,10 @@ var PullRequestFeedbackService = class {
 };
 //#endregion
 //#region src/pr-feedback-routes.ts
-const MAX_SESSION_ID_CHARS$1 = 1024;
+const MAX_SESSION_ID_CHARS$2 = 1024;
 function sessionId(url) {
 	const value = url.searchParams.get("sessionId");
-	if (value === null || value.length === 0 || value.length > MAX_SESSION_ID_CHARS$1) throw new PullRequestFeedbackError("invalid-session", "The session is invalid.");
+	if (value === null || value.length === 0 || value.length > MAX_SESSION_ID_CHARS$2) throw new PullRequestFeedbackError("invalid-session", "The session is invalid.");
 	return value;
 }
 function pullNumber(url) {
@@ -4425,7 +4544,7 @@ function registerPullRequestFeedbackRoute(ctx, service, cwdForSession) {
 }
 //#endregion
 //#region src/repository-status-routes.ts
-const MAX_PATH_CHARS = 4096;
+const MAX_PATH_CHARS$1 = 4096;
 /** Read-only repository status for an arbitrary directory (the overview panel
 *  aggregates every Claude session's checkout through this). */
 function registerRepositoryStatusRoute(ctx, service) {
@@ -4436,7 +4555,7 @@ function registerRepositoryStatusRoute(ctx, service) {
 			if (!trustedRequest(req)) return json(res, 403, { error: "forbidden" });
 			if (req.method !== "GET") return json(res, 405, { error: "method not allowed" });
 			const cwd = new URL(req.url ?? "/", "http://localhost").searchParams.get("cwd");
-			if (cwd === null || cwd.length === 0 || cwd.length > MAX_PATH_CHARS || !isAbsolute(cwd) || cwd.includes("\0")) return json(res, 400, {
+			if (cwd === null || cwd.length === 0 || cwd.length > MAX_PATH_CHARS$1 || !isAbsolute(cwd) || cwd.includes("\0")) return json(res, 400, {
 				error: "invalid-request",
 				message: "The cwd query parameter is invalid."
 			});
@@ -4452,6 +4571,45 @@ function registerRepositoryStatusRoute(ctx, service) {
 	}), "dsh-claude: repository status route");
 }
 //#endregion
+//#region src/repository-file-routes.ts
+const MAX_PATH_CHARS = 4096;
+/** Read-only slice of a working-tree file so the diff panel can expand unmodified lines around hunks. */
+function registerRepositoryFileRoute(ctx, service) {
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: CLAUDE_REPOSITORY_FILE_PATH,
+		handler: async (req, res) => {
+			if (!trustedRequest(req)) return json(res, 403, { error: "forbidden" });
+			if (req.method !== "GET") return json(res, 405, { error: "method not allowed" });
+			const params = new URL(req.url ?? "/", "http://localhost").searchParams;
+			const cwd = params.get("cwd");
+			const path = params.get("path");
+			const from = Number(params.get("from"));
+			const to = Number(params.get("to"));
+			if (cwd === null || cwd.length === 0 || cwd.length > MAX_PATH_CHARS || !isAbsolute(cwd) || cwd.includes("\0")) return json(res, 400, {
+				error: "invalid-request",
+				message: "The cwd query parameter is invalid."
+			});
+			if (path === null || path.length === 0 || path.length > MAX_PATH_CHARS) return json(res, 400, {
+				error: "invalid-request",
+				message: "The path query parameter is invalid."
+			});
+			try {
+				return json(res, 200, await service.fileLines(cwd, path, from, to));
+			} catch (error) {
+				if (error instanceof RepositoryFileError) return json(res, error.code === "invalid-request" ? 400 : 409, {
+					error: error.code,
+					message: error.message
+				});
+				return json(res, 500, {
+					error: "repository-file-unavailable",
+					message: "The file could not be read."
+				});
+			}
+		}
+	}), "dsh-claude: repository file route");
+}
+//#endregion
 //#region src/jira.ts
 const REQUEST_TIMEOUT_MS = 15e3;
 const MAX_RESULTS = 20;
@@ -4465,7 +4623,7 @@ var JiraError = class extends Error {
 		this.code = code;
 	}
 };
-function record$2(value) {
+function record$4(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
 /** Jira Cloud sites are origins; Data Center may carry a context path. */
@@ -4491,15 +4649,15 @@ function buildJql(query) {
 	return `text ~ "${trimmed.replaceAll("\\", "\\\\").replaceAll("\"", "\\\"")}*" ORDER BY updated DESC`;
 }
 function parseTickets(value, siteUrl) {
-	const issues = record$2(value)?.issues;
+	const issues = record$4(value)?.issues;
 	if (!Array.isArray(issues)) return [];
 	const tickets = [];
 	for (const item of issues) {
-		const issue = record$2(item);
-		const fields = record$2(issue?.fields);
+		const issue = record$4(item);
+		const fields = record$4(issue?.fields);
 		if (issue === void 0 || typeof issue.key !== "string" || fields === void 0) continue;
-		const status = record$2(fields.status)?.name;
-		const type = record$2(fields.issuetype)?.name;
+		const status = record$4(fields.status)?.name;
+		const type = record$4(fields.issuetype)?.name;
 		tickets.push({
 			key: issue.key,
 			summary: typeof fields.summary === "string" ? fields.summary.slice(0, 256) : "",
@@ -4541,7 +4699,7 @@ var JiraService = class {
 			email,
 			apiToken
 		};
-		const myself = record$2(await this.#json(connection, "/rest/api/3/myself"));
+		const myself = record$4(await this.#json(connection, "/rest/api/3/myself"));
 		const displayName = typeof myself?.displayName === "string" ? myself.displayName : void 0;
 		const accountId = typeof myself?.accountId === "string" ? myself.accountId : void 0;
 		const store = {
@@ -4560,7 +4718,7 @@ var JiraService = class {
 		if (ticket === void 0) throw new JiraError("invalid-request", "The ticket key is invalid.");
 		let accountId = store.accountId;
 		if (accountId === void 0) {
-			const myself = record$2(await this.#json(store, "/rest/api/3/myself"));
+			const myself = record$4(await this.#json(store, "/rest/api/3/myself"));
 			if (typeof myself?.accountId !== "string") throw new JiraError("jira-failed", "The Jira account id is unavailable.");
 			accountId = myself.accountId;
 			await this.#write({
@@ -4628,7 +4786,7 @@ var JiraService = class {
 			throw error;
 		}
 		if (Buffer.byteLength(text) > MAX_STORE_BYTES) return void 0;
-		const input = record$2(JSON.parse(text));
+		const input = record$4(JSON.parse(text));
 		if (input === void 0 || typeof input.siteUrl !== "string" || typeof input.email !== "string" || typeof input.apiToken !== "string") return void 0;
 		return {
 			siteUrl: input.siteUrl,
@@ -4659,20 +4817,20 @@ var JiraService = class {
 };
 //#endregion
 //#region src/jira-routes.ts
-const MAX_BODY_BYTES$1 = 8192;
-function record$1(value) {
+const MAX_BODY_BYTES$2 = 8192;
+function record$3(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
-async function readJson$1(req) {
+async function readJson$2(req) {
 	const chunks = [];
 	let size = 0;
 	for await (const chunk of req) {
 		const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
 		size += buffer.length;
-		if (size > MAX_BODY_BYTES$1) throw new JiraError("body-too-large", "The request body is too large.");
+		if (size > MAX_BODY_BYTES$2) throw new JiraError("body-too-large", "The request body is too large.");
 		chunks.push(buffer);
 	}
-	const value = record$1(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+	const value = record$3(JSON.parse(Buffer.concat(chunks).toString("utf8")));
 	if (value === void 0) throw new JiraError("invalid-request", "The request body is invalid.");
 	return value;
 }
@@ -4695,7 +4853,7 @@ function registerJiraRoute(ctx, service) {
 				}
 				if (url.pathname === `/plugins/dsh-claude/jira/connect`) {
 					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
-					const input = await readJson$1(req);
+					const input = await readJson$2(req);
 					return json(res, 200, await service.connect({
 						siteUrl: string(input, "siteUrl"),
 						email: string(input, "email"),
@@ -4709,7 +4867,7 @@ function registerJiraRoute(ctx, service) {
 				}
 				if (url.pathname === `/plugins/dsh-claude/jira/assign`) {
 					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
-					const input = await readJson$1(req);
+					const input = await readJson$2(req);
 					await service.assignToMe(string(input, "key"));
 					return json(res, 200, { assigned: true });
 				}
@@ -4733,6 +4891,319 @@ function registerJiraRoute(ctx, service) {
 	}), "dsh-claude: jira route");
 }
 //#endregion
+//#region src/ask.ts
+const MAX_SELECTION_CHARS = 8e3;
+const MAX_CONTEXT_CHARS = 16e3;
+const MAX_QUESTION_CHARS = 2e3;
+const ASK_TIMEOUT_MS = 18e4;
+const MAX_STDERR_BYTES = 65536;
+const MAX_TOOL_SUMMARY_CHARS = 160;
+const READ_ONLY_TOOLS = [
+	"Read",
+	"Grep",
+	"Glob"
+];
+var AskError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "AskError";
+		this.code = code;
+	}
+};
+function fence(value) {
+	return `"""\n${value.replaceAll("\"\"\"", "\" \" \"")}\n"""`;
+}
+function askPrompt(request) {
+	const selection = request.selection.trim().slice(0, MAX_SELECTION_CHARS);
+	const context = (request.context ?? "").trim().slice(0, MAX_CONTEXT_CHARS);
+	const question = request.question.trim().slice(0, MAX_QUESTION_CHARS);
+	return [
+		"You are answering a follow-up question about part of an earlier assistant reply in this project.",
+		"",
+		"Selected passage:",
+		fence(selection),
+		...context.length === 0 || context === selection ? [] : [
+			"",
+			"Surrounding reply, for context only:",
+			fence(context)
+		],
+		"",
+		`Question: ${question}`,
+		"",
+		"Answer the question directly and concisely, in the same language as the question. Use Markdown.",
+		"Only the read-only tools Read, Grep, and Glob are available; use them when the answer depends on project code, otherwise answer from the passage."
+	].join("\n");
+}
+/** CLI effort for a session thinking mode; `off` and unknown modes send nothing. */
+function effortFor(thinkingMode) {
+	if (thinkingMode === void 0 || thinkingMode === "off") return void 0;
+	if (thinkingMode === "ultracode") return "max";
+	return [
+		"low",
+		"medium",
+		"high",
+		"max"
+	].includes(thinkingMode) ? thinkingMode : void 0;
+}
+function askArguments(preferences) {
+	const effort = effortFor(preferences.thinkingMode);
+	return [
+		"-p",
+		"--output-format",
+		"stream-json",
+		"--verbose",
+		"--include-partial-messages",
+		"--strict-mcp-config",
+		"--mcp-config",
+		"{\"mcpServers\":{}}",
+		...preferences.model === void 0 || preferences.model === "default" ? [] : ["--model", preferences.model],
+		...effort === void 0 ? [] : ["--effort", effort],
+		"--tools",
+		...READ_ONLY_TOOLS,
+		"--allowedTools",
+		...READ_ONLY_TOOLS
+	];
+}
+function record$2(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+/** One-line description of a tool call, mirroring the main window's step titles. */
+function toolSummary(input) {
+	const fields = record$2(input);
+	if (fields === void 0) return void 0;
+	const candidate = [
+		fields.command,
+		fields.pattern,
+		fields.file_path,
+		fields.path,
+		fields.query
+	].find((value) => typeof value === "string" && value.length > 0);
+	return (typeof candidate === "string" ? candidate : JSON.stringify(fields)).replaceAll(/\s+/gu, " ").trim().slice(0, MAX_TOOL_SUMMARY_CHARS);
+}
+function eventsOfStreamLine(line) {
+	let parsed;
+	try {
+		parsed = record$2(JSON.parse(line));
+	} catch {
+		return [];
+	}
+	if (parsed === void 0) return [];
+	if (parsed.type === "system" && parsed.subtype === "init") return [{
+		type: "status",
+		text: "ready"
+	}];
+	if (parsed.type === "stream_event") {
+		const event = record$2(parsed.event);
+		if (event?.type === "content_block_start") {
+			const block = record$2(event.content_block);
+			if (block?.type === "tool_use" && typeof block.id === "string" && typeof block.name === "string") return [{
+				type: "tool",
+				id: block.id,
+				phase: "start",
+				name: block.name
+			}];
+			return [];
+		}
+		const delta = record$2(event?.delta);
+		if (event?.type !== "content_block_delta" || delta === void 0) return [];
+		if (delta.type === "text_delta" && typeof delta.text === "string") return [{
+			type: "text",
+			text: delta.text
+		}];
+		if (delta.type === "thinking_delta" && typeof delta.thinking === "string") return [{
+			type: "thinking",
+			text: delta.thinking
+		}];
+		return [];
+	}
+	if (parsed.type === "assistant" || parsed.type === "user") {
+		const content = record$2(parsed.message)?.content;
+		if (!Array.isArray(content)) return [];
+		const events = [];
+		for (const item of content) {
+			const block = record$2(item);
+			if (block?.type === "tool_use" && typeof block.id === "string" && typeof block.name === "string") {
+				const summary = toolSummary(block.input);
+				events.push({
+					type: "tool",
+					id: block.id,
+					phase: "input",
+					name: block.name,
+					...summary === void 0 ? {} : { summary }
+				});
+			} else if (block?.type === "tool_result" && typeof block.tool_use_id === "string") events.push({
+				type: "tool",
+				id: block.tool_use_id,
+				phase: "done",
+				...block.is_error === true ? { error: true } : {}
+			});
+		}
+		return events;
+	}
+	if (parsed.type === "result" && typeof parsed.result === "string") return [{
+		type: "result",
+		text: parsed.result
+	}];
+	return [];
+}
+/** One-shot Claude Code query answering a question about selected reply text. */
+var AskService = class {
+	#runtime;
+	#executablePath;
+	constructor(runtime, executablePath) {
+		this.#runtime = runtime;
+		this.#executablePath = executablePath;
+	}
+	async ask(cwd, request, preferences, onEvent, signal) {
+		if (request.question.trim().length === 0 || request.selection.trim().length === 0) throw new AskError("invalid-request", "A selection and a question are required.");
+		if (this.#executablePath.length === 0) throw new AskError("claude-unavailable", "Claude Code is unavailable.");
+		const timeout = AbortSignal.timeout(ASK_TIMEOUT_MS);
+		const handle = this.#runtime.spawn({
+			argv: [this.#executablePath, ...askArguments(preferences)],
+			cwd,
+			stdio: {
+				stdin: { data: askPrompt(request) },
+				stdout: "pipe",
+				stderr: { maxBytes: MAX_STDERR_BYTES }
+			},
+			graceMs: 1e3,
+			signal: signal === void 0 ? timeout : AbortSignal.any([signal, timeout]),
+			env: {}
+		});
+		const stdout = handle.stdout;
+		if (stdout === void 0) throw new AskError("ask-failed", "Claude output is unavailable.");
+		const decoder = new StringDecoder("utf8");
+		let buffer = "";
+		let emitted = false;
+		let result;
+		const consume = (line) => {
+			for (const event of eventsOfStreamLine(line)) {
+				if (event.type === "result") {
+					result = event.text;
+					continue;
+				}
+				if (event.type !== "tool" && event.text.length === 0) continue;
+				if (event.type === "text") emitted = true;
+				onEvent(event);
+			}
+		};
+		for await (const chunk of stdout) {
+			buffer += typeof chunk === "string" ? chunk : decoder.write(chunk);
+			const lines = buffer.split("\n");
+			buffer = lines.pop() ?? "";
+			for (const line of lines) if (line.trim().length > 0) consume(line);
+		}
+		buffer += decoder.end();
+		if (buffer.trim().length > 0) consume(buffer);
+		const outcome = await handle.done;
+		if (!emitted && result !== void 0 && result.length > 0) {
+			emitted = true;
+			onEvent({
+				type: "text",
+				text: result
+			});
+		}
+		if (!emitted) {
+			if (signal?.aborted === true) throw new AskError("aborted", "The question was cancelled.");
+			if (timeout.aborted) throw new AskError("timeout", "Claude took too long to answer.");
+			const stderr = handle.collected.stderr?.readFrom(0).text.trim().split(/\r?\n/u).filter((line) => line.length > 0).at(-1);
+			throw new AskError("ask-failed", stderr !== void 0 && stderr.length > 0 ? stderr : `Claude exited with code ${String(outcome.exitCode)}.`);
+		}
+	}
+};
+//#endregion
+//#region src/ask-routes.ts
+const MAX_BODY_BYTES$1 = 131072;
+const MAX_SESSION_ID_CHARS$1 = 1024;
+function record$1(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+async function readJson$1(req) {
+	const chunks = [];
+	let size = 0;
+	for await (const chunk of req) {
+		const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+		size += buffer.length;
+		if (size > MAX_BODY_BYTES$1) throw new AskError("body-too-large", "The request body is too large.");
+		chunks.push(buffer);
+	}
+	const value = record$1(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+	if (value === void 0) throw new AskError("invalid-request", "The request body is invalid.");
+	return value;
+}
+function askRequest(input) {
+	if (typeof input.selection !== "string" || typeof input.question !== "string" || input.context !== void 0 && typeof input.context !== "string") throw new AskError("invalid-request", "The selection and question fields are required.");
+	return {
+		selection: input.selection,
+		question: input.question,
+		...typeof input.context === "string" ? { context: input.context } : {}
+	};
+}
+function ndjson(res, value) {
+	res.write(`${JSON.stringify(value)}\n`);
+}
+function registerAskRoute(ctx, service, cwdForSession, preferencesFor) {
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: CLAUDE_ASK_PATH,
+		handler: async (req, res) => {
+			if (!trustedRequest(req)) return json(res, 403, { error: "forbidden" });
+			if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
+			const url = new URL(req.url ?? "/", "http://localhost");
+			let cwd;
+			let request;
+			let sessionId;
+			try {
+				const value = url.searchParams.get("sessionId");
+				if (value === null || value.length === 0 || value.length > MAX_SESSION_ID_CHARS$1) throw new AskError("invalid-session", "The session is invalid.");
+				sessionId = value;
+				const resolved = cwdForSession(sessionId);
+				if (resolved === void 0) throw new AskError("session-unavailable", "The Claude session is unavailable.");
+				cwd = resolved;
+				request = askRequest(await readJson$1(req));
+			} catch (error) {
+				if (error instanceof AskError) return json(res, 409, {
+					error: error.code,
+					message: error.message
+				});
+				if (error instanceof SyntaxError) return json(res, 400, { error: "invalid-json" });
+				return json(res, 500, {
+					error: "ask-unavailable",
+					message: "The question could not be sent."
+				});
+			}
+			res.writeHead(200, {
+				"content-type": "application/x-ndjson; charset=utf-8",
+				"cache-control": "no-store",
+				"x-content-type-options": "nosniff"
+			});
+			res.flushHeaders?.();
+			const controller = new AbortController();
+			req.on("close", () => {
+				controller.abort();
+			});
+			try {
+				await service.ask(cwd, request, preferencesFor(sessionId) ?? {}, (event) => {
+					ndjson(res, event.type === "text" ? {
+						type: "delta",
+						text: event.text
+					} : event);
+				}, controller.signal);
+				ndjson(res, { type: "done" });
+			} catch (error) {
+				ndjson(res, {
+					type: "error",
+					code: error instanceof AskError ? error.code : "ask-unavailable",
+					message: error instanceof AskError ? error.message : "The question could not be answered."
+				});
+			} finally {
+				res.end();
+			}
+		}
+	}), "dsh-claude: ask route");
+}
+//#endregion
 //#region src/review-comment-routes.ts
 const MAX_BODY_BYTES = 16384;
 const MAX_SESSION_ID_CHARS = 1024;
@@ -4772,6 +5243,7 @@ function registerReviewCommentRoute(ctx, store, ownsSession) {
 					return json(res, 200, { comment: store.add(sessionId, {
 						path: input.path,
 						line: input.line,
+						startLine: input.startLine,
 						side: input.side,
 						text: input.text
 					}) });
@@ -4806,7 +5278,7 @@ const MAX_MANIFEST_BYTES = 262144;
 const MAX_UPDATE_OUTPUT_BYTES = 32768;
 const SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
 const PROFILE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
-function safeMessage(error) {
+function safeMessage$1(error) {
 	return redactText(error instanceof Error ? error.message : String(error), 500);
 }
 async function readManifest(path) {
@@ -4968,7 +5440,7 @@ async function checkPluginUpdate(deps = {}) {
 			state: "error",
 			canUpdate: false,
 			restartRequired: false,
-			message: safeMessage(error)
+			message: safeMessage$1(error)
 		};
 	}
 }
@@ -5015,7 +5487,7 @@ async function updatePlugin(deps = {}) {
 	const outcome = await handle.done;
 	if (outcome.exitCode !== 0) {
 		const detail = handle.collected.stderr?.readFrom(0).text ?? "";
-		throw new Error(`DSH plugin update failed (${outcome.exitCode ?? outcome.signal ?? "unknown exit"}): ${safeMessage(detail)}`);
+		throw new Error(`DSH plugin update failed (${outcome.exitCode ?? outcome.signal ?? "unknown exit"}): ${safeMessage$1(detail)}`);
 	}
 	await verifyInstalledVersion(installation, latest);
 	if (deps.requestRestart !== void 0) setTimeout(() => deps.requestRestart?.(), 100).unref?.();
@@ -5052,12 +5524,44 @@ function registerClaudeUpdateRoutes(ctx, runtime, deps = {}) {
 			try {
 				json(res, 200, await route.run());
 			} catch (error) {
-				json(res, 500, { error: safeMessage(error) });
+				json(res, 500, { error: safeMessage$1(error) });
 			}
 		}
 	}), `dsh-claude: ${route.method} ${route.path}`);
 }
 //#endregion
+//#region src/plan-usage-routes.ts
+const EMPTY = {
+	available: false,
+	windows: [],
+	fetchedAt: 0
+};
+function safeMessage(error) {
+	return redactText(error instanceof Error ? error.message : String(error), 1e3);
+}
+/** Plan usage: GET serves the value the metadata bridge last cached (free —
+*  it rides an already-running session), POST reads fresh numbers from a
+*  throwaway probe process so a refresh never depends on, or disturbs, a live
+*  Claude session. */
+function registerPlanUsageRoute(ctx, probe, now = Date.now) {
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: CLAUDE_USAGE_PATH,
+		handler: async (req, res) => {
+			if (req.method !== "GET" && req.method !== "POST") return json(res, 405, { error: "method not allowed" });
+			if (!trustedRequest(req)) return json(res, 403, { error: "forbidden" });
+			if (req.method === "GET") return json(res, 200, latestPlanUsage() ?? EMPTY);
+			try {
+				const report = await probe(now());
+				recordPlanUsage(report);
+				json(res, 200, report);
+			} catch (error) {
+				json(res, 500, { error: safeMessage(error) });
+			}
+		}
+	}), "dsh-claude: plan usage route");
+}
+//#endregion
 //#region src/global-settings.ts
 const MAX_SETTINGS_BYTES = 262144;
 const MAX_REQUEST_BYTES = 8192;
@@ -5441,6 +5945,13 @@ function mountClaudeMetadata(ctx, supervisor, agent, model, sidecar, publishComm
 			} catch (error) {
 				warn("context usage", error);
 			}
+			if (stopped) return;
+			try {
+				const plan = await supervisor.planUsage(agent, model);
+				if (!stopped) recordPlanUsage(normalizePlanUsage(plan, Date.now()));
+			} catch (error) {
+				warn("plan usage", error);
+			}
 		});
 	};
 	return agent.ctx.effect(() => {
@@ -5591,6 +6102,7 @@ async function apply(ctx, config) {
 		});
 		registerRepositorySetupRoute(webCtx, repositorySetup);
 		registerRepositoryStatusRoute(webCtx, repositoryStatus);
+		registerRepositoryFileRoute(webCtx, repositoryStatus);
 		registerJiraRoute(webCtx, new JiraService());
 		const repositoryActions = new RepositoryActionService(webCtx.subprocess, supervisorConfig.executablePath, (cwd) => repositoryStatus.invalidate(cwd));
 		const cwdForClaudeSession = (sessionId) => {
@@ -5600,11 +6112,19 @@ async function apply(ctx, config) {
 		};
 		registerRepositoryActionRoute(webCtx, repositoryActions, cwdForClaudeSession);
 		registerPullRequestFeedbackRoute(webCtx, new PullRequestFeedbackService(webCtx.subprocess), cwdForClaudeSession);
+		registerAskRoute(webCtx, new AskService(webCtx.subprocess, supervisorConfig.executablePath), cwdForClaudeSession, (sessionId) => {
+			const snapshot = supervisor.snapshots().find((item) => item.sessionId === sessionId);
+			return snapshot === void 0 ? void 0 : {
+				model: snapshot.model,
+				...snapshot.thinkingMode === void 0 ? {} : { thinkingMode: snapshot.thinkingMode }
+			};
+		});
 		const ownsClaudeSession = (sessionId) => {
 			const agent = webCtx.agents.get(sessionId);
 			return agent !== void 0 && webCtx.agentPresets.composedPreset(agent.ctx) === "claude";
 		};
 		registerReviewCommentRoute(webCtx, reviewComments, ownsClaudeSession);
+		registerPlanUsageRoute(webCtx, (fetchedAt) => probePlanUsage(supervisorConfig.executablePath, fetchedAt));
 		registerClaudeProjectionRoute(webCtx, sidecar, ownsClaudeSession, (sessionId) => commandCatalogs.get(sessionId) ?? [], async (sessionId) => {
 			const agent = webCtx.agents.get(sessionId);
 			if (agent === void 0 || webCtx.agentPresets.composedPreset(agent.ctx) !== "claude") return void 0;