@rivus/agent 0.16.0 → 0.16.1

package/dist/bootstrap/pi-feishu.js

@@ -1,15 +1,15 @@
+import { i as resolvePiSessionToolNames, l as validatePiSkillCommand, m as createPiBashTool, n as createPiToolProxyDefinitions, p as createPiSkillReadTools, r as createPiSessionResources, t as createPiToolNameResolver } from "../chunks/pi.js";
 import { d as resolveInvocationAuthority, r as createPiSkillRuntime, s as createToolInputDigest, u as createInvocationAuthority } from "../chunks/rivus-tool.js";
 import { $t as openJsonlRecoveryControl, A as createScheduledAutomation, An as createLangfuseAgentTelemetry, Bn as createFeishuTopicContextResolver, Dn as createPiAgentLoop, Dt as createBackgroundSessionHostTools, Ei as openJsonFeishuSessionStore, En as createPiSessionRegistry, Gi as readPersistenceFile, Hi as ToolInvocationDenied, Ii as createFeishuCardDeliveryReconciler, In as createJsonlAgentEventLog, Ji as mergePiProviderModelDeclaration, Jt as createFeishuPresentationPreparation, K as createRivusMemoryToolDescriptor, Ki as isRecord$4, Lt as createBackgroundSessionService, Nt as openJsonlBackgroundSessionDeliveryStore, Oi as openJsonlFeishuInboxRepository, Ot as createBackgroundSessionSupervisor, Pi as openJsonlFeishuCardDeliveryLedger, Qr as createUuidRunIds, Si as createJsonFetchRequest, Ti as createSessionScheduler, Tn as readAutomationPresentation, Ui as createToolBroker, Un as createConfiguredFeishuTextReplySender, W as createProjectMemoryPromptPreparer, Wi as openJsonlToolOperationLedger, Wn as createConfiguredFeishuCardRolloverRuntime, Xt as createAgentHarnessPooledRuntime, Yi as writeAtomicTextFile, Yt as createFeishuDeploymentEndpoint, Zr as createSystemClock, an as createAgentsMdInstructionsProvider, bn as createJsonFileFeishuCardTargetRegistry, c as createConfiguredFeishuAutomationCardSender, d as createHumanInteractionToolApprovalGateway, en as openJsonlToolOperationLedger$1, f as createHumanInteractionEndpointRegistry, g as loadRivusDeploymentManifest, hr as createLazyFeishuWebSocketEventDispatcher, ht as resolveFeishuDeliveryChatId, ii as createAgentHarness, j as AUTOMATION_SUPPRESSION_PREFIX, jn as resolveLangfuseTelemetryConfig, jt as openJsonlBackgroundSessionRepository, k as openJsonAutomationTickRepository, l as createRoutedHumanInteractionToolApprovalService, mn as createFeishuCotPublisher, mt as createConfiguredFeishuBackgroundSessionDelivery, n as createConfiguredFeishuHumanInteractionPresenter, o as createJsonlHumanInteractionRepository, on as createWorkspaceRootHandle, qi as mergePiProviderBaseUrlOverride, t as createHumanInteractionService, tn as createToolBroker$1, tr as createConfiguredFeishuOpenApiClient, u as createHumanInteractionModelChangeApproval, wt as resolveBackgroundSessionSupervisorIntervalMs, z as openJsonlAgentMemoryService } from "../chunks/src.js";
 import { I as resolveFeishuEndpointCredentials, J as migrateRivusModelManagementConfig, K as installRivusModelManagementCliLauncher, U as runDeploymentProcessEffect, X as loadMergedLocalEnvFile, Y as parseRivusModelManagementHomeConfig, q as installRivusRuntimeManagementSkill } from "../chunks/rivus-daemon-cli.js";
 import { t as createSha256Digest } from "../chunks/sha256-digest.js";
 import { a as toRivusModelManagementSubmission, i as projectRivusModelCliResponse, r as parseRivusModelManagementWireRequest, t as createRivusModelManagementFailure } from "../chunks/rivus-model-management-wire.js";
 import { f as createBackgroundSessionStepSourceMessageId } from "../chunks/background-session-authority.js";
