@felan-ai/felan 0.28.4 → 0.30.0

package/dist/client/client.d.ts

@@ -0,0 +1,181 @@
+import { type ControlRequest, type ControlResponse, type DaemonIdentity, type Interaction, type Operation, type OperationParams, type OperationResult, type PresentationEvent, type Response, type ResponseFor } from '@felan-ai/session-protocol';
+import { type DaemonTarget, type ResolvedDaemonTarget } from '@felan-ai/daemon/client';
+import { type SessionState } from './reducer.js';
+import { type BlockedReason, type ClientDiagnostic } from './diagnostics.js';
+import { type TransportConnector } from './transport.js';
+export declare function newRequestId(now?: number): string;
+export type RequestState = {
+    status: 'pending';
+    id: string;
+    op: Operation;
+    attempts: number;
+} | {
+    status: 'accepted' | 'rejected' | 'indeterminate';
+    id: string;
+    op: Operation;
+    attempts: number;
+    response: Response;
+};
+export interface AttachmentState {
+    readonly id: string;
+    readonly session: string;
+    readonly requirePolicy?: 'acp-strict';
+    readonly binding?: string;
+    readonly state: SessionState;
+    /** When the latest snapshot made this attachment live. */
+    readonly liveSince?: number;
+    /** Why the attachment last became blocked. */
+    readonly blocked?: BlockedReason;
+}
+export interface SessionClientOptions {
+    target: DaemonTarget;
+    clientVersion: string;
+    expectedDaemonVersion?: string;
+    expectedComposition?: Pick<NonNullable<OperationResult<'hello'>['composition']>, 'managerPackage' | 'managerVersion' | 'providerDigest'>;
+    kind: OperationParams<'hello'>['kind'];
+    interactionKinds?: OperationParams<'hello'>['interactionKinds'];
+    capabilities?: OperationParams<'hello'>['capabilities'];
+    expected?: DaemonIdentity;
+    connector?: TransportConnector;
+    launch?: {
+        entrypoint: string;
+        timeoutMs?: number;
+        replacing?: DaemonIdentity;
+        hostConfigPath?: string;
+    };
+    requestTimeoutMs?: number;
+    retries?: number;
+    /** Automatic reconnect attempts after an established connection drops; unlimited by default, 0 disables. */
+    reconnectAttempts?: number;
+    /** First automatic reconnect delay; later attempts double it up to `reconnectMaxDelayMs`. */
+    reconnectDelayMs?: number;
+    reconnectMaxDelayMs?: number;
+    /** Receives connection and attachment transitions for troubleshooting; must not throw. */
+    diagnostics?: (event: ClientDiagnostic) => void;
+}
+export declare class SessionClient {
+    private readonly options;
+    readonly target: ResolvedDaemonTarget;
+    private readonly connector;
+    private readonly timeout;
+    private readonly retries;
+    private readonly reconnectLimit;
+    private readonly delay;
+    private readonly maxDelay;
+    private transport;
+    private connecting;
+    private connectingLaunches;
+    private epoch;
+    private closed;
+    private readonly lifetime;
+    private reconnectCount;
+    private reconnectTimer;
+    private reconnectAt;
+    private established;
+    private readyAt;
+    private records;
+    private attachments;
+    private readonly interactionNotifications;
+    private queuedInteractions;
+    private queuedInteractionBytes;
+    private recovering;
+    private listeners;
+    private readonly presentationListeners;
+    private readonly presentationSequences;
+    private pinned;
+    private verifying;
+    private replacing;
+    private mismatchedWork;
+    private negotiated;
+    private connectionState;
+    constructor(options: SessionClientOptions);
+    get status(): "ready" | "blocked" | "closed" | "disconnected" | "connecting" | "incompatible";
+    /** The scheduled automatic reconnect after an established connection dropped; automatic attempts never launch a daemon. */
+    get reconnection(): {
+        attempt: number;
+        retryAt: number;
+    } | undefined;
+    get identity(): {
+        namespaceId: string;
+        instanceId: string;
+        agentDir: string;
+        rootSet: string[];
+    } | undefined;
+    get capabilities(): {
+        composition?: {
+            restartRequired?: boolean;
+            managerPackage: string;
+            managerVersion: string;
+            providerDigest: string;
+            configDigest: string;
+        };
+        capabilities?: ("ui.action" | "ui.status" | "ui.progress" | "ui.document" | "ui.view" | "native.events")[];
+        daemonVersion: string;
+        identity: {
+            namespaceId: string;
+            instanceId: string;
+            agentDir: string;
+            rootSet: string[];
+        };
+        protocol: 1;
+        attachmentId: string;
+        principal: string;
+        operations: string[];
+        interactionKinds: ("select" | "confirm" | "input" | "editor" | "tool_approval" | "dependency" | "form")[];
+    } | undefined;
+    /** Active work on an incompatible daemon, when it could report it; restarting it would interrupt that work. */
+    get incompatibleActiveWork(): number | undefined;
+    getInteractions(options?: {
+        includeSessions?: boolean;
+    }): readonly Interaction[];
+    /** An independent, mutable copy of the attachment; use {@link readAttachment} for frequent reads. */
+    getAttachment(session: string): AttachmentState | undefined;
+    /** The current attachment itself, deeply frozen and shared with every reader; it never changes, later updates replace it. */
+    readAttachment(session: string): AttachmentState | undefined;
+    getRequest(id: string): RequestState | undefined;
+    subscribe(listener: () => void): () => void;
+    subscribePresentation(listener: (event: PresentationEvent) => void): () => void;
+    private emit;
+    private connectTransport;
+    private whileOpen;
+    /** Connects now, resetting automatic backoff; unlike automatic reconnects this starts an absent daemon when `launch` is configured. */
+    connect(options?: {
+        replacing?: DaemonIdentity;
+    }): Promise<OperationResult<'hello'>>;
+    private connectShared;
+    /** An idle daemon from another installation is replaced transparently; one with active work stays incompatible so the caller can ask. */
+    private open;
+    private openOnce;
+    private activeWork;
+    request<O extends Operation>(op: O, params: OperationParams<O>, options?: {
+        session?: string;
+        id?: string;
+    }): Promise<ResponseFor<O>>;
+    private exchange;
+    private transmit;
+    private finish;
+    private receive;
+    private acceptInteraction;
+    attach(session: string, policy?: {
+        requirePolicy?: 'acp-strict';
+    }): Promise<ResponseFor<'attach'>>;
+    retryAttach(session: string): Promise<ResponseFor<'attach'>>;
+    private restore;
+    detach(session: string): Promise<ResponseFor<'detach'>>;
+    private resync;
+    /** Updates an attachment and reports transitions into recovery or a blocked state, keeping why it blocked. A snapshot that cannot go live is a new recovery. */
+    private store;
+    private diagnoseAttach;
+    private diagnose;
+    /** Like connection backoff, the recovery budget renews only after the attachment stayed live longer than the longest reconnect delay, so a flapping session cannot resnapshot forever. */
+    private renewRecoveryBudget;
+    private recover;
+    private lost;
+    /** Schedules the next automatic attempt; outstanding requests stay pending only until an attempt fails. */
+    private retryLater;
+    private cancelReconnect;
+    private settleOutstanding;
+    control(op: ControlRequest['op'], mode?: 'drain' | 'force'): Promise<ControlResponse>;
+    close(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}