@rynx-ai/daemon 0.1.0 → 0.1.10-beta.2

package/dist/remote-runtime-connection-manager.d.ts

@@ -0,0 +1,103 @@
+import { type RuntimeBrowserInspectTarget } from "@rynx-ai/protocol/runtime-browser-inspect";
+import { type RuntimeBrowserSurfaceOpenFrame } from "@rynx-ai/protocol/runtime-browser-surface";
+import { type DirectRuntimeConnection, type DirectRuntimeBrowserInspectConnection, type DirectRuntimeBrowserSurfaceConnection, type DirectRuntimeCredential } from "@rynx-ai/remote-runtime-client";
+import type { DirectRuntimeBrowserSurfaceHost, DirectRuntimeEmulatorSurfaceHost, RemoteRuntimeDispatcher, RuntimeConnectionLease, RuntimeConnectionResolverHost } from "@rynx-ai/server";
+import { type FileRemoteRuntimeCredentialStore, type RemoteRuntimeClientCredential } from "./remote-runtime-credential-store.js";
+import { type RemoteRuntimeTarget, type RemoteRuntimeTargetStore } from "./remote-runtime-target-store.js";
+export type RuntimeConnectionManagerErrorCode = "invalid_target" | "not_found" | "authentication_failed" | "identity_mismatch" | "incompatible" | "protocol_error" | "deadline_exceeded" | "outcome_unknown" | "closed" | "cancelled";
+export declare class RuntimeConnectionManagerError extends Error {
+    readonly code: RuntimeConnectionManagerErrorCode;
+    readonly outcome: "not_started" | "unknown" | undefined;
+    constructor(code: RuntimeConnectionManagerErrorCode, message: string, options?: ErrorOptions & {
+        outcome?: "not_started" | "unknown";
+    });
+}
+interface RuntimeTargetReader {
+    get(selector: string): RemoteRuntimeTarget | undefined;
+}
+interface RuntimeCredentialReader {
+    load(credentialRef: string): Promise<RemoteRuntimeClientCredential>;
+}
+interface RuntimeClientAdapter {
+    connect(credential: DirectRuntimeCredential): Promise<DirectRuntimeConnection>;
+    openBrowserInspect?(credential: DirectRuntimeCredential, target: RuntimeBrowserInspectTarget, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<DirectRuntimeBrowserInspectConnection>;
+    openBrowserSurface?(credential: DirectRuntimeCredential, frame: RuntimeBrowserSurfaceOpenFrame, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<DirectRuntimeBrowserSurfaceConnection>;
+}
+export interface DaemonRuntimeConnectionManagerOptions {
+    localDaemonId: string;
+    dispatcher: Pick<RemoteRuntimeDispatcher, "dispatch" | "openSessionEvents" | "openSessionTerminal">;
+    localBrowserSurface?: DirectRuntimeBrowserSurfaceHost;
+    localEmulatorSurface?: DirectRuntimeEmulatorSurfaceHost;
+    targets: Pick<RemoteRuntimeTargetStore, "get"> | RuntimeTargetReader;
+    credentials: Pick<FileRemoteRuntimeCredentialStore, "load"> | RuntimeCredentialReader;
+    client?: RuntimeClientAdapter;
+    idleTtlMs?: number;
+    maxIdleConnections?: number;
+}
+/**
+ * Daemon-owned Local/Direct Runtime resolver.
+ *
+ * Application callers receive only a logical target and a typed call surface;
+ * target routes and client credentials never cross this boundary. Direct
+ * connections are reused while healthy, but a failed call is never retried.
+ */
+export declare class DaemonRuntimeConnectionManager implements RuntimeConnectionResolverHost {
+    private readonly options;
+    private readonly client;
+    private readonly idleTtlMs;
+    private readonly maxIdleConnections;
+    private readonly slots;
+    private readonly generations;
+    /** Independent inspect sockets must outlive shared control-channel eviction. */
+    private readonly browserInspectClosers;
+    private localStatusSnapshot?;
+    private closed;
+    private managerClosePromise?;
+    constructor(options: DaemonRuntimeConnectionManagerOptions);
+    acquire(selector: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<RuntimeConnectionLease>;
+    /** Synchronously detaches the generation, then closes it asynchronously. */
+    invalidate(daemonId: string): Promise<void>;
+    close(): Promise<void>;
+    private localLease;
+    private callLocal;
+    private readLocalStatus;
+    private dispatchLocalRequest;
+    private rememberLocalStatus;
+    private assertMethodSupported;
+    private assertSessionEventsSupported;
+    private assertSessionTerminalSupported;
+    private directLease;
+    private wrapDirectSessionSubscription;
+    private openDedicatedDirectTerminal;
+    private openDedicatedDirectBrowserSurface;
+    private openDedicatedDirectBrowserInspect;
+    private openDedicatedDirectEmulatorSurface;
+    private slotFor;
+    private openDirectConnection;
+    private evict;
+    private closeSlot;
+    private trackDedicatedTerminal;
+    private trackDedicatedBrowserSurface;
+    private trackDedicatedBrowserInspect;
+    private registerBrowserInspectCloser;
+    private closeBrowserInspects;
+    private trackDedicatedEmulatorSurface;
+    private registerDedicatedCloser;
+    private scheduleIdleClose;
+    private pruneIdleConnections;
+    private cancelIdleTimer;
+    private assertOpen;
+    private assertSlotCurrent;
+    private isSlotCurrent;
+    private generation;
+    private bumpGeneration;
+}
+export {};