@rivus/agent 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { $ as createAgentTranscriptTurn, A as createAgentLoopModelExecutionStart
 import { a as MemoryBinding, c as MemoryScope, d as RIVUS_MEMORY_TOOL_PLUGIN_ID, f as RIVUS_MEMORY_TOOL_VERSION, h as restrictMemoryScopesForAudience, i as MEMORY_SCOPES, l as MemoryState, m as createRivusMemoryToolContract, n as AgentMemoryIdentity, o as MemoryInvocationAudience, p as createMemoryNamespace, r as AgentMemorySnapshot, s as MemoryRecord, t as AgentMemoryAuthority, u as RIVUS_MEMORY_TOOL_ID } from "./agent-memory.js";
 import { A as createRecoveryAction, C as ToolOperationReconciliation, D as createToolOperationLedger, E as ToolOperationState, O as InvalidRecoveryAction, S as ToolOperationLedger, T as ToolOperationRecord, _ as InvocationAuthorityRef, b as ToolOperationBinding, c as ToolApprovalRequest, d as ToolBrokerOptions, f as ToolExecutionRequest, g as InvocationAuthority, h as InvalidInvocationAuthority, k as RecoveryAction, l as ToolApprovalService, m as createToolBroker, o as AuthorizationPolicyProvider, p as ToolInvocationDenied, s as AuthorizationPolicyState, t as PiToolApprovalGateway, u as ToolBroker, v as createInvocationAuthority, w as ToolOperationReconciliationOutcome, x as ToolOperationInspectResult, y as ToolOperationBeginResult } from "./pi-tool-proxy.js";
 import { A as RivusToolRisk, C as RivusToolDescriptor, D as RivusToolGrantSet, E as RivusToolFactoryContext, O as RivusToolIdempotency, S as RivusSkillGrantSet, T as RivusToolExecutor, _ as RivusPluginCatalogSnapshot, a as RegisteredRivusPlugin, b as RivusResolvedToolDescriptor, c as ResolvedRivusAgentDefinition, d as RivusAutomationInput, f as RivusAutomationTemplate, g as RivusPluginCatalog, h as RivusPlugin, i as RegisteredRivusAutomation, j as requiresToolApproval, k as RivusToolInputRejected, l as RivusAgentDeployment, m as RivusHostToolDescriptor, n as RIVUS_PLUGIN_API_VERSION, o as RegisteredRivusSkill, p as RivusAutomationTickContext, r as RegisteredRivusAgentProfile, s as RegisteredRivusTool, t as InvalidRivusPlugin, u as RivusAgentProfile, v as RivusPluginManifest, w as RivusToolExecutionContext, x as RivusSkillDescriptor, y as RivusPluginRegistry } from "./rivus-plugin.js";
+import { $ as suspendBackgroundSession, A as BackgroundSessionCancellation, B as completeBackgroundSessionStep, C as BackgroundSessionDeliveryStore, D as BackgroundSessionRepositoryCorrupted, E as BackgroundSessionRepositoryConflict, F as BackgroundSessionState, G as isBackgroundSessionLeaseExpired, H as createBackgroundSession, I as BackgroundSessionTerminalResult, J as releaseBackgroundSessionLease, K as isBackgroundSessionTerminalPhase, L as BackgroundSessionTransitionDenied, M as BackgroundSessionLease, N as BackgroundSessionOrigin, O as createBackgroundSessionRepository, P as BackgroundSessionPhase, Q as resolveBackgroundSessionReconciliation, R as appendBackgroundSessionInput, S as BackgroundSessionDeliveryRecord, T as BackgroundSessionRepository, U as failBackgroundSessionStep, V as completeBackgroundSessionStop, W as isBackgroundSessionDue, X as requestBackgroundSessionStop, Y as renewBackgroundSessionLease, Z as requeueInterruptedBackgroundSessionStep, _ as createBackgroundSessionToolContracts, a as createBackgroundSessionService, b as narrowBackgroundSessionDefinition, c as terminalDeliveryId, d as BACKGROUND_SESSION_TOOL_IDS, f as BACKGROUND_SESSION_TOOL_PLUGIN_ID, g as createBackgroundSessionStepSourceMessageId, h as createBackgroundSessionKey, i as BackgroundSessionSummary, j as BackgroundSessionId, k as BackgroundSessionAuthority, l as BACKGROUND_SESSION_SESSION_KEY_PREFIX, m as backgroundSessionToolIds, n as BackgroundSessionDetail, o as progressDeliveryId, p as BACKGROUND_SESSION_TOOL_VERSION, q as parkBackgroundSessionForReconciliation, r as BackgroundSessionService, s as sessionIdFromSessionKey, t as BackgroundSessionCallerDenied, u as BACKGROUND_SESSION_START_TOOL_ID, v as extendBackgroundSessionDefinition, w as createBackgroundSessionDeliveryStore, x as BackgroundSessionDeliveryConflict, y as isBackgroundSessionToolId, z as claimBackgroundSession } from "./background-session-service.js";
 import { a as assertRivusPluginConforms, i as RivusPluginLifecycleProbe, n as RivusPluginConformanceInput, o as createFakeRivusPlugin, r as RivusPluginConformanceReport, t as RivusPluginConformanceError } from "./rivus-plugin-testkit.js";
 import { Effect, Stream } from "effect";
 import { Tracer } from "@opentelemetry/api";
@@ -1780,206 +1781,6 @@ interface ScheduledAutomation {
 }
 declare function createScheduledAutomation(options: ScheduledAutomationOptions): ScheduledAutomation;
 //#endregion
-//#region src/domain/background-agent-session.d.ts
-type BackgroundSessionId = string;
-type BackgroundSessionPhase = "queued" | "running" | "waiting" | "input-required" | "stopping" | "stopped" | "completed" | "failed" | "reconciliation-required";
-declare function isBackgroundSessionTerminalPhase(phase: BackgroundSessionPhase): boolean;
-interface BackgroundSessionLease {
-  readonly owner: string;
-  readonly epoch: number;
-  readonly expiresAt: string;
-}
-interface BackgroundSessionOrigin {
-  readonly endpointId: string;
-  readonly tenantKey: string;
-  readonly conversationId?: string;
-  readonly allowedActorOpenIds: ReadonlyArray<string>;
-  readonly memory?: AgentMemoryIdentity;
-}
-interface BackgroundSessionAuthority {
-  readonly agentId: string;
-  readonly profileRevision: string;
-  readonly toolGrantRevision: string;
-  readonly policyEpoch: number;
-  readonly memoryScopes: ReadonlyArray<MemoryScope>;
-  readonly projectSpaceId?: string;
-  readonly sessionKey: string;
-}
-interface BackgroundSessionTerminalResult {
-  readonly text: string;
-  readonly stepRunId: string;
-  readonly completedAt: string;
-}
-interface BackgroundSessionCancellation {
-  readonly reason: string;
-  readonly requestedAt: string;
-}
-interface BackgroundSessionState {
-  readonly sessionId: BackgroundSessionId;
-  readonly displayName: string;
-  readonly phase: BackgroundSessionPhase;
-  readonly revision: number;
-  readonly parentRunId: string;
-  readonly sourceMessageId: string;
-  readonly origin: BackgroundSessionOrigin;
-  readonly authority: BackgroundSessionAuthority;
-  readonly prompt: string;
-  readonly stepCount: number;
-  readonly wakeCount: number;
-  readonly currentStepRunId?: string;
-  readonly lastWakeText?: string;
-  readonly pendingInput: ReadonlyArray<string>;
-  readonly wakeAt?: string;
-  readonly lease?: BackgroundSessionLease;
-  readonly cancellation?: BackgroundSessionCancellation;
-  readonly consecutiveFailures: number;
-  readonly result?: BackgroundSessionTerminalResult;
-  readonly errorMessage?: string;
-  readonly reconciliationNote?: string;
-  readonly createdAt: string;
-  readonly updatedAt: string;
-}
-declare class BackgroundSessionTransitionDenied extends Error {
-  readonly sessionId: BackgroundSessionId;
-  readonly name = "BackgroundSessionTransitionDenied";
-  constructor(sessionId: BackgroundSessionId, message: string);
-}
-interface CreateBackgroundSessionInput {
-  readonly sessionId: BackgroundSessionId;
-  readonly displayName: string;
-  readonly prompt: string;
-  readonly parentRunId: string;
-  readonly sourceMessageId: string;
-  readonly origin: BackgroundSessionOrigin;
-  readonly authority: BackgroundSessionAuthority;
-  readonly now: string;
-}
-declare function createBackgroundSession(input: CreateBackgroundSessionInput): BackgroundSessionState;
-interface ClaimBackgroundSessionInput {
-  readonly lease: BackgroundSessionLease;
-  readonly stepRunId: string;
-  readonly wakeText: string;
-  readonly now: string;
-}
-declare function claimBackgroundSession(state: BackgroundSessionState, input: ClaimBackgroundSessionInput): BackgroundSessionState;
-declare function renewBackgroundSessionLease(state: BackgroundSessionState, lease: BackgroundSessionLease): BackgroundSessionState;
-declare function releaseBackgroundSessionLease(state: BackgroundSessionState): BackgroundSessionState;
-interface SuspendBackgroundSessionInput {
-  readonly wakeAt?: string;
-  readonly reason?: string;
-  readonly now: string;
-}
-declare function suspendBackgroundSession(state: BackgroundSessionState, input: SuspendBackgroundSessionInput): BackgroundSessionState;
-declare function completeBackgroundSessionStep(state: BackgroundSessionState, input: {
-  readonly text: string;
-  readonly stepRunId: string;
-  readonly now: string;
-}): BackgroundSessionState;
-declare function failBackgroundSessionStep(state: BackgroundSessionState, input: {
-  readonly errorMessage: string;
-  readonly now: string;
-  readonly retryable: boolean;
-  readonly wakeAt?: string;
-}): BackgroundSessionState;
-declare function requestBackgroundSessionStop(state: BackgroundSessionState, input: {
-  readonly reason: string;
-  readonly now: string;
-}): BackgroundSessionState;
-declare function completeBackgroundSessionStop(state: BackgroundSessionState, input: {
-  readonly now: string;
-}): BackgroundSessionState;
-declare function parkBackgroundSessionForReconciliation(state: BackgroundSessionState, input: {
-  readonly reason: string;
-  readonly now: string;
-}): BackgroundSessionState;
-declare function resolveBackgroundSessionReconciliation(state: BackgroundSessionState, input: {
-  readonly outcome: "continue" | "stop";
-  readonly now: string;
-}): BackgroundSessionState;
-declare function appendBackgroundSessionInput(state: BackgroundSessionState, input: {
-  readonly message: string;
-  readonly now: string;
-}): BackgroundSessionState;
-declare function requeueInterruptedBackgroundSessionStep(state: BackgroundSessionState, input: {
-  readonly wakeText: string;
-  readonly now: string;
-}): BackgroundSessionState;
-declare function isBackgroundSessionLeaseExpired(state: BackgroundSessionState, now: string): boolean;
-declare function isBackgroundSessionDue(state: BackgroundSessionState, now: string): boolean;
-//#endregion
-//#region src/application/background-session/background-session-repository.d.ts
-interface BackgroundSessionLeasePrecondition {
-  readonly kind: "absent";
-}
-interface BackgroundSessionLeaseRequirement {
-  readonly kind: "held";
-  readonly owner: string;
-  readonly epoch: number;
-}
-interface BackgroundSessionLeaseStaleOrAbsent {
-  readonly kind: "absent-or-stale";
-}
-interface BackgroundSessionRepository {
-  create(state: BackgroundSessionState): Promise<BackgroundSessionState>;
-  get(sessionId: string): Promise<BackgroundSessionState | undefined>;
-  list(options?: {
-    readonly phase?: BackgroundSessionPhase;
-    readonly limit?: number;
-  }): Promise<ReadonlyArray<BackgroundSessionState>>;
-  update(input: {
-    readonly sessionId: string;
-    readonly expectedRevision: number;
-    readonly expectedLease?: BackgroundSessionLeasePrecondition | BackgroundSessionLeaseRequirement | BackgroundSessionLeaseStaleOrAbsent;
-    readonly now?: string;
-    readonly build: (state: BackgroundSessionState) => BackgroundSessionState;
-  }): Promise<BackgroundSessionState | undefined>;
-}
-declare class BackgroundSessionRepositoryConflict extends Error {
-  readonly name = "BackgroundSessionRepositoryConflict";
-  constructor(sessionId: string, message: string);
-}
-declare class BackgroundSessionRepositoryCorrupted extends Error {
-  readonly name = "BackgroundSessionRepositoryCorrupted";
-}
-interface CreateBackgroundSessionRepositoryOptions {
-  readonly initial?: ReadonlyArray<BackgroundSessionState>;
-  readonly persist?: (state: BackgroundSessionState) => Promise<void>;
-}
-declare function createBackgroundSessionRepository(options?: CreateBackgroundSessionRepositoryOptions): BackgroundSessionRepository;
-//#endregion
-//#region src/application/background-session/background-session-delivery-store.d.ts
-type BackgroundSessionDeliveryKind = "progress" | "final" | "stopped" | "failed" | "reconciliation";
-interface BackgroundSessionDeliveryRecord {
-  readonly deliveryId: string;
-  readonly sessionId: string;
-  readonly kind: BackgroundSessionDeliveryKind;
-  readonly text: string;
-  readonly state: "pending" | "delivered";
-  readonly revision: number;
-  readonly providerMessageId?: string;
-  readonly createdAt: string;
-}
-interface BackgroundSessionDeliveryStore {
-  enqueue(input: {
-    readonly deliveryId: string;
-    readonly sessionId: string;
-    readonly kind: BackgroundSessionDeliveryKind;
-    readonly text: string;
-    readonly createdAt: string;
-  }): Promise<BackgroundSessionDeliveryRecord>;
-  pending(): Promise<ReadonlyArray<BackgroundSessionDeliveryRecord>>;
-  markDelivered(deliveryId: string, providerMessageId: string): Promise<BackgroundSessionDeliveryRecord | undefined>;
-}
-declare class BackgroundSessionDeliveryConflict extends Error {
-  readonly name = "BackgroundSessionDeliveryConflict";
-  constructor(deliveryId: string, message: string);
-}
-interface CreateBackgroundSessionDeliveryStoreOptions {
-  readonly initial?: ReadonlyArray<BackgroundSessionDeliveryRecord>;
-  readonly persist?: (record: BackgroundSessionDeliveryRecord) => Promise<void>;
-}
-declare function createBackgroundSessionDeliveryStore(options?: CreateBackgroundSessionDeliveryStoreOptions): BackgroundSessionDeliveryStore;
-//#endregion
 //#region src/application/background-session/background-session-supervisor.d.ts
 interface BackgroundSessionLimits {
   readonly intervalMs: number;
@@ -3050,93 +2851,6 @@ declare class AgentMemoryError extends Error {
 }
 declare function createAgentMemoryService(options?: AgentMemoryServiceOptions): AgentMemoryService;
 //#endregion
-//#region src/application/background-session/background-session-authority.d.ts
-declare const BACKGROUND_SESSION_TOOL_IDS: readonly ["background.start", "background.wait", "background.list", "background.status", "background.send", "background.stop"];
-declare const BACKGROUND_SESSION_START_TOOL_ID = "background.start";
-declare const BACKGROUND_SESSION_TOOL_PLUGIN_ID = "rivus-core";
-declare const BACKGROUND_SESSION_TOOL_VERSION = "1.0.0";
-declare const BACKGROUND_SESSION_SESSION_KEY_PREFIX = "background";
-declare function createBackgroundSessionKey(sessionId: string): string;
-declare function createBackgroundSessionStepSourceMessageId(sessionId: string, stepCount: number): string;
-interface BackgroundSessionToolContract extends RivusResolvedToolDescriptor {}
-declare function createBackgroundSessionToolContracts(): ReadonlyArray<BackgroundSessionToolContract>;
-declare function backgroundSessionToolIds(): ReadonlyArray<string>;
-declare function isBackgroundSessionToolId(toolId: string): boolean;
-declare function extendBackgroundSessionDefinition(definition: ResolvedRivusAgentDefinition): ResolvedRivusAgentDefinition;
-declare function narrowBackgroundSessionDefinition(definition: ResolvedRivusAgentDefinition): ResolvedRivusAgentDefinition;
-//#endregion
-//#region src/application/background-session/background-session-service.d.ts
-interface BackgroundSessionSummary {
-  readonly sessionId: string;
-  readonly displayName: string;
-  readonly phase: BackgroundSessionPhase;
-  readonly stepCount: number;
-  readonly wakeAt?: string;
-  readonly createdAt: string;
-  readonly updatedAt: string;
-}
-interface BackgroundSessionDetail extends BackgroundSessionSummary {
-  readonly parentRunId: string;
-  readonly pendingInput: ReadonlyArray<string>;
-  readonly result?: BackgroundSessionState["result"];
-  readonly errorMessage?: string;
-  readonly cancellationReason?: string;
-  readonly reconciliationNote?: string;
-}
-declare class BackgroundSessionCallerDenied extends Error {
-  readonly name = "BackgroundSessionCallerDenied";
-  constructor(message: string);
-}
-interface BackgroundSessionServiceOptions {
-  readonly clock: {
-    now(): string;
-  };
-  readonly deliveries: BackgroundSessionDeliveryStore;
-  readonly repository: BackgroundSessionRepository;
-}
-interface BackgroundSessionService {
-  list(input: {
-    readonly context: RivusToolExecutionContext;
-    readonly limit?: number;
-    readonly phase?: BackgroundSessionPhase;
-  }): Promise<ReadonlyArray<BackgroundSessionSummary>>;
-  resolveReconciliation(input: {
-    readonly outcome: "continue" | "stop";
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionSummary>;
-  send(input: {
-    readonly context: RivusToolExecutionContext;
-    readonly message: string;
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionSummary>;
-  start(input: {
-    readonly authority: BackgroundSessionAuthority;
-    readonly context: RivusToolExecutionContext;
-    readonly displayName?: string;
-    readonly prompt: string;
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionSummary>;
-  status(input: {
-    readonly context: RivusToolExecutionContext;
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionDetail>;
-  stop(input: {
-    readonly context: RivusToolExecutionContext;
-    readonly reason?: string;
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionSummary>;
-  wait(input: {
-    readonly context: RivusToolExecutionContext;
-    readonly delayMs?: number;
-    readonly reason?: string;
-    readonly until?: string;
-  }): Promise<BackgroundSessionSummary>;
-}
-declare function createBackgroundSessionService(options: BackgroundSessionServiceOptions): BackgroundSessionService;
-declare function sessionIdFromSessionKey(sessionKey: string): string | undefined;
-declare function terminalDeliveryId(sessionId: string, kind: BackgroundSessionDeliveryKind): string;
-declare function progressDeliveryId(sessionId: string, stepCount: number): string;
-//#endregion
 //#region src/application/background-session/background-session-tools.d.ts
 interface CreateBackgroundSessionHostToolsOptions {
   readonly createSessionId: () => string;

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 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 { a as BACKGROUND_SESSION_START_TOOL_ID, c as BACKGROUND_SESSION_TOOL_VERSION, d as createBackgroundSessionStepSourceMessageId, f as createBackgroundSessionToolContracts, h as narrowBackgroundSessionDefinition, i as BACKGROUND_SESSION_SESSION_KEY_PREFIX, l as backgroundSessionToolIds, m as isBackgroundSessionToolId, n as resolveRivusAgentDefinition, o as BACKGROUND_SESSION_TOOL_IDS, p as extendBackgroundSessionDefinition, s as BACKGROUND_SESSION_TOOL_PLUGIN_ID, t as createRivusPluginCatalog, u as createBackgroundSessionKey } from "./rivus-plugin-registry.js";
+import { a as BACKGROUND_SESSION_TOOL_VERSION, c as createBackgroundSessionStepSourceMessageId, d as isBackgroundSessionToolId, f as narrowBackgroundSessionDefinition, i as BACKGROUND_SESSION_TOOL_PLUGIN_ID, l as createBackgroundSessionToolContracts, n as BACKGROUND_SESSION_START_TOOL_ID, o as backgroundSessionToolIds, r as BACKGROUND_SESSION_TOOL_IDS, s as createBackgroundSessionKey, t as BACKGROUND_SESSION_SESSION_KEY_PREFIX, u as extendBackgroundSessionDefinition } from "./background-session-authority.js";
+import { n as resolveRivusAgentDefinition, t as createRivusPluginCatalog } from "./rivus-plugin-registry.js";
 import { $ as loadRivusDeployment, A as DEFAULT_BACKGROUND_SESSION_LIFETIME_MS, B as acceptsCardPresentationProgress, C as loadRivusDaemonConfig, D as loadRivusDeploymentManifest, E as RivusDeploymentManifestError, F as DEFAULT_BACKGROUND_SESSION_SUPERVISOR_INTERVAL_MS, G as createCardPresentationChain, H as beginCardPresentationHandoff, I as resolveBackgroundSessionSupervisorIntervalMs, J as markCardPresentationTerminal, K as failCardPresentationHandoff, L as DEFAULT_CARD_STREAM_LEASE_MS, M as DEFAULT_BACKGROUND_SESSION_MAX_CONSECUTIVE_FAILURES, N as DEFAULT_BACKGROUND_SESSION_RETRY_BACKOFF_MS, O as DEFAULT_BACKGROUND_SESSION_LEASE_MS, P as DEFAULT_BACKGROUND_SESSION_STEP_TIMEOUT_MS, Q as RivusPluginLoadError, R as createFeishuCardRollover, S as RivusDaemonConfigError, U as compensateCardPresentationHandoff, V as activeCardPresentation, W as completeCardPresentationHandoff, X as resolveFeishuEndpointCredentials, Y as FeishuEndpointCredentialError, _ as createStableId, a as InvalidRivusProjectSpace, b as createRivusEnvFromOpenClawConfig, c as RivusDeploymentReadinessError, d as createRivusAgentHost, et as validateRivusDeploymentManifest, f as AgentInstanceBusy, g as createAgentInstanceRegistry, h as AgentInstanceConflict, i as resolveRivusProjectSpace, j as DEFAULT_BACKGROUND_SESSION_MAX_CONCURRENT_SESSIONS, k as DEFAULT_BACKGROUND_SESSION_LEASE_RENEWAL_INTERVAL_MS, l as createRivusDeploymentDaemon, m as createAgentRuntimePool, n as createRivusDeploymentCliProcess, o as RivusDeploymentAutomationReadinessError, p as AgentRuntimeDisposed, q as isCardPresentationHandoffDue, 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 CardPresentationTransitionDenied } 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 { a as readBackgroundSessionWaitInput, i as readBackgroundSessionString, n as readBackgroundSessionObject, r as readBackgroundSessionPhase, t as readBackgroundSessionInteger } from "./background-session-input.js";
 import { n as assertRivusPluginConforms, r as createFakeRivusPlugin, t as RivusPluginConformanceError } from "./rivus-plugin-testkit.js";
 import { Cause, Deferred, Effect, Either, Exit, Fiber, Option, Stream } from "effect";
 import { createHash, randomUUID } from "node:crypto";
@@ -6955,16 +6957,12 @@ function createExecutor(contract, options) {
 			});
 		};
 		case "background.wait": return (input, context) => {
-			const { delayMs, reason, until } = readObject(input, [
-				"delayMs",
-				"reason",
-				"until"
-			]);
+			const { delayMs, reason, until } = readWaitInput(input);
 			return options.service.wait({
 				context,
-				...delayMs === void 0 ? {} : { delayMs: readInteger(delayMs, "delayMs") },
-				...reason === void 0 ? {} : { reason: readString(reason, "reason") },
-				...until === void 0 ? {} : { until: readString(until, "until") }
+				...delayMs === void 0 ? {} : { delayMs },
+				...reason === void 0 ? {} : { reason },
+				...until === void 0 ? {} : { until }
 			});
 		};
 		case "background.list": return async (input, context) => {
@@ -7048,39 +7046,24 @@ function buildAuthority(definition, context, sessionId) {
 	});
 }
 function readObject(input, allowed) {
-	if (input === null || typeof input !== "object" || Array.isArray(input)) throw new BackgroundSessionCallerDenied("background tool input must be an object");
-	const record = input;
-	const unknown = Object.keys(record).find((key) => !allowed.includes(key));
-	if (unknown) throw new BackgroundSessionCallerDenied(`field is not allowed: ${unknown}`);
-	return record;
+	return readBackgroundSessionObject(input, allowed, (message) => new BackgroundSessionCallerDenied(message));
 }
 function readString(value, name) {
-	if (typeof value !== "string" || value.trim() === "") throw new BackgroundSessionCallerDenied(`${name} must be a non-empty string`);
-	return value;
+	return readBackgroundSessionString(value, name, (message) => new BackgroundSessionCallerDenied(message));
 }
 function readInteger(value, name) {
-	if (!Number.isSafeInteger(value) || value < 1) throw new BackgroundSessionCallerDenied(`${name} must be a positive integer`);
-	return value;
+	return readBackgroundSessionInteger(value, name, (message) => new BackgroundSessionCallerDenied(message));
 }
 function readPhase(value) {
-	const phases = [
-		"queued",
-		"running",
-		"waiting",
-		"input-required",
-		"stopping",
-		"stopped",
-		"completed",
-		"failed",
-		"reconciliation-required"
-	];
-	if (typeof value !== "string" || !phases.includes(value)) throw new BackgroundSessionCallerDenied(`phase must be one of ${phases.join(", ")}`);
-	return value;
+	return readBackgroundSessionPhase(value, (message) => new BackgroundSessionCallerDenied(message));
 }
 function readReplayedSessionId(value) {
 	if (value === null || typeof value !== "object" || Array.isArray(value)) throw new BackgroundSessionCallerDenied("replayed background tool result is invalid");
 	return readString(value.sessionId, "sessionId");
 }
+function readWaitInput(input) {
+	return readBackgroundSessionWaitInput(input, (message) => new BackgroundSessionCallerDenied(message));
+}
 async function asToolInputRejection$1(operation) {
 	try {
 		return await operation();

package/dist/mcp.d.ts

@@ -0,0 +1,86 @@
+import { k as BackgroundSessionAuthority, r as BackgroundSessionService } from "./background-session-service.js";
+import { Readable, Writable } from "node:stream";
+
+//#region src/application/background-session/background-session-control.d.ts
+type BackgroundSessionControlCommand = "start" | "wait" | "list" | "status" | "send" | "stop";
+interface BackgroundSessionControlOrigin {
+  readonly allowedActorOpenIds: ReadonlyArray<string>;
+  readonly conversationId?: string;
+  readonly endpointId: string;
+  readonly tenantKey: string;
+}
+interface BackgroundSessionControlContext {
+  readonly agentId: string;
+  readonly authority: BackgroundSessionAuthority;
+  readonly origin: BackgroundSessionControlOrigin;
+  readonly policyEpoch: number;
+  readonly runId: string;
+  readonly sessionKey: string;
+  readonly sourceMessageId: string;
+}
+interface BackgroundSessionControl {
+  handle(command: BackgroundSessionControlCommand, context: BackgroundSessionControlContext, input: unknown): Promise<unknown>;
+}
+declare function createBackgroundSessionControl(options: {
+  readonly service: BackgroundSessionService;
+}): BackgroundSessionControl;
+declare class BackgroundSessionControlError extends Error {
+  readonly name = "BackgroundSessionControlError";
+}
+declare function toControlContext(input: {
+  readonly agentId: string;
+  readonly authority: BackgroundSessionAuthority;
+  readonly origin: BackgroundSessionControlOrigin;
+  readonly policyEpoch: number;
+  readonly sessionKey: string;
+  readonly sourceMessageId?: string;
+}): BackgroundSessionControlContext;
+//#endregion
+//#region src/infrastructure/mcp/background-session-mcp-server.d.ts
+declare const BACKGROUND_SESSION_MCP_SERVER_NAME = "rivus-background-sessions";
+declare const BACKGROUND_SESSION_MCP_SERVER_VERSION = "1.0.0";
+interface BackgroundSessionMcpServerOptions {
+  readonly controlContext: BackgroundSessionControlContext;
+  readonly controlUrl: string;
+  readonly controlToken: string;
+  readonly enabledTools?: ReadonlyArray<BackgroundSessionControlCommand>;
+  readonly fetch?: typeof fetch;
+  readonly input?: Readable;
+  readonly output?: Writable;
+  readonly serverName?: string;
+  readonly serverVersion?: string;
+}
+interface BackgroundSessionMcpServer {
+  run(): Promise<void>;
+}
+declare class BackgroundSessionMcpError extends Error {
+  readonly name = "BackgroundSessionMcpError";
+}
+declare function createBackgroundSessionMcpServer(options: BackgroundSessionMcpServerOptions): BackgroundSessionMcpServer;
+interface RunBackgroundSessionMcpServerEnv {
+  readonly fetch?: typeof fetch;
+  readonly input?: Readable;
+  readonly output?: Writable;
+}
+declare function runBackgroundSessionMcpServer(options?: RunBackgroundSessionMcpServerEnv): Promise<void>;
+//#endregion
+//#region src/infrastructure/http/background-session-control-http-server.d.ts
+interface BackgroundSessionControlHttpServerOptions {
+  readonly control: BackgroundSessionControl;
+  readonly host?: string;
+  readonly port: number;
+  readonly token: string;
+}
+interface BackgroundSessionControlHttpServer {
+  port(): number;
+  close(): Promise<void>;
+  start(): Promise<void>;
+}
+declare class BackgroundSessionControlHttpError extends Error {
+  readonly statusCode: number;
+  readonly name = "BackgroundSessionControlHttpError";
+  constructor(statusCode: number, message: string);
+}
+declare function createBackgroundSessionControlHttpServer(options: BackgroundSessionControlHttpServerOptions): BackgroundSessionControlHttpServer;
+//#endregion
+export { BACKGROUND_SESSION_MCP_SERVER_NAME, BACKGROUND_SESSION_MCP_SERVER_VERSION, type BackgroundSessionControl, type BackgroundSessionControlCommand, type BackgroundSessionControlContext, BackgroundSessionControlError, BackgroundSessionControlHttpError, type BackgroundSessionControlHttpServer, type BackgroundSessionControlHttpServerOptions, type BackgroundSessionControlOrigin, BackgroundSessionMcpError, type BackgroundSessionMcpServer, type BackgroundSessionMcpServerOptions, createBackgroundSessionControl, createBackgroundSessionControlHttpServer, createBackgroundSessionMcpServer, runBackgroundSessionMcpServer, toControlContext };