@botbotgo/agent-harness 0.0.290 → 0.0.291

package/dist/persistence/file-store.d.ts

@@ -1,35 +1,35 @@
-import type { ArtifactListing, ArtifactRecord, HarnessEvent, InternalApprovalRecord, RunSummary, RunState, ThreadSummary, ThreadRunRecord, TranscriptMessage } from "../contracts/types.js";
-import type { ApprovalFilter, PersistedSessionListSummary, PersistedRunRequest, PersistedRunControlRecord, PersistedRunInspection, PersistedRunQueueRecord, PersistenceLifecycle as Lifecycle, RuntimePersistence, RecoveryIntent, PersistenceRunMeta as RunMeta, RunSummaryFilter, ThreadSummaryFilter, PersistenceThreadMeta as ThreadMeta } from "./types.js";
-type RunIndexRecord = {
-    runId: string;
-    threadId: string;
-    state: RunState;
+import type { ArtifactListing, ArtifactRecord, HarnessEvent, InternalApprovalRecord, RequestSummary, RequestState, SessionRequestRecord, SessionSummary, TranscriptMessage } from "../contracts/types.js";
+import type { ApprovalFilter, PersistedSessionListSummary, PersistedRequestInput, PersistedRequestControlRecord, PersistedRunInspection, PersistedRequestQueueRecord, PersistenceLifecycle as Lifecycle, PersistenceRequestMeta as RequestMeta, RuntimePersistence, RecoveryIntent, PersistenceSessionMeta as SessionMeta, RequestSummaryFilter, SessionSummaryFilter } from "./types.js";
+type RequestIndexRecord = {
+    requestId: string;
+    sessionId: string;
+    state: RequestState;
     resumable: boolean;
     updatedAt: string;
 };
 export declare class FilePersistence implements RuntimePersistence {
-    private readonly runRoot;
-    constructor(runRoot: string);
+    private readonly runtimeRoot;
+    constructor(runtimeRoot: string);
     private artifactsRoot;
-    private threadIndexPath;
-    private runIndexPath;
+    private sessionIndexPath;
+    private requestIndexPath;
     private approvalIndexPath;
-    private runQueuePath;
-    private runControlPath;
+    private requestQueuePath;
+    private requestControlPath;
     private traceItemsPath;
     initialize(): Promise<void>;
-    threadDir(threadId: string): string;
-    runDir(threadId: string, runId: string): string;
-    createThread(input: {
-        threadId: string;
+    sessionDir(sessionId: string): string;
+    requestDir(sessionId: string, requestId: string): string;
+    createSession(input: {
+        sessionId: string;
         agentId: string;
-        runId: string;
-        status: RunState;
+        requestId: string;
+        status: RequestState;
         createdAt: string;
     }): Promise<void>;
-    createRun(input: {
-        threadId: string;
-        runId: string;
+    createRequest(input: {
+        sessionId: string;
+        requestId: string;
         agentId: string;
         executionMode: string;
         adapterKind?: string;
@@ -37,74 +37,74 @@ export declare class FilePersistence implements RuntimePersistence {
         startedAt?: string;
         currentAgentId?: string;
         delegationChain?: string[];
-        runtimeSnapshot?: RunSummary["runtimeSnapshot"];
+        runtimeSnapshot?: RequestSummary["runtimeSnapshot"];
     }): Promise<void>;
-    setRunState(threadId: string, runId: string, state: RunState, checkpointRef?: string | null): Promise<void>;
+    setRequestState(sessionId: string, requestId: string, state: RequestState, checkpointRef?: string | null): Promise<void>;
     appendEvent(event: HarnessEvent): Promise<void>;
-    listSessions(filter?: ThreadSummaryFilter): Promise<ThreadSummary[]>;
-    listSessionSummaries(filter?: ThreadSummaryFilter): Promise<PersistedSessionListSummary[]>;
-    listRunIndexes(): Promise<RunIndexRecord[]>;
-    private readRunSummary;
-    listRuns(filter?: RunSummaryFilter): Promise<RunSummary[]>;
-    getRun(runId: string): Promise<RunSummary | null>;
-    getSession(threadId: string): Promise<ThreadSummary | null>;
-    getThreadMeta(threadId: string): Promise<ThreadMeta | null>;
-    listThreadRuns(threadId: string): Promise<ThreadRunRecord[]>;
-    listRunEvents(threadId: string, runId: string): Promise<HarnessEvent[]>;
+    listSessions(filter?: SessionSummaryFilter): Promise<SessionSummary[]>;
+    listSessionSummaries(filter?: SessionSummaryFilter): Promise<PersistedSessionListSummary[]>;
+    listRequestIndexes(): Promise<RequestIndexRecord[]>;
+    private readRequestSummary;
+    listRequests(filter?: RequestSummaryFilter): Promise<RequestSummary[]>;
+    getRequest(requestId: string): Promise<RequestSummary | null>;
+    getSession(sessionId: string): Promise<SessionSummary | null>;
+    getSessionMeta(sessionId: string): Promise<SessionMeta | null>;
+    listSessionRequests(sessionId: string): Promise<SessionRequestRecord[]>;
+    listRequestEvents(sessionId: string, requestId: string): Promise<HarnessEvent[]>;
     listApprovals(filter?: ApprovalFilter): Promise<InternalApprovalRecord[]>;
     getApproval(approvalId: string): Promise<InternalApprovalRecord | null>;
-    getRunApprovals(threadId: string, runId: string): Promise<InternalApprovalRecord[]>;
-    getRunMeta(threadId: string, runId: string): Promise<RunMeta>;
-    getRunLifecycle(threadId: string, runId: string): Promise<Lifecycle>;
-    getRunInspection(threadId: string, runId: string): Promise<PersistedRunInspection>;
-    updateRunInspection(threadId: string, runId: string, patch: {
+    getRequestApprovals(sessionId: string, requestId: string): Promise<InternalApprovalRecord[]>;
+    getRequestMeta(sessionId: string, requestId: string): Promise<RequestMeta>;
+    getRequestLifecycle(sessionId: string, requestId: string): Promise<Lifecycle>;
+    getRequestInspection(sessionId: string, requestId: string): Promise<PersistedRunInspection>;
+    updateRequestInspection(sessionId: string, requestId: string, patch: {
         endedAt?: string | null;
         lastActivityAt?: string;
         currentAgentId?: string | null;
         delegationChain?: string[];
-        runtimeSnapshot?: RunSummary["runtimeSnapshot"] | null;
+        runtimeSnapshot?: RequestSummary["runtimeSnapshot"] | null;
     }): Promise<void>;
-    appendRunTraceItem(threadId: string, runId: string, item: unknown): Promise<void>;
-    listRunTraceItems(threadId: string, runId: string): Promise<unknown[]>;
-    deleteThread(threadId: string): Promise<boolean>;
-    saveRunRequest(threadId: string, runId: string, request: PersistedRunRequest): Promise<void>;
-    getRunRequest(threadId: string, runId: string): Promise<PersistedRunRequest | null>;
-    clearRunRequest(threadId: string, runId: string): Promise<void>;
+    appendRequestTraceItem(sessionId: string, requestId: string, item: unknown): Promise<void>;
+    listRequestTraceItems(sessionId: string, requestId: string): Promise<unknown[]>;
+    deleteSession(sessionId: string): Promise<boolean>;
+    saveRequestInput(sessionId: string, requestId: string, request: PersistedRequestInput): Promise<void>;
+    getRequestInput(sessionId: string, requestId: string): Promise<PersistedRequestInput | null>;
+    clearRequestInput(sessionId: string, requestId: string): Promise<void>;
     createApproval(record: InternalApprovalRecord): Promise<void>;
-    resolveApproval(threadId: string, runId: string, approvalId: string, status: InternalApprovalRecord["status"]): Promise<InternalApprovalRecord>;
-    createArtifact(threadId: string, runId: string, artifact: ArtifactRecord, content: unknown): Promise<ArtifactRecord>;
-    listArtifacts(threadId: string, runId: string): Promise<ArtifactListing>;
-    readArtifact(threadId: string, runId: string, artifactPath: string): Promise<unknown>;
-    appendThreadMessage(threadId: string, message: TranscriptMessage): Promise<void>;
-    listThreadMessages(threadId: string, limit?: number): Promise<TranscriptMessage[]>;
-    saveRecoveryIntent(threadId: string, runId: string, intent: RecoveryIntent): Promise<void>;
-    getRecoveryIntent(threadId: string, runId: string): Promise<RecoveryIntent | null>;
-    clearRecoveryIntent(threadId: string, runId: string): Promise<void>;
-    enqueueRun(input: {
-        threadId: string;
-        runId: string;
+    resolveApproval(sessionId: string, requestId: string, approvalId: string, status: InternalApprovalRecord["status"]): Promise<InternalApprovalRecord>;
+    createRequestArtifact(sessionId: string, requestId: string, artifact: ArtifactRecord, content: unknown): Promise<ArtifactRecord>;
+    listRequestArtifacts(sessionId: string, requestId: string): Promise<ArtifactListing>;
+    readRequestArtifact(sessionId: string, requestId: string, artifactPath: string): Promise<unknown>;
+    appendSessionMessage(sessionId: string, message: TranscriptMessage): Promise<void>;
+    listSessionMessages(sessionId: string, limit?: number): Promise<TranscriptMessage[]>;
+    saveRequestRecoveryIntent(sessionId: string, requestId: string, intent: RecoveryIntent): Promise<void>;
+    getRequestRecoveryIntent(sessionId: string, requestId: string): Promise<RecoveryIntent | null>;
+    clearRequestRecoveryIntent(sessionId: string, requestId: string): Promise<void>;
+    enqueueRequest(input: {
+        sessionId: string;
+        requestId: string;
         priority?: number;
         queueKey?: string | null;
         availableAt?: string;
     }): Promise<void>;
-    getQueuedRun(runId: string): Promise<PersistedRunQueueRecord | null>;
-    claimQueuedRun(input: {
-        threadId: string;
-        runId: string;
+    getQueuedRequest(requestId: string): Promise<PersistedRequestQueueRecord | null>;
+    claimQueuedRequest(input: {
+        sessionId: string;
+        requestId: string;
         workerId: string;
         claimedAt?: string;
         leaseExpiresAt: string;
-    }): Promise<PersistedRunQueueRecord>;
-    renewRunLease(input: {
-        runId: string;
+    }): Promise<PersistedRequestQueueRecord>;
+    renewRequestLease(input: {
+        requestId: string;
         workerId: string;
         heartbeatAt?: string;
         leaseExpiresAt: string;
     }): Promise<void>;
-    releaseRunClaim(runId: string): Promise<void>;
-    listExpiredClaimedRuns(cutoffIso: string): Promise<PersistedRunQueueRecord[]>;
-    getRunControl(runId: string): Promise<PersistedRunControlRecord | null>;
-    requestRunCancel(runId: string, reason?: string): Promise<PersistedRunControlRecord>;
-    clearRunCancel(runId: string): Promise<void>;
+    releaseRequestClaim(requestId: string): Promise<void>;
+    listExpiredClaimedRequests(cutoffIso: string): Promise<PersistedRequestQueueRecord[]>;
+    getRequestControl(requestId: string): Promise<PersistedRequestControlRecord | null>;
+    requestRequestCancel(requestId: string, reason?: string): Promise<PersistedRequestControlRecord>;
+    clearRequestCancel(requestId: string): Promise<void>;
 }
 export {};