@nuvin/session 0.1.0-rc.5

package/dist/client/directory.d.ts

@@ -0,0 +1,141 @@
+import type { HistorySummary, ProfileSummary, ProviderSummary, SessionDescriptor, WorkspaceSummary } from "../protocol/types.ts";
+import type { GetEndpoint } from "./endpoint.ts";
+import { type TransportSocket } from "./socket.ts";
+/**
+ * A configured daemon endpoint. Two forms (web spec §6):
+ * - static: `{url, token}` resolved upfront (local UDS / LAN TCP, unchanged);
+ * - endpoint provider: `getEndpoint()` resolves a FRESH `{url, credential}`
+ *   per connection attempt (cloud relay: POST /api/daemons/:id/connect).
+ */
+export type DirectoryServerConfig = {
+    name: string;
+    url?: string;
+    token?: string;
+    getEndpoint?: GetEndpoint;
+    /** Per-server socket factory (e.g. ws-over-UDS for the local daemon, spec §7). */
+    socketFactory?: (url: string) => TransportSocket;
+};
+/**
+ * Per-server panel status (spec §7): the merged view fills in incrementally
+ * and an unreachable server never blocks the panel.
+ */
+export type DirectoryServerStatus = {
+    state: "connecting";
+} | {
+    state: "online";
+    sessions: SessionDescriptor[];
+} | {
+    state: "offline";
+    error: string;
+};
+export type DirectoryServerView = {
+    name: string;
+    url: string;
+    status: DirectoryServerStatus;
+};
+export type DirectoryView = {
+    servers: DirectoryServerView[];
+};
+export type ServerDirectoryOptions = {
+    servers: DirectoryServerConfig[];
+    /** Test seam / socket override. Defaults to the global WHATWG WebSocket (browsers, node >= 22). */
+    socketFactory?: (url: string) => TransportSocket;
+    /** Connect + handshake deadline per server (ms). Default 5000. */
+    connectTimeoutMs?: number;
+};
+/**
+ * Multi-server session listing for the picker (spec §7). One directory socket
+ * per configured server: hello/welcome handshake (token in the hello frame,
+ * NEVER the URL — spec §4.1), then `list-sessions` and the pre-attach
+ * management commands. Directory sockets never carry session traffic —
+ * attaching to a picked session opens a fresh WebSocketTransport.
+ *
+ * Failure policy (spec §8): auth/version rejections, timeouts, and dropped
+ * connections mark THAT server offline with an actionable message and reject
+ * its in-flight commands; other servers are untouched. There is no automatic
+ * reconnect loop — `refresh()` retries offline servers on demand.
+ */
+export interface ServerDirectory {
+    /** Stable reference between change notifications — safe for useSyncExternalStore. */
+    getView(): DirectoryView;
+    subscribe(listener: () => void): () => void;
+    /** Reconnect offline servers and re-issue list-sessions on online ones. */
+    refresh(): void;
+    /**
+     * Diff-update the server set (web cloud spec §6: the daemon list is re-polled).
+     * New names are added and connected; missing names are closed and removed
+     * (pending commands reject); kept names get their config replaced so future
+     * reconnects use the fresh endpoint provider. Live sockets of kept servers
+     * are untouched.
+     */
+    setServers(configs: DirectoryServerConfig[]): void;
+    createSession(server: string, options: {
+        cwd: string;
+        name?: string;
+        workspace?: string;
+        profile?: string;
+    }): Promise<SessionDescriptor>;
+    /**
+     * Switch-and-resume a cold session (spec §3/§5): issues `resume-session` and
+     * resolves the live `SessionDescriptor` the daemon rehydrated. The cold
+     * transcript carries no cwd, so the caller supplies the cwd the rehydrated
+     * runtime runs in. Idempotent daemon-side (an already-live id resolves to the
+     * existing live session).
+     */
+    resumeSession(server: string, historyId: string, options: {
+        cwd: string;
+        name?: string;
+        workspace?: string;
+        profile?: string;
+    }): Promise<SessionDescriptor>;
+    killSession(server: string, sessionId: string, options?: {
+        delete?: boolean;
+    }): Promise<void>;
+    /** Remote cwd completion for the new-session flow (spec §7). */
+    completePath(server: string, prefix: string): Promise<string[]>;
+    /**
+     * One-shot cold/resumable history for a server (spec §8): issues
+     * `list-history` and resolves the `history-list` reply. The local picker uses
+     * this for its "Local" section instead of a second in-process runtime.
+     */
+    listHistory(server: string, opts?: {
+        profile?: string;
+        cwd?: string;
+    }): Promise<{
+        sessions: HistorySummary[];
+        currentWorkspace?: string;
+    }>;
+    /**
+     * Permanently delete a cold session transcript (spec §8): issues
+     * `delete-history` and resolves on an ok ack. Rejects when the daemon reports
+     * the id is unknown or currently live. After resolving, callers should
+     * re-fetch `listHistory` for an authoritative refresh.
+     */
+    deleteHistory(server: string, historyId: string, opts: {
+        workspace: string;
+        profile?: string;
+    }): Promise<void>;
+    /** List the SELECTED server's workspaces for a profile (spec §7). */
+    listWorkspaces(server: string, opts?: {
+        profile?: string;
+    }): Promise<WorkspaceSummary[]>;
+    /** Create a named workspace under a profile; `root` omitted ⇒ daemon provisions workdir/. */
+    createWorkspace(server: string, opts: {
+        name: string;
+        root?: string;
+        profile?: string;
+    }): Promise<WorkspaceSummary>;
+    /** List the SELECTED server's config profiles (per-daemon) for the new-session screen. */
+    listProfiles(server: string): Promise<ProfileSummary[]>;
+    /** List the SELECTED server's configured providers (web spec §7). */
+    listProviders(server: string): Promise<ProviderSummary[]>;
+    /** Set the server's default provider; the daemon reloads running sessions like reload-config. */
+    setDefaultProvider(server: string, providerId: string): Promise<void>;
+    /** Store a provider credential on the daemon (transits the wire; stored only daemon-side). */
+    setProviderAuth(server: string, providerId: string, credential: string): Promise<void>;
+    /** Remove a provider's stored credential on the daemon. */
+    clearProviderAuth(server: string, providerId: string): Promise<void>;
+    close(): void;
+}
+export declare function createServerDirectory(options: ServerDirectoryOptions): ServerDirectory;
+//# sourceMappingURL=directory.d.ts.map

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

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

