agl 1.0.17 → 21.0.2

package/dist_ts/classes.harnessoperationmanager.d.ts

@@ -0,0 +1,113 @@
+import { type IControllerDraftAttachment, type IControllerRuntimeId, type IControllerSessionDraft, type IControllerSessionDraftUpdate, type TControllerSessionHarnessId } from '../dist_ts_interfaces/interfaces.js';
+export declare class ControllerHarnessOperationConflictError extends Error {
+    constructor(messageArg: string);
+}
+export declare class ControllerHarnessOperationLimitError extends Error {
+    constructor(messageArg: string);
+}
+export type TControllerHarnessOperationKind = 'send' | 'slash';
+type TControllerHarnessOperationState = 'submitting' | 'accepted' | 'outcomeUnknown';
+export interface IControllerHarnessOperationReservation {
+    operationId: string;
+    createdAt: number;
+    kind: TControllerHarnessOperationKind;
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    draft: IControllerSessionDraft;
+    promptSuffix: string;
+    /** Native user-message identity when the harness accepts a caller-selected ID. */
+    messageId?: IControllerRuntimeId;
+    uploadDirectory?: string;
+}
+export interface IControllerHarnessOperationSnapshot {
+    reservation: IControllerHarnessOperationReservation;
+    state: TControllerHarnessOperationState;
+    flexQueueId?: string;
+    flexRunId?: string;
+}
+export interface IControllerHarnessOperationBarrier {
+    token: string;
+    harnessId?: 'opencode' | 'flex';
+    operationIds: string[];
+    sessions: Array<{
+        projectId: string;
+        sessionId: IControllerRuntimeId;
+    }>;
+}
+export interface IControllerHarnessOperationManagerOptions {
+    onDraftChanged: (projectIdArg: string, sessionIdArg: IControllerRuntimeId, updateArg: IControllerSessionDraftUpdate) => void;
+    onOperationReleased?: (reservationArg: IControllerHarnessOperationReservation) => void;
+    cleanupTimeoutMs?: number;
+}
+export declare class ControllerHarnessOperationManager {
+    private readonly options;
+    private readonly drafts;
+    private readonly uploads;
+    private readonly operationsBySession;
+    private readonly operationsByOpenCodeMessage;
+    private readonly operationsByFlexQueue;
+    private readonly pendingUploadCleanups;
+    private readonly harnessAdmissionGenerations;
+    private readonly sealedHarnessAdmissions;
+    private activeOperationCount;
+    private operationBarrier?;
+    private closed;
+    private closePromise?;
+    private readonly cleanupTimeoutMs;
+    constructor(options: IControllerHarnessOperationManagerOptions);
+    getDraft(projectIdArg: string, sessionIdArg: IControllerRuntimeId): IControllerSessionDraft;
+    updateDraft(projectIdArg: string, sessionIdArg: IControllerRuntimeId, expectedRevisionArg: number, patchArg: {
+        text?: string;
+        attachments?: readonly IControllerDraftAttachment[];
+    }): IControllerSessionDraft;
+    reserve(kindArg: TControllerHarnessOperationKind, projectIdArg: string, sessionIdArg: IControllerRuntimeId, draftRevisionArg: number, optionsArg: {
+        allowAttachments: boolean;
+    }): Promise<IControllerHarnessOperationReservation>;
+    accept(reservationArg: IControllerHarnessOperationReservation): IControllerSessionDraft;
+    bindOpenCodeMessage(reservationArg: IControllerHarnessOperationReservation, messageIdArg: IControllerRuntimeId): void;
+    private clearReservationDraft;
+    markOutcomeUnknown(reservationArg: IControllerHarnessOperationReservation): void;
+    fail(reservationArg: IControllerHarnessOperationReservation): Promise<void>;
+    complete(reservationArg: IControllerHarnessOperationReservation): Promise<void>;
+    bindFlex(reservationArg: IControllerHarnessOperationReservation, queueIdArg: string, runIdArg?: string): void;
+    bindFlexRun(projectIdArg: string, sessionIdArg: IControllerRuntimeId, queueIdArg: string, runIdArg: string): boolean;
+    completeFlex(projectIdArg: string, sessionIdArg: IControllerRuntimeId, queueIdArg: string, runIdArg?: string): Promise<boolean>;
+    ownsFlexRun(projectIdArg: string, sessionIdArg: IControllerRuntimeId, queueIdArg: string, runIdArg: string): boolean;
+    completeOpenCodeMessage(projectIdArg: string, sessionIdArg: IControllerRuntimeId, messageIdArg: IControllerRuntimeId): Promise<boolean>;
+    getActive(projectIdArg: string, sessionIdArg: IControllerRuntimeId): IControllerHarnessOperationSnapshot | undefined;
+    getOperation(reservationArg: IControllerHarnessOperationReservation): IControllerHarnessOperationSnapshot | undefined;
+    listSessionActive(projectIdArg: string, sessionIdArg: IControllerRuntimeId): IControllerHarnessOperationSnapshot[];
+    bindFlexMessage(projectIdArg: string, sessionIdArg: IControllerRuntimeId, queueIdArg: string, runIdArg: string, messageIdArg: IControllerRuntimeId): boolean;
+    listProjectActive(projectIdArg: string): IControllerHarnessOperationSnapshot[];
+    listHarnessActive(harnessIdArg: 'opencode' | 'flex'): IControllerHarnessOperationSnapshot[];
+    assertExclusive(reservationArg: IControllerHarnessOperationReservation): void;
+    sealHarnessAdmission(harnessIdArg: TControllerSessionHarnessId): number;
+    reopenHarnessAdmission(harnessIdArg: TControllerSessionHarnessId, generationArg: number): boolean;
+    assertCurrentHarnessAdmission(reservationArg: IControllerHarnessOperationReservation): void;
+    beginOperationBarrier(harnessIdArg?: 'opencode' | 'flex', maximumSessionsArg?: number): IControllerHarnessOperationBarrier;
+    beginUpgradeBarrier(maximumSessionsArg?: number): IControllerHarnessOperationBarrier;
+    waitForOperationBarrier(barrierArg: IControllerHarnessOperationBarrier, timeoutMsArg: number, signalArg?: AbortSignal): Promise<boolean>;
+    waitForUpgradeBarrier(barrierArg: IControllerHarnessOperationBarrier, timeoutMsArg: number, signalArg?: AbortSignal): Promise<boolean>;
+    endOperationBarrier(barrierArg: IControllerHarnessOperationBarrier): void;
+    endUpgradeBarrier(barrierArg: IControllerHarnessOperationBarrier): void;
+    purgeSession(projectIdArg: string, sessionIdArg: IControllerRuntimeId): Promise<void>;
+    releaseSession(projectIdArg: string, sessionIdArg: IControllerRuntimeId): Promise<void>;
+    purgeProject(projectIdArg: string): Promise<void>;
+    releaseHarness(harnessIdArg: 'opencode' | 'flex'): Promise<void>;
+    close(): Promise<void>;
+    private sessionKey;
+    private assertOperationBarrier;
+    private currentHarnessAdmissionGeneration;
+    private assertHarnessAdmission;
+    private flexQueueKey;
+    private openCodeMessageKey;
+    private findActive;
+    private requireActive;
+    private releaseActive;
+    private waitForCleanup;
+    private finalizeRelease;
+    private cleanupUpload;
+    private retryPendingUploadCleanup;
+    private retryPendingUploadCleanups;
+}
+export {};