@rivus/runtime 0.16.6 → 0.17.0

package/dist/index.js

@@ -1,7 +1,8 @@
-import { a as requiresToolApproval$1, c as resolveInvocationAuthority, i as normalizeStableJson, l as normalizeAgentInvocation, n as InvalidToolInput, o as InvalidInvocationAuthority, r as createToolInputDigest$1, s as createInvocationAuthority, t as InvalidStableJson, u as RivusToolInputRejected } from "./chunks/tool-input-digest.js";
-import { S as normalizeAgentLoopEvent, _ as createAgentLoopToolExecutionStart, a as createTextAgentLoopFromCallback, b as createEventAgentLoop, c as toEffectAgentLoop, d as createAgentLoopModelExecutionStart, f as createAgentLoopSkillExecutionEnd, g as createAgentLoopToolExecutionEnd, h as createAgentLoopThinkingDelta, i as createTextAgentLoop, l as toEffectAgentLoopInput, m as createAgentLoopTextDelta, n as createAsyncIterableAgentLoop, o as fromEffectAgentLoop, p as createAgentLoopSkillExecutionStart, r as createEventAgentLoop$1, s as toCompatibilityAgentLoopInput, t as createAgentLoopFromCallback, u as createAgentLoopModelExecutionEnd, v as createAgentLoopToolExecutionUpdate, x as createTextAgentLoop$1, y as createAgentLoopTurnStart } from "./chunks/agent-loop.js";
-import { Cause, Deferred, Effect, Exit, Option, Queue, Stream } from "effect";
-import { createHash, randomUUID } from "node:crypto";
+import { a as createInvocationAuthority, i as InvalidInvocationAuthority, n as InvalidToolInput, o as resolveInvocationAuthority, r as createToolInputDigest, s as normalizeAgentInvocation, t as requiresToolApproval } from "./chunks/tool-risk-policy.js";
+import { i as isAgentSteeringRequest, n as cloneAgentSteeringInput, o as projectUserInputText, r as cloneUserInput, t as ATTACHMENT_RECOVERY_COMMAND } from "./chunks/agent-user-input.js";
+import { Deferred, Effect, Option, Queue, Stream } from "effect";
+import { unwrapExit } from "@rivus/platform/effect";
+import { createHash } from "node:crypto";
 import { appendFile, chmod, lstat, mkdir, readFile, realpath, stat } from "node:fs/promises";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { isPathWithin } from "@rivus/platform/filesystem";
@@ -13,7 +14,6 @@ import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
 import { ROOT_CONTEXT, SpanStatusCode, trace } from "@opentelemetry/api";
 import { isRecord, readPersistenceFile } from "@rivus/platform/persistence";
 import { createSerialExecutor } from "@rivus/platform/concurrency";
-import { createSha256Digest } from "@rivus/platform/identity";
 //#region src/core/application/agent-execution/contracts/agent-execution-errors.ts
 var AgentHarnessBusy = class {
 	activeRun;
@@ -77,20 +77,6 @@ var AgentRunCancelled = class {
 	}
 };
 //#endregion
-//#region src/core/application/agent-execution/contracts/agent-domain-events.ts
-function isAssistantTextDeltaEvent(event) {
-	return event.type === "assistant_text_delta";
-}
-function isAssistantThinkingDeltaEvent(event) {
-	return event.type === "assistant_thinking_delta";
-}
-function isAgentToolExecutionEvent(event) {
-	return event.type === "agent_tool_execution_started" || event.type === "agent_tool_execution_updated" || event.type === "agent_tool_execution_ended";
-}
-function isTerminalAgentDomainEvent(event) {
-	return event.type === "agent_run_completed" || event.type === "agent_run_failed" || event.type === "agent_run_cancelled";
-}
-//#endregion
 //#region src/core/application/agent-execution/contracts/run-admission.ts
 var ModelChangeBoundaryDeadlineError = class extends Error {
 	name = "ModelChangeBoundaryDeadlineError";
@@ -167,77 +153,13 @@ function assembleWorkspaceInstructions(input, digest) {
 	return Object.freeze(view);
 }
 //#endregion
-//#region src/core/application/agent-execution/context/agent-context-assembler.ts
-var AgentContextBudgetExceeded = class extends Error {
-	name = "AgentContextBudgetExceeded";
-};
-function assembleAgentContext(input) {
-	const required = [
-		layer("host-safety", input.hostSafety),
-		layer("system-prompt", input.systemPrompt),
-		...input.managedInstructions ? [layer("managed-instructions", input.managedInstructions)] : [],
-		...input.toolSchemas.map((content) => layer("tool-schema", content)),
-		layer("current-input", input.currentInput)
-	];
-	let bytes = size(required);
-	if (bytes > input.maxBytes) throw new AgentContextBudgetExceeded("required context layers exceed byte budget");
-	const selected = [...required];
-	const optional = [
-		...(input.workspaceInstructions ?? []).map((content) => layer("workspace-instructions", content)),
-		...(input.skills ?? []).map((content) => layer("skill", content)),
-		...(input.memory ?? []).map((content) => layer("memory", content)),
-		...input.compaction ? [layer("compaction", input.compaction)] : [],
-		...(input.transcript ?? []).map((content) => layer("transcript", content))
-	];
-	const omitted = /* @__PURE__ */ new Set();
-	for (const candidate of optional) {
-		const candidateBytes = byteLength(candidate.content);
-		if (bytes + candidateBytes <= input.maxBytes) {
-			selected.push(candidate);
-			bytes += candidateBytes;
-		} else omitted.add(candidate.kind);
-	}
-	const order = [
-		"host-safety",
-		"system-prompt",
-		"managed-instructions",
-		"workspace-instructions",
-		"tool-schema",
-		"skill",
-		"memory",
-		"compaction",
-		"transcript",
-		"current-input"
-	];
-	selected.sort((a, b) => order.indexOf(a.kind) - order.indexOf(b.kind));
-	return Object.freeze({
-		bytes,
-		layers: Object.freeze(selected),
-		omittedKinds: Object.freeze(order.filter((kind) => omitted.has(kind)))
-	});
-}
-function layer(kind, content) {
-	return Object.freeze({
-		kind,
-		content
-	});
-}
-function size(layers) {
-	return layers.reduce((total, item) => total + byteLength(item.content), 0);
-}
-function byteLength(value) {
-	return new TextEncoder().encode(value).byteLength;
-}
-//#endregion
-//#region src/adapters/agent/memory/agent-memory-access.ts
+//#region src/adapters/agent/memory/rivus-memory-tool-contract.ts
 const MEMORY_SCOPES = Object.freeze([
 	"conversation",
 	"agent-private",
 	"project",
 	"shared-user-profile"
 ]);
-//#endregion
-//#region src/adapters/agent/memory/rivus-memory-tool-contract.ts
 const RIVUS_MEMORY_TOOL_ID = "memory";
 const RIVUS_MEMORY_TOOL_PLUGIN_ID = "rivus-core";
 const RIVUS_MEMORY_TOOL_VERSION = "1.0.0";
@@ -334,7 +256,7 @@ function trimRequired(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
 function trimOptional(value) {
-	if (value === void 0) return void 0;
+	if (value === void 0) return;
 	if (typeof value !== "string") return "";
 	return value.trim() || void 0;
 }
@@ -575,7 +497,7 @@ function normalizeMemoryBinding(binding) {
 		tenantId
 	});
 }
-function createMemoryNamespace$1(binding) {
+function createMemoryNamespace(binding) {
 	const normalized = normalizeMemoryBinding(binding);
 	return {
 		conversation: [
@@ -653,7 +575,7 @@ function createMemoryService(options) {
 			return yield* options.repository.save(record.toSnapshot()).pipe(Effect.mapError(mapRepositoryConflict), Effect.map(snapshotRecord));
 		});
 		const handle = {
-			namespace: createMemoryNamespace$1(binding),
+			namespace: createMemoryNamespace(binding),
 			scope: binding.scope,
 			confirm: (input) => update(input.id, (current) => current.confirm({
 				expectedRevision: input.expectedRevision,
@@ -709,82 +631,105 @@ function toVisibleSnapshot(record) {
 	return record && isVisibleMemory(record) ? snapshotRecord(record) : void 0;
 }
 //#endregion
+//#region src/core/application/tool-execution/contracts/rivus-tool.ts
+var RivusToolInputRejected = class extends Error {
+	name = "RivusToolInputRejected";
+};
+//#endregion
 //#region src/adapters/agent/memory/rivus-memory-tool.ts
 function createRivusMemoryTool(memory) {
-	const handles = Array.isArray(memory) ? [...memory] : [memory];
+	const handles = "scope" in memory ? [memory] : [...memory];
 	if (handles.length === 0) throw new AgentMemoryError("rivus_memory requires at least one bound Memory scope");
 	const byScope = new Map(handles.map((handle) => [handle.scope, handle]));
-	const findStoredById = async (id) => {
+	const findStoredById = (id) => Effect.gen(function* () {
 		for (const handle of handles) {
-			const record = await handle.inspect(id);
+			const record = yield* handle.inspect(id);
 			if (record) return {
 				handle,
 				record
 			};
 		}
-	};
-	const execute = async (command) => {
-		rejectUnknown(command, command.command === "search" ? [
-			"command",
-			"query",
-			"scope"
-		] : command.command === "propose" ? [
-			"command",
-			"input",
-			"scope"
-		] : command.command === "forget_request" ? [
-			"command",
-			"id",
-			"reason"
-		] : ["command", "id"]);
-		switch (command.command) {
-			case "search": {
-				const query = readSearchQuery(command.query);
-				const scope = readOptionalScope(command.scope);
-				const selected = scope ? [requireScope(byScope, scope)] : handles;
-				return (await Promise.all(selected.map((handle) => handle.search(query)))).flat();
-			}
-			case "read": {
-				const id = readId(command.id);
-				for (const handle of handles) {
-					const record = await handle.read(id);
-					if (record) return record;
+	});
+	const execute = (value) => Effect.try({
+		catch: (error) => error,
+		try: () => {
+			const command = readCommand(value);
+			rejectUnknown(command, command.command === "search" ? [
+				"command",
+				"query",
+				"scope"
+			] : command.command === "propose" ? [
+				"command",
+				"input",
+				"scope"
+			] : command.command === "forget_request" ? [
+				"command",
+				"id",
+				"reason"
+			] : ["command", "id"]);
+			switch (command.command) {
+				case "search": {
+					const query = readSearchQuery(command.query);
+					const scope = readOptionalScope(command.scope);
+					const selected = scope ? [requireScope(byScope, scope)] : handles;
+					return Effect.all(selected.map((handle) => handle.search(query)), { concurrency: "unbounded" }).pipe(Effect.map((records) => records.flat()));
 				}
-				return;
-			}
-			case "propose": {
-				const input = readProposeInput(command.input);
-				const scope = readOptionalScope(command.scope);
-				if (scope === "shared-user-profile") throw new AgentMemoryError("Shared User Profile changes require trusted confirmation");
-				const handle = scope ? requireScope(byScope, scope) : byScope.get("agent-private") ?? (handles.length === 1 ? handles[0] : void 0);
-				if (!handle) throw new AgentMemoryError("memory scope is required when multiple scopes are granted");
-				if (handle.scope === "shared-user-profile") throw new AgentMemoryError("Shared User Profile changes require trusted confirmation");
-				return handle.propose({ content: input.content });
-			}
-			case "forget_request": {
-				const id = readId(command.id);
-				const stored = await findStoredById(id);
-				if (!stored) throw new AgentMemoryError(`memory not found: ${id}`);
-				if (stored.handle.scope === "shared-user-profile" || stored.handle.scope === "project" || stored.record.state !== "proposed") throw new AgentMemoryError("Only proposed private Memory can be forgotten by the model; confirmed or project-shared Memory requires trusted control");
-				return toTombstoneReceipt(await stored.handle.forgetRequest({
-					expectedRevision: stored.record.revision,
-					id,
-					...command.reason === void 0 ? {} : { reason: readReason(command.reason) }
-				}));
+				case "read": {
+					const id = readId(command.id);
+					return Effect.gen(function* () {
+						for (const handle of handles) {
+							const record = yield* handle.read(id);
+							if (record) return record;
+						}
+					});
+				}
+				case "propose": {
+					const input = readProposeInput(command.input);
+					const scope = readOptionalScope(command.scope);
+					if (scope === "shared-user-profile") throw new AgentMemoryError("Shared User Profile changes require trusted confirmation");
+					const handle = scope ? requireScope(byScope, scope) : byScope.get("agent-private") ?? (handles.length === 1 ? handles[0] : void 0);
+					if (!handle) throw new AgentMemoryError("memory scope is required when multiple scopes are granted");
+					if (handle.scope === "shared-user-profile") throw new AgentMemoryError("Shared User Profile changes require trusted confirmation");
+					return handle.propose({ content: input.content });
+				}
+				case "forget_request": {
+					const id = readId(command.id);
+					const reason = command.reason === void 0 ? void 0 : readReason(command.reason);
+					return Effect.gen(function* () {
+						const stored = yield* findStoredById(id);
+						if (!stored) return yield* Effect.fail(new AgentMemoryError(`memory not found: ${id}`));
+						if (stored.handle.scope === "shared-user-profile" || stored.handle.scope === "project" || stored.record.state !== "proposed") return yield* Effect.fail(new AgentMemoryError("Only proposed private Memory can be forgotten by the model; confirmed or project-shared Memory requires trusted control"));
+						const record = yield* stored.handle.forgetRequest({
+							expectedRevision: stored.record.revision,
+							id,
+							...reason === void 0 ? {} : { reason }
+						});
+						return yield* Effect.try({
+							catch: (error) => error,
+							try: () => toTombstoneReceipt(record)
+						});
+					});
+				}
+				default: throw new AgentMemoryError(`unknown rivus_memory command: ${String(command.command)}`);
 			}
-			default: throw new AgentMemoryError(`unknown rivus_memory command: ${String(command.command)}`);
 		}
-	};
+	}).pipe(Effect.flatten);
 	return {
 		execute,
-		replayCompleted: async (command, completedResult) => {
-			const input = readCommand(command);
-			if (input.command === "search" || input.command === "read") return execute(input);
-			const id = readCompletedMemoryId(completedResult);
-			const stored = await findStoredById(id);
-			if (!stored) throw new AgentMemoryError(`completed Memory operation references missing Memory: ${id}`);
+		replayCompleted: (command, completedResult) => Effect.gen(function* () {
+			const input = yield* Effect.try({
+				catch: (error) => error,
+				try: () => readCommand(command)
+			});
+			if (input.command === "search" || input.command === "read") return yield* execute(input);
+			const id = yield* Effect.try({
+				catch: (error) => error,
+				try: () => readCompletedMemoryId(completedResult)
+			});
+			const stored = yield* findStoredById(id);
+			if (!stored) return yield* Effect.fail(new AgentMemoryError(`completed Memory operation references missing Memory: ${id}`));
 			return stored.record.state === "tombstoned" ? toTombstoneReceipt(stored.record) : stored.record;
-		}
+		})
 	};
 }
 function createRivusMemoryToolDescriptor(options) {
@@ -812,7 +757,7 @@ function readId(value) {
 	return value;
 }
 function readOptionalScope(value) {
-	if (value === void 0) return void 0;
+	if (value === void 0) return;
 	if (typeof value !== "string" || !MEMORY_SCOPES.includes(value)) throw new AgentMemoryError("memory scope must be conversation, agent-private, project, or shared-user-profile");
 	return value;
 }
@@ -868,35 +813,39 @@ function toTombstoneReceipt(record) {
 		state: record.state
 	};
 }
-async function asToolInputRejection(operation) {
-	try {
-		return await operation();
-	} catch (error) {
-		if (error instanceof AgentMemoryError) throw new RivusToolInputRejected(error.message);
-		throw error;
-	}
+function asToolInputRejection(operation) {
+	return Effect.runPromiseExit(Effect.try({
+		catch: (error) => error,
+		try: operation
+	}).pipe(Effect.flatten, Effect.mapError((error) => error instanceof AgentMemoryError ? new RivusToolInputRejected(error.message) : error))).then(unwrapExit);
 }
 //#endregion
 //#region src/adapters/agent/memory/project-memory-prompt-preparer.ts
-const DEFAULT_MAX_BYTES = 8 * 1024;
+const DEFAULT_MAX_BYTES = 8192;
 const DEFAULT_MAX_RECORDS = 20;
 function createProjectMemoryPromptPreparer(options) {
 	const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
 	const maxRecords = options.maxRecords ?? DEFAULT_MAX_RECORDS;
 	if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) throw new Error("Project Memory maxBytes must be positive");
 	if (!Number.isSafeInteger(maxRecords) || maxRecords <= 0) throw new Error("Project Memory maxRecords must be positive");
-	return async (input) => {
-		const invocationIdentity = (input.invocation ? normalizeAgentInvocation(input.invocation) : void 0)?.memory;
+	return (input) => Effect.gen(function* () {
+		const invocationIdentity = (yield* Effect.try({
+			catch: (error) => error,
+			try: () => input.invocation ? normalizeAgentInvocation(input.invocation) : void 0
+		}))?.memory;
 		if (invocationIdentity?.projectId && invocationIdentity.projectId !== options.projectId) return input.text;
 		const identity = invocationIdentity ?? options.identity;
 		if (!identity) return input.text;
-		const records = (await options.memory.bind({
-			agentId: options.agentId,
-			projectId: options.projectId,
-			scope: "project",
-			subjectId: identity.subjectId,
-			tenantId: identity.tenantId
-		}).search({ query: "" })).filter((record) => record.state === "confirmed").sort((left, right) => left.id.localeCompare(right.id)).slice(0, maxRecords);
+		const records = (yield* (yield* Effect.try({
+			catch: (error) => error,
+			try: () => options.memory.bind({
+				agentId: options.agentId,
+				projectId: options.projectId,
+				scope: "project",
+				subjectId: identity.subjectId,
+				tenantId: identity.tenantId
+			})
+		})).search({ query: "" })).filter((record) => record.state === "confirmed").sort((left, right) => left.id.localeCompare(right.id)).slice(0, maxRecords);
 		const selected = [];
 		let usedBytes = 0;
 		for (const record of records) {
@@ -914,7 +863,7 @@ function createProjectMemoryPromptPreparer(options) {
 			"</rivus_project_memory>"
 		].join("\n");
 		return input.text.startsWith("/skill:") ? `${input.text} \n\n${context}` : `${input.text}\n\n${context}`;
-	};
+	});
 }
 //#endregion
 //#region src/adapters/agent/workspace/node-workspace-root-registry.ts
@@ -986,7 +935,7 @@ async function readSource(rootPath, sourcePath, maxBytes) {
 	try {
 		metadata = await lstat(sourcePath);
 	} catch (error) {
-		if (isMissing(error)) return void 0;
+		if (isMissing(error)) return;
 		throw error;
 	}
 	const relativePath = toRelative(rootPath, sourcePath);
@@ -1036,14 +985,6 @@ function isMissing(error) {
 	return error instanceof Error && "code" in error && error.code === "ENOENT";
 }
 //#endregion
-//#region src/adapters/agent/memory/persisted-memory-record.ts
-function createPersistedMemoryRecord(input) {
-	return createMemoryRecord(input);
-}
-function restorePersistedMemoryRecord(snapshot) {
-	return restoreMemoryRecord(snapshot);
-}
-//#endregion
 //#region src/adapters/observability/content/telemetry-content-redactor.ts
 const REDACTED = "[REDACTED]";
 const TRUNCATED = "[TRUNCATED]";
@@ -1180,9 +1121,6 @@ const SPAN_NAMES = {
 	turn: "Agent 处理"
 };
 const MAX_TOOL_DISPLAY_NAME_LENGTH = 64;
-function createOpenTelemetryAgentEventSink(options) {
-	return createOpenTelemetryAgentTelemetry(options).sink;
-}
 function createOpenTelemetryAgentTelemetry(options) {
 	const runs = /* @__PURE__ */ new Map();
 	const pendingModelContent = /* @__PURE__ */ new Map();
@@ -1461,7 +1399,7 @@ function notifyProjectionError(callback, error, event) {
 	}
 }
 function redactEventContent(redactContent, callback, value, event) {
-	if (!redactContent) return void 0;
+	if (!redactContent) return;
 	try {
 		const redacted = redactContent(value);
 		if (typeof redacted !== "string") throw new TypeError("content redactor must return a string");
@@ -1488,7 +1426,7 @@ function resolveLangfuseTelemetryConfig(env) {
 		publicKey,
 		secretKey
 	].filter(Boolean).length;
-	if (configured === 0) return void 0;
+	if (configured === 0) return;
 	if (configured !== 3) throw new LangfuseTelemetryConfigError("LANGFUSE_BASE_URL, LANGFUSE_PUBLIC_KEY, and LANGFUSE_SECRET_KEY must be configured together");
 	let endpoint;
 	try {
@@ -1507,13 +1445,14 @@ function resolveLangfuseTelemetryConfig(env) {
 	};
 }
 function createLangfuseAgentTelemetry(config) {
-	const processor = new BatchSpanProcessor(new OTLPTraceExporter({
+	const exporter = new OTLPTraceExporter({
 		headers: {
 			Authorization: `Basic ${Buffer$1.from(`${config.publicKey}:${config.secretKey}`).toString("base64")}`,
 			"x-langfuse-ingestion-version": "4"
 		},
 		url: config.endpoint
-	}), {
+	});
+	const processor = new BatchSpanProcessor(exporter, {
 		scheduledDelayMillis: 1e3,
 		exportTimeoutMillis: 1e4,
 		maxExportBatchSize: 512,
@@ -1579,6 +1518,7 @@ function projectAgentRun(state, event) {
 			finalText: "",
 			phase: "accepted",
 			prompt: event.prompt,
+			...event.userInput ? { userInput: event.userInput } : {},
 			runId: event.runId,
 			sessionKey: event.sessionKey,
 			thinkingText: "",
@@ -1761,6 +1701,7 @@ function updateRunSummary(current, event, state) {
 		case "agent_run_accepted":
 			next.acceptedAt = event.occurredAt;
 			next.prompt = event.prompt;
+			if (event.userInput) next.userInput = event.userInput;
 			next.sessionKey = event.sessionKey;
 			break;
 		case "agent_turn_started":
@@ -1778,7 +1719,6 @@ function updateRunSummary(current, event, state) {
 			if (event.reason === void 0) delete next.cancellationReason;
 			else next.cancellationReason = event.reason;
 			next.cancelledAt = event.occurredAt;
-			break;
 	}
 	return next;
 }
@@ -1796,6 +1736,7 @@ function toRunSummary(summary) {
 		finalText: summary.finalText,
 		phase: summary.phase,
 		...summary.prompt ? { prompt: summary.prompt } : {},
+		...summary.userInput ? { userInput: summary.userInput } : {},
 		runId: summary.runId,
 		...summary.sessionKey ? { sessionKey: summary.sessionKey } : {},
 		...summary.startedAt ? { startedAt: summary.startedAt } : {},
@@ -1859,14 +1800,16 @@ function createAgentTranscriptTurn(summary) {
 		thinkingText: summary.thinkingText,
 		toolExecutionCount: summary.toolExecutionCount,
 		updatedAt: summary.updatedAt,
-		userText: summary.prompt ?? ""
+		userText: summary.prompt ?? "",
+		...summary.userInput ? { userInput: summary.userInput } : {}
 	};
 }
 function createAgentTranscriptMessages(transcript) {
 	return transcript.turns.flatMap((turn) => {
 		const messages = [{
 			content: turn.userText,
-			role: "user"
+			role: "user",
+			...turn.userInput ? { userInput: turn.userInput } : {}
 		}];
 		if (turn.assistantText) messages.push({
 			content: turn.assistantText,
@@ -1878,7 +1821,8 @@ function createAgentTranscriptMessages(transcript) {
 function createAgentConversationMessages(options) {
 	return [...options.transcript ? createAgentTranscriptMessages(options.transcript) : [], {
 		content: options.text,
-		role: "user"
+		role: "user",
+		...options.userInput ? { userInput: options.userInput } : {}
 	}];
 }
 //#endregion
@@ -2196,16 +2140,36 @@ function toDomainEvent(runId, sessionKey, event, occurredAt) {
 function createSteeringChannel() {
 	return Queue.unbounded().pipe(Effect.map((queue) => {
 		let closed = false;
+		const toText = (input) => typeof input === "string" ? input : projectUserInputText(isAgentSteeringRequest(input) ? input.userInput : input);
 		return {
-			next: () => Queue.take(queue),
+			next: () => Queue.take(queue).pipe(Effect.map(toText)),
+			nextInput: () => Queue.take(queue),
 			close: () => Effect.gen(function* () {
+				closed = true;
+				return Array.from(yield* Queue.takeAll(queue)).map(toText);
+			}),
+			closeInput: () => Effect.gen(function* () {
 				closed = true;
 				return Array.from(yield* Queue.takeAll(queue));
 			}),
-			push: (text) => Effect.sync(() => !closed && Queue.unsafeOffer(queue, text))
+			push: (input) => Effect.sync(() => !closed && Queue.unsafeOffer(queue, input))
 		};
 	}));
 }
+function bindAttachmentAccess(access, cancellation) {
+	if (!access) return;
+	const bound = access.bind?.(cancellation.attachmentBinding) ?? access;
+	cancellation.attachmentAccesses.add(bound);
+	return bound;
+}
+function bindAttachmentAccessInput(input, cancellation) {
+	if (typeof input === "string" || !isAgentSteeringRequest(input) || !input.attachmentAccess) return input;
+	const attachmentAccess = bindAttachmentAccess(input.attachmentAccess, cancellation);
+	return attachmentAccess ? {
+		...input,
+		attachmentAccess
+	} : input;
+}
 function createAgentHarness(options) {
 	if (options.runTimeoutMs !== void 0 && (!Number.isSafeInteger(options.runTimeoutMs) || options.runTimeoutMs < 1)) throw new Error("Agent run timeout must be a positive integer");
 	let activeRun;
@@ -2240,6 +2204,10 @@ function createAgentHarness(options) {
 		};
 	};
 	const runPrompt = (command, emit, interruptionReason = "run interrupted") => Effect.gen(function* () {
+		if (command.userInput) command = {
+			...command,
+			userInput: cloneUserInput(command.userInput)
+		};
 		if (activeRun !== void 0) return yield* Effect.fail(new AgentHarnessBusy(activeRun, activeRunState));
 		const runId = yield* options.runIds.next;
 		activeRun = {
@@ -2248,8 +2216,16 @@ function createAgentHarness(options) {
 		};
 		const previousSessionState = queryStore.getSessionState(command.sessionKey);
 		const previousSessionTranscript = queryStore.getSessionTranscript(command.sessionKey);
+		const abortController = new AbortController();
 		const cancellation = {
-			abortController: new AbortController(),
+			abortController,
+			attachmentAccesses: /* @__PURE__ */ new Set(),
+			attachmentBinding: {
+				...options.generationId ? { generationId: options.generationId } : {},
+				runId,
+				sessionKey: command.sessionKey,
+				signal: abortController.signal
+			},
 			deferred: yield* Deferred.make(),
 			steering: yield* createSteeringChannel()
 		};
@@ -2257,6 +2233,7 @@ function createAgentHarness(options) {
 		const events = [];
 		const updates = [];
 		let settled = false;
+		let boundAttachmentAccess;
 		let state = initialAgentRunState;
 		const project = (event) => Effect.gen(function* () {
 			for (const sink of options.eventSinks ?? []) yield* Effect.try({
@@ -2292,12 +2269,14 @@ function createAgentHarness(options) {
 			settled = true;
 		});
 		return yield* Effect.gen(function* () {
+			boundAttachmentAccess = bindAttachmentAccess(command.attachmentAccess, cancellation);
 			const acceptedAt = yield* options.clock.now;
 			yield* record({
 				occurredAt: acceptedAt,
 				prompt: command.text,
 				runId,
 				sessionKey: command.sessionKey,
+				...command.userInput ? { userInput: command.userInput } : {},
 				type: "agent_run_accepted"
 			});
 			const startedAt = yield* options.clock.now;
@@ -2309,17 +2288,20 @@ function createAgentHarness(options) {
 			});
 			const loopInput = {
 				abortSignal: cancellation.abortController.signal,
+				...boundAttachmentAccess ? { attachmentAccess: boundAttachmentAccess } : {},
 				...command.invocation ? { invocation: command.invocation } : {},
 				messages: createAgentConversationMessages({
 					text: command.text,
-					transcript: previousSessionTranscript
+					transcript: previousSessionTranscript,
+					...command.userInput ? { userInput: command.userInput } : {}
 				}),
 				...previousSessionState ? { previousSessionState } : {},
 				...previousSessionTranscript.turnCount > 0 ? { previousSessionTranscript } : {},
 				runId,
 				sessionKey: command.sessionKey,
 				...options.loop.supportsSteering ? { steering: cancellation.steering } : {},
-				text: command.text
+				text: command.text,
+				...command.userInput ? { userInput: command.userInput } : {}
 			};
 			const loop = Effect.try({
 				try: () => options.loop.run(loopInput),
@@ -2394,14 +2376,21 @@ function createAgentHarness(options) {
 				updates
 			};
 		}).pipe(Effect.onInterrupt(() => recordInterruptedRun), Effect.ensuring(Effect.sync(() => {
-			if (!settled && !cancellation.abortController.signal.aborted) cancellation.abortController.abort({
-				reason: interruptionReason,
-				runId,
-				sessionKey: command.sessionKey
-			});
-			activeRun = void 0;
-			activeCancellation = void 0;
-			activeRunState = void 0;
+			try {
+				if (!settled && !cancellation.abortController.signal.aborted) cancellation.abortController.abort({
+					reason: interruptionReason,
+					runId,
+					sessionKey: command.sessionKey
+				});
+			} finally {
+				for (const access of cancellation.attachmentAccesses) try {
+					access.revoke?.();
+				} catch {}
+				cancellation.attachmentAccesses.clear();
+				activeRun = void 0;
+				activeCancellation = void 0;
+				activeRunState = void 0;
+			}
 		})));
 	});
 	const requestCancellation = (runId, reason) => Effect.gen(function* () {
@@ -2418,10 +2407,12 @@ function createAgentHarness(options) {
 		}
 		return completed;
 	});
-	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;
-		return yield* activeCancellation.steering.push(normalized);
+	const requestSteering = (runId, text) => requestSteeringInput(runId, text);
+	const requestSteeringInput = (runId, input) => Effect.gen(function* () {
+		const normalized = typeof input === "string" ? input.trim() : input;
+		if (typeof normalized === "string" && !normalized || typeof normalized !== "string" && options.loop.supportsStructuredSteering !== true || !options.loop.supportsSteering || !activeRun || activeRun.runId !== runId || !activeCancellation || activeCancellation.requested) return false;
+		const bound = bindAttachmentAccessInput(normalized, activeCancellation);
+		return yield* activeCancellation.steering.push(cloneAgentSteeringInput(bound));
 	});
 	const requestSessionCancellation = (sessionKey, runId, reason) => {
 		if (!activeRun || activeRun.sessionKey !== sessionKey) return Effect.succeed(false);
@@ -2431,6 +2422,10 @@ function createAgentHarness(options) {
 		if (!activeRun || activeRun.sessionKey !== sessionKey) return Effect.succeed(false);
 		return requestSteering(runId, text);
 	};
+	const requestSessionSteeringInput = (sessionKey, runId, input) => {
+		if (!activeRun || activeRun.sessionKey !== sessionKey) return Effect.succeed(false);
+		return requestSteeringInput(runId, input);
+	};
 	const requestSessionActiveCancellation = (sessionKey, reason) => {
 		if (!activeRun || activeRun.sessionKey !== sessionKey) return Effect.succeed(false);
 		return requestCancellation(activeRun.runId, reason);
@@ -2446,10 +2441,12 @@ function createAgentHarness(options) {
 		}),
 		cancelRun: requestCancellation,
 		steerRun: requestSteering,
+		steerRunInput: requestSteeringInput,
 		forSession: (sessionKey) => ({
 			cancelActiveRun: (reason) => requestSessionActiveCancellation(sessionKey, reason),
 			cancelRun: (runId, reason) => requestSessionCancellation(sessionKey, runId, reason),
 			steerRun: (runId, text) => requestSessionSteering(sessionKey, runId, text),
+			steerRunInput: (runId, input) => requestSessionSteeringInput(sessionKey, runId, input),
 			getActiveRun: () => getSessionActiveRun(sessionKey),
 			getActiveRunState: () => getSessionActiveRunState(sessionKey),
 			getAvailability: () => getSessionAvailability(sessionKey),
@@ -2673,50 +2670,9 @@ function abortError(signal) {
 	return signal.reason instanceof Error ? signal.reason : /* @__PURE__ */ new Error("Run admission aborted");
 }
 //#endregion
-//#region src/core/application/memory/compaction/compaction-service.ts
-var CompactionError = class extends Error {
-	name = "CompactionError";
-};
-function createEffectCompactionService(options) {
-	const candidates = /* @__PURE__ */ new Map();
-	const committed = /* @__PURE__ */ new Map();
-	const serial = Effect.unsafeMakeSemaphore(1);
-	return {
-		createCandidate: (input) => {
-			const safeInput = Object.freeze({
-				agentId: input.agentId,
-				conversationId: input.conversationId,
-				instanceId: input.instanceId,
-				profileRevision: input.profileRevision,
-				tenantId: input.tenantId,
-				transcript: Object.freeze([...input.transcript]),
-				watermark: input.watermark
-			});
-			return options.compactor.compact(safeInput).pipe(Effect.map((summary) => Object.freeze({
-				agentId: input.agentId,
-				conversationId: input.conversationId,
-				id: `compaction:${options.identity.next()}`,
-				instanceId: input.instanceId,
-				profileRevision: input.profileRevision,
-				summary,
-				tenantId: input.tenantId,
-				watermark: input.watermark
-			})), Effect.tap((candidate) => Effect.sync(() => candidates.set(candidate.id, candidate))));
-		},
-		commit: (candidateId) => serial.withPermits(1)(Effect.suspend(() => {
-			const candidate = candidates.get(candidateId);
-			if (!candidate) return Effect.fail(new CompactionError(`unknown compaction candidate: ${candidateId}`));
-			const key = `${candidate.instanceId}/${candidate.conversationId}`;
-			const current = committed.get(key);
-			if (current && current.watermark >= candidate.watermark) return Effect.fail(new CompactionError("compaction watermark conflict"));
-			return Effect.sync(() => {
-				committed.set(key, candidate);
-				candidates.delete(candidateId);
-				return candidate;
-			});
-		})),
-		current: (instanceId, conversationId) => committed.get(`${instanceId}/${conversationId}`)
-	};
+//#region src/adapters/agent/memory/persisted-memory-record.ts
+function restorePersistedMemoryRecord(snapshot) {
+	return restoreMemoryRecord(snapshot);
 }
 //#endregion
 //#region src/adapters/outbound/persistence/memory/agent-memory-repository-contract.ts
@@ -2730,9 +2686,6 @@ function resolveAgentMemoryUpdate(previous, next) {
 	if (!previous.validateTransitionTo(next)) throw new Error("memory revision or transition conflict");
 	return next;
 }
-//#endregion
-//#region src/adapters/outbound/persistence/memory/agent-memory-snapshot-codec.ts
-const AGENT_MEMORY_JSONL_VERSION = 1;
 function encodeAgentMemorySnapshot(snapshot) {
 	return JSON.stringify({
 		snapshot,
@@ -2756,7 +2709,7 @@ function decodeAgentMemorySnapshots(raw) {
 		} catch {
 			throw invalidSnapshot(index);
 		}
-		const key = `${createMemoryNamespace$1(record.binding)}\u0000${record.id}`;
+		const key = `${createMemoryNamespace(record.binding)}\u0000${record.id}`;
 		const previous = latest.get(key);
 		try {
 			if (previous) resolveAgentMemoryUpdate(previous, record);
@@ -2777,7 +2730,7 @@ function createInMemoryAgentMemoryRepository(options = {}) {
 	const records = /* @__PURE__ */ new Map();
 	for (const snapshot of options.initial ?? []) {
 		const restored = restorePersistedAgentMemoryRecord(snapshot);
-		const namespace = createMemoryNamespace$1(restored.binding);
+		const namespace = createMemoryNamespace(restored.binding);
 		const bucket = records.get(namespace) ?? /* @__PURE__ */ new Map();
 		if (bucket.has(restored.id)) throw new AgentMemoryRepositoryConflict(`duplicate initial memory: ${restored.id}`);
 		bucket.set(restored.id, restored);
@@ -2785,8 +2738,8 @@ function createInMemoryAgentMemoryRepository(options = {}) {
 	}
 	const serial = Effect.unsafeMakeSemaphore(1);
 	return {
-		get: (binding, id) => Effect.sync(() => records.get(createMemoryNamespace$1(binding))?.get(id)),
-		list: (binding) => Effect.sync(() => [...records.get(createMemoryNamespace$1(binding))?.values() ?? []]),
+		get: (binding, id) => Effect.sync(() => records.get(createMemoryNamespace(binding))?.get(id)),
+		list: (binding) => Effect.sync(() => [...records.get(createMemoryNamespace(binding))?.values() ?? []]),
 		save: (snapshotInput) => serial.withPermits(1)(Effect.uninterruptible(Effect.suspend(() => {
 			let record;
 			try {
@@ -2794,7 +2747,7 @@ function createInMemoryAgentMemoryRepository(options = {}) {
 			} catch {
 				return Effect.fail(new AgentMemoryRepositoryConflict("memory revision or transition conflict"));
 			}
-			const namespace = createMemoryNamespace$1(record.binding);
+			const namespace = createMemoryNamespace(record.binding);
 			const bucket = records.get(namespace) ?? /* @__PURE__ */ new Map();
 			const previous = bucket.get(record.id);
 			try {
@@ -3222,7 +3175,7 @@ function restoreToolOperation(snapshot) {
 var ToolOperationLedgerError = class extends Error {
 	name = "ToolOperationLedgerError";
 };
-function createToolOperationLedger$1(options = {}) {
+function createToolOperationLedger(options = {}) {
 	const records = /* @__PURE__ */ new Map();
 	for (const snapshot of options.initial ?? []) {
 		const operation = restoreToolOperation(snapshot);
@@ -3330,7 +3283,7 @@ var ToolInvocationDenied = class extends Error {
 	name = "ToolInvocationDenied";
 };
 function createToolBroker(options) {
-	const operations = options.operations ?? createToolOperationLedger$1();
+	const operations = options.operations ?? createToolOperationLedger();
 	const hostTools = new Map(options.hostTools?.map((tool) => [tool.id, tool]) ?? []);
 	if (hostTools.size !== (options.hostTools?.length ?? 0)) throw new ToolInvocationDenied("duplicate Host Tool id");
 	return { execute: (request) => Effect.gen(function* () {
@@ -3341,8 +3294,8 @@ function createToolBroker(options) {
 		const policy = yield* options.policy.current();
 		if (policy.revokedToolIds.includes(request.toolId)) return yield* Effect.fail(new ToolInvocationDenied(`tool has been revoked: ${request.toolId}`));
 		if (prepared.tool.idempotency === "required" && !request.operationId) return yield* Effect.fail(new ToolInvocationDenied(`tool requires a stable operation id: ${request.toolId}`));
-		if (requiresToolApproval$1(prepared.tool.risk) && !request.operationId) return yield* Effect.fail(new ToolInvocationDenied(`tool approval requires a stable operation id: ${request.toolId}`));
-		if (requiresToolApproval$1(prepared.tool.risk) && !request.approvalId) return yield* Effect.fail(new ToolInvocationDenied(`tool requires trusted approval: ${request.toolId}`));
+		if (requiresToolApproval(prepared.tool.risk) && !request.operationId) return yield* Effect.fail(new ToolInvocationDenied(`tool approval requires a stable operation id: ${request.toolId}`));
+		if (requiresToolApproval(prepared.tool.risk) && !request.approvalId) return yield* Effect.fail(new ToolInvocationDenied(`tool requires trusted approval: ${request.toolId}`));
 		const binding = yield* Effect.try({
 			catch: (error) => error,
 			try: () => createOperationBinding(prepared.authority, prepared.tool, request.input, options.digest)
@@ -3354,7 +3307,7 @@ function createToolBroker(options) {
 			if (inspected.status === "completed") return yield* replayCompleted(inspected.result);
 			if (inspected.status === "blocked") return yield* Effect.fail(new ToolInvocationDenied(`tool operation is fenced: ${inspected.reason}`));
 		}
-		if (requiresToolApproval$1(prepared.tool.risk)) {
+		if (requiresToolApproval(prepared.tool.risk)) {
 			if (!(yield* options.approvals.consume({
 				agentId: prepared.authority.agentId,
 				approvalId: request.approvalId,
@@ -3405,7 +3358,7 @@ function prepareInvocation(hostTools, catalog, request) {
 function createOperationBinding(authority, tool, input, digest) {
 	let inputDigest;
 	try {
-		inputDigest = createToolInputDigest$1(input, digest);
+		inputDigest = createToolInputDigest(input, digest);
 	} catch (error) {
 		if (error instanceof InvalidToolInput) throw new ToolInvocationDenied(`tool input is not stable JSON: ${tool.id}`);
 		throw error;
@@ -3461,9 +3414,6 @@ const RIVUS_RUNTIME_TOOL_IDS = Object.freeze([
 function isRivusRuntimeToolId(value) {
 	return RIVUS_RUNTIME_TOOL_IDS.includes(value);
 }
-//#endregion
-//#region src/adapters/outbound/persistence/tool-operation/tool-operation-snapshot-codec.ts
-const TOOL_OPERATION_JSONL_VERSION = 1;
 function encodeToolOperationSnapshot(record) {
 	return JSON.stringify({
 		record,
@@ -3503,7 +3453,7 @@ function openJsonlToolOperationLedger(options) {
 			if (recovered !== operation) yield* persist(options.filePath, recovered.toSnapshot());
 			initial.push(recovered.toSnapshot());
 		}
-		return createToolOperationLedger$1({
+		return createToolOperationLedger({
 			initial,
 			persist: (record) => persist(options.filePath, record)
 		});
@@ -3748,417 +3698,5 @@ function readDate(value, field, lineNumber) {
 	return date;
 }
 //#endregion
-//#region src/testing/fakes.ts
-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(() => {
-		const runId = runIds[index];
-		if (runId === void 0) throw new Error("No run ids left in test generator");
-		index += 1;
-		return runId;
-	}) };
-}
-//#endregion
-//#region src/adapters/compatibility/agent-execution/loop/agent-loop-prompt-transformer.ts
-function createAgentLoopPromptTransformer(options) {
-	return {
-		run: (input) => Stream.unwrap(Effect.promise(() => Promise.resolve(options.transform(input))).pipe(Effect.map((text) => options.loop.run({
-			...input,
-			text
-		})))),
-		...options.loop.supportsSteering ? { supportsSteering: true } : {}
-	};
-}
-//#endregion
-//#region src/adapters/compatibility/agent-execution/runtime/agent-harness.ts
-function createAgentHarness$1(options) {
-	return createAgentHarness({
-		...options,
-		loop: toEffectAgentLoop(options.loop)
-	});
-}
-//#endregion
-//#region src/adapters/compatibility/agent-execution/runtime/agent-callback-adapters.ts
-function createAgentDomainEventSinkFromCallback(append) {
-	return createAgentDomainEventSink((event) => Effect.tryPromise({
-		try: async () => {
-			await append(event);
-		},
-		catch: (cause) => cause
-	}));
-}
-function createAgentDomainEventHandler(handle) {
-	return (event) => Effect.tryPromise({
-		try: async () => {
-			await handle(event);
-		},
-		catch: (cause) => cause
-	});
-}
-function createAgentRunUpdateHandler(handle) {
-	return (update) => Effect.tryPromise({
-		try: async () => {
-			await handle(update);
-		},
-		catch: (cause) => cause
-	});
-}
-//#endregion
-//#region src/adapters/compatibility/agent-execution/runtime/agent-harness-client.ts
-function createAgentHarnessClient(harness) {
-	return {
-		cancelActiveRun: (reason) => Effect.runPromise(harness.cancelActiveRun(reason)),
-		cancelRun: (runId, reason) => Effect.runPromise(harness.cancelRun(runId, reason)),
-		forSession: (sessionKey) => createAgentSessionClient(harness.forSession(sessionKey)),
-		getActiveRun: () => harness.getActiveRun(),
-		getActiveRunId: () => harness.getActiveRunId(),
-		getActiveRunState: () => harness.getActiveRunState(),
-		getAvailability: () => harness.getAvailability(),
-		getHistory: () => harness.getHistory(),
-		getRunEvents: (runId) => harness.getRunEvents(runId),
-		getRunSnapshot: (runId) => harness.getRunSnapshot(runId),
-		getRunSummary: (runId) => harness.getRunSummary(runId),
-		getRunState: (runId) => harness.getRunState(runId),
-		getRunUpdates: (runId) => harness.getRunUpdates(runId),
-		getSessionHistory: (sessionKey) => harness.getSessionHistory(sessionKey),
-		getSessionLatestRunSnapshot: (sessionKey) => harness.getSessionLatestRunSnapshot(sessionKey),
-		getSessionLatestRunSummary: (sessionKey) => harness.getSessionLatestRunSummary(sessionKey),
-		getSessionRuns: (sessionKey) => harness.getSessionRuns(sessionKey),
-		getSessionSnapshot: (sessionKey) => harness.getSessionSnapshot(sessionKey),
-		getSessionSummary: (sessionKey) => harness.getSessionSummary(sessionKey),
-		getSessionTranscript: (sessionKey) => harness.getSessionTranscript(sessionKey),
-		getSessionState: (sessionKey) => harness.getSessionState(sessionKey),
-		getState: () => harness.getState(),
-		harness,
-		prompt: (command) => Effect.runPromise(harness.prompt(command)),
-		promptRunSnapshot: (command) => Effect.runPromise(harness.promptRunSnapshot(command)),
-		promptSnapshot: (command) => Effect.runPromise(harness.promptSnapshot(command)),
-		promptText: (command) => Effect.runPromise(harness.promptText(command)),
-		promptTurn: (command) => Effect.runPromise(harness.promptTurn(command)),
-		promptWithEvents: (command, onEvent) => Effect.runPromise(harness.promptWithEvents(command, createAgentDomainEventHandler(onEvent))),
-		promptWithText: (command, onTextDelta) => Effect.runPromise(harness.promptWithEvents(command, createTextDeltaEventHandler(onTextDelta))),
-		promptWithUpdates: (command, onUpdate) => Effect.runPromise(harness.promptWithUpdates(command, createAgentRunUpdateHandler(onUpdate))),
-		stream: (command) => Stream.toAsyncIterable(harness.stream(command)),
-		streamText: (command) => Stream.toAsyncIterable(harness.streamText(command)),
-		streamUpdates: (command) => Stream.toAsyncIterable(harness.streamUpdates(command)),
-		subscribe: (listener) => harness.subscribe(listener),
-		subscribeRun: (runId, listener) => harness.subscribeRun(runId, listener),
-		subscribeRunUpdates: (runId, listener) => harness.subscribeRunUpdates(runId, listener),
-		subscribeUpdates: (listener) => harness.subscribeUpdates(listener),
-		tryPrompt: (command) => runAttempt(harness.prompt(command)),
-		tryPromptText: (command) => runAttempt(harness.promptText(command))
-	};
-}
-function createAgentSessionClient(handle) {
-	return {
-		cancelActiveRun: (reason) => Effect.runPromise(handle.cancelActiveRun(reason)),
-		cancelRun: (runId, reason) => Effect.runPromise(handle.cancelRun(runId, reason)),
-		getActiveRun: () => handle.getActiveRun(),
-		getActiveRunState: () => handle.getActiveRunState(),
-		getAvailability: () => handle.getAvailability(),
-		getHistory: () => handle.getHistory(),
-		getLatestRunSnapshot: () => handle.getLatestRunSnapshot(),
-		getLatestRunSummary: () => handle.getLatestRunSummary(),
-		getRunEvents: (runId) => handle.getRunEvents(runId),
-		getRunSnapshot: (runId) => handle.getRunSnapshot(runId),
-		getRunSummary: (runId) => handle.getRunSummary(runId),
-		getRuns: () => handle.getRuns(),
-		getRunState: (runId) => handle.getRunState(runId),
-		getRunUpdates: (runId) => handle.getRunUpdates(runId),
-		getSnapshot: () => handle.getSnapshot(),
-		getState: () => handle.getState(),
-		getSummary: () => handle.getSummary(),
-		getTranscript: () => handle.getTranscript(),
-		handle,
-		prompt: (text) => Effect.runPromise(handle.prompt(text)),
-		promptRunSnapshot: (text) => Effect.runPromise(handle.promptRunSnapshot(text)),
-		promptSnapshot: (text) => Effect.runPromise(handle.promptSnapshot(text)),
-		promptText: (text) => Effect.runPromise(handle.promptText(text)),
-		promptTurn: (text) => Effect.runPromise(handle.promptTurn(text)),
-		promptWithEvents: (text, onEvent) => Effect.runPromise(handle.promptWithEvents(text, createAgentDomainEventHandler(onEvent))),
-		promptWithText: (text, onTextDelta) => Effect.runPromise(handle.promptWithEvents(text, createTextDeltaEventHandler(onTextDelta))),
-		promptWithUpdates: (text, onUpdate) => Effect.runPromise(handle.promptWithUpdates(text, createAgentRunUpdateHandler(onUpdate))),
-		sessionKey: handle.sessionKey,
-		stream: (text) => Stream.toAsyncIterable(handle.stream(text)),
-		streamText: (text) => Stream.toAsyncIterable(handle.streamText(text)),
-		streamUpdates: (text) => Stream.toAsyncIterable(handle.streamUpdates(text)),
-		subscribe: (listener) => handle.subscribe(listener),
-		subscribeRun: (runId, listener) => handle.subscribeRun(runId, listener),
-		subscribeRunUpdates: (runId, listener) => handle.subscribeRunUpdates(runId, listener),
-		subscribeUpdates: (listener) => handle.subscribeUpdates(listener),
-		tryPrompt: (text) => runAttempt(handle.prompt(text)),
-		tryPromptText: (text) => runAttempt(handle.promptText(text))
-	};
-}
-function createTextDeltaEventHandler(onTextDelta) {
-	return createAgentDomainEventHandler((event) => {
-		if (!isAssistantTextDeltaEvent(event)) return;
-		return onTextDelta(event.delta);
-	});
-}
-async function runAttempt(effect) {
-	const exit = await Effect.runPromiseExit(effect);
-	if (Exit.isSuccess(exit)) return {
-		ok: true,
-		value: exit.value
-	};
-	const failure = Cause.failureOption(exit.cause);
-	return {
-		error: Option.isSome(failure) ? failure.value : exit.cause,
-		ok: false
-	};
-}
-//#endregion
-//#region src/adapters/compatibility/agent-execution/runtime/agent-runtime-primitives.ts
-const DEFAULT_MAIN_SESSION_KEY = "main";
-function createDefaultAgentHarness(options) {
-	return createAgentHarness$1({
-		...options,
-		clock: options.clock ?? createSystemClock(),
-		runIds: options.runIds ?? createUuidRunIds()
-	});
-}
-function createDefaultAgentHarnessFromCallback(run, options = {}) {
-	return createDefaultAgentHarness({
-		...options,
-		loop: createAgentLoopFromCallback(run)
-	});
-}
-function createDefaultAgentHarnessFromTextCallback(generate, options = {}) {
-	return createDefaultAgentHarness({
-		...options,
-		loop: createTextAgentLoopFromCallback(generate)
-	});
-}
-function createDefaultAgentHarnessClient(options) {
-	return createAgentHarnessClient(createDefaultAgentHarness(options));
-}
-function createDefaultAgentHarnessClientFromCallback(run, options = {}) {
-	return createAgentHarnessClient(createDefaultAgentHarnessFromCallback(run, options));
-}
-function createDefaultAgentHarnessClientFromTextCallback(generate, options = {}) {
-	return createAgentHarnessClient(createDefaultAgentHarnessFromTextCallback(generate, options));
-}
-function createDefaultAgentRuntime(options, runtimeOptions = {}) {
-	return createAgentRuntime(createDefaultAgentHarness(options), runtimeOptions);
-}
-function createDefaultAgentRuntimeFromCallback(run, options = {}, runtimeOptions = {}) {
-	return createAgentRuntime(createDefaultAgentHarnessFromCallback(run, options), runtimeOptions);
-}
-function createDefaultAgentRuntimeFromTextCallback(generate, options = {}, runtimeOptions = {}) {
-	return createAgentRuntime(createDefaultAgentHarnessFromTextCallback(generate, options), runtimeOptions);
-}
-function createSystemClock() {
-	return { now: Effect.sync(() => /* @__PURE__ */ new Date()) };
-}
-function createUuidRunIds() {
-	return { next: Effect.sync(() => randomUUID()) };
-}
-function createAgentRuntime(harness, options = {}) {
-	const mainSessionKey = options.mainSessionKey ?? DEFAULT_MAIN_SESSION_KEY;
-	const client = createAgentHarnessClient(harness);
-	const mainClient = client.forSession(mainSessionKey);
-	return {
-		client,
-		forSession: (sessionKey) => harness.forSession(sessionKey),
-		forSessionClient: (sessionKey) => client.forSession(sessionKey),
-		harness,
-		mainClient,
-		mainSession: harness.forSession(mainSessionKey),
-		mainSessionKey,
-		prompt: (text) => mainClient.prompt(text),
-		promptText: (text) => mainClient.promptText(text),
-		promptTurn: (text) => mainClient.promptTurn(text),
-		tryPrompt: (text) => mainClient.tryPrompt(text),
-		tryPromptText: (text) => mainClient.tryPromptText(text)
-	};
-}
-//#endregion
-//#region src/adapters/compatibility/memory/public-contract.ts
-function createMemoryNamespace(binding) {
-	return {
-		conversation: [
-			binding.tenantId,
-			binding.agentId,
-			binding.subjectId,
-			binding.conversationId ?? "",
-			binding.scope
-		],
-		"agent-private": [
-			binding.tenantId,
-			binding.agentId,
-			binding.subjectId,
-			binding.scope
-		],
-		project: [
-			binding.tenantId,
-			binding.agentId,
-			binding.projectId ?? "",
-			binding.scope
-		],
-		"shared-user-profile": [
-			binding.tenantId,
-			binding.subjectId,
-			binding.scope
-		]
-	}[binding.scope].map(encodeURIComponent).join("/");
-}
-function restrictMemoryScopesForAudience(scopes, audience) {
-	return audience === "group" ? scopes.filter((scope) => scope === "conversation" || scope === "project") : [...scopes];
-}
-//#endregion
-//#region src/adapters/compatibility/memory/legacy-memory-adapter.ts
-function adaptLegacyMemoryService(service) {
-	return { bind: (binding) => adaptLegacyMemoryHandle(service.bind(binding)) };
-}
-function adaptLegacyMemoryHandle(handle) {
-	return Object.freeze({
-		namespace: handle.namespace,
-		scope: handle.scope,
-		confirm: async (input) => toCanonicalRecord(await handle.confirm(input)),
-		forgetRequest: async (input) => toCanonicalRecord(await handle.forgetRequest(input)),
-		inspect: async (id) => toOptionalCanonicalRecord(await handle.inspect(id)),
-		propose: async (input) => toCanonicalRecord(await handle.propose(input)),
-		read: async (id) => toOptionalCanonicalRecord(await handle.read(id)),
-		search: async (query) => (await handle.search(query)).map((record) => toCanonicalRecord(record))
-	});
-}
-function toCanonicalRecord(record) {
-	return { ...record };
-}
-function toOptionalCanonicalRecord(record) {
-	return record === void 0 ? void 0 : toCanonicalRecord(record);
-}
-//#endregion
-//#region src/adapters/compatibility/memory/project-memory-prompt-preparer.ts
-function createLegacyProjectMemoryPromptPreparer(options) {
-	const prepare = createProjectMemoryPromptPreparer({
-		...options,
-		memory: adaptLegacyMemoryService(options.memory)
-	});
-	return (input) => prepare(input);
-}
-//#endregion
-//#region src/adapters/compatibility/memory/rivus-memory-tool.ts
-function createLegacyRivusMemoryTool(memory) {
-	const tool = createRivusMemoryTool(Array.isArray(memory) ? memory.map(adaptLegacyMemoryHandle) : [adaptLegacyMemoryHandle(memory)]);
-	return {
-		execute: async (command) => executeLegacyCommand(tool, command),
-		replayCompleted: (command, completedResult) => tool.replayCompleted(command, completedResult)
-	};
-}
-async function executeLegacyCommand(tool, command) {
-	return tool.execute(command);
-}
-function createLegacyRivusMemoryToolDescriptor(options) {
-	return createRivusMemoryToolDescriptor({ memory: adaptLegacyMemoryService(options.memory) });
-}
-//#endregion
-//#region src/adapters/compatibility/tool-execution/runtime/effect-runner.ts
-async function runToolExecutionEffect(effect) {
-	const exit = await Effect.runPromiseExit(effect);
-	if (Exit.isSuccess(exit)) return exit.value;
-	throw failureOrCause(exit.cause);
-}
-function runToolExecutionEffectSync(effect) {
-	const exit = Effect.runSyncExit(effect);
-	if (Exit.isSuccess(exit)) return exit.value;
-	throw failureOrCause(exit.cause);
-}
-function failureOrCause(cause) {
-	const failure = Cause.failureOption(cause);
-	return Option.isSome(failure) ? failure.value : Cause.squash(cause);
-}
-//#endregion
-//#region src/adapters/compatibility/memory/compaction/compaction-service.ts
-function createCompactionService(options) {
-	const service = createEffectCompactionService({
-		compactor: { compact: (input) => Effect.tryPromise({
-			catch: (error) => error,
-			try: () => options.compactor.compact(input)
-		}) },
-		identity: { next: () => randomUUID() }
-	});
-	return {
-		createCandidate: (input) => runToolExecutionEffect(service.createCandidate(input)),
-		commit: (candidateId) => runToolExecutionEffectSync(service.commit(candidateId)),
-		current: (instanceId, conversationId) => service.current(instanceId, conversationId)
-	};
-}
-//#endregion
-//#region src/adapters/compatibility/tool-execution/public-contract.ts
-function createInvocationAuthority$1(authority) {
-	return createInvocationAuthority(authority);
-}
-function createToolInputDigest(input) {
-	return createToolInputDigest$1(input, createSha256Digest);
-}
-function requiresToolApproval(risk) {
-	return requiresToolApproval$1(risk);
-}
-//#endregion
-//#region src/adapters/compatibility/tool-execution/tool-operation-ledger.ts
-const effectLedger = Symbol("rivus.tool-execution.effect-ledger");
-function createToolOperationLedger(options = {}) {
-	return adaptEffectToolOperationLedger(createToolOperationLedger$1({
-		...options.initial ? { initial: options.initial } : {},
-		...options.persist ? { persist: (record) => Effect.tryPromise({
-			catch: (error) => error,
-			try: () => options.persist(record)
-		}) } : {}
-	}));
-}
-function adaptEffectToolOperationLedger(ledger) {
-	const facade = {
-		abort: (operationId, binding) => runToolExecutionEffect(ledger.abort(operationId, binding)),
-		begin: (operationId, binding) => runToolExecutionEffect(ledger.begin(operationId, binding)),
-		complete: (operationId, binding, result) => runToolExecutionEffect(ledger.complete(operationId, binding, result)),
-		inspect: (operationId, binding) => runToolExecutionEffect(ledger.inspect(operationId, binding)),
-		reconciliationRequired: () => ledger.reconciliationRequired(),
-		reconcile: async (input) => {
-			const action = createRecoveryAction(input.action);
-			return runToolExecutionEffect(ledger.reconcile({
-				...input,
-				action,
-				outcome: input.outcome
-			}));
-		},
-		requireReconciliation: (operationId, binding, reason) => runToolExecutionEffect(ledger.requireReconciliation(operationId, binding, reason)),
-		unresolvedForSource: (sourceMessageId) => ledger.unresolvedForSource(sourceMessageId)
-	};
-	Object.defineProperty(facade, effectLedger, { value: ledger });
-	return Object.freeze(facade);
-}
-function toEffectToolOperationLedger(ledger) {
-	if (effectLedger in ledger) return ledger[effectLedger];
-	return {
-		abort: (operationId, binding) => fromPromise(() => ledger.abort(operationId, binding)),
-		begin: (operationId, binding) => fromPromise(() => ledger.begin(operationId, binding)),
-		complete: (operationId, binding, result) => fromPromise(() => ledger.complete(operationId, binding, result)),
-		inspect: (operationId, binding) => fromPromise(() => ledger.inspect(operationId, binding)),
-		reconciliationRequired: () => ledger.reconciliationRequired(),
-		reconcile: (input) => fromPromise(() => ledger.reconcile(input)),
-		requireReconciliation: (operationId, binding, reason) => fromPromise(() => ledger.requireReconciliation(operationId, binding, reason)),
-		unresolvedForSource: (sourceMessageId) => ledger.unresolvedForSource(sourceMessageId)
-	};
-}
-function fromPromise(operation) {
-	return Effect.tryPromise({
-		catch: (error) => error,
-		try: operation
-	});
-}
-//#endregion
-export { AGENT_MEMORY_JSONL_VERSION, AgentContextBudgetExceeded, AgentEventHandlerFailed, AgentEventLogStoreError, AgentEventSinkFailed, AgentHarnessBusy, AgentLoopFailed, AgentMemoryError, AgentMemoryRepositoryConflict, AgentRunCancelled, CompactionError, CompactionError as LegacyCompactionError, InvalidInvocationAuthority, InvalidInvocationAuthority as LegacyInvalidInvocationAuthority, InvalidRecoveryAction, InvalidStableJson, InvalidStableJson as LegacyInvalidStableJson, InvalidToolInput, InvalidToolInput as LegacyInvalidToolInput, InvalidWorkspaceRoot, LangfuseTelemetryConfigError, MEMORY_SCOPES, ModelChangeBoundaryDeadlineError, RIVUS_MEMORY_TOOL_ID, RIVUS_MEMORY_TOOL_PLUGIN_ID, RIVUS_MEMORY_TOOL_VERSION, RIVUS_RUNTIME_TOOL_IDS, RivusToolInputRejected, TOOL_OPERATION_JSONL_VERSION, ToolExecutorInputRejected, ToolInvocationDenied, ToolOperationLedgerError, WorkspaceInstructionsSourceError, adaptEffectToolOperationLedger as adaptLegacyEffectToolOperationLedger, assembleAgentContext, buildAgentSessionSnapshot, buildRunSnapshot, createAgentConversationMessages, createAgentDomainEventHandler, createAgentDomainEventSink, createAgentDomainEventSinkFromCallback, createAgentExecutionQueryStore, createAgentHarness, createAgentHarnessClient, createAgentLoopModelExecutionEnd, createAgentLoopModelExecutionStart, createAgentLoopSkillExecutionEnd, createAgentLoopSkillExecutionStart, createAgentLoopTextDelta, createAgentLoopThinkingDelta, createAgentLoopToolExecutionEnd, createAgentLoopToolExecutionStart, createAgentLoopToolExecutionUpdate, createAgentLoopTurnStart, createAgentRunStreams, createAgentRunUpdateHandler, createAgentRuntime, createAgentTranscriptMessages, createAgentTranscriptTurn, createAgentsMdInstructionsSource, createDefaultAgentHarness, createDefaultAgentHarnessClient, createDefaultAgentHarnessClientFromCallback, createDefaultAgentHarnessClientFromTextCallback, createDefaultAgentHarnessFromCallback, createDefaultAgentHarnessFromTextCallback, createDefaultAgentRuntime, createDefaultAgentRuntimeFromCallback, createDefaultAgentRuntimeFromTextCallback, createEffectCompactionService, createEventAgentLoop, createFixedClock, createInMemoryAgentMemoryRepository, createInvocationAuthority, createJsonlAgentEventLog, createLangfuseAgentTelemetry, createAgentHarness$1 as createLegacyAgentHarness, createAgentLoopFromCallback as createLegacyAgentLoopFromCallback, createAgentLoopPromptTransformer as createLegacyAgentLoopPromptTransformer, createAsyncIterableAgentLoop as createLegacyAsyncIterableAgentLoop, createCompactionService as createLegacyCompactionService, createEventAgentLoop$1 as createLegacyEventAgentLoop, createInvocationAuthority$1 as createLegacyInvocationAuthority, createMemoryNamespace as createLegacyMemoryNamespace, createLegacyProjectMemoryPromptPreparer, createLegacyRivusMemoryTool, createLegacyRivusMemoryToolDescriptor, createTextAgentLoop as createLegacyTextAgentLoop, createTextAgentLoopFromCallback as createLegacyTextAgentLoopFromCallback, createToolInputDigest as createLegacyToolInputDigest, createToolOperationLedger as createLegacyToolOperationLedger, createMemoryNamespace$1 as createMemoryNamespace, createMemoryService, createOpenTelemetryAgentEventSink, createOpenTelemetryAgentTelemetry, createPersistedMemoryRecord, createProjectMemoryPromptPreparer, createRecoveryAction, createRivusMemoryTool, createRivusMemoryToolContract, createRivusMemoryToolDescriptor, createRunAdmission, createSequenceRunIds, createSystemClock, createTelemetryContentRedactor, createTestClock, createTextAgentLoop$1 as createTextAgentLoop, createToolBroker, createToolInputDigest$1 as createToolInputDigest, createToolOperationLedger$1 as createToolOperationLedger, createUuidRunIds, createWorkspaceInstructionsResolver, createWorkspaceRootHandle, decodeAgentMemorySnapshots, decodeToolOperationSnapshots, describeLoopError, encodeAgentMemorySnapshot, encodeToolOperationSnapshot, evolveAgentRun, fromEffectAgentLoop as fromEffectLegacyAgentLoop, initialAgentRunState, isAgentToolExecutionEvent, isAssistantTextDeltaEvent, isAssistantThinkingDeltaEvent, isRivusRuntimeToolId, isTerminalAgentDomainEvent, isTerminalAgentRunPhase, normalizeAgentInvocation, normalizeAgentLoopEvent, normalizeStableJson as normalizeLegacyStableJson, normalizeStableJson, normalizeMemoryBinding, notifyListeners, notifyUpdateListeners, openJsonlAgentMemoryRepository, openJsonlToolOperationLedger, projectAgentSessionHistory, remainingUntil, replayAgentHistory, replayAgentTranscript, replayRunUpdates, requiresToolApproval as requiresLegacyToolApproval, requiresToolApproval$1 as requiresToolApproval, resolveInvocationAuthority, resolveLangfuseTelemetryConfig, resolveWorkspaceRootPath, restoreAgentHistory, restorePersistedMemoryRecord, restoreToolOperation as restorePersistedToolOperation, restrictMemoryScopesForAudience as restrictLegacyMemoryScopesForAudience, toDomainEvent, toEffectAgentLoop as toEffectLegacyAgentLoop, toEffectAgentLoopInput as toEffectLegacyAgentLoopInput, toEffectToolOperationLedger as toEffectLegacyToolOperationLedger, toCompatibilityAgentLoopInput as toLegacyAgentLoopInput, toRunUpdate };
+export { ATTACHMENT_RECOVERY_COMMAND, AgentEventHandlerFailed, AgentEventSinkFailed, AgentLoopFailed, AgentRunCancelled, InvalidInvocationAuthority, ModelChangeBoundaryDeadlineError, RIVUS_MEMORY_TOOL_ID, RIVUS_MEMORY_TOOL_PLUGIN_ID, RIVUS_MEMORY_TOOL_VERSION, RIVUS_RUNTIME_TOOL_IDS, RivusToolInputRejected, ToolExecutorInputRejected, ToolInvocationDenied, createAgentHarness, createAgentsMdInstructionsSource, createInvocationAuthority, createJsonlAgentEventLog, createLangfuseAgentTelemetry, createMemoryService, createProjectMemoryPromptPreparer, createRecoveryAction, createRivusMemoryToolContract, createRivusMemoryToolDescriptor, createRunAdmission, createTelemetryContentRedactor, createToolBroker, createToolInputDigest, createWorkspaceInstructionsResolver, createWorkspaceRootHandle, isRivusRuntimeToolId, normalizeAgentInvocation, openJsonlAgentMemoryRepository, openJsonlToolOperationLedger, remainingUntil, resolveInvocationAuthority, resolveLangfuseTelemetryConfig, restoreAgentHistory };
+