@maudecode/talaria-web 1.18.0 → 1.19.0

package/dist/sessions/relay.d.ts

@@ -1,3 +1,4 @@
+import type { DocumentBackend } from './storage/backend.js';
 import type { StreamRegistry } from './streams.js';
 import type { PendingPrompts } from './pending.js';
 import type { SessionStore } from './store.js';
@@ -18,16 +19,16 @@ export interface RelayConfig {
     publisher_id: string;
     key_id: string;
     private_key_path: string;
+    private_key_document?: string;
     profiles: Record<string, RelayProfile>;
 }
 /** Python `RelayConfig._validated_origin`: a bare origin with no path, query, credentials, or fragment. */
 export declare function validatedOrigin(raw: string, httpsOnly?: boolean): string;
-export declare function relayStatePath(stateDir: string): string;
 /** Python `RelayConfig.from_state`: null when absent or a v1 file (registration is required again); throws on corruption. */
-export declare function loadRelayConfig(stateDir: string): RelayConfig | null;
-export declare function saveRelayConfig(stateDir: string, config: RelayConfig): void;
-/** Python `_profile_identity`: a persistent `pfi_<32 hex>` per profile home, minted on first use (0600). */
-export declare function profileIdentity(profileHome: string): string;
+export declare function loadRelayConfig(documents: DocumentBackend): Promise<RelayConfig | null>;
+export declare function saveRelayConfig(documents: DocumentBackend, config: RelayConfig): Promise<void>;
+/** The profile identity lives in the selected backend, with the JSON adapter retaining its old private file. */
+export declare function profileIdentity(deps: Pick<RelayPublisherDeps, 'documents' | 'profileHome'>, profile: string): Promise<string>;
 /**
  * Profile-scoped browser activity leases; a fresh active lease mutes alerts for that profile.
  * Each tab's entry also fences its sequence number for PRESENCE_FENCE_SECONDS past lease expiry,
@@ -49,6 +50,7 @@ export declare class PresenceLeases {
     };
 }
 export interface RelayPublisherDeps {
+    documents: DocumentBackend;
     registry: StreamRegistry;
     pending: PendingPrompts;
     store: SessionStore;
@@ -76,9 +78,7 @@ export interface RelayState {
 export declare class RelayPublisher {
     readonly config: RelayConfig;
     private readonly deps;
-    private readonly key;
-    private readonly revisionPath;
-    private readonly startedPath;
+    private key;
     private startedUnsupportedLogged;
     private lastRevision;
     private terminal;
@@ -93,27 +93,31 @@ export declare class RelayPublisher {
     private timer;
     private failures;
     constructor(config: RelayConfig, deps: RelayPublisherDeps);
+    initialize(): Promise<void>;
     /** Carry unpublished terminal state, queued views, and the revision floor from the publisher being replaced. */
     inherit(previous: RelayPublisher): void;
-    start(publishInitial?: boolean): void;
+    start(publishInitial?: boolean): Promise<void>;
     stop(): void;
     changed(): void;
     noteTerminal(streamId: string, phase: string): void;
     /** Queue a viewed acknowledgement; the loop sends it after the snapshot carrying the session's terminal state. */
     markViewed(sid: string, profile: string | null): void;
+    /** Bind an unconfigured deletion once, before sending, so retries cannot cross relay or profile identities. */
+    private pendingDeleted;
     /** Send the views queued before the snapshot just published, so the relay already holds every outcome they saw. */
     private flushViews;
     private nextRevision;
     private sleep;
     private run;
     /** Python `build_states`: one row per session with a live or recently terminal run in this profile. */
-    buildStates(profile: string): RelayState[];
+    buildStates(profile: string): Promise<RelayState[]>;
     publishSnapshot(isolatePermanent?: boolean): Promise<void>;
     private publishes;
     /** Validation publish for one newly enrolled profile (Python `publish_profile`). */
     publishProfile(profileId: string, expectedIdentity: string): Promise<void>;
-    private loadStarted;
-    private saveStarted;
+    private parseStarted;
+    private startedDocument;
+    private mutateStarted;
     /** Give each enrolled profile without a ledger entry a floor of now; true when the ledger changed. */
     private trackProfiles;
     /** Record every messageful Web or Agent session that started in an enrolled profile since tracking began. */
@@ -125,7 +129,6 @@ export declare class RelayPublisher {
     private put;
 }
 export interface RelayServiceDeps extends RelayPublisherDeps {
-    stateDir: string;
     env: Record<string, string | undefined>;
     canonicalProfile: (profile: string) => string;
     addListener: (listener: () => void) => () => void;
@@ -142,16 +145,13 @@ export declare class RelayService {
     constructor(deps: RelayServiceDeps);
     current(): RelayPublisher | null;
     /** Python `start_talaria_relay_publisher`: resume from saved state; invalid state disables the publisher. */
-    start(): boolean;
+    start(): Promise<boolean>;
     stop(): void;
     private adopt;
     /** A viewed session clears its finished runs on the relay; without a publisher there is nothing to clear. */
-    markViewed(sid: string): void;
-    /**
-     * A deleted session can never be viewed, so its finished runs are cleared once, under the profile it had (the
-     * store no longer knows it). Later lookups of the same id do not resend.
-     */
-    clearDeleted(sid: string, profile: string | null): void;
+    markViewed(sid: string): Promise<void>;
+    /** Persist before reporting successful deletion, even when publication is unavailable. */
+    clearDeleted(sid: string, profile: string | null): Promise<void>;
     /** Terminal turn events reach the relay even mid-swap (Python `note_talaria_terminal`). */
     noteTerminal(streamId: string, phase: string): void;
     /** Python `configure_talaria_relay_publisher`: validate with a real snapshot before swapping publishers. */