package/dist/client/endpoint.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Endpoint-provider seam (relay spec §9.1, web spec §6). Relay connections
+ * cannot know their URL or credential upfront: every attempt POSTs the
+ * server's connect endpoint for a fresh single-use channel URL + grant.
+ * `getEndpoint()` is that hook — the transport/directory call it before EVERY
+ * connection attempt (initial and each reconnect) so the reconnect loop itself
+ * stays unchanged. Static LAN/UDS configs keep passing `{url, token}` and
+ * never touch this. The credential is an opaque string either way — grant
+ * crypto never enters browser-safe client code.
+ */
+export type TransportCredential = {
+    token: string;
+} | {
+    grant: string;
+};
+export type TransportEndpoint = {
+    url: string;
+    credential: TransportCredential;
+};
+export type GetEndpoint = () => Promise<TransportEndpoint>;
+/**
+ * Thrown by a GetEndpoint when the failure is PERMANENT — the daemon is
+ * revoked/unregistered (connect endpoint 404s), so backoff retries can never
+ * succeed (web spec §10 "Revoked daemon"). The transport treats it like a
+ * server-initiated detach: terminal close + onDetached(reason). Transient
+ * failures (network, 409 daemon-offline, 5xx) stay plain errors and keep the
+ * normal retry-with-backoff behavior.
+ */
+export declare class TerminalEndpointError extends Error {
+    readonly reason: string;
+    constructor(reason: string, message?: string);
+}
+//# sourceMappingURL=endpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/client/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEjF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAK7C"}

package/dist/client/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./directory.ts";
+export * from "./endpoint.ts";
+export * from "./session-client.ts";
+export * from "./socket.ts";
+export * from "./transport.ts";
+export * from "./uds-socket.ts";
+export * from "./websocket.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}