-import { i as resolvePiSessionToolNames, l as validatePiSkillCommand, n as createPiToolProxyDefinitions, p as createPiSkillReadTools, r as createPiSessionResources, t as createPiToolNameResolver } from "../chunks/pi.js";
 import { Effect, Either } from "effect";
 import { createHash, randomUUID } from "node:crypto";
 import { chmod, mkdir, open, readFile, realpath, rename, stat, unlink } from "node:fs/promises";
 import { delimiter, dirname, isAbsolute, join, relative, resolve } from "node:path";
-import { ModelRuntime, SessionManager, SettingsManager, createAgentSession, createBashToolDefinition, defineTool, estimateTokens } from "@earendil-works/pi-coding-agent";
+import { ModelRuntime, SessionManager, SettingsManager, createAgentSession, estimateTokens } from "@earendil-works/pi-coding-agent";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
 import { Type } from "typebox";
@@ -155,26 +155,29 @@ function createPiManagedSessionContext(options) {
 			if (input.invocation?.kind === "feishu" && input.invocation.allowedActorOpenIds.length === 1) context = options.contexts.issue(input);
 		},
 		deactivate,
-		tool: defineTool(createBashToolDefinition(options.cwd, { spawnHook: (spawn) => {
-			const { RIVUS_MODEL_CONTEXT: _context, RIVUS_MODEL_SOCKET: _socket, ...baseEnv } = spawn.env;
-			const prepared = {
-				...spawn,
-				env: {
-					...baseEnv,
-					PATH: [
-						options.binDirectory,
-						dirname(options.nodeExecutable),
-						baseEnv.PATH
-					].filter(Boolean).join(delimiter),
-					RIVUS_MODEL_MANAGEMENT_ENABLED: "true",
-					RIVUS_MODEL_SOCKET: options.socketPath
-				}
-			};
-			return context ? createPiModelManagementBashSpawnHook({
-				context,
-				socketPath: options.socketPath
-			})(prepared) : prepared;
-		} }))
+		tool: createPiBashTool(options.cwd, {
+			...options.bashToolOptions,
+			spawnHook: (spawn) => {
+				const { RIVUS_MODEL_CONTEXT: _context, RIVUS_MODEL_SOCKET: _socket, ...baseEnv } = spawn.env;
+				const prepared = {
+					...spawn,
+					env: {
+						...baseEnv,
+						PATH: [
+							options.binDirectory,
+							dirname(options.nodeExecutable),
+							baseEnv.PATH
+						].filter(Boolean).join(delimiter),
+						RIVUS_MODEL_MANAGEMENT_ENABLED: "true",
+						RIVUS_MODEL_SOCKET: options.socketPath
+					}
+				};
+				return context ? createPiModelManagementBashSpawnHook({
+					context,
+					socketPath: options.socketPath
+				})(prepared) : prepared;
+			}
+		})
 	};
 }
 //#endregion
