agl 1.0.17 → 21.0.2

package/dist_ts/classes.controller.d.ts

@@ -0,0 +1,523 @@
+import { type IControllerMessage, type IControllerMessageBundle, type IControllerMessagePage, type IControllerReasoningUpdate, type IControllerTextUpdate, type IControllerPermission, type IControllerQuestion, type IControllerSession, type IControllerStatus, type IControllerToolExecution } from '../dist_ts_interfaces/index.js';
+import type { IControllerStartOptions, IControllerStartResult } from './interfaces.lifecycle.js';
+export declare const controllerFlexRestartDelayMs: (attemptArg: number) => number;
+export declare const boundControllerMessagePage: (pageArg: IControllerMessagePage, maximumBundlesArg?: number, protectedMessageCheckArg?: (messageArg: IControllerMessage) => boolean) => IControllerMessagePage;
+export declare const boundControllerMessageBundle: (bundleArg: IControllerMessageBundle) => IControllerMessageBundle;
+export declare const mergeControllerMessagePageSnapshots: (pageArg: IControllerMessagePage, executionsArg: readonly IControllerToolExecution[], reasoningUpdatesArg: readonly IControllerReasoningUpdate[], textUpdatesArg: readonly IControllerTextUpdate[]) => IControllerMessagePage;
+export declare const mergeFlexReasoningUpdatesIntoDetail: <TDetail extends {
+    messages: IControllerMessage[];
+    session?: IControllerSession;
+}>(detailArg: TDetail, updatesArg: readonly IControllerReasoningUpdate[]) => TDetail;
+export declare const mergeFlexTextUpdatesIntoDetail: <TDetail extends {
+    messages: IControllerMessage[];
+    session?: IControllerSession;
+}>(detailArg: TDetail, updatesArg: readonly IControllerTextUpdate[]) => TDetail;
+export declare const mergeOpenCodeReasoningUpdatesIntoDetail: <TDetail extends {
+    messages: IControllerMessage[];
+    session?: IControllerSession;
+}>(detailArg: TDetail, updatesArg: readonly IControllerReasoningUpdate[]) => TDetail;
+export declare const mergeOpenCodeTextUpdatesIntoDetail: <TDetail extends {
+    messages: IControllerMessage[];
+    session?: IControllerSession;
+}>(detailArg: TDetail, updatesArg: readonly IControllerTextUpdate[]) => TDetail;
+export declare const settleControllerAttentionLists: (permissionsPromiseArg: Promise<IControllerPermission[]>, questionsPromiseArg: Promise<IControllerQuestion[]>, reportErrorArg?: (message: string, error: unknown) => void) => Promise<{
+    permissions: IControllerPermission[];
+    questions: IControllerQuestion[];
+}>;
+export declare const isControllerWebSocketRequestAllowed: (headersArg: Headers, publicOriginArg: string, tlsModeArg: "local" | "proxy", trustedProxySecretArg?: string) => boolean;
+export declare class OpenCodeController {
+    readonly options: IControllerStartOptions;
+    private readonly startedAt;
+    private lifecycleState;
+    private processGroupId;
+    private processFingerprint;
+    private setupRequired;
+    private setupCodeExpiresAt?;
+    private projectIdsByDirectory;
+    private defaultModels;
+    private autoAcceptPermissions;
+    private readonly yoloSessionsByProjectKey;
+    private readonly unusedSessionStates;
+    private readonly claimedSessionKeys;
+    private claimedSessionEvictionGeneration;
+    /** sha256(token) -> auth payload; memory-only, cleared on stop */
+    private readonly resumeTokens;
+    private readonly autoRepliedPermissionIds;
+    private readonly flexProviderLogins;
+    private readonly flexRefreshJobs;
+    private readonly pendingFlexFinishedJobs;
+    private readonly pendingFlexFinishedPrompts;
+    private readonly activeFlexRuns;
+    private readonly pendingFlexRunCleanups;
+    private flexRunAuthorityFenced;
+    private flexGlobalCleanupPending;
+    private flexGlobalCleanupGeneration;
+    private flexGlobalCleanupPromise?;
+    private readonly flexModelOptionsByConnection;
+    private readonly flexProviderConnectionMutationTails;
+    private readonly flexModelRefreshAdmissionTasks;
+    private readonly flexProviderNames;
+    private readonly pendingOpenCodeControllerEvents;
+    private readonly latestOpenCodeToolExecutions;
+    private readonly latestOpenCodeReasoningUpdates;
+    private readonly latestOpenCodeTextUpdates;
+    private readonly latestFlexToolExecutions;
+    private readonly latestFlexReasoningUpdates;
+    private readonly latestFlexTextUpdates;
+    private readonly pendingFlexControllerEvents;
+    private readonly pendingFlexAutoAcceptSweeps;
+    private openCodeControllerEventDrainTask?;
+    private openCodeToolStreamEpoch;
+    private openCodeToolStreamRevision;
+    private openCodeMessageStreamEpoch;
+    private openCodeMessageStreamRevision;
+    private flexToolStreamEpoch;
+    private flexToolStreamRevision;
+    private flexMessageStreamEpoch;
+    private flexMessageStreamRevision;
+    private latestFlexToolExecutionBytes;
+    private latestFlexMessageUpdateBytes;
+    private pendingFlexToolEventBytes;
+    private pendingFlexMessageEventBytes;
+    private flexControllerEventDrainTask?;
+    private flexAutoAcceptDrainTask?;
+    private runtimeConfig?;
+    private controllerId?;
+    private authStore?;
+    private passkeyManager?;
+    private openCodeSupervisor?;
+    private openCodeClient?;
+    private flexSupervisor?;
+    private readonly openCodeSupervisorExitSignals;
+    private readonly flexSupervisorExitSignals;
+    private flexProjectionReader?;
+    private gitReversion?;
+    private readonly pendingProjectRemovalTasks;
+    private flexProjectionReaderReady;
+    private flexServiceInit?;
+    private flexRecoveryReady;
+    private flexUnsupported;
+    private flexRestartAttempt;
+    private flexRestartTimer?;
+    private flexRestartTask?;
+    private flexHarnessAdmissionFenceGeneration?;
+    private flexChildExitCleanupPending;
+    private flexChildExitCleanupTask?;
+    private flexGenerationCleanup?;
+    private readonly plannedFlexSupervisorStops;
+    private flexMigrationDatabase?;
+    private flexMigrationStore?;
+    private flexMigrationCleanupPromise?;
+    private controllerProjectMutationTail;
+    private unsubscribeFlexEvents?;
+    private terminalManager?;
+    private terminalResourceHost?;
+    private browserResourceHost?;
+    private resourceCoordinator?;
+    private readonly browserViews;
+    private readonly browserViewSlots;
+    private readonly authenticatedPeerIds;
+    private openCodeResourceGeneration;
+    private flexResourceGeneration;
+    private typedServer?;
+    private unsubscribeConnectionClose?;
+    private eventStreamTask?;
+    private openCodeFailClosedTask?;
+    private openCodeFailClosedRetryTimer?;
+    private flexRunCleanupRetryTimer?;
+    private startPromise?;
+    private stopPromise?;
+    private stopRequested;
+    private controllerStartedRecorded;
+    private controllerStoppedRecorded;
+    private readonly operationAbortController;
+    private readonly activeOperations;
+    private readonly harnessSessionEnumerationTasks;
+    private readonly sessionLayoutOperationTails;
+    private readonly sessionLayoutOperationDepths;
+    private readonly sessionStateMutationTails;
+    private readonly harnessOperationManager;
+    private upgradeCoordinator?;
+    private upgradeToken?;
+    private upgradeStatus?;
+    private upgradeBarrier?;
+    private openCodeAccountSwitchBarrier?;
+    private openCodeAccountSwitchTask?;
+    private openCodeAccountSwitchAdmissionSealed;
+    private selectedOpenCodeProviderConnectionId?;
+    private readonly plannedOpenCodeSupervisorStops;
+    private readonly retainedOpenCodeSupervisors;
+    private openCodeRuntimeAdmissionSealed;
+    private sessionIntelligenceFlexAdmissionSealed;
+    private openCodeRuntimeLeaseCount;
+    private openCodeRuntimeLeaseDrained?;
+    private upgradePreparationAbortController?;
+    private upgradePreparationTask?;
+    private upgradePreparationAdmissionTail;
+    private upgradeFinalizeTail;
+    private upgradeWorkerWatchdog?;
+    private upgradeWorkerWatchdogTask?;
+    private retainedUpgradeOwnershipTask?;
+    private retainedUpgradeLock?;
+    private retainedUpgradeReleaseTask?;
+    private readonly activeSessionBackgroundOperations;
+    private readonly openCodeOperationMonitors;
+    private readonly sessionIntelligenceJobs;
+    private readonly sessionIntelligenceCapabilities;
+    private readonly projectSessionIntelligenceAdmissions;
+    private readonly sessionIntelligenceAdmissions;
+    private readonly retiringProjectIds;
+    private readonly retiringSessionKeys;
+    private readonly archivingSessionKeys;
+    private readonly archivePreflightReads;
+    private readonly abortingSessionKeys;
+    private readonly projectArchiveAdmissions;
+    private readonly projectHarnessSubmissionAdmissions;
+    private readonly sessionHarnessSubmissionAdmissions;
+    private activeSessionIntelligenceJobCount;
+    private sessionIntelligenceCleanupTimer?;
+    private sessionIntelligenceCleanupTask?;
+    private readonly systemMetricsSampler;
+    private readonly activeOperationCountsByPeer;
+    private protectedOperationWindowStartedAt;
+    private protectedOperationCount;
+    private readonly protectedOperationCountsByPeer;
+    private unauthenticatedAuditWindowStartedAt;
+    private unauthenticatedAuditCount;
+    private readonly unauthenticatedAuditCountsByPeer;
+    private unauthenticatedPreflightWindowStartedAt;
+    private unauthenticatedPreflightCount;
+    private readonly unauthenticatedPreflightCountsByPeer;
+    constructor(optionsArg: IControllerStartOptions);
+    start(): Promise<IControllerStartResult>;
+    stop(): Promise<void>;
+    getStatus(): IControllerStatus;
+    private performStart;
+    private startOpenCodeEventStream;
+    private acquireOpenCodeRuntimeLease;
+    private sealOpenCodeRuntimeAdmission;
+    private waitForOpenCodeRuntimeLeases;
+    private createOpenCodeSupervisor;
+    private createRuntimeExitSignal;
+    private createOpenCodeClient;
+    private closeFlexMigrationResources;
+    private flexIsOperational;
+    private sealFlexRuntimeAuthority;
+    private reopenFlexRuntimeAuthority;
+    private ensureFlexProjectionReader;
+    private canRestartFlex;
+    private scheduleFlexRestart;
+    private startFlexRestartAttempt;
+    private stopOwnedFlexSupervisor;
+    private failClosedFlexAfterSessionIntelligenceCleanup;
+    private closeSessionIntelligenceCapabilitiesForFlexSupervisor;
+    private cleanupFlexGeneration;
+    private waitForFlexGenerationCleanup;
+    private cleanupFlexAfterChildExit;
+    private restartFlex;
+    private handleWebSocketConnectionClose;
+    private performStop;
+    private createRouter;
+    private runAudited;
+    private requireProjectsRoot;
+    private ensureInitialProject;
+    private reconcileProjectState;
+    private finishProjectRemoval;
+    private runControllerProjectMutation;
+    private resolveCurrentReconciliationProject;
+    private schedulePendingProjectRemoval;
+    private waitForPendingProjectRemovalRetry;
+    private defaultModelForHarness;
+    private validateControllerModelChoice;
+    private resolveSessionIntelligenceModel;
+    private soleActiveFlexDefaultModelChoice;
+    private beginFlexModelRefresh;
+    private hydrateFlexProviderCatalogs;
+    private listFlexProviderConnections;
+    private withFlexProviderConnectionMutation;
+    private withFlexProviderConnectionMutations;
+    private activateOpenCodeProviderConnection;
+    private performOpenCodeProviderConnectionActivation;
+    private readActiveOpenCodeProviderAuth;
+    private persistSelectedOpenCodeProviderConnection;
+    private currentOwnedOpenCodeRuntime;
+    private startStagedOpenCodeRuntime;
+    private installOpenCodeRuntime;
+    private stopOwnedOpenCodeRuntime;
+    private stopUninstalledOpenCodeSupervisor;
+    private resolveOpenCodeAccountSwitchCohort;
+    private continueOpenCodeAccountSwitchSessions;
+    private remainingOpenCodeAccountSwitchMs;
+    private releaseOpenCodeAccountSwitchAdmission;
+    private clearFlexProviderConnectionChoices;
+    private logoutFlexProviderConnection;
+    private recoverDeletingFlexProviderConnections;
+    private recoverDeletingFlexProviderConnection;
+    private toFlexModelChoice;
+    private listFlexSessions;
+    private enumerateHarnessSessions;
+    private toFlexSession;
+    private findArchivedLayoutSessionIds;
+    private assertAttentionRequestOwned;
+    private toFlexMessageBundle;
+    private toFlexPermission;
+    private sessionStateMutationKey;
+    private withSessionStateMutation;
+    private withActiveSessionMutation;
+    private reserveHarnessSubmissionAdmission;
+    private reserveAdmissionEntry;
+    private withHarnessSubmissionAdmission;
+    private waitForAdmissionDrain;
+    private waitForPromiseWithSignal;
+    private runWithSignal;
+    private waitForProjectHarnessSubmissionAdmissions;
+    private waitForSessionHarnessSubmissionAdmissions;
+    private waitForProjectArchiveAdmissions;
+    private assertSessionMutationAdmission;
+    private startSessionBackgroundOperation;
+    private abortSessionBackgroundOperation;
+    private abortProjectSessionBackgroundOperations;
+    private abortActiveHarnessOperation;
+    private abortProjectHarnessOperations;
+    private reserveProjectSessionIntelligenceAdmission;
+    private reserveSessionIntelligenceAdmission;
+    private reserveSessionIntelligenceAdmissionEntry;
+    private waitForProjectSessionIntelligenceAdmissions;
+    private waitForSessionIntelligenceAdmissions;
+    private waitForAllProjectSessionIntelligenceAdmissions;
+    private assertSessionExists;
+    private readControllerSession;
+    private assertSessionIsNotIntelligenceTemporary;
+    private getFlexSessionMetrics;
+    private executeSessionIntelligenceJob;
+    private createSessionIntelligenceCapability;
+    private closeSessionIntelligenceCapability;
+    private beginSessionIntelligenceCapabilityRequest;
+    private assertSessionIntelligenceCapabilityActive;
+    private listSessionIntelligenceChats;
+    private readSessionIntelligenceChat;
+    private boundSessionIntelligenceMessageText;
+    private findHiddenSessionIntelligenceChatIds;
+    private boundSessionIntelligenceTranscript;
+    private isCanonicalIsoDate;
+    private waitForSessionIntelligenceResult;
+    private cancelAndDrainSessionIntelligenceJob;
+    private waitForSessionIntelligencePoll;
+    private requireControllerId;
+    private recoverSessionIntelligence;
+    private scheduleSessionIntelligenceCleanup;
+    private startSessionIntelligenceCleanupTimer;
+    private stopSessionIntelligenceCleanupTimer;
+    private drainOpenCodeOperationMonitors;
+    private retireProjectSessionIntelligence;
+    private drainSessionIntelligenceOperations;
+    private waitForSessionIntelligenceOperations;
+    private cleanupSessionIntelligenceOrphans;
+    private getFlexSessionDetail;
+    private toPublicProviderConnection;
+    private toPublicProviderAccount;
+    private toPublicProviderLogin;
+    private toFlexModelOptions;
+    private consumePendingFlexFinishedPrompt;
+    private registerFlexRun;
+    private unregisterFlexRun;
+    private ownsFlexRun;
+    private retireFlexRun;
+    private retryFlexRunCleanup;
+    private retryPendingFlexRunCleanups;
+    private retryFlexGlobalCleanup;
+    private drainFlexGlobalCleanup;
+    private queueFlexGlobalCleanup;
+    private scheduleFlexRunCleanupRetry;
+    private fenceFlexRunAuthority;
+    private acknowledgeFlexRun;
+    private handleHarnessOperationReleased;
+    private pendingPromptsForSession;
+    private queueHarnessPromptChanged;
+    private releaseOpenCodeOperationsAfterSessionError;
+    private startOpenCodeOperationMonitor;
+    private reconcileOpenCodeOperations;
+    private handleOpenCodeMessageLifecycle;
+    private failClosedOpenCodeHarness;
+    private queueHarnessSessionErrors;
+    private handleHarnessChildExit;
+    private handleFlexChildExitObserved;
+    private handleFlexChildExit;
+    private handleUndeliveredFlexHostSuccess;
+    private handleFlexHostRequest;
+    private queueHarnessSessionError;
+    private consumePendingFlexFinishedJob;
+    private handleFlexEvent;
+    private getFlexToolStreamCursor;
+    private prepareCoreMessagePageForLiveSnapshots;
+    private boundLiveSnapshotsForCorePage;
+    private getFlexMessageStreamCursor;
+    private flexToolPayloadCovers;
+    private flexCorePageRepresentsToolExecution;
+    private flexCorePageRepresentsReasoningUpdate;
+    private flexCorePageRepresentsTextUpdate;
+    private retireCoveredFlexSnapshots;
+    private deleteLatestFlexToolExecution;
+    private deleteLatestFlexReasoningUpdate;
+    private deleteLatestFlexTextUpdate;
+    private setLatestFlexToolExecution;
+    private setLatestFlexReasoningUpdate;
+    private setLatestFlexTextUpdate;
+    private flexControllerEventLiveBytes;
+    private deletePendingFlexControllerEvent;
+    private setPendingFlexControllerEvent;
+    private clearPendingFlexControllerEvents;
+    private flexSnapshotsForSession;
+    private flexToolExecutionsForSession;
+    private flexReasoningUpdatesForSession;
+    private flexTextUpdatesForSession;
+    private advanceFlexToolStreamEpoch;
+    private advanceFlexMessageStreamEpoch;
+    private advanceFlexStreams;
+    private purgeFlexToolExecutionsForSession;
+    private purgeOpenCodeStreamStateForSession;
+    private purgeOpenCodeStreamStateForProject;
+    private purgeFlexToolExecutionsForProject;
+    private handleFlexToolExecution;
+    private handleFlexReasoningUpdate;
+    private handleFlexTextUpdate;
+    private getOpenCodeToolStreamCursor;
+    private getOpenCodeMessageStreamCursor;
+    private openCodeToolExecutionKey;
+    private openCodeToolExecutionsForSession;
+    private openCodeReasoningUpdatesForSession;
+    private openCodeTextUpdatesForSession;
+    private advanceOpenCodeToolStreamEpoch;
+    private advanceOpenCodeMessageStreamEpoch;
+    private advanceOpenCodeStreams;
+    private handleOpenCodeReasoningUpdate;
+    private handleOpenCodeTextUpdate;
+    private handleOpenCodeMessageUpdate;
+    private handleOpenCodeToolExecution;
+    private controllerEventKey;
+    private queueOpenCodeControllerEvent;
+    private startOpenCodeControllerEventDrain;
+    private drainOpenCodeControllerEvents;
+    private rebaseFlexLiveControllerEvent;
+    private queueFlexControllerEvent;
+    private startFlexControllerEventDrain;
+    private drainFlexControllerEvents;
+    private queueFlexAutoAcceptSweep;
+    private startFlexAutoAcceptDrain;
+    private drainFlexAutoAcceptSweeps;
+    private autoAcceptFlexPendingPermissions;
+    private isProjectAutoAcceptedSession;
+    private hasFlexYoloSessions;
+    private projectRuntimeIdKey;
+    private unusedSessionKey;
+    private trimUnusedSessionStates;
+    private markUnusedSession;
+    private claimUnusedSession;
+    private discardUnusedSession;
+    private isConfirmedArchivedSession;
+    private isConfirmedOpenCodeArchive;
+    private readArchivePreflight;
+    private readMutableHarnessSession;
+    private requireOpenCodeArchiveRuntime;
+    private requireFlexArchiveRuntime;
+    private waitForArchiveRetryOrRuntimeExit;
+    private waitForArchiveRuntimeExit;
+    private waitForOpenCodeArchiveMutationOrRuntimeExit;
+    private reconcileUnknownOpenCodeArchive;
+    private retainUnknownOpenCodeArchive;
+    private reconcileUnknownFlexArchive;
+    private finalizeArchivedSession;
+    private archiveSession;
+    private deleteSession;
+    private readonly autoAcceptSweepTimers;
+    /**
+     * Collapses permission-event bursts into one sweep per directory: every
+     * auto-reply itself emits permission events, so sweeping per event goes
+     * quadratic under load.
+     */
+    private scheduleAutoAcceptSweep;
+    private autoAcceptPendingPermissions;
+    private pruneSessionFromLayout;
+    private runSessionLayoutOperation;
+    private pushSessionLayoutChanged;
+    private pushResourceChanged;
+    private openBrowserView;
+    private activateBrowserView;
+    private closeBrowserView;
+    private closeBrowserViewsForPeer;
+    private closeBrowserViewsForResource;
+    private runBrowserViewSlotOperation;
+    private enqueueBrowserViewSlotOperation;
+    private markBrowserViewClosing;
+    private scheduleBrowserViewClose;
+    private requestBrowserViewCleanup;
+    private cleanupBrowserViewAsSlotOwner;
+    private attemptBrowserViewCleanup;
+    private scheduleBrowserViewCleanupRetry;
+    private operateBrowserView;
+    private queueBrowserViewEvent;
+    private sendBrowserViewEvent;
+    private bindBrowserFrameStreamAuthorization;
+    private revalidateBrowserFrameStream;
+    private isBrowserRuntimeAuthorityCurrent;
+    private toControllerBrowserViewState;
+    private resolveAttentionRootSessionIds;
+    private sweepAutoAcceptAcrossProjects;
+    private resolveProject;
+    private resolveProjectIdentity;
+    private assertProjectDirectory;
+    private resolveAvailableProjects;
+    private toPublicProject;
+    private resolveExistingProjectDirectory;
+    /**
+     * Display name for a registered directory: relative when it lives under the
+     * projects root, else the absolute path itself.
+     */
+    private deriveProjectName;
+    private listProjectPathSuggestions;
+    private sendTerminalOutput;
+    private pushControllerEvent;
+    private runUpgradePreparationAdmission;
+    private upgradePreparationReplayIsAccepted;
+    private createUpgradePreparationContext;
+    private persistUpgradePreparation;
+    private pushUpgradePreparationEvent;
+    private completeUpgradePreparation;
+    private clearUpgradePreparationAbortController;
+    private compensateUpgradePreparationFailure;
+    private prepareUpgrade;
+    private beginUpgradePreparation;
+    private abortAndWaitForUpgradePreparation;
+    private finalizeUpgrade;
+    private sendUpgradeControlPrompt;
+    private retainUpgradeOwnership;
+    private releaseRetainedUpgradeOwnership;
+    private startUpgradeWorkerWatchdog;
+    private pushSessionDraftChanged;
+    private isHarnessSubmissionOutcomeUnknown;
+    private isFlexPromptAdmissionTerminated;
+    private assertStartActive;
+    private runOperation;
+    private abortBusySessionsBeforeExit;
+    private mintResumeToken;
+    private consumeResumeToken;
+    private recordProtectedOperation;
+    private recordUnauthenticatedAuditOperation;
+    private recordUnauthenticatedPreflightOperation;
+    private trackOperationPromise;
+    private waitForActiveOperations;
+    private waitForOwnedProcessGroupChildren;
+    private requireRuntimeConfig;
+    private requireAuthStore;
+    private requireTypedServer;
+    private requirePasskeyManager;
+    private requireOpenCodeClient;
+    private requireFlexSupervisor;
+    private requireFlexProjectionReader;
+    private requireGitReversion;
+    private resolveFlexHostGitProject;
+    private terminalPeerLifecycle;
+    private requireTerminalManager;
+    private requireResourceCoordinator;
+    private requireBrowserResourceHost;
+}