@llui/agent 0.0.43 → 0.0.45

package/dist/client/agentConnect.d.ts

@@ -1,7 +1,7 @@
 import { type Send } from '@llui/dom';
 import type { AgentSession, AgentToken } from '../protocol.js';
 import type { AgentEffect } from './effects.js';
-export type AgentConnectStatus = 'idle' | 'minting' | 'pending-claude' | 'active' | 'error';
+export type AgentConnectStatus = 'idle' | 'minting' | 'pending-claude' | 'active' | 'reconnecting' | 'failed' | 'error';
 export type AgentConnectPendingToken = {
     token: AgentToken;
     tid: string;
@@ -15,6 +15,12 @@ export type AgentConnectPendingToken = {
      */
     connectSnippet: string;
     expiresAt: number;
+    /**
+     * Cached so the auto-reconnect path can re-open the WS without
+     * re-minting. The MintSucceeded → AgentOpenWS path stores it; the
+     * RestoreSession path also fills it in. Cleared by `Disconnect`.
+     */
+    wsUrl: string;
 };
 export type AgentConnectState = {
     status: AgentConnectStatus;
@@ -25,6 +31,21 @@ export type AgentConnectState = {
         code: string;
         detail: string;
     } | null;
+    /**
+     * Reconnect attempt counter. Incremented on each WS-close that
+     * triggers an auto-reconnect; reset on `WsOpened` and on user
+     * actions (`Disconnect`, fresh `Mint`). Drives the backoff schedule
+     * (1s, 2s, 4s, 8s, 16s, 30s, 30s, …) and surfaces to UI as
+     * "reconnecting (attempt 3 / next in 4s)".
+     */
+    reconnectAttempt: number;
+    /**
+     * Total cumulative ms spent in `reconnecting` for the current
+     * outage. Compared against `reconnectGiveUpMs` (effect-side option,
+     * default 5 min) to decide when to surface `failed` to the user.
+     * Reset whenever a WS opens successfully.
+     */
+    reconnectElapsedMs: number;
 };
 export type AgentConnectMsg = 
 /** @intent("Mint a new agent token and open the pairing WebSocket") */
@@ -104,6 +125,53 @@ export type AgentConnectMsg =
  */
  | {
     type: 'CopyConnectSnippet';
+}
+/**
+ * @humanOnly — internal: app boot dispatches this with credentials
+ * read from sessionStorage to skip the mint round-trip after page
+ * refresh. The agent's token (still alive on the server) keeps
+ * working since we don't go through the rotate-on-resume path. The
+ * reducer is idempotent against an in-flight Mint — only fires from
+ * `idle`.
+ */
+ | {
+    type: 'RestoreSession';
+    token: AgentToken;
+    tid: string;
+    lapUrl: string;
+    wsUrl: string;
+    expiresAt: number;
+}
+/**
+ * @intent("Disconnect the active agent session and clear all
+ * persisted credentials. Stops any in-flight reconnect attempt;
+ * subsequent WS closures stay in `idle` instead of triggering
+ * auto-reconnect. Use when the user explicitly clicks Disconnect
+ * in the panel — for transient drops, do nothing and let the
+ * reconnect loop run.")
+ */
+ | {
+    type: 'Disconnect';
+}
+/**
+ * @humanOnly — internal: scheduler effect dispatched this when the
+ * backoff timer fired. The reducer increments the attempt counter,
+ * adds the just-elapsed delay to `reconnectElapsedMs`, and emits
+ * `AgentOpenWS` with the cached pendingToken/wsUrl so the WS can
+ * reattach without minting.
+ */
+ | {
+    type: 'ReconnectAttempt';
+    elapsedMs: number;
+}
+/**
+ * @humanOnly — internal: scheduler effect dispatched this when the
+ * give-up ceiling was reached without a successful WS open.
+ * Reducer flips status to `failed` so the UI can surface a clear
+ * error and offer a manual reconnect.
+ */
+ | {
+    type: 'ReconnectGaveUp';
 };
 /**
  * Options threaded through `init()` and `update()`. `mintUrl` is

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

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

package/dist/client/agentConnect.js

@@ -1,4 +1,28 @@
 import { tagSend } from '@llui/dom';
+/**
+ * Backoff schedule for the auto-reconnect loop. Doubles starting at
+ * 1s, caps at 30s. Translates `state.reconnectAttempt` into the next
+ * delay; the effect handler schedules a `setTimeout` for that long
+ * and dispatches `ReconnectAttempt` when it fires.
+ *
+ * Lives in the reducer so tests can pin the timings without poking
+ * effect-handler internals; the constants are not exported because
+ * tweaking them changes UX more than tweaks to the give-up ceiling.
+ */
+const RECONNECT_BASE_MS = 1000;
+const RECONNECT_CAP_MS = 30_000;
+function reconnectDelayMs(attempt) {
+    const factor = Math.min(Math.pow(2, attempt), RECONNECT_CAP_MS / RECONNECT_BASE_MS);
+    return Math.min(RECONNECT_BASE_MS * factor, RECONNECT_CAP_MS);
+}
+/**
+ * Total cumulative wait, across all reconnect attempts, before the
+ * loop gives up and transitions to `'failed'`. 5 minutes is long
+ * enough to weather a brief server outage but short enough that a
+ * permanently-down endpoint surfaces clearly to the user instead of
+ * silently spinning.
+ */
+const RECONNECT_GIVE_UP_MS = 5 * 60 * 1000;
 /** Component shape is [State, Effect[]] — consistent with @llui/components. */
 export function init(_opts) {
     return [
@@ -8,6 +32,8 @@ export function init(_opts) {
             sessions: [],
             resumable: [],
             error: null,
+            reconnectAttempt: 0,
+            reconnectElapsedMs: 0,
         },
         [],
     ];
@@ -24,36 +50,187 @@ export function update(state, msg, opts = {}) {
             return [{ ...state, status: 'minting' }, [mintEffect]];
         }
         case 'MintSucceeded': {
-            // The connect snippet has to work across every Claude surface.
-            // Claude Desktop exposes MCP tools as bare names (`connect_session`),
-            // but Claude Code namespaces them (`mcp__<server>__connect_session`)
-            // and may defer-load them — so an LLM that searches its tool list for
-            // a literal `connect_session` won't find it. Naming the LLui MCP
-            // server explicitly gives the model enough to resolve the right tool
-            // on either platform.
+            // The connect snippet has to work across every MCP surface.
+            // Claude Desktop and similar clients expose MCP tools as bare
+            // names (`connect_session`), but Claude Code (and other tool-list-
+            // namespacing clients) emit them as `mcp__llui__connect_session`
+            // and may defer-load them — so an LLM that searches its tool list
+            // for a literal `connect_session` won't find it. Naming the LLui
+            // MCP server explicitly (with its canonical `llui` install name,
+            // matching the install docs) gives the model enough to resolve
+            // the right tool on either platform; the parenthetical names the
+            // edge case so a deferred-tool client doesn't bail out.
+            //
+            // Phrased generically (`AI assistant`, `Some MCP clients`) since
+            // MCP support is rapidly expanding past Claude — the snippet
+            // shouldn't telegraph "this is Claude-only" when it works against
+            // any compliant client. The literal `mcp__llui__` prefix matches
+            // the install command in `site/content/agents.md`; users who
+            // renamed the server in their config can substitute their name.
             const pending = {
                 token: msg.token,
                 tid: msg.tid,
                 lapUrl: msg.lapUrl,
-                connectSnippet: `Connect this Claude session to the LLui app. Call the LLui MCP server's ` +
+                connectSnippet: `Connect this AI assistant to the LLui app. Call the LLui MCP server's ` +
+                    `\`connect_session\` tool with url=${JSON.stringify(msg.lapUrl)} and ` +
+                    `token=${JSON.stringify(msg.token)}. ` +
+                    `(Some MCP clients namespace tools as ` +
+                    `\`mcp__llui__connect_session\` and load them lazily — search the tool list if \`connect_session\` isn't immediately available.)`,
+                expiresAt: msg.expiresAt,
+                wsUrl: msg.wsUrl,
+            };
+            return [
+                {
+                    ...state,
+                    status: 'pending-claude',
+                    pendingToken: pending,
+                    error: null,
+                    reconnectAttempt: 0,
+                    reconnectElapsedMs: 0,
+                },
+                [
+                    { type: 'AgentOpenWS', token: msg.token, wsUrl: msg.wsUrl },
+                    // Persist alongside opening the WS so the host can store the
+                    // credentials in sessionStorage; on page refresh, app boot
+                    // dispatches `RestoreSession` with the same shape and we
+                    // re-enter the same state without re-minting.
+                    {
+                        type: 'AgentSessionPersist',
+                        token: msg.token,
+                        tid: msg.tid,
+                        lapUrl: msg.lapUrl,
+                        wsUrl: msg.wsUrl,
+                        expiresAt: msg.expiresAt,
+                    },
+                ],
+            ];
+        }
+        case 'RestoreSession': {
+            // Idempotent guard: only fires from idle. A racing Mint click
+            // would already have moved us to `minting` — restoring on top
+            // would clobber the in-flight pending state with stale
+            // credentials read from sessionStorage. Easier to no-op here
+            // than to coordinate the race in the host.
+            if (state.status !== 'idle')
+                return [state, []];
+            // Regenerate the connectSnippet so the user can re-paste if
+            // their AI lost the original tool call (same shape as
+            // MintSucceeded — the framework owns this string and updates
+            // to it ride along the agent package version).
+            const restored = {
+                token: msg.token,
+                tid: msg.tid,
+                lapUrl: msg.lapUrl,
+                connectSnippet: `Connect this AI assistant to the LLui app. Call the LLui MCP server's ` +
                     `\`connect_session\` tool with url=${JSON.stringify(msg.lapUrl)} and ` +
                     `token=${JSON.stringify(msg.token)}. ` +
-                    `(In Claude Code the tool may be namespaced as ` +
-                    `\`mcp__<server>__connect_session\` and deferred — load it via tool search if needed.)`,
+                    `(Some MCP clients namespace tools as ` +
+                    `\`mcp__llui__connect_session\` and load them lazily — search the tool list if \`connect_session\` isn't immediately available.)`,
                 expiresAt: msg.expiresAt,
+                wsUrl: msg.wsUrl,
             };
             return [
-                { ...state, status: 'pending-claude', pendingToken: pending, error: null },
+                {
+                    ...state,
+                    status: 'pending-claude',
+                    pendingToken: restored,
+                    error: null,
+                    reconnectAttempt: 0,
+                    reconnectElapsedMs: 0,
+                },
                 [{ type: 'AgentOpenWS', token: msg.token, wsUrl: msg.wsUrl }],
             ];
         }
         case 'MintFailed':
             return [{ ...state, status: 'error', error: msg.error }, []];
-        case 'WsOpened':
+        case 'WsOpened': {
             // WS is open but Claude hasn't bound yet; stay at pending-claude.
+            // If we were `reconnecting`, this is a successful reattach —
+            // back to pending-claude and reset the attempt counters.
+            if (state.status === 'reconnecting') {
+                return [
+                    { ...state, status: 'pending-claude', reconnectAttempt: 0, reconnectElapsedMs: 0 },
+                    [],
+                ];
+            }
             return [state, []];
-        case 'WsClosed':
-            return [{ ...state, status: 'idle', pendingToken: null }, []];
+        }
+        case 'WsClosed': {
+            // Three cases:
+            //   1. We had no pendingToken (already idle / pre-mint) → no-op.
+            //   2. Status is `idle` or `failed` (Disconnect already cleared,
+            //      or we previously gave up) → no-op so a delayed close
+            //      event after Disconnect doesn't accidentally restart the
+            //      loop.
+            //   3. We're connected/connecting and the close was unsolicited
+            //      → schedule a reconnect with backoff.
+            if (state.pendingToken === null)
+                return [{ ...state, status: 'idle' }, []];
+            if (state.status === 'idle' || state.status === 'failed')
+                return [state, []];
+            const delayMs = reconnectDelayMs(state.reconnectAttempt);
+            return [
+                { ...state, status: 'reconnecting', error: null },
+                [{ type: 'AgentReconnectSchedule', delayMs }],
+            ];
+        }
+        case 'ReconnectAttempt': {
+            // Backoff timer fired. If the user disconnected in the gap, we
+            // moved to idle and ignore. Otherwise, increment attempt + add
+            // the elapsed delay to the cumulative window. Past the give-up
+            // ceiling, transition to `failed` so the UI can offer a manual
+            // reconnect; otherwise re-open the WS with the cached
+            // credentials (no mint, same token — the server's grace window
+            // is what makes this transparent to the agent).
+            if (state.status !== 'reconnecting' || state.pendingToken === null) {
+                return [state, []];
+            }
+            const newElapsed = state.reconnectElapsedMs + msg.elapsedMs;
+            if (newElapsed >= RECONNECT_GIVE_UP_MS) {
+                return [{ ...state, status: 'failed', reconnectElapsedMs: newElapsed }, []];
+            }
+            return [
+                {
+                    ...state,
+                    reconnectAttempt: state.reconnectAttempt + 1,
+                    reconnectElapsedMs: newElapsed,
+                },
+                [
+                    {
+                        type: 'AgentOpenWS',
+                        token: state.pendingToken.token,
+                        wsUrl: state.pendingToken.wsUrl,
+                    },
+                ],
+            ];
+        }
+        case 'ReconnectGaveUp':
+            return [{ ...state, status: 'failed' }, []];
+        case 'Disconnect': {
+            // User-initiated. Revoke the active tid (server kills the
+            // pairing), wipe the persisted credentials so a refresh can't
+            // restore them, and zero the reconnect counters so any in-
+            // flight backoff timer that fires post-disconnect becomes a
+            // no-op (the status guard in `ReconnectAttempt` keeps it from
+            // re-opening the WS).
+            const tid = state.pendingToken?.tid;
+            const effects = [];
+            if (tid !== undefined)
+                effects.push({ type: 'AgentRevoke', tid });
+            effects.push({ type: 'AgentSessionClear' });
+            effects.push({ type: 'AgentCloseWS' });
+            return [
+                {
+                    ...state,
+                    status: 'idle',
+                    pendingToken: null,
+                    error: null,
+                    reconnectAttempt: 0,
+                    reconnectElapsedMs: 0,
+                },
+                effects,
+            ];
+        }
         case 'ActivatedByClaude':
             return [{ ...state, status: 'active' }, []];
         case 'ResumeList':
@@ -63,14 +240,22 @@ export function update(state, msg, opts = {}) {
         case 'Resume':
             return [state, [{ type: 'AgentResumeClaim', tid: msg.tid }]];
         case 'Revoke': {
-            // Optimistically remove from sessions + resumable.
+            // Optimistically remove from sessions + resumable. If the
+            // revoked tid matches the currently-pending session, also fire
+            // AgentSessionClear so the host wipes its persisted credentials
+            // — otherwise a refresh would try to RestoreSession with a
+            // server-side-revoked token and end up at an auth-failed WS.
+            const isActiveTid = state.pendingToken !== null && state.pendingToken.tid === msg.tid;
+            const effects = [{ type: 'AgentRevoke', tid: msg.tid }];
+            if (isActiveTid)
+                effects.push({ type: 'AgentSessionClear' });
             return [
                 {
                     ...state,
                     sessions: state.sessions.filter((s) => s.tid !== msg.tid),
                     resumable: state.resumable.filter((s) => s.tid !== msg.tid),
                 },
-                [{ type: 'AgentRevoke', tid: msg.tid }],
+                effects,
             ];
         }
         case 'ClearError':

package/dist/client/agentConnect.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentConnect.js","sourceRoot":"","sources":["../../src/client/agentConnect.ts"],"names":[],"mappings":"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","sourcesContent":["import { tagSend, type Send } from '@llui/dom'\nimport type { AgentSession, AgentToken } from '../protocol.js'\nimport type { AgentEffect } from './effects.js'\n\nexport type AgentConnectStatus = 'idle' | 'minting' | 'pending-claude' | 'active' | 'error'\n\nexport type AgentConnectPendingToken = {\n  token: AgentToken\n  tid: string\n  lapUrl: string\n  /**\n   * Natural-language connect instruction the user copies into Claude.\n   * Includes URL, token, and the explicit `connect_session` tool\n   * call. Works in any Claude client (Desktop, CC CLI, etc.) — the\n   * Desktop-specific `/llui-connect` slash command is sugar over the\n   * same tool call.\n   */\n  connectSnippet: string\n  expiresAt: number\n}\n\nexport type AgentConnectState = {\n  status: AgentConnectStatus\n  pendingToken: AgentConnectPendingToken | null\n  sessions: AgentSession[]\n  resumable: AgentSession[]\n  error: { code: string; detail: string } | null\n}\n\nexport type AgentConnectMsg =\n  /** @intent(\"Mint a new agent token and open the pairing WebSocket\") */\n  | { type: 'Mint' }\n  /**\n   * @humanOnly — internal: dispatched by the AgentMintRequest effect\n   * handler when the mint endpoint replies success. Carries the token\n   * and connection URLs into state.\n   */\n  | {\n      type: 'MintSucceeded'\n      token: AgentToken\n      tid: string\n      lapUrl: string\n      wsUrl: string\n      expiresAt: number\n    }\n  /** @humanOnly — internal: dispatched by the AgentMintRequest handler on failure. */\n  | { type: 'MintFailed'; error: { code: string; detail: string } }\n  /** @humanOnly — internal: WS adapter signalled the pairing socket is open. */\n  | { type: 'WsOpened' }\n  /** @humanOnly — internal: WS adapter signalled the pairing socket is closed. */\n  | { type: 'WsClosed' }\n  /** @humanOnly — internal: Claude bound the session via /agent/claim. */\n  | { type: 'ActivatedByClaude' }\n  /** @intent(\"Check which previously-issued agent sessions can be resumed\") */\n  | { type: 'ResumeList'; tids: string[] }\n  /** @humanOnly — internal: AgentResumeCheck effect handler returned the list. */\n  | { type: 'ResumeListLoaded'; sessions: AgentSession[] }\n  /** @intent(\"Resume an existing agent session by tid\") */\n  | { type: 'Resume'; tid: string }\n  /** @intent(\"Revoke an agent session by tid\") */\n  | { type: 'Revoke'; tid: string }\n  /** @intent(\"Dismiss the current agent connect error\") */\n  | { type: 'ClearError' }\n  /** @humanOnly — internal: AgentSessionsList effect handler returned the list. */\n  | { type: 'SessionsLoaded'; sessions: AgentSession[] }\n  /** @intent(\"Refresh the list of active agent sessions\") */\n  | { type: 'RefreshSessions' }\n  /**\n   * @intent(\"Copy the agent connect snippet to the clipboard\")\n   * Resolves the pendingToken's snippet in update() (state-reading is\n   * what update() is for) and dispatches a clipboard-write effect.\n   */\n  | { type: 'CopyConnectSnippet' }\n\n/**\n * Options threaded through `init()` and `update()`. `mintUrl` is\n * optional — when omitted the agent effect handler derives it from\n * `EffectHandlerHost.agentBasePath` (default `/agent` → `/agent/mint`).\n * Set explicitly only when the mint endpoint lives outside the\n * configured base path.\n */\nexport type AgentConnectInitOpts = { mintUrl?: string }\n\n/** Component shape is [State, Effect[]] — consistent with @llui/components. */\nexport function init(_opts: AgentConnectInitOpts): [AgentConnectState, AgentEffect[]] {\n  return [\n    {\n      status: 'idle',\n      pendingToken: null,\n      sessions: [],\n      resumable: [],\n      error: null,\n    },\n    [],\n  ]\n}\n\nexport function update(\n  state: AgentConnectState,\n  msg: AgentConnectMsg,\n  opts: AgentConnectInitOpts = {},\n): [AgentConnectState, AgentEffect[]] {\n  switch (msg.type) {\n    case 'Mint': {\n      // mintUrl: undefined means \"let the effect handler derive it\n      // from agentBasePath\". Only include the property when explicitly\n      // set, so the effect's discriminated shape stays clean.\n      const mintEffect: AgentEffect =\n        opts.mintUrl !== undefined\n          ? { type: 'AgentMintRequest', mintUrl: opts.mintUrl }\n          : { type: 'AgentMintRequest' }\n      return [{ ...state, status: 'minting' }, [mintEffect]]\n    }\n    case 'MintSucceeded': {\n      // The connect snippet has to work across every Claude surface.\n      // Claude Desktop exposes MCP tools as bare names (`connect_session`),\n      // but Claude Code namespaces them (`mcp__<server>__connect_session`)\n      // and may defer-load them — so an LLM that searches its tool list for\n      // a literal `connect_session` won't find it. Naming the LLui MCP\n      // server explicitly gives the model enough to resolve the right tool\n      // on either platform.\n      const pending: AgentConnectPendingToken = {\n        token: msg.token,\n        tid: msg.tid,\n        lapUrl: msg.lapUrl,\n        connectSnippet:\n          `Connect this Claude session to the LLui app. Call the LLui MCP server's ` +\n          `\\`connect_session\\` tool with url=${JSON.stringify(msg.lapUrl)} and ` +\n          `token=${JSON.stringify(msg.token)}. ` +\n          `(In Claude Code the tool may be namespaced as ` +\n          `\\`mcp__<server>__connect_session\\` and deferred — load it via tool search if needed.)`,\n        expiresAt: msg.expiresAt,\n      }\n      return [\n        { ...state, status: 'pending-claude', pendingToken: pending, error: null },\n        [{ type: 'AgentOpenWS', token: msg.token, wsUrl: msg.wsUrl }],\n      ]\n    }\n    case 'MintFailed':\n      return [{ ...state, status: 'error', error: msg.error }, []]\n    case 'WsOpened':\n      // WS is open but Claude hasn't bound yet; stay at pending-claude.\n      return [state, []]\n    case 'WsClosed':\n      return [{ ...state, status: 'idle', pendingToken: null }, []]\n    case 'ActivatedByClaude':\n      return [{ ...state, status: 'active' }, []]\n    case 'ResumeList':\n      return [state, [{ type: 'AgentResumeCheck', tids: msg.tids }]]\n    case 'ResumeListLoaded':\n      return [{ ...state, resumable: msg.sessions }, []]\n    case 'Resume':\n      return [state, [{ type: 'AgentResumeClaim', tid: msg.tid }]]\n    case 'Revoke': {\n      // Optimistically remove from sessions + resumable.\n      return [\n        {\n          ...state,\n          sessions: state.sessions.filter((s) => s.tid !== msg.tid),\n          resumable: state.resumable.filter((s) => s.tid !== msg.tid),\n        },\n        [{ type: 'AgentRevoke', tid: msg.tid }],\n      ]\n    }\n    case 'ClearError':\n      return [{ ...state, error: null }, []]\n    case 'SessionsLoaded':\n      return [{ ...state, sessions: msg.sessions }, []]\n    case 'RefreshSessions':\n      return [state, [{ type: 'AgentSessionsList' }]]\n    case 'CopyConnectSnippet': {\n      // No-op when there's no pending token — the button's\n      // `disabled` accessor already gates the click, but we accept\n      // the message for runtime safety.\n      if (!state.pendingToken) return [state, []]\n      return [state, [{ type: 'AgentClipboardWrite', text: state.pendingToken.connectSnippet }]]\n    }\n  }\n}\n\n// ── Connect helper ────────────────────────────────────────────────────────────\n\nexport type AgentConnectConnectOptions = {\n  id?: string // optional DOM id prefix\n}\n\n/**\n * Static prop bag with reactive accessors. Mirrors the @llui/components\n * pattern (e.g. `dialog.connect`): callers spread bag keys directly\n * into element helpers, and function-valued props re-evaluate per\n * binding-mask hit. The previous shape — `(state) => bag` — required\n * callers to wrap every prop access in their own arrow, which the\n * documented usage didn't do (and silently produced `undefined` props\n * when spread).\n */\nexport type ConnectBag<S> = {\n  root: { 'data-scope': 'agent-connect'; 'data-state': (s: S) => AgentConnectStatus }\n  mintTrigger: { onClick: () => void; disabled: (s: S) => boolean }\n  pendingTokenBox: { 'data-part': 'pending-token'; 'data-visible': (s: S) => boolean }\n  copyConnectSnippetButton: { onClick: () => void; disabled: (s: S) => boolean }\n  sessionsList: { 'data-part': 'sessions-list' }\n  sessionItem: (tid: string) => { 'data-part': 'session-item'; 'data-tid': string }\n  revokeButton: (tid: string) => { onClick: () => void }\n  resumeBanner: { 'data-part': 'resume-banner'; 'data-visible': (s: S) => boolean }\n  resumeItem: (tid: string) => { 'data-part': 'resume-item'; 'data-tid': string }\n  resumeButton: (tid: string) => { onClick: () => void }\n  dismissButton: (tid: string) => { onClick: () => void }\n  error: {\n    'data-part': 'error'\n    'data-visible': (s: S) => boolean\n    onClick: () => void\n  }\n}\n\n/**\n * Builds prop bags for the view. Static-bag-with-reactive-accessors\n * shape (matches the @llui/components convention); spread directly\n * into element helpers.\n */\nexport function connect<S>(\n  get: (s: S) => AgentConnectState,\n  send: Send<AgentConnectMsg>,\n  _opts: AgentConnectConnectOptions = {},\n): ConnectBag<S> {\n  return {\n    root: {\n      'data-scope': 'agent-connect',\n      'data-state': (s) => get(s).status,\n    },\n    mintTrigger: {\n      onClick: tagSend(send, ['Mint'], () => send({ type: 'Mint' })),\n      disabled: (s) => {\n        const cs = get(s)\n        return cs.status === 'minting' || cs.status === 'pending-claude' || cs.status === 'active'\n      },\n    },\n    pendingTokenBox: {\n      'data-part': 'pending-token',\n      'data-visible': (s) => get(s).pendingToken !== null,\n    },\n    copyConnectSnippetButton: {\n      // The handler reads state at click time via the Msg/effect path:\n      // CopyConnectSnippet → update() reads pendingToken.connectSnippet\n      // → effect AgentClipboardWrite writes to navigator.clipboard.\n      // Routing through update() keeps state reads out of event\n      // handlers, which is what makes the static-bag-with-reactive-\n      // accessors shape work cleanly.\n      onClick: tagSend(send, ['CopyConnectSnippet'], () => send({ type: 'CopyConnectSnippet' })),\n      disabled: (s) => get(s).pendingToken === null,\n    },\n    sessionsList: { 'data-part': 'sessions-list' },\n    sessionItem: (tid) => ({ 'data-part': 'session-item', 'data-tid': tid }),\n    revokeButton: (tid) => ({\n      onClick: tagSend(send, ['Revoke'], () => send({ type: 'Revoke', tid })),\n    }),\n    resumeBanner: {\n      'data-part': 'resume-banner',\n      'data-visible': (s) => get(s).resumable.length > 0,\n    },\n    resumeItem: (tid) => ({ 'data-part': 'resume-item', 'data-tid': tid }),\n    resumeButton: (tid) => ({\n      onClick: tagSend(send, ['Resume'], () => send({ type: 'Resume', tid })),\n    }),\n    dismissButton: (tid) => ({\n      // For dismiss, we currently just remove the resumable record\n      // locally. A \"dismiss forever\" flag could land in a follow-up;\n      // for v1, dismiss is a client-side-only state prune by reusing\n      // the Revoke Msg path with intent-split; for now emit Revoke\n      // which both revokes server-side AND removes locally.\n      onClick: tagSend(send, ['Revoke'], () => send({ type: 'Revoke', tid })),\n    }),\n    error: {\n      'data-part': 'error',\n      'data-visible': (s) => get(s).error !== null,\n      onClick: tagSend(send, ['ClearError'], () => send({ type: 'ClearError' })),\n    },\n  }\n}\n"]}
+{"version":3,"file":"agentConnect.js","sourceRoot":"","sources":["../../src/client/agentConnect.ts"],"names":[],"mappings":"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","sourcesContent":["import { tagSend, type Send } from '@llui/dom'\nimport type { AgentSession, AgentToken } from '../protocol.js'\nimport type { AgentEffect } from './effects.js'\n\nexport type AgentConnectStatus =\n  | 'idle'\n  | 'minting'\n  | 'pending-claude'\n  | 'active'\n  | 'reconnecting'\n  | 'failed'\n  | 'error'\n\nexport type AgentConnectPendingToken = {\n  token: AgentToken\n  tid: string\n  lapUrl: string\n  /**\n   * Natural-language connect instruction the user copies into Claude.\n   * Includes URL, token, and the explicit `connect_session` tool\n   * call. Works in any Claude client (Desktop, CC CLI, etc.) — the\n   * Desktop-specific `/llui-connect` slash command is sugar over the\n   * same tool call.\n   */\n  connectSnippet: string\n  expiresAt: number\n  /**\n   * Cached so the auto-reconnect path can re-open the WS without\n   * re-minting. The MintSucceeded → AgentOpenWS path stores it; the\n   * RestoreSession path also fills it in. Cleared by `Disconnect`.\n   */\n  wsUrl: string\n}\n\nexport type AgentConnectState = {\n  status: AgentConnectStatus\n  pendingToken: AgentConnectPendingToken | null\n  sessions: AgentSession[]\n  resumable: AgentSession[]\n  error: { code: string; detail: string } | null\n  /**\n   * Reconnect attempt counter. Incremented on each WS-close that\n   * triggers an auto-reconnect; reset on `WsOpened` and on user\n   * actions (`Disconnect`, fresh `Mint`). Drives the backoff schedule\n   * (1s, 2s, 4s, 8s, 16s, 30s, 30s, …) and surfaces to UI as\n   * \"reconnecting (attempt 3 / next in 4s)\".\n   */\n  reconnectAttempt: number\n  /**\n   * Total cumulative ms spent in `reconnecting` for the current\n   * outage. Compared against `reconnectGiveUpMs` (effect-side option,\n   * default 5 min) to decide when to surface `failed` to the user.\n   * Reset whenever a WS opens successfully.\n   */\n  reconnectElapsedMs: number\n}\n\nexport type AgentConnectMsg =\n  /** @intent(\"Mint a new agent token and open the pairing WebSocket\") */\n  | { type: 'Mint' }\n  /**\n   * @humanOnly — internal: dispatched by the AgentMintRequest effect\n   * handler when the mint endpoint replies success. Carries the token\n   * and connection URLs into state.\n   */\n  | {\n      type: 'MintSucceeded'\n      token: AgentToken\n      tid: string\n      lapUrl: string\n      wsUrl: string\n      expiresAt: number\n    }\n  /** @humanOnly — internal: dispatched by the AgentMintRequest handler on failure. */\n  | { type: 'MintFailed'; error: { code: string; detail: string } }\n  /** @humanOnly — internal: WS adapter signalled the pairing socket is open. */\n  | { type: 'WsOpened' }\n  /** @humanOnly — internal: WS adapter signalled the pairing socket is closed. */\n  | { type: 'WsClosed' }\n  /** @humanOnly — internal: Claude bound the session via /agent/claim. */\n  | { type: 'ActivatedByClaude' }\n  /** @intent(\"Check which previously-issued agent sessions can be resumed\") */\n  | { type: 'ResumeList'; tids: string[] }\n  /** @humanOnly — internal: AgentResumeCheck effect handler returned the list. */\n  | { type: 'ResumeListLoaded'; sessions: AgentSession[] }\n  /** @intent(\"Resume an existing agent session by tid\") */\n  | { type: 'Resume'; tid: string }\n  /** @intent(\"Revoke an agent session by tid\") */\n  | { type: 'Revoke'; tid: string }\n  /** @intent(\"Dismiss the current agent connect error\") */\n  | { type: 'ClearError' }\n  /** @humanOnly — internal: AgentSessionsList effect handler returned the list. */\n  | { type: 'SessionsLoaded'; sessions: AgentSession[] }\n  /** @intent(\"Refresh the list of active agent sessions\") */\n  | { type: 'RefreshSessions' }\n  /**\n   * @intent(\"Copy the agent connect snippet to the clipboard\")\n   * Resolves the pendingToken's snippet in update() (state-reading is\n   * what update() is for) and dispatches a clipboard-write effect.\n   */\n  | { type: 'CopyConnectSnippet' }\n  /**\n   * @humanOnly — internal: app boot dispatches this with credentials\n   * read from sessionStorage to skip the mint round-trip after page\n   * refresh. The agent's token (still alive on the server) keeps\n   * working since we don't go through the rotate-on-resume path. The\n   * reducer is idempotent against an in-flight Mint — only fires from\n   * `idle`.\n   */\n  | {\n      type: 'RestoreSession'\n      token: AgentToken\n      tid: string\n      lapUrl: string\n      wsUrl: string\n      expiresAt: number\n    }\n  /**\n   * @intent(\"Disconnect the active agent session and clear all\n   * persisted credentials. Stops any in-flight reconnect attempt;\n   * subsequent WS closures stay in `idle` instead of triggering\n   * auto-reconnect. Use when the user explicitly clicks Disconnect\n   * in the panel — for transient drops, do nothing and let the\n   * reconnect loop run.\")\n   */\n  | { type: 'Disconnect' }\n  /**\n   * @humanOnly — internal: scheduler effect dispatched this when the\n   * backoff timer fired. The reducer increments the attempt counter,\n   * adds the just-elapsed delay to `reconnectElapsedMs`, and emits\n   * `AgentOpenWS` with the cached pendingToken/wsUrl so the WS can\n   * reattach without minting.\n   */\n  | { type: 'ReconnectAttempt'; elapsedMs: number }\n  /**\n   * @humanOnly — internal: scheduler effect dispatched this when the\n   * give-up ceiling was reached without a successful WS open.\n   * Reducer flips status to `failed` so the UI can surface a clear\n   * error and offer a manual reconnect.\n   */\n  | { type: 'ReconnectGaveUp' }\n\n/**\n * Options threaded through `init()` and `update()`. `mintUrl` is\n * optional — when omitted the agent effect handler derives it from\n * `EffectHandlerHost.agentBasePath` (default `/agent` → `/agent/mint`).\n * Set explicitly only when the mint endpoint lives outside the\n * configured base path.\n */\nexport type AgentConnectInitOpts = { mintUrl?: string }\n\n/**\n * Backoff schedule for the auto-reconnect loop. Doubles starting at\n * 1s, caps at 30s. Translates `state.reconnectAttempt` into the next\n * delay; the effect handler schedules a `setTimeout` for that long\n * and dispatches `ReconnectAttempt` when it fires.\n *\n * Lives in the reducer so tests can pin the timings without poking\n * effect-handler internals; the constants are not exported because\n * tweaking them changes UX more than tweaks to the give-up ceiling.\n */\nconst RECONNECT_BASE_MS = 1000\nconst RECONNECT_CAP_MS = 30_000\nfunction reconnectDelayMs(attempt: number): number {\n  const factor = Math.min(Math.pow(2, attempt), RECONNECT_CAP_MS / RECONNECT_BASE_MS)\n  return Math.min(RECONNECT_BASE_MS * factor, RECONNECT_CAP_MS)\n}\n\n/**\n * Total cumulative wait, across all reconnect attempts, before the\n * loop gives up and transitions to `'failed'`. 5 minutes is long\n * enough to weather a brief server outage but short enough that a\n * permanently-down endpoint surfaces clearly to the user instead of\n * silently spinning.\n */\nconst RECONNECT_GIVE_UP_MS = 5 * 60 * 1000\n\n/** Component shape is [State, Effect[]] — consistent with @llui/components. */\nexport function init(_opts: AgentConnectInitOpts): [AgentConnectState, AgentEffect[]] {\n  return [\n    {\n      status: 'idle',\n      pendingToken: null,\n      sessions: [],\n      resumable: [],\n      error: null,\n      reconnectAttempt: 0,\n      reconnectElapsedMs: 0,\n    },\n    [],\n  ]\n}\n\nexport function update(\n  state: AgentConnectState,\n  msg: AgentConnectMsg,\n  opts: AgentConnectInitOpts = {},\n): [AgentConnectState, AgentEffect[]] {\n  switch (msg.type) {\n    case 'Mint': {\n      // mintUrl: undefined means \"let the effect handler derive it\n      // from agentBasePath\". Only include the property when explicitly\n      // set, so the effect's discriminated shape stays clean.\n      const mintEffect: AgentEffect =\n        opts.mintUrl !== undefined\n          ? { type: 'AgentMintRequest', mintUrl: opts.mintUrl }\n          : { type: 'AgentMintRequest' }\n      return [{ ...state, status: 'minting' }, [mintEffect]]\n    }\n    case 'MintSucceeded': {\n      // The connect snippet has to work across every MCP surface.\n      // Claude Desktop and similar clients expose MCP tools as bare\n      // names (`connect_session`), but Claude Code (and other tool-list-\n      // namespacing clients) emit them as `mcp__llui__connect_session`\n      // and may defer-load them — so an LLM that searches its tool list\n      // for a literal `connect_session` won't find it. Naming the LLui\n      // MCP server explicitly (with its canonical `llui` install name,\n      // matching the install docs) gives the model enough to resolve\n      // the right tool on either platform; the parenthetical names the\n      // edge case so a deferred-tool client doesn't bail out.\n      //\n      // Phrased generically (`AI assistant`, `Some MCP clients`) since\n      // MCP support is rapidly expanding past Claude — the snippet\n      // shouldn't telegraph \"this is Claude-only\" when it works against\n      // any compliant client. The literal `mcp__llui__` prefix matches\n      // the install command in `site/content/agents.md`; users who\n      // renamed the server in their config can substitute their name.\n      const pending: AgentConnectPendingToken = {\n        token: msg.token,\n        tid: msg.tid,\n        lapUrl: msg.lapUrl,\n        connectSnippet:\n          `Connect this AI assistant to the LLui app. Call the LLui MCP server's ` +\n          `\\`connect_session\\` tool with url=${JSON.stringify(msg.lapUrl)} and ` +\n          `token=${JSON.stringify(msg.token)}. ` +\n          `(Some MCP clients namespace tools as ` +\n          `\\`mcp__llui__connect_session\\` and load them lazily — search the tool list if \\`connect_session\\` isn't immediately available.)`,\n        expiresAt: msg.expiresAt,\n        wsUrl: msg.wsUrl,\n      }\n      return [\n        {\n          ...state,\n          status: 'pending-claude',\n          pendingToken: pending,\n          error: null,\n          reconnectAttempt: 0,\n          reconnectElapsedMs: 0,\n        },\n        [\n          { type: 'AgentOpenWS', token: msg.token, wsUrl: msg.wsUrl },\n          // Persist alongside opening the WS so the host can store the\n          // credentials in sessionStorage; on page refresh, app boot\n          // dispatches `RestoreSession` with the same shape and we\n          // re-enter the same state without re-minting.\n          {\n            type: 'AgentSessionPersist',\n            token: msg.token,\n            tid: msg.tid,\n            lapUrl: msg.lapUrl,\n            wsUrl: msg.wsUrl,\n            expiresAt: msg.expiresAt,\n          },\n        ],\n      ]\n    }\n    case 'RestoreSession': {\n      // Idempotent guard: only fires from idle. A racing Mint click\n      // would already have moved us to `minting` — restoring on top\n      // would clobber the in-flight pending state with stale\n      // credentials read from sessionStorage. Easier to no-op here\n      // than to coordinate the race in the host.\n      if (state.status !== 'idle') return [state, []]\n      // Regenerate the connectSnippet so the user can re-paste if\n      // their AI lost the original tool call (same shape as\n      // MintSucceeded — the framework owns this string and updates\n      // to it ride along the agent package version).\n      const restored: AgentConnectPendingToken = {\n        token: msg.token,\n        tid: msg.tid,\n        lapUrl: msg.lapUrl,\n        connectSnippet:\n          `Connect this AI assistant to the LLui app. Call the LLui MCP server's ` +\n          `\\`connect_session\\` tool with url=${JSON.stringify(msg.lapUrl)} and ` +\n          `token=${JSON.stringify(msg.token)}. ` +\n          `(Some MCP clients namespace tools as ` +\n          `\\`mcp__llui__connect_session\\` and load them lazily — search the tool list if \\`connect_session\\` isn't immediately available.)`,\n        expiresAt: msg.expiresAt,\n        wsUrl: msg.wsUrl,\n      }\n      return [\n        {\n          ...state,\n          status: 'pending-claude',\n          pendingToken: restored,\n          error: null,\n          reconnectAttempt: 0,\n          reconnectElapsedMs: 0,\n        },\n        [{ type: 'AgentOpenWS', token: msg.token, wsUrl: msg.wsUrl }],\n      ]\n    }\n    case 'MintFailed':\n      return [{ ...state, status: 'error', error: msg.error }, []]\n    case 'WsOpened': {\n      // WS is open but Claude hasn't bound yet; stay at pending-claude.\n      // If we were `reconnecting`, this is a successful reattach —\n      // back to pending-claude and reset the attempt counters.\n      if (state.status === 'reconnecting') {\n        return [\n          { ...state, status: 'pending-claude', reconnectAttempt: 0, reconnectElapsedMs: 0 },\n          [],\n        ]\n      }\n      return [state, []]\n    }\n    case 'WsClosed': {\n      // Three cases:\n      //   1. We had no pendingToken (already idle / pre-mint) → no-op.\n      //   2. Status is `idle` or `failed` (Disconnect already cleared,\n      //      or we previously gave up) → no-op so a delayed close\n      //      event after Disconnect doesn't accidentally restart the\n      //      loop.\n      //   3. We're connected/connecting and the close was unsolicited\n      //      → schedule a reconnect with backoff.\n      if (state.pendingToken === null) return [{ ...state, status: 'idle' }, []]\n      if (state.status === 'idle' || state.status === 'failed') return [state, []]\n      const delayMs = reconnectDelayMs(state.reconnectAttempt)\n      return [\n        { ...state, status: 'reconnecting', error: null },\n        [{ type: 'AgentReconnectSchedule', delayMs }],\n      ]\n    }\n    case 'ReconnectAttempt': {\n      // Backoff timer fired. If the user disconnected in the gap, we\n      // moved to idle and ignore. Otherwise, increment attempt + add\n      // the elapsed delay to the cumulative window. Past the give-up\n      // ceiling, transition to `failed` so the UI can offer a manual\n      // reconnect; otherwise re-open the WS with the cached\n      // credentials (no mint, same token — the server's grace window\n      // is what makes this transparent to the agent).\n      if (state.status !== 'reconnecting' || state.pendingToken === null) {\n        return [state, []]\n      }\n      const newElapsed = state.reconnectElapsedMs + msg.elapsedMs\n      if (newElapsed >= RECONNECT_GIVE_UP_MS) {\n        return [{ ...state, status: 'failed', reconnectElapsedMs: newElapsed }, []]\n      }\n      return [\n        {\n          ...state,\n          reconnectAttempt: state.reconnectAttempt + 1,\n          reconnectElapsedMs: newElapsed,\n        },\n        [\n          {\n            type: 'AgentOpenWS',\n            token: state.pendingToken.token,\n            wsUrl: state.pendingToken.wsUrl,\n          },\n        ],\n      ]\n    }\n    case 'ReconnectGaveUp':\n      return [{ ...state, status: 'failed' }, []]\n    case 'Disconnect': {\n      // User-initiated. Revoke the active tid (server kills the\n      // pairing), wipe the persisted credentials so a refresh can't\n      // restore them, and zero the reconnect counters so any in-\n      // flight backoff timer that fires post-disconnect becomes a\n      // no-op (the status guard in `ReconnectAttempt` keeps it from\n      // re-opening the WS).\n      const tid = state.pendingToken?.tid\n      const effects: AgentEffect[] = []\n      if (tid !== undefined) effects.push({ type: 'AgentRevoke', tid })\n      effects.push({ type: 'AgentSessionClear' })\n      effects.push({ type: 'AgentCloseWS' })\n      return [\n        {\n          ...state,\n          status: 'idle',\n          pendingToken: null,\n          error: null,\n          reconnectAttempt: 0,\n          reconnectElapsedMs: 0,\n        },\n        effects,\n      ]\n    }\n    case 'ActivatedByClaude':\n      return [{ ...state, status: 'active' }, []]\n    case 'ResumeList':\n      return [state, [{ type: 'AgentResumeCheck', tids: msg.tids }]]\n    case 'ResumeListLoaded':\n      return [{ ...state, resumable: msg.sessions }, []]\n    case 'Resume':\n      return [state, [{ type: 'AgentResumeClaim', tid: msg.tid }]]\n    case 'Revoke': {\n      // Optimistically remove from sessions + resumable. If the\n      // revoked tid matches the currently-pending session, also fire\n      // AgentSessionClear so the host wipes its persisted credentials\n      // — otherwise a refresh would try to RestoreSession with a\n      // server-side-revoked token and end up at an auth-failed WS.\n      const isActiveTid = state.pendingToken !== null && state.pendingToken.tid === msg.tid\n      const effects: AgentEffect[] = [{ type: 'AgentRevoke', tid: msg.tid }]\n      if (isActiveTid) effects.push({ type: 'AgentSessionClear' })\n      return [\n        {\n          ...state,\n          sessions: state.sessions.filter((s) => s.tid !== msg.tid),\n          resumable: state.resumable.filter((s) => s.tid !== msg.tid),\n        },\n        effects,\n      ]\n    }\n    case 'ClearError':\n      return [{ ...state, error: null }, []]\n    case 'SessionsLoaded':\n      return [{ ...state, sessions: msg.sessions }, []]\n    case 'RefreshSessions':\n      return [state, [{ type: 'AgentSessionsList' }]]\n    case 'CopyConnectSnippet': {\n      // No-op when there's no pending token — the button's\n      // `disabled` accessor already gates the click, but we accept\n      // the message for runtime safety.\n      if (!state.pendingToken) return [state, []]\n      return [state, [{ type: 'AgentClipboardWrite', text: state.pendingToken.connectSnippet }]]\n    }\n  }\n}\n\n// ── Connect helper ────────────────────────────────────────────────────────────\n\nexport type AgentConnectConnectOptions = {\n  id?: string // optional DOM id prefix\n}\n\n/**\n * Static prop bag with reactive accessors. Mirrors the @llui/components\n * pattern (e.g. `dialog.connect`): callers spread bag keys directly\n * into element helpers, and function-valued props re-evaluate per\n * binding-mask hit. The previous shape — `(state) => bag` — required\n * callers to wrap every prop access in their own arrow, which the\n * documented usage didn't do (and silently produced `undefined` props\n * when spread).\n */\nexport type ConnectBag<S> = {\n  root: { 'data-scope': 'agent-connect'; 'data-state': (s: S) => AgentConnectStatus }\n  mintTrigger: { onClick: () => void; disabled: (s: S) => boolean }\n  pendingTokenBox: { 'data-part': 'pending-token'; 'data-visible': (s: S) => boolean }\n  copyConnectSnippetButton: { onClick: () => void; disabled: (s: S) => boolean }\n  sessionsList: { 'data-part': 'sessions-list' }\n  sessionItem: (tid: string) => { 'data-part': 'session-item'; 'data-tid': string }\n  revokeButton: (tid: string) => { onClick: () => void }\n  resumeBanner: { 'data-part': 'resume-banner'; 'data-visible': (s: S) => boolean }\n  resumeItem: (tid: string) => { 'data-part': 'resume-item'; 'data-tid': string }\n  resumeButton: (tid: string) => { onClick: () => void }\n  dismissButton: (tid: string) => { onClick: () => void }\n  error: {\n    'data-part': 'error'\n    'data-visible': (s: S) => boolean\n    onClick: () => void\n  }\n}\n\n/**\n * Builds prop bags for the view. Static-bag-with-reactive-accessors\n * shape (matches the @llui/components convention); spread directly\n * into element helpers.\n */\nexport function connect<S>(\n  get: (s: S) => AgentConnectState,\n  send: Send<AgentConnectMsg>,\n  _opts: AgentConnectConnectOptions = {},\n): ConnectBag<S> {\n  return {\n    root: {\n      'data-scope': 'agent-connect',\n      'data-state': (s) => get(s).status,\n    },\n    mintTrigger: {\n      onClick: tagSend(send, ['Mint'], () => send({ type: 'Mint' })),\n      disabled: (s) => {\n        const cs = get(s)\n        return cs.status === 'minting' || cs.status === 'pending-claude' || cs.status === 'active'\n      },\n    },\n    pendingTokenBox: {\n      'data-part': 'pending-token',\n      'data-visible': (s) => get(s).pendingToken !== null,\n    },\n    copyConnectSnippetButton: {\n      // The handler reads state at click time via the Msg/effect path:\n      // CopyConnectSnippet → update() reads pendingToken.connectSnippet\n      // → effect AgentClipboardWrite writes to navigator.clipboard.\n      // Routing through update() keeps state reads out of event\n      // handlers, which is what makes the static-bag-with-reactive-\n      // accessors shape work cleanly.\n      onClick: tagSend(send, ['CopyConnectSnippet'], () => send({ type: 'CopyConnectSnippet' })),\n      disabled: (s) => get(s).pendingToken === null,\n    },\n    sessionsList: { 'data-part': 'sessions-list' },\n    sessionItem: (tid) => ({ 'data-part': 'session-item', 'data-tid': tid }),\n    revokeButton: (tid) => ({\n      onClick: tagSend(send, ['Revoke'], () => send({ type: 'Revoke', tid })),\n    }),\n    resumeBanner: {\n      'data-part': 'resume-banner',\n      'data-visible': (s) => get(s).resumable.length > 0,\n    },\n    resumeItem: (tid) => ({ 'data-part': 'resume-item', 'data-tid': tid }),\n    resumeButton: (tid) => ({\n      onClick: tagSend(send, ['Resume'], () => send({ type: 'Resume', tid })),\n    }),\n    dismissButton: (tid) => ({\n      // For dismiss, we currently just remove the resumable record\n      // locally. A \"dismiss forever\" flag could land in a follow-up;\n      // for v1, dismiss is a client-side-only state prune by reusing\n      // the Revoke Msg path with intent-split; for now emit Revoke\n      // which both revokes server-side AND removes locally.\n      onClick: tagSend(send, ['Revoke'], () => send({ type: 'Revoke', tid })),\n    }),\n    error: {\n      'data-part': 'error',\n      'data-visible': (s) => get(s).error !== null,\n      onClick: tagSend(send, ['ClearError'], () => send({ type: 'ClearError' })),\n    },\n  }\n}\n"]}

package/dist/client/effect-handler.d.ts

@@ -1,4 +1,5 @@
 import type { AgentEffect } from './effects.js';
+import type { AgentSessionStorage } from './factory.js';
 export type EffectHandlerHost = {
     send(msg: unknown): void;
     /** Wraps an agentConnect msg into an app-Msg. */
@@ -10,6 +11,16 @@ export type EffectHandlerHost = {
     /** Called before opening WS / on WS lifecycle events. */
     openWs(token: string, wsUrl: string): void;
     closeWs(): void;
+    /**
+     * Optional storage adapter. When set, `AgentSessionPersist` writes
+     * to it and `AgentSessionClear` clears it; the host doesn't need
+     * to handle these effects itself. When `null` or `undefined`, the
+     * effects no-op here and host code (if any) handles them in the
+     * outer effect router. The factory passes
+     * `defaultSessionStorage()` by default, so the framework is
+     * refresh-survival-ready out of the box.
+     */
+    sessionStorage?: AgentSessionStorage | null;
     /**
      * Base path for agent HTTP endpoints. Default: `'/agent'` (matches
      * the canonical paths in `@llui/vite-plugin`'s dev middleware and

package/dist/client/effect-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect-handler.d.ts","sourceRoot":"","sources":["../../src/client/effect-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAQ/C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,iDAAiD;IACjD,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IACrC,0EAA0E;IAC1E,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,yDAAyD;IACzD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C,OAAO,IAAI,IAAI,CAAA;IACf;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,IAG5B,QAAQ,WAAW,KAAG,OAAO,CAAC,IAAI,CAAC,CAsBjE"}
+{"version":3,"file":"effect-handler.d.ts","sourceRoot":"","sources":["../../src/client/effect-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAO/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,iDAAiD;IACjD,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IACrC,0EAA0E;IAC1E,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,yDAAyD;IACzD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C,OAAO,IAAI,IAAI,CAAA;IACf;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAC3C;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,IAG5B,QAAQ,WAAW,KAAG,OAAO,CAAC,IAAI,CAAC,CA0CjE"}

package/dist/client/effect-handler.js

@@ -28,9 +28,38 @@ export function createEffectHandler(host) {
                 return handleForwardMsg(host, effect);
             case 'AgentClipboardWrite':
                 return handleClipboardWrite(effect);
+            case 'AgentSessionPersist':
+                // Framework-owned when a storage adapter is configured;
+                // otherwise no-op and let the host's outer effect router
+                // handle it (the legacy contract). See factory.ts'
+                // `sessionStorage` option.
+                if (host.sessionStorage) {
+                    host.sessionStorage.write({
+                        token: effect.token,
+                        tid: effect.tid,
+                        lapUrl: effect.lapUrl,
+                        wsUrl: effect.wsUrl,
+                        expiresAt: effect.expiresAt,
+                    });
+                }
+                return;
+            case 'AgentSessionClear':
+                if (host.sessionStorage)
+                    host.sessionStorage.clear();
+                return;
+            case 'AgentReconnectSchedule':
+                return handleReconnectSchedule(host, effect);
         }
     };
 }
+async function handleReconnectSchedule(host, effect) {
+    // Single-shot timer. The reducer owns cancellation semantics via
+    // the status guard in `ReconnectAttempt` — if the user dispatches
+    // `Disconnect` while we're sleeping, the dispatched message hits
+    // an `idle` reducer and is a no-op. No cancel handle needed.
+    await new Promise((resolve) => setTimeout(resolve, effect.delayMs));
+    host.send(host.wrapAgentConnect({ type: 'ReconnectAttempt', elapsedMs: effect.delayMs }));
+}
 // ── HTTP-bound handlers ─────────────────────────────────────────────
 async function handleMintRequest(host, effect, doFetch) {
     // Derive a default `mintUrl` from `agentBasePath` so consumers can