@rivus/agent 0.5.2 → 0.6.1

package/dist/index.js

@@ -1,8 +1,10 @@
 import { a as createAgentLoopSkillExecutionStart, c as createAgentLoopToolExecutionEnd, d as createAsyncIterableAgentLoop, f as createEventAgentLoop, i as createAgentLoopSkillExecutionEnd, l as createAgentLoopToolExecutionStart, m as createTextAgentLoopFromCallback, n as createAgentLoopModelExecutionEnd, o as createAgentLoopTextDelta, p as createTextAgentLoop, r as createAgentLoopModelExecutionStart, s as createAgentLoopThinkingDelta, t as createAgentLoopFromCallback, u as createAgentLoopToolExecutionUpdate } from "./agent-loop.js";
-import { a as RIVUS_MEMORY_TOOL_ID, c as createMemoryNamespace, d as InvalidRivusPlugin, f as RIVUS_PLUGIN_API_VERSION, i as MEMORY_SCOPES, l as createRivusMemoryToolContract, m as requiresToolApproval, n as resolveRivusAgentDefinition, o as RIVUS_MEMORY_TOOL_PLUGIN_ID, p as RivusToolInputRejected, s as RIVUS_MEMORY_TOOL_VERSION, t as createRivusPluginCatalog, u as restrictMemoryScopesForAudience } from "./rivus-plugin-registry.js";
-import { C as loadRivusDaemonConfig, D as loadRivusDeploymentManifest, E as RivusDeploymentManifestError, M as loadRivusDeployment, N as validateRivusDeploymentManifest, O as FeishuEndpointCredentialError, S as RivusDaemonConfigError, _ as createStableId, a as InvalidRivusProjectSpace, b as createRivusEnvFromOpenClawConfig, c as RivusDeploymentReadinessError, d as createRivusAgentHost, f as AgentInstanceBusy, g as createAgentInstanceRegistry, h as AgentInstanceConflict, i as resolveRivusProjectSpace, j as RivusPluginLoadError, k as resolveFeishuEndpointCredentials, l as createRivusDeploymentDaemon, m as createAgentRuntimePool, n as createRivusDeploymentCliProcess, o as RivusDeploymentAutomationReadinessError, p as AgentRuntimeDisposed, r as createConfiguredRivusDeploymentDaemon, s as RivusDeploymentDaemonLifecycleError, t as runRivusDaemonCli, u as InvalidRivusEndpointBinding, v as createRivusDaemonShutdownController, w as loadNodeRivusPluginModule, x as formatRivusEnvFile, y as OpenClawEnvImportError } from "./rivus-daemon-cli.js";
+import { a as createMemoryNamespace, c as InvalidRivusPlugin, d as requiresToolApproval, i as RIVUS_MEMORY_TOOL_VERSION, l as RIVUS_PLUGIN_API_VERSION, n as RIVUS_MEMORY_TOOL_ID, o as createRivusMemoryToolContract, r as RIVUS_MEMORY_TOOL_PLUGIN_ID, s as restrictMemoryScopesForAudience, t as MEMORY_SCOPES, u as RivusToolInputRejected } from "./agent-memory.js";
+import { n as resolveRivusAgentDefinition, t as createRivusPluginCatalog } from "./rivus-plugin-registry.js";
+import { A as CardPresentationTransitionDenied, B as FeishuEndpointCredentialError, C as loadRivusDaemonConfig, D as loadRivusDeploymentManifest, E as RivusDeploymentManifestError, F as completeCardPresentationHandoff, G as validateRivusDeploymentManifest, I as createCardPresentationChain, L as failCardPresentationHandoff, M as activeCardPresentation, N as beginCardPresentationHandoff, O as DEFAULT_CARD_STREAM_LEASE_MS, P as compensateCardPresentationHandoff, R as isCardPresentationHandoffDue, S as RivusDaemonConfigError, U as RivusPluginLoadError, V as resolveFeishuEndpointCredentials, W as loadRivusDeployment, _ as createStableId, a as InvalidRivusProjectSpace, b as createRivusEnvFromOpenClawConfig, c as RivusDeploymentReadinessError, d as createRivusAgentHost, f as AgentInstanceBusy, g as createAgentInstanceRegistry, h as AgentInstanceConflict, i as resolveRivusProjectSpace, j as acceptsCardPresentationProgress, k as createFeishuCardRollover, l as createRivusDeploymentDaemon, m as createAgentRuntimePool, n as createRivusDeploymentCliProcess, o as RivusDeploymentAutomationReadinessError, p as AgentRuntimeDisposed, r as createConfiguredRivusDeploymentDaemon, s as RivusDeploymentDaemonLifecycleError, t as runRivusDaemonCli, u as InvalidRivusEndpointBinding, v as createRivusDaemonShutdownController, w as loadNodeRivusPluginModule, x as formatRivusEnvFile, y as OpenClawEnvImportError, z as markCardPresentationTerminal } from "./rivus-daemon-cli.js";
+import { a as InvalidInvocationAuthority, i as normalizeStableJson, n as InvalidToolInput, o as createInvocationAuthority, r as createToolInputDigest, s as resolveInvocationAuthority, t as InvalidStableJson } from "./tool-input-digest.js";
 import { n as assertRivusPluginConforms, r as createFakeRivusPlugin, t as RivusPluginConformanceError } from "./rivus-plugin-testkit.js";
-import { Cause, Deferred, Effect, Exit, Fiber, Option, Stream } from "effect";
+import { Cause, Deferred, Effect, Either, Exit, Fiber, Option, Stream } from "effect";
 import { createHash, randomUUID } from "node:crypto";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { appendFile, lstat, mkdir, readFile, readdir, realpath, rename, stat, unlink, writeFile } from "node:fs/promises";
@@ -14,7 +16,6 @@ import { resourceFromAttributes } from "@opentelemetry/resources";
 import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
 import { ROOT_CONTEXT, SpanStatusCode, trace } from "@opentelemetry/api";