@@ -4054,13 +4057,6 @@ async function createRivusDeploymentAdapters(context) {
 				}) : void 0;
 				const sessionRegistry = createPiSessionRegistry({ createSession: async (firstInput) => {
 					let activeInput = firstInput;
-					const managedContext = management?.enabled && runContexts && input.definition.runtimeToolGrantSet.toolIds.includes("bash") ? createPiManagedSessionContext({
-						binDirectory: management.binDirectory,
-						contexts: runContexts.registry,
-						cwd: workingDirectory,
-						nodeExecutable: process.execPath,
-						socketPath: management.socketPath
-					}) : void 0;
 					const resources = await createPiSessionResources({
 						agentDir: PI_AGENT_DIR,
 						appendSystemPromptOverride: () => [workspaceInstructions.content, skillRuntime.prompt].filter((content) => content.length > 0),
@@ -4069,8 +4065,17 @@ async function createRivusDeploymentAdapters(context) {
 						...input.projectSpace ? { projectSkillPaths: input.projectSpace.skillPaths } : {},
 						systemPromptOverride: () => input.definition.systemPrompt
 					});
+					const managedContext = management?.enabled && runContexts && input.definition.runtimeToolGrantSet.toolIds.includes("bash") ? createPiManagedSessionContext({
+						...resources.bashToolOptions ? { bashToolOptions: resources.bashToolOptions } : {},
+						binDirectory: management.binDirectory,
+						contexts: runContexts.registry,
+						cwd: workingDirectory,
+						nodeExecutable: process.execPath,
+						socketPath: management.socketPath
+					}) : void 0;
+					const bashTool = input.definition.runtimeToolGrantSet.toolIds.includes("bash") ? managedContext?.tool ?? createPiBashTool(workingDirectory, resources.bashToolOptions) : void 0;
 					const customTools = [
-						...managedContext ? [managedContext.tool] : [],
+						...bashTool ? [bashTool] : [],
 						...createPiSkillReadTools({
 							cwd: workingDirectory,
 							runtimeToolIds: input.definition.runtimeToolGrantSet.toolIds,
@@ -4088,7 +4093,7 @@ async function createRivusDeploymentAdapters(context) {
 						}),
 						...skillRuntime.tool ? [skillRuntime.tool] : []
 					];
-					const activeToolNames = resolvePiSessionToolNames(managedContext ? input.definition.runtimeToolGrantSet.toolIds.filter((toolId) => toolId !== "bash") : input.definition.runtimeToolGrantSet.toolIds, customTools);
+					const activeToolNames = resolvePiSessionToolNames(bashTool ? input.definition.runtimeToolGrantSet.toolIds.filter((toolId) => toolId !== "bash") : input.definition.runtimeToolGrantSet.toolIds, customTools);
 					const result = await createAgentSession(resources.withSessionOptions({
 						...piOptions,
 						...management?.enabled ? management.runtime.getSessionOptions() : {},
@@ -4115,6 +4120,7 @@ async function createRivusDeploymentAdapters(context) {
 				} });
 				const unregisterModels = management?.enabled ? management.runtime.registerSessionRegistry(sessionRegistry) : void 0;
 				const loop = createPiAgentLoop({
+					supportsSteering: true,
 					disposeSessionAfterRun: false,
 					...management?.enabled ? { runBoundary: management.boundary } : {},
 					...telemetry ? { modelContentObserver: telemetry.modelContentObserver } : {},

package/dist/chunks/agent-loop.d.ts

@@ -416,7 +416,8 @@ interface AgentLoopInput {
   readonly steering?: AgentSteeringChannel;
 }
 interface AgentSteeringChannel {
-  next(): Promise<string>;
+  next(signal?: AbortSignal): Promise<string>;
+  close?(): Promise<readonly string[]>;
 }
 interface AgentLoop {
   run(input: AgentLoopInput): Stream.Stream<AgentLoopEvent, unknown>;

package/dist/chunks/agent-loop.js

@@ -117,14 +117,20 @@ function toEffectAgentLoopInput(input) {
 	const { steering, ...rest } = input;
 	return {
 		...rest,
-		...steering ? { steering: { next: () => Effect.promise(() => steering.next()) } } : {}
+		...steering ? { steering: {
+			...steering.close ? { close: () => Effect.promise(() => steering.close()) } : {},
+			next: () => Effect.promise((signal) => steering.next(signal))
+		} } : {}
 	};
 }
 function toCompatibilityAgentLoopInput(input) {
 	const { steering, ...rest } = input;
 	return {
 		...rest,
-		...steering ? { steering: { next: () => Effect.runPromise(steering.next()) } } : {}
+		...steering ? { steering: {
+			...steering.close ? { close: () => Effect.runPromise(steering.close()) } : {},
+			next: (signal) => Effect.runPromise(steering.next(), { signal })
+		} } : {}
 	};
 }
 function isPromiseLike(value) {

package/dist/chunks/index.d.ts

@@ -1808,6 +1808,7 @@ interface FeishuCardRolloverOptions {
   readonly createSuccessor: (request: FeishuCardRolloverSuccessorRequest) => Effect.Effect<FeishuCardRolloverTarget, unknown>;
   readonly leaseMs?: number;
   readonly observe?: (event: FeishuCardRolloverEvent) => void;
+  readonly progressDisplay?: ConversationProgressDisplay;
   readonly publisher: FeishuCardRolloverStreamPublisher;
   readonly store: FeishuCardPresentationStore;
 }
@@ -2989,6 +2990,10 @@ interface PiSessionManager {
 }
 interface PiAgentSession {
   abort?: () => Promise<void> | void;
+  /** Native queue operations required when the loop opts into steering. */
+  steer?(text: string): Promise<void> | void;
+  readonly isStreaming?: boolean;
+  clearQueue?(): unknown;
   setModel?(model: unknown): Promise<void> | void;
   setThinkingLevel?(level: string): void;
   waitForIdle?(): Promise<void>;
@@ -3003,6 +3008,7 @@ interface PiCreateAgentSessionResult {
   readonly session: PiAgentSession;
 }
 interface PiSdkAgentLoopOptions<TSessionOptions = unknown> {
+  readonly supportsSteering?: boolean;
   readonly createAgentSession: (options: TSessionOptions | undefined) => Promise<PiCreateAgentSessionResult> | PiCreateAgentSessionResult;
   readonly sessionOptions?: TSessionOptions;
 }
@@ -3018,6 +3024,7 @@ interface PiAgentSessionHandle {
   readonly refreshResources?: () => Promise<void> | void;
 }
 interface PiAgentLoopOptions {
+  readonly supportsSteering?: boolean;
   readonly resolveSession: (input: AgentLoopInput) => Promise<PiAgentSessionHandle> | PiAgentSessionHandle;
   readonly modelContentObserver?: AgentModelContentObserver;
   readonly disposeSessionAfterRun?: boolean;

package/dist/chunks/pi.js

@@ -4,9 +4,39 @@ import { t as createSha256Digest } from "./sha256-digest.js";
 import { createHash } from "node:crypto";
 import { readFile, realpath, stat } from "node:fs/promises";
 import { isAbsolute, join, relative } from "node:path";
-import { DefaultResourceLoader, SettingsManager, createReadToolDefinition } from "@earendil-works/pi-coding-agent";
+import { DefaultResourceLoader, SettingsManager, createBashToolDefinition, createReadToolDefinition, defineTool } from "@earendil-works/pi-coding-agent";
 import { Unsafe } from "typebox";
 import { realpathSync, statSync } from "node:fs";
+//#region src/adapters/pi/tool-execution/pi-bash-tool.ts
+const DEFAULT_TIMEOUT_SECONDS = 120;
+/** Keep Pi's native execution, rendering and abort cleanup with a bounded default. */
+function createPiBashTool(cwd, options) {
+	const { commandPrefix, shellPath, spawnHook } = options ?? {};
+	const tool = createBashToolDefinition(cwd, {
+		...commandPrefix === void 0 ? {} : { commandPrefix },
+		...shellPath === void 0 ? {} : { shellPath },
+		...spawnHook === void 0 ? {} : { spawnHook }
+	});
+	return defineTool({
+		...tool,
+		description: `${tool.description} Defaults to ${DEFAULT_TIMEOUT_SECONDS} seconds when timeout is omitted; set an explicit positive timeout for longer commands.`,
+		parameters: {
+			...tool.parameters,
+			properties: {
+				...tool.parameters.properties,
+				timeout: {
+					...tool.parameters.properties.timeout,
+					description: `Timeout in seconds (optional, defaults to ${DEFAULT_TIMEOUT_SECONDS})`
+				}
+			}
+		},
+		execute: (id, args, signal, onUpdate, context) => tool.execute(id, {
+			...args,
+			timeout: args.timeout === void 0 ? DEFAULT_TIMEOUT_SECONDS : args.timeout
+		}, signal, onUpdate, context)
+	});
+}
+//#endregion
 //#region src/adapters/pi/skills/pi-skill-read-tool.ts
 var ProjectSkillReadDenied = class extends Error {
 	name = "ProjectSkillReadDenied";
@@ -165,12 +195,19 @@ const PI_BEHAVIOR_SETTING_KEYS = Object.freeze([
 ]);
 async function createPiSessionResources(options) {
 	const settingsManager = createSanitizedSettingsManager(options.cwd, options.agentDir, options.settingsOverrides);
+	const commandPrefix = settingsManager.getShellCommandPrefix();
+	const shellPath = settingsManager.getShellPath();
+	const bashToolOptions = commandPrefix === void 0 && shellPath === void 0 ? void 0 : Object.freeze({
+		...commandPrefix === void 0 ? {} : { commandPrefix },
+		...shellPath === void 0 ? {} : { shellPath }
+	});
 	let skillPaths = await resolveSkillPaths(options);
 	let currentResourceLoader = createResourceLoader(options, settingsManager, skillPaths);
 	await currentResourceLoader.reload();
 	let skillNames = validatePiSkillCatalog(currentResourceLoader.getSkills());
 	const resourceLoader = createResourceLoaderFacade(() => currentResourceLoader, settingsManager);
 	return {
+		...bashToolOptions === void 0 ? {} : { bashToolOptions },
 		get skillNames() {
 			return skillNames;
 		},
@@ -366,4 +403,4 @@ function createPiToolNameResolver(tools) {
 	return createPiToolNameResolver$1(tools);
 }
 //#endregion
-export { InvalidPiSkillSource as a, validatePiSkillCatalog as c, createPiProjectSkillReadTool as d, createPiSkillReadTool as f, resolvePiSessionToolNames as i, validatePiSkillCommand as l, createPiToolProxyDefinitions as n, resolvePiSkillSources as o, createPiSkillReadTools as p, createPiSessionResources as r, InvalidPiSkillCatalog as s, createPiToolNameResolver as t, ProjectSkillReadDenied as u };
+export { InvalidPiSkillSource as a, validatePiSkillCatalog as c, createPiProjectSkillReadTool as d, createPiSkillReadTool as f, resolvePiSessionToolNames as i, validatePiSkillCommand as l, createPiBashTool as m, createPiToolProxyDefinitions as n, resolvePiSkillSources as o, createPiSkillReadTools as p, createPiSessionResources as r, InvalidPiSkillCatalog as s, createPiToolNameResolver as t, ProjectSkillReadDenied as u };

package/dist/chunks/rivus-daemon-cli.js

@@ -2350,7 +2350,7 @@ function createProcessDeploymentAdapterPorts(factories, runEffect) {
 		runtimeFactory: { create: (input) => Effect.tryPromise({
 			try: () => Promise.resolve(factories.createRuntime(input)),
 			catch: toError$3
-		}).pipe(Effect.map((runtime) => toDeploymentRuntime(runtime, runEffect))) }
+		}).pipe(Effect.map((runtime) => toEffectAgentRuntime(runtime, runEffect))) }
 	};
 }
 function adaptEndpointFactory(create, input, runEffect) {
@@ -2408,19 +2408,6 @@ function adaptBackgroundSessionFactory(create, input, runEffect) {
 		catch: toError$3
 	});
 }
-function toDeploymentRuntime(runtime, runEffect) {
-	const adapted = toEffectAgentRuntime(runtime, runEffect);
-	const cancel = adapted.cancel?.bind(adapted);
-	const dispose = adapted.dispose?.bind(adapted);
-	const steer = adapted.steer?.bind(adapted);
-	return {
-		...adapted.concurrency ? { concurrency: adapted.concurrency } : {},
-		...cancel ? { cancel: (input) => cancel(input).pipe(Effect.mapError(toError$3)) } : {},
-		...dispose ? { dispose: () => dispose().pipe(Effect.mapError(toError$3)) } : {},
-		run: (input) => adapted.run(input).pipe(Effect.mapError(toError$3)),
-		...steer ? { steer: (input) => steer(input).pipe(Effect.mapError(toError$3)) } : {}
-	};
-}
 function toLifecycleAdapter(adapter) {
 	return {
 		running: () => adapter.running(),

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 } : {},

package/dist/pi.d.ts

@@ -66,6 +66,23 @@ interface PiNamedTool {
 }
 declare function resolvePiSessionToolNames(runtimeToolIds: ReadonlyArray<RivusRuntimeToolId>, customTools: ReadonlyArray<PiNamedTool>): ReadonlyArray<string>;
 //#endregion
+//#region src/adapters/pi/tool-execution/pi-bash-tool-options.d.ts
+interface PiBashSpawnContext {
+  command: string;
+  cwd: string;
+  env: Record<string, string | undefined>;
+}
+/** Rivus's Bash configuration boundary, independent of provider UI/model types. */
+interface PiBashToolOptions {
+  commandPrefix?: string;
+  shellPath?: string;
+  spawnHook?: (context: PiBashSpawnContext) => PiBashSpawnContext;
+}
+//#endregion
+//#region src/adapters/pi/tool-execution/pi-bash-tool.d.ts
+/** Keep Pi's native execution, rendering and abort cleanup with a bounded default. */
+declare function createPiBashTool(cwd: string, options?: PiBashToolOptions): PiToolDefinition;
+//#endregion
 //#region src/adapters/pi/runtime/pi-session-resources.d.ts
 interface CreatePiSessionResourcesOptions {
   readonly agentDir: string;
@@ -77,6 +94,10 @@ interface CreatePiSessionResourcesOptions {
   readonly systemPromptOverride?: (base: string | undefined) => string | undefined;
 }
 interface PiSessionResources {
+  readonly bashToolOptions?: {
+    readonly commandPrefix?: string;
+    readonly shellPath?: string;
+  };
   readonly skillNames: ReadonlySet<string>;
   readonly skillPaths: ReadonlyArray<string>;
   readonly refresh: () => Promise<void>;
@@ -105,4 +126,4 @@ interface PiToolProxyOptions {
 declare function createPiToolProxyDefinitions(options: PiToolProxyOptions): PiToolDefinition[];
 declare function createPiToolNameResolver(tools: ReadonlyArray<Pick<RivusResolvedToolDescriptor, "id">>): (toolName: string) => string;
 //#endregion
-export { type CreatePiSessionResourcesOptions, InvalidPiSkillCatalog, InvalidPiSkillSource, type PiSessionResources, type PiSkillRuntime, type PiToolApprovalGateway, type PiToolApprovalRequest, type PiToolContent, type PiToolDefinition, type PiToolProxyOptions, type PiToolResult, ProjectSkillReadDenied, type ResolvePiSkillSourcesOptions, createPiProjectSkillReadTool, createPiSessionResources, createPiSkillReadTool, createPiSkillReadTools, createPiSkillRuntime, createPiToolNameResolver, createPiToolProxyDefinitions, resolvePiSessionToolNames, resolvePiSkillSources, validatePiSkillCatalog, validatePiSkillCommand };
+export { type CreatePiSessionResourcesOptions, InvalidPiSkillCatalog, InvalidPiSkillSource, type PiBashToolOptions, type PiSessionResources, type PiSkillRuntime, type PiToolApprovalGateway, type PiToolApprovalRequest, type PiToolContent, type PiToolDefinition, type PiToolProxyOptions, type PiToolResult, ProjectSkillReadDenied, type ResolvePiSkillSourcesOptions, createPiBashTool, createPiProjectSkillReadTool, createPiSessionResources, createPiSkillReadTool, createPiSkillReadTools, createPiSkillRuntime, createPiToolNameResolver, createPiToolProxyDefinitions, resolvePiSessionToolNames, resolvePiSkillSources, validatePiSkillCatalog, validatePiSkillCommand };

package/dist/pi.js

@@ -1,3 +1,3 @@
+import { a as InvalidPiSkillSource, c as validatePiSkillCatalog, d as createPiProjectSkillReadTool, f as createPiSkillReadTool, i as resolvePiSessionToolNames, l as validatePiSkillCommand, m as createPiBashTool, n as createPiToolProxyDefinitions, o as resolvePiSkillSources, p as createPiSkillReadTools, r as createPiSessionResources, s as InvalidPiSkillCatalog, t as createPiToolNameResolver, u as ProjectSkillReadDenied } from "./chunks/pi.js";
 import { r as createPiSkillRuntime } from "./chunks/rivus-tool.js";
-import { a as InvalidPiSkillSource, c as validatePiSkillCatalog, d as createPiProjectSkillReadTool, f as createPiSkillReadTool, i as resolvePiSessionToolNames, l as validatePiSkillCommand, n as createPiToolProxyDefinitions, o as resolvePiSkillSources, p as createPiSkillReadTools, r as createPiSessionResources, s as InvalidPiSkillCatalog, t as createPiToolNameResolver, u as ProjectSkillReadDenied } from "./chunks/pi.js";
-export { InvalidPiSkillCatalog, InvalidPiSkillSource, ProjectSkillReadDenied, createPiProjectSkillReadTool, createPiSessionResources, createPiSkillReadTool, createPiSkillReadTools, createPiSkillRuntime, createPiToolNameResolver, createPiToolProxyDefinitions, resolvePiSessionToolNames, resolvePiSkillSources, validatePiSkillCatalog, validatePiSkillCommand };
+export { InvalidPiSkillCatalog, InvalidPiSkillSource, ProjectSkillReadDenied, createPiBashTool, createPiProjectSkillReadTool, createPiSessionResources, createPiSkillReadTool, createPiSkillReadTools, createPiSkillRuntime, createPiToolNameResolver, createPiToolProxyDefinitions, resolvePiSessionToolNames, resolvePiSkillSources, validatePiSkillCatalog, validatePiSkillCommand };

package/examples/pi-feishu-deployment.bootstrap.ts

@@ -81,6 +81,7 @@ import {
   type RivusThinkingLevel
 } from "@rivus/agent";
 import {
+  createPiBashTool,
   createPiSkillReadTools,
   createPiSessionResources,
   createPiSkillRuntime,
@@ -532,9 +533,19 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
         const sessionRegistry = createPiSessionRegistry({
           createSession: async (firstInput) => {
             let activeInput = firstInput;
+            const resources = await createPiSessionResources({
+              agentDir: PI_AGENT_DIR,
+              appendSystemPromptOverride: () =>
+                [workspaceInstructions.content, skillRuntime.prompt].filter((content) => content.length > 0),
+              cwd: workingDirectory,
+              homeDirectory: homedir(),
+              ...(input.projectSpace ? { projectSkillPaths: input.projectSpace.skillPaths } : {}),
+              systemPromptOverride: () => input.definition.systemPrompt
+            });
             const managedContext =
               management?.enabled && runContexts && input.definition.runtimeToolGrantSet.toolIds.includes("bash")
                 ? createPiManagedSessionContext({
+                    ...(resources.bashToolOptions ? { bashToolOptions: resources.bashToolOptions } : {}),
                     binDirectory: management.binDirectory,
                     contexts: runContexts.registry,
                     cwd: workingDirectory,
@@ -542,17 +553,11 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
                     socketPath: management.socketPath
                   })
                 : undefined;
-            const resources = await createPiSessionResources({
-              agentDir: PI_AGENT_DIR,
-              appendSystemPromptOverride: () =>
-                [workspaceInstructions.content, skillRuntime.prompt].filter((content) => content.length > 0),
-              cwd: workingDirectory,
-              homeDirectory: homedir(),
-              ...(input.projectSpace ? { projectSkillPaths: input.projectSpace.skillPaths } : {}),
-              systemPromptOverride: () => input.definition.systemPrompt
-            });
+            const bashTool = input.definition.runtimeToolGrantSet.toolIds.includes("bash")
+              ? (managedContext?.tool ?? createPiBashTool(workingDirectory, resources.bashToolOptions))
+              : undefined;
             const customTools = [
-              ...(managedContext ? [managedContext.tool] : []),
+              ...(bashTool ? [bashTool] : []),
               ...createPiSkillReadTools({
                 cwd: workingDirectory,
                 runtimeToolIds: input.definition.runtimeToolGrantSet.toolIds,
@@ -570,7 +575,7 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
               }),
               ...(skillRuntime.tool ? [skillRuntime.tool] : [])
             ];
-            const nativeToolIds = managedContext
+            const nativeToolIds = bashTool
               ? input.definition.runtimeToolGrantSet.toolIds.filter((toolId) => toolId !== "bash")
               : input.definition.runtimeToolGrantSet.toolIds;
             const activeToolNames = resolvePiSessionToolNames(nativeToolIds, customTools);
@@ -605,6 +610,7 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
           ? management.runtime.registerSessionRegistry(sessionRegistry)
           : undefined;
         const loop = createPiAgentLoop({
+          supportsSteering: true,
           disposeSessionAfterRun: false,
           ...(management?.enabled ? { runBoundary: management.boundary } : {}),
           ...(telemetry ? { modelContentObserver: telemetry.modelContentObserver } : {}),

package/examples/pi-feishu.bootstrap.ts

@@ -81,6 +81,7 @@ export async function createRivusDaemonProcess(
     }
   });
   const piLoop = createPiAgentLoop({
+    supportsSteering: true,
     disposeSessionAfterRun: false,
     resolveSession: (input) => sessionRegistry.resolve(input)
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivus/agent",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "A local agent daemon core built around a usable agent harness and domain events.",
   "type": "module",
   "license": "MIT",