@rivus/agent 0.16.0 → 0.16.2

package/dist/chunks/src.js

@@ -3423,10 +3423,17 @@ function toDomainEvent(runId, sessionKey, event, occurredAt) {
 //#endregion
 //#region src/core/application/agent-execution/execution/agent-harness.ts
 function createSteeringChannel() {
-	return Queue.unbounded().pipe(Effect.map((queue) => ({
-		next: () => Queue.take(queue),
-		push: (text) => Queue.offer(queue, text).pipe(Effect.asVoid)
-	})));
+	return Queue.unbounded().pipe(Effect.map((queue) => {
+		let closed = false;
+		return {
+			next: () => Queue.take(queue),
+			close: () => Effect.gen(function* () {
+				closed = true;
+				return Array.from(yield* Queue.takeAll(queue));
+			}),
+			push: (text) => Effect.sync(() => !closed && Queue.unsafeOffer(queue, text))
+		};
+	}));
 }
 function createAgentHarness$1(options) {
 	if (options.runTimeoutMs !== void 0 && (!Number.isSafeInteger(options.runTimeoutMs) || options.runTimeoutMs < 1)) throw new Error("Agent run timeout must be a positive integer");
@@ -3643,8 +3650,7 @@ function createAgentHarness$1(options) {
 	const requestSteering = (runId, text) => Effect.gen(function* () {
 		const normalized = text.trim();
 		if (!normalized || !options.loop.supportsSteering || !activeRun || activeRun.runId !== runId || !activeCancellation || activeCancellation.requested) return false;
-		yield* activeCancellation.steering.push(normalized);
-		return true;
+		return yield* activeCancellation.steering.push(normalized);
 	});
 	const requestSessionCancellation = (sessionKey, runId, reason) => {
 		if (!activeRun || activeRun.sessionKey !== sessionKey) return Effect.succeed(false);
@@ -5588,9 +5594,207 @@ function cardPresentationLeaseDeadline(at, leaseMs) {
 	return new Date(atMs + validateCardPresentationLeaseMs(leaseMs)).toISOString();
 }
 //#endregion
+//#region src/adapters/feishu/run-presentation/feishu-run-presentation-renderer.ts
+function renderFeishuRunProgress(presentation) {
+	const visible = presentation.steps.filter(isVisibleStep);
+	const running = [...visible].reverse().find((step) => step.status === "running");
+	const title = visible.length === 0 ? "执行过程 · 展开查看" : presentation.phase === "running" && running ? `执行过程 · ${runningLabel(running)}` : `执行过程 · ${visible.length} 段 · ${presentation.totalToolCallCount} 次工具调用`;
+	return {
+		markdown: [...presentation.omittedStepCount > 0 ? [`> 另有 ${presentation.omittedStepCount} 个较早步骤未展示`] : [], ...renderProgressSteps(visible)].join("\n\n") || "正在准备执行…",
+		title
+	};
+}
+function renderFeishuRunTimeline(presentation, options) {
+	const visible = presentation.steps.filter(isVisibleStep);
+	const elements = [];
+	for (let index = 0; index < visible.length;) {
+		const step = visible[index];
+		if (step.kind !== "tool") {
+			elements.push(...renderTimelineStep(step, options.expanded));
+			index += 1;
+			continue;
+		}
+		const tools = [];
+		while (index < visible.length && visible[index]?.kind === "tool") {
+			tools.push(visible[index]);
+			index += 1;
+		}
+		elements.push(renderToolSequence(tools, options.expanded));
+	}
+	return {
+		elements,
+		inspectable: visible.some((step) => step.kind === "skill" || step.kind === "tool")
+	};
+}
+function renderFeishuVisibleAnswer(presentation, currentText) {
+	const committed = presentation?.steps.filter((step) => step.kind === "assistant").map((step) => step.text.trim()).filter(Boolean) ?? [];
+	const current = currentText.trim();
+	return [...committed, ...current ? [current] : []].join("\n\n");
+}
+function renderProgressSteps(steps) {
+	const rendered = [];
+	for (let index = 0; index < steps.length;) {
+		const step = steps[index];
+		if (step.kind !== "tool") {
+			rendered.push(renderStep(step));
+			index += 1;
+			continue;
+		}
+		const tools = [];
+		while (index < steps.length && steps[index]?.kind === "tool") {
+			tools.push(steps[index]);
+			index += 1;
+		}
+		rendered.push(tools.map(renderToolSummary).join("\n"));
+	}
+	return rendered;
+}
+function renderToolSequence(tools, expanded) {
+	if (tools.length === 1) return {
+		content: renderToolSummary(tools[0]),
+		tag: "markdown"
+	};
+	return collapsiblePanel({
+		content: tools.map(renderToolSummary).join("\n"),
+		expanded: expanded || tools.some((tool) => tool.status === "running"),
+		title: toolSequenceTitle(tools)
+	});
+}
+function toolSequenceTitle(tools) {
+	if ([...tools].reverse().find((tool) => tool.status === "running")) return `执行过程 · ${tools.length} 个工具 · 进行中`;
+	if (tools.some((tool) => tool.status === "failed")) return `执行过程 · ${tools.length} 个工具 · 有失败`;
+	const totalDuration = tools.reduce((total, tool) => total + (tool.durationMs ?? 0), 0);
+	return totalDuration > 0 ? `执行过程 · ${tools.length} 个工具 · 已完成 · ${formatDuration$1(totalDuration)}` : `执行过程 · ${tools.length} 个工具 · 已完成`;
+}
+function renderToolSummary(step) {
+	const skill = step.skillId ? ` · ${escapeInline(step.skillId)}` : "";
+	const duration = step.durationMs === void 0 ? "" : ` · ${formatDuration$1(step.durationMs)}`;
+	return `- ${statusIcon(step.status)} **${escapeInline(toolAction(step.toolName))}**${skill}${duration}`;
+}
+function renderTimelineStep(step, expandCompleted) {
+	switch (step.kind) {
+		case "assistant": return [{
+			content: step.text,
+			margin: "0px",
+			tag: "markdown",
+			text_align: "left",
+			text_size: "normal"
+		}];
+		case "skill": return [collapsiblePanel({
+			content: skillDetails(step),
+			expanded: step.status === "running" || expandCompleted,
+			title: `${step.skillId} · ${step.status === "running" ? "读取中" : step.status === "failed" ? "读取失败" : "已读取"}`
+		})];
+		case "tool": return [{
+			content: renderToolSummary(step),
+			tag: "markdown"
+		}];
+		case "model":
+		case "response": return [];
+	}
+}
+function collapsiblePanel(options) {
+	return {
+		background_color: options.expanded ? "blue-50" : "grey-50",
+		elements: [{
+			content: options.content,
+			tag: "markdown",
+			text_align: "left",
+			text_size: "normal"
+		}],
+		expanded: options.expanded,
+		header: {
+			expanded_title: {
+				content: options.title,
+				tag: "plain_text",
+				text_align: "left"
+			},
+			icon: {
+				color: "grey",
+				tag: "standard_icon",
+				token: "down-small-ccm_outlined"
+			},
+			icon_expanded_angle: -180,
+			icon_position: "right",
+			padding: "8px 12px 8px 12px",
+			title: {
+				content: options.title,
+				tag: "plain_text",
+				text_align: "left"
+			},
+			width: "fill"
+		},
+		margin: "8px 0px 0px 0px",
+		padding: "12px 12px 12px 12px",
+		tag: "collapsible_panel"
+	};
+}
+function skillDetails(step) {
+	const duration = step.durationMs === void 0 ? "" : ` · ${formatDuration$1(step.durationMs)}`;
+	return [`**${statusLabel(step.status)}**${duration}`, `这一步：读取并应用技能 \`${escapeInline(step.skillId)}\` 的任务说明。`].join("\n\n");
+}
+function statusLabel(status) {
+	switch (status) {
+		case "completed": return "已完成";
+		case "failed": return "未完成";
+		case "running": return "进行中";
+	}
+}
+function toolAction(toolName) {
+	const normalized = toolName.toLowerCase();
+	const executable = normalized.split(/[\\/]/u).at(-1) ?? normalized;
+	if (executable === "bash" || executable === "exec" || executable === "exec_command") return "执行命令";
+	if (normalized.includes("read") && normalized.includes("file")) return "读取文件";
+	if (normalized.includes("write") && normalized.includes("file")) return "写入文件";
+	if (normalized.includes("search") || normalized === "rg") return "搜索内容";
+	if (normalized.includes("fetch") || normalized.includes("http")) return "访问服务";
+	return `调用 ${toolName.replace(/^.*[\\/]/u, "")}`;
+}
+function renderStep(step) {
+	const duration = step.durationMs === void 0 ? "" : ` · ${formatDuration$1(step.durationMs)}`;
+	switch (step.kind) {
+		case "assistant": return step.text;
+		case "model": return `- ${statusIcon(step.status)} ${step.label}${duration}`;
+		case "skill": return `- ${statusIcon(step.status)} ${step.label} \`${escapeInline(step.skillId)}\`${duration}`;
+		case "response": return `- ${statusIcon(step.status)} ${step.label}${duration}`;
+		case "tool": return renderToolSummary(step);
+	}
+}
+function isVisibleStep(step) {
+	return step.kind === "assistant" || step.kind === "skill" || step.kind === "tool";
+}
+function runningLabel(step) {
+	switch (step.kind) {
+		case "assistant": return "正在说明进展";
+		case "model": return "正在分析";
+		case "skill": return "正在读取技能";
+		case "tool": return `正在调用 ${step.toolName}`;
+		case "response": return "正在整理回答";
+	}
+}
+function statusIcon(status) {
+	switch (status) {
+		case "completed": return "✅";
+		case "failed": return "⚠️";
+		case "running": return "⏳";
+	}
+}
+function formatDuration$1(milliseconds) {
+	if (milliseconds < 1e3) return `${milliseconds} 毫秒`;
+	if (milliseconds < 6e4) {
+		const seconds = milliseconds / 1e3;
+		return `${Number(seconds.toFixed(seconds < 10 ? 1 : 0))} 秒`;
+	}
+	return `${Math.floor(milliseconds / 6e4)} 分 ${Math.floor(milliseconds % 6e4 / 1e3)} 秒`;
+}
+function escapeInline(value) {
+	return value.replace(/`/g, "ˋ");
+}
+//#endregion
 //#region src/adapters/feishu/card-presentation/rollover/feishu-card-rollover.ts
 function createFeishuCardRollover(options) {
 	const leaseMs = validateCardPresentationLeaseMs(options.leaseMs ?? 51e4);
+	const progressDisplay = options.progressDisplay ?? "collapsed";
 	const counters = createCounters();
 	const latestPresentationByRun = /* @__PURE__ */ new Map();
 	const latestTextByRun = /* @__PURE__ */ new Map();
@@ -5598,6 +5802,7 @@ function createFeishuCardRollover(options) {
 	const liveRuns = /* @__PURE__ */ new Map();
 	const semaphore = Effect.unsafeMakeSemaphore(1);
 	const exclusive = (effect) => semaphore.withPermits(1)(effect);
+	const exclusiveDeferred = (factory) => semaphore.withPermits(1)(Effect.suspend(factory));
 	const record = (event, at) => {
 		counters[event.type] += 1;
 		options.observe?.({
@@ -5606,36 +5811,86 @@ function createFeishuCardRollover(options) {
 		});
 	};
 	const recordNow = (event) => options.clock.now.pipe(Effect.map((at) => record(event, at)));
+	const failHandoffAndRecord = (input) => options.store.failHandoff({
+		failedAt: input.failedAt,
+		runId: input.runId
+	}).pipe(Effect.catchAll((storeError) => recordNow({
+		error: storeError,
+		runId: input.runId,
+		type: "presentation_write_failed"
+	})), Effect.flatMap(() => recordNow({
+		cardId: input.predecessor.cardId,
+		error: input.error,
+		generation: input.generation,
+		presentationId: input.predecessor.presentationId,
+		runId: input.runId,
+		...input.successorCardId === void 0 ? {} : { successorCardId: input.successorCardId },
+		type: input.type
+	})), Effect.as({ error: input.error }));
 	const leaseDeadline = (at) => cardPresentationLeaseDeadline(at.toISOString(), leaseMs);
 	const presentationId = (runId, generation) => `${runId}#${generation}`;
-	const publishProgress = (action) => Effect.suspend(() => {
+	const publishProgress = (action) => Effect.gen(function* () {
 		const chain = options.store.chain(action.runId);
-		if (chain && acceptsCardPresentationProgress(chain)) {
-			if (action.type === "update_text") latestTextByRun.set(action.runId, action.text);
-			else {
-				latestPresentationByRun.set(action.runId, action.presentation);
-				latestTextByRun.set(action.runId, action.presentation.answer.text);
-			}
-			const run = liveRuns.get(action.runId);
-			if (!run) return options.publisher.publish(action);
-			const baseline = generationBaselineByRun.get(action.runId);
-			const text = projectText(latestTextByRun.get(action.runId), baseline?.text);
-			const presentation = projectPresentation(latestPresentationByRun.get(action.runId), baseline);
-			return options.publisher.publish({
-				...presentation === void 0 ? {} : { presentation },
+		if (!chain) {
+			yield* recordNow({
 				runId: action.runId,
-				sessionKey: run.sessionKey,
-				...text === void 0 ? {} : { text },
-				type: "update_presentation"
+				type: "stale_update_dropped"
 			});
+			return;
 		}
-		return recordNow({
-			...chain ? {
+		const previousPresentation = latestPresentationByRun.get(action.runId);
+		const visibleChanged = hasVisibleIncrement(previousPresentation, latestTextByRun.get(action.runId), action.type === "update_progress" ? action.presentation : previousPresentation, action.type === "update_text" ? action.text : action.presentation.answer.text, progressDisplay);
+		const run = liveRuns.get(action.runId);
+		const acceptsProgress = acceptsCardPresentationProgress(chain);
+		if (!acceptsProgress && !(run !== void 0)) {
+			yield* recordNow({
 				generation: chain.activeGeneration,
-				presentationId: chain.activePresentationId
-			} : {},
+				presentationId: chain.activePresentationId,
+				runId: action.runId,
+				type: "stale_update_dropped"
+			});
+			return;
+		}
+		if (run && acceptsProgress) {
+			const now = yield* options.clock.now;
+			if (visibleChanged && isCardPresentationHandoffDue(chain, now.toISOString())) {
+				if (yield* options.publisher.flush(action.runId).pipe(Effect.map(() => true), Effect.catchAll((error) => recordNow({
+					error,
+					runId: action.runId,
+					type: "presentation_write_failed"
+				}).pipe(Effect.as(false))))) yield* runHandoff(action.runId, true);
+			}
+		}
+		if (action.type === "update_text") latestTextByRun.set(action.runId, action.text);
+		else {
+			latestPresentationByRun.set(action.runId, action.presentation);
+			latestTextByRun.set(action.runId, action.presentation.answer.text);
+		}
+		const currentChain = options.store.chain(action.runId);
+		if (!currentChain || !acceptsCardPresentationProgress(currentChain)) {
+			yield* recordNow({
+				...currentChain ? {
+					generation: currentChain.activeGeneration,
+					presentationId: currentChain.activePresentationId
+				} : {},
+				runId: action.runId,
+				type: "stale_update_dropped"
+			});
+			return;
+		}
+		if (!run) {
+			yield* options.publisher.publish(action);
+			return;
+		}
+		const baseline = generationBaselineByRun.get(action.runId);
+		const text = projectText(latestTextByRun.get(action.runId), baseline?.text);
+		const presentation = projectPresentation(latestPresentationByRun.get(action.runId), baseline);
+		yield* options.publisher.publish({
+			...presentation === void 0 ? {} : { presentation },
 			runId: action.runId,
-			type: "stale_update_dropped"
+			sessionKey: run.sessionKey,
+			...text === void 0 ? {} : { text },
+			type: "update_presentation"
 		});
 	});
 	const publishTerminal = (action) => {
@@ -5675,7 +5930,7 @@ function createFeishuCardRollover(options) {
 			default: return publishTerminal(action);
 		}
 	};
-	const runHandoff = (runId) => Effect.gen(function* () {
+	const runHandoff = (runId, triggeredByVisibleProgress) => Effect.gen(function* () {
 		const run = liveRuns.get(runId);
 		if (!run) return {
 			reason: "not-live",
@@ -5687,6 +5942,10 @@ function createFeishuCardRollover(options) {
 			reason: "not-due",
 			status: "skipped"
 		};
+		if (!triggeredByVisibleProgress) return {
+			reason: "not-due",
+			status: "skipped"
+		};
 		const start = yield* options.store.beginHandoff({
 			handoffAt: startedAt.toISOString(),
 			runId
@@ -5714,27 +5973,20 @@ function createFeishuCardRollover(options) {
 			generation,
 			presentationId: successorId,
 			run
-		}).pipe(Effect.map((target) => ({ target })), Effect.catchAll((error) => options.store.failHandoff({
-			failedAt: startedAt.toISOString(),
-			runId
-		}).pipe(Effect.catchAll((storeError) => recordNow({
-			error: storeError,
-			runId,
-			type: "presentation_write_failed"
-		})), Effect.flatMap(() => recordNow({
-			cardId: predecessor.cardId,
+		}).pipe(Effect.map((target) => ({ target })), Effect.catchAll((error) => failHandoffAndRecord({
 			error,
+			failedAt: startedAt.toISOString(),
 			generation,
-			presentationId: predecessor.presentationId,
+			predecessor,
 			runId,
 			type: "handoff_failed"
-		})), Effect.as({ error }))));
+		})));
 		if ("error" in created) return {
 			error: created.error,
 			status: "failed"
 		};
 		const adoptedAt = yield* options.clock.now;
-		const presentation = yield* options.store.completeHandoff({
+		const completed = yield* options.store.completeHandoff({
 			runId,
 			successor: {
 				cardId: created.target.cardId,
@@ -5743,7 +5995,20 @@ function createFeishuCardRollover(options) {
 				leaseDeadlineAt: leaseDeadline(adoptedAt),
 				presentationId: successorId
 			}
-		});
+		}).pipe(Effect.map((presentation) => ({ presentation })), Effect.catchAll((error) => failHandoffAndRecord({
+			error,
+			failedAt: adoptedAt.toISOString(),
+			generation,
+			predecessor,
+			runId,
+			successorCardId: created.target.cardId,
+			type: "presentation_write_failed"
+		})));
+		if ("error" in completed) return {
+			error: completed.error,
+			status: "failed"
+		};
+		const presentation = completed.presentation;
 		record({
 			cardId: predecessor.cardId,
 			generation,
@@ -5787,8 +6052,8 @@ function createFeishuCardRollover(options) {
 				return chain !== void 0 && isCardPresentationHandoffDue(chain, nowIso);
 			});
 		},
-		flush: (runId) => exclusive(options.publisher.flush(runId)),
-		handoff: (runId) => exclusive(runHandoff(runId)),
+		flush: (runId) => exclusiveDeferred(() => options.publisher.flush(runId)),
+		handoff: (runId) => exclusive(runHandoff(runId, false)),
 		observeStreamClosed: (cardId) => {
 			counters.stream_closed += 1;
 			options.observe?.({
@@ -5796,7 +6061,7 @@ function createFeishuCardRollover(options) {
 				type: "stream_closed"
 			});
 		},
-		publish: (action) => exclusive(publishAction(action)),
+		publish: (action) => exclusiveDeferred(() => publishAction(action)),
 		releaseRun: (runId) => Effect.sync(() => {
 			latestTextByRun.delete(runId);
 			latestPresentationByRun.delete(runId);
@@ -5830,16 +6095,26 @@ function projectText(text, baseline) {
 	if (text === baseline) return "";
 	return text.startsWith(baseline) ? text.slice(baseline.length) : text;
 }
+function hasVisibleIncrement(previousPresentation, previousText, nextPresentation, nextText, progressDisplay) {
+	const baseline = previousPresentation === void 0 && previousText === void 0 ? void 0 : {
+		...previousPresentation === void 0 ? {} : { presentation: previousPresentation },
+		...previousText === void 0 ? {} : { text: previousText }
+	};
+	const text = projectText(nextText, previousText) ?? "";
+	const presentation = projectPresentation(nextPresentation, baseline);
+	if (renderFeishuVisibleAnswer(presentation, text).trim().length > 0) return true;
+	return progressDisplay !== "hidden" && (presentation?.steps.some((step) => step.kind === "skill" || step.kind === "tool") ?? false);
+}
 function projectPresentation(presentation, baseline) {
 	if (!presentation || !baseline) return presentation;
-	const previous = new Map(baseline.presentation?.steps.map((step) => [step.id, JSON.stringify(step)]) ?? []);
+	const previous = new Map(baseline.presentation?.steps.filter((step) => step.kind === "assistant" || step.kind === "skill" || step.kind === "tool").map((step) => [step.id, visibleStepSignature(step)]) ?? []);
 	let skippedCommittedBaselineText = false;
 	const steps = presentation.steps.filter((step) => {
 		if (!skippedCommittedBaselineText && step.kind === "assistant" && baseline.text?.trim() && step.text.trim() === baseline.text.trim() && !previous.has(step.id)) {
 			skippedCommittedBaselineText = true;
 			return false;
 		}
-		return previous.get(step.id) !== JSON.stringify(step);
+		return (step.kind === "assistant" || step.kind === "skill" || step.kind === "tool") && previous.get(step.id) !== visibleStepSignature(step);
 	});
 	const answer = projectText(presentation.answer.text, baseline.text) ?? "";
 	if (steps.length === 0 && answer.trim() === "") return void 0;
@@ -5855,6 +6130,25 @@ function projectPresentation(presentation, baseline) {
 		totalToolCallCount: steps.filter((step) => step.kind === "tool").length
 	};
 }
+function visibleStepSignature(step) {
+	if (step.kind === "assistant") return JSON.stringify({
+		id: step.id,
+		kind: step.kind,
+		text: step.text
+	});
+	return step.kind === "skill" ? JSON.stringify({
+		id: step.id,
+		kind: step.kind,
+		skillId: step.skillId,
+		status: step.status
+	}) : JSON.stringify({
+		id: step.id,
+		kind: step.kind,
+		skillId: step.skillId,
+		status: step.status,
+		toolName: step.toolName
+	});
+}
 function projectTerminalAction(action, baseline) {
 	if (!baseline || action.type !== "finish" && action.type !== "fail" && action.type !== "cancel") return action;
 	const presentation = action.presentation ? projectPresentation(action.presentation, baseline) : void 0;
@@ -5923,20 +6217,20 @@ function createCoalescingFeishuPublisher(options) {
 	const pendingProgressByRun = /* @__PURE__ */ new Map();
 	const pendingPresentationByRun = /* @__PURE__ */ new Map();
 	const flushText = (runId, text) => Effect.gen(function* () {
-		pendingTextByRun.delete(runId);
 		yield* options.publisher.publish({
 			runId,
 			text,
 			type: "update_text"
 		});
+		if (pendingTextByRun.get(runId) === text) pendingTextByRun.delete(runId);
 	});
 	const flushProgress = (runId, presentation) => Effect.gen(function* () {
-		pendingProgressByRun.delete(runId);
 		yield* options.publisher.publish({
 			presentation,
 			runId,
 			type: "update_progress"
 		});
+		if (pendingProgressByRun.get(runId) === presentation) pendingProgressByRun.delete(runId);
 	});
 	const flushRun = (runId) => {
 		const text = pendingTextByRun.get(runId);
@@ -5944,10 +6238,10 @@ function createCoalescingFeishuPublisher(options) {
 		const presentation = pendingPresentationByRun.get(runId);
 		return Effect.gen(function* () {
 			if (presentation !== void 0) {
-				pendingPresentationByRun.delete(runId);
 				yield* options.publisher.publish(presentation);
-				pendingProgressByRun.delete(runId);
-				pendingTextByRun.delete(runId);
+				if (pendingPresentationByRun.get(runId) === presentation) pendingPresentationByRun.delete(runId);
+				if (pendingProgressByRun.get(runId) === progress) pendingProgressByRun.delete(runId);
+				if (pendingTextByRun.get(runId) === text) pendingTextByRun.delete(runId);
 				return;
 			}
 			if (progress !== void 0) yield* flushProgress(runId, progress);
@@ -6077,203 +6371,6 @@ function createConfiguredFeishuOpenApiClient(options) {
 	});
 }
 //#endregion
-//#region src/adapters/feishu/run-presentation/feishu-run-presentation-renderer.ts
-function renderFeishuRunProgress(presentation) {
-	const visible = presentation.steps.filter(isVisibleStep);
-	const running = [...visible].reverse().find((step) => step.status === "running");
-	const title = visible.length === 0 ? "执行过程 · 展开查看" : presentation.phase === "running" && running ? `执行过程 · ${runningLabel(running)}` : `执行过程 · ${visible.length} 段 · ${presentation.totalToolCallCount} 次工具调用`;
-	return {
-		markdown: [...presentation.omittedStepCount > 0 ? [`> 另有 ${presentation.omittedStepCount} 个较早步骤未展示`] : [], ...renderProgressSteps(visible)].join("\n\n") || "正在准备执行…",
-		title
-	};
-}
-function renderFeishuRunTimeline(presentation, options) {
-	const visible = presentation.steps.filter(isVisibleStep);
-	const elements = [];
-	for (let index = 0; index < visible.length;) {
-		const step = visible[index];
-		if (step.kind !== "tool") {
-			elements.push(...renderTimelineStep(step, options.expanded));
-			index += 1;
-			continue;
-		}
-		const tools = [];
-		while (index < visible.length && visible[index]?.kind === "tool") {
-			tools.push(visible[index]);
-			index += 1;
-		}
-		elements.push(renderToolSequence(tools, options.expanded));
-	}
-	return {
-		elements,
-		inspectable: visible.some((step) => step.kind === "skill" || step.kind === "tool")
-	};
-}
-function renderFeishuVisibleAnswer(presentation, currentText) {
-	const committed = presentation?.steps.filter((step) => step.kind === "assistant").map((step) => step.text.trim()).filter(Boolean) ?? [];
-	const current = currentText.trim();
-	return [...committed, ...current ? [current] : []].join("\n\n");
-}
-function renderProgressSteps(steps) {
-	const rendered = [];
-	for (let index = 0; index < steps.length;) {
-		const step = steps[index];
-		if (step.kind !== "tool") {
-			rendered.push(renderStep(step));
-			index += 1;
-			continue;
-		}
-		const tools = [];
-		while (index < steps.length && steps[index]?.kind === "tool") {
-			tools.push(steps[index]);
-			index += 1;
-		}
-		rendered.push(tools.map(renderToolSummary).join("\n"));
-	}
-	return rendered;
-}
-function renderToolSequence(tools, expanded) {
-	if (tools.length === 1) return {
-		content: renderToolSummary(tools[0]),
-		tag: "markdown"
-	};
-	return collapsiblePanel({
-		content: tools.map(renderToolSummary).join("\n"),
-		expanded: expanded || tools.some((tool) => tool.status === "running"),
-		title: toolSequenceTitle(tools)
-	});
-}
-function toolSequenceTitle(tools) {
-	if ([...tools].reverse().find((tool) => tool.status === "running")) return `执行过程 · ${tools.length} 个工具 · 进行中`;
-	if (tools.some((tool) => tool.status === "failed")) return `执行过程 · ${tools.length} 个工具 · 有失败`;
-	const totalDuration = tools.reduce((total, tool) => total + (tool.durationMs ?? 0), 0);
-	return totalDuration > 0 ? `执行过程 · ${tools.length} 个工具 · 已完成 · ${formatDuration$1(totalDuration)}` : `执行过程 · ${tools.length} 个工具 · 已完成`;
-}
-function renderToolSummary(step) {
-	const skill = step.skillId ? ` · ${escapeInline(step.skillId)}` : "";
-	const duration = step.durationMs === void 0 ? "" : ` · ${formatDuration$1(step.durationMs)}`;
-	return `- ${statusIcon(step.status)} **${escapeInline(toolAction(step.toolName))}**${skill}${duration}`;
-}
-function renderTimelineStep(step, expandCompleted) {
-	switch (step.kind) {
-		case "assistant": return [{
-			content: step.text,
-			margin: "0px",
-			tag: "markdown",
-			text_align: "left",
-			text_size: "normal"
-		}];
-		case "skill": return [collapsiblePanel({
-			content: skillDetails(step),
-			expanded: step.status === "running" || expandCompleted,
-			title: `${step.skillId} · ${step.status === "running" ? "读取中" : step.status === "failed" ? "读取失败" : "已读取"}`
-		})];
-		case "tool": return [{
-			content: renderToolSummary(step),
-			tag: "markdown"
-		}];
-		case "model":
-		case "response": return [];
-	}
-}
-function collapsiblePanel(options) {
-	return {
-		background_color: options.expanded ? "blue-50" : "grey-50",
-		elements: [{
-			content: options.content,
-			tag: "markdown",
-			text_align: "left",
-			text_size: "normal"
-		}],
-		expanded: options.expanded,
-		header: {
-			expanded_title: {
-				content: options.title,
-				tag: "plain_text",
-				text_align: "left"
-			},
-			icon: {
-				color: "grey",
-				tag: "standard_icon",
-				token: "down-small-ccm_outlined"
-			},
-			icon_expanded_angle: -180,
-			icon_position: "right",
-			padding: "8px 12px 8px 12px",
-			title: {
-				content: options.title,
-				tag: "plain_text",
-				text_align: "left"
-			},
-			width: "fill"
-		},
-		margin: "8px 0px 0px 0px",
-		padding: "12px 12px 12px 12px",
-		tag: "collapsible_panel"
-	};
-}
-function skillDetails(step) {
-	const duration = step.durationMs === void 0 ? "" : ` · ${formatDuration$1(step.durationMs)}`;
-	return [`**${statusLabel(step.status)}**${duration}`, `这一步：读取并应用技能 \`${escapeInline(step.skillId)}\` 的任务说明。`].join("\n\n");
-}
-function statusLabel(status) {
-	switch (status) {
-		case "completed": return "已完成";
-		case "failed": return "未完成";
-		case "running": return "进行中";
-	}
-}
-function toolAction(toolName) {
-	const normalized = toolName.toLowerCase();
-	const executable = normalized.split(/[\\/]/u).at(-1) ?? normalized;
-	if (executable === "bash" || executable === "exec" || executable === "exec_command") return "执行命令";
-	if (normalized.includes("read") && normalized.includes("file")) return "读取文件";
-	if (normalized.includes("write") && normalized.includes("file")) return "写入文件";
-	if (normalized.includes("search") || normalized === "rg") return "搜索内容";
-	if (normalized.includes("fetch") || normalized.includes("http")) return "访问服务";
-	return `调用 ${toolName.replace(/^.*[\\/]/u, "")}`;
-}
-function renderStep(step) {
-	const duration = step.durationMs === void 0 ? "" : ` · ${formatDuration$1(step.durationMs)}`;
-	switch (step.kind) {
-		case "assistant": return step.text;
-		case "model": return `- ${statusIcon(step.status)} ${step.label}${duration}`;
-		case "skill": return `- ${statusIcon(step.status)} ${step.label} \`${escapeInline(step.skillId)}\`${duration}`;
-		case "response": return `- ${statusIcon(step.status)} ${step.label}${duration}`;
-		case "tool": return renderToolSummary(step);
-	}
-}
-function isVisibleStep(step) {
-	return step.kind === "assistant" || step.kind === "skill" || step.kind === "tool";
-}
-function runningLabel(step) {
-	switch (step.kind) {
-		case "assistant": return "正在说明进展";
-		case "model": return "正在分析";
-		case "skill": return "正在读取技能";
-		case "tool": return `正在调用 ${step.toolName}`;
-		case "response": return "正在整理回答";
-	}
-}
-function statusIcon(status) {
-	switch (status) {
-		case "completed": return "✅";
-		case "failed": return "⚠️";
-		case "running": return "⏳";
-	}
-}
-function formatDuration$1(milliseconds) {
-	if (milliseconds < 1e3) return `${milliseconds} 毫秒`;
-	if (milliseconds < 6e4) {
-		const seconds = milliseconds / 1e3;
-		return `${Number(seconds.toFixed(seconds < 10 ? 1 : 0))} 秒`;
-	}
-	return `${Math.floor(milliseconds / 6e4)} 分 ${Math.floor(milliseconds % 6e4 / 1e3)} 秒`;
-}
-function escapeInline(value) {
-	return value.replace(/`/g, "ˋ");
-}
-//#endregion
 //#region src/adapters/feishu/run-presentation/feishu-agent-run-card.ts
 const FEISHU_AGENT_CARD_ELEMENT_ID = "rivus_agent_answer";
 const FEISHU_AGENT_CARD_PROGRESS_ELEMENT_ID = "rivus_agent_progress";
@@ -6704,6 +6801,7 @@ function createConfiguredFeishuCardRolloverRuntime(options) {
 		}),
 		leaseMs,
 		...options.observe ? { observe: options.observe } : {},
+		progressDisplay,
 		publisher,
 		store: options.cardTargets
 	});
@@ -6718,7 +6816,7 @@ function createConfiguredFeishuCardRolloverRuntime(options) {
 	const streaming = createPeriodicEffectLoop({
 		intervalMs: options.flushIntervalMs ?? options.config.feishu.streamMinIntervalMs,
 		...options.onError ? { onError: options.onError } : {},
-		run: () => publisher.flush(),
+		run: () => cardRollover.flush(),
 		sleep: options.sleep
 	});
 	return {
@@ -7654,22 +7752,114 @@ function resolveContentMode(value) {
 	throw new LangfuseTelemetryConfigError("RIVUS_TELEMETRY_CONTENT must be either \"metadata-only\" or \"redacted\"");
 }
 //#endregion
+//#region src/adapters/pi/execution/pi-session-prompts.ts
+/** One ordinary prompt writer, with ordered native steering while that prompt is streaming. */
+async function runPiSessionPrompts(options) {
+	const { input, handle } = options;
+	const { session } = handle;
+	const prepare = (text) => handle.preparePrompt?.({
+		...input,
+		text
+	}) ?? text;
+	if (!options.supportsSteering) {
+		const text = await prepare(input.text);
+		if (!input.abortSignal.aborted) await session.prompt(text);
+		return;
+	}
+	if (!session.steer || typeof session.isStreaming !== "boolean" || !session.clearQueue) throw new Error("Pi steering requires native steer, isStreaming and clearQueue capabilities");
+	const mailbox = input.steering;
+	const stop = new AbortController();
+	const onAbort = () => stop.abort();
+	input.abortSignal.addEventListener("abort", onAbort, { once: true });
+	if (input.abortSignal.aborted) stop.abort();
+	const close = () => Effect.runPromise(mailbox?.close?.() ?? Effect.succeed([]));
+	const take = () => Effect.runPromise(mailbox?.next() ?? Effect.never, { signal: stop.signal }).then((text) => ({
+		type: "steering",
+		text
+	}), (error) => {
+		if (stop.signal.aborted) return { type: "closed" };
+		throw error;
+	});
+	let prompt = Promise.resolve({ type: "completed" });
+	const startPrompt = (text) => {
+		prompt = session.prompt(text).then(() => ({ type: "completed" }), (error) => ({
+			type: "failed",
+			error
+		}));
+	};
+	const settlePrompt = async () => {
+		const outcome = await prompt;
+		if (outcome.type === "failed") throw outcome.error;
+	};
+	let next;
+	let succeeded = false;
+	try {
+		const text = await prepare(input.text);
+		if (input.abortSignal.aborted) return;
+		startPrompt(text);
+		next = take();
+		while (!input.abortSignal.aborted) {
+			const outcome = await Promise.race([next, prompt]);
+			if (outcome.type === "failed") throw outcome.error;
+			if (outcome.type === "closed") break;
+			if (outcome.type === "completed") {
+				const remaining = await close();
+				stop.abort();
+				const claimed = await next;
+				const accepted = claimed.type === "steering" ? [claimed.text, ...remaining] : remaining;
+				for (const acceptedText of accepted) {
+					const prepared = await prepare(acceptedText);
+					if (input.abortSignal.aborted) return;
+					startPrompt(prepared);
+					await settlePrompt();
+				}
+				succeeded = true;
+				return;
+			}
+			const prepared = await prepare(outcome.text);
+			if (input.abortSignal.aborted) break;
+			if (session.isStreaming) await session.steer(prepared);
+			else {
+				await settlePrompt();
+				if (input.abortSignal.aborted) break;
+				startPrompt(prepared);
+			}
+			next = take();
+		}
+	} finally {
+		input.abortSignal.removeEventListener("abort", onAbort);
+		await close();
+		stop.abort();
+		await next;
+		const cancelledOrFailed = !succeeded || input.abortSignal.aborted;
+		if (cancelledOrFailed) await options.abort();
+		await prompt;
+		if (cancelledOrFailed) session.clearQueue();
+	}
+}
+//#endregion
 //#region src/adapters/pi/execution/pi-agent-loop.ts
 function createPiAgentLoop$1(options) {
-	return { run: (input) => {
-		const stream = Stream.fromAsyncIterable(runPiSession(input, options), (error) => error);
-		if (!options.runBoundary) return stream;
-		return Stream.unwrapScoped(Effect.acquireRelease(options.runBoundary.acquireRun({ signal: input.abortSignal }), (lease) => Effect.sync(lease.release)).pipe(Effect.as(stream)));
-	} };
+	return {
+		...options.supportsSteering ? { supportsSteering: true } : {},
+		run: (input) => {
+			const stream = Stream.fromAsyncIterable(runPiSession(input, options), (error) => error);
+			if (!options.runBoundary) return stream;
+			return Stream.unwrapScoped(Effect.acquireRelease(options.runBoundary.acquireRun({ signal: input.abortSignal }), (lease) => Effect.sync(lease.release)).pipe(Effect.as(stream)));
+		}
+	};
 }
 function createPiSdkAgentLoop$1(options) {
-	return createPiAgentLoop$1({ resolveSession: async () => {
-		const result = await options.createAgentSession(options.sessionOptions);
-		return {
-			dispose: () => result.session.dispose?.(),
-			session: result.session
-		};
-	} });
+	return createPiAgentLoop$1({
+		...options.supportsSteering ? { supportsSteering: true } : {},
+		resolveSession: async () => {
+			const result = await options.createAgentSession(options.sessionOptions);
+			return {
+				dispose: () => result.session.dispose?.(),
+				session: result.session
+			};
+		}
+	});
 }
 async function* runPiSession(input, options) {
 	const queue = createAsyncQueue();
@@ -7726,7 +7916,12 @@ async function* runPiSession(input, options) {
 					queue.offer(mapped);
 				}
 			});
-			await handle.session.prompt(handle.preparePrompt ? await handle.preparePrompt(input) : input.text);
+			await runPiSessionPrompts({
+				input,
+				handle,
+				supportsSteering: options.supportsSteering === true,
+				abort: abortSession
+			});
 			complete(input.abortSignal.aborted || terminalErrorMessage === void 0 ? void 0 : new Error(terminalErrorMessage));
 		} catch (error) {
 			complete(input.abortSignal.aborted ? void 0 : error);
@@ -7986,6 +8181,7 @@ function createAsyncQueue() {
 //#region src/adapters/compatibility/agent-execution/pi/pi-agent-loop.ts
 function createPiAgentLoop(options) {
 	return fromEffectAgentLoop(createPiAgentLoop$1({
+		...options.supportsSteering ? { supportsSteering: true } : {},
 		...options.disposeSessionAfterRun === void 0 ? {} : { disposeSessionAfterRun: options.disposeSessionAfterRun },
 		...options.modelContentObserver ? { modelContentObserver: options.modelContentObserver } : {},
 		...options.runBoundary ? { runBoundary: options.runBoundary } : {},