@sayknow-cli/coding-agent 0.3.10 → 0.3.12

package/CHANGELOG.md

@@ -4,19 +4,6 @@ Sayknow-CLI is a rebranded fork of [gajae-code](https://github.com/Yeachan-Heo/g
 This file tracks the **fork's own releases**; upstream's full feature history lives
 in that project. Each release notes the upstream version it is built on.
 
-## [0.3.10] — 2026-07-09
-
-### Changed
-
-- Synced onto upstream **gajae-code v0.9.2**, carrying the 0.9.2 patch set into
-  Sayknow-CLI while preserving the SKC fork layer and release surface.
-
-### Fixed
-
-- Updated the release version surfaces so `skc --version`, package metadata,
-  native sentinel exports, plugin metadata, schemas, and public sync checks report
-  **0.3.10** consistently.
-
 ## [0.3.0] — 2026-06-23
 
 ### Changed

package/dist/types/build-metadata.d.ts

@@ -0,0 +1,7 @@
+export type BuildChannel = "release" | "dev" | "local-source" | "package-install" | "compiled" | "unknown";
+export interface BuildMetadata {
+    channel: BuildChannel;
+    label: string;
+}
+export declare function resolveBuildMetadata(moduleDir?: string): BuildMetadata;
+export declare function formatBuildLabel(metadata?: BuildMetadata): string;

package/dist/types/capability/mcp.d.ts

@@ -7,7 +7,7 @@ export interface MCPServer {
     name: string;
     /** Whether this server is enabled (default: true) */
     enabled?: boolean;
-    /** Whether to connect automatically at session startup (default: true) */
+    /** Whether explicit runtime MCP consumers should connect automatically (default: true) */
     autoload?: boolean;
     /** Connection timeout in milliseconds */
     timeout?: number;
@@ -17,6 +17,8 @@ export interface MCPServer {
     args?: string[];
     /** Environment variables */
     env?: Record<string, string>;
+    /** Whether explicit stdio runtime consumers should avoid inheriting host environment */
+    noInheritEnv?: boolean;
     /** Working directory for stdio transport */
     cwd?: string;
     /** URL (for HTTP/SSE transport) */

package/dist/types/commands/mcp.d.ts

@@ -1,5 +1,5 @@
 /**
- * Direct MCP server registration for standalone SKC.
+ * Explicit MCP server config storage for standalone SKC.
  */
 import { Command } from "@sayknow-cli/utils/cli";
 import { type MCPAction } from "../cli/mcp-cli";

package/dist/types/config/keybindings.d.ts

@@ -297,11 +297,11 @@ export declare const KEYBINDINGS: {
     };
     readonly "app.session.delete": {
         readonly defaultKeys: "ctrl+d";
-        readonly description: "Delete session";
+        readonly description: "Delete current session transcript/artifacts";
     };
     readonly "app.session.deleteNoninvasive": {
         readonly defaultKeys: "ctrl+backspace";
-        readonly description: "Delete session (non-invasive)";
+        readonly description: "Delete selected session transcript/artifacts (non-invasive)";
     };
     readonly "app.tree.foldOrUp": {
         readonly defaultKeys: ["ctrl+left", "alt+left"];

package/dist/types/modes/acp/acp-event-mapper.d.ts

@@ -16,6 +16,8 @@ interface AcpEventMapperOptions {
      * before emitting `ToolCallLocation` entries.
      */
     cwd?: string;
+    /** Phase to expose after compaction ends. Prompt-bound compaction resumes responding; idle maintenance returns idle. */
+    compactionEndPhase?: "responding" | "idle";
 }
 export declare function mapToolKind(toolName: string): ToolKind;
 export declare function mapAgentWireEventPayloadToAcpSessionUpdates(payload: AgentWireEventPayload, sessionId: string, options?: AcpEventMapperOptions): SessionNotification[];

package/dist/types/modes/components/hook-selector.d.ts

@@ -48,6 +48,7 @@ export interface HookSelectorOptions {
 export declare class HookSelectorComponent extends Container {
     #private;
     constructor(title: string, options: string[], onSelect: (option: string) => void, onCancel: () => void, opts?: HookSelectorOptions);
+    hasActiveInlineInput(): boolean;
     handleInput(keyData: string): void;
     dispose(): void;
 }

package/dist/types/modes/components/status-line/types.d.ts

@@ -27,6 +27,12 @@ export interface SegmentContext {
     };
     contextPercent: number;
     contextWindow: number;
+    /**
+     * True when a standalone `context_pct` segment is also part of the active
+     * layout. The model segment suppresses its inline percentage in that case to
+     * avoid showing the same value twice.
+     */
+    contextPctSegmentActive?: boolean;
     autoCompactEnabled: boolean;
     subagentCount: number;
     jobs: JobsSnapshot;

package/dist/types/modes/components/status-line.d.ts

@@ -6,6 +6,7 @@ import { type JobsSnapshot } from "../jobs-observer";
 export interface StatusLineSegmentOptions {
     model?: {
         showThinkingLevel?: boolean;
+        showContextPercent?: boolean;
     };
     path?: {
         abbreviate?: boolean;

package/dist/types/modes/components/welcome.d.ts

@@ -14,6 +14,7 @@ export interface WelcomeComponentOptions {
     getReservedBottomRows?: (termWidth: number) => number;
     changelogMarkdown?: string;
     collapseChangelog?: boolean;
+    buildLabel?: string;
 }
 /**
  * Sayknow-CLI launch surface: a blue-gradient SAYKNOW wordmark, compact

package/dist/types/modes/rpc/rpc-client.d.ts

@@ -7,7 +7,7 @@ import type { AgentEvent, AgentMessage, AgentToolResult, ThinkingLevel } from "@
 import type { CompactionResult } from "@sayknow-cli/agent-core/compaction";
 import type { ImageContent, Model } from "@sayknow-cli/ai";
 import type { BashResult } from "../../exec/bash-executor";
-import type { SessionStats } from "../../session/agent-session";
+import type { AgentSessionEvent, SessionStats } from "../../session/agent-session";
 import type { RpcExtensionUIRequest, RpcGetStateInclude, RpcHandoffResult, RpcHostToolDefinition, RpcSessionState, RpcUnattendedAccepted, RpcUnattendedDeclaration, RpcWorkflowGate, RpcWorkflowGateResolution } from "./rpc-types";
 export interface RpcClientOptions {
     /** Dial an existing Unix-domain socket instead of spawning a stdio child. */
@@ -37,6 +37,7 @@ export interface RpcClientOptions {
 }
 export type ModelInfo = Pick<Model, "provider" | "id" | "contextWindow" | "reasoning" | "thinking">;
 export type RpcEventListener = (event: AgentEvent) => void;
+export type RpcSessionEventListener = (event: AgentSessionEvent) => void;
 export interface RpcClientToolContext<TDetails = unknown> {
     toolCallId: string;
     signal: AbortSignal;
@@ -72,9 +73,13 @@ export declare class RpcClient {
      */
     [Symbol.dispose](): void;
     /**
-     * Subscribe to agent events.
+     * Subscribe to the legacy core AgentEvent subset.
      */
     onEvent(listener: RpcEventListener): () => void;
+    /**
+     * Subscribe to all renderer-facing agent session events.
+     */
+    onSessionEvent(listener: RpcSessionEventListener): () => void;
     /**
      * Subscribe to workflow lifecycle gates emitted by RPC mode.
      */

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -7,6 +7,18 @@ interface RenderInitialMessagesOptions {
     preserveExistingChat?: boolean;
 }
 export declare function argsWithPartialJson(args: unknown, partialJson: unknown): unknown;
+export declare class CollapsedChatHistoryComponent implements Component {
+    readonly isCollapsedChatHistory = true;
+    count: number;
+    startTime: number;
+    endTime: number;
+    constructor(count: number, startTime: number, endTime: number);
+    merge(count: number, startTime: number, endTime: number): void;
+    render(_width: number): string[];
+    invalidate(): void;
+}
+export declare function addChatChild(ctx: InteractiveModeContext, component: Component): void;
+export declare function trimChatChildren(ctx: InteractiveModeContext): void;
 export declare class UiHelpers {
     #private;
     private ctx;

package/dist/types/notifications/telegram-daemon.d.ts

@@ -375,6 +375,8 @@ export declare class TelegramNotificationDaemon {
     private rememberPendingThreadedFrame;
     private flushPendingThreadedFrames;
     private ensureTopic;
+    private topicPastOrphanGrace;
+    private deleteOrphanedTopic;
     private deleteTopic;
     private persistTopics;
     loadTopics(): Promise<void>;

package/dist/types/runtime-mcp/config-writer.d.ts

@@ -70,10 +70,11 @@ export declare function getMCPServer(filePath: string, name: string): Promise<MC
  */
 export declare function listMCPServers(filePath: string): Promise<string[]>;
 /**
- * Set a server's autoload flag (connect automatically at session startup).
+ * Set a server's autoload flag for explicit runtime MCP consumers.
  *
- * Autoload defaults to true, so turning it on removes the key to keep the
- * config file free of redundant fields; turning it off writes `autoload: false`.
+ * Autoload defaults to true for consumers that honor it, so turning it on
+ * removes the key to keep the config file free of redundant fields; turning it
+ * off writes `autoload: false`.
  *
  * @throws Error if the server doesn't exist
  */

package/dist/types/runtime-mcp/types.d.ts

@@ -46,9 +46,10 @@ interface MCPServerConfigBase {
     /** Whether this server is enabled (default: true) */
     enabled?: boolean;
     /**
-     * Whether to connect this server automatically at session startup (default: true).
-     * When false the server stays configured-but-disconnected until connected
-     * explicitly (e.g. `/mcp connect <name>`).
+     * Whether an explicit runtime MCP consumer should connect this server
+     * automatically when that consumer starts (default: true). Normal standalone
+     * `skc`, `skc --tmux`, and print-mode sessions do not consume `skc mcp`
+     * registrations today.
      */
     autoload?: boolean;
     /** Connection timeout in milliseconds (default: 30000) */

package/dist/types/session/agent-session.d.ts

@@ -156,6 +156,10 @@ export interface AsyncJobSnapshot {
     recent: AsyncJobSnapshotItem[];
     delivery: AsyncJobDeliveryState;
 }
+export interface RetainedMemorySample {
+    tuiChatChildren?: number;
+    tuiCachedRenderBytes?: number;
+}
 export interface AgentSessionConfig {
     agent: Agent;
     sessionManager: SessionManager;
@@ -237,6 +241,8 @@ export interface AgentSessionConfig {
      * **MUST NOT** dispose it on their own teardown.
      */
     ownedAsyncJobManager?: AsyncJobManager;
+    /** Cheap TUI retained-memory counters; absent for headless sessions. */
+    retainedMemorySampler?: () => RetainedMemorySample;
     /**
      * MCPManager whose lifecycle this session owns (top-level sessions that
      * connected plugin-bundle MCP servers). Only the owned manager is
@@ -368,6 +374,15 @@ export declare const __agentSessionPerfCounters: {
     reset(): void;
 };
 export declare function buildContextInjectionSignature(kind: string, parts: readonly string[]): string;
+export declare class StreamingEditFileCache {
+    #private;
+    get(path: string): string | undefined;
+    set(path: string, content: string): void;
+    delete(path: string): void;
+    clear(): void;
+    has(path: string): boolean;
+    get totalBytes(): number;
+}
 export declare class AgentSession {
     #private;
     readonly agent: Agent;
@@ -935,6 +950,7 @@ export declare class AgentSession {
     prepareContributionPrep(options?: ContributionPrepOptions): Promise<ContributionPrepResult>;
     /** Test seam: override the emergency-compaction resource sampler so tests never read real RSS. */
     setResourceSampler(sampler: () => EmergencyCompactionSample): void;
+    setRetainedMemorySampler(sampler: (() => RetainedMemorySample) | undefined): void;
     /**
      * Toggle auto-compaction setting.
      */

package/dist/types/session/session-manager.d.ts

@@ -535,6 +535,7 @@ export declare class SessionManager {
     getInjectedTtsrRules(): string[];
     getLeafId(): string | null;
     getLeafEntry(): SessionEntry | undefined;
+    getResidentImageBytes(): number;
     /**
      * Get the most recent model role from the current session path.
      * Returns undefined if no model change has been recorded.

package/dist/types/tools/skill.d.ts

@@ -4,15 +4,16 @@
  * Lets the agent hand off to another available skill in the current turn. The
  * callee's SKILL.md is dispatched through the same custom-message path used by
  * `/skill:<name>` typing, as a user-attribution message delivered same-turn
- * (without `deliverAs: "nextTurn"`). Before dispatch, the tool calls
- * `skc state <caller> handoff --to <callee>` in-process via the state-runtime
- * function so caller and callee mode-states plus `skill-active-state.json`
- * transition atomically.
+ * (without `deliverAs: "nextTurn"`). When the caller is one of the canonical
+ * workflow skills, the tool first runs the native state handoff so workflow
+ * mode-state and `skill-active-state.json` transition atomically. Runtime
+ * project/user skills have no native workflow mode-state, so they are dispatched
+ * directly and tracked by the prompt observer instead.
  *
- * Chaining is refused unless the caller's `current_phase` is in
- * `{complete, completed, handoff, failed, cancelled, canceled, inactive}`. The
- * agent declares readiness either by writing `current_phase: "handoff"` to its
- * mode-state or by running the handoff verb directly.
+ * Canonical workflow chaining is refused unless the caller's `current_phase` is
+ * in `{complete, completed, handoff, failed, cancelled, canceled, inactive}`.
+ * The agent declares readiness either by writing `current_phase: "handoff"` to
+ * its mode-state or by running the handoff verb directly.
  */
 import type { AgentTool, AgentToolResult } from "@sayknow-cli/agent-core";
 import * as z from "zod/v4";

package/dist/types/utils/linkedom.d.ts

@@ -0,0 +1,4 @@
+type LinkedomModule = typeof import("linkedom");
+type ParseHtml = LinkedomModule["parseHTML"];
+export declare function parseHtmlLazy(markup: string): Promise<ReturnType<ParseHtml>>;
+export {};

package/dist/types/utils/pasted-image-path.d.ts

@@ -23,8 +23,10 @@ export interface ResolvePastedImagePathOptions extends DecodePastedPathOptions {
  */
 export declare function decodePastedPathCandidate(text: string, options?: DecodePastedPathOptions): string | undefined;
 /**
- * Returns the resolved path when the whole pasted text is a single path to an
- * existing image file (verified by extension AND content signature),
- * otherwise `undefined` (the paste is inserted as text).
+ * Returns the resolved path when the whole pasted text is a recognized clipboard
+ * temp path to an existing image file, otherwise `undefined` (the paste is
+ * inserted as text). Arbitrary saved image paths are not auto-attached here;
+ * users attach them explicitly with `@path/to/image.png`.
  */
 export declare function resolvePastedImagePath(text: string, options?: ResolvePastedImagePathOptions): string | undefined;
+export declare function formatPastedImageReference(placeholder: string, imagePath: string): string;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@sayknow-cli/coding-agent",
-	"version": "0.3.10",
+	"version": "0.3.12",
 	"description": "Sayknow-CLI CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://sayknow-cli.com",
 	"author": "jaybeyond",
@@ -52,12 +52,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@sayknow-cli/stats": "0.3.10",
-		"@sayknow-cli/agent-core": "0.3.10",
-		"@sayknow-cli/ai": "0.3.10",
-		"@sayknow-cli/natives": "0.3.10",
-		"@sayknow-cli/tui": "0.3.10",
-		"@sayknow-cli/utils": "0.3.10",
+		"@sayknow-cli/stats": "0.3.12",
+		"@sayknow-cli/agent-core": "0.3.12",
+		"@sayknow-cli/ai": "0.3.12",
+		"@sayknow-cli/natives": "0.3.12",
+		"@sayknow-cli/tui": "0.3.12",
+		"@sayknow-cli/utils": "0.3.12",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/scripts/build-binary.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 
 import * as path from "node:path";
+import { buildDevCompileArgs } from "./compile-args";
 
 const packageDir = path.join(import.meta.dir, "..");
 const outputPath = path.join(packageDir, "dist", "skc");
@@ -34,49 +35,7 @@ async function main(): Promise<void> {
 		await runCommand(["bun", "--cwd=../natives", "run", "embed:native"]);
 		try {
 			const buildEnv = shouldAdhocSignDarwinBinary() ? { ...Bun.env, BUN_NO_CODESIGN_MACHO_BINARY: "1" } : Bun.env;
-			await runCommand(
-				[
-					"bun",
-					"build",
-					"--compile",
-					// Minify shrinks the bundled JS the compiled binary must parse at
-					// startup (302MB → ~114MB --help RSS measured on darwin-arm64).
-					// --keep-names below preserves identifiers for error reports.
-					"--minify",
-					"--no-compile-autoload-bunfig",
-					"--no-compile-autoload-dotenv",
-					"--no-compile-autoload-tsconfig",
-					"--no-compile-autoload-package-json",
-					"--keep-names",
-					"--define",
-					'process.env.PI_COMPILED="true"',
-					"--external",
-					"mupdf",
-					"--root",
-					"../..",
-					"./src/cli.ts",
-					// Worker entrypoints. Bun's `--compile` discovers the literal in
-					// `new Worker("…", …)` at each spawn site, but only actually
-					// emits the worker into the bunfs root when it is listed here as
-					// an explicit additional entry. Paths are relative to this
-					// script's cwd (packages/coding-agent) and the `--root` above
-					// (../..) makes them appear inside the binary at
-					// `/$bunfs/root/packages/<pkg>/src/<worker>.js`, which is
-					// exactly what the literals at the spawn sites resolve to.
-					"../stats/src/sync-worker.ts",
-					"./src/tools/browser/tab-worker-entry.ts",
-					"./src/eval/js/worker-entry.ts",
-					// Hidden notify daemon CLI (loaded via dynamic import from notify-cli); list it
-					// explicitly so Bun standalone keeps `skc notify daemon-internal` usable.
-					"./src/notifications/telegram-daemon-cli.ts",
-					// Hidden Telegram Remote gateway entrypoint. `skc telegram start` self-spawns
-					// `skc telegram __gateway`, which dynamic-imports this bundled entry.
-					"../telegram-remote/src/index.ts",
-					"--outfile",
-					"dist/skc",
-				],
-				buildEnv,
-			);
+			await runCommand(buildDevCompileArgs(), buildEnv);
 
 			await stageWorkspaceNativeAddons();
 			// Bun 1.3.12 emits a truncated Mach-O signature on darwin builds.

package/scripts/compile-args.ts

@@ -0,0 +1,106 @@
+export interface CompileArgOptions {
+	root: string;
+	entrypoints: string[];
+	outfile: string;
+	target?: string;
+	defines?: string[];
+	externals?: string[];
+}
+
+export const compileAutoloadDisableFlags = [
+	"--no-compile-autoload-bunfig",
+	"--no-compile-autoload-dotenv",
+	"--no-compile-autoload-tsconfig",
+	"--no-compile-autoload-package-json",
+];
+
+const compiledDefineFlags = ['process.env.PI_COMPILED="true"'];
+const releaseDefineFlags = [...compiledDefineFlags, 'process.env.SKC_BUILD_CHANNEL="release"'];
+const devDefineFlags = [...compiledDefineFlags, 'process.env.SKC_BUILD_CHANNEL="dev"'];
+
+export const compiledExternalPackages = ["mupdf"];
+
+export const releaseEntrypoints = [
+	"./packages/coding-agent/src/cli.ts",
+	"./packages/stats/src/sync-worker.ts",
+	"./packages/coding-agent/src/tools/browser/tab-worker-entry.ts",
+	"./packages/coding-agent/src/eval/js/worker-entry.ts",
+	"./packages/natives/native/index.js",
+	"./packages/coding-agent/src/notifications/telegram-daemon-cli.ts",
+	// Hidden Telegram Remote gateway entrypoint. `skc telegram start` self-spawns
+	// `skc telegram __gateway`, which dynamic-imports this bundled entry.
+	"./packages/telegram-remote/src/index.ts",
+	// NOTE: models.json must NOT be listed here — `bun build --compile` does not
+	// emit `.json` extra entrypoints into the bunfs. It is embedded via the
+	// `with { type: "file" }` import in packages/ai/src/models.ts instead.
+	// NOTE: handlebars must NOT be listed here either — the extra entrypoint
+	// silently vanished from minified bundles and crashed v0.9.3–v0.9.6
+	// releases at startup (#1939). It is bundled via the statically-traceable
+	// `require("handlebars")` in packages/utils/src/prompt.ts instead.
+];
+
+export const devEntrypoints = [
+	"./src/cli.ts",
+	"../stats/src/sync-worker.ts",
+	"./src/tools/browser/tab-worker-entry.ts",
+	"./src/eval/js/worker-entry.ts",
+	"./src/notifications/telegram-daemon-cli.ts",
+	"../telegram-remote/src/index.ts",
+];
+
+export function buildReleaseCompileArgs(target: string, outfile: string): string[] {
+	return buildCompileArgs({
+		root: ".",
+		entrypoints: releaseEntrypoints,
+		outfile,
+		target,
+		defines: releaseDefineFlags,
+
+		externals: compiledExternalPackages,
+	});
+}
+
+export function buildDevCompileArgs(outfile = "dist/skc"): string[] {
+	return buildCompileArgs({
+		root: "../..",
+		entrypoints: devEntrypoints,
+		outfile,
+		defines: devDefineFlags,
+		externals: compiledExternalPackages,
+	});
+}
+
+export function buildCompileArgs(options: CompileArgOptions): string[] {
+	const args = [
+		"bun",
+		"build",
+		"--compile",
+		// Minify shrinks the bundled JS the compiled binary must parse at
+		// startup (302MB → ~114MB --help RSS measured on darwin-arm64).
+		// --keep-names below preserves identifiers for error reports.
+		// SAFE with handlebars since #1939: the module is bundled via a
+		// statically-traceable require in packages/utils/src/prompt.ts, not a
+		// bunfs extra entrypoint (which --minify silently dropped, crashing
+		// v0.9.3–v0.9.6 releases at startup).
+		"--minify",
+		...compileAutoloadDisableFlags,
+		"--keep-names",
+	];
+
+	for (const define of options.defines ?? []) {
+		args.push("--define", define);
+	}
+
+	args.push("--root", options.root);
+
+	for (const external of options.externals ?? []) {
+		args.push("--external", external);
+	}
+
+	if (options.target) {
+		args.push("--target", options.target);
+	}
+
+	args.push(...options.entrypoints, "--outfile", options.outfile);
+	return args;
+}

package/scripts/generate-docs-index.ts

@@ -58,6 +58,7 @@ const mapEntries = docsWithContent
 	.join("\n");
 const output = [
 	"// Auto-generated by scripts/generate-docs-index.ts - DO NOT EDIT",
+	`Reflect.set(globalThis, Symbol.for("skc.docs-index.generated.loaded"), true);`,
 	"",
 	`export const EMBEDDED_DOC_FILENAMES: readonly string[] = ${filenamesLiteral};`,
 	"",

package/src/build-metadata.ts

@@ -0,0 +1,104 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { isCompiledBinary } from "@sayknow-cli/utils/env";
+
+export type BuildChannel = "release" | "dev" | "local-source" | "package-install" | "compiled" | "unknown";
+
+export interface BuildMetadata {
+	channel: BuildChannel;
+	label: string;
+}
+
+const REPO_MARKERS = [".git", "bun.lock"];
+const SOURCE_REPO_PACKAGE_NAME = "sayknow-cli";
+
+export function resolveBuildMetadata(moduleDir: string = import.meta.dir): BuildMetadata {
+	const explicitChannel = normalizeBuildChannel(process.env.SKC_BUILD_CHANNEL);
+	if (explicitChannel) {
+		return metadataForChannel(explicitChannel);
+	}
+
+	if (isCompiledBinary()) {
+		return metadataForChannel("compiled");
+	}
+
+	if (isLocalSourceTree(moduleDir)) {
+		return metadataForChannel("local-source");
+	}
+
+	return metadataForChannel("package-install");
+}
+
+export function formatBuildLabel(metadata: BuildMetadata = resolveBuildMetadata()): string {
+	return metadata.label;
+}
+
+function normalizeBuildChannel(value: string | undefined): BuildChannel | undefined {
+	const normalized = value?.trim().toLowerCase();
+	if (!normalized) return undefined;
+	switch (normalized) {
+		case "release":
+		case "stable":
+			return "release";
+		case "dev":
+		case "development":
+			return "dev";
+		case "local-source":
+		case "source":
+		case "local":
+			return "local-source";
+		case "package-install":
+		case "package":
+		case "npm":
+			return "package-install";
+		case "compiled":
+			return "compiled";
+		case "unknown":
+			return "unknown";
+		default:
+			return "unknown";
+	}
+}
+
+function metadataForChannel(channel: BuildChannel): BuildMetadata {
+	switch (channel) {
+		case "release":
+			return { channel, label: "release build" };
+		case "dev":
+			return { channel, label: "dev build" };
+		case "local-source":
+			return { channel, label: "local source" };
+		case "package-install":
+			return { channel, label: "package install" };
+		case "compiled":
+			return { channel, label: "compiled build" };
+		case "unknown":
+			return { channel, label: "build unknown" };
+	}
+}
+
+function isLocalSourceTree(startDir: string): boolean {
+	let current = path.resolve(startDir);
+	while (true) {
+		if (hasRepoMarkers(current)) return true;
+		const parent = path.dirname(current);
+		if (parent === current) return false;
+		current = parent;
+	}
+}
+
+function hasRepoMarkers(dir: string): boolean {
+	if (!REPO_MARKERS.every(marker => fs.existsSync(path.join(dir, marker)))) return false;
+	return readPackageName(path.join(dir, "package.json")) === SOURCE_REPO_PACKAGE_NAME;
+}
+
+function readPackageName(packageJsonPath: string): string | undefined {
+	try {
+		const parsed: unknown = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+		if (typeof parsed !== "object" || parsed === null || !("name" in parsed)) return undefined;
+		const name = parsed.name;
+		return typeof name === "string" ? name : undefined;
+	} catch {
+		return undefined;
+	}
+}

package/src/capability/mcp.ts

@@ -15,7 +15,7 @@ export interface MCPServer {
 	name: string;
 	/** Whether this server is enabled (default: true) */
 	enabled?: boolean;
-	/** Whether to connect automatically at session startup (default: true) */
+	/** Whether explicit runtime MCP consumers should connect automatically (default: true) */
 	autoload?: boolean;
 	/** Connection timeout in milliseconds */
 	timeout?: number;
@@ -25,6 +25,8 @@ export interface MCPServer {
 	args?: string[];
 	/** Environment variables */
 	env?: Record<string, string>;
+	/** Whether explicit stdio runtime consumers should avoid inheriting host environment */
+	noInheritEnv?: boolean;
 	/** Working directory for stdio transport */
 	cwd?: string;
 	/** URL (for HTTP/SSE transport) */