-import { Unsafe } from "typebox";
 //#region src/application/support/serial-executor.ts
 function createSerialExecutor() {
 	let tail = Promise.resolve();
@@ -134,7 +135,7 @@ function createFeishuCardDeliveryReconciler(options) {
 	return { reconcile: () => Effect.gen(function* () {
 		const projector = createFeishuStreamProjector();
 		const terminalByRun = /* @__PURE__ */ new Map();
-		for (const event of options.events) for (const action of projector.apply(event)) if (action.type !== "update_text") terminalByRun.set(action.runId, action);
+		for (const event of options.events) for (const action of projector.apply(event)) if (action.type !== "update_text" && action.type !== "handoff") terminalByRun.set(action.runId, action);
 		let repaired = 0;
 		for (const [runId, action] of terminalByRun) {
 			if (options.ledger.isTerminalPublished(runId)) continue;
@@ -1935,6 +1936,9 @@ function encodeSegment(value) {
 }
 //#endregion
 //#region src/application/feishu/feishu-message-intake.ts
+function readTenantKey(payload) {
+	return payload.event.sender?.tenant_key ?? payload.header?.tenant_key ?? "";
+}
 var UnsupportedFeishuMessage = class extends Error {
 	messageType;
 	name = "UnsupportedFeishuMessage";
@@ -2011,7 +2015,7 @@ function toSessionReference(payload, options) {
 	return {
 		agentId: options.agentId,
 		chatId: payload.event.message.chat_id,
-		tenantKey: payload.event.sender?.tenant_key ?? payload.header?.tenant_key ?? "",
+		tenantKey: readTenantKey(payload),
 		...payload.event.message.thread_id ? { threadId: payload.event.message.thread_id } : {}
 	};
 }
@@ -2092,6 +2096,7 @@ function createFeishuAgentDaemon(options) {
 		handleMessage: (payload, handleOptions) => {
 			let dedupeMessageId;
 			const sideEffectsDisabled = handleOptions?.sideEffects === "disabled";
+			const finalizeRun = options.finalizeRun ?? (() => Effect.void);
 			const prepareRun = sideEffectsDisabled ? void 0 : options.prepareRun;
 			const publish = sideEffectsDisabled ? () => Effect.void : options.publish;
 			const publishRunUpdate = sideEffectsDisabled ? void 0 : options.publishRunUpdate;
@@ -2111,12 +2116,14 @@ function createFeishuAgentDaemon(options) {
 				}
 				if (inbound.type === "cancel_run") return yield* cancelRun(inbound);
 				const projector = createFeishuStreamProjector();
+				const acceptedRunIds = /* @__PURE__ */ new Set();
 				const command = {
 					...inbound.command,
 					...options.resolveInvocation ? { invocation: options.resolveInvocation(payload, inbound.conversationId) } : {}
 				};
 				const result = yield* execution.promptWithUpdates(command, (update) => Effect.gen(function* () {
 					const event = update.event;
+					if (event.type === "agent_run_accepted") acceptedRunIds.add(event.runId);
 					if (event.type === "agent_run_accepted" && prepareRun) yield* prepareRun({
 						messageId: inbound.messageId,
 						prompt: event.prompt,
@@ -2126,7 +2133,7 @@ function createFeishuAgentDaemon(options) {
 					});
 					if (publishRunUpdate) yield* publishRunUpdate(update);
 					for (const action of projector.applyUpdate(update)) yield* publish(action);
-				}));
+				})).pipe(Effect.ensuring(Effect.forEach(acceptedRunIds, (runId) => finalizeRun(runId), { discard: true })));
 				return {
 					finalText: result.finalText,
 					messageId: inbound.messageId,
@@ -2226,9 +2233,8 @@ function createFeishuMessageQueue(options) {
 	};
 }
 function createLaneKey(payload) {
-	const tenantKey = payload.event.sender?.tenant_key ?? payload.header?.tenant_key ?? "unknown-tenant";
 	const message = payload.event.message;
-	return `${tenantKey}:${message.chat_id}:${message.thread_id ?? message.chat_id}`;
+	return `${readTenantKey(payload)}:${message.chat_id}:${message.thread_id ?? message.chat_id}`;
 }
 //#endregion
 //#region src/application/feishu/feishu-group-policy.ts
@@ -2250,7 +2256,10 @@ function createFeishuMessageWorker(options) {
 		const results = [];
 		while (options.queue.pending() > 0) {
 			const batchSize = Math.min(concurrency, options.queue.pending());
-			const batch = yield* Effect.all(Array.from({ length: batchSize }, () => options.queue.drainOne()), { concurrency: "unbounded" });
+			const outcomes = yield* Effect.all(Array.from({ length: batchSize }, () => options.queue.drainOne().pipe(Effect.either)), { concurrency: "unbounded" });
+			const failures = outcomes.filter(Either.isLeft).map((outcome) => outcome.left);
+			if (failures.length > 0) yield* Effect.fail(failures.length === 1 ? failures[0] : new AggregateError(failures, "Feishu message batch failed"));
+			const batch = outcomes.filter(Either.isRight).map((outcome) => outcome.right);
 			if (batch.every((result) => !result.handled)) break;
 			for (const result of batch) if (result.handled) results.push(result);
 		}
@@ -2261,8 +2270,8 @@ function createFeishuMessageWorker(options) {
 	}) };
 }
 //#endregion
-//#region src/application/feishu/feishu-worker-loop.ts
-function createFeishuWorkerLoop(options) {
+//#region src/application/support/periodic-effect-loop.ts
+function createPeriodicEffectLoop(options) {
 	let running = false;
 	let fiber;
 	const reportError = (error) => {
@@ -2270,7 +2279,7 @@ function createFeishuWorkerLoop(options) {
 		return reported instanceof Promise ? Effect.promise(() => reported) : Effect.void;
 	};
 	const continueAfterReporting = (effect) => effect.pipe(Effect.asVoid, Effect.catchAll((error) => reportError(error)));
-	const cycle = Effect.suspend(() => continueAfterReporting(options.drainAvailable()).pipe(Effect.flatMap(() => continueAfterReporting(options.sleep(options.intervalMs))), Effect.flatMap(() => cycle)));
+	const cycle = Effect.suspend(() => continueAfterReporting(options.run()).pipe(Effect.flatMap(() => continueAfterReporting(options.sleep(options.intervalMs))), Effect.flatMap(() => cycle)));
 	return {
 		running: () => running,
 		start: () => {
@@ -2287,6 +2296,16 @@ function createFeishuWorkerLoop(options) {
 	};
 }
 //#endregion
+//#region src/application/feishu/feishu-worker-loop.ts
+function createFeishuWorkerLoop(options) {
+	return createPeriodicEffectLoop({
+		intervalMs: options.intervalMs,
+		...options.onError ? { onError: options.onError } : {},
+		run: () => options.drainAvailable(),
+		sleep: options.sleep
+	});
+}
+//#endregion
 //#region src/application/daemon/rivus-daemon-process.ts
 function createRivusDaemonProcess(options) {
 	let running = false;
@@ -2364,6 +2383,7 @@ function createRivusDaemonStatusReporter(options) {
 		const activeSessionKey = availability?.busy ? availability.activeSessionKey : activeRun?.sessionKey;
 		return {
 			agentId: options.agentId,
+			...options.cardPresentations ? { cards: options.cardPresentations() } : {},
 			harness: {
 				...activeRunId !== void 0 ? { activeRunId } : {},
 				...activeRunState !== void 0 ? { activeRunState } : {},
@@ -2643,6 +2663,7 @@ function createFeishuAgentRuntime(options) {
 	const daemon = createFeishuAgentDaemon({
 		agentId: options.agentId,
 		...options.botOpenId ? { botOpenId: options.botOpenId } : {},
+		...options.finalizeRun ? { finalizeRun: options.finalizeRun } : {},
 		harness,
 		...options.prepareRun ? { prepareRun: options.prepareRun } : {},
 		publish: options.publish
@@ -2709,7 +2730,7 @@ function isRetryableFeishuMessageError(error) {
 	return !(error instanceof AgentRunCancelled || error instanceof UnsupportedFeishuMessage || error instanceof InvalidFeishuMessageContent || error instanceof InvalidFeishuSessionReference);
 }
 function summarizeReceiveMessage(payload) {
-	const tenantKey = payload.event.sender?.tenant_key ?? payload.header?.tenant_key;
+	const tenantKey = readTenantKey(payload);
 	return {
 		chatId: payload.event.message.chat_id,
 		messageId: payload.event.message.message_id,
@@ -2764,14 +2785,41 @@ async function stopWebSocketClient(client) {
 	else await client.disconnect?.();
 }
 //#endregion
+//#region src/application/feishu/feishu-card-rollover-supervisor.ts
+const DEFAULT_INTERVAL_MS = 1e3;
+function createFeishuCardRolloverSupervisor(options) {
+	const intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+	if (!Number.isSafeInteger(intervalMs) || intervalMs < 1) throw new Error("Feishu card rollover supervisor interval must be a positive integer");
+	const tick = () => Effect.gen(function* () {
+		const now = yield* options.clock.now;
+		const results = [];
+		for (const runId of options.rollover.dueRunIds(now)) results.push(yield* options.rollover.handoff(runId));
+		return { results };
+	});
+	const loop = createPeriodicEffectLoop({
+		intervalMs,
+		...options.onError ? { onError: options.onError } : {},
+		run: tick,
+		sleep: options.sleep
+	});
+	return {
+		recover: () => options.rollover.recover().pipe(Effect.asVoid),
+		running: () => loop.running(),
+		start: () => loop.start(),
+		stop: () => loop.stop(),
+		tick
+	};
+}
+//#endregion
 //#region src/infrastructure/feishu/feishu-agent-run-card.ts
+const FEISHU_AGENT_CARD_ELEMENT_ID = "rivus_agent_answer";
 function createFeishuAgentRunCard(input) {
 	const presentation = resolveRunPresentation(input);
 	return {
 		body: { elements: [
 			{
 				content: presentation.content,
-				element_id: input.status === "running" ? input.elementId ?? "rivus_agent_answer" : "rivus_agent_answer",
+				element_id: input.status === "running" ? input.elementId ?? "rivus_agent_answer" : FEISHU_AGENT_CARD_ELEMENT_ID,
 				tag: "markdown"
 			},
 			{
@@ -2813,9 +2861,15 @@ function resolveRunPresentation(input) {
 	switch (input.status) {
 		case "running": return {
 			content: input.text || "正在思考…",
-			note: "回答将实时更新",
+			note: input.generation ? "接续上一条消息，回答将实时更新" : "回答将实时更新",
 			template: "blue",
-			title: "正在处理"
+			title: input.generation ? "正在处理（续）" : "正在处理"
+		};
+		case "handoff": return {
+			content: "任务仍在后台处理，进度将继续显示在下一条消息。",
+			note: "本卡片的流式窗口已交接",
+			template: "blue",
+			title: "已转到新消息"
 		};
 		case "completed": return {
 			content: input.text || "已完成。",
@@ -2921,11 +2975,12 @@ function createFeishuCardKitOpenApiClient(options) {
 	const agentName = options.agentName ?? "Rivus Agent";
 	const streamingClosedCards = /* @__PURE__ */ new Set();
 	const call = (request) => options.client.request(request).pipe(Effect.asVoid);
-	const updateTerminal = (request, status) => updateTerminalCard(baseUrl, agentName, request, status, call).pipe(Effect.tap(() => Effect.sync(() => streamingClosedCards.delete(request.cardId))));
+	const updateTerminal = (request, status) => updateWholeCard(baseUrl, agentName, request, status, call).pipe(Effect.tap(() => Effect.sync(() => streamingClosedCards.delete(request.cardId))));
 	return {
 		cancel: (request) => updateTerminal(request, "cancelled"),
 		fail: (request) => updateTerminal(request, "failed"),
 		finish: (request) => updateTerminal(request, "completed"),
+		handoff: (request) => Effect.sync(() => streamingClosedCards.add(request.cardId)).pipe(Effect.flatMap(() => updateWholeCard(baseUrl, agentName, request, "handoff", call))),
 		updateText: (request) => {
 			if (streamingClosedCards.has(request.cardId)) return Effect.void;
 			return call({
@@ -2937,7 +2992,10 @@ function createFeishuCardKitOpenApiClient(options) {
 				url: `${baseUrl}/open-apis/cardkit/v1/cards/${encodeURIComponent(request.cardId)}/elements/${encodeURIComponent(request.elementId)}/content`
 			}).pipe(Effect.catchAll((error) => {
 				if (!isStreamingClosed(error)) return Effect.fail(error);
-				return Effect.sync(() => streamingClosedCards.add(request.cardId));
+				return Effect.sync(() => {
+					streamingClosedCards.add(request.cardId);
+					options.onStreamingClosed?.(request.cardId);
+				});
 			}));
 		}
 	};
@@ -2945,17 +3003,14 @@ function createFeishuCardKitOpenApiClient(options) {
 function isStreamingClosed(error) {
 	return error instanceof FeishuOpenApiError && (error.code === 200850 || error.code === 300309);
 }
-function updateTerminalCard(baseUrl, agentName, request, status, call) {
-	const card = status === "completed" && "text" in request ? createFeishuAgentRunCard({
+function updateWholeCard(baseUrl, agentName, request, status, call) {
+	const card = status === "completed" ? createFeishuAgentRunCard({
 		agentName,
-		status: "completed",
-		text: request.text
-	}) : status === "cancelled" ? createFeishuAgentRunCard({
-		agentName,
-		status: "cancelled"
+		status,
+		text: "text" in request ? request.text : ""
 	}) : createFeishuAgentRunCard({
 		agentName,
-		status: "failed"
+		status
 	});
 	return call({
 		body: {
@@ -2983,6 +3038,10 @@ function createFeishuCardKitPublisher(options) {
 				elementId: target.elementId,
 				sequence
 			});
+			case "handoff": return yield* options.client.handoff({
+				cardId: target.cardId,
+				sequence
+			});
 			case "finish":
 				yield* options.client.finish({
 					cardId: target.cardId,
@@ -3032,6 +3091,7 @@ function createCoalescingFeishuPublisher(options) {
 				case "update_text": return Effect.sync(() => {
 					pendingTextByRun.set(action.runId, action.text);
 				});
+				case "handoff": return options.publisher.publish(action);
 				case "finish": return Effect.gen(function* () {
 					pendingTextByRun.set(action.runId, action.text);
 					yield* flushRun(action.runId);
@@ -3064,7 +3124,8 @@ function createConfiguredFeishuCardKitPublisher(options) {
 		client: createFeishuCardKitOpenApiClient({
 			...options.agentName === void 0 ? {} : { agentName: options.agentName },
 			baseUrl: options.config.feishu.baseUrl,
-			client: options.client
+			client: options.client,
+			...options.onStreamingClosed === void 0 ? {} : { onStreamingClosed: options.onStreamingClosed }
 		}),
 		...options.ledger ? { ledger: options.ledger } : {},
 		resolveTarget: options.resolveTarget
@@ -3077,36 +3138,33 @@ function createConfiguredFeishuCardKitPublisher(options) {
 }
 //#endregion
 //#region src/infrastructure/feishu/feishu-cardkit-target-preparation.ts
-const DEFAULT_ELEMENT_ID = "rivus_agent_answer";
+const DEFAULT_ELEMENT_ID = FEISHU_AGENT_CARD_ELEMENT_ID;
 function createFeishuCardTargetPreparation(options) {
 	return (run) => Effect.gen(function* () {
 		const target = yield* options.createTarget(run);
-		yield* options.registry.bind(run.runId, target);
+		yield* options.presentations.bindRun(run, target);
 	});
 }
-function createConfiguredFeishuCardKitTargetPreparation(options) {
-	const creator = createFeishuCardKitOpenApiTargetCreator({
+function createConfiguredFeishuCardKitTargetCreator(options) {
+	return createFeishuCardKitOpenApiTargetCreator({
 		baseUrl: options.config.feishu.baseUrl,
 		client: options.client,
 		elementId: options.elementId ?? DEFAULT_ELEMENT_ID,
 		...options.initialContent === void 0 ? {} : { initialContent: options.initialContent },
 		...options.title === void 0 ? {} : { title: options.title }
 	});
-	return createFeishuCardTargetPreparation({
-		createTarget: (run) => creator.createTarget(run),
-		registry: options.registry
-	});
 }
 function createFeishuCardKitOpenApiTargetCreator(options) {
 	const baseUrl = (options.baseUrl ?? "https://open.feishu.cn").replace(/\/$/, "");
 	const title = options.title ?? "Rivus Agent";
 	const initialContent = options.initialContent ?? "";
-	return { createTarget: (run) => Effect.gen(function* () {
+	return { createTarget: (run, createOptions) => Effect.gen(function* () {
 		const cardId = yield* readStringData(yield* options.client.request({
 			body: {
 				data: JSON.stringify(createFeishuAgentRunCard({
 					agentName: title,
 					elementId: options.elementId,
+					...createOptions?.generation === void 0 ? {} : { generation: createOptions.generation },
 					runId: run.runId,
 					sessionKey: run.sessionKey,
 					status: "running",
@@ -3143,6 +3201,68 @@ function isRecord$2(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 //#endregion
+//#region src/composition/feishu-card-rollover-runtime.ts
+const MIN_SUPERVISOR_INTERVAL_MS = 200;
+const MAX_SUPERVISOR_INTERVAL_MS = 5e3;
+function createConfiguredFeishuCardRolloverRuntime(options) {
+	const leaseMs = options.config.feishu.cardStreamLeaseMs;
+	let rollover;
+	const publisher = createConfiguredFeishuCardKitPublisher({
+		...options.agentName === void 0 ? {} : { agentName: options.agentName },
+		client: options.client,
+		config: options.config,
+		...options.ledger ? { ledger: options.ledger } : {},
+		onStreamingClosed: (cardId) => rollover?.observeStreamClosed(cardId),
+		resolveTarget: (runId) => options.cardTargets.resolveTarget(runId),
+		sleep: options.sleep
+	});
+	const creator = createConfiguredFeishuCardKitTargetCreator({
+		client: options.client,
+		config: options.config,
+		...options.elementId === void 0 ? {} : { elementId: options.elementId },
+		...options.initialContent === void 0 ? {} : { initialContent: options.initialContent },
+		...options.title === void 0 ? {} : { title: options.title }
+	});
+	const cardRollover = createFeishuCardRollover({
+		clock: options.clock,
+		createSuccessor: ({ generation, run }) => creator.createTarget(run, { generation }),
+		leaseMs,
+		...options.observe ? { observe: options.observe } : {},
+		publisher,
+		store: options.cardTargets
+	});
+	rollover = cardRollover;
+	const supervisor = createFeishuCardRolloverSupervisor({
+		clock: options.clock,
+		intervalMs: options.supervisorIntervalMs ?? resolveSupervisorInterval(leaseMs),
+		...options.onError ? { onError: options.onError } : {},
+		rollover: cardRollover,
+		sleep: options.sleep
+	});
+	return {
+		prepareRun: createFeishuCardTargetPreparation({
+			createTarget: (run) => creator.createTarget(run),
+			presentations: cardRollover
+		}),
+		rollover: cardRollover,
+		supervisor,
+		transport: {
+			running: () => supervisor.running(),
+			start: async () => {
+				await Effect.runPromise(supervisor.recover().pipe(Effect.catchAll((error) => {
+					const reported = options.onError?.(error);
+					return reported instanceof Promise ? Effect.promise(() => reported) : Effect.void;
+				})));
+				supervisor.start();
+			},
+			stop: () => supervisor.stop()
+		}
+	};
+}
+function resolveSupervisorInterval(leaseMs) {
+	return Math.max(MIN_SUPERVISOR_INTERVAL_MS, Math.min(MAX_SUPERVISOR_INTERVAL_MS, Math.floor(leaseMs / 10)));
+}
+//#endregion
 //#region src/composition/rivus-daemon-bootstrap.ts
 const DEFAULT_WORKER_INTERVAL_MS$1 = 250;
 const DEFAULT_RUN_TIMEOUT_MS = 900 * 1e3;
@@ -3157,23 +3277,26 @@ function createConfiguredRivusDaemonBootstrap(options) {
 		config: options.config,
 		request: options.request
 	});
-	const prepareRun = createConfiguredFeishuCardKitTargetPreparation({
-		client: openApiClient,
-		config: options.config,
-		registry: options.cardTargets
-	});
-	const publisher = createConfiguredFeishuCardKitPublisher({
+	const cardRollover = createConfiguredFeishuCardRolloverRuntime({
+		cardTargets: options.cardTargets,
 		client: openApiClient,
+		clock: options.clock,
 		config: options.config,
-		resolveTarget: (runId) => options.cardTargets.resolveTarget(runId),
-		sleep: options.sleep
+		...options.cardLedger ? { ledger: options.cardLedger } : {},
+		...options.observeCardRollover ? { observe: options.observeCardRollover } : {},
+		...options.onWorkerError ? { onError: options.onWorkerError } : {},
+		sleep: options.sleep,
+		...options.cardRolloverIntervalMs === void 0 ? {} : { supervisorIntervalMs: options.cardRolloverIntervalMs }
 	});
+	const publisher = cardRollover.rollover;
+	const prepareRun = (run) => cardRollover.prepareRun(run);
 	const periodicFlush = createPeriodicFlush(options, publisher);
 	const runtime = createFeishuAgentRuntime({
 		agentId: options.config.agentId,
 		...options.botOpenId ? { botOpenId: options.botOpenId } : {},
 		clock: options.clock,
 		eventSinks: [options.eventLog],
+		finalizeRun: (runId) => cardRollover.rollover.releaseRun(runId),
 		...options.inboxRepository ? { inboxRepository: options.inboxRepository } : {},
 		...options.initialEvents ? { initialEvents: options.initialEvents } : {},
 		...options.initialRunStates ? { initialRunStates: options.initialRunStates } : {},
@@ -3197,25 +3320,31 @@ function createConfiguredRivusDaemonBootstrap(options) {
 	});
 	const restoreHistoryFromLog = () => restoreAgentHistory(options.eventLog);
 	let processRef;
-	let transport = websocketTransport;
+	let transport = createCompositeRivusDaemonTransport({ transports: [websocketTransport, cardRollover.transport] });
 	const statusReporter = createRivusDaemonStatusReporter({
 		agentId: options.config.agentId,
 		availability: () => runtime.harness.getAvailability(),
 		pending: () => runtime.pending(),
 		processRunning: () => processRef?.running() ?? false,
+		cardPresentations: () => cardRollover.rollover.status(),
 		receiveStatus: () => runtime.receiveStatus(),
 		restoreHistory: restoreHistoryFromLog,
 		transportRunning: () => transport.running(),
 		workerLoopRunning: () => workerLoop.running()
 	});
 	const statusTransport = options.createStatusTransport?.(statusReporter);
-	if (statusTransport) transport = createCompositeRivusDaemonTransport({ transports: [websocketTransport, statusTransport] });
+	if (statusTransport) transport = createCompositeRivusDaemonTransport({ transports: [
+		websocketTransport,
+		cardRollover.transport,
+		statusTransport
+	] });
 	const process = createRivusDaemonProcess({
 		transport,
 		workerLoop
 	});
 	processRef = process;
 	return {
+		cardRollover,
 		cardTargets: options.cardTargets,
 		eventLog: options.eventLog,
 		process,
@@ -3956,62 +4085,6 @@ function resolveContentMode(value) {
 	throw new LangfuseTelemetryConfigError("RIVUS_TELEMETRY_CONTENT must be either \"metadata-only\" or \"redacted\"");
 }
 //#endregion
-//#region src/infrastructure/pi/pi-skill-tool.ts
-const PI_SKILL_READER_TOOL_NAME = "rivus_read_skill";
-function createPiSkillRuntime(skills) {
-	if (skills.length === 0) return Object.freeze({ prompt: "" });
-	const skillsById = new Map(skills.map((skill) => [skill.id, skill]));
-	const prompt = [
-		"Granted Skills are versioned instructions loaded on demand.",
-		`Before following a Skill, call ${PI_SKILL_READER_TOOL_NAME} with its exact ID and follow the returned content.`,
-		"Granted Skill catalog:",
-		...skills.map((skill) => `- ${skill.id} | ${skill.title} | v${skill.version} | ${skill.digest}`)
-	].join("\n");
-	const tool = {
-		description: "Read the full versioned instructions for one Skill granted to this Agent Runtime.",
-		execute: async (_callId, input) => {
-			const skillId = readSkillId$1(input);
-			const skill = skillsById.get(skillId);
-			if (!skill) throw new Error(`Skill is not granted: ${skillId}`);
-			const details = {
-				contentLength: skill.content.length,
-				digest: skill.digest,
-				skillId: skill.id,
-				title: skill.title,
-				version: skill.version
-			};
-			return {
-				content: [{
-					text: skill.content,
-					type: "text"
-				}],
-				details
-			};
-		},
-		executionMode: "sequential",
-		label: "Read granted Skill",
-		name: PI_SKILL_READER_TOOL_NAME,
-		parameters: Unsafe({
-			additionalProperties: false,
-			properties: { skillId: {
-				description: "Exact Skill ID from the granted Skill catalog.",
-				type: "string"
-			} },
-			required: ["skillId"],
-			type: "object"
-		}),
-		promptSnippet: `${PI_SKILL_READER_TOOL_NAME}: read one granted Skill by exact ID`
-	};
-	return Object.freeze({
-		prompt,
-		tool
-	});
-}
-function readSkillId$1(input) {
-	if (input === null || typeof input !== "object" || Array.isArray(input) || typeof input.skillId !== "string") throw new Error("Skill reader input requires a string skillId");
-	return input.skillId;
-}
-//#endregion
 //#region src/infrastructure/pi/pi-agent-loop.ts
 function createPiAgentLoop(options) {
 	return createAsyncIterableAgentLoop({ run: (input) => runPiSession(input, options) });
@@ -4346,6 +4419,79 @@ function createPiSessionRegistry(options) {
 	};
 }
 //#endregion
+//#region src/application/feishu/feishu-card-presentation-store.ts
+var FeishuCardPresentationNotFound = class {
+	runId;
+	_tag = "FeishuCardPresentationNotFound";
+	constructor(runId) {
+		this.runId = runId;
+	}
+};
+function createFeishuCardPresentationStore(options = {}) {
+	const chains = new Map(options.initial?.map((chain) => [chain.runId, structuredClone(chain)]) ?? []);
+	const serial = createSerialExecutor();
+	const save = async (next) => {
+		for (const chain of next) chains.set(chain.runId, structuredClone(chain));
+		await options.persist?.([...chains.values()]);
+	};
+	const mutate = (operation) => Effect.tryPromise({
+		try: () => serial.run(operation),
+		catch: (error) => error
+	});
+	const transition = (runId, apply) => mutate(async () => {
+		const current = chains.get(runId);
+		if (!current) throw new FeishuCardPresentationNotFound(runId);
+		const next = apply(current);
+		if (next !== current) await save([next]);
+		return activeCardPresentation(next);
+	});
+	return {
+		bind: (binding) => mutate(async () => {
+			const current = chains.get(binding.runId);
+			if (current && activeCardPresentation(current).cardId === binding.cardId) return activeCardPresentation(current);
+			const created = createCardPresentationChain(binding);
+			await save([created]);
+			return activeCardPresentation(created);
+		}),
+		beginHandoff: ({ handoffAt, runId }) => mutate(async () => {
+			const current = chains.get(runId);
+			if (!current) throw new FeishuCardPresentationNotFound(runId);
+			const next = beginCardPresentationHandoff(current, handoffAt);
+			if (next === current) return {
+				presentation: activeCardPresentation(current),
+				started: false
+			};
+			await save([next]);
+			return {
+				presentation: activeCardPresentation(next),
+				started: true
+			};
+		}),
+		chain: (runId) => {
+			const current = chains.get(runId);
+			return current ? structuredClone(current) : void 0;
+		},
+		chains: () => [...chains.values()].map((chain) => structuredClone(chain)),
+		compensateInterruptedHandoffs: (compensatedAt) => mutate(async () => {
+			const compensated = [...chains.values()].map((chain) => ({
+				chain,
+				next: compensateCardPresentationHandoff(chain, compensatedAt)
+			})).filter(({ chain, next }) => next !== chain).map(({ next }) => next);
+			if (compensated.length > 0) await save(compensated);
+			return compensated.map((chain) => structuredClone(chain));
+		}),
+		completeHandoff: ({ runId, successor }) => transition(runId, (chain) => completeCardPresentationHandoff(chain, successor)),
+		failHandoff: ({ failedAt, runId }) => transition(runId, (chain) => failCardPresentationHandoff(chain, failedAt)).pipe(Effect.asVoid),
+		markTerminal: ({ runId, terminalReceiptId }) => transition(runId, (chain) => markCardPresentationTerminal(chain, terminalReceiptId)).pipe(Effect.asVoid),
+		release: (runId) => mutate(async () => {
+			if (!chains.has(runId)) return;
+			chains.delete(runId);
+			await options.persist?.([...chains.values()]);
+		}),
+		size: () => chains.size
+	};
+}
+//#endregion
 //#region src/infrastructure/feishu/feishu-card-target-registry.ts
 var FeishuCardTargetNotFound = class {
 	runId;
@@ -4363,74 +4509,101 @@ var FeishuCardTargetRegistryStoreError = class {
 		this.cause = cause;
 	}
 };
-function createInMemoryFeishuCardTargetRegistry() {
-	const targets = /* @__PURE__ */ new Map();
-	return {
-		bind: (runId, target) => Effect.sync(() => {
-			targets.set(runId, target);
-		}),
-		release: (runId) => Effect.sync(() => {
-			targets.delete(runId);
-		}),
-		resolveTarget: (runId) => Effect.sync(() => targets.get(runId)).pipe(Effect.flatMap((target) => target ? Effect.succeed(target) : Effect.fail(new FeishuCardTargetNotFound(runId)))),
-		size: () => targets.size
-	};
+const PRESENTATION_FILE_VERSION = 2;
+const LEGACY_PRESENTATION_TIMESTAMP = (/* @__PURE__ */ new Date(0)).toISOString();
+function createInMemoryFeishuCardTargetRegistry(initial = []) {
+	const store = createFeishuCardPresentationStore({ initial });
+	return withTargetResolution(store, () => Effect.succeed(store));
 }
 function createJsonFileFeishuCardTargetRegistry(options) {
-	let lastKnownSize = 0;
-	const loadTargets = Effect.tryPromise({
-		try: async () => {
-			try {
-				const raw = await readFile(options.filePath, "utf8");
-				const targets = parseTargets(JSON.parse(raw));
-				lastKnownSize = Object.keys(targets).length;
-				return targets;
-			} catch (error) {
-				if (isNodeErrorWithCode(error, "ENOENT")) {
-					lastKnownSize = 0;
-					return {};
-				}
-				throw error;
-			}
-		},
-		catch: (error) => new FeishuCardTargetRegistryStoreError("load", error)
-	});
-	const saveTargets = (targets) => Effect.tryPromise({
-		try: async () => {
-			await mkdir(dirname(options.filePath), { recursive: true });
-			await writeFile(options.filePath, `${JSON.stringify(targets, null, 2)}\n`, "utf8");
-			lastKnownSize = Object.keys(targets).length;
-		},
-		catch: (error) => new FeishuCardTargetRegistryStoreError("save", error)
+	let opened;
+	let loaded;
+	const open = async () => {
+		const store = createFeishuCardPresentationStore({
+			initial: await loadChains(options.filePath),
+			persist: (chains) => saveChains(options.filePath, chains)
+		});
+		loaded = store;
+		return store;
+	};
+	const ready = () => Effect.tryPromise({
+		try: () => opened ??= open(),
+		catch: (error) => error instanceof FeishuCardTargetRegistryStoreError ? error : new FeishuCardTargetRegistryStoreError("load", error)
 	});
+	const use = (operation) => ready().pipe(Effect.flatMap(operation));
+	return withTargetResolution({
+		bind: (binding) => use((current) => current.bind(binding)),
+		beginHandoff: (input) => use((current) => current.beginHandoff(input)),
+		chain: (runId) => loaded?.chain(runId),
+		chains: () => loaded?.chains() ?? [],
+		compensateInterruptedHandoffs: (compensatedAt) => use((current) => current.compensateInterruptedHandoffs(compensatedAt)),
+		completeHandoff: (input) => use((current) => current.completeHandoff(input)),
+		failHandoff: (input) => use((current) => current.failHandoff(input)),
+		markTerminal: (input) => use((current) => current.markTerminal(input)),
+		release: (runId) => use((current) => current.release(runId)),
+		size: () => loaded?.size() ?? 0
+	}, ready);
+}
+function withTargetResolution(store, ready) {
 	return {
-		bind: (runId, target) => loadTargets.pipe(Effect.flatMap((targets) => saveTargets({
-			...targets,
-			[runId]: target
-		}))),
-		release: (runId) => loadTargets.pipe(Effect.flatMap((targets) => {
-			const nextTargets = { ...targets };
-			delete nextTargets[runId];
-			return saveTargets(nextTargets);
-		})),
-		resolveTarget: (runId) => loadTargets.pipe(Effect.flatMap((targets) => {
-			const target = targets[runId];
-			return target ? Effect.succeed(target) : Effect.fail(new FeishuCardTargetNotFound(runId));
-		})),
-		size: () => lastKnownSize
+		...store,
+		resolveTarget: (runId) => ready().pipe(Effect.flatMap((current) => {
+			const chain = current.chain(runId);
+			return chain ? Effect.succeed(toTarget(activeCardPresentation(chain))) : Effect.fail(new FeishuCardTargetNotFound(runId));
+		}))
 	};
 }
-function parseTargets(value) {
-	if (!isRecord$4(value)) throw new Error("Feishu card target registry file must contain a JSON object.");
-	const targets = {};
-	for (const [runId, target] of Object.entries(value)) {
-		if (!isFeishuCardTarget(target)) throw new Error(`Invalid Feishu card target entry for run '${runId}'.`);
-		targets[runId] = target;
+function toTarget(presentation) {
+	return {
+		cardId: presentation.cardId,
+		elementId: presentation.elementId ?? "rivus_agent_answer"
+	};
+}
+async function loadChains(filePath) {
+	try {
+		const raw = await readFile(filePath, "utf8");
+		return parseChains(JSON.parse(raw));
+	} catch (error) {
+		if (isNodeErrorWithCode(error, "ENOENT")) return [];
+		throw new FeishuCardTargetRegistryStoreError("load", error);
+	}
+}
+async function saveChains(filePath, chains) {
+	try {
+		await mkdir(dirname(filePath), { recursive: true });
+		const runs = Object.fromEntries(chains.map((chain) => [chain.runId, chain]));
+		await writeFile(filePath, `${JSON.stringify({
+			runs,
+			version: PRESENTATION_FILE_VERSION
+		}, null, 2)}\n`, "utf8");
+	} catch (error) {
+		throw new FeishuCardTargetRegistryStoreError("save", error);
 	}
-	return targets;
 }
-function isFeishuCardTarget(value) {
-	return isRecord$4(value) && typeof value.cardId === "string" && typeof value.elementId === "string";
+function parseChains(value) {
+	if (!isRecord$4(value)) throw new Error("Feishu card presentation file must contain a JSON object.");
+	if (value.version === void 0) return Object.entries(value).map(([runId, target]) => parseLegacyChain(runId, target));
+	if (value.version !== PRESENTATION_FILE_VERSION || !isRecord$4(value.runs)) throw new Error(`Unsupported Feishu card presentation file version: ${JSON.stringify(value.version)}`);
+	return Object.entries(value.runs).map(([runId, chain]) => parseChain(runId, chain));
+}
+function parseLegacyChain(runId, target) {
+	if (!isRecord$4(target) || typeof target.cardId !== "string" || typeof target.elementId !== "string") throw new Error(`Invalid Feishu card target entry for run '${runId}'.`);
+	return createCardPresentationChain({
+		cardId: target.cardId,
+		createdAt: LEGACY_PRESENTATION_TIMESTAMP,
+		elementId: target.elementId,
+		leaseDeadlineAt: LEGACY_PRESENTATION_TIMESTAMP,
+		presentationId: `${runId}#0`,
+		runId,
+		sourceMessageId: ""
+	});
+}
+function parseChain(runId, value) {
+	if (!isRecord$4(value) || value.runId !== runId || !Number.isInteger(value.activeGeneration) || typeof value.activePresentationId !== "string" || !Number.isInteger(value.revision) || !Array.isArray(value.presentations) || value.presentations.length === 0) throw new Error(`Invalid Feishu card presentation chain for run '${runId}'.`);
+	const chain = value;
+	for (const presentation of chain.presentations) if (!isRecord$4(presentation) || typeof presentation.cardId !== "string" || typeof presentation.presentationId !== "string" || typeof presentation.status !== "string" || !Number.isInteger(presentation.generation)) throw new Error(`Invalid Feishu card presentation entry for run '${runId}'.`);
+	activeCardPresentation(chain);
+	return chain;
 }
 //#endregion
 //#region src/infrastructure/feishu/feishu-cot-tool-presenter.ts
@@ -4804,6 +4977,15 @@ function readRedactedString(serialized) {
 function createFixedClock(now) {
 	return { now: Effect.succeed(now) };
 }
+function createTestClock(initial) {
+	let now = initial;
+	return {
+		advance: (ms) => {
+			now = new Date(now.getTime() + ms);
+		},
+		now: Effect.suspend(() => Effect.succeed(now))
+	};
+}
 function createSequenceRunIds(runIds) {
 	let index = 0;
 	return { next: Effect.sync(() => {
@@ -4977,72 +5159,6 @@ function freezeView(view) {
 	return Object.freeze(view);
 }
 //#endregion
-//#region src/application/delegation/tool-authority.ts
-const authorities = /* @__PURE__ */ new WeakMap();
-var InvalidInvocationAuthority = class extends Error {
-	name = "InvalidInvocationAuthority";
-};
-function createInvocationAuthority(authority) {
-	if (!authority.sourceMessageId.trim()) throw new InvalidInvocationAuthority("invocation authority requires a trusted source message id");
-	const reference = Object.freeze({ id: `authority:${randomUUID()}` });
-	const memory = authority.memory ? Object.freeze({
-		...authority.memory,
-		scopes: Object.freeze(restrictMemoryScopesForAudience(authority.memory.scopes, authority.memory.audience))
-	}) : void 0;
-	authorities.set(reference, Object.freeze({
-		...authority,
-		...memory ? { memory } : {}
-	}));
-	return reference;
-}
-function resolveInvocationAuthority(reference) {
-	const authority = authorities.get(reference);
-	if (!authority) throw new InvalidInvocationAuthority("invocation authority was not issued by this host");
-	return authority;
-}
-//#endregion
-//#region src/application/delegation/tool-input-digest.ts
-var InvalidStableJson = class extends Error {
-	name = "InvalidStableJson";
-};
-var InvalidToolInput = class extends InvalidStableJson {
-	name = "InvalidToolInput";
-};
-function createToolInputDigest(input) {
-	let canonical;
-	try {
-		canonical = normalizeStableJson(input);
-	} catch (error) {
-		if (error instanceof InvalidStableJson) throw new InvalidToolInput(error.message);
-		throw error;
-	}
-	return `sha256:${createHash("sha256").update(JSON.stringify(canonical)).digest("hex")}`;
-}
-function normalizeStableJson(value) {
-	return canonicalize(value, /* @__PURE__ */ new Set());
-}
-function canonicalize(value, ancestors) {
-	if (value === null || typeof value === "string" || typeof value === "boolean") return value;
-	if (typeof value === "number") {
-		if (!Number.isFinite(value)) throw new InvalidStableJson("stable JSON numbers must be finite");
-		return Object.is(value, -0) ? 0 : value;
-	}
-	if (typeof value !== "object") throw new InvalidStableJson("value must contain only stable JSON values");
-	if (ancestors.has(value)) throw new InvalidStableJson("stable JSON must not contain cycles");
-	ancestors.add(value);
-	try {
-		if (Array.isArray(value)) return Array.from({ length: value.length }, (_, index) => {
-			if (!Object.hasOwn(value, index)) throw new InvalidStableJson("stable JSON arrays must not contain holes");
-			return canonicalize(value[index], ancestors);
-		});
-		const prototype = Object.getPrototypeOf(value);
-		if (prototype !== Object.prototype && prototype !== null) throw new InvalidStableJson("stable JSON objects must be plain objects");
-		return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([key, entry]) => [key, canonicalize(entry, ancestors)]));
-	} finally {
-		ancestors.delete(value);
-	}
-}
-//#endregion
 //#region src/application/delegation/tool-operation-ledger.ts
 function createToolOperationLedger(options = {}) {
 	const records = new Map(options.initial?.map((record) => [record.operationId, structuredClone(record)]) ?? []);
@@ -5393,6 +5509,7 @@ function createFeishuDeploymentEndpoint(options) {
 		agentId: options.agentId,
 		botOpenId: options.botOpenId,
 		execution: execution.port,
+		...options.finalizeRun ? { finalizeRun: options.finalizeRun } : {},
 		...options.interactions ? { interactions: options.interactions } : {},
 		...options.prepareRun ? { prepareRun: options.prepareRun } : {},
 		publish: options.publish,
@@ -5431,14 +5548,19 @@ function createFeishuDeploymentEndpoint(options) {
 		})
 	});
 	return {
-		running: () => websocket.running() && workerLoop.running(),
+		running: () => websocket.running() && workerLoop.running() && (options.cardRollover?.running() ?? true),
 		start: async () => {
 			execution.beginStart();
 			try {
+				await options.cardRollover?.start();
 				await websocket.start();
 				workerLoop.start();
 			} catch (startError) {
-				const cleanupErrors = await settleCleanup([() => websocket.stop(), () => workerLoop.stop()]);
+				const cleanupErrors = await settleCleanup([
+					() => websocket.stop(),
+					() => workerLoop.stop(),
+					() => options.cardRollover?.stop()
+				]);
 				if (cleanupErrors.length > 0) throw new AggregateError([startError, ...cleanupErrors], "Feishu endpoint startup and cleanup failed");
 				throw startError;
 			}
@@ -5449,7 +5571,8 @@ function createFeishuDeploymentEndpoint(options) {
 			const cleanupErrors = await settleCleanup([
 				() => websocketStop,
 				() => execution.cancelActiveAndWait(),
-				() => workerStop
+				() => workerStop,
+				() => options.cardRollover?.stop()
 			]);
 			if (cleanupErrors.length === 1) throw cleanupErrors[0];
 			if (cleanupErrors.length > 1) throw new AggregateError(cleanupErrors, "Feishu endpoint cleanup failed");
@@ -5560,7 +5683,7 @@ function createInvocation(payload, endpointId, memoryTenantId, conversationId, p
 			tenantId: memoryTenantId
 		} } : {},
 		sourceMessageId: payload.event.message.message_id,
-		tenantKey: payload.event.sender?.tenant_key ?? payload.header?.tenant_key ?? ""
+		tenantKey: readTenantKey(payload)
 	};
 }
 function namespaceSessionKey(namespace, sessionKey) {
@@ -6787,112 +6910,6 @@ function assertTimestamp(value, label) {
 	if (!Number.isFinite(Date.parse(value))) throw new HumanInteractionTransitionDenied(`${label} must be an ISO timestamp`);
 }
 //#endregion
-//#region src/infrastructure/pi/pi-tool-proxy.ts
-function createPiToolProxyDefinitions(options) {
-	const names = /* @__PURE__ */ new Set();
-	return options.tools.map((tool) => {
-		const name = toPiToolName(tool.id);
-		if (names.has(name)) throw new Error(`Pi tool name collision: ${name}`);
-		names.add(name);
-		return {
-			description: tool.description,
-			execute: async (callId, input, signal) => {
-				const activeInput = options.getActiveInput();
-				const invocation = activeInput?.invocation;
-				if (!activeInput || !invocation) throw new Error(`tool ${tool.id} requires an active agent run with a trusted invocation`);
-				if (!invocation.tenantKey) throw new Error(`tool ${tool.id} requires a trusted tenant identity`);
-				throwIfAborted(signal ?? activeInput.abortSignal);
-				const inputDigest = createToolInputDigest(input);
-				const operationId = createBoundId("operation", {
-					agentId: options.agentId,
-					inputDigest,
-					instanceId: options.instanceId,
-					sourceMessageId: invocation.sourceMessageId,
-					toolId: tool.id,
-					toolVersion: tool.version
-				});
-				const approvalId = createBoundId("approval", {
-					callId,
-					operationId,
-					runId: activeInput.runId
-				});
-				if (requiresToolApproval(tool.risk)) {
-					if (invocation.allowedActorOpenIds.length === 0) throw new Error(`tool ${tool.id} requires at least one trusted approval actor`);
-					await options.approvals.requestApproval({
-						agentId: options.agentId,
-						allowedActorOpenIds: invocation.allowedActorOpenIds,
-						approvalId,
-						callId,
-						endpointId: invocation.endpointId,
-						inputDigest,
-						instanceId: options.instanceId,
-						operationId,
-						risk: tool.risk,
-						runId: activeInput.runId,
-						sessionKey: activeInput.sessionKey,
-						signal: signal ?? activeInput.abortSignal,
-						sourceMessageId: invocation.sourceMessageId,
-						tenantKey: invocation.tenantKey,
-						toolId: tool.id,
-						toolVersion: tool.version
-					});
-					throwIfAborted(signal ?? activeInput.abortSignal);
-				}
-				const result = await options.broker.execute({
-					authority: createInvocationAuthority({
-						agentId: options.agentId,
-						instanceId: options.instanceId,
-						...invocation.memory ? { memory: {
-							...invocation.memory,
-							scopes: options.memoryScopes ?? []
-						} } : {},
-						runId: activeInput.runId,
-						sessionKey: activeInput.sessionKey,
-						sourceMessageId: invocation.sourceMessageId,
-						tenantKey: invocation.tenantKey,
-						toolGrantSet: options.toolGrantSet
-					}),
-					callId,
-					input,
-					operationId,
-					...requiresToolApproval(tool.risk) ? { approvalId } : {},
-					toolId: tool.id,
-					version: tool.version
-				});
-				return {
-					content: [{
-						text: stringifyToolResult(result),
-						type: "text"
-					}],
-					details: result
-				};
-			},
-			executionMode: "sequential",
-			label: tool.id,
-			name,
-			parameters: Unsafe(tool.inputSchema),
-			promptSnippet: `${name}: ${tool.description}`
-		};
-	});
-}
-function createPiToolNameResolver(tools) {
-	const toolIdsByPiName = new Map(tools.map((tool) => [toPiToolName(tool.id), tool.id]));
-	return (toolName) => toolIdsByPiName.get(toolName) ?? toolName;
-}
-function toPiToolName(toolId) {
-	return `rivus_${toolId.replace(/[^a-zA-Z0-9_-]/g, "_")}`;
-}
-function createBoundId(kind, binding) {
-	return `${kind}:${createHash("sha256").update(JSON.stringify(binding)).digest("hex")}`;
-}
-function throwIfAborted(signal) {
-	if (signal.aborted) throw signal.reason ?? /* @__PURE__ */ new Error("tool execution was aborted");
-}
-function stringifyToolResult(result) {
-	if (typeof result === "string") return result;
-	return JSON.stringify(result ?? null);
-}
-//#endregion
 //#region src/composition/human-interaction-tool-approval-gateway.ts
 function createHumanInteractionEndpointRegistry() {
 	const services = /* @__PURE__ */ new Map();
@@ -7409,4 +7426,4 @@ function validateDecisionInput(input) {
 	if (input.recommendedOptionId && !optionIds.includes(input.recommendedOptionId)) throw new Error("recommended user decision option must be available");
 }
 //#endregion
-export { AgentContextBudgetExceeded, AgentEventHandlerFailed, AgentEventLogStoreError, AgentEventSinkFailed, AgentHarnessBusy, AgentInstanceBusy, AgentInstanceConflict, AgentLoopFailed, AgentMemoryError, AgentRunCancelled, AgentRuntimeDisposed, AutomationMandateError, CompactionError, DelegationDenied, DeliveryOutboxError, FeishuCardTargetNotFound, FeishuCardTargetRegistryStoreError, FeishuCotProtocolError, FeishuEndpointCredentialError, FeishuOpenApiError, FeishuTenantAccessTokenError, HumanInteractionRepositoryError, HumanInteractionTransitionDenied, InvalidFeishuCardAction, InvalidFeishuMessageContent, InvalidFeishuSessionReference, InvalidInvocationAuthority, InvalidProjectSkillCatalog, InvalidRecoveryAction, InvalidRivusEndpointBinding, InvalidRivusPlugin, InvalidRivusProjectSpace, InvalidStableJson, InvalidToolInput, InvalidWorkspaceRoot, LangfuseTelemetryConfigError, MEMORY_SCOPES, OpenClawEnvImportError, PluginStateConflict, RIVUS_MEMORY_TOOL_ID, RIVUS_MEMORY_TOOL_PLUGIN_ID, RIVUS_MEMORY_TOOL_VERSION, RIVUS_PLUGIN_API_VERSION, RivusDaemonConfigError, RivusDeploymentAutomationReadinessError, RivusDeploymentDaemonLifecycleError, RivusDeploymentManifestError, RivusDeploymentReadinessError, RivusPluginConformanceError, RivusPluginLoadError, RivusToolInputRejected, SessionSchedulerCapacityExceeded, SessionSchedulerDisposed, ToolInvocationDenied, UnsupportedFeishuCardAction, UnsupportedFeishuMessage, WorkspaceInstructionsSourceError, assembleAgentContext, assertRivusPluginConforms, commitAutomationOutcome, createAgentCommandFromFeishuCardAction, createAgentCommandFromFeishuMessage, createAgentConversationMessages, createAgentDomainEventHandler, createAgentDomainEventSink, createAgentDomainEventSinkFromCallback, createAgentHarness, createAgentHarnessClient, createAgentHarnessPooledRuntime, createAgentInstanceRegistry, createAgentLoopFromCallback, createAgentLoopModelExecutionEnd, createAgentLoopModelExecutionStart, createAgentLoopPromptTransformer, createAgentLoopSkillExecutionEnd, createAgentLoopSkillExecutionStart, createAgentLoopTextDelta, createAgentLoopThinkingDelta, createAgentLoopToolExecutionEnd, createAgentLoopToolExecutionStart, createAgentLoopToolExecutionUpdate, createAgentMemoryService, createAgentRunUpdateHandler, createAgentRuntime, createAgentRuntimePool, createAgentTranscriptMessages, createAgentTranscriptTurn, createAgentsMdInstructionsProvider, createAsyncIterableAgentLoop, createAutomationMandateStore, createCoalescingFeishuPublisher, createCompactionService, createCompositeRivusDaemonTransport, createConfiguredFeishuAutomationCardSender, createConfiguredFeishuCardKitPublisher, createConfiguredFeishuCardKitTargetPreparation, createConfiguredFeishuHumanInteractionPresenter, createConfiguredFeishuOpenApiClient, createConfiguredFeishuTextReplySender, createConfiguredRivusDaemonBootstrap, createConfiguredRivusDeploymentDaemon, createDailyAutomationSchedule, createDefaultAgentHarness, createDefaultAgentHarnessClient, createDefaultAgentHarnessClientFromCallback, createDefaultAgentHarnessClientFromTextCallback, createDefaultAgentHarnessFromCallback, createDefaultAgentHarnessFromTextCallback, createDefaultAgentRuntime, createDefaultAgentRuntimeFromCallback, createDefaultAgentRuntimeFromTextCallback, createDelegationService, createDeliveryOutbox, createEventAgentLoop, createFakeRivusPlugin, createFeishuAgentDaemon, createFeishuAgentRunCard, createFeishuAgentRuntime, createFeishuCardActionCallbackResponse, createFeishuCardActionErrorResponse, createFeishuCardDeliveryLedger, createFeishuCardDeliveryReconciler, createFeishuCardKitOpenApiClient, createFeishuCardKitOpenApiTargetCreator, createFeishuCardKitPublisher, createFeishuCardTargetPreparation, createFeishuConversationId, createFeishuCotPublisher, createFeishuDeploymentEndpoint, createFeishuEventHandlers, createFeishuHumanInteractionCard, createFeishuHumanInteractionPresenter, createFeishuInboxRepository, createFeishuMessageQueue, createFeishuMessageWorker, createFeishuOpenApiClient, createFeishuPeriodicFlush, createFeishuPresentationPreparation, createFeishuSessionKey, createFeishuStreamProjector, createFeishuTenantAccessTokenProvider, createFeishuWebSocketDaemon, createFeishuWorkerLoop, createFixedClock, createHumanInteractionEndpointRegistry, createHumanInteractionService, createHumanInteractionToolApprovalGateway, createInMemoryFeishuCardTargetRegistry, createInMemoryHumanInteractionRepository, createInvocationAuthority, createJsonFetchRequest, createJsonFileFeishuCardTargetRegistry, createJsonlAgentEventLog, createJsonlHumanInteractionRepository, createLangfuseAgentTelemetry, createLazyFeishuWebSocketEventDispatcher, createMemoryNamespace, createOpenTelemetryAgentEventSink, createOpenTelemetryAgentTelemetry, createPiAgentLoop, createPiSdkAgentLoop, createPiSessionRegistry, createPiSkillRuntime, createPiToolNameResolver, createPiToolProxyDefinitions, createPluginStateStore, createProjectMemoryPromptPreparer, createRateLimitedFeishuPublisher, createRecoveryAction, createRecoveryControl, createRivusAgentHost, createRivusDaemonProcess, createRivusDaemonShutdownController, createRivusDaemonStatusHttpServer, createRivusDaemonStatusReporter, createRivusDeploymentCliProcess, createRivusDeploymentDaemon, createRivusEnvFromOpenClawConfig, createRivusMemoryTool, createRivusMemoryToolContract, createRivusMemoryToolDescriptor, createRivusPluginCatalog, createRoutedHumanInteractionToolApprovalService, createScheduledAutomation, createSequenceRunIds, createSessionScheduler, createSubagentCoordinator, createSystemClock, createTelemetryContentRedactor, createTextAgentLoop, createTextAgentLoopFromCallback, createToolBroker, createToolInputDigest, createToolOperationLedger, createUuidRunIds, createWorkspaceRootHandle, describeFeishuMessageIntake, evolveAgentRun, formatRivusEnvFile, initialAgentRunState, intersectToolIds, isAgentToolExecutionEvent, isAssistantTextDeltaEvent, isAssistantThinkingDeltaEvent, isTerminalAgentDomainEvent, isTerminalAgentRunPhase, loadNodeRivusPluginModule, loadRivusDaemonConfig, loadRivusDeployment, loadRivusDeploymentManifest, normalizeStableJson, openJsonAutomationTickRepository, openJsonlAgentMemoryService, openJsonlFeishuCardDeliveryLedger, openJsonlFeishuInboxRepository, openJsonlRecoveryControl, openJsonlToolOperationLedger, replayAgentHistory, replayAgentTranscript, requiresToolApproval, resolveFeishuEndpointCredentials, resolveLangfuseTelemetryConfig, resolveRivusAgentDefinition, resolveRivusProjectSpace, restoreAgentHistory, restoreConfiguredRivusDaemonBootstrap, restrictMemoryScopesForAudience, runRivusDaemonCli, shouldAcceptFeishuEndpointMessage, transitionHumanInteraction, validateProjectSkillCatalog, validateProjectSkillCommand, validateRivusDeploymentManifest };
+export { AgentContextBudgetExceeded, AgentEventHandlerFailed, AgentEventLogStoreError, AgentEventSinkFailed, AgentHarnessBusy, AgentInstanceBusy, AgentInstanceConflict, AgentLoopFailed, AgentMemoryError, AgentRunCancelled, AgentRuntimeDisposed, AutomationMandateError, CardPresentationTransitionDenied, CompactionError, DEFAULT_CARD_STREAM_LEASE_MS, DelegationDenied, DeliveryOutboxError, FeishuCardPresentationNotFound, FeishuCardTargetNotFound, FeishuCardTargetRegistryStoreError, FeishuCotProtocolError, FeishuEndpointCredentialError, FeishuOpenApiError, FeishuTenantAccessTokenError, HumanInteractionRepositoryError, HumanInteractionTransitionDenied, InvalidFeishuCardAction, InvalidFeishuMessageContent, InvalidFeishuSessionReference, InvalidInvocationAuthority, InvalidProjectSkillCatalog, InvalidRecoveryAction, InvalidRivusEndpointBinding, InvalidRivusPlugin, InvalidRivusProjectSpace, InvalidStableJson, InvalidToolInput, InvalidWorkspaceRoot, LangfuseTelemetryConfigError, MEMORY_SCOPES, OpenClawEnvImportError, PluginStateConflict, RIVUS_MEMORY_TOOL_ID, RIVUS_MEMORY_TOOL_PLUGIN_ID, RIVUS_MEMORY_TOOL_VERSION, RIVUS_PLUGIN_API_VERSION, RivusDaemonConfigError, RivusDeploymentAutomationReadinessError, RivusDeploymentDaemonLifecycleError, RivusDeploymentManifestError, RivusDeploymentReadinessError, RivusPluginConformanceError, RivusPluginLoadError, RivusToolInputRejected, SessionSchedulerCapacityExceeded, SessionSchedulerDisposed, ToolInvocationDenied, UnsupportedFeishuCardAction, UnsupportedFeishuMessage, WorkspaceInstructionsSourceError, acceptsCardPresentationProgress, activeCardPresentation, assembleAgentContext, assertRivusPluginConforms, commitAutomationOutcome, createAgentCommandFromFeishuCardAction, createAgentCommandFromFeishuMessage, createAgentConversationMessages, createAgentDomainEventHandler, createAgentDomainEventSink, createAgentDomainEventSinkFromCallback, createAgentHarness, createAgentHarnessClient, createAgentHarnessPooledRuntime, createAgentInstanceRegistry, createAgentLoopFromCallback, createAgentLoopModelExecutionEnd, createAgentLoopModelExecutionStart, createAgentLoopPromptTransformer, createAgentLoopSkillExecutionEnd, createAgentLoopSkillExecutionStart, createAgentLoopTextDelta, createAgentLoopThinkingDelta, createAgentLoopToolExecutionEnd, createAgentLoopToolExecutionStart, createAgentLoopToolExecutionUpdate, createAgentMemoryService, createAgentRunUpdateHandler, createAgentRuntime, createAgentRuntimePool, createAgentTranscriptMessages, createAgentTranscriptTurn, createAgentsMdInstructionsProvider, createAsyncIterableAgentLoop, createAutomationMandateStore, createCoalescingFeishuPublisher, createCompactionService, createCompositeRivusDaemonTransport, createConfiguredFeishuAutomationCardSender, createConfiguredFeishuCardKitPublisher, createConfiguredFeishuCardKitTargetCreator, createConfiguredFeishuCardRolloverRuntime, createConfiguredFeishuHumanInteractionPresenter, createConfiguredFeishuOpenApiClient, createConfiguredFeishuTextReplySender, createConfiguredRivusDaemonBootstrap, createConfiguredRivusDeploymentDaemon, createDailyAutomationSchedule, createDefaultAgentHarness, createDefaultAgentHarnessClient, createDefaultAgentHarnessClientFromCallback, createDefaultAgentHarnessClientFromTextCallback, createDefaultAgentHarnessFromCallback, createDefaultAgentHarnessFromTextCallback, createDefaultAgentRuntime, createDefaultAgentRuntimeFromCallback, createDefaultAgentRuntimeFromTextCallback, createDelegationService, createDeliveryOutbox, createEventAgentLoop, createFakeRivusPlugin, createFeishuAgentDaemon, createFeishuAgentRunCard, createFeishuAgentRuntime, createFeishuCardActionCallbackResponse, createFeishuCardActionErrorResponse, createFeishuCardDeliveryLedger, createFeishuCardDeliveryReconciler, createFeishuCardKitOpenApiClient, createFeishuCardKitOpenApiTargetCreator, createFeishuCardKitPublisher, createFeishuCardPresentationStore, createFeishuCardRollover, createFeishuCardRolloverSupervisor, createFeishuCardTargetPreparation, createFeishuConversationId, createFeishuCotPublisher, createFeishuDeploymentEndpoint, createFeishuEventHandlers, createFeishuHumanInteractionCard, createFeishuHumanInteractionPresenter, createFeishuInboxRepository, createFeishuMessageQueue, createFeishuMessageWorker, createFeishuOpenApiClient, createFeishuPeriodicFlush, createFeishuPresentationPreparation, createFeishuSessionKey, createFeishuStreamProjector, createFeishuTenantAccessTokenProvider, createFeishuWebSocketDaemon, createFeishuWorkerLoop, createFixedClock, createHumanInteractionEndpointRegistry, createHumanInteractionService, createHumanInteractionToolApprovalGateway, createInMemoryFeishuCardTargetRegistry, createInMemoryHumanInteractionRepository, createInvocationAuthority, createJsonFetchRequest, createJsonFileFeishuCardTargetRegistry, createJsonlAgentEventLog, createJsonlHumanInteractionRepository, createLangfuseAgentTelemetry, createLazyFeishuWebSocketEventDispatcher, createMemoryNamespace, createOpenTelemetryAgentEventSink, createOpenTelemetryAgentTelemetry, createPiAgentLoop, createPiSdkAgentLoop, createPiSessionRegistry, createPluginStateStore, createProjectMemoryPromptPreparer, createRateLimitedFeishuPublisher, createRecoveryAction, createRecoveryControl, createRivusAgentHost, createRivusDaemonProcess, createRivusDaemonShutdownController, createRivusDaemonStatusHttpServer, createRivusDaemonStatusReporter, createRivusDeploymentCliProcess, createRivusDeploymentDaemon, createRivusEnvFromOpenClawConfig, createRivusMemoryTool, createRivusMemoryToolContract, createRivusMemoryToolDescriptor, createRivusPluginCatalog, createRoutedHumanInteractionToolApprovalService, createScheduledAutomation, createSequenceRunIds, createSessionScheduler, createSubagentCoordinator, createSystemClock, createTelemetryContentRedactor, createTestClock, createTextAgentLoop, createTextAgentLoopFromCallback, createToolBroker, createToolInputDigest, createToolOperationLedger, createUuidRunIds, createWorkspaceRootHandle, describeFeishuMessageIntake, evolveAgentRun, formatRivusEnvFile, initialAgentRunState, intersectToolIds, isAgentToolExecutionEvent, isAssistantTextDeltaEvent, isAssistantThinkingDeltaEvent, isCardPresentationHandoffDue, isTerminalAgentDomainEvent, isTerminalAgentRunPhase, loadNodeRivusPluginModule, loadRivusDaemonConfig, loadRivusDeployment, loadRivusDeploymentManifest, normalizeStableJson, openJsonAutomationTickRepository, openJsonlAgentMemoryService, openJsonlFeishuCardDeliveryLedger, openJsonlFeishuInboxRepository, openJsonlRecoveryControl, openJsonlToolOperationLedger, replayAgentHistory, replayAgentTranscript, requiresToolApproval, resolveFeishuEndpointCredentials, resolveLangfuseTelemetryConfig, resolveRivusAgentDefinition, resolveRivusProjectSpace, restoreAgentHistory, restoreConfiguredRivusDaemonBootstrap, restrictMemoryScopesForAudience, runRivusDaemonCli, shouldAcceptFeishuEndpointMessage, transitionHumanInteraction, validateProjectSkillCatalog, validateProjectSkillCommand, validateRivusDeploymentManifest };