blun-king-cli 9.1.569 → 9.1.571

package/blun.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 // BLUN_BUILD_INPUT_SHA256:058cccc03f986fac95f89d198bb56bfa928b0c5117340651158d2f731509129c
+import { SessionQueueDelivery as BlunSessionQueueDelivery, captureSessionQueueBoundary } from "./bin/telegram-session-queue-runtime.mjs";
 import { fileURLToPath as __cjsShimFileURLToPath } from 'node:url';
 import { dirname as __cjsShimDirname } from 'node:path';
 const __filename = __cjsShimFileURLToPath(import.meta.url);
@@ -21351,7 +21352,15 @@ var init_types$14 = __esmMin((() => {}));
 //#region ../../packages/agent-core/src/flags/registry.ts
 var FLAG_DEFINITIONS;
 var init_registry$1 = __esmMin((() => {
-	FLAG_DEFINITIONS = [{
+	FLAG_DEFINITIONS = [
+{
+        id: 'agent_spine_timeline',
+        title: 'AgentSpine session transport',
+        description: 'Pass the current native record source to the enabled AgentSpine plugin.',
+        env: 'BLUN_EXPERIMENTAL_AGENT_SPINE_TIMELINE',
+        default: false,
+        surface: 'core',
+    },{
 		id: "vision_reader",
 		title: "Vision reader",
 		description: "Enrich user images with observations from a configured internal service.",
@@ -231318,10 +231327,9 @@ async function runHook(command, input, options) {
 			cwd: options.cwd,
 			stdio: "pipe",
 			detached: process.platform !== "win32",
-			env: options.env ? {
-				...process.env,
-				...options.env
-			} : void 0
+			env: options.env || options.runtimeEnv
+                ? overlayRuntimeEnv({ ...process.env, ...options.env }, options.runtimeEnv)
+                : undefined
 		});
 	} catch (error) {
 		return allowResult({ stderr: errorMessage$11(error) });
@@ -231659,28 +231667,44 @@ async prepareToolUse(args = {}) {
 			await Promise.allSettled([...this.pendingTriggers]);
 		}
 		async triggerInner(event, args) {
-			const matcherValue = matcherValueText(args.matcherValue);
-			const inputData = toHookInputData({
-				hookEventName: event,
-				sessionId: this.options.sessionId ?? "",
-				cwd: this.options.cwd ?? "",
-				...args.inputData
-			});
-			const matched = this.matchingHooks(event, matcherValue);
-			if (matched.length === 0) return [];
-			this.emitTriggered(event, matcherValue, matched.length);
-			const startedAt = Date.now();
-			const results = await createRequire(import.meta.url)("./bin/observer-hooks.cjs").runHookPhases(matched, (hook) => runHook(hook.command, inputData, {
-				timeout: hook.timeout ?? DEFAULT_HOOK_TIMEOUT_SECONDS,
-				cwd: hook.cwd ?? (this.options.cwd === "" ? void 0 : this.options.cwd),
-				env: hook.env,
-				signal: args.signal
-			}), args.signal);
-			for (const message of hookWarningMessages(results)) this.emitWarning(event, message);
-			const { action, reason } = aggregateResults(event, results);
-			this.emitResolved(event, matcherValue, action, reason, Date.now() - startedAt);
-			return results;
-		}
+        const matcherValue = matcherValueText(args.matcherValue);
+        const inputData = toHookInputData({
+            hookEventName: event,
+            sessionId: this.options.sessionId ?? '',
+            cwd: this.options.cwd ?? '',
+            ...args.inputData,
+        });
+        const matched = this.matchingHooks(event, matcherValue);
+        if (matched.length === 0)
+            return [];
+        if (event === 'UserPromptSubmit'
+            && !Object.hasOwn(inputData, 'event_id') && !Object.hasOwn(inputData, 'hook_event_id')) {
+            // One logical delivery, shared by every hook; explicit IDs preserve redelivery identity.
+            inputData['event_id'] = releasePromptUUID();
+        }
+        this.emitTriggered(event, matcherValue, matched.length);
+        const startedAt = Date.now();
+        const results = await Promise.all(matched.map(async (hook) => {
+            let runtimeEnv;
+            try {
+                runtimeEnv = this.options.runtimeEnv?.(hook);
+            }
+            catch {
+                // A resolver error may contain private values. Other hooks still run.
+                return { action: 'allow', stderr: 'Hook runtime environment is unavailable.' };
+            }
+            return runHook(hook.command, inputData, {
+                timeout: hook.timeout ?? DEFAULT_HOOK_TIMEOUT_SECONDS,
+                cwd: hook.cwd ?? (this.options.cwd === '' ? undefined : this.options.cwd),
+                env: hook.env,
+                runtimeEnv,
+                signal: args.signal,
+            });
+        }));
+        const { action, reason } = aggregateResults(event, results);
+        this.emitResolved(event, matcherValue, action, reason, Date.now() - startedAt);
+        return results;
+    }
 		matchingHooks(event, matcherValue) {
 			const seen = /* @__PURE__ */ new Set();
 			const matched = [];
@@ -236096,6 +236120,13 @@ var init_records = __esmMin((() => {
 		persistence;
 		_restoring = null;
 		metadataInitialized = false;
+persistedProtocolVersion;
+get fileSource() {
+        if (!(this.persistence instanceof FileSystemAgentRecordPersistence)
+            || this.persistedProtocolVersion === undefined)
+            return undefined;
+        return { path: this.persistence.filePath, protocolVersion: this.persistedProtocolVersion };
+    }
 		resumeCheckpointRestored = false;
 		messageTimes = new WeakMap();
 		constructor(agent, persistence) {
@@ -236119,8 +236150,15 @@ var init_records = __esmMin((() => {
 					created_at: Date.now()
 				});
 				this.metadataInitialized = true;
-			}
-			if (stamped.type === "metadata") this.metadataInitialized = true;
+			
+this.persistedProtocolVersion = "1.4";
+}
+			if (stamped.type === 'metadata') {
+            if (!this.metadataInitialized) {
+                this.persistedProtocolVersion = stamped.protocol_version;
+            }
+            this.metadataInitialized = true;
+        }
 			this.persistence?.append(stamped);
 		}
 		restore(record) {
@@ -236134,7 +236172,8 @@ var init_records = __esmMin((() => {
 			}
 		}
 		async replay(options = {}) {
-			if (!this.persistence) throw new Error("No persistence provided for AgentRecords");
+			this.persistedProtocolVersion = undefined;
+if (!this.persistence) throw new Error("No persistence provided for AgentRecords");
 			this.resumeCheckpointRestored = false;
 			const rewriteMigratedRecords = options.rewriteMigratedRecords ?? true;
 			if (rewriteMigratedRecords && await this.tryReplayResumeCheckpoint()) return {};
@@ -236152,6 +236191,7 @@ var init_records = __esmMin((() => {
 					hasMetadata = true;
 					this.metadataInitialized = true;
 					const readVersion = record.protocol_version;
+this.persistedProtocolVersion = readVersion;
 					if (isNewerWireVersion(readVersion)) {
 						warning = `Session wire protocol version ${readVersion} is newer than the current version 1.4. Records will be replayed without migration.`;
 						shouldRewrite = false;
@@ -236174,6 +236214,7 @@ var init_records = __esmMin((() => {
 			if (completed && shouldRewrite && replayedRecords !== void 0) {
 				this.persistence.rewrite(replayedRecords);
 				await this.persistence.flush();
+this.persistedProtocolVersion = "1.4";
 			}
 			if (completed && this.persistence instanceof FileSystemAgentRecordPersistence) this.persistence.persistedRecordCount = replayedRecordCount;
 			if (completed && this.agent.blobStore !== void 0) for (const msg of this.agent.context.history) await this.agent.blobStore.rehydrateParts(msg.content);
@@ -236184,8 +236225,17 @@ var init_records = __esmMin((() => {
 			if (this.agent.replayBuilder.options.range !== void 0) return false;
 			const checkpoint = await loadResumeCheckpoint({ wirePath: this.persistence.filePath });
 			if (!checkpoint.ok) return false;
+let sourceProtocol;
+for await (const metadata of this.persistence.read()) {
+  if (metadata.type !== 'metadata' || metadata.protocol_version !== "1.4") return false;
+  sourceProtocol = metadata.protocol_version;
+  break;
+}
+if (sourceProtocol === undefined) return false;
+
 			if (!restoreAgentResumeSnapshot(this.agent, checkpoint.snapshot)) return false;
 			this.metadataInitialized = true;
+this.persistedProtocolVersion = sourceProtocol;
 			let tailRecordCount = 0;
 			for await (const record of this.persistence.readFrom(checkpoint.offset, checkpoint.recordCount)) {
 				this.restore(record);
@@ -265678,34 +265728,52 @@ var init_web_search = __esmMin((() => {
 				execute: (ctx) => this.execution(args, ctx)
 			};
 		}
-		async execution(args, { toolCallId }) {
-			try {
-				const opts = { toolCallId };
-				const results = await this.provider.search(args.query, opts);
-				const builder = new ToolResultBuilder({ maxLineLength: null });
-				if (results.length === 0) {
-					builder.write("No search results found.");
-					return builder.ok();
-				}
-				let first = true;
-				for (const result of results) {
-					if (!first) builder.write("---\n\n");
-					first = false;
-					builder.write(`Title: ${result.title}\n`);
-					if (result.siteName) builder.write(`Site: ${result.siteName}\n`);
-					if (result.date) builder.write(`Date: ${result.date}\n`);
-					builder.write(`URL: ${result.url}\n`);
-					builder.write(`Snippet: ${result.snippet}\n\n`);
-				}
-				builder.write("When you rely on a result in your answer, cite it inline as a markdown link, e.g. [title](url).");
-				return builder.ok();
-			} catch (error) {
-				return {
-					isError: true,
-					output: classifySearchError(error)
-				};
-			}
-		}
+		async execution(args, { toolCallId, }) {
+        try {
+            let failedSources = 0;
+            const opts = { toolCallId, onNotice: notice => {
+                    if (notice.code === 'partial-sources' && Number.isInteger(notice.failedSources)
+                        && notice.failedSources > 0 && notice.failedSources <= 128) {
+                        failedSources = Math.max(failedSources, notice.failedSources);
+                    }
+                } };
+            const results = await this.provider.search(args.query, opts);
+            const builder = new ToolResultBuilder({ maxLineLength: null });
+            if (failedSources > 0) {
+                if (results.length === 0)
+                    throw new Error('Search sources failed without usable results.');
+                builder.write(`Some search sources failed (${failedSources}). Results below are partial, not a complete search.\n\n`);
+            }
+            if (results.length === 0) {
+                builder.write('No search results found.');
+                return builder.ok();
+            }
+            let first = true;
+            for (const result of results) {
+                if (!first)
+                    builder.write('---\n\n');
+                first = false;
+                builder.write(`Title: ${result.title}\n`);
+                if (result.siteName)
+                    builder.write(`Site: ${result.siteName}\n`);
+                if (result.date)
+                    builder.write(`Date: ${result.date}\n`);
+                builder.write(`URL: ${result.url}\n`);
+                builder.write(`Snippet: ${result.snippet}\n\n`);
+            }
+            // Keep the citation reminder next to the data (not just in the static tool
+            // description), so it is present on every search. Cite the page actually
+            // relied on — after a FetchURL follow-up, that is the fetched page.
+            builder.write('When you rely on a result in your answer, cite it inline as a markdown link, e.g. [title](url).');
+            return builder.ok();
+        }
+        catch (error) {
+            return {
+                isError: true,
+                output: classifySearchError(error),
+            };
+        }
+    }
 	};
 }));
 //#endregion
@@ -298151,13 +298219,11 @@ function resolveStdioCwd(configCwd, defaultCwd) {
 	if (defaultCwd !== void 0 && !isAbsolute$2(configCwd)) return resolve$2(defaultCwd, configCwd);
 	return configCwd;
 }
-function mergeStdioEnv(configEnv, parentEnv = process.env) {
-	const merged = {};
-	for (const [key, value] of Object.entries(parentEnv)) if (value !== void 0) merged[key] = value;
-	if (configEnv !== void 0) Object.assign(merged, configEnv);
-	Object.assign(merged, proxyEnvForChild(merged));
-	reconcileChildNoProxy(merged, configEnv);
-	return merged;
+function mergeStdioEnv(configEnv, parentEnv = process.env, runtimeEnv) {
+    const merged = overlayRuntimeEnv({ ...parentEnv, ...configEnv }, runtimeEnv);
+    Object.assign(merged, proxyEnvForChild(merged));
+    reconcileChildNoProxy(merged, overlayRuntimeEnv(configEnv ?? {}, runtimeEnv));
+    return merged;
 }
 var STDERR_BUFFER_CAPACITY, StdioMcpClient, BoundedTail;
 var init_client_stdio = __esmMin((() => {
@@ -298187,7 +298253,7 @@ var init_client_stdio = __esmMin((() => {
 			this.transport = new StdioClientTransport({
 				command: config.command,
 				args: config.args,
-				env: mergeStdioEnv(config.env, config.inheritEnv === false ? {} : process.env),
+				env: mergeStdioEnv(config.env, config.inheritEnv === false ? {} : process.env, options.runtimeEnv),
 				cwd: resolveStdioCwd(config.cwd, options.defaultCwd),
 				stderr: "pipe"
 			});
@@ -298689,22 +298755,32 @@ var init_connection_manager = __esmMin((() => {
 			return entry.attemptId;
 		}
 		createClient(config, name) {
-			const toolCallTimeoutMs = config.toolTimeoutMs;
-			if (config.transport === "stdio") return new StdioMcpClient(config, {
-				toolCallTimeoutMs,
-				defaultCwd: this.options.stdioCwd
-			});
-			if (config.transport === "sse") return new SseMcpClient(config, {
-				toolCallTimeoutMs,
-				envLookup: this.options.envLookup,
-				oauthProvider: this.resolveOAuthProvider(config, name)
-			});
-			return new HttpMcpClient(config, {
-				toolCallTimeoutMs,
-				envLookup: this.options.envLookup,
-				oauthProvider: this.resolveOAuthProvider(config, name)
-			});
-		}
+        const toolCallTimeoutMs = config.toolTimeoutMs;
+        if (config.transport === 'stdio') {
+            let runtimeEnv;
+            try {
+                runtimeEnv = this.options.stdioRuntimeEnv?.(name, config);
+            }
+            catch {
+                throw new Error('MCP runtime environment is unavailable.');
+            }
+            return new StdioMcpClient(config, {
+                toolCallTimeoutMs, defaultCwd: this.options.stdioCwd, runtimeEnv,
+            });
+        }
+        if (config.transport === 'sse') {
+            return new SseMcpClient(config, {
+                toolCallTimeoutMs,
+                envLookup: this.options.envLookup,
+                oauthProvider: this.resolveOAuthProvider(config, name),
+            });
+        }
+        return new HttpMcpClient(config, {
+            toolCallTimeoutMs,
+            envLookup: this.options.envLookup,
+            oauthProvider: this.resolveOAuthProvider(config, name),
+        });
+    }
 		resolveOAuthProvider(config, name) {
 			const oauthService = this.oauthService;
 			if (oauthService === void 0) return void 0;
@@ -299417,6 +299493,43 @@ var init_lsp = __esmMin((() => {
 	init_manager$1();
 }));
 //#endregion
+
+import { randomBytes as releaseRecordRandomBytes } from "node:crypto";
+const EMPTY_RUNTIME = Object.freeze({
+    AGENTSPINE_KING_TIMELINE_SOURCE: '',
+    AGENTSPINE_KING_WIRE_PROTOCOL_VERSION: '',
+    AGENTSPINE_TIMELINE_TRANSPORT_SESSION_ID: '',
+    AGENTSPINE_TIMELINE_SESSION_CAPABILITY: '',
+});
+class AgentSpineSessionRuntime {
+    #env = EMPTY_RUNTIME;
+    #hooks;
+    #servers;
+    constructor(recipients) {
+        this.#hooks = new Set(recipients?.hooks);
+        this.#servers = new Map(Object.entries(recipients?.mcpServers ?? {}));
+    }
+    get hasRecipients() {
+        return this.#hooks.size > 0 || this.#servers.size > 0;
+    }
+    bind(sessionId, source) {
+        this.#env = EMPTY_RUNTIME;
+        if (!sessionId || !/^[A-Za-z0-9][A-Za-z0-9:_.@/-]{0,127}$/.test(sessionId) || !source)
+            return;
+        this.#env = Object.freeze({
+            AGENTSPINE_KING_TIMELINE_SOURCE: source.path,
+            AGENTSPINE_KING_WIRE_PROTOCOL_VERSION: source.protocolVersion,
+            AGENTSPINE_TIMELINE_TRANSPORT_SESSION_ID: sessionId,
+            AGENTSPINE_TIMELINE_SESSION_CAPABILITY: `astc_${releaseRecordRandomBytes(32).toString('base64url')}`,
+        });
+    }
+    forHook(hook) {
+        return this.#hooks.has(hook) ? this.#env : EMPTY_RUNTIME;
+    }
+    forMcp(name, config) {
+        return config.transport === 'stdio' && this.#servers.get(name) === config ? this.#env : EMPTY_RUNTIME;
+    }
+}
 //#region ../../packages/agent-core/src/session/index.ts
 async function waitForSettlementOrTimeout(promise, timeoutMs) {
 	let timeout;
@@ -299497,6 +299610,16 @@ var init_session$1 = __esmMin((() => {
 		writeMetadataPromise = Promise.resolve();
 		agentsMdWarning;
 		accountMemoryContext = "";
+agentSpineRuntime;
+mcpLoadStarted = false;
+startMcpServers() {
+        if (this.mcpLoadStarted)
+            return;
+        this.mcpLoadStarted = true;
+        void this.loadMcpServers().catch((error) => {
+            this.emitInitialMcpLoadError(error);
+        });
+    }
 		constructor(options) {
 			this.options = options;
 			this.logHandle = options.id === void 0 ? void 0 : getRootLogger().attachSession({
@@ -299506,6 +299629,8 @@ var init_session$1 = __esmMin((() => {
 			this.log = this.logHandle?.logger ?? (options.id === void 0 ? log : log.createChild({ sessionId: options.id }));
 			this.rpc = options.rpc;
 			this.experimentalFlags = options.experimentalFlags ?? new FlagResolver();
+this.agentSpineRuntime = this.experimentalFlags.enabled('agent_spine_timeline')
+            ? new AgentSpineSessionRuntime(options.agentSpineRuntime) : undefined;
 			this.visionReader = createManagedMediaVisionReader(options.toolServices?.media) ?? (this.experimentalFlags.enabled("vision_reader") ? createVisionReader(options.config?.services?.visionReader) : void 0);
 			this.hookEngine = new HookEngine(options.hooks, {
 				cwd: options.kaos.getcwd(),
@@ -299534,8 +299659,13 @@ var init_session$1 = __esmMin((() => {
 						code: "HOST_HOOK_WARNING",
 						message
 					});
-				}
-			});
+				},
+runtimeEnv: (hook) => {
+                const hostEnv = options.hookRuntimeEnv?.(hook);
+                const timelineEnv = this.agentSpineRuntime?.forHook(hook);
+                return timelineEnv === undefined ? hostEnv : { ...hostEnv, ...timelineEnv };
+            }
+});
 			this.telemetry = options.telemetry ?? noopTelemetryClient;
 			this.toolKaos = options.kaos;
 			this.persistenceKaos = options.persistenceKaos ?? options.kaos;
@@ -299546,8 +299676,13 @@ var init_session$1 = __esmMin((() => {
 			this.mcp = new McpConnectionManager({
 				oauthService: new McpOAuthService({ blunHomeDir: resolveSharedBlunHome(options.blunHomeDir) }),
 				log: this.log,
-				stdioCwd: options.kaos.getcwd()
-			});
+				stdioCwd: options.kaos.getcwd(),
+stdioRuntimeEnv: (name, config) => {
+                const hostEnv = options.mcpRuntimeEnv?.(name, config);
+                const timelineEnv = this.agentSpineRuntime?.forMcp(name, config);
+                return timelineEnv === undefined ? hostEnv : { ...hostEnv, ...timelineEnv };
+            }
+});
 			this.lsp = options.lspServers === void 0 || Object.keys(options.lspServers).length === 0 ? void 0 : new LspManager({
 				cwd: options.kaos.getcwd(),
 				servers: options.lspServers
@@ -299560,9 +299695,7 @@ var init_session$1 = __esmMin((() => {
 			}).then(() => {
 				this.refreshAgentBuiltinTools();
 			});
-			this.loadMcpServers().catch((error) => {
-				this.emitInitialMcpLoadError(error);
-			});
+			if (!this.agentSpineRuntime?.hasRecipients) this.startMcpServers();
 		}
 		setToolKaos(kaos) {
 			this.toolKaos = kaos;
@@ -300208,7 +300341,18 @@ var init_session$1 = __esmMin((() => {
 			});
 		}
 		async triggerSessionStart(source) {
-			const results = await this.hookEngine.trigger("SessionStart", {
+			if (this.agentSpineRuntime?.hasRecipients && !this.mcpLoadStarted) {
+            try {
+                const main = this.getReadyAgent('main');
+                await main?.records.flush();
+                this.agentSpineRuntime.bind(this.options.id, main?.records.fileSource);
+            }
+            catch {
+                this.log.warn('Native session record source is unavailable.');
+            }
+            this.startMcpServers();
+        }
+const results = await this.hookEngine.trigger("SessionStart", {
 				matcherValue: source,
 				inputData: { source }
 			});
@@ -315095,43 +315239,80 @@ var init_blun_web_search = __esmMin((() => {
 			this.fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);
 		}
 		async search(query, options) {
-			const bodyJson = JSON.stringify({ text_query: query });
-			const toolCallId = options?.toolCallId;
-			const response = await this.post(bodyJson, toolCallId);
-			if (response.status === 401) {
-				const detail = await safeReadText(response);
-				throw new Error(`Blun search request failed: HTTP 401 (auth/unauthorized). ${detail}`.trim());
-			}
-			if (response.status !== 200) {
-				const detail = await safeReadText(response);
-				throw new Error(`Blun search request failed: HTTP ${String(response.status)}. ${detail}`.trim());
-			}
-			const json = await response.json();
-			return (Array.isArray(json.search_results) ? json.search_results : []).map((r) => {
-				const out = {
-					title: r.title ?? "",
-					url: r.url ?? "",
-					snippet: r.snippet ?? ""
-				};
-				if (typeof r.date === "string" && r.date.length > 0) out.date = r.date;
-				if (typeof r.site_name === "string" && r.site_name.length > 0) out.siteName = r.site_name;
-				return out;
-			});
-		}
-		async post(bodyJson, toolCallId) {
-			const accessToken = await this.resolveApiKey();
-			return this.fetchImpl(this.baseUrl, {
-				method: "POST",
-				headers: {
-					...this.defaultHeaders,
-					Authorization: `Bearer ${accessToken}`,
-					"Content-Type": "application/json",
-					...toolCallId !== void 0 && toolCallId.length > 0 ? { "X-Msh-Tool-Call-Id": toolCallId } : {},
-					...this.customHeaders
-				},
-				body: bodyJson
-			});
-		}
+        const body = { text_query: query };
+        const bodyJson = JSON.stringify(body);
+        const toolCallId = options?.toolCallId;
+        const supportsNotices = typeof options?.onNotice === 'function';
+        const response = await this.post(bodyJson, toolCallId, supportsNotices);
+        if (response.status === 401) {
+            const detail = await safeReadText(response);
+            throw new Error(`Blun search request failed: HTTP 401 (auth/unauthorized). ${detail}`.trim());
+        }
+        if (response.status !== 200) {
+            const detail = await safeReadText(response);
+            throw new Error(`Blun search request failed: HTTP ${String(response.status)}. ${detail}`.trim());
+        }
+        const json = (await response.json());
+        const raw = Array.isArray(json.search_results) ? json.search_results : [];
+        const status = json.search_status;
+        if (status !== undefined) {
+            if (!status || typeof status !== 'object' || !Array.isArray(json.search_results)
+                || !Number.isInteger(status.failed_sources) || typeof status.failed_sources !== 'number'
+                || status.failed_sources < 0 || status.failed_sources > 128
+                || (status.state !== 'complete' && status.state !== 'partial')
+                || (status.state === 'complete' && status.failed_sources !== 0)
+                || (status.state === 'partial' && (status.failed_sources === 0 || raw.length === 0))) {
+                throw new Error('Invalid search status response.');
+            }
+            if (!raw.every(row => {
+                if (!row || typeof row.title !== 'string' || !row.title.trim()
+                    || typeof row.snippet !== 'string' || typeof row.url !== 'string')
+                    return false;
+                try {
+                    const url = new URL(row.url);
+                    return (url.protocol === 'https:' || url.protocol === 'http:') && !url.username && !url.password;
+                }
+                catch {
+                    return false;
+                }
+            }))
+                throw new Error('Invalid search results response.');
+            if (status.state === 'partial') {
+                if (!supportsNotices)
+                    throw new Error('Partial search results require a notice consumer.');
+                options?.onNotice?.({ code: 'partial-sources', failedSources: status.failed_sources });
+            }
+        }
+        return raw.map((r) => {
+            const out = {
+                title: r.title ?? '',
+                url: r.url ?? '',
+                snippet: r.snippet ?? '',
+            };
+            if (typeof r.date === 'string' && r.date.length > 0)
+                out.date = r.date;
+            if (typeof r.site_name === 'string' && r.site_name.length > 0)
+                out.siteName = r.site_name;
+            return out;
+        });
+    }
+		async post(bodyJson, toolCallId, supportsNotices) {
+        const accessToken = await this.resolveApiKey();
+        return this.fetchImpl(this.baseUrl, {
+            method: 'POST',
+            headers: {
+                ...this.defaultHeaders,
+                Authorization: `Bearer ${accessToken}`,
+                'Content-Type': 'application/json',
+                ...(toolCallId !== undefined && toolCallId.length > 0
+                    ? { 'X-Msh-Tool-Call-Id': toolCallId }
+                    : {}),
+                ...this.customHeaders,
+                ...(supportsNotices ? { 'X-BLUN-Search-Contract': 'partial-v1' } : {}),
+            },
+            body: bodyJson,
+        });
+    }
 		async resolveApiKey() {
 			if (this.tokenProvider !== void 0) try {
 				return await this.tokenProvider.getAccessToken();
@@ -318903,6 +319084,7 @@ var init_core_impl = __esmMin((() => {
 			const pluginSessionStarts = this.plugins.enabledSessionStarts();
 			const pluginCommands = await this.plugins.enabledCommands();
 			const mcpConfig = this.mergePluginMcpConfig(withCallerMcp);
+const pluginHooks = this.plugins.enabledHooks();
 			const runtime = await this.resolveRuntime(config);
 			const session = new Session$1({
 				kaos: parentKaos.withCwd(workDir),
@@ -318915,7 +319097,8 @@ var init_core_impl = __esmMin((() => {
 				rpc: proxyWithExtraPayload(await this.sdk, { sessionId: summary.id }),
 				providerManager: this.resolveProviderManager(summary.id),
 				background: config.background,
-				hooks: [...config.hooks ?? [], ...this.plugins.enabledHooks()],
+				hooks: [...(config.hooks ?? []), ...pluginHooks],
+agentSpineRuntime: this.agentSpineRuntimeRecipients(pluginHooks, mcpConfig),
 				permissionRules: config.permission?.rules,
 				skills: this.resolveSessionSkillConfig(config),
 				mcpConfig,
@@ -318998,6 +319181,7 @@ var init_core_impl = __esmMin((() => {
 			const pluginSessionStarts = this.plugins.enabledSessionStarts();
 			const pluginCommands = await this.plugins.enabledCommands();
 			const mcpConfig = this.mergePluginMcpConfig(withCallerMcp);
+const pluginHooks = this.plugins.enabledHooks();
 			const runtime = await this.resolveRuntime(config);
 			const parentKaos = parentKaosForRead;
 			const persistenceKaos = overrides.persistenceKaos ?? parentKaos;
@@ -319012,7 +319196,8 @@ var init_core_impl = __esmMin((() => {
 				rpc: proxyWithExtraPayload(await this.sdk, { sessionId: summary.id }),
 				providerManager: this.resolveProviderManager(summary.id),
 				background: config.background,
-				hooks: [...config.hooks ?? [], ...this.plugins.enabledHooks()],
+				hooks: [...(config.hooks ?? []), ...pluginHooks],
+agentSpineRuntime: this.agentSpineRuntimeRecipients(pluginHooks, mcpConfig),
 				permissionRules: config.permission?.rules,
 				skills: this.resolveSessionSkillConfig(config),
 				mcpConfig,
@@ -319468,6 +319653,21 @@ var init_core_impl = __esmMin((() => {
 				}
 			};
 		}
+agentSpineRuntimeRecipients(pluginHooks, mcpConfig) {
+        if (!this.experimentalFlags.enabled('agent_spine_timeline'))
+            return undefined;
+        const plugin = this.plugins.get('agent-spine');
+        if (plugin?.state !== 'ok' || !plugin.enabled)
+            return undefined;
+        // These objects came from PluginManager, not caller hooks or session metadata.
+        const hooks = pluginHooks.filter(hook => hook.env?.['BLUN_PLUGIN_ROOT'] === plugin.root);
+        const mcpServers = Object.fromEntries(Object.entries(mcpConfig?.servers ?? {}).filter(([name, config]) => {
+            const origin = mcpConfig?.origins?.[name];
+            return origin?.source === 'plugin' && origin.pluginId === plugin.id && origin.pluginEnabled
+                && config.transport === 'stdio' && config.enabled !== false;
+        }));
+        return hooks.length > 0 || Object.keys(mcpServers).length > 0 ? { hooks, mcpServers } : undefined;
+    }
 		async resolveCurrentMcpConfig(session) {
 			const snapshot = session.mcpConfigSnapshot();
 			const callerServers = Object.fromEntries(Object.entries(snapshot?.servers ?? {}).filter(([name]) => snapshot?.origins?.[name]?.source === "session"));
@@ -422051,6 +422251,21 @@ var TelegramChannelController = class {
 	constructor(host, dir = telegramStateDir(), options = {}) {
 		this.host = host;
 		this.dir = dir;
+    this.sessionScope = options.sessionScope;
+    this.sessionDelivery = new BlunSessionQueueDelivery(dir, {
+      ownsChannel: () => !this.stopped && this.ownsChannel(),
+      currentSessionId: () => this.sessionScope?.()?.sessionId,
+      legacyCheckpoint: () => this.checkpointOffset,
+      inject: (envelope, acknowledge) => {
+        const trace = telegramDeliveryIdentity(envelope.meta);
+        telegramDeliveryLifecycle.record({ stage: "tui_injected", ...trace, route: "tui" });
+        this.host.inject(envelope, () => {
+          if (this.stopped || !this.ownsChannel()) return;
+          acknowledge();
+          telegramDeliveryLifecycle.record({ stage: "acknowledged", ...trace, route: "tui" });
+        });
+      }
+    });
 		this.spawnBridge = options.spawnBridge ?? spawn;
 		this.bridgeStopTimeoutMs = options.bridgeStopTimeoutMs ?? BRIDGE_STOP_TIMEOUT_MS;
 		this.bridgeForceStopTimeoutMs = options.bridgeForceStopTimeoutMs ?? BRIDGE_FORCE_STOP_TIMEOUT_MS;
@@ -422305,6 +422520,7 @@ var TelegramChannelController = class {
 			this.loseOwnership();
 			return;
 		}
+		if (this.sessionScope !== undefined) { this.pollSessionQueue(this.sessionScope()); return; }
 		let stats;
 		try {
 			stats = statSync(this.queueFile);
@@ -422486,6 +422702,16 @@ var TelegramChannelController = class {
 			if (!servers.some((server) => (server.name === "telegram" || server.name.endsWith(":telegram")) && server.status !== "disabled" && server.status !== "failed")) this.host.warn(uiText("telegramChannel.replyToolsMissing", { command: "/plugins install <repo>\\plugins\\telegram" }));
 		} catch {}
 	}
+
+pollSessionQueue(scope, deliver = true) {
+    try { this.sessionDelivery.poll(scope, deliver); this.sessionQueueError = undefined; }
+    catch (error) { const message = String(error); if (message !== this.sessionQueueError) {
+      this.sessionQueueError = message;
+      this.host.warn(uiText("telegramChannel.leaseWriteFailed", { error: message }));
+    } }
+  }
+
+bindSessionQueue(scope) { if (this.sessionScope !== undefined) this.pollSessionQueue(scope, false); }
 };
 //#endregion
 //#region src/tui/commands/config-general.copy.ts
@@ -518947,28 +519173,46 @@ async function saveAutoRetrievedMedia(result) {
 function isGroupChat(chatId) {
 	return chatId.startsWith("-");
 }
-const STRONG_META = /\b(keine (gruppen ?)?antwort|gar keine antwort|halte (mich|die klappe)|(bin|bleibe) (jetzt )?still|ich schweige|schweige|stille|nichts (zu tun|zu melden|fur mich|fuer mich)|nicht (direkt )?an mich( gerichtet)?|nicht meine lane|keine reaktion|no ?action|kein wort|silence|staying (silent|out|quiet)|keeping (quiet|out)|no (response|reply|answer|comment)|nothing (to (add|do|report)|for me)|not (for me|my lane|addressed to me|directed at me)|holding back|standing by|no need to (respond|reply))\b/;
-const SHORT_CONFIRM = /^(verstanden|kapiert|ok|okay|alles klar|geht klar|angekommen|seh sie|ich seh sie|gemerkt|passt|erledigt notiert|notiert|no ?action|understood|got it|noted|acknowledged|roger|received|silence)\b[\s\S]{0,48}$/;
+function normalizeGroupNoise(text) {
+    return text
+        .toLowerCase()
+        .replace(/\u00e4/g, 'a')
+        .replace(/\u00f6/g, 'o')
+        .replace(/\u00fc/g, 'u')
+        .replace(/\u00df/g, 'ss')
+        .replace(/[\u2010-\u2015]/g, ' ')
+        .replace(/[^\p{L}\p{N}\s]/gu, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+const GROUP_REPLY_EMPTY_CLAUSES = [
+    /^(verstanden|kapiert|ok|okay|alles klar|geht klar|angekommen|seh sie|ich seh sie|gemerkt|passt|erledigt notiert|notiert|understood|got it|noted|acknowledged|roger|received)$/,
+    /^(bin da|bin hier|hier bin ich|ich bin da|was brauchst du|was gibt es|was liegt an|wie kann ich helfen|bereit|ich warte|warte auf|melde mich|freut mich|here|standing by|ready|awaiting|what do you need)$/,
+    /^(keine (gruppen ?)?antwort|gar keine antwort|keine reaktion|kein wort|no ?action|no (response|reply|answer|comment))( (notig|erforderlich|needed|required))?$/,
+    /^(ich )?(halte mich raus|(bin|bleibe) (jetzt )?still|schweige|habe nichts zu melden)$/,
+    /^(stille|still|silence|nichts (zu tun|zu melden|fur mich|fuer mich)|nicht meine lane)$/,
+    /^(i (am |will be )?)?(staying (silent|out|quiet)|keeping (quiet|out)|holding back)$/,
+    /^(i have )?nothing (to (add|do|report)|for me)$/,
+    /^no need to (respond|reply)$/,
+    /^(nicht (direkt )?an mich( gerichtet)?|not (for me|my lane|addressed to me|directed at me|to me))$/,
+    /^(die(se)? nachricht ist )?(nicht (direkt )?an mich|an die gruppe)( gerichtet)?$/,
+    /^(this|the) message is (addressed to the group|not (addressed )?to me)$/,
+    /^(es gibt )?kein(en|e)? (auftrag( (an|fur|fuer) mich)?|frage( an mich)?|arbeit( verlangt)?)$/,
+    /^(there is )?no (task|question|work)( for me)?$/,
+    /^(ich beende den )?turn ohne (ausgabe|antwort)( beendet)?$/,
+    /^i (will )?end this turn without (a response|output)$/,
+    /^(nach|gemaess) der leerlauf regel( \d+)? gibt es nichts zu melden$/,
+];
+const GROUP_REPLY_NOTIFICATION_CONTEXT = /^die(se)? nachricht ist eine (konfigurations )?information( [\p{L}\p{N} _-]{1,64} wird ab jetzt nur noch bei erwahnung benachrichtigt)?( an die gruppe gerichtet)?$/u;
+
 function isGroupNoiseReply(text) {
-	const n = text.toLowerCase().replace(/ä/g, "a").replace(/ö/g, "o").replace(/ü/g, "u").replace(/ß/g, "ss").replace(/[‐-―]/g, " ").replace(/[^\p{L}\p{N}\s]/gu, " ").replace(/\s+/g, " ").trim();
-	if (n.length === 0) return true;
-	if (n.length > 200) return false;
-	return STRONG_META.test(n) || SHORT_CONFIRM.test(n);
+    const clauses = text.split(/[.!?;,\r\n]+|\s+[-\u2013\u2014]\s+/u).map(normalizeGroupNoise).filter(Boolean);
+    return clauses.every((clause) => GROUP_REPLY_EMPTY_CLAUSES.some((pattern) => pattern.test(clause))
+        || GROUP_REPLY_NOTIFICATION_CONTEXT.test(clause));
 }
-/**
-* Whether a group reply must be suppressed. `contextOnly` = the triggering
-* message was context-only and not addressed to King. All
-* Sprachen": on a read-only message King should stay silent, so ANY short reply
-* back is meta chatter regardless of language ("Silence.", "Tystnad.", "沈黙。").
-* Long substantive contributions still pass; the word-list catches longer DE/EN
-* meta lines. Addressed messages only hit the word-list, never the length rule.
-*/
-function isGroupSuppressed(text, contextOnly) {
-	if (isGroupNoiseReply(text)) return true;
-	if (contextOnly) {
-		if (text.replace(/\s+/g, " ").trim().length <= 40) return true;
-	}
-	return false;
+/** Unknown content is preserved, including short useful context-only warnings. */
+function isGroupSuppressed(text, _contextOnly) {
+    return isGroupNoiseReply(text);
 }
 /**
 * Send `text` to `chatId` via the Bot API and log it to outbox.jsonl as
@@ -520803,6 +521047,7 @@ var BlunTUI = class {
 		const { workDir } = this.state.appState;
 		let session;
 		let shouldReplayHistory = false;
+const telegramBoundary = this.captureTelegramQueueBoundary();
 		const isResumeStartup = startup.sessionFlag !== void 0 || startup.continueLast;
 		const createSessionOptions = {
 			workDir,
@@ -520876,7 +521121,7 @@ var BlunTUI = class {
 			return false;
 		}
 		if (session === void 0) throw new Error(uiText("blunTui.startup.sessionNotInitialized"));
-		await this.measureStartupPhase("session_bind_ms", () => this.setSession(session, { refreshPersonalMemory: false }));
+		await this.measureStartupPhase("session_bind_ms", () => this.setSession(session, { refreshPersonalMemory: false, telegramSessionScope: { sessionId: session.id, mode: shouldReplayHistory ? "resume" : "new", boundary: telegramBoundary } }));
 		await this.measureStartupPhase("runtime_state_ms", () => this.syncRuntimeState(session));
 		this.applyStartupPermissionAndPlanToAppState();
 		this.state.startupState = "ready";
@@ -522115,6 +522360,7 @@ var BlunTUI = class {
 			text: focusedModelInput
 		}, imagePart] : focusedModelInput;
 		session.promptAccepted(promptInput, channelPromptOrigin(channelReportSources)).then((result) => {
+if (this.session !== session) return;
 			if (result.accepted) {
 				if (channelFocusId !== void 0) this.clearAddressedChannelFocusIds([channelFocusId]);
 				this.traceTelegramDelivery?.({ stage: "accepted", ...channelDeliveryTrace, route: "prompt", turnId: result.turnId });
@@ -522174,6 +522420,7 @@ var BlunTUI = class {
 			this.updateQueueDisplay();
 			this.state.ui.requestRender();
 		}).catch((error) => {
+if (this.session !== session) return;
 			this.failSessionRequest(uiText("blunTui.session.sendFailed", { error: formatErrorMessage$2(error) }));
 		});
 		this.updateQueueDisplay();
@@ -522662,8 +522909,8 @@ var BlunTUI = class {
 			onOwnershipLost: () => {
 				if (this.telegramChannel === controller) this.telegramChannel = void 0;
 			}
-		});
-		controller.start();
+    }, telegramStateDir(), { sessionScope: () => this.deferUserMessages || this.session?.id !== this.telegramSessionScope?.sessionId ? undefined : this.telegramSessionScope });
+    controller.start();
 		this.telegramChannel = controller;
 		this.showStatus(uiText("blunTui.telegram.attached", { pid: process.pid }));
 	}
@@ -523269,27 +523516,10 @@ var BlunTUI = class {
 		return this.harness.createSession(options);
 	}
 	async setSession(session, options = {}) {
-		const resumedStatus = await session.getStatus();
-		if (!isManagedBlunModelAlias(resumedStatus.model ?? BLUN_KING_MODEL_ALIAS, this.state.appState.availableModels)) {
-			await session.setModel(BLUN_KING_MODEL_ALIAS, { allowFallback: false });
-			this.showStatus(uiText("config.model.unknownAlias", { alias: resumedStatus.model ?? "" }), "warning");
-		}
-		await this.personalMemoryController.clear(this.session);
-		const previous = this.unloadCurrentSession(approvalCancellationFeedback("switching_session"));
-		await this.managedQuotaWarningPersistence;
-		await this.flushGoalChannelReplyPersistence();
-		await previous?.close();
-		resetChannelPreambleState(this.channelPreamble);
-		this.session = session;
-		this.managedQuotaWarningController.restore(session.id, managedQuotaWarningThresholdFromMetadata(session.getResumeState()?.sessionMetadata?.custom));
-		this.setAppState({ modelFallbackAllowed: false });
-		this.harness.setTelemetryContext({ sessionId: session.id });
-		this.registerSessionHandlers(session);
-		this.syncAdditionalDirs(session);
-		await this.refreshManagedImageReaderAvailability(session);
-		await this.authFlow.applyManagedAccountContextToSession();
-		if (options.refreshPersonalMemory !== false) await this.personalMemoryController.refresh();
-	}
+  await this.withTelegramQueuePaused(async boundary => {
+    await this.setSessionRuntime(session, options, options.telegramSessionScope ?? { sessionId: session.id, mode: "resume", boundary });
+  });
+}
 	async syncRuntimeState(session = this.requireSession()) {
 		const [status, goalResult, loopResult] = await Promise.all([session.getStatus(), session.getGoal(), session.getLoop()]);
 		this.setAppState({
@@ -523498,28 +523728,10 @@ var BlunTUI = class {
 		return true;
 	}
 	async switchToSession(session, statusMessage) {
-		this.resetSessionRuntime();
-		await this.setSession(session);
-		await this.syncRuntimeState(session);
-		this.updateTerminalTitle();
-		try {
-			await this.refreshSkillCommands(this.session);
-			await this.refreshPluginCommands(this.session);
-		} catch {}
-		this.clearTranscriptAndRedraw({ preserveScrollbackArchive: true });
-		try {
-			await this.sessionReplay.hydrateFromReplay(session);
-		} catch (error) {
-			const msg = formatErrorMessage$2(error);
-			this.showError(uiText("blunTui.session.replayFailed", { error: msg }));
-		} finally {
-			this.sessionEventHandler.startSubscription();
-		}
-		const resumeState = session.getResumeState();
-		if (resumeState?.warning !== void 0) this.showStatus(uiText("blunTui.warning", { warning: resumeState.warning }), "warning");
-		this.showStatus(statusMessage);
-		this.showSessionWarnings(session);
-	}
+        await this.withTelegramQueuePaused(async (boundary) => {
+            await this.switchToSessionRuntime(session, statusMessage, boundary);
+        });
+    }
 	async reloadCurrentSessionView(session, statusMessage) {
 		await this.personalMemoryController.clear(session);
 		if (this.goalChannelReplyScope?.session === session && this.goalChannelReplyScope.reloading) this.goalChannelReplyScope.restored = false;
@@ -523553,56 +523765,10 @@ var BlunTUI = class {
 		this.showSessionWarnings(session);
 	}
 	async createNewSession() {
-		if (this.state.appState.isReplaying) {
-			this.showError(uiText("blunTui.session.createReplayBlocked"));
-			return;
-		}
-		this.clearQueuedMessages();
-		const activeSession = this.session;
-		const activeTurn = activeSession !== void 0 && (this.streamingUI.hasActiveTurn() || this.state.appState.streamingPhase !== "idle" || this.state.appState.isCompacting);
-		if (activeTurn) {
-			this.markCurrentRunCancelledByUser();
-			try {
-				await activeSession.cancel();
-			} catch (error) {
-				if (!(error instanceof BlunError && error.code === ErrorCodes.SESSION_NOT_FOUND)) {
-					this.showError(formatErrorMessage$2(error));
-					return;
-				}
-			}
-			this.clearTurnCancellation();
-		}
-		let session;
-		try {
-			session = await this.createSessionFromCurrentState();
-		} catch (error) {
-			const msg = formatErrorMessage$2(error);
-			this.showError(uiText("blunTui.session.createFailed", { error: msg }));
-			return;
-		}
-		this.resetSessionRuntime();
-		await this.setSession(session);
-		this.setAppState({ sessionId: session.id });
-		try {
-			await this.activateRuntime();
-			await this.syncRuntimeState(session);
-		} catch (error) {
-			this.sessionEventHandler.startSubscription();
-			const msg = formatErrorMessage$2(error);
-			this.showError(uiText("blunTui.session.postCreateFailed", { error: msg }));
-			return;
-		}
-		try {
-			await this.refreshSkillCommands(this.session);
-			await this.refreshPluginCommands(this.session);
-		} catch {}
-		this.sessionEventHandler.startSubscription();
-		this.clearTranscriptAndRedraw({ preserveScrollbackArchive: true });
-		this.scrollbackController.prepareNewSession(session);
-		this.showStatus(uiText("blunTui.session.started", { sessionId: session.id }));
-		this.showSessionWarnings(session);
-		this.showConfigWarningsIfAny();
-	}
+        await this.withTelegramQueuePaused(async (boundary) => {
+            await this.createNewSessionRuntime(boundary);
+        });
+    }
 	/** Surface config.toml load warnings (degraded or kept-previous config) in the status bar. */
 	async showConfigWarningsIfAny() {
 		try {
@@ -524574,6 +524740,133 @@ var BlunTUI = class {
 		this.patchLivePane({ pendingQuestion: null });
 		this.restoreEditor();
 	}
+
+async switchToSessionRuntime(session, statusMessage, boundary) {
+		this.resetSessionRuntime();
+		await this.setSession(session, { telegramSessionScope: { sessionId: session.id, mode: "resume", boundary } });
+		await this.syncRuntimeState(session);
+		this.updateTerminalTitle();
+		try {
+			await this.refreshSkillCommands(this.session);
+			await this.refreshPluginCommands(this.session);
+		} catch {}
+		this.clearTranscriptAndRedraw({ preserveScrollbackArchive: true });
+		try {
+			await this.sessionReplay.hydrateFromReplay(session);
+		} catch (error) {
+			const msg = formatErrorMessage$2(error);
+			this.showError(uiText("blunTui.session.replayFailed", { error: msg }));
+		} finally {
+			this.sessionEventHandler.startSubscription();
+		}
+		const resumeState = session.getResumeState();
+		if (resumeState?.warning !== void 0) this.showStatus(uiText("blunTui.warning", { warning: resumeState.warning }), "warning");
+		this.showStatus(statusMessage);
+		this.showSessionWarnings(session);
+	}
+
+async createNewSessionRuntime(boundary) {
+		if (this.state.appState.isReplaying) {
+			this.showError(uiText("blunTui.session.createReplayBlocked"));
+			return;
+		}
+		const activeSession = this.session;
+		const activeTurn = activeSession !== void 0 && (this.streamingUI.hasActiveTurn() || this.state.appState.streamingPhase !== "idle" || this.state.appState.isCompacting);
+		if (activeTurn) {
+			this.markCurrentRunCancelledByUser();
+			try {
+				await activeSession.cancel();
+			} catch (error) {
+				if (!(error instanceof BlunError && error.code === ErrorCodes.SESSION_NOT_FOUND)) {
+					this.showError(formatErrorMessage$2(error));
+					return;
+				}
+			}
+			this.clearTurnCancellation();
+		}
+		let session;
+		try {
+			session = await this.createSessionFromCurrentState();
+		} catch (error) {
+			const msg = formatErrorMessage$2(error);
+			this.showError(uiText("blunTui.session.createFailed", { error: msg }));
+			return;
+		}
+		this.resetSessionRuntime();
+		await this.setSession(session, { telegramSessionScope: { sessionId: session.id, mode: "new", boundary } });
+		this.setAppState({ sessionId: session.id });
+		try {
+			await this.activateRuntime();
+			await this.syncRuntimeState(session);
+		} catch (error) {
+			this.sessionEventHandler.startSubscription();
+			const msg = formatErrorMessage$2(error);
+			this.showError(uiText("blunTui.session.postCreateFailed", { error: msg }));
+			return;
+		}
+		try {
+			await this.refreshSkillCommands(this.session);
+			await this.refreshPluginCommands(this.session);
+		} catch {}
+		this.sessionEventHandler.startSubscription();
+		this.clearTranscriptAndRedraw({ preserveScrollbackArchive: true });
+		this.scrollbackController.prepareNewSession(session);
+		this.showStatus(uiText("blunTui.session.started", { sessionId: session.id }));
+		this.showSessionWarnings(session);
+		this.showConfigWarningsIfAny();
+	}
+
+async setSessionRuntime(session, options, queueScope) {
+		const resumedStatus = await session.getStatus();
+		if (!isManagedBlunModelAlias(resumedStatus.model ?? BLUN_KING_MODEL_ALIAS, this.state.appState.availableModels)) {
+			await session.setModel(BLUN_KING_MODEL_ALIAS, { allowFallback: false });
+			this.showStatus(uiText("config.model.unknownAlias", { alias: resumedStatus.model ?? "" }), "warning");
+		}
+		await this.personalMemoryController.clear(this.session);
+		const previous = this.unloadCurrentSession(approvalCancellationFeedback("switching_session"));
+		await this.managedQuotaWarningPersistence;
+		await this.flushGoalChannelReplyPersistence();
+		await previous?.close();
+  if (previous?.id !== session.id) {
+    this.state.queuedMessages = this.state.queuedMessages.filter(item => item.mode !== "channel" && item.mode !== "channel-command");
+    this.queueFlushBatchRemaining = 0;
+    this.queueSteerInFlight = undefined;
+    this.channelPromptInFlight = undefined;
+    this.deferredChannelAcknowledgements.clear();
+    this.pendingChannelReplyGuard = undefined;
+    this.syncChannelQueueDeadline();
+  }
+		resetChannelPreambleState(this.channelPreamble);
+		this.session = session;
+		this.managedQuotaWarningController.restore(session.id, managedQuotaWarningThresholdFromMetadata(session.getResumeState()?.sessionMetadata?.custom));
+		this.setAppState({ modelFallbackAllowed: false });
+		this.harness.setTelemetryContext({ sessionId: session.id });
+		this.registerSessionHandlers(session);
+		this.syncAdditionalDirs(session);
+		await this.refreshManagedImageReaderAvailability(session);
+		await this.authFlow.applyManagedAccountContextToSession();
+		if (options.refreshPersonalMemory !== false) await this.personalMemoryController.refresh();
+	
+this.telegramSessionScope = queueScope;
+this.telegramChannel?.bindSessionQueue(queueScope);
+}
+
+async withTelegramQueuePaused(work) {
+        const boundary = this.captureTelegramQueueBoundary();
+        const wasDeferred = this.deferUserMessages;
+        this.deferUserMessages = true;
+        try {
+            return await work(boundary);
+        }
+        finally {
+            this.deferUserMessages = wasDeferred;
+            this.scheduleQueueDrain();
+        }
+    }
+
+captureTelegramQueueBoundary() {
+        return captureSessionQueueBoundary(join(telegramStateDir(), 'inbound-queue.jsonl')) ?? 'absent';
+    }
 };
 //#endregion
 //#region src/cli/run-shell.ts
@@ -525292,3 +525585,23 @@ async function logStartupFailure(operation, error) {
 }
 //#endregion
 export { configureTelegramPluginLaunchMode, createBlunHarness, createBlunHostIdentity, handleMainCommand, isDirectCliEntry, main };
+
+import { randomUUID as releasePromptUUID } from "node:crypto";
+function overlayRuntimeEnv(base, runtime) {
+    const result = {};
+    for (const [key, value] of Object.entries(base)) {
+        if (value !== undefined)
+            result[key] = value;
+    }
+    for (const [key, value] of Object.entries(runtime ?? {})) {
+        // Node selects one casing on Windows; leaving both can preserve a stale value.
+        if (process.platform === 'win32') {
+            for (const existing of Object.keys(result)) {
+                if (existing.toUpperCase() === key.toUpperCase())
+                    delete result[existing];
+            }
+        }
+        result[key] = value;
+    }
+    return result;
+}