@nuvin/components 0.1.0

package/dist/session/client-commands.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Client-handled slash commands for the web surface — intercepted in App.tsx
+ * BEFORE the wire (mirrors the TUI's client-slash-commands.ts). These never
+ * round-trip to the host; everything else is routed to `client.runSlashCommand`.
+ */
+import type { SlashCommandDescriptor } from "@nuvin/session/protocol";
+/** Actions the web client-side slash commands drive. */
+export type WebClientActions = {
+    /** `/theme` — toggle light/dark via the existing useThemeMode toggler. */
+    toggleTheme(): void;
+};
+/**
+ * Descriptors for client-handled web slash commands. Merged with
+ * `snapshot.serverCommands` for Composer autocomplete. `/new` is intentionally
+ * absent — on web it is a SERVER command and already appears in serverCommands().
+ */
+export declare function webClientCommandDescriptors(_actions: WebClientActions): SlashCommandDescriptor[];
+/**
+ * Attempt to handle `raw` as a client-side slash command.
+ *
+ * Returns `true` when the command was consumed (caller must NOT forward to
+ * `client.runSlashCommand`). Returns `false` for unknown commands so the caller
+ * can route them to the server.
+ */
+export declare function handleWebClientSlashCommand(raw: string, actions: WebClientActions): boolean;
+//# sourceMappingURL=client-commands.d.ts.map

package/dist/session/client-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-commands.d.ts","sourceRoot":"","sources":["../../src/session/client-commands.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0EAA0E;IAC1E,WAAW,IAAI,IAAI,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,sBAAsB,EAAE,CAEhG;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAW3F"}

package/dist/session/commands.d.ts

@@ -0,0 +1,9 @@
+import type { AskUserAnswers } from "@nuvin/agent-core/shared";
+import type { WebApprovalDecision } from "./types";
+export declare function sendSubmit(text: string, tabKey?: string): void;
+export declare function sendApproval(decision: WebApprovalDecision, comment?: string, tabKey?: string): void;
+export declare function sendAnswer(answers: AskUserAnswers, tabKey?: string): void;
+export declare function sendAbort(tabKey?: string): void;
+export declare function sendDequeue(queuedId: string, tabKey?: string): void;
+export declare function sendNewSession(tabKey?: string): void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/session/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/session/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAW9D;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAQN;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAMzE;AAED,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAInE;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpD"}

package/dist/session/directory-source.d.ts

@@ -0,0 +1,101 @@
+import type { GetEndpoint } from "@nuvin/session/client";
+import type { HistoryPage, SessionDescriptor, SessionSnapshot, WorkspaceSummary } from "@nuvin/session/protocol";
+/** Display-only daemon metadata (cloud): human name + presence (web spec §6). */
+export type DaemonMeta = {
+    id: string;
+    label: string;
+    online: boolean;
+    lastSeenAt: string | null;
+    /**
+     * Live sessions from the REST snapshot (spec §4.3/§5.1); [] when none / local mode.
+     * OPTIONAL so existing `DaemonMeta` literals (e.g. `use-directory.test.tsx`
+     * mock-source fixtures) stay valid and out of this phase's scope; every reader
+     * uses `m?.activeSessions ?? []`.
+     */
+    activeSessions?: SessionDescriptor[];
+};
+/**
+ * A daemon entry the browser directory can dial: static {url,token} (local)
+ * or an endpoint provider (cloud relay). Structurally DirectoryServerConfig
+ * minus socketFactory (the browser supplies its own). WebServerEntry
+ * (required url+token) is assignable to this, so the local source is unchanged.
+ */
+export type WebDirectoryEntry = {
+    name: string;
+    url?: string;
+    token?: string;
+    getEndpoint?: GetEndpoint;
+};
+export type DirectorySnapshot = {
+    entries: WebDirectoryEntry[];
+    meta?: Map<string, DaemonMeta>;
+    defaultSessionId?: string;
+};
+/**
+ * Directory re-sourcing seam (web spec §6/§9): the composition root picks the
+ * implementation — local GET /api/servers vs cloud GET /api/daemons — and
+ * connectDirectory/refreshDirectory stay implementation-blind.
+ */
+export interface DirectorySource {
+    load(): Promise<DirectorySnapshot>;
+    /**
+     * Read-only transcript of a cold session over REST (spec §5.1). Present on the
+     * cloud source (GET /api/daemons/:id/transcript/:historyId); absent on the
+     * local/mock sources until Phase 7. Readers guard `source?.fetchTranscript`.
+     */
+    fetchTranscript?(server: string, historyId: string, opts?: {
+        workspace?: string;
+        profile?: string;
+    }): Promise<SessionSnapshot>;
+    /**
+     * Delete a session (live or cold) over REST (spec §5.1/§5.5). Present on the
+     * cloud source (DELETE /api/daemons/:id/sessions/:historyId); absent on the
+     * local/mock sources until Phase 7. Readers guard `source?.deleteSession`.
+     */
+    deleteSession?(server: string, historyId: string, opts?: {
+        workspace?: string;
+        profile?: string;
+    }): Promise<void>;
+    /**
+     * Paginated cold-history over REST (spec §5.1). Present on the cloud source
+     * (GET /api/daemons/:id/history); absent on local/mock until Phase 7. Readers
+     * guard `source?.fetchHistory`.
+     */
+    fetchHistory?(server: string, opts?: {
+        profile?: string;
+        cwd?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<HistoryPage>;
+    /**
+     * List the daemon's workspaces over REST (spec §5.1/§7). Present on the cloud
+     * source (GET /api/daemons/:id/workspaces); absent on the local/mock sources
+     * until Phase 7. Readers guard `source?.listWorkspaces`. Mirrors the WS
+     * directory client's listWorkspaces so the App wiring swaps cleanly.
+     */
+    listWorkspaces?(server: string, opts?: {
+        profile?: string;
+    }): Promise<WorkspaceSummary[]>;
+    /**
+     * Create a workspace over REST (spec §5.1/§7 — list + create only). Present on
+     * the cloud source (POST /api/daemons/:id/workspaces); absent on local/mock
+     * until Phase 7. Readers guard `source?.createWorkspace`.
+     */
+    createWorkspace?(server: string, opts: {
+        name: string;
+        root?: string;
+        profile?: string;
+    }): Promise<WorkspaceSummary>;
+}
+/**
+ * Local source: same-origin GET /api/servers for the directory, plus the SAME
+ * read-only/management REST methods the cloud source has (spec §4.5). The methods
+ * dial the daemon's own HTTP base (derived from the entry ws url) with the entry
+ * token as a bearer — the browser reaches the daemon directly, exactly as it does
+ * for the ws attach. `getActiveSource()` therefore carries these in local mode,
+ * so every Phase 3/5/6 consumer takes the REST path uniformly with cloud.
+ */
+export declare function createLocalDirectorySource(deps?: {
+    fetchImpl?: typeof fetch;
+}): DirectorySource;
+//# sourceMappingURL=directory-source.d.ts.map

package/dist/session/directory-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-source.d.ts","sourceRoot":"","sources":["../../src/session/directory-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAIjC,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACtC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnC;;;;OAIG;IACH,eAAe,CAAC,CACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B;;;;OAIG;IACH,aAAa,CAAC,CACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;;OAIG;IACH,YAAY,CAAC,CACX,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACzE,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB;;;;;OAKG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC1F;;;;OAIG;IACH,eAAe,CAAC,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AASD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACtC,eAAe,CAoHjB"}

package/dist/session/directory-status.d.ts

@@ -0,0 +1,8 @@
+import type { DirectoryView } from "@nuvin/session/client";
+/**
+ * Returns true iff the named server exists in `view` and its status.state is
+ * "online". Used by the StartScreen guard to disable autocomplete and block
+ * Start when the target server is offline or still connecting.
+ */
+export declare function isServerOnline(view: DirectoryView, server: string): boolean;
+//# sourceMappingURL=directory-status.d.ts.map

package/dist/session/directory-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-status.d.ts","sourceRoot":"","sources":["../../src/session/directory-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAM3D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG3E"}

package/dist/session/directory.d.ts

@@ -0,0 +1,41 @@
+import { type ServerDirectory, type TransportSocket } from "@nuvin/session/client";
+import type { WebDirectoryEntry } from "./directory-source";
+/**
+ * Serializable daemon entry handed to the browser by GET /api/servers
+ * (the CLI's WebServerEntry, spec §1). Structurally a DirectoryServerConfig
+ * WITHOUT a socketFactory — the browser supplies its own (browserSocketFactory).
+ * The token rides the hello frame, never the URL.
+ */
+export type WebServerEntry = {
+    name: string;
+    url: string;
+    token: string;
+};
+/** Parsed GET /api/servers payload. */
+export type ServersResponse = {
+    servers: WebServerEntry[];
+    /** Pre-provisioned Local session for first-paint attach (later phase). */
+    defaultSessionId?: string;
+};
+export declare function isServersResponse(value: unknown): value is ServersResponse;
+/**
+ * Fetch the daemon directory over same-origin HTTP (localhost-gated by the CLI).
+ * Mirrors fetchCredentials: no-store, ok-guard, structural validation. The
+ * bearer tokens it returns are only safe because the endpoint is origin-gated.
+ */
+export declare function fetchServers(): Promise<ServersResponse>;
+/** The browser's per-server socket factory: a native WHATWG WebSocket (spec §2). */
+export declare function browserSocketFactory(url: string): TransportSocket;
+export type BuildBrowserDirectoryOptions = {
+    /** Test seam / override; defaults to browserSocketFactory. */
+    socketFactory?: (url: string) => TransportSocket;
+    connectTimeoutMs?: number;
+};
+/**
+ * Build a browser ServerDirectory from the resolved /api/servers entries. Each
+ * entry has no per-server socketFactory, so the directory falls back to the
+ * supplied (WHATWG) factory for every server — one persistent daemon socket
+ * each, surviving session switches (the session attach is a separate socket).
+ */
+export declare function buildBrowserDirectory(servers: WebDirectoryEntry[], options?: BuildBrowserDirectoryOptions): ServerDirectory;
+//# sourceMappingURL=directory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/session/directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAQ5D;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAYF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E;AAED;;;;GAIG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAU7D;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAEjE;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,8DAA8D;IAC9D,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,CAAC;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAAE,EAC5B,OAAO,GAAE,4BAAiC,GACzC,eAAe,CAQjB"}

package/dist/session/index.d.ts

@@ -0,0 +1,16 @@
+export type { WorkflowViewState } from "@nuvin/session/protocol";
+export type { WebClientActions } from "./client-commands";
+export { handleWebClientSlashCommand, webClientCommandDescriptors } from "./client-commands";
+export { sendAbort, sendAnswer, sendApproval, sendDequeue, sendNewSession, sendSubmit, } from "./commands";
+export { type BuildBrowserDirectoryOptions, browserSocketFactory, buildBrowserDirectory, fetchServers, type ServersResponse, type WebServerEntry, } from "./directory";
+export type { DaemonMeta, DirectorySnapshot, DirectorySource, WebDirectoryEntry, } from "./directory-source";
+export { createLocalDirectorySource } from "./directory-source";
+export { snapshotFromSessionState } from "./snapshot";
+export type { TabState } from "./store";
+export { createDraftTab, ensureDraftTab, setForegroundKey, swapTabKey, useSessionStore, useTab, useTabDraft, } from "./store";
+export type { SessionRouteDeps, StartSessionOptions } from "./transport";
+export { attachedTabKeys, attachSession, connectedClient, connectTransport, createSessionThenSwitch, detachTab, disconnectTransport, ensureAttached, focusTab, getResumedHistoryIds, openColdTranscript, reportError, resetEnsureAttachedForTests, resolveSessionRoute, resumeColdViewingTab, resumeThenSwitch, startSession, switchSession, } from "./transport";
+export type { BasicWebMessage, JsonObject, JsonValue, ToolMessageStatus, ToolWebMessage, WebApprovalDecision, WebApprovalSnapshot, WebMessage, WebSessionCredentials, WebSessionSnapshot, } from "./types";
+export { acquireDirectoryLink, connectDirectory, desiredLinkNames, disconnectDirectory, getActiveSource, getDaemonMeta, getDefaultSessionId, getDirectory, getDirectoryError, getServerEntries, getServerEntry, isServerOnline, refreshDirectory, useAllDirectoryLinks, useDaemonMeta, useDirectory, useDirectoryLink, usePickerPoll, } from "./use-directory";
+export { type UseSessionTransportOptions, useSessionTransport } from "./use-session-transport";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,4BAA4B,EACjC,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,MAAM,EACN,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EACL,eAAe,EACf,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,SAAS,EACT,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/session/snapshot.d.ts

@@ -0,0 +1,11 @@
+import type { SessionViewState, SlashCommandDescriptor } from "@nuvin/session/protocol";
+import type { WebSessionSnapshot } from "./types";
+/**
+ * Project the replicated SessionViewState (built by the shared
+ * reduceSessionEvent — parity by construction) into the view shape the web
+ * components render. Tool rows hidden by the anti-flash reducer (a pending
+ * approval's sole representation is the approval card, and rejected tools
+ * never ran — spec §4.5) are filtered out of the transcript.
+ */
+export declare function snapshotFromSessionState(state: SessionViewState, serverCommands?: SlashCommandDescriptor[]): WebSessionSnapshot;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/session/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/session/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAExF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,gBAAgB,EACvB,cAAc,GAAE,sBAAsB,EAAO,GAC5C,kBAAkB,CA0BpB"}

package/dist/session/store.d.ts

@@ -0,0 +1,96 @@
+import type { WebSessionSnapshot } from "./types";
+export interface TabState {
+    server: string;
+    sessionId: string;
+    title: string;
+    snapshot: WebSessionSnapshot | null;
+    connected: boolean;
+    error: string | null;
+    unread: number;
+    lastViewedAt: number;
+    isDraft?: boolean;
+    draftCwd?: string;
+    coldHistoryId?: string;
+    /**
+     * True when this tab is a read-only REST transcript (spec §5.2): no socket,
+     * `connected: false`, composer enabled, never in the LRU attach set. Cleared
+     * when the tab is promoted to live via swapTabKey.
+     */
+    coldViewing?: boolean;
+    unreachable?: boolean;
+}
+type SessionStore = {
+    tabs: Map<string, TabState>;
+    /**
+     * Composer drafts, keyed by tabKey — deliberately a SEPARATE slice from
+     * `tabs` (A2). Typing mutates only this Map, so the `tabs` Map that App/TabBar
+     * subscribe to stays referentially stable and the whole shell no longer
+     * re-renders on every keystroke. Cleaned up alongside the tab in
+     * removeTab/swapTabKey.
+     */
+    drafts: Map<string, string>;
+    foregroundKey: string | null;
+    sidebarCollapsed: boolean;
+    setSidebarCollapsed: (value: boolean) => void;
+    draft: string;
+    setDraft: (draft: string) => void;
+    upsertTab: (tabKey: string, init: Pick<TabState, "server" | "sessionId"> & Partial<TabState>) => void;
+    removeTab: (tabKey: string) => void;
+    setForegroundKey: (tabKey: string | null) => void;
+    setTabSnapshot: (tabKey: string, s: WebSessionSnapshot | ((p: WebSessionSnapshot | null) => WebSessionSnapshot)) => void;
+    setTabConnected: (tabKey: string, c: boolean) => void;
+    setTabError: (tabKey: string, e: string | null) => void;
+    setTabDraft: (tabKey: string, text: string) => void;
+    bumpTabViewed: (tabKey: string) => void;
+    createDraftTab: (server: string, opts?: {
+        cwd?: string;
+    }) => string;
+    swapTabKey: (oldKey: string, next: {
+        server: string;
+        sessionId: string;
+    }) => string;
+};
+export declare const useSessionStore: import("zustand").UseBoundStore<import("zustand").StoreApi<SessionStore>>;
+/**
+ * Standalone export so callers (route components, ensureAttached, index.ts) can
+ * set the URL-derived foreground key without reaching through the store action.
+ */
+export declare function setForegroundKey(key: string | null): void;
+/**
+ * Standalone export so callers (and index.ts) can import createDraftTab without
+ * going through the store action directly. Delegates to the store action.
+ */
+export declare function createDraftTab(server: string, opts?: {
+    cwd?: string;
+}): string;
+/**
+ * Standalone export so callers (and index.ts) can import swapTabKey without
+ * going through the store action directly. Delegates to the store action.
+ */
+export declare function swapTabKey(oldKey: string, next: {
+    server: string;
+    sessionId: string;
+}): string;
+/**
+ * Return the tabKey of `server`'s current draft tab (most recently viewed),
+ * creating one when none exists. <DraftView> resolves /d/:daemon/new through
+ * this: one addressable draft per daemon; a page reload starts a fresh draft
+ * because the tabs map is rebuilt empty.
+ */
+export declare function ensureDraftTab(server: string, opts?: {
+    cwd?: string;
+}): string;
+/**
+ * Reactive accessor for a single pool row by URL id (spec §6). Returns the
+ * TabState for `${daemon}::${sessionId}`, or undefined. Replaces the deleted
+ * global facade: components read THEIR session by the URL's params.
+ */
+export declare function useTab(daemon: string | null | undefined, sessionId: string | null | undefined): TabState | undefined;
+/**
+ * Reactive accessor for a single tab's composer draft (A2). Reads the dedicated
+ * `drafts` slice, so a keystroke re-renders only the subscribing Composer — not
+ * the `tabs`-Map subscribers (App, TabBar).
+ */
+export declare function useTabDraft(tabKey: string | null): string;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/session/store.d.ts.map

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

package/dist/session/tool-timing.d.ts

@@ -0,0 +1,14 @@
+import type { WebSessionSnapshot } from "./types";
+/**
+ * Tracks per-tool-call start/complete timestamps as snapshots arrive from the
+ * server. Mutates and re-emits a snapshot where each tool message has its
+ * `startedAt` / `completedAt` fields populated.
+ *
+ * The tracker is stateful across snapshots so timestamps remain stable.
+ */
+export declare function createTimingTracker(now?: () => number): {
+    annotate: (snapshot: WebSessionSnapshot) => WebSessionSnapshot;
+    reset: () => void;
+};
+export type TimingTracker = ReturnType<typeof createTimingTracker>;
+//# sourceMappingURL=tool-timing.d.ts.map

package/dist/session/tool-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-timing.d.ts","sourceRoot":"","sources":["../../src/session/tool-timing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAOjF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,MAAiB;yBAOlC,kBAAkB,KAAG,kBAAkB;iBAJjD,IAAI;EAkEvB;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/session/transport.d.ts

@@ -0,0 +1,187 @@
+import { type SessionClient, type WebSocketClientTransport } from "@nuvin/session/client";
+import type { DirectorySource } from "./directory-source";
+import type { WebSessionCredentials } from "./types";
+/** Option shape for startSession — matches directory.createSession's create-time knobs (R1). */
+export type StartSessionOptions = {
+    cwd: string;
+    workspace?: string;
+    profile?: string;
+};
+/** Per-connection registry entry (replaces the module-level singletons). */
+interface Connection {
+    client: SessionClient;
+    transport: WebSocketClientTransport;
+    /** Bumped each time this tabKey's connection is replaced or closed. Stale callbacks no-op. */
+    generation: number;
+    server: string;
+    sessionId: string;
+}
+/**
+ * Returns a snapshot copy of the in-session resumedHistoryIds map so callers
+ * cannot mutate the module-level map.
+ */
+export declare function getResumedHistoryIds(): Map<string, string>;
+/**
+ * Test-only accessor — returns the set of tabKeys currently in the registry.
+ * Exported so transport.test.ts can assert LRU sweep counts without reaching into internals.
+ */
+export declare function attachedTabKeys(): Map<string, Connection>;
+export declare function reportError(error: unknown, tabKey?: string): void;
+/**
+ * Attach (or re-attach) to a given session. Closes any existing connection
+ * for this tab before opening the next; switching NEVER kills the prior
+ * session on the daemon (detach ≠ stop).
+ * Derives tabKey, opens/swaps the connection, upserts the tab row, sets it active.
+ * After opening, runs the LRU sweep to cap attached connections at MAX_ATTACHED.
+ */
+export declare function attachSession(credentials: WebSessionCredentials & {
+    server?: string;
+}, opts?: {
+    activate?: boolean;
+}): void;
+/**
+ * Focus a tab by tabKey. If the tab has a live connection (non-stale), just
+ * flips foregroundKey (no re-attach). If the tab is stale (row exists but no
+ * registry connection), re-opens the connection via attachSession so the daemon
+ * re-sends the snapshot (replay). Resolves {url,token} from the retained server
+ * entries (populated by connectTransport). Per spec §3: no kill-session on focus.
+ */
+export declare function focusTab(tabKey: string): void;
+/**
+ * Bootstrap the browser from GET /api/servers (replaces the old /api/session
+ * connectTransport). Builds the Phase-3 directory with ZERO links; mounted route
+ * components (<Picker>/<DaemonLayout>) acquire the links they need. Does NOT
+ * auto-attach any session: the picker (home view) is the landing screen, and
+ * reload restores only the URL's session (spec §8). Idempotent: returns
+ * immediately if a session client or directory already exist.
+ */
+export declare function connectTransport(source?: DirectorySource): void;
+/**
+ * Disconnect all session connections AND tear down the directory.
+ * Clears the entire registry + tabs + foregroundKey.
+ */
+export declare function disconnectTransport(): void;
+/**
+ * Switch to a different session on the named server. Resolves {url,token} from
+ * the retained server entries (populated by connectTransport). Does NOT send
+ * kill-session — switching detaches locally but never kills the prior session
+ * on the daemon.
+ */
+export declare function switchSession(server: string, sessionId: string): void;
+/**
+ * Create a new session via the directory, then attach to it. The directory
+ * uses its own daemon socket; this opens a fresh session-attach socket.
+ * Rejects if the directory is not yet bootstrapped.
+ */
+export declare function createSessionThenSwitch(server: string, options: {
+    cwd: string;
+    name?: string;
+    workspace?: string;
+}): Promise<void>;
+/**
+ * Resume an existing session via the directory, then attach to it. Resume is
+ * idempotent daemon-side (de-dupes an already-live session), so calling this
+ * on an already-live session resolves the existing descriptor and switches to
+ * it — no duplicate session.
+ *
+ * R8: records historyId → descriptor.id in the in-session resumedHistoryIds map
+ * so the launcher can dedup cold rows that have already been resumed into a live tab.
+ */
+export declare function resumeThenSwitch(server: string, historyId: string, options: {
+    cwd: string;
+    name?: string;
+    workspace?: string;
+}): Promise<void>;
+/**
+ * Open a COLD session's transcript READ-ONLY over REST (spec §5.2): fetch the
+ * snapshot via the active DirectorySource, project it, and upsert a cold-viewing
+ * tab (no socket, connected:false, composer enabled). Never opens an attach
+ * connection, so it never counts toward the LRU attach cap. Both local and cloud
+ * sources serve read-only transcripts over REST now (spec §4.5); a missing
+ * method means a mock/uninitialised source, and the fetch itself may fail.
+ */
+export declare function openColdTranscript(server: string, historyId: string, opts?: {
+    workspace?: string;
+    profile?: string;
+}): Promise<void>;
+/**
+ * Promote a cold-viewing tab to live on composer submit (spec §5.2): resume the
+ * cold session, swap the cold-viewing tab to the resumed session's NEW id, open
+ * the attach connection, replace the URL, and deliver the queued composer input
+ * once connected. Rejects if the directory is not connected or the server is
+ * unknown (the caller keeps the typed input + stays read-only on rejection).
+ */
+export declare function resumeColdViewingTab(server: string, historyId: string, text: string, options: {
+    cwd: string;
+    workspace?: string;
+}): Promise<void>;
+/**
+ * Detach a tab: close its registry connection if present, then remove the tab
+ * row from the store. Does NOT send kill-session — detach ≠ stop (spec §5/D2).
+ */
+export declare function detachTab(tabKey: string): void;
+export declare function connectedClient(tabKey?: string): SessionClient | null;
+/**
+ * Lazily create a session and attach to it.
+ *
+ * If `opts.replaceDraftKey` is provided, the draft tab at that key is swapped
+ * to the new sessionId (preserving bar position + active pointer) BEFORE the
+ * attach connection is opened — so there is never a transient double-tab.
+ * The caller is responsible for any first-prompt `sendSubmit` (R2 — no import
+ * from commands.ts).
+ *
+ * Returns `{ tabKey, sessionId }` so the caller can route `sendSubmit`.
+ */
+export declare function startSession(server: string, options: StartSessionOptions, opts?: {
+    replaceDraftKey?: string;
+}): Promise<{
+    tabKey: string;
+    sessionId: string;
+}>;
+/** Session-branch resolution inputs (mirrors route-sync's applyRoute deps, session-only). */
+export type SessionRouteDeps = {
+    status: "loading" | "error" | "ready";
+    serverNames: ReadonlySet<string>;
+    /** Live sessions from the connected socket view (empty while connecting). */
+    liveSessionIds: ReadonlySet<string>;
+    /** REST-snapshot presence; "absent" in local mode (no daemon meta). */
+    presence: "online" | "offline" | "absent";
+    /**
+     * The daemon's directory-link connection state (spec §5.3 — local liveness
+     * comes from the socket, not REST meta). "absent" = no link in the view yet
+     * (unacquired, or the acquire's coalescing microtask hasn't reconciled). Used
+     * to hold instead of bounce mid-connect, and to detect a local (meta-less)
+     * online link that means COLD.
+     */
+    linkState: "connecting" | "online" | "offline" | "absent";
+    /** REST-snapshot active-session ids (authoritative before the socket connects). */
+    activeSessionIds: ReadonlySet<string>;
+    hasTab: boolean;
+    focusTab: () => void;
+    switchSession: () => void;
+    beginColdResolve: () => void;
+    navigate: (to: string, opts: {
+        replace: boolean;
+        toast?: string;
+    }) => void;
+};
+/**
+ * Pure session-route decision table (spec §5.1). A warm pool hit (hasTab)
+ * focuses instantly regardless of directory status; otherwise resolve against
+ * the authoritative REST snapshot (union with the live socket) into
+ * attach / cold-read-only / unreachable-gate / not-found-bounce.
+ */
+export declare function resolveSessionRoute(daemon: string, sessionId: string, deps: SessionRouteDeps): void;
+/** Test-only: clear the in-flight cold-resolve guard between tests. */
+export declare function resetEnsureAttachedForTests(): void;
+/**
+ * Resolve the session URL (spec §5.1). Called by <SessionView> on mount / param
+ * change (and re-run when the directory view / meta updates). Reads the live
+ * directory view + REST daemon meta + the store, then drives resolveSessionRoute.
+ * The attach path is idempotent: attachSession upserts the tab synchronously, so
+ * a StrictMode second invoke hits the hasTab → focusTab branch (one dial); the
+ * cold path is idempotent via coldResolveInFlight (one fetch).
+ */
+export declare function ensureAttached(daemon: string, sessionId: string): void;
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/session/transport.d.ts.map

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

package/dist/session/types.d.ts

@@ -0,0 +1,73 @@
+import type { GetEndpoint } from "@nuvin/session/client";
+import type { ApprovalDescriptor, QuestionDescriptor, QueuedMessageView, SlashCommandDescriptor, WorkflowViewState } from "@nuvin/session/protocol";
+import type { ToolMessageStatus as SessionToolMessageStatus, ToolTuiMessage, TuiMessage } from "@nuvin/session/state";
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type JsonValue = JsonObject | JsonValue[] | boolean | null | number | string;
+export type ToolMessageStatus = SessionToolMessageStatus;
+export type WebMessage = TuiMessage;
+export type ToolWebMessage = ToolTuiMessage;
+export type BasicWebMessage = Exclude<TuiMessage, ToolTuiMessage>;
+export type WebApprovalDecision = "a" | "n" | "y";
+export interface WebApprovalSnapshot {
+    active: ApprovalDescriptor | null;
+    pendingCount: number;
+}
+export interface WebSessionSnapshot {
+    approval: WebApprovalSnapshot;
+    approvalMode: string;
+    busy: boolean;
+    /**
+     * Count of messages queued for auto-send, mirrored from the wire (the
+     * controller owns the queue; see `turn-status.queuedCount`). The web UI now
+     * renders the actual `queued` list as a composer tray rather than this count,
+     * but the field stays projected for parity (the TUI consumes it). Absent ⇒ 0.
+     */
+    queuedCount?: number;
+    /** Messages waiting in the auto-send queue, in send order. Absent ⇒ []. */
+    queued?: QueuedMessageView[];
+    /** Total context-window token budget for the active model, when known. */
+    contextWindowLimit?: number;
+    /** Fraction (0–1) of the context window used by the latest model response. */
+    contextWindowUsage?: number;
+    /** Token count of the latest model response, when known. */
+    currentTokens?: number;
+    cwd: string;
+    messages: WebMessage[];
+    modelName: string;
+    /** Active main-agent persona id; `"default"` for the built-in coordinator. */
+    persona: string;
+    /** Active config profile; rendered as a header indicator. Absent ⇒ "default". */
+    profile?: string;
+    /** Active workspace name; rendered as a header indicator. Absent ⇒ hidden. */
+    workspace?: string;
+    question: {
+        active: QuestionDescriptor | null;
+    };
+    /**
+     * Server-executed slash command descriptors from the attach snapshot. Merged
+     * with web client-side commands for Composer autocomplete. Empty when the host
+     * registers none.
+     */
+    serverCommands: SlashCommandDescriptor[];
+    /**
+     * Reduced live summaries of background workflow runs (spec §8.2, D8). UI-only;
+     * NEVER agent context. Projected from `SessionViewState.workflows`.
+     */
+    workflows: WorkflowViewState[];
+}
+/**
+ * Session-attach credentials. Static {url, token} (local/LAN, unchanged) or an
+ * endpoint provider that resolves a fresh relay channel + grant per connection
+ * attempt (web spec §6). Credentials ride the hello frame, never the URL.
+ */
+export type WebSessionCredentials = {
+    sessionId: string;
+} & ({
+    url: string;
+    token: string;
+} | {
+    getEndpoint: GetEndpoint;
+});
+//# sourceMappingURL=types.d.ts.map