agl 1.0.17 → 21.0.2

package/dist_ts/classes.authstore.d.ts

@@ -0,0 +1,160 @@
+import * as plugins from './plugins.js';
+import { type IAuthStore, type IConsumeCeremonyOptions, type IControllerAuditEvent, type IControllerAuthDocument, type IRecordAuditEventInput, type IMintedTempPassword, type ISetupAuthority, type IStoredPasskeyCredential, type TWebAuthnCeremonyKind, type IWebAuthnCeremonyDocument, type IWebAuthnSetupCeremonyDocument } from './interfaces.auth.js';
+import type { IControllerRuntimeConfig } from './interfaces.config.js';
+import { type IControllerProjectFilesystemIdentity, type IControllerProjectDocument, type IControllerResourceDocument, type IControllerSessionState, type IControllerIntelligenceAdmission, type IControllerInterruptedIntelligenceRecovery, type IControllerSettingsDocument } from './interfaces.projects.js';
+import type { TControllerModelChoice, IControllerRuntimeId, IControllerSessionGroup, IControllerSessionLayout, TControllerTerminalId, TControllerResourceKind, TControllerSessionId } from '../dist_ts_interfaces/index.js';
+import type { IFlexDatabaseDescriptor } from './interfaces.flexipc.js';
+export interface ISmartDataAuthStoreOptions {
+    /** external server URL; absent = embedded smartdb engine */
+    mongoDbUrl?: string;
+    mongoDbName: string;
+    /** storage directory for the embedded engine; required without mongoDbUrl */
+    embeddedDataDirectory?: string;
+    /** previous installed default that may be logically migrated */
+    legacyEmbeddedDataDirectory?: string;
+}
+export declare const assertProvidedSetupCode: (setupCodeArg: string) => string;
+type TFlexProjectManagementRecord = plugins.flexharness.TFlexProjectManagementRecord;
+type TFlexProjectManagementSnapshot = plugins.flexharness.IFlexProjectManagementSnapshot;
+type TFlexProjectManagementTombstone = plugins.flexharness.IFlexProjectManagementTombstone;
+type TFlexProjectManagementWriteContext = plugins.flexharness.IFlexProjectManagementWriteContext;
+type TFlexSessionGeneration = plugins.flexharness.IFlexSessionGeneration;
+export declare const assertControllerResourceCreationCapacity: (projectResourceCountArg: number, controllerResourceCountArg: number) => void;
+export declare class SmartDataAuthStore implements IAuthStore {
+    private readonly options;
+    private database?;
+    private embeddedDatabase?;
+    private readonly smartDataManager;
+    private initialized;
+    private initPromise?;
+    private controllerId?;
+    private resolvedMongoDbUrl?;
+    private closePromise?;
+    private closeStarted;
+    private projectMutationAdmissionOpen;
+    private projectMutationTail;
+    private sessionStateMutationTail;
+    private auditPruneTimer?;
+    private runSessionStateMutation;
+    constructor(options: ISmartDataAuthStoreOptions);
+    private get db();
+    init(): Promise<void>;
+    private initOnce;
+    private pruneAuditHistory;
+    private stopEmbeddedDatabase;
+    close(): Promise<void>;
+    getRuntimeConfig(controllerPortArg: number): Promise<IControllerRuntimeConfig | undefined>;
+    /** Process-private connection data for the isolated Flex child and projection reader. */
+    getDatabaseDescriptor(): IFlexDatabaseDescriptor;
+    resolveOrCreateRuntimeConfig(runtimeConfigArg: IControllerRuntimeConfig): Promise<IControllerAuthDocument>;
+    private finalizeRuntimeConfigDocument;
+    rotateSetupAuthority(providedCodeArg?: string): Promise<ISetupAuthority | null>;
+    getState(): Promise<IControllerAuthDocument>;
+    assertSetupAuthority(setupCodeArg: string, ceremonyArg?: IWebAuthnSetupCeremonyDocument, nowArg?: Date): Promise<IControllerAuthDocument>;
+    countActiveCeremonies(kindArg: TWebAuthnCeremonyKind, nowArg: Date): Promise<number>;
+    createCeremony(ceremonyArg: IWebAuthnCeremonyDocument): Promise<IWebAuthnCeremonyDocument>;
+    consumeCeremony(optionsArg: IConsumeCeremonyOptions): Promise<IWebAuthnCeremonyDocument>;
+    assertPendingCeremony(optionsArg: IConsumeCeremonyOptions): Promise<IWebAuthnCeremonyDocument>;
+    private findPendingCeremony;
+    commitFirstCredential(ceremonyArg: IWebAuthnSetupCeremonyDocument, credentialArg: IStoredPasskeyCredential): Promise<IControllerAuthDocument>;
+    updateCounter(credentialIdArg: string, expectedCounterArg: number, newCounterArg: number): Promise<IStoredPasskeyCredential>;
+    recordAuditEvent(eventArg: IRecordAuditEventInput): Promise<IControllerAuditEvent>;
+    private assertInitialized;
+    private findStoredState;
+    private requireControllerId;
+    listProjects(): Promise<IControllerProjectDocument[]>;
+    createProject(nameArg: string, directoryArg: string, identityArg: IControllerProjectFilesystemIdentity): Promise<{
+        project: IControllerProjectDocument;
+        created: boolean;
+    }>;
+    removeProject(projectIdArg: string): Promise<boolean>;
+    beginProjectRemoval(projectIdArg: string): Promise<IControllerProjectDocument | undefined>;
+    listPendingProjectRemovals(): Promise<IControllerProjectDocument[]>;
+    private withProjectMutation;
+    private insertResourceDocument;
+    private transitionResourceDocument;
+    getProject(projectIdArg: string): Promise<IControllerProjectDocument | undefined>;
+    getPendingProjectRemoval(projectIdArg: string): Promise<IControllerProjectDocument | undefined>;
+    listResources(projectIdArg: string, optionsArg?: {
+        includeRetired?: boolean;
+    }): Promise<IControllerResourceDocument[]>;
+    listRecoverableResources(): Promise<IControllerResourceDocument[]>;
+    getResource(projectIdArg: string, resourceIdArg: string, optionsArg?: {
+        includeRetired?: boolean;
+    }): Promise<IControllerResourceDocument | undefined>;
+    createResource(inputArg: {
+        projectId: string;
+        kind: TControllerResourceKind;
+        title: string;
+        terminal?: IControllerResourceDocument['terminal'];
+    }): Promise<IControllerResourceDocument>;
+    renameResource(projectIdArg: string, resourceIdArg: string, titleArg: string): Promise<IControllerResourceDocument>;
+    beginResourceAttachmentTransition(projectIdArg: string, resourceIdArg: string, sessionIdArg: TControllerSessionId | null, expectedAttachmentRevisionArg: number): Promise<IControllerResourceDocument>;
+    commitResourceAttachmentTransition(projectIdArg: string, resourceIdArg: string, operationIdArg: string): Promise<IControllerResourceDocument>;
+    beginResourceRetirement(projectIdArg: string, resourceIdArg: string): Promise<IControllerResourceDocument>;
+    completeResourceRetirement(projectIdArg: string, resourceIdArg: string): Promise<IControllerResourceDocument>;
+    markTerminalResourceStopped(projectIdArg: string, resourceIdArg: string, outcomeArg?: {
+        stoppedAt?: Date;
+        lastExitCode?: number;
+    }): Promise<IControllerResourceDocument>;
+    markTerminalResourceRunning(projectIdArg: string, resourceIdArg: string): Promise<IControllerResourceDocument>;
+    getSettings(): Promise<IControllerSettingsDocument>;
+    updateSettings(patchArg: {
+        defaultModels?: TControllerModelChoice[];
+        autoAcceptPermissions?: boolean;
+        selectedOpenCodeProviderConnectionId?: string | null;
+    }): Promise<IControllerSettingsDocument>;
+    getSessionLayout(projectIdArg: string): Promise<IControllerSessionLayout>;
+    updateSessionLayout(projectIdArg: string, groupsArg: IControllerSessionGroup[], ungroupedSessionIdsArg?: IControllerSessionGroup['sessionIds'], expectedRevisionArg?: number): Promise<IControllerSessionLayout>;
+    removeSessionFromLayout(projectIdArg: string, sessionIdArg: IControllerRuntimeId): Promise<boolean>;
+    pruneTerminalLayoutEntries(projectIdArg: string, liveTerminalIdsArg: readonly TControllerTerminalId[]): Promise<boolean>;
+    pruneArchivedSessionLayoutEntries(projectIdArg: string, archivedSessionIdsArg: readonly IControllerRuntimeId[]): Promise<boolean>;
+    private filterSessionLayout;
+    private sessionStateIdentity;
+    private createEmptySessionStateDocument;
+    private findStoredSessionState;
+    private insertSessionState;
+    private transitionSessionState;
+    getSessionState(projectIdArg: string, sessionIdArg: IControllerRuntimeId): Promise<IControllerSessionState>;
+    loadFlexProjectManagement(projectIdArg: string, sessionIdArg: string, sessionGenerationArg: Readonly<TFlexSessionGeneration>): Promise<TFlexProjectManagementRecord | undefined>;
+    saveFlexProjectManagement(projectIdArg: string, sessionIdArg: string, snapshotArg: TFlexProjectManagementSnapshot, expectedRevisionArg: number, writeContextArg: TFlexProjectManagementWriteContext): Promise<void>;
+    tombstoneFlexProjectManagement(projectIdArg: string, sessionIdArg: string, tombstoneArg: TFlexProjectManagementTombstone, expectedRevisionArg: number): Promise<void>;
+    purgeFlexProjectManagementNamespace(projectIdArg: string): Promise<void>;
+    setSessionModelChoice(projectIdArg: string, sessionIdArg: IControllerRuntimeId, modelChoiceArg: TControllerModelChoice): Promise<IControllerSessionState>;
+    private clearStoredSessionModelChoiceForProviderConnection;
+    clearSessionModelChoicesForProviderConnection(providerConnectionIdArg: string, signalArg?: AbortSignal): Promise<number>;
+    saveSessionScratchpad(projectIdArg: string, sessionIdArg: IControllerRuntimeId, textArg: string, expectedRevisionArg: number): Promise<IControllerSessionState>;
+    private saveSessionScratchpadUnqueued;
+    admitSessionIntelligence(projectIdArg: string, sessionIdArg: IControllerRuntimeId, questionArg: string): Promise<IControllerIntelligenceAdmission>;
+    private admitSessionIntelligenceUnqueued;
+    attachSessionIntelligenceTemporarySession(projectIdArg: string, sessionIdArg: IControllerRuntimeId, exchangeIdArg: string, temporarySessionIdArg: string): Promise<void>;
+    private attachSessionIntelligenceTemporarySessionUnqueued;
+    completeSessionIntelligence(projectIdArg: string, sessionIdArg: IControllerRuntimeId, exchangeIdArg: string, answerArg: string, scratchpadTextArg: string, modelArg: string): Promise<IControllerSessionState | undefined>;
+    private completeSessionIntelligenceUnqueued;
+    failSessionIntelligence(projectIdArg: string, sessionIdArg: IControllerRuntimeId, exchangeIdArg: string, errorArg: string, modelArg?: string): Promise<IControllerSessionState | undefined>;
+    private failSessionIntelligenceUnqueued;
+    recoverInterruptedSessionIntelligence(): Promise<IControllerInterruptedIntelligenceRecovery>;
+    private recoverInterruptedSessionIntelligenceUnqueued;
+    listProjectSessionIntelligenceCleanupObligations(projectIdArg: string): Promise<IControllerInterruptedIntelligenceRecovery['temporarySessionIds']>;
+    getSessionIntelligenceCleanupObligations(projectIdArg: string, sessionIdArg: IControllerRuntimeId): Promise<IControllerInterruptedIntelligenceRecovery['temporarySessionIds']>;
+    findProjectSessionIntelligenceTemporarySessionIds(projectIdArg: string, candidateIdsArg: string[], signalArg?: AbortSignal): Promise<Set<string>>;
+    isSessionStateTombstoned(projectIdArg: string, sessionIdArg: IControllerRuntimeId): Promise<boolean>;
+    retireProjectSessionStates(projectIdArg: string, cleanupTemporarySessionArg: (temporarySessionIdArg: string) => Promise<void>, signalArg?: AbortSignal): Promise<{
+        retiredCount: number;
+        temporarySessionIds: string[];
+    }>;
+    clearSessionIntelligenceTemporarySession(projectIdArg: string, sessionIdArg: IControllerRuntimeId, exchangeIdArg: string, temporarySessionIdArg: string): Promise<void>;
+    private clearSessionIntelligenceTemporarySessionUnqueued;
+    tombstoneSessionState(projectIdArg: string, sessionIdArg: IControllerRuntimeId): Promise<void>;
+    private tombstoneSessionStateUnqueued;
+    private applyFlexProjectManagementScratchpad;
+    private applySessionStateTombstone;
+    createTempPassword(ttlMsArg: number): Promise<IMintedTempPassword>;
+    verifyTempPassword(passwordArg: string): Promise<{
+        credentialId: string;
+        expiresAt: Date;
+    } | undefined>;
+    private assertRuntimeConfigMatches;
+    private auditEventsEqual;
+}
+export {};