dsh-session-bridge 0.2.0 → 0.3.0

package/lib/index.js

@@ -4,7 +4,7 @@ import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { appendFileSync, mkdirSync } from "node:fs";
 import { randomUUID } from "node:crypto";
-//#region node_modules/.pnpm/@deepseek-ai+dsh-home-paths@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-in_163d6a248f48546c43609789e3a6f2aa/node_modules/@deepseek-ai/dsh-home-paths/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-home-paths@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-in_7832b76c982cc1477c0eac59a4954baf/node_modules/@deepseek-ai/dsh-home-paths/lib/index.js
 /**
 * Shared filesystem path helpers for DeepSeek Harness user data.
 *
@@ -2200,7 +2200,7 @@ var Service = class Service {
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-typert-protocol@0.1.2-alpha.5_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-typert-protocol/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-typert-protocol@0.1.2-rc.1_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-typert-protocol/lib/index.js
 /** The one Remote failure class shared by owners, the Gateway, and consumers. */
 /**
 * One Remote call failure: a real Error carrying its stable code and typed
@@ -2345,7 +2345,7 @@ function validateName(subject, value) {
 	if (!isTypertRemoteSegment(value)) throw new TypeError(`typert-protocol: ${subject} must contain only RPC endpoint segment characters`);
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-util-values@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-i_4c434a1a30063a3cb77c280072a5c101/node_modules/@deepseek-ai/dsh-util-values/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-util-values@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-i_486cdbb63f2ab3a8eaad87d2b6e5a4b7/node_modules/@deepseek-ai/dsh-util-values/lib/index.js
 /** Duplicate-install-safe JSON and immutable-value helpers. @module @deepseek-ai/dsh-util-values */
 /**
 * Mark an unreachable closed-union branch.
@@ -2557,7 +2557,7 @@ function deepFreeze(value) {
 	return value;
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-util-crypto@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-i_8594a45cf8ae488dc1880a22a6864aa8/node_modules/@deepseek-ai/dsh-util-crypto/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-util-crypto@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-i_45952c52282327ee28c4189b1e05c80c/node_modules/@deepseek-ai/dsh-util-crypto/lib/index.js
 /**
 * Random v4 UUID, minted from `crypto.getRandomValues`.
 * @returns the UUID string.
@@ -2570,7 +2570,7 @@ function randomUUID$1() {
 	return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-brand@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-invaria_e2403996a25372848a6710513dd3725f/node_modules/@deepseek-ai/dsh-brand/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-brand@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-invaria_0a6acdb1edc9f1b3caaaafba5a0cd464/node_modules/@deepseek-ai/dsh-brand/lib/index.js
 /**
 * Duplicate-install-safe nominal string helpers.
 *
@@ -3187,11 +3187,11 @@ defineMethod("transform", [
 	"preserve"
 ], ({ inner }, isInner) => inner.toString(isInner));
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-timeout@0.1.2-alpha.5_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-timeout/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-timeout@0.1.2-rc.1_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-timeout/lib/index.js
 /** Largest delay Node schedules without clamping it to one millisecond. */
 const MAX_TIMER_DELAY_MS = 2147483647;
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-llm@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-invariant_ba6560006b4459f1f9769001786a712b/node_modules/@deepseek-ai/dsh-llm/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-llm@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-invariant_cc3ae850d309c6dee6d11afd096d0893/node_modules/@deepseek-ai/dsh-llm/lib/index.js
 /**
 * Detach and deep-freeze a message whose identity already exists.
 * @param message - complete message, including its stable identity.
@@ -8966,7 +8966,7 @@ function superRefine(fn, params) {
 	return /* @__PURE__ */ _superRefine(fn, params);
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-storage@0.1.2-alpha.5_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-storage/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-storage@0.1.2-rc.1_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-storage/lib/index.js
 /**
 * Backend-facing vocabulary of the storage hub: a backend owns one medium
 * (a file-tree root, a database file) and exposes operation groups over it.
@@ -8977,7 +8977,7 @@ function superRefine(fn, params) {
 /** Allowed format for unit and table names: safe as a file name and as a SQL identifier segment without escaping. */
 const UNIT_NAME_RE = /^[a-z][a-z0-9_]*$/;
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-storage-domain@0.1.2-alpha.5_@deepseek-ai+cordis@4.0.2_@deepseek-ai+ds_045e358f2bf6c5fc406379121d884012/node_modules/@deepseek-ai/dsh-storage-domain/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-storage-domain@0.1.2-rc.1_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-i_9f44d404e0b20c2f6e8599234336f27b/node_modules/@deepseek-ai/dsh-storage-domain/lib/index.js
 /**
 * Domain declaration vocabulary. A spec object is the single source of a
 * domain's identity, layout, and record schemas: the owning package defines
@@ -9098,6 +9098,29 @@ Service.init;
 * dsh-session-bridge core: 会话创建 / 发消息 / 等待回复 / 读取 / 查找。
 * 所有逻辑跑在插件宿主上下文（rootCtx），操作的是 DSH 真实的会话与 agent 注册表。
 */
+/**
+* 兼容读取不同 dsh-session 版本上的会话事件：
+* - 旧版 `Session` 暴露 `get events(): readonly SessionEvent[]`；
+* - 新版（如宿主实际运行的 0.1.2-rc.x）将 `get events` 改为
+*   `snapshotEvents(fromSeq?, toSeqExclusive?)` 方法——`.events` 直接读取会
+*   得到 `undefined`，对 for...of 迭代即抛 `events is not iterable`。
+* 两者都读不到（或 session 不存在）时回退为空数组，绝不抛迭代错误。
+*/
+function sessionEvents(session) {
+	const s = session;
+	if (s === null || s === void 0) return [];
+	if (Array.isArray(s.events)) return s.events;
+	if (typeof s.snapshotEvents === "function") try {
+		return s.snapshotEvents();
+	} catch {
+		return [];
+	}
+	return [];
+}
+/** 规约任意"事件列表"值为数组（非数组 → []），避免 events is not iterable。 */
+function asEventList(events) {
+	return Array.isArray(events) ? events : [];
+}
 /** agent.followup / steer 接受的用户消息值。 */
 function userMessage(text) {
 	return {
@@ -9121,6 +9144,18 @@ function blockText(content) {
 	}
 	return parts.length === 0 ? void 0 : parts.join("\n");
 }
+/** 提取指定类型的 content block 文本（如 reasoning），用于从消息 content 里读出思维链。 */
+function blockTextByType(content, wantedType) {
+	if (!Array.isArray(content)) return void 0;
+	const parts = [];
+	for (const raw of content) {
+		const block = raw;
+		if (block !== null && typeof block === "object" && block.type === wantedType && typeof block.text === "string") {
+			if (block.text !== "") parts.push(block.text);
+		}
+	}
+	return parts.length === 0 ? void 0 : parts.join("\n");
+}
 function countImages(content) {
 	if (!Array.isArray(content)) return 0;
 	let n = 0;
@@ -9141,8 +9176,9 @@ function toolNamesOf(toolCalls) {
 }
 /** 折叠会话事件日志为可读消息行（跳过非 user 来源与空消息）。 */
 function foldMessages(events) {
+	const list = asEventList(events);
 	const rows = [];
-	for (const event of events) if (event.type === "user/message") {
+	for (const event of list) if (event.type === "user/message") {
 		const source = event.data.source;
 		if (source !== void 0 && source.kind !== "user") continue;
 		const text = blockText(event.data.content);
@@ -9157,7 +9193,7 @@ function foldMessages(events) {
 	} else if (event.type === "assistant/message") {
 		const message = event.data.message;
 		const text = message === null ? void 0 : blockText(message.content);
-		const reasoning = message === null ? void 0 : blockText(message.reasoning);
+		const reasoning = message === null ? void 0 : blockTextByType(message.content, "reasoning") ?? blockText(message.reasoning);
 		const images = message === null ? 0 : countImages(message.content);
 		const toolCalls = message === null ? [] : toolNamesOf(message.toolCalls);
 		if (text === void 0 && reasoning === void 0 && toolCalls.length === 0) continue;
@@ -9174,13 +9210,119 @@ function foldMessages(events) {
 	}
 	return rows;
 }
+/** 按已完成输出段落折叠事件日志：每个 assistant/message 割一段，返回 sinceSeq 后的所有段落（事件序）。 */
+function segmentsSince(events, sinceSeq = 0) {
+	const list = asEventList(events);
+	const out = [];
+	let openTurn = false;
+	for (const event of list) {
+		if (event.type === "turn/start") {
+			openTurn = true;
+			continue;
+		}
+		if (event.type === "turn/end") {
+			openTurn = false;
+			continue;
+		}
+		if (event.type !== "assistant/message") continue;
+		if (event.seq <= sinceSeq) continue;
+		const message = event.data.message;
+		const text = message === null ? void 0 : blockText(message.content);
+		const reasoning = message === null ? void 0 : blockTextByType(message.content, "reasoning") ?? blockText(message.reasoning);
+		const toolCalls = message === null ? [] : toolNamesOf(message.toolCalls);
+		const turn = event.data?.turn;
+		const step = event.data?.step;
+		const seg = {
+			seq: event.seq,
+			time: event.time,
+			turn: typeof turn === "number" ? turn : 0,
+			step: typeof step === "number" ? step : 0,
+			toolCalls,
+			openTurn
+		};
+		if (text !== void 0) seg.text = text;
+		if (reasoning !== void 0) seg.reasoning = reasoning;
+		out.push(seg);
+	}
+	return out;
+}
+/** 取自 sinceSeq 之后最新一个已完成输出段落（无则 null）。 */
+function latestSegmentSince(events, sinceSeq = 0) {
+	const segs = segmentsSince(events, sinceSeq);
+	return segs.length === 0 ? null : segs[segs.length - 1] ?? null;
+}
+/**
+* 对一个 live 会话的事件日志折叠出其"实时思维链"：
+* - 优先聚合流式 assistant/chunk 事件里的 reasoning-delta（turn 中途即可见、增量，
+*   这正是监控思维链并按规则提前终止所需的粒度）；
+* - 同时聚合同窗口的 text-delta 增量；
+* - 若没有进行中的 chunk（会话空闲、或该 provider 不流式推理/无推理），返回 null，
+*   调用方应回落为 foldMessages 里的已定型 message.reasoning。
+* 纯读、无副作用；事件形状不做任何假设，缺失/异常一律安全处理。
+*/
+function liveReasoningSnapshot(events) {
+	const list = asEventList(events);
+	let lastFinalizedSeq = -1;
+	let reasoning = "";
+	let text = "";
+	let seq = -1;
+	let time = 0;
+	let turn = 0;
+	let step = 0;
+	let foundDelta = false;
+	for (const event of list) {
+		if (event.type === "assistant/message") {
+			lastFinalizedSeq = event.seq;
+			continue;
+		}
+		if (event.type !== "assistant/chunk") continue;
+		if (event.seq <= lastFinalizedSeq) continue;
+		const data = event.data;
+		if (data === null || data === void 0 || typeof data !== "object") continue;
+		const c = data.chunk;
+		if (c === null || typeof c !== "object" || typeof c.type !== "string") continue;
+		if (c.type === "reasoning-delta" || c.type === "text-delta") {
+			if (typeof c.text !== "string") continue;
+			if (c.type === "reasoning-delta") reasoning += c.text;
+			else text += c.text;
+			if (typeof data.turn === "number") turn = data.turn;
+			if (typeof data.step === "number") step = data.step;
+			foundDelta = true;
+			if (event.seq > seq) seq = event.seq;
+			if (event.time > time) time = event.time;
+		}
+	}
+	if (!foundDelta) return null;
+	return {
+		turn,
+		step,
+		reasoning,
+		text,
+		seq,
+		time
+	};
+}
+/** 思维链尾巴默认截断上限（字符）。 */
+const REASONING_TAIL_LIMIT = 4e3;
+/**
+* 组装一条受字符上限约束的"思维链尾巴"用于展示/摘要：
+* 优先进行中的 liveReasoning，否则最近已定型的 lastReasoning；
+* 超出上限时截断并附省略标记。两者皆无返回 undefined。
+*/
+function reasoningTailOf(liveReasoning, lastReasoning, limit = REASONING_TAIL_LIMIT) {
+	const source = liveReasoning ?? lastReasoning;
+	if (source === void 0 || source === "") return void 0;
+	if (source.length <= limit) return source;
+	return source.slice(0, limit) + "…";
+}
 /**
 * 会话标题：优先 session/title 事件（last-wins，与 UI 一致）；
 * 无标题事件时回落为第一条用户消息（截断 80 字符）。
 */
 function titleOf(events) {
+	const list = asEventList(events);
 	let title;
-	for (const event of events) {
+	for (const event of list) {
 		const raw = event;
 		if (raw.type === "session/title") {
 			const t = raw.data.title;
@@ -9188,7 +9330,7 @@ function titleOf(events) {
 		}
 	}
 	if (title !== void 0) return title;
-	for (const event of events) if (event.type === "user/message") {
+	for (const event of list) if (event.type === "user/message") {
 		const source = event.data.source;
 		if (source !== void 0 && source.kind !== "user") continue;
 		const text = blockText(event.data.content);
@@ -9200,8 +9342,9 @@ function titleOf(events) {
 }
 /** 日志最大事件序号。 */
 function maxSeq(events) {
+	const list = asEventList(events);
 	let m = -1;
-	for (const event of events) if (event.seq > m) m = event.seq;
+	for (const event of list) if (event.seq > m) m = event.seq;
 	return m;
 }
 function sleep(ms) {
@@ -9223,33 +9366,51 @@ async function waitForReply(opts) {
 	const started = Date.now();
 	const deadline = started + opts.timeoutMs;
 	const requireTurnEnd = opts.requireTurnEnd ?? false;
+	const waitForSegment = opts.waitForSegment ?? false;
 	let latest = null;
 	let textReply = null;
+	let segment = null;
 	let turnEnded = false;
 	for (;;) {
 		if (opts.signal !== void 0 && opts.signal.aborted) break;
-		const events = opts.session.events;
+		const events = sessionEvents(opts.session);
 		for (const row of foldMessages(events)) {
 			if (row.seq <= opts.baselineSeq || row.role !== "assistant") continue;
 			if (latest === null || row.seq > latest.seq) latest = row;
 			if (row.text !== void 0 && (textReply === null || row.seq > textReply.seq)) textReply = row;
 		}
+		if (waitForSegment) {
+			const seg = latestSegmentSince(events, opts.baselineSeq);
+			if (seg !== null && (segment === null || seg.seq > segment.seq)) segment = seg;
+		}
 		if (requireTurnEnd && latest !== null) {
 			for (const event of events) if (event.seq > latest.seq && event.type === "turn/end") {
 				turnEnded = true;
 				break;
 			}
 		}
-		if (requireTurnEnd ? latest !== null && turnEnded : textReply !== null) break;
+		let done;
+		if (requireTurnEnd) done = latest !== null && turnEnded;
+		else if (waitForSegment) done = segment !== null;
+		else done = textReply !== null;
+		if (done) break;
 		if (Date.now() >= deadline) break;
 		await sleep(100);
 	}
-	const message = textReply ?? latest;
+	let message = waitForSegment && segment !== null ? {
+		seq: segment.seq,
+		time: segment.time,
+		role: "assistant",
+		images: 0,
+		...segment.text !== void 0 ? { text: segment.text } : {},
+		...segment.reasoning !== void 0 ? { reasoning: segment.reasoning } : {},
+		...segment.toolCalls.length > 0 ? { toolCalls: segment.toolCalls } : {}
+	} : textReply ?? latest;
 	return {
 		message,
 		seq: message === null ? opts.baselineSeq : message.seq,
 		turnEnded,
-		timedOut: requireTurnEnd ? latest !== null && !turnEnded : textReply === null,
+		timedOut: requireTurnEnd ? latest !== null && !turnEnded : waitForSegment ? segment === null : textReply === null,
 		aborted: opts.signal !== void 0 && opts.signal.aborted,
 		waitedMs: Date.now() - started
 	};
@@ -9309,7 +9470,7 @@ async function attachSessionToWorkspace(ctx, sessionId, cwd) {
 * 纯读，无副作用。用于 `session_bridge_status`。
 */
 function statusSnapshot(ctx, agent) {
-	const events = agent.session.events;
+	const events = sessionEvents(agent.session);
 	const rows = foldMessages(events);
 	let lastActivityAt = null;
 	let lastTurn = 0;
@@ -9325,13 +9486,18 @@ function statusSnapshot(ctx, agent) {
 	}
 	const recent = rows.slice(-8);
 	let lastAssistantText;
+	let lastReasoning;
 	for (let i = rows.length - 1; i >= 0; i -= 1) {
 		const row = rows[i];
-		if (row !== void 0 && row.role === "assistant" && row.text !== void 0) {
-			lastAssistantText = row.text;
-			break;
+		if (row !== void 0 && row.role === "assistant") {
+			if (lastAssistantText === void 0 && row.text !== void 0) lastAssistantText = row.text;
+			if (lastReasoning === void 0 && row.reasoning !== void 0) lastReasoning = row.reasoning;
+			if (lastAssistantText !== void 0 && lastReasoning !== void 0) break;
 		}
 	}
+	const live = liveReasoningSnapshot(events);
+	const liveReasoning = live !== null && live.reasoning !== "" ? live.reasoning : void 0;
+	const reasoningTail = reasoningTailOf(liveReasoning, lastReasoning);
 	const inbox = agent.inbox;
 	const cwd = agent.session.header.cwd;
 	return {
@@ -9349,6 +9515,9 @@ function statusSnapshot(ctx, agent) {
 		nextTurnCount: inbox?.nextTurn?.length ?? 0,
 		nextStepCount: inbox?.nextStep?.length ?? 0,
 		...lastAssistantText === void 0 ? {} : { lastAssistantText },
+		...lastReasoning === void 0 ? {} : { lastReasoning },
+		...liveReasoning === void 0 ? {} : { liveReasoning },
+		...reasoningTail === void 0 ? {} : { reasoningTail },
 		messageCount: rows.length,
 		recent
 	};
@@ -9403,6 +9572,16 @@ var SessionMonitor = class {
 	start(config) {
 		const existing = this.entries.get(config.sessionId);
 		const now = Date.now();
+		const cotInit = { rules: (config.coTRules ?? []).reduce((acc, rule, index) => {
+			const key = String(index) + ":" + rule.match + ":" + rule.field + ":" + rule.value;
+			acc[key] = {
+				hits: 0,
+				lastFiredAt: null,
+				lastMatch: false,
+				lastSubject: ""
+			};
+			return acc;
+		}, {}) };
 		const entry = existing !== void 0 ? {
 			...existing,
 			config,
@@ -9416,8 +9595,10 @@ var SessionMonitor = class {
 			lastActionAt: null,
 			lastNote: "监控已启动",
 			done: false,
-			cycles: 0
+			cycles: 0,
+			cot: cotInit
 		};
+		if (entry.cot === void 0) entry.cot = cotInit;
 		this.entries.set(config.sessionId, entry);
 		this.ensureTimer();
 		this.log(entry, "monitor start session=" + config.sessionId + " interval=" + config.intervalMs + " stalled=" + String(config.stalledMs ?? 6e4) + " maxStuck=" + String(config.maxStuckCycles ?? 3));
@@ -9543,6 +9724,7 @@ var SessionMonitor = class {
 			this.log(entry, "STALL(#" + entry.stuckCount + ") → steer: " + steer);
 			return;
 		}
+		if (this.evaluateCoTRules(entry, snapshot, sessionId)) return;
 		if (entry.stuckCount !== 0) entry.stuckCount = 0;
 		entry.lastAction = "steady";
 		entry.lastActionAt = Date.now();
@@ -9567,6 +9749,76 @@ var SessionMonitor = class {
 		if (!text) return false;
 		return keywords.some((kw) => kw !== "" && text.includes(kw));
 	}
+	/**
+	* 评估思维链（CoT）规则。规则只对 live 会话有意义：running 时用进行中的
+	* reasoning-delta 流，空闲时回落到已定型 lastReasoning。not-contains 规则作用在
+	* reasoning 字段时，若该会话本就没有推理（非推理模型/尚未产出），不判定为命中，
+	* 避免误 cancel 一个根本不产生思维链的会话。
+	* @returns true 表示本 tick 已被某条规则触发并处理（steer/cancel），调用方应 return。
+	*/
+	evaluateCoTRules(entry, snapshot, sessionId) {
+		const rules = entry.config.coTRules ?? [];
+		if (rules.length === 0) return false;
+		const minHits = entry.config.cotMinHits ?? 1;
+		const hasLive = (snapshot.liveReasoning ?? "") !== "";
+		const subject = {
+			reasoning: snapshot.liveReasoning ?? snapshot.lastReasoning ?? "",
+			text: snapshot.lastAssistantText ?? "",
+			hasReasoning: hasLive || (snapshot.lastReasoning ?? "") !== ""
+		};
+		const now = Date.now();
+		const rulesState = entry.cot;
+		let engaged = false;
+		rules.forEach((rule, index) => {
+			if (engaged) return;
+			const key = String(index) + ":" + rule.match + ":" + rule.field + ":" + rule.value;
+			const st = rulesState.rules[key] ?? {
+				hits: 0,
+				lastFiredAt: null,
+				lastMatch: false
+			};
+			if (rule.field === "reasoning" && rule.match === "not-contains" && !subject.hasReasoning) {
+				st.lastMatch = false;
+				st.hits = 0;
+				return;
+			}
+			let hit;
+			if (rule.field === "reasoning") hit = rule.match === "contains" ? subject.reasoning.includes(rule.value) : !subject.reasoning.includes(rule.value);
+			else if (rule.field === "text") hit = rule.match === "contains" ? subject.text.includes(rule.value) : !subject.text.includes(rule.value);
+			else {
+				const reasonHas = subject.reasoning.includes(rule.value);
+				const textHas = subject.text.includes(rule.value);
+				hit = rule.match === "contains" ? reasonHas || textHas : !reasonHas && !textHas;
+			}
+			st.lastMatch = hit;
+			st.hits = hit ? st.hits + 1 : 0;
+			this.log(entry, "CoT rule " + key + " hit=" + String(hit) + " hits=" + String(st.hits) + "/" + String(minHits));
+			if (!(hit && st.hits >= minHits)) return;
+			const coolMs = Math.max(entry.config.intervalMs, 5e3) * 2;
+			if (st.lastFiredAt !== null && now - st.lastFiredAt < coolMs) return;
+			st.lastFiredAt = now;
+			if (rule.action === "cancel") {
+				const reason = "reasoning-rule:" + rule.value;
+				cancelLiveSession(this.ctx, sessionId, false, reason);
+				entry.lastAction = "cot-cancel";
+				entry.lastActionAt = Date.now();
+				entry.lastNote = "思维链规则触发 cancel: " + rule.value;
+				entry.stuckCount = 0;
+				this.log(entry, "COT-CANCEL session=" + sessionId + " rule=" + key + " value=" + rule.value);
+			} else {
+				const steer = rule.message !== void 0 && rule.message.trim() !== "" ? rule.message.trim() : "监控判定：思维链/回复匹配规则「" + rule.value + "」，请据此调整方向并继续推进任务。";
+				sendLiveMessage(this.ctx, sessionId, steer, "steer");
+				entry.lastAction = "cot-steer";
+				entry.lastActionAt = Date.now();
+				entry.lastNote = "思维链规则触发 steer: " + rule.value;
+				entry.stuckCount = 0;
+				this.log(entry, "COT-STEER session=" + sessionId + " rule=" + key + " steer=" + steer);
+			}
+			engaged = true;
+			st.hits = 0;
+		});
+		return engaged;
+	}
 	hasLlm() {
 		return this.ctx.llm !== void 0;
 	}
@@ -9622,7 +9874,7 @@ var SessionMonitor = class {
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-scope@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-invaria_cc61ed22356bd3509f8221ef1e37b1c1/node_modules/@deepseek-ai/dsh-scope/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-scope@0.1.2-alpha.2_@deepseek-ai+cordis@4.0.2_@deepseek-ai+dsh-invaria_51e6fefef6ddce4f991b3d02344a1a72/node_modules/@deepseek-ai/dsh-scope/lib/index.js
 /**
 * Shared insertion-ordered storage and effect ownership for scope-aware registries.
 *
@@ -9901,7 +10153,7 @@ function scopeTarget(base, key) {
 	return carrier;
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-tools@0.1.2-alpha.2_3813614b220b461dfd055a6c3c46e93f/node_modules/@deepseek-ai/dsh-tools/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-tools@0.1.2-alpha.2_96d3de6f0f5da790676b5bfb20e4a981/node_modules/@deepseek-ai/dsh-tools/lib/index.js
 /**
 * Enforced JSON Schema subset shared by tool outputs, generated PTC mode
 * types, subagents, and workflows. The subset accepts any JSON root, an
@@ -13403,7 +13655,7 @@ function toolAbortedBeforeDispatchResult(prior) {
 	};
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-agent@0.1.2-alpha.2_58555bdbcb744cce566f3f4d16801116/node_modules/@deepseek-ai/dsh-agent/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-agent@0.1.2-alpha.2_82401c175458b799db42b9e8f7dd7700/node_modules/@deepseek-ai/dsh-agent/lib/index.js
 /**
 * Agent-scoped model selection shared by runtime entry points.
 * @module @deepseek-ai/dsh-agent/model-selection
@@ -13633,7 +13885,7 @@ function registerCreate(env) {
 			});
 			let reply;
 			if (typeof args.prompt === "string" && args.prompt.trim() !== "") {
-				const baseline = maxSeq(agent.session.events);
+				const baseline = maxSeq(sessionEvents(agent.session));
 				agent.followup(userMessage(args.prompt.trim()));
 				env.registry.touch(sessionId);
 				if (args.waitForReply === true) reply = await maybeWait(env, agent.session, baseline, args, exec.signal);
@@ -13701,7 +13953,7 @@ function registerSend(env) {
 			if (typeof args.message !== "string" || args.message.trim() === "") throw new Error("invalid message: expected a non-empty string");
 			const agent = liveAgent(env, args.sessionId);
 			if (agent === void 0) throw new Error("session " + JSON.stringify(args.sessionId) + " is not live — call session_bridge_resume first to bring it online (or session_bridge_find to locate it)");
-			const baseline = maxSeq(agent.session.events);
+			const baseline = maxSeq(sessionEvents(agent.session));
 			if (args.mode === "steer") agent.steer(userMessage(args.message.trim()));
 			else agent.followup(userMessage(args.message.trim()));
 			const headerCwd = agent.session.header.cwd;
@@ -13764,7 +14016,7 @@ function registerResume(env) {
 					sessionId: args.sessionId,
 					alreadyLive: true,
 					...existing.session.header.cwd === void 0 ? {} : { cwd: existing.session.header.cwd },
-					title: titleOf(existing.session.events) ?? null,
+					title: titleOf(sessionEvents(existing.session)) ?? null,
 					running: existing.status === "running"
 				});
 			}
@@ -13797,7 +14049,7 @@ function registerResume(env) {
 				sessionId: args.sessionId,
 				resumed: true,
 				...headerCwd === void 0 ? {} : { cwd: headerCwd },
-				title: titleOf(handle.agent.session.events) ?? null
+				title: titleOf(sessionEvents(handle.agent.session)) ?? null
 			});
 		}
 	}));
@@ -13805,7 +14057,7 @@ function registerResume(env) {
 function registerWait(env) {
 	env.ctx.tools.register(defineTool({
 		name: "session_bridge_wait",
-		description: "Wait for a session next assistant reply: blocks (polling the session log) until a NEW assistant text reply appears after sinceSeq (default: the latest seq at call time). Returns the reply summary, or timedOut/aborted when the deadline or caller cancellation ends the wait. Use it to consume a reply produced asynchronously by another session (e.g. a session you sent a message to, or one working on its own).",
+		description: "Wait for a session next assistant output: blocks (polling the session log) until a NEW assistant output appears after sinceSeq (default: the latest seq at call time). waitFor=reply returns as soon as a new assistant TEXT reply is readable; waitFor=segment returns as soon as any new COMPLETED output segment appears (an assistant/message step — text, reasoning, or tool-call turn), i.e. it does NOT wait for the whole turn, so you can observe the chain-of-thought/output paragraph by paragraph as it is produced. Returns the output summary, or timedOut/aborted when the deadline or caller cancellation ends the wait. Use it to consume output produced asynchronously by another session (e.g. a session you sent a message to, or one working on its own).",
 		parameters: {
 			sessionId: {
 				type: "string",
@@ -13823,6 +14075,11 @@ function registerWait(env) {
 			requireTurnEnd: {
 				type: "boolean",
 				description: "When true, wait for the reply turn/end to settle before returning (default false; false returns as soon as the reply text is readable)."
+			},
+			waitFor: {
+				type: "string",
+				enum: ["reply", "segment"],
+				description: "reply (default) waits for a new assistant TEXT reply; segment waits for any new completed output segment (an assistant/message step, incl. reasoning/tool turns) and returns it immediately, without waiting for the whole turn."
 			}
 		},
 		output: {
@@ -13851,11 +14108,15 @@ function registerWait(env) {
 			if (typeof args.sessionId !== "string" || args.sessionId.trim() === "") throw new Error("invalid sessionId: expected a non-empty string");
 			const agent = liveAgent(env, args.sessionId);
 			if (agent === void 0) throw new Error("session " + JSON.stringify(args.sessionId) + " is not live — call session_bridge_resume first (waiting requires a live session)");
+			const waitSegment = args.waitFor === "segment";
 			let baseline;
 			if (typeof args.sinceSeq === "number" && Number.isInteger(args.sinceSeq) && args.sinceSeq >= 0) baseline = args.sinceSeq;
-			else {
+			else if (waitSegment) {
+				const segs = segmentsSince(sessionEvents(agent.session));
+				baseline = segs.length === 0 ? -1 : segs[segs.length - 1]?.seq ?? -1;
+			} else {
 				let lastText = -1;
-				for (const row of foldMessages(agent.session.events)) if (row.text !== void 0) lastText = row.seq;
+				for (const row of foldMessages(sessionEvents(agent.session))) if (row.text !== void 0) lastText = row.seq;
 				baseline = lastText;
 			}
 			const result = await waitForReply({
@@ -13863,7 +14124,8 @@ function registerWait(env) {
 				baselineSeq: baseline,
 				timeoutMs: clampTimeout(args.timeoutMs),
 				signal: exec.signal,
-				requireTurnEnd: args.requireTurnEnd === true
+				requireTurnEnd: args.requireTurnEnd === true,
+				...waitSegment ? { waitForSegment: true } : {}
 			});
 			env.registry.touch(args.sessionId);
 			return asJson({
@@ -13874,6 +14136,83 @@ function registerWait(env) {
 		}
 	}));
 }
+function registerSegments(env) {
+	env.ctx.tools.register(defineTool({
+		name: "session_bridge_segments",
+		description: "Read the completed output segments of a session incrementally - each finished assistant step (one assistant/message paragraph), without waiting for the whole turn. Pass sinceSeq to page forward. Use this to watch a session produce its chain-of-thought / output paragraph by paragraph as each step finishes.",
+		parameters: {
+			sessionId: {
+				type: "string",
+				required: true,
+				description: "Session id to read segments from (live or offline)."
+			},
+			sinceSeq: {
+				type: "number",
+				description: "Only return completed segments after this event seq (paging cursor)."
+			},
+			limit: {
+				type: "number",
+				description: "Maximum number of segments to return (default 10, max 50)."
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: true
+			},
+			render: (_args, value) => {
+				const segs = value.segments ?? [];
+				if (segs.length === 0) return [{
+					type: "text",
+					text: "(no completed segments)"
+				}];
+				return [{
+					type: "text",
+					text: segs.map((sg) => {
+						const head = "seg #" + String(sg.seq) + " (turn " + String(sg.turn) + " step " + String(sg.step) + ")";
+						const text = typeof sg.text === "string" ? sg.text : "";
+						const reason = typeof sg.reasoning === "string" && sg.reasoning !== "" ? " [reasoning " + sg.reasoning.length + " chars]" : "";
+						return head + (Array.isArray(sg.toolCalls) && sg.toolCalls.length > 0 ? " [tools: " + sg.toolCalls.join(",") + "]" : "") + reason + ": " + text.slice(0, 160);
+					}).join("\n")
+				}];
+			}
+		},
+		async execute(args) {
+			const agent = liveAgent(env, args.sessionId);
+			let events;
+			let live;
+			if (agent !== void 0) {
+				events = sessionEvents(agent.session);
+				live = true;
+			} else try {
+				events = (await env.ctx.sessionPersistence.inspect(args.sessionId)).events;
+				live = false;
+			} catch (error) {
+				throw new Error(String(error));
+			}
+			const sinceSeq = typeof args.sinceSeq === "number" && Number.isInteger(args.sinceSeq) && args.sinceSeq >= 0 ? args.sinceSeq : 0;
+			clampLimit(args.limit, 10, 50);
+			const segs = segmentsSince(events, sinceSeq);
+			env.registry.touch(args.sessionId);
+			const nextCursorSeq = segs.length === 0 ? sinceSeq : segs[segs.length - 1]?.seq ?? sinceSeq;
+			return asJson({
+				sessionId: args.sessionId,
+				live,
+				nextCursorSeq,
+				segments: segs.map((sg) => ({
+					seq: sg.seq,
+					time: sg.time,
+					turn: sg.turn,
+					step: sg.step,
+					openTurn: sg.openTurn,
+					...sg.text === void 0 ? {} : { text: sg.text },
+					...sg.reasoning === void 0 ? {} : { reasoning: sg.reasoning },
+					...sg.toolCalls.length > 0 ? { toolCalls: sg.toolCalls } : {}
+				}))
+			});
+		}
+	}));
+}
 function registerRead(env) {
 	env.ctx.tools.register(defineTool({
 		name: "session_bridge_read",
@@ -13934,7 +14273,7 @@ function registerRead(env) {
 			let live;
 			let cwd;
 			if (agent !== void 0) {
-				events = agent.session.events;
+				events = sessionEvents(agent.session);
 				live = true;
 				cwd = agent.session.header.cwd;
 			} else {
@@ -14051,7 +14390,7 @@ function registerFind(env) {
 				const wsId = wsById.get(agent.id) ?? workspaceByPath(env.ctx, headerCwd);
 				items.push({
 					sessionId: agent.id,
-					title: titleOf(agent.session.events),
+					title: titleOf(sessionEvents(agent.session)),
 					...headerCwd === void 0 ? {} : { cwd: headerCwd },
 					...wsId === void 0 ? {} : { workspaceId: wsId },
 					live: true,
@@ -14154,6 +14493,7 @@ function registerBridgeTools(env) {
 	registerSend(env);
 	registerResume(env);
 	registerWait(env);
+	registerSegments(env);
 	registerRead(env);
 	registerFind(env);
 	registerStatus(env);
@@ -14161,11 +14501,33 @@ function registerBridgeTools(env) {
 	registerMonitor(env);
 	registerArchive(env);
 }
+/** 校验并规范化 coRules 参数为 CoTRule[]；非法项抛清晰错误。 */
+function parseCoRules(raw) {
+	return raw.map((rule, index) => {
+		return {
+			match: rule.match === "contains" || rule.match === "not-contains" ? rule.match : (() => {
+				throw new Error("coRules[" + index + "].match must be \"contains\" or \"not-contains\"");
+			})(),
+			field: rule.field === "reasoning" || rule.field === "text" || rule.field === "both" ? rule.field : (() => {
+				throw new Error("coRules[" + index + "].field must be \"reasoning\", \"text\" or \"both\"");
+			})(),
+			action: rule.action === "steer" || rule.action === "cancel" ? rule.action : (() => {
+				throw new Error("coRules[" + index + "].action must be \"steer\" or \"cancel\"");
+			})(),
+			value: typeof rule.value === "string" && rule.value.trim() !== "" ? rule.value.trim() : (() => {
+				throw new Error("coRules[" + index + "].value must be a non-empty string");
+			})(),
+			...typeof rule.message === "string" && rule.message.trim() !== "" ? { message: rule.message.trim() } : {}
+		};
+	});
+}
 function renderMonitorState(entry) {
 	const lines = [];
 	lines.push(`monitoring ${entry.config.sessionId}${entry.config.label === void 0 ? "" : " (\"" + entry.config.label + "\")"}`);
 	lines.push(`interval: ${entry.config.intervalMs}ms | stalled: ${String(entry.config.stalledMs ?? 6e4)}ms | maxStuck: ${String(entry.config.maxStuckCycles ?? 3)}`);
 	lines.push(`cycles: ${entry.cycles} | stuck: ${entry.stuckCount} | lastAction: ${entry.lastAction}`);
+	const cotCount = (entry.config.coTRules ?? []).length;
+	if (cotCount > 0) lines.push(`coRules: ${cotCount} rule(s) (minHits ${String(entry.config.cotMinHits ?? 1)})`);
 	if (entry.lastNote !== "") lines.push(`note: ${entry.lastNote}`);
 	if (entry.done) lines.push("done: yes");
 	return lines;
@@ -14173,7 +14535,7 @@ function renderMonitorState(entry) {
 function registerMonitor(env) {
 	env.ctx.tools.register(defineTool({
 		name: "session_bridge_monitor_start",
-		description: "Start a background watchdog on a main session: poll its progress at an interval, and automatically schedule — steer the session when it stalls (or, with useLlm, when it drifts off-track), cancel it when it stays stuck past maxStuckCycles, and stop when a done keyword appears while idle. This is the \"monitor worker\" that watches a main task thread and corrects/stops it. Uses session_bridge_status-style facts; pass sessionId of a live session. Returns the watchdog state.",
+		description: "Start a background watchdog on a main session: poll its progress at an interval, and automatically schedule — steer the session when it stalls (or, with useLlm, when it drifts off-track), cancel it when it stays stuck past maxStuckCycles, and stop when a done keyword appears while idle. It can also enforce chain-of-thought rules via coRules: e.g. coRules=[{match:\"not-contains\",field:\"reasoning\",value:\"I'm\",action:\"cancel\"}] stops the session the moment its live reasoning stops containing I'm (evaluated on each poll while running). This is the \"monitor worker\" that watches a main task thread and corrects/stops it. Uses session_bridge_status-style facts; pass sessionId of a live session. Returns the watchdog state.",
 		parameters: {
 			sessionId: {
 				type: "string",
@@ -14212,6 +14574,51 @@ function registerMonitor(env) {
 			label: {
 				type: "string",
 				description: "Optional human label for logs/display."
+			},
+			coRules: {
+				type: "array",
+				items: {
+					type: "object",
+					additionalProperties: false,
+					properties: {
+						match: {
+							type: "string",
+							required: true,
+							enum: ["contains", "not-contains"],
+							description: "contains = must include value in the chosen field; not-contains = must NOT include it."
+						},
+						field: {
+							type: "string",
+							required: true,
+							enum: [
+								"reasoning",
+								"text",
+								"both"
+							],
+							description: "Match on reasoning (chain-of-thought), text (reply), or both (either)."
+						},
+						value: {
+							type: "string",
+							required: true,
+							description: "The substring to match (non-empty)."
+						},
+						action: {
+							type: "string",
+							required: true,
+							enum: ["steer", "cancel"],
+							description: "steer injects a guiding message; cancel terminates the session."
+						},
+						message: {
+							type: "string",
+							description: "Custom steer text (default is a guidance prompt)."
+						}
+					}
+				},
+				description: "Chain-of-thought rules: when a rule stays matched for cotMinHits consecutive polls (default 1), trigger its action. Example: [{match:\"not-contains\",field:\"reasoning\",value:\"I'm\",action:\"cancel\"}] stops the session the moment its live reasoning no longer contains I'm."
+			},
+			cotMinHits: {
+				type: "number",
+				description: "How many consecutive matched polls before a CoT rule fires (default 1 = immediately)."
 			}
 		},
 		output: {
@@ -14242,7 +14649,9 @@ function registerMonitor(env) {
 				...args.useLlm === true ? { useLlm: true } : {},
 				...typeof args.onStallSteer === "string" && args.onStallSteer.trim() !== "" ? { onStallSteer: args.onStallSteer.trim() } : {},
 				...typeof args.onOffTrackSteer === "string" && args.onOffTrackSteer.trim() !== "" ? { onOffTrackSteer: args.onOffTrackSteer.trim() } : {},
-				...typeof args.label === "string" && args.label.trim() !== "" ? { label: args.label.trim() } : {}
+				...typeof args.label === "string" && args.label.trim() !== "" ? { label: args.label.trim() } : {},
+				...Array.isArray(args.coRules) && args.coRules.length > 0 ? { coTRules: parseCoRules(args.coRules) } : {},
+				...typeof args.cotMinHits === "number" && Number.isInteger(args.cotMinHits) && args.cotMinHits >= 1 ? { cotMinHits: Math.floor(args.cotMinHits) } : {}
 			};
 			const entry = env.monitor.start(config);
 			env.registry.touch(args.sessionId);
@@ -14314,7 +14723,19 @@ function registerMonitor(env) {
 		}
 	}));
 }
-/** 渲染监控快照为一行摘要：运行态 + openTurn + 卡住/待处理 + 最新回复。 */
+/** 按 reasoning 选项裁剪快照里的思维链字段（避免入 token 时有 diff 语义差）。 */
+function pruneReasoning(snapshot, mode) {
+	if (mode === "tail") return snapshot;
+	const rest = { ...snapshot };
+	delete rest.reasoningTail;
+	if (mode === "none") {
+		delete rest.lastReasoning;
+		delete rest.liveReasoning;
+	} else if (mode === "last") delete rest.liveReasoning;
+	else delete rest.lastReasoning;
+	return rest;
+}
+/** 渲染监控快照为一行摘要：运行态 + openTurn + 卡住/待处理 + 最新回复(+ 思维链预览)。 */
 function renderStatus(snapshot, stalledMsThreshold) {
 	const lines = [];
 	const runLabel = snapshot.running === "running" ? "running" : "idle";
@@ -14327,12 +14748,16 @@ function renderStatus(snapshot, stalledMsThreshold) {
 	}
 	if (snapshot.pendingWork) lines.push(`pendingWork: ${snapshot.nextTurnCount} turn + ${snapshot.nextStepCount} step`);
 	if (snapshot.lastAssistantText !== void 0) lines.push(`lastReply: ${snapshot.lastAssistantText}`);
+	if (snapshot.reasoningTail !== void 0 && snapshot.reasoningTail !== "") {
+		const preview = snapshot.reasoningTail.length > 160 ? snapshot.reasoningTail.slice(0, 160) + "…" : snapshot.reasoningTail;
+		lines.push(`reasoning: ${preview}`);
+	}
 	return lines;
 }
 function registerStatus(env) {
 	env.ctx.tools.register(defineTool({
 		name: "session_bridge_status",
-		description: "Inspect a session's live progress for monitoring/scheduling. Returns running/idle, whether a turn is open, last turn number, time since the last event (for stall detection), pending queued work, and the latest text reply. When stalledMsThreshold is given, marks the session as stalled when the time since the last event exceeds it. Pass sessionId of a live session (use session_bridge_find to locate; session_bridge_resume to bring an offline one online). Use this as the \"observe\" step of a monitor→decide→steer/cancel loop.",
+		description: "Inspect a session's live progress for monitoring/scheduling. Returns running/idle, whether a turn is open, last turn number, time since the last event (for stall detection), pending queued work, and the latest text reply. It also surfaces the session's chain-of-thought: lastReasoning is the most recent finalized reasoning block, liveReasoning is the in-flight reasoning streamed for the current handled turn (reasoning-delta), and reasoningTail is a compact merged preview. reasoning=none drops all three to keep tokens small. When stalledMsThreshold is given, marks the session as stalled when the time since the last event exceeds it. Pass sessionId of a live session (use session_bridge_find to locate; session_bridge_resume to bring an offline one online). Use this as the \"observe\" step of a monitor→decide→steer/cancel loop.",
 		parameters: {
 			sessionId: {
 				type: "string",
@@ -14346,6 +14771,16 @@ function registerStatus(env) {
 			recent: {
 				type: "number",
 				description: "Number of recent messages to include in the snapshot (default 8, max 20)."
+			},
+			reasoning: {
+				type: "string",
+				enum: [
+					"none",
+					"last",
+					"live",
+					"tail"
+				],
+				description: "Which chain-of-thought fields to include: tail (default) returns lastReasoning/liveReasoning/reasoningTail; last only the finalized reasoning; live only the in-flight reasoning; none drops all reasoning fields."
 			}
 		},
 		output: {
@@ -14371,7 +14806,8 @@ function registerStatus(env) {
 			const agent = liveAgent(env, args.sessionId);
 			if (agent === void 0) throw new Error("session " + JSON.stringify(args.sessionId) + " is not live — call session_bridge_resume first (status requires a live session)");
 			const threshold = typeof args.stalledMsThreshold === "number" && Number.isFinite(args.stalledMsThreshold) && args.stalledMsThreshold >= 0 ? args.stalledMsThreshold : 6e4;
-			const snapshot = statusSnapshot(env.ctx, agent);
+			const reasoningMode = args.reasoning === "none" || args.reasoning === "last" || args.reasoning === "live" ? args.reasoning : "tail";
+			const snapshot = pruneReasoning(statusSnapshot(env.ctx, agent), reasoningMode);
 			const shown = typeof args.recent === "number" && Number.isInteger(args.recent) && args.recent >= 0 ? Math.min(args.recent, 20) : 8;
 			const envCwd = agent.session.header.cwd;
 			env.registry.touch(args.sessionId, {