@rivus/agent 0.14.3 → 0.15.0

package/dist/chunks/api3.d.ts

@@ -1,402 +0,0 @@
-import { Effect } from "effect";
-
-//#region src/modules/background-session/domain/session/background-session-model.d.ts
-type BackgroundSessionMemoryScope = "conversation" | "agent-private" | "project" | "shared-user-profile";
-interface BackgroundSessionMemoryIdentity {
-  readonly audience: "group" | "private";
-  readonly conversationId?: string;
-  readonly projectId?: string;
-  readonly subjectId: string;
-  readonly tenantId: string;
-}
-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?: BackgroundSessionMemoryIdentity;
-}
-interface BackgroundSessionAuthority {
-  readonly agentId: string;
-  readonly profileRevision: string;
-  readonly toolGrantRevision: string;
-  readonly policyEpoch: number;
-  readonly memoryScopes: ReadonlyArray<BackgroundSessionMemoryScope>;
-  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);
-}
-//#endregion
-//#region src/modules/background-session/application/authority/background-session-identity.d.ts
-declare const BACKGROUND_SESSION_SESSION_KEY_PREFIX = "background";
-declare function createBackgroundSessionKey(sessionId: string): string;
-declare function createBackgroundSessionStepSourceMessageId(sessionId: string, stepCount: number): string;
-//#endregion
-//#region src/modules/background-session/application/authority/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";
-interface BackgroundSessionToolContract {
-  readonly description: string;
-  readonly digest: string;
-  readonly id: string;
-  readonly idempotency: "none" | "supported" | "required";
-  readonly inputSchema: unknown;
-  readonly pluginId: string;
-  readonly risk: "observe" | "mutate" | "irreversible" | "host-control";
-  readonly version: string;
-}
-interface BackgroundSessionToolGrantSet {
-  readonly revision: string;
-  readonly toolIds: ReadonlyArray<string>;
-}
-interface BackgroundSessionAgentDefinition {
-  readonly agentId: string;
-  readonly endpointIds: ReadonlyArray<string>;
-  readonly memory: {
-    readonly scopes: ReadonlyArray<BackgroundSessionMemoryScope>;
-  };
-  readonly model: Readonly<Record<string, unknown>>;
-  readonly pluginId: string;
-  readonly profileId: string;
-  readonly profileRevision: string;
-  readonly projectSpaceId?: string;
-  readonly projectSpaceRevision?: string;
-  readonly skillGrantSet: {
-    readonly revision: string;
-    readonly skillIds: ReadonlyArray<string>;
-  };
-  readonly skills: ReadonlyArray<unknown>;
-  readonly systemPrompt: string;
-  readonly tools: ReadonlyArray<BackgroundSessionToolContract>;
-  readonly toolGrantSet: BackgroundSessionToolGrantSet;
-}
-type TransformedBackgroundSessionDefinition<T extends BackgroundSessionAgentDefinition> = Omit<T, "toolGrantSet" | "tools"> & {
-  readonly toolGrantSet: BackgroundSessionToolGrantSet;
-  readonly tools: ReadonlyArray<BackgroundSessionToolContract>;
-};
-declare function createBackgroundSessionToolContracts(): ReadonlyArray<BackgroundSessionToolContract>;
-declare function backgroundSessionToolIds(): ReadonlyArray<string>;
-declare function isBackgroundSessionToolId(toolId: string): boolean;
-declare function extendBackgroundSessionDefinition<T extends BackgroundSessionAgentDefinition>(definition: T): TransformedBackgroundSessionDefinition<T>;
-declare function narrowBackgroundSessionDefinition<T extends BackgroundSessionAgentDefinition>(definition: T): TransformedBackgroundSessionDefinition<T>;
-//#endregion
-//#region src/modules/background-session/application/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);
-}
-//#endregion
-//#region src/modules/background-session/application/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";
-}
-//#endregion
-//#region src/modules/background-session/application/session/background-session-service.d.ts
-interface BackgroundSessionExecutionOrigin {
-  readonly allowedActorOpenIds: ReadonlyArray<string>;
-  readonly conversationId?: string;
-  readonly endpointId: string;
-  readonly tenantKey: string;
-}
-interface BackgroundSessionExecutionContext {
-  readonly agentId: string;
-  readonly callId: string;
-  readonly instanceId: string;
-  readonly memory?: BackgroundSessionMemoryIdentity & {
-    readonly scopes: ReadonlyArray<BackgroundSessionMemoryScope>;
-  };
-  readonly operationId?: string;
-  readonly origin?: BackgroundSessionExecutionOrigin;
-  readonly policyEpoch: number;
-  readonly runId: string;
-  readonly sessionKey: string;
-  readonly sourceMessageId?: string;
-  readonly toolId: string;
-  readonly toolVersion: string;
-}
-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: BackgroundSessionExecutionContext;
-    readonly limit?: number;
-    readonly phase?: BackgroundSessionPhase;
-  }): Promise<ReadonlyArray<BackgroundSessionSummary>>;
-  resolveReconciliation(input: {
-    readonly outcome: "continue" | "stop";
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionSummary>;
-  send(input: {
-    readonly context: BackgroundSessionExecutionContext;
-    readonly message: string;
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionSummary>;
-  start(input: {
-    readonly authority: BackgroundSessionAuthority;
-    readonly context: BackgroundSessionExecutionContext;
-    readonly displayName?: string;
-    readonly prompt: string;
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionSummary>;
-  status(input: {
-    readonly context: BackgroundSessionExecutionContext;
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionDetail>;
-  stop(input: {
-    readonly context: BackgroundSessionExecutionContext;
-    readonly reason?: string;
-    readonly sessionId: string;
-  }): Promise<BackgroundSessionSummary>;
-  wait(input: {
-    readonly context: BackgroundSessionExecutionContext;
-    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/modules/background-session/application/control/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/modules/background-session/application/supervision/background-session-config.d.ts
-declare const DEFAULT_BACKGROUND_SESSION_STEP_TIMEOUT_MS: number;
-declare const DEFAULT_BACKGROUND_SESSION_MAX_CONCURRENT_SESSIONS = 4;
-declare const DEFAULT_BACKGROUND_SESSION_LEASE_MS = 30000;
-declare const DEFAULT_BACKGROUND_SESSION_LEASE_RENEWAL_INTERVAL_MS = 10000;
-declare const DEFAULT_BACKGROUND_SESSION_MAX_CONSECUTIVE_FAILURES = 3;
-declare const DEFAULT_BACKGROUND_SESSION_RETRY_BACKOFF_MS = 30000;
-declare const DEFAULT_BACKGROUND_SESSION_LIFETIME_MS: number;
-declare const DEFAULT_BACKGROUND_SESSION_SUPERVISOR_INTERVAL_MS = 1000;
-declare function resolveBackgroundSessionSupervisorIntervalMs(leaseMs: number): number;
-//#endregion
-//#region src/modules/background-session/application/supervision/background-session-delivery-queue.d.ts
-type BackgroundSessionDeliveryKindForSupervisor = "progress" | "final" | "stopped" | "failed" | "reconciliation";
-type BackgroundSessionDeliverySink = (delivery: {
-  readonly deliveryId: string;
-  readonly kind: BackgroundSessionDeliveryKindForSupervisor;
-  readonly sessionId: string;
-  readonly text: string;
-}) => Promise<{
-  readonly providerMessageId: string;
-}>;
-//#endregion
-//#region src/modules/background-session/application/supervision/background-session-supervisor.d.ts
-interface BackgroundSessionLimits {
-  readonly intervalMs: number;
-  readonly leaseMs: number;
-  readonly leaseRenewalIntervalMs: number;
-  readonly maxConcurrentSessions: number;
-  readonly maxConsecutiveFailures: number;
-  readonly retryBackoffMs: number;
-  readonly sessionLifetimeMs: number;
-}
-interface BackgroundSessionStepResult {
-  readonly finalText: string;
-  readonly runId: string;
-}
-interface BackgroundSessionSupervisorOptions {
-  readonly clock: {
-    now(): string;
-  };
-  readonly config: BackgroundSessionLimits;
-  readonly deliveries: BackgroundSessionDeliveryStore;
-  readonly deliver: BackgroundSessionDeliverySink;
-  readonly onError?: (error: unknown) => void;
-  readonly repository: BackgroundSessionRepository;
-  readonly runStep: (input: {
-    readonly session: BackgroundSessionState;
-    readonly signal: AbortSignal;
-    readonly wakeText: string;
-  }) => Promise<BackgroundSessionStepResult>;
-  readonly sleep: (ms: number) => Effect.Effect<void>;
-}
-interface BackgroundSessionSupervisorStatus {
-  readonly capacity: number;
-  readonly counters: {
-    readonly completed: number;
-    readonly deliveriesDelivered: number;
-    readonly failed: number;
-    readonly started: number;
-    readonly staleLeaseEventsDropped: number;
-    readonly stopped: number;
-  };
-  readonly inFlightSteps: number;
-  readonly oldestDueAt?: string;
-  readonly owner: string;
-  readonly phaseCounts: Readonly<Record<BackgroundSessionPhase, number>>;
-  readonly reconciliationCount: number;
-  readonly repositoryHealthy: boolean;
-  readonly running: boolean;
-}
-interface BackgroundSessionSupervisor {
-  recover(): Effect.Effect<void>;
-  start(): Effect.Effect<void>;
-  status(): BackgroundSessionSupervisorStatus;
-  stop(): Effect.Effect<void>;
-  tick(): Effect.Effect<void>;
-}
-declare function createBackgroundSessionSupervisor(options: BackgroundSessionSupervisorOptions): BackgroundSessionSupervisor;
-//#endregion
-export { BackgroundSessionPhase as $, BackgroundSessionRepository as A, backgroundSessionToolIds as B, BackgroundSessionDetail as C, progressDeliveryId as D, createBackgroundSessionService as E, BackgroundSessionDeliveryStore as F, BACKGROUND_SESSION_SESSION_KEY_PREFIX as G, extendBackgroundSessionDefinition as H, BACKGROUND_SESSION_START_TOOL_ID as I, BackgroundSessionAuthority as J, createBackgroundSessionKey as K, BACKGROUND_SESSION_TOOL_IDS as L, BackgroundSessionRepositoryCorrupted as M, BackgroundSessionDeliveryConflict as N, sessionIdFromSessionKey as O, BackgroundSessionDeliveryRecord as P, BackgroundSessionOrigin as Q, BACKGROUND_SESSION_TOOL_PLUGIN_ID as R, BackgroundSessionCallerDenied as S, BackgroundSessionSummary as T, isBackgroundSessionToolId as U, createBackgroundSessionToolContracts as V, narrowBackgroundSessionDefinition as W, BackgroundSessionId as X, BackgroundSessionCancellation as Y, BackgroundSessionLease as Z, BackgroundSessionControlContext as _, createBackgroundSessionSupervisor as a, createBackgroundSessionControl as b, DEFAULT_BACKGROUND_SESSION_LIFETIME_MS as c, DEFAULT_BACKGROUND_SESSION_RETRY_BACKOFF_MS as d, BackgroundSessionState as et, DEFAULT_BACKGROUND_SESSION_STEP_TIMEOUT_MS as f, BackgroundSessionControlCommand as g, BackgroundSessionControl as h, BackgroundSessionSupervisorStatus as i, BackgroundSessionRepositoryConflict as j, terminalDeliveryId as k, DEFAULT_BACKGROUND_SESSION_MAX_CONCURRENT_SESSIONS as l, resolveBackgroundSessionSupervisorIntervalMs as m, BackgroundSessionSupervisor as n, BackgroundSessionTransitionDenied as nt, DEFAULT_BACKGROUND_SESSION_LEASE_MS as o, DEFAULT_BACKGROUND_SESSION_SUPERVISOR_INTERVAL_MS as p, createBackgroundSessionStepSourceMessageId as q, BackgroundSessionSupervisorOptions as r, isBackgroundSessionTerminalPhase as rt, DEFAULT_BACKGROUND_SESSION_LEASE_RENEWAL_INTERVAL_MS as s, BackgroundSessionLimits as t, BackgroundSessionTerminalResult as tt, DEFAULT_BACKGROUND_SESSION_MAX_CONSECUTIVE_FAILURES as u, BackgroundSessionControlError as v, BackgroundSessionService as w, toControlContext as x, BackgroundSessionControlOrigin as y, BACKGROUND_SESSION_TOOL_VERSION as z };

package/dist/chunks/module.js

@@ -1,267 +0,0 @@
-import { a as deepFreeze, c as validateRivusCatalogIdentifier, d as RIVUS_RUNTIME_TOOL_IDS, i as createRivusPluginCatalog, l as validateRivusMemoryScopes, o as uniqueRivusCatalogIds, p as InvalidRivusPlugin, s as uniqueRivusRuntimeToolIds } from "./api.js";
-import { t as createSha256Digest } from "./sha256-digest.js";
-import { q as createBackgroundSessionToolContracts } from "./api2.js";
-//#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";
-function createRivusMemoryToolContract(scopes) {
-	return Object.freeze({
-		description: "Search and read Memory inside Host-bound scopes; propose or request forgetting only in writable private scopes.",
-		digest: "sha256:rivus-memory-v3",
-		id: RIVUS_MEMORY_TOOL_ID,
-		idempotency: "required",
-		inputSchema: Object.freeze({
-			additionalProperties: false,
-			properties: {
-				command: {
-					description: "One of search, read, propose, or forget_request.",
-					enum: [
-						"search",
-						"read",
-						"propose",
-						"forget_request"
-					],
-					type: "string"
-				},
-				id: {
-					description: "Required for read and forget_request.",
-					minLength: 1,
-					type: "string"
-				},
-				input: {
-					additionalProperties: false,
-					description: "Required for propose.",
-					properties: { content: {
-						minLength: 1,
-						type: "string"
-					} },
-					required: ["content"],
-					type: "object"
-				},
-				query: {
-					additionalProperties: false,
-					description: "Required for search.",
-					properties: { query: { type: "string" } },
-					required: ["query"],
-					type: "object"
-				},
-				reason: {
-					description: "Optional reason for forget_request.",
-					type: "string"
-				},
-				...scopes.length === 0 ? {} : { scope: {
-					description: "Optional Host-granted scope for search or propose. Confirmed Project and Shared User Profile Memory are read-only to the model.",
-					enum: [...scopes],
-					type: "string"
-				} }
-			},
-			required: ["command"],
-			type: "object"
-		}),
-		risk: "mutate",
-		version: RIVUS_MEMORY_TOOL_VERSION
-	});
-}
-//#endregion
-//#region src/adapters/agent/catalog/rivus-host-tool-descriptor-provider.ts
-function createRivusHostToolDescriptorProvider(options) {
-	return Object.freeze({ provide: ({ deployment, memoryScopes }) => {
-		const contributions = [];
-		if (deployment.memory?.tool === true) contributions.push({
-			scope: "profile",
-			tool: Object.freeze({
-				...createRivusMemoryToolContract(memoryScopes),
-				pluginId: RIVUS_MEMORY_TOOL_PLUGIN_ID
-			})
-		});
-		if (options.backgroundSessions) contributions.push(...createBackgroundSessionToolContracts().map(toRuntimeContribution));
-		return Object.freeze(contributions);
-	} });
-}
-function toRuntimeContribution(tool) {
-	return Object.freeze({
-		scope: "runtime",
-		tool: Object.freeze({ ...tool })
-	});
-}
-//#endregion
-//#region src/modules/agent-catalog/application/resolution/rivus-agent-definition-resolver.ts
-function createRivusAgentDefinitionResolver(providers) {
-	return Object.freeze({ resolve: (catalog, deployment) => resolveRivusAgentDefinition(catalog, deployment, providers) });
-}
-function resolveRivusAgentDefinition(catalog, deployment, providers) {
-	const snapshot = catalog.snapshot();
-	const plugin = snapshot.plugins.find((candidate) => candidate.id === deployment.pluginId);
-	if (!plugin) throw new InvalidRivusPlugin(`unknown deployment plugin: ${deployment.pluginId}`);
-	const profile = snapshot.profiles.find((candidate) => candidate.id === deployment.profileId && candidate.pluginId === deployment.pluginId);
-	if (!profile) throw new InvalidRivusPlugin(`unknown profile ${deployment.profileId} for plugin ${deployment.pluginId}`);
-	const memoryScopes = resolveMemoryScopes(profile, deployment);
-	const runtimeToolIds = resolveRuntimeTools(profile, deployment);
-	const memoryTool = deployment.memory?.tool === true;
-	if (memoryTool && memoryScopes.length === 0) throw new InvalidRivusPlugin(`deployment ${deployment.agentId} Memory Tool requires at least one granted scope`);
-	const contributions = providers.flatMap((provider) => provider.provide({
-		deployment,
-		memoryScopes,
-		profile
-	}));
-	const profileContributions = contributions.filter(({ scope }) => scope === "profile");
-	const runtimeContributions = contributions.filter(({ scope }) => scope === "runtime");
-	validateToolContributions(snapshot.tools, contributions);
-	if (memoryTool && !profileContributions.some(({ tool }) => tool.id === "memory")) throw new InvalidRivusPlugin(`deployment ${deployment.agentId} Memory Tool descriptor is unavailable`);
-	const pluginTools = resolvePluginTools(snapshot.tools, profile, deployment);
-	const profileToolsById = new Map(profileContributions.map(({ tool }) => [tool.id, deepFreeze({ ...tool })]));
-	const resolvedProfileToolIds = [...pluginTools.keys(), ...profileToolsById.keys()].sort();
-	const tools = resolvedProfileToolIds.map((id) => pluginTools.get(id) ?? profileToolsById.get(id));
-	const skills = resolveSkills(snapshot.skills, profile, deployment);
-	const skillIds = skills.map(({ id }) => id);
-	const profileRevision = digest({
-		memory: {
-			scopes: memoryScopes,
-			tool: memoryTool
-		},
-		model: profile.model,
-		plugin,
-		profileId: profile.id,
-		runtimeTools: runtimeToolIds,
-		skills: skills.map(({ content, digest: skillDigest, id, pluginId, title, version }) => ({
-			content,
-			digest: skillDigest,
-			id,
-			pluginId,
-			title,
-			version
-		})),
-		systemPrompt: profile.systemPrompt,
-		tools
-	});
-	const toolGrantSet = deepFreeze({
-		revision: digest({
-			profileRevision,
-			toolIds: resolvedProfileToolIds
-		}),
-		toolIds: resolvedProfileToolIds
-	});
-	const skillGrantSet = deepFreeze({
-		revision: digest({
-			profileRevision,
-			skillIds
-		}),
-		skillIds
-	});
-	const runtimeToolGrantSet = deepFreeze({
-		revision: digest({
-			profileRevision,
-			toolIds: runtimeToolIds
-		}),
-		toolIds: runtimeToolIds
-	});
-	return extendRuntimeTools(deepFreeze({
-		agentId: deployment.agentId,
-		endpointIds: [...deployment.endpointIds],
-		memory: {
-			scopes: memoryScopes,
-			tool: memoryTool
-		},
-		model: profile.model,
-		pluginId: deployment.pluginId,
-		profileId: deployment.profileId,
-		...deployment.projectSpaceId ? { projectSpaceId: deployment.projectSpaceId } : {},
-		profileRevision,
-		runtimeToolGrantSet,
-		skillGrantSet,
-		skills,
-		systemPrompt: profile.systemPrompt,
-		toolGrantSet,
-		tools
-	}), runtimeContributions);
-}
-function resolveRuntimeTools(profile, deployment) {
-	const profileToolIds = uniqueRivusRuntimeToolIds(profile.runtimeTools?.allow ?? [], `profile ${profile.id}`);
-	const requestedToolIds = uniqueRivusRuntimeToolIds(deployment.runtimeTools?.allow ?? [], `deployment ${deployment.agentId}`);
-	const profileToolIdSet = new Set(profileToolIds);
-	const requestedToolIdSet = new Set(requestedToolIds);
-	return RIVUS_RUNTIME_TOOL_IDS.filter((id) => profileToolIdSet.has(id) && requestedToolIdSet.has(id));
-}
-function resolveMemoryScopes(profile, deployment) {
-	const profileScopes = validateRivusMemoryScopes(profile.memory.scopes, `profile ${profile.id}`);
-	const requestedScopes = validateRivusMemoryScopes(deployment.memory?.scopes ?? [], `deployment ${deployment.agentId}`);
-	return profileScopes.filter((scope) => requestedScopes.includes(scope));
-}
-function resolvePluginTools(registeredTools, profile, deployment) {
-	const requestedTools = uniqueRivusCatalogIds(deployment.tools.allow, "deployment tool allowlist");
-	const catalogTools = new Map(registeredTools.map((tool) => [tool.id, tool]));
-	for (const id of requestedTools) if (!catalogTools.has(id)) throw new InvalidRivusPlugin(`unknown deployment tool: ${id}`);
-	const profileToolIds = uniqueRivusCatalogIds(profile.tools.allow, "profile tool allowlist");
-	for (const id of profileToolIds) if (!catalogTools.has(id)) throw new InvalidRivusPlugin(`profile ${profile.id} references unknown tool: ${id}`);
-	const grantedIds = profileToolIds.filter((id) => requestedTools.includes(id)).sort();
-	return new Map(grantedIds.map((id) => [id, toResolvedTool(catalogTools.get(id))]));
-}
-function resolveSkills(registeredSkills, profile, deployment) {
-	const requestedSkills = uniqueRivusCatalogIds(deployment.skills.allow, "deployment skill allowlist");
-	const catalogSkills = new Map(registeredSkills.map((skill) => [skill.id, skill]));
-	for (const id of requestedSkills) if (!catalogSkills.has(id)) throw new InvalidRivusPlugin(`unknown deployment skill: ${id}`);
-	return uniqueRivusCatalogIds(profile.skills.allow, "profile skill allowlist").filter((id) => requestedSkills.includes(id)).sort().map((id) => {
-		const skill = catalogSkills.get(id);
-		if (!skill) throw new InvalidRivusPlugin(`profile ${profile.id} references unknown skill: ${id}`);
-		return skill;
-	});
-}
-function validateToolContributions(registeredTools, contributions) {
-	const knownIds = new Set(registeredTools.map(({ id }) => id));
-	for (const { tool } of contributions) {
-		validateRivusCatalogIdentifier(tool.id, "contributed tool");
-		validateRivusCatalogIdentifier(tool.pluginId, "contributed tool plugin");
-		if (knownIds.has(tool.id)) throw new InvalidRivusPlugin(`duplicate contributed tool id: ${tool.id}`);
-		if (tool.version.trim() === "" || tool.digest.trim() === "") throw new InvalidRivusPlugin(`contributed tool ${tool.id} requires a version and digest`);
-		knownIds.add(tool.id);
-	}
-}
-function extendRuntimeTools(definition, contributions) {
-	if (contributions.length === 0) return definition;
-	const additions = contributions.map(({ tool }) => deepFreeze({ ...tool }));
-	const additionIds = additions.map(({ id }) => id).sort();
-	return deepFreeze({
-		...definition,
-		toolGrantSet: {
-			revision: digest({
-				parentRevision: definition.toolGrantSet.revision,
-				toolIds: additionIds
-			}),
-			toolIds: [...definition.toolGrantSet.toolIds, ...additionIds].sort()
-		},
-		tools: [...definition.tools, ...additions]
-	});
-}
-function toResolvedTool(tool) {
-	const { createExecutor: _createExecutor, description, digest: toolDigest, id, idempotency, inputSchema, pluginId, risk, version } = tool;
-	return deepFreeze({
-		description,
-		digest: toolDigest,
-		id,
-		idempotency,
-		inputSchema,
-		pluginId,
-		risk,
-		version
-	});
-}
-function digest(value) {
-	return createSha256Digest(stableJson(value));
-}
-function stableJson(value) {
-	if (Array.isArray(value)) return `[${value.map(stableJson).join(",")}]`;
-	if (value !== null && typeof value === "object") return `{${Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, child]) => `${JSON.stringify(key)}:${stableJson(child)}`).join(",")}}`;
-	return JSON.stringify(value);
-}
-//#endregion
-//#region src/modules/agent-catalog/module.ts
-function createRivusAgentCatalog(options = {}) {
-	const resolver = createRivusAgentDefinitionResolver(options.toolDescriptorProviders ?? []);
-	return Object.freeze({
-		createPluginCatalog: createRivusPluginCatalog,
-		resolve: (catalog, deployment) => resolver.resolve(catalog, deployment)
-	});
-}
-//#endregion
-export { RIVUS_MEMORY_TOOL_VERSION as a, RIVUS_MEMORY_TOOL_PLUGIN_ID as i, createRivusHostToolDescriptorProvider as n, createRivusMemoryToolContract as o, RIVUS_MEMORY_TOOL_ID as r, createRivusAgentCatalog as t };