forkit-connect 0.1.0

package/dist/v1/state.d.ts

@@ -0,0 +1,87 @@
+import type { AgentModelUsageRecord, BuildSession, C2SessionState, C2LifecycleEvent, ConnectIdentityState, ConnectConfig, ConnectEffectiveBindingState, ConnectState, DaemonStatus, DetectedAgent, DetectedModel, DetectedRuntime, DeliveredNotification, EvidenceEvent, LifecycleMonitorRecord, ModelEvolutionCandidate, ModelBinding, PendingReview, RuntimePassport, ServiceEntitlements, SyncQueueItem, VitalityPulseEvent, VitalityPulseSummary } from './types';
+import type { AgentLink } from './types';
+export interface StatePaths {
+    stateDir: string;
+    stateFile: string;
+    legacyStateFile: string;
+    identityPrivateKeyFile: string;
+}
+export declare class LocalStateStore {
+    private readonly paths;
+    private db;
+    constructor(baseDir?: string);
+    getPaths(): StatePaths;
+    ensureInitialized(): ConnectState;
+    readState(): ConnectState;
+    readRawStateFile(): Record<string, unknown> | null;
+    writeState(state: ConnectState): void;
+    updateSessionCredentialMetadata(input: {
+        credentialPresent: boolean;
+        credentialRef: string | null;
+        authStatus: 'missing' | 'authenticated';
+        lastAuthenticatedAt: string | null;
+        updatedAt?: string;
+    }): ConnectState;
+    updateWorkspaceProjectBinding(workspaceId: string | null, projectId: string | null): ConnectState;
+    updateEffectiveBinding(effectiveBinding: ConnectEffectiveBindingState | null): ConnectState;
+    updateConnectConfig(configPatch: Partial<Pick<ConnectConfig, 'discovery_mode' | 'daemon_interval_seconds' | 'notifications_enabled' | 'notification_min_interval_seconds' | 'evolution_bridge_enabled'>>): ConnectState;
+    updateConnectIdentity(identityPatch: Partial<ConnectIdentityState>): ConnectState;
+    updateServiceEntitlements(entitlements: ServiceEntitlements): ConnectState;
+    updateDaemonStatus(statusPatch: Partial<DaemonStatus>): ConnectState;
+    appendC2Events(events: C2LifecycleEvent[]): ConnectState;
+    pruneRedundantPendingC2Events(): number;
+    backfillMissingGaidOnPendingC2Events(gaid: string): number;
+    updateC2SyncStatus(lastSyncAt: string | null, lastSyncError: string | null): ConnectState;
+    /**
+     * Backfill pending events that have no passport_gaid with the supplied gaid.
+     * Events recorded before a model was bound lack a GAID; once binding is
+     * confirmed this promotes them to syncable without altering their content.
+     * Returns the number of events updated.
+     */
+    backfillC2EventsWithGaid(gaid: string): number;
+    markC2EventSynced(eventId: string): ConnectState;
+    markC2EventFailed(eventId: string, errorMessage: string): ConnectState;
+    discardC2Event(eventId: string, errorMessage: string): ConnectState;
+    updatePulseState(summary: VitalityPulseSummary | null, lastError: string | null, pulseEvents?: Array<Omit<VitalityPulseEvent, 'event_id'>>): ConnectState;
+    upsertDetectedRuntime(runtime: DetectedRuntime): ConnectState;
+    upsertRuntimePassport(runtimePassport: RuntimePassport): ConnectState;
+    replaceRuntimePassports(runtimePassports: RuntimePassport[]): ConnectState;
+    upsertC2Session(session: C2SessionState): ConnectState;
+    replaceC2Sessions(sessions: C2SessionState[]): ConnectState;
+    upsertBuildSession(buildSession: BuildSession): ConnectState;
+    upsertDetectedAgent(agent: DetectedAgent): ConnectState;
+    replaceDetectedAgents(agents: DetectedAgent[]): ConnectState;
+    upsertAgentLink(link: AgentLink): ConnectState;
+    upsertAgentModelUsage(record: AgentModelUsageRecord): ConnectState;
+    replaceAgentModelUsage(records: AgentModelUsageRecord[]): ConnectState;
+    replaceDetectedModels(models: DetectedModel[]): ConnectState;
+    replaceEvolutionCandidates(candidates: ModelEvolutionCandidate[]): ConnectState;
+    upsertModelBinding(binding: ModelBinding): ConnectState;
+    replaceModelBindings(bindings: ModelBinding[]): ConnectState;
+    recordDeliveredNotification(notification: DeliveredNotification): ConnectState;
+    addEvidenceEvent(event: Omit<EvidenceEvent, 'id' | 'createdAt'>): ConnectState;
+    enqueue(item: Omit<SyncQueueItem, 'id' | 'attempts' | 'createdAt' | 'nextRetryAt' | 'lastError'>): SyncQueueItem;
+    trimQueueItemsByType(type: SyncQueueItem['type'], keepLatest: number): number;
+    listReadyQueueItems(referenceTime?: Date): SyncQueueItem[];
+    hasPendingPassportDraftForDiscoveryHash(discoveryHash: string, registrationKey?: string | null): boolean;
+    markQueueItemResult(id: string, ok: boolean, errorMessage?: string): void;
+    upsertPendingReview(review: PendingReview): ConnectState;
+    resolvePendingReview(reviewId: string, status: 'confirmed' | 'dismissed' | 'auto_confirmed'): ConnectState;
+    upsertLifecycleMonitorRecord(record: LifecycleMonitorRecord): ConnectState;
+    readIdentityPrivateKey(): string | null;
+    writeIdentityPrivateKey(privateKeyPem: string): void;
+    retireLegacyStateFile(): void;
+    private mutateState;
+    private ensureInitializedInternal;
+    private readStateFromDatabase;
+    private withDatabase;
+    private getDb;
+    private persistState;
+    private loadRawStateRecord;
+    private readLegacyStateFile;
+    private ensureStateDirectory;
+    private tightenStatePathPermissions;
+    private recoverDatabaseFiles;
+    private isRecoverableDatabaseError;
+}
+//# sourceMappingURL=state.d.ts.map