@rivus/agent 0.13.2 → 0.14.1

package/dist/chunks/api3.d.ts

@@ -0,0 +1,402 @@
+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 };