nexus-agentd 0.2.5 → 0.3.0

package/dist/session.d.ts

@@ -1,9 +1,32 @@
 import type { AgentDriver } from './drivers/index.js';
 import { SessionEventLog } from './events.js';
 import { RunStore, type RunListQuery } from './run-store.js';
+import { type AdminRetryReservationFactory, type AdminRunOperationResult, type AdminRunControls } from './session/admin-runs.js';
 import type { AcpSessionSink, AgentSessionRuntime, AgentSessionSink } from './session-contract.js';
 import type { AgentdAgentView, AgentdArtifact, AgentdConfig, AgentdEvent, AgentdEventType, AgentdInputAttachmentView, AgentdPendingRequest, AgentdPendingResponse, AgentdProtocol, AgentdSessionState, AgentdSessionView, AgentdTurnCompletionProof } from './types.js';
-import type { WorkspacePolicy } from './workspace.js';
+import { type WorkspacePolicy } from './workspace.js';
+/** Optional durable sink for full artifact snapshots. */
+export interface SessionArtifactStore {
+    recordArtifacts(runId: string, artifacts: AgentdArtifact[]): unknown | Promise<unknown>;
+}
+export type SessionLifecycleEvent = {
+    type: 'session_created';
+    sessionId: string;
+    ownerKeyId: string;
+    agentId: string;
+} | {
+    type: 'run_updated';
+    sessionId: string;
+    runId: string;
+    ownerKeyId: string;
+    state: AgentdSessionState;
+} | {
+    type: 'session_closed';
+    sessionId: string;
+    ownerKeyId: string;
+    agentId: string;
+};
+export type SessionLifecycleListener = (event: SessionLifecycleEvent) => void;
 export declare class ManagedSession implements AgentSessionSink, AcpSessionSink {
     readonly agentId: string;
     readonly protocol: AgentdProtocol;
@@ -27,8 +50,11 @@ export declare class ManagedSession implements AgentSessionSink, AcpSessionSink
     private artifacts;
     private inputAttachments;
     private runtime?;
-    constructor(agentId: string, protocol: AgentdProtocol, workspace: string | undefined, ownerKeyId: string, maxEvents: number, maxOutputChars: number, agentName: string, runStore?: RunStore | undefined, instanceId?: string);
+    private readonly artifactStore?;
+    private readonly onRunUpdate?;
+    constructor(agentId: string, protocol: AgentdProtocol, workspace: string | undefined, ownerKeyId: string, maxEvents: number, maxOutputChars: number, agentName: string, runStore?: RunStore | undefined, instanceId?: string, artifactStore?: SessionArtifactStore, onRunUpdate?: (runId: string, state: AgentdSessionState) => void);
     attach(runtime: AgentSessionRuntime): void;
+    runtimeAvailable(): boolean;
     setProtocolSessionId(id: string): void;
     setAcpSessionId(id: string): void;
     setState(state: AgentdSessionState, error?: string): void;
@@ -43,7 +69,7 @@ export declare class ManagedSession implements AgentSessionSink, AcpSessionSink
     clearPending(): void;
     emit(type: AgentdEventType, data?: unknown): void;
     addInputAttachment(name: string, mediaType: string | undefined, bytes: Buffer): AgentdInputAttachmentView;
-    message(message: string, attachmentIds?: string[]): Promise<void>;
+    message(message: string, attachmentIds?: string[], retryOfRunId?: string): Promise<void>;
     resolvePending(response: AgentdPendingResponse, attachmentIds?: string[]): Promise<void>;
     cancel(): Promise<void>;
     dispose(): Promise<void>;
@@ -62,21 +88,43 @@ export declare class SessionManager {
     private sessions;
     private sessionLocks;
     private cleanupTimer?;
-    private readinessCache?;
-    constructor(config: AgentdConfig, workspacePolicy: WorkspacePolicy, drivers: Map<string, AgentDriver>, runStore?: RunStore | undefined);
+    private readonly readiness;
+    private readonly admission;
+    private readonly adminRuns;
+    private readonly artifactStore?;
+    private readonly lifecycleListeners;
+    constructor(config: AgentdConfig, workspacePolicy: WorkspacePolicy, drivers: Map<string, AgentDriver>, runStore?: RunStore | undefined, artifactStore?: SessionArtifactStore);
     reconfigure(config: AgentdConfig, workspacePolicy: WorkspacePolicy, drivers: Map<string, AgentDriver>): void;
     startCleanup(): void;
     listAgents(agentIds?: Set<string>, force?: boolean): Promise<AgentdAgentView[]>;
     create(agentId: string, workspaceInput: string | undefined, ownerKeyId: string): Promise<AgentdSessionView>;
+    private createReserved;
     get(id: string): AgentdSessionView;
     owns(id: string, keyId: string): boolean;
     count(): number;
+    subscribeLifecycle(listener: SessionLifecycleListener): () => boolean;
     listRuns(query?: RunListQuery): {
         runs: import("./types.js").AgentdRunView[];
         total: number;
+        stats: {
+            active: number;
+            completed: number;
+            failed: number;
+        };
     };
     getRun(id: string): import("./types.js").AgentdRunDetail;
-    message(id: string, message: string, attachmentIds?: string[]): Promise<AgentdSessionView>;
+    getRunOwnerKeyId(id: string): string | undefined;
+    ownsRun(id: string, keyId: string): boolean;
+    getRunArtifacts(id: string): import("./types.js").AgentdRunArtifactView[];
+    getStorageMetrics(): ReturnType<RunStore['metrics']> | undefined;
+    readRunArtifact(runId: string, artifactId: string): Promise<import("./artifact-store.js").ArtifactReadResult | undefined>;
+    getRunArtifact(runId: string, artifactId: string): Promise<import("./artifact-store.js").ArtifactReadResult | undefined>;
+    getRunControls(id: string): AdminRunControls;
+    cancelRun(id: string): Promise<AdminRunOperationResult>;
+    respondRun(id: string, response: AgentdPendingResponse, attachmentIds?: string[]): Promise<AdminRunOperationResult>;
+    retryRun(id: string, reserveRetry?: AdminRetryReservationFactory): Promise<AdminRunOperationResult>;
+    retryOfRunId(id: string): string | undefined;
+    message(id: string, message: string, attachmentIds?: string[], retryOfRunId?: string): Promise<AgentdSessionView>;
     resolvePending(id: string, response: AgentdPendingResponse, attachmentIds?: string[]): Promise<AgentdSessionView>;
     addInputAttachment(id: string, name: string, mediaType: string | undefined, bytes: Buffer): AgentdInputAttachmentView;
     publishFile(id: string, paths: string[]): Promise<{
@@ -86,14 +134,23 @@ export declare class SessionManager {
     cancel(id: string): Promise<AgentdSessionView>;
     close(id: string): Promise<AgentdSessionView>;
     eventsAfter(id: string, after?: string): AgentdEvent[];
+    eventReplay(id: string, after?: string): {
+        earliestId: string;
+        latestId: string;
+        reset: {
+            reason: string;
+            requestedAfter: string | null;
+        } | undefined;
+        events: AgentdEvent[];
+    };
     subscribe(id: string, listener: (event: AgentdEvent) => void): () => boolean;
     shutdown(): Promise<void>;
     private withSessionLock;
     private require;
-    private ensureCapacity;
     private cleanup;
     private restartCleanup;
     private defaultWorkspace;
+    private notifyLifecycle;
 }
 export declare class SessionNotFoundError extends Error {
     readonly sessionId: string;