@llui/agent 0.0.32 → 0.0.35

package/dist/client/agentConnect.js

@@ -1,3 +1,4 @@
+import { tagSend } from '@llui/dom';
 /** Component shape is [State, Effect[]] — consistent with @llui/components. */
 export function init(_opts) {
     return [
@@ -11,19 +12,34 @@ export function init(_opts) {
         [],
     ];
 }
-export function update(state, msg, opts) {
+export function update(state, msg, opts = {}) {
     switch (msg.type) {
-        case 'Mint':
-            return [
-                { ...state, status: 'minting' },
-                [{ type: 'AgentMintRequest', mintUrl: opts.mintUrl }],
-            ];
+        case 'Mint': {
+            // mintUrl: undefined means "let the effect handler derive it
+            // from agentBasePath". Only include the property when explicitly
+            // set, so the effect's discriminated shape stays clean.
+            const mintEffect = opts.mintUrl !== undefined
+                ? { type: 'AgentMintRequest', mintUrl: opts.mintUrl }
+                : { type: 'AgentMintRequest' };
+            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.
             const pending = {
                 token: msg.token,
                 tid: msg.tid,
                 lapUrl: msg.lapUrl,
-                connectSnippet: `/llui-connect ${msg.lapUrl} ${msg.token}`,
+                connectSnippet: `Connect this Claude session 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.)`,
                 expiresAt: msg.expiresAt,
             };
             return [
@@ -63,52 +79,74 @@ export function update(state, msg, opts) {
             return [{ ...state, sessions: msg.sessions }, []];
         case 'RefreshSessions':
             return [state, [{ type: 'AgentSessionsList' }]];
+        case 'CopyConnectSnippet': {
+            // No-op when there's no pending token — the button's
+            // `disabled` accessor already gates the click, but we accept
+            // the message for runtime safety.
+            if (!state.pendingToken)
+                return [state, []];
+            return [state, [{ type: 'AgentClipboardWrite', text: state.pendingToken.connectSnippet }]];
+        }
     }
 }
 /**
- * Builds prop bags for the view. See spec §9.1 and the @llui/components
- * dialog.ts pattern.
+ * Builds prop bags for the view. Static-bag-with-reactive-accessors
+ * shape (matches the @llui/components convention); spread directly
+ * into element helpers.
  */
 export function connect(get, send, _opts = {}) {
-    return (state) => {
-        const s = get(state);
-        return {
-            root: { 'data-scope': 'agent-connect', 'data-state': s.status },
-            mintTrigger: {
-                onClick: () => send({ type: 'Mint' }),
-                disabled: s.status === 'minting' || s.status === 'pending-claude' || s.status === 'active',
-            },
-            pendingTokenBox: { 'data-part': 'pending-token', 'data-visible': s.pendingToken !== null },
-            copyConnectSnippetButton: {
-                onClick: () => {
-                    if (s.pendingToken && typeof navigator !== 'undefined' && 'clipboard' in navigator) {
-                        void navigator.clipboard.writeText(s.pendingToken.connectSnippet);
-                    }
-                },
-                disabled: s.pendingToken === null,
-            },
-            sessionsList: { 'data-part': 'sessions-list' },
-            sessionItem: (tid) => ({ 'data-part': 'session-item', 'data-tid': tid }),
-            revokeButton: (tid) => ({ onClick: () => send({ type: 'Revoke', tid }) }),
-            resumeBanner: { 'data-part': 'resume-banner', 'data-visible': s.resumable.length > 0 },
-            resumeItem: (tid) => ({ 'data-part': 'resume-item', 'data-tid': tid }),
-            resumeButton: (tid) => ({ onClick: () => send({ type: 'Resume', tid }) }),
-            dismissButton: (tid) => ({
-                // For dismiss, we currently just remove the resumable record locally.
-                // A "dismiss forever" flag could land in a follow-up; for v1, dismiss
-                // is a client-side-only state prune by reusing the Revoke Msg path
-                // with intent-split; for now Emit Revoke which both revokes server-side
-                // AND removes locally. Alternative: emit a new DismissResume msg —
-                // spec §9.1 lists dismissButton but doesn't spell out the emitted msg.
-                // V1 pragmatic choice: same as revoke (mark revoked on server).
-                onClick: () => send({ type: 'Revoke', tid }),
-            }),
-            error: {
-                'data-part': 'error',
-                'data-visible': s.error !== null,
-                onClick: () => send({ type: 'ClearError' }),
+    return {
+        root: {
+            'data-scope': 'agent-connect',
+            'data-state': (s) => get(s).status,
+        },
+        mintTrigger: {
+            onClick: tagSend(send, ['Mint'], () => send({ type: 'Mint' })),
+            disabled: (s) => {
+                const cs = get(s);
+                return cs.status === 'minting' || cs.status === 'pending-claude' || cs.status === 'active';
             },
-        };
+        },
+        pendingTokenBox: {
+            'data-part': 'pending-token',
+            'data-visible': (s) => get(s).pendingToken !== null,
+        },
+        copyConnectSnippetButton: {
+            // The handler reads state at click time via the Msg/effect path:
+            // CopyConnectSnippet → update() reads pendingToken.connectSnippet
+            // → effect AgentClipboardWrite writes to navigator.clipboard.
+            // Routing through update() keeps state reads out of event
+            // handlers, which is what makes the static-bag-with-reactive-
+            // accessors shape work cleanly.
+            onClick: tagSend(send, ['CopyConnectSnippet'], () => send({ type: 'CopyConnectSnippet' })),
+            disabled: (s) => get(s).pendingToken === null,
+        },
+        sessionsList: { 'data-part': 'sessions-list' },
+        sessionItem: (tid) => ({ 'data-part': 'session-item', 'data-tid': tid }),
+        revokeButton: (tid) => ({
+            onClick: tagSend(send, ['Revoke'], () => send({ type: 'Revoke', tid })),
+        }),
+        resumeBanner: {
+            'data-part': 'resume-banner',
+            'data-visible': (s) => get(s).resumable.length > 0,
+        },
+        resumeItem: (tid) => ({ 'data-part': 'resume-item', 'data-tid': tid }),
+        resumeButton: (tid) => ({
+            onClick: tagSend(send, ['Resume'], () => send({ type: 'Resume', tid })),
+        }),
+        dismissButton: (tid) => ({
+            // For dismiss, we currently just remove the resumable record
+            // locally. A "dismiss forever" flag could land in a follow-up;
+            // for v1, dismiss is a client-side-only state prune by reusing
+            // the Revoke Msg path with intent-split; for now emit Revoke
+            // which both revokes server-side AND removes locally.
+            onClick: tagSend(send, ['Revoke'], () => send({ type: 'Revoke', tid })),
+        }),
+        error: {
+            'data-part': 'error',
+            'data-visible': (s) => get(s).error !== null,
+            onClick: tagSend(send, ['ClearError'], () => send({ type: 'ClearError' })),
+        },
     };
 }
 //# sourceMappingURL=agentConnect.js.map

package/dist/client/agentConnect.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentConnect.js","sourceRoot":"","sources":["../../src/client/agentConnect.ts"],"names":[],"mappings":"AA8CA,+EAA+E;AAC/E,MAAM,UAAU,IAAI,CAAC,KAA2B;IAC9C,OAAO;QACL;YACE,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,IAAI;SACZ;QACD,EAAE;KACH,CAAA;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,KAAwB,EACxB,GAAoB,EACpB,IAA0B;IAE1B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO;gBACL,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;gBAC/B,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;aACtD,CAAA;QACH,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,OAAO,GAA6B;gBACxC,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,cAAc,EAAE,iBAAiB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE;gBAC1D,SAAS,EAAE,GAAG,CAAC,SAAS;aACzB,CAAA;YACD,OAAO;gBACL,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE;gBAC1E,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;aAC9D,CAAA;QACH,CAAC;QACD,KAAK,YAAY;YACf,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;QAC9D,KAAK,UAAU;YACb,kEAAkE;YAClE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QACpB,KAAK,UAAU;YACb,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;QAC/D,KAAK,mBAAmB;YACtB,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;QAC7C,KAAK,YAAY;YACf,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAChE,KAAK,kBAAkB;YACrB,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;QACpD,KAAK,QAAQ;YACX,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QAC9D,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,mDAAmD;YACnD,OAAO;gBACL;oBACE,GAAG,KAAK;oBACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC;oBACzD,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC;iBAC5D;gBACD,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;aACxC,CAAA;QACH,CAAC;QACD,KAAK,YAAY;YACf,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;QACxC,KAAK,gBAAgB;YACnB,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;QACnD,KAAK,iBAAiB;YACpB,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAA;IACnD,CAAC;AACH,CAAC;AAuBD;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,GAAgC,EAChC,IAA2B,EAC3B,QAAoC,EAAE;IAEtC,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAA;QACpB,OAAO;YACL,IAAI,EAAE,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YAC/D,WAAW,EAAE;gBACX,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,gBAAgB,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;aAC3F;YACD,eAAe,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,CAAC,YAAY,KAAK,IAAI,EAAE;YAC1F,wBAAwB,EAAE;gBACxB,OAAO,EAAE,GAAG,EAAE;oBACZ,IAAI,CAAC,CAAC,YAAY,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;wBACnF,KAAK,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;oBACnE,CAAC;gBACH,CAAC;gBACD,QAAQ,EAAE,CAAC,CAAC,YAAY,KAAK,IAAI;aAClC;YACD,YAAY,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE;YAC9C,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;YACxE,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YACzE,YAAY,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;YACtF,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;YACtE,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YACzE,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACvB,sEAAsE;gBACtE,sEAAsE;gBACtE,mEAAmE;gBACnE,wEAAwE;gBACxE,mEAAmE;gBACnE,uEAAuE;gBACvE,gEAAgE;gBAChE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;aAC7C,CAAC;YACF,KAAK,EAAE;gBACL,WAAW,EAAE,OAAO;gBACpB,cAAc,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI;gBAChC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;aAC5C;SACF,CAAA;IACH,CAAC,CAAA;AACH,CAAC","sourcesContent":["import 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  connectSnippet: string // \"/llui-connect <lapUrl> <token>\"\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  | { type: 'Mint' }\n  | {\n      type: 'MintSucceeded'\n      token: AgentToken\n      tid: string\n      lapUrl: string\n      wsUrl: string\n      expiresAt: number\n    }\n  | { type: 'MintFailed'; error: { code: string; detail: string } }\n  | { type: 'WsOpened' }\n  | { type: 'WsClosed' }\n  | { type: 'ActivatedByClaude' }\n  | { type: 'ResumeList'; tids: string[] }\n  | { type: 'ResumeListLoaded'; sessions: AgentSession[] }\n  | { type: 'Resume'; tid: string }\n  | { type: 'Revoke'; tid: string }\n  | { type: 'ClearError' }\n  | { type: 'SessionsLoaded'; sessions: AgentSession[] }\n  | { type: 'RefreshSessions' }\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      return [\n        { ...state, status: 'minting' },\n        [{ type: 'AgentMintRequest', mintUrl: opts.mintUrl }],\n      ]\n    case 'MintSucceeded': {\n      const pending: AgentConnectPendingToken = {\n        token: msg.token,\n        tid: msg.tid,\n        lapUrl: msg.lapUrl,\n        connectSnippet: `/llui-connect ${msg.lapUrl} ${msg.token}`,\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  }\n}\n\n// ── Connect helper ────────────────────────────────────────────────────────────\n\nexport type AgentConnectConnectOptions = {\n  id?: string // optional DOM id prefix\n}\n\ntype ConnectBag = {\n  root: { 'data-scope': string; 'data-state': string }\n  mintTrigger: { onClick: () => void; disabled: boolean }\n  pendingTokenBox: { 'data-part': string; 'data-visible': boolean }\n  copyConnectSnippetButton: { onClick: () => void; disabled: boolean }\n  sessionsList: { 'data-part': string }\n  sessionItem: (tid: string) => { 'data-part': string; 'data-tid': string }\n  revokeButton: (tid: string) => { onClick: () => void }\n  resumeBanner: { 'data-part': string; 'data-visible': boolean }\n  resumeItem: (tid: string) => { 'data-part': string; 'data-tid': string }\n  resumeButton: (tid: string) => { onClick: () => void }\n  dismissButton: (tid: string) => { onClick: () => void }\n  error: { 'data-part': string; 'data-visible': boolean; onClick: () => void }\n}\n\n/**\n * Builds prop bags for the view. See spec §9.1 and the @llui/components\n * dialog.ts pattern.\n */\nexport function connect<S>(\n  get: (s: S) => AgentConnectState,\n  send: Send<AgentConnectMsg>,\n  _opts: AgentConnectConnectOptions = {},\n): (state: S) => ConnectBag {\n  return (state) => {\n    const s = get(state)\n    return {\n      root: { 'data-scope': 'agent-connect', 'data-state': s.status },\n      mintTrigger: {\n        onClick: () => send({ type: 'Mint' }),\n        disabled: s.status === 'minting' || s.status === 'pending-claude' || s.status === 'active',\n      },\n      pendingTokenBox: { 'data-part': 'pending-token', 'data-visible': s.pendingToken !== null },\n      copyConnectSnippetButton: {\n        onClick: () => {\n          if (s.pendingToken && typeof navigator !== 'undefined' && 'clipboard' in navigator) {\n            void navigator.clipboard.writeText(s.pendingToken.connectSnippet)\n          }\n        },\n        disabled: s.pendingToken === null,\n      },\n      sessionsList: { 'data-part': 'sessions-list' },\n      sessionItem: (tid) => ({ 'data-part': 'session-item', 'data-tid': tid }),\n      revokeButton: (tid) => ({ onClick: () => send({ type: 'Revoke', tid }) }),\n      resumeBanner: { 'data-part': 'resume-banner', 'data-visible': s.resumable.length > 0 },\n      resumeItem: (tid) => ({ 'data-part': 'resume-item', 'data-tid': tid }),\n      resumeButton: (tid) => ({ onClick: () => send({ type: 'Resume', tid }) }),\n      dismissButton: (tid) => ({\n        // For dismiss, we currently just remove the resumable record locally.\n        // A \"dismiss forever\" flag could land in a follow-up; for v1, dismiss\n        // is a client-side-only state prune by reusing the Revoke Msg path\n        // with intent-split; for now Emit Revoke which both revokes server-side\n        // AND removes locally. Alternative: emit a new DismissResume msg —\n        // spec §9.1 lists dismissButton but doesn't spell out the emitted msg.\n        // V1 pragmatic choice: same as revoke (mark revoked on server).\n        onClick: () => send({ type: 'Revoke', tid }),\n      }),\n      error: {\n        'data-part': 'error',\n        'data-visible': s.error !== null,\n        onClick: () => send({ type: 'ClearError' }),\n      },\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 = '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"]}

package/dist/client/agentLog.d.ts

@@ -11,41 +11,58 @@ export type AgentLogState = {
 export type AgentLogInitOpts = {
     maxEntries?: number;
 };
-export type AgentLogMsg = {
+export type AgentLogMsg = 
+/**
+ * @humanOnly — internal: WS frame router dispatches this on every
+ * `log-append` frame from the runtime. Agents observe the log via
+ * the LAP read surface, not by emitting Append themselves.
+ */
+{
     type: 'Append';
     entry: LogEntry;
-} | {
+}
+/** @intent("Clear the agent activity log") */
+ | {
     type: 'Clear';
-} | {
+}
+/** @intent("Set the visibility filter for the agent log") */
+ | {
     type: 'SetFilter';
     filter: AgentLogFilter;
 };
 export declare function init(_opts?: AgentLogInitOpts): [AgentLogState, AgentEffect[]];
 export declare function update(state: AgentLogState, msg: AgentLogMsg, opts?: AgentLogInitOpts): [AgentLogState, AgentEffect[]];
 import { type Send } from '@llui/dom';
-type ConnectBag = {
+/**
+ * Static prop bag with reactive accessors. See agentConnect.ts for
+ * the rationale.
+ *
+ * `visibleEntries` is exposed as a reactive accessor returning the
+ * filtered entry list — pass it to `each` directly:
+ *   each(bag.visibleEntries, (e) => …)
+ */
+export type ConnectBag<S> = {
     root: {
-        'data-scope': string;
+        'data-scope': 'agent-log';
     };
     list: {
-        'data-part': string;
-        'data-count': number;
+        'data-part': 'list';
+        'data-count': (s: S) => number;
     };
     entryItem: (id: string) => {
-        'data-part': string;
+        'data-part': 'entry';
         'data-id': string;
-        'data-kind': string;
-    } | null;
+        'data-kind': (s: S) => LogKind | 'missing';
+    };
     filterControls: {
         clearButton: {
             onClick: () => void;
-            disabled: boolean;
+            disabled: (s: S) => boolean;
         };
         setFilter: (filter: AgentLogFilter) => void;
     };
     /** Filtered view of entries — respects state.filter. */
-    visibleEntries: LogEntry[];
+    visibleEntries: (s: S) => LogEntry[];
 };
-export declare function connect<S>(get: (s: S) => AgentLogState, send: Send<AgentLogMsg>): (state: S) => ConnectBag;
-export {};
+export declare function connect<S>(get: (s: S) => AgentLogState, send: Send<AgentLogMsg>): ConnectBag<S>;
 //# sourceMappingURL=agentLog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agentLog.d.ts","sourceRoot":"","sources":["../../src/client/agentLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAEvD,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,QAAQ,EAAE,CAAA;IACnB,MAAM,EAAE,cAAc,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAA;AAIjD,wBAAgB,IAAI,CAAC,KAAK,GAAE,gBAAqB,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC,CAEjF;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,gBAAqB,GAC1B,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC,CAchC;AAGD,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9B,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACjG,cAAc,EAAE;QACd,WAAW,EAAE;YAAE,OAAO,EAAE,MAAM,IAAI,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,CAAA;QACvD,SAAS,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;KAC5C,CAAA;IACD,wDAAwD;IACxD,cAAc,EAAE,QAAQ,EAAE,CAAA;CAC3B,CAAA;AAED,wBAAgB,OAAO,CAAC,CAAC,EACvB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,aAAa,EAC5B,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,GACtB,CAAC,KAAK,EAAE,CAAC,KAAK,UAAU,CA0B1B"}
+{"version":3,"file":"agentLog.d.ts","sourceRoot":"","sources":["../../src/client/agentLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAEvD,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,QAAQ,EAAE,CAAA;IACnB,MAAM,EAAE,cAAc,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD,MAAM,MAAM,WAAW;AACrB;;;;GAIG;AACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE;AACrC,8CAA8C;GAC5C;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE;AACnB,6DAA6D;GAC3D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAA;AAIjD,wBAAgB,IAAI,CAAC,KAAK,GAAE,gBAAqB,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC,CAEjF;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,gBAAqB,GAC1B,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC,CAchC;AAGD,OAAO,EAAW,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AAM9C;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,IAAI,EAAE;QAAE,YAAY,EAAE,WAAW,CAAA;KAAE,CAAA;IACnC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;KAAE,CAAA;IAC7D,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QACzB,WAAW,EAAE,OAAO,CAAA;QACpB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,GAAG,SAAS,CAAA;KAC3C,CAAA;IACD,cAAc,EAAE;QACd,WAAW,EAAE;YAAE,OAAO,EAAE,MAAM,IAAI,CAAC;YAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;SAAE,CAAA;QACjE,SAAS,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;KAC5C,CAAA;IACD,wDAAwD;IACxD,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAA;CACrC,CAAA;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CA4C/F"}

package/dist/client/agentLog.js

@@ -19,35 +19,54 @@ export function update(state, msg, opts = {}) {
     }
 }
 // Connect bag:
-import {} from '@llui/dom';
+import { tagSend } from '@llui/dom';
+// Sentinel for the memoization slot — distinguishable from any
+// possible parent state value (including null/undefined).
+const UNSET = Symbol('agent-log-visible-unset');
 export function connect(get, send) {
-    return (state) => {
+    // Memoize the filter result by parent-state reference. Each render
+    // pass typically calls `visibleEntries`, `list['data-count']`, and
+    // every `entryItem(id)['data-kind']` — without this, an `each` loop
+    // over visibleEntries triggers O(n) filter recomputes per item.
+    // Parent state is immutable (TEA), so reference equality is enough.
+    // Using a single-slot cache rather than a WeakMap because consumers
+    // call from a hot path and a single recent state covers >99% of hits.
+    let lastState = UNSET;
+    let lastResult = [];
+    const visible = (state) => {
+        if (state === lastState)
+            return lastResult;
         const s = get(state);
-        const visible = s.entries.filter((e) => {
+        lastResult = s.entries.filter((e) => {
             if (s.filter.kinds && !s.filter.kinds.includes(e.kind))
                 return false;
             if (s.filter.since !== undefined && e.at < s.filter.since)
                 return false;
             return true;
         });
-        return {
-            root: { 'data-scope': 'agent-log' },
-            list: { 'data-part': 'list', 'data-count': visible.length },
-            entryItem: (id) => {
-                const e = visible.find((x) => x.id === id);
-                if (!e)
-                    return null;
-                return { 'data-part': 'entry', 'data-id': e.id, 'data-kind': e.kind };
-            },
-            filterControls: {
-                clearButton: {
-                    onClick: () => send({ type: 'Clear' }),
-                    disabled: s.entries.length === 0,
-                },
-                setFilter: (filter) => send({ type: 'SetFilter', filter }),
+        lastState = state;
+        return lastResult;
+    };
+    const findVisible = (state, id) => visible(state).find((x) => x.id === id);
+    return {
+        root: { 'data-scope': 'agent-log' },
+        list: {
+            'data-part': 'list',
+            'data-count': (s) => visible(s).length,
+        },
+        entryItem: (id) => ({
+            'data-part': 'entry',
+            'data-id': id,
+            'data-kind': (s) => findVisible(s, id)?.kind ?? 'missing',
+        }),
+        filterControls: {
+            clearButton: {
+                onClick: tagSend(send, ['Clear'], () => send({ type: 'Clear' })),
+                disabled: (s) => get(s).entries.length === 0,
             },
-            visibleEntries: visible,
-        };
+            setFilter: (filter) => send({ type: 'SetFilter', filter }),
+        },
+        visibleEntries: visible,
     };
 }
 //# sourceMappingURL=agentLog.js.map

package/dist/client/agentLog.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentLog.js","sourceRoot":"","sources":["../../src/client/agentLog.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentEffect } from './effects.js'\nimport type { LogEntry, LogKind } from '../protocol.js'\n\nexport type AgentLogFilter = { kinds?: LogKind[]; since?: number }\n\nexport type AgentLogState = {\n  entries: LogEntry[]\n  filter: AgentLogFilter\n}\n\nexport type AgentLogInitOpts = { maxEntries?: number } // default 100\n\nexport type AgentLogMsg =\n  | { type: 'Append'; entry: LogEntry }\n  | { type: 'Clear' }\n  | { type: 'SetFilter'; filter: AgentLogFilter }\n\nconst DEFAULT_MAX = 100\n\nexport function init(_opts: AgentLogInitOpts = {}): [AgentLogState, AgentEffect[]] {\n  return [{ entries: [], filter: {} }, []]\n}\n\nexport function update(\n  state: AgentLogState,\n  msg: AgentLogMsg,\n  opts: AgentLogInitOpts = {},\n): [AgentLogState, AgentEffect[]] {\n  const max = opts.maxEntries ?? DEFAULT_MAX\n  switch (msg.type) {\n    case 'Append': {\n      const next = [...state.entries, msg.entry]\n      // Ring-buffer cap\n      if (next.length > max) next.splice(0, next.length - max)\n      return [{ ...state, entries: next }, []]\n    }\n    case 'Clear':\n      return [{ ...state, entries: [] }, []]\n    case 'SetFilter':\n      return [{ ...state, filter: msg.filter }, []]\n  }\n}\n\n// Connect bag:\nimport { type Send } from '@llui/dom'\n\ntype ConnectBag = {\n  root: { 'data-scope': string }\n  list: { 'data-part': string; 'data-count': number }\n  entryItem: (id: string) => { 'data-part': string; 'data-id': string; 'data-kind': string } | null\n  filterControls: {\n    clearButton: { onClick: () => void; disabled: boolean }\n    setFilter: (filter: AgentLogFilter) => void\n  }\n  /** Filtered view of entries — respects state.filter. */\n  visibleEntries: LogEntry[]\n}\n\nexport function connect<S>(\n  get: (s: S) => AgentLogState,\n  send: Send<AgentLogMsg>,\n): (state: S) => ConnectBag {\n  return (state) => {\n    const s = get(state)\n    const visible = s.entries.filter((e) => {\n      if (s.filter.kinds && !s.filter.kinds.includes(e.kind)) return false\n      if (s.filter.since !== undefined && e.at < s.filter.since) return false\n      return true\n    })\n    return {\n      root: { 'data-scope': 'agent-log' },\n      list: { 'data-part': 'list', 'data-count': visible.length },\n      entryItem: (id) => {\n        const e = visible.find((x) => x.id === id)\n        if (!e) return null\n        return { 'data-part': 'entry', 'data-id': e.id, 'data-kind': e.kind }\n      },\n      filterControls: {\n        clearButton: {\n          onClick: () => send({ type: 'Clear' }),\n          disabled: s.entries.length === 0,\n        },\n        setFilter: (filter) => send({ type: 'SetFilter', filter }),\n      },\n      visibleEntries: visible,\n    }\n  }\n}\n"]}
+{"version":3,"file":"agentLog.js","sourceRoot":"","sources":["../../src/client/agentLog.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentEffect } from './effects.js'\nimport type { LogEntry, LogKind } from '../protocol.js'\n\nexport type AgentLogFilter = { kinds?: LogKind[]; since?: number }\n\nexport type AgentLogState = {\n  entries: LogEntry[]\n  filter: AgentLogFilter\n}\n\nexport type AgentLogInitOpts = { maxEntries?: number } // default 100\n\nexport type AgentLogMsg =\n  /**\n   * @humanOnly — internal: WS frame router dispatches this on every\n   * `log-append` frame from the runtime. Agents observe the log via\n   * the LAP read surface, not by emitting Append themselves.\n   */\n  | { type: 'Append'; entry: LogEntry }\n  /** @intent(\"Clear the agent activity log\") */\n  | { type: 'Clear' }\n  /** @intent(\"Set the visibility filter for the agent log\") */\n  | { type: 'SetFilter'; filter: AgentLogFilter }\n\nconst DEFAULT_MAX = 100\n\nexport function init(_opts: AgentLogInitOpts = {}): [AgentLogState, AgentEffect[]] {\n  return [{ entries: [], filter: {} }, []]\n}\n\nexport function update(\n  state: AgentLogState,\n  msg: AgentLogMsg,\n  opts: AgentLogInitOpts = {},\n): [AgentLogState, AgentEffect[]] {\n  const max = opts.maxEntries ?? DEFAULT_MAX\n  switch (msg.type) {\n    case 'Append': {\n      const next = [...state.entries, msg.entry]\n      // Ring-buffer cap\n      if (next.length > max) next.splice(0, next.length - max)\n      return [{ ...state, entries: next }, []]\n    }\n    case 'Clear':\n      return [{ ...state, entries: [] }, []]\n    case 'SetFilter':\n      return [{ ...state, filter: msg.filter }, []]\n  }\n}\n\n// Connect bag:\nimport { tagSend, type Send } from '@llui/dom'\n\n// Sentinel for the memoization slot — distinguishable from any\n// possible parent state value (including null/undefined).\nconst UNSET: unique symbol = Symbol('agent-log-visible-unset')\n\n/**\n * Static prop bag with reactive accessors. See agentConnect.ts for\n * the rationale.\n *\n * `visibleEntries` is exposed as a reactive accessor returning the\n * filtered entry list — pass it to `each` directly:\n *   each(bag.visibleEntries, (e) => …)\n */\nexport type ConnectBag<S> = {\n  root: { 'data-scope': 'agent-log' }\n  list: { 'data-part': 'list'; 'data-count': (s: S) => number }\n  entryItem: (id: string) => {\n    'data-part': 'entry'\n    'data-id': string\n    'data-kind': (s: S) => LogKind | 'missing'\n  }\n  filterControls: {\n    clearButton: { onClick: () => void; disabled: (s: S) => boolean }\n    setFilter: (filter: AgentLogFilter) => void\n  }\n  /** Filtered view of entries — respects state.filter. */\n  visibleEntries: (s: S) => LogEntry[]\n}\n\nexport function connect<S>(get: (s: S) => AgentLogState, send: Send<AgentLogMsg>): ConnectBag<S> {\n  // Memoize the filter result by parent-state reference. Each render\n  // pass typically calls `visibleEntries`, `list['data-count']`, and\n  // every `entryItem(id)['data-kind']` — without this, an `each` loop\n  // over visibleEntries triggers O(n) filter recomputes per item.\n  // Parent state is immutable (TEA), so reference equality is enough.\n  // Using a single-slot cache rather than a WeakMap because consumers\n  // call from a hot path and a single recent state covers >99% of hits.\n  let lastState: S | typeof UNSET = UNSET\n  let lastResult: LogEntry[] = []\n  const visible = (state: S): LogEntry[] => {\n    if (state === lastState) return lastResult\n    const s = get(state)\n    lastResult = s.entries.filter((e) => {\n      if (s.filter.kinds && !s.filter.kinds.includes(e.kind)) return false\n      if (s.filter.since !== undefined && e.at < s.filter.since) return false\n      return true\n    })\n    lastState = state\n    return lastResult\n  }\n  const findVisible = (state: S, id: string): LogEntry | undefined =>\n    visible(state).find((x) => x.id === id)\n\n  return {\n    root: { 'data-scope': 'agent-log' },\n    list: {\n      'data-part': 'list',\n      'data-count': (s) => visible(s).length,\n    },\n    entryItem: (id) => ({\n      'data-part': 'entry',\n      'data-id': id,\n      'data-kind': (s) => findVisible(s, id)?.kind ?? 'missing',\n    }),\n    filterControls: {\n      clearButton: {\n        onClick: tagSend(send, ['Clear'], () => send({ type: 'Clear' })),\n        disabled: (s) => get(s).entries.length === 0,\n      },\n      setFilter: (filter) => send({ type: 'SetFilter', filter }),\n    },\n    visibleEntries: visible,\n  }\n}\n"]}

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

@@ -10,6 +10,29 @@ export type EffectHandlerHost = {
     /** Called before opening WS / on WS lifecycle events. */
     openWs(token: string, wsUrl: string): void;
     closeWs(): void;
+    /**
+     * Base path for agent HTTP endpoints. Default: `'/agent'` (matches
+     * the canonical paths in `@llui/vite-plugin`'s dev middleware and
+     * `@llui/agent/server/http/router.ts`).
+     *
+     * Override when the consumer ships `@cloudflare/vite-plugin` in
+     * dev — that plugin routes every non-`/cdn-cgi/*` path to the
+     * worker, shadowing canonical `/agent/*` URLs. The vite-plugin
+     * registers a parallel handler at `/cdn-cgi/agent/*`; pass
+     * `agentBasePath: '/cdn-cgi/agent'` here so the client hits that.
+     *
+     * Production deployments without cloudflare-vite leave this
+     * unset; the agent server's router serves the canonical paths.
+     */
+    agentBasePath?: string;
 };
+/**
+ * Top-level dispatcher. The switch is intentionally thin — each
+ * `case` delegates to a per-effect function below. Splitting was
+ * motivated by the previous 150-line monolith mixing HTTP, WS, and
+ * browser-only side effects in one switch; per-effect handlers are
+ * directly unit-testable and the dispatcher reads as a flat catalogue
+ * of supported effect types.
+ */
 export declare function createEffectHandler(host: EffectHandlerHost): (effect: AgentEffect) => Promise<void>;
 //# sourceMappingURL=effect-handler.d.ts.map

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;CAChB,CAAA;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,IAG5B,QAAQ,WAAW,KAAG,OAAO,CAAC,IAAI,CAAC,CAwHjE"}
+{"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"}