@llui/agent 0.0.42 → 0.0.44

package/dist/client/agentConnect.d.ts

@@ -104,6 +104,22 @@ 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;
 };
 /**
  * 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

@@ -24,26 +24,78 @@ 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)}. ` +
-                    `(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,
             };
             return [
                 { ...state, status: 'pending-claude', pendingToken: pending, error: null },
+                [
+                    { 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)}. ` +
+                    `(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,
+            };
+            return [
+                { ...state, status: 'pending-claude', pendingToken: restored, error: null },
                 [{ type: 'AgentOpenWS', token: msg.token, wsUrl: msg.wsUrl }],
             ];
         }
@@ -63,14 +115,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 = '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   * @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/**\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 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      }\n      return [\n        { ...state, status: 'pending-claude', pendingToken: pending, error: null },\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      }\n      return [\n        { ...state, status: 'pending-claude', pendingToken: restored, 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. 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.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;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,CA8BjE"}

package/dist/client/effect-handler.js

@@ -28,6 +28,14 @@ export function createEffectHandler(host) {
                 return handleForwardMsg(host, effect);
             case 'AgentClipboardWrite':
                 return handleClipboardWrite(effect);
+            case 'AgentSessionPersist':
+            case 'AgentSessionClear':
+                // Host-handled (sessionStorage write/clear). The framework
+                // emits these alongside MintSucceeded / Revoke so the host
+                // can survive a page refresh without invalidating the agent's
+                // token; we no-op here so the host's effect router is the
+                // single source of truth for the storage policy.
+                return;
         }
     };
 }

package/dist/client/effect-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"effect-handler.js","sourceRoot":"","sources":["../../src/client/effect-handler.ts"],"names":[],"mappings":"AAsCA;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAEpD,OAAO,KAAK,UAAU,MAAM,CAAC,MAAmB;QAC9C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,kBAAkB;gBACrB,OAAO,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;YACjD,KAAK,aAAa;gBAChB,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACnC,KAAK,cAAc;gBACjB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;YAC5B,KAAK,kBAAkB;gBACrB,OAAO,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;YACjD,KAAK,kBAAkB;gBACrB,OAAO,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;YACjD,KAAK,aAAa;gBAChB,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;YAC5C,KAAK,mBAAmB;gBACtB,OAAO,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC1C,KAAK,iBAAiB;gBACpB,OAAO,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACvC,KAAK,qBAAqB;gBACxB,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;QACvC,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,uEAAuE;AAEvE,KAAK,UAAU,iBAAiB,CAC9B,IAAuB,EACvB,MAA0D,EAC1D,OAAc;IAEd,mEAAmE;IACnE,iEAAiE;IACjE,mEAAmE;IACnE,6CAA6C;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,GAAG,IAAI,OAAO,CAAA;IAChD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;QAC9E,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAA;YAClC,IAAI,CAAC,IAAI,CACP,IAAI,CAAC,gBAAgB,CAAC;gBACpB,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE;aAC9C,CAAC,CACH,CAAA;YACD,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiB,CAAA;QAC/C,IAAI,CAAC,IAAI,CACP,IAAI,CAAC,gBAAgB,CAAC;YACpB,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CACH,CAAA;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,IAAI,CACP,IAAI,CAAC,gBAAgB,CAAC;YACpB,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE;SAC9C,CAAC,CACH,CAAA;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,IAAuB,EACvB,MAA0D,EAC1D,OAAc;IAEd,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,cAAc,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;SAC5C,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAM;QACnB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuB,CAAA;QACrD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,IAAuB,EACvB,MAA0D,EAC1D,OAAc;IAEd,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,eAAe,EAAE;YAChD,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;SAC1C,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAM;QACnB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAA;QACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,IAAuB,EACvB,MAAqD,EACrD,OAAc;IAEd,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,IAAI,SAAS,EAAE;YAC9B,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;SAC1C,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,IAAuB,EAAE,OAAc;IACvE,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,WAAW,EAAE;YAC5C,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,SAAS;SACvB,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAM;QACnB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqB,CAAA;QACnD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;AACH,CAAC;AAED,uEAAuE;AAEvE,SAAS,YAAY,CACnB,IAAuB,EACvB,MAAqD;IAErD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;AACzC,CAAC;AAED,SAAS,aAAa,CAAC,IAAuB;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAA;AAChB,CAAC;AAED,uEAAuE;AAEvE,SAAS,gBAAgB,CACvB,IAAuB,EACvB,MAAyD;IAEzD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAC9B,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,MAA6D;IAE7D,kEAAkE;IAClE,oEAAoE;IACpE,4DAA4D;IAC5D,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC;QAAE,OAAM;IAC3E,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;AACH,CAAC;AAED,uEAAuE;AAEvE,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,gEAAgE;IAChE,+DAA+D;IAC/D,wCAAwC;IACxC,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAA;IAC3D,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,eAAe,GAAG,eAAe,CAAA;AAEvC;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,IAAuB;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,IAAI,QAAQ,CAAA;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAC1D,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IACjD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,OAAO,GAAG,MAAM,GAAG,OAAO,EAAE,CAAA;AAC9B,CAAC","sourcesContent":["import type { AgentEffect } from './effects.js'\nimport type {\n  MintResponse,\n  ResumeListResponse,\n  ResumeClaimResponse,\n  SessionsResponse,\n} from '../protocol.js'\n\nexport type EffectHandlerHost = {\n  send(msg: unknown): void // root app send; wraps agent sub-msgs into the app Msg envelope\n  /** Wraps an agentConnect msg into an app-Msg. */\n  wrapAgentConnect(m: unknown): unknown\n  /** Called for AgentForwardMsg — the payload is re-dispatched via send. */\n  forward(payload: unknown): void\n  /** fetch for HTTP effects; override in tests. */\n  fetch?: typeof fetch\n  /** Called before opening WS / on WS lifecycle events. */\n  openWs(token: string, wsUrl: string): void\n  closeWs(): void\n  /**\n   * Base path for agent HTTP endpoints. Default: `'/agent'` (matches\n   * the canonical paths in `@llui/vite-plugin`'s dev middleware and\n   * `@llui/agent/server/http/router.ts`).\n   *\n   * Override when the consumer ships `@cloudflare/vite-plugin` in\n   * dev — that plugin routes every non-`/cdn-cgi/*` path to the\n   * worker, shadowing canonical `/agent/*` URLs. The vite-plugin\n   * registers a parallel handler at `/cdn-cgi/agent/*`; pass\n   * `agentBasePath: '/cdn-cgi/agent'` here so the client hits that.\n   *\n   * Production deployments without cloudflare-vite leave this\n   * unset; the agent server's router serves the canonical paths.\n   */\n  agentBasePath?: string\n}\n\ntype Fetch = typeof fetch\n\n/**\n * Top-level dispatcher. The switch is intentionally thin — each\n * `case` delegates to a per-effect function below. Splitting was\n * motivated by the previous 150-line monolith mixing HTTP, WS, and\n * browser-only side effects in one switch; per-effect handlers are\n * directly unit-testable and the dispatcher reads as a flat catalogue\n * of supported effect types.\n */\nexport function createEffectHandler(host: EffectHandlerHost) {\n  const doFetch = host.fetch ?? fetch.bind(globalThis)\n\n  return async function handle(effect: AgentEffect): Promise<void> {\n    switch (effect.type) {\n      case 'AgentMintRequest':\n        return handleMintRequest(host, effect, doFetch)\n      case 'AgentOpenWS':\n        return handleOpenWs(host, effect)\n      case 'AgentCloseWS':\n        return handleCloseWs(host)\n      case 'AgentResumeCheck':\n        return handleResumeCheck(host, effect, doFetch)\n      case 'AgentResumeClaim':\n        return handleResumeClaim(host, effect, doFetch)\n      case 'AgentRevoke':\n        return handleRevoke(host, effect, doFetch)\n      case 'AgentSessionsList':\n        return handleSessionsList(host, doFetch)\n      case 'AgentForwardMsg':\n        return handleForwardMsg(host, effect)\n      case 'AgentClipboardWrite':\n        return handleClipboardWrite(effect)\n    }\n  }\n}\n\n// ── HTTP-bound handlers ─────────────────────────────────────────────\n\nasync function handleMintRequest(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentMintRequest' }>,\n  doFetch: Fetch,\n): Promise<void> {\n  // Derive a default `mintUrl` from `agentBasePath` so consumers can\n  // change the base path in one place (the effect handler) without\n  // also having to keep the `agentConnect` opts in sync. `agentBase`\n  // accepts both absolute paths and full URLs.\n  const base = agentBase(host)\n  if (!base) return\n  const mintUrl = effect.mintUrl ?? `${base}/mint`\n  try {\n    const res = await doFetch(mintUrl, { method: 'POST', credentials: 'include' })\n    if (!res.ok) {\n      const detail = await safeText(res)\n      host.send(\n        host.wrapAgentConnect({\n          type: 'MintFailed',\n          error: { code: `http-${res.status}`, detail },\n        }),\n      )\n      return\n    }\n    const body = (await res.json()) as MintResponse\n    host.send(\n      host.wrapAgentConnect({\n        type: 'MintSucceeded',\n        token: body.token,\n        tid: body.tid,\n        lapUrl: body.lapUrl,\n        wsUrl: body.wsUrl,\n        expiresAt: body.expiresAt,\n      }),\n    )\n  } catch (e) {\n    host.send(\n      host.wrapAgentConnect({\n        type: 'MintFailed',\n        error: { code: 'network', detail: String(e) },\n      }),\n    )\n  }\n}\n\nasync function handleResumeCheck(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentResumeCheck' }>,\n  doFetch: Fetch,\n): Promise<void> {\n  const base = agentBase(host)\n  if (!base) return\n  try {\n    const res = await doFetch(`${base}/resume/list`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ tids: effect.tids }),\n    })\n    if (!res.ok) return\n    const body = (await res.json()) as ResumeListResponse\n    host.send(host.wrapAgentConnect({ type: 'ResumeListLoaded', sessions: body.sessions }))\n  } catch {\n    /* quiet failure; user can retry */\n  }\n}\n\nasync function handleResumeClaim(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentResumeClaim' }>,\n  doFetch: Fetch,\n): Promise<void> {\n  const base = agentBase(host)\n  if (!base) return\n  try {\n    const res = await doFetch(`${base}/resume/claim`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ tid: effect.tid }),\n    })\n    if (!res.ok) return\n    const body = (await res.json()) as ResumeClaimResponse\n    host.openWs(body.token, body.wsUrl)\n    host.send(host.wrapAgentConnect({ type: 'WsOpened' }))\n  } catch {\n    /* quiet */\n  }\n}\n\nasync function handleRevoke(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentRevoke' }>,\n  doFetch: Fetch,\n): Promise<void> {\n  const base = agentBase(host)\n  if (!base) return\n  try {\n    await doFetch(`${base}/revoke`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ tid: effect.tid }),\n    })\n  } catch {\n    /* quiet */\n  }\n}\n\nasync function handleSessionsList(host: EffectHandlerHost, doFetch: Fetch): Promise<void> {\n  const base = agentBase(host)\n  if (!base) return\n  try {\n    const res = await doFetch(`${base}/sessions`, {\n      method: 'GET',\n      credentials: 'include',\n    })\n    if (!res.ok) return\n    const body = (await res.json()) as SessionsResponse\n    host.send(host.wrapAgentConnect({ type: 'SessionsLoaded', sessions: body.sessions }))\n  } catch {\n    /* quiet */\n  }\n}\n\n// ── WS-bound handlers ───────────────────────────────────────────────\n\nfunction handleOpenWs(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentOpenWS' }>,\n): void {\n  host.openWs(effect.token, effect.wsUrl)\n}\n\nfunction handleCloseWs(host: EffectHandlerHost): void {\n  host.closeWs()\n}\n\n// ── Local handlers (no network) ─────────────────────────────────────\n\nfunction handleForwardMsg(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentForwardMsg' }>,\n): void {\n  host.forward(effect.payload)\n}\n\nasync function handleClipboardWrite(\n  effect: Extract<AgentEffect, { type: 'AgentClipboardWrite' }>,\n): Promise<void> {\n  // Browser-only — `navigator.clipboard` is undefined in Node/jsdom\n  // test environments. Silently no-op rather than throw, matching the\n  // rest of the agent effect handlers' failure-quiet pattern.\n  if (typeof navigator === 'undefined' || !('clipboard' in navigator)) return\n  try {\n    await navigator.clipboard.writeText(effect.text)\n  } catch {\n    /* quiet — clipboard permission denied or document not focused */\n  }\n}\n\n// ── Helpers ─────────────────────────────────────────────────────────\n\nasync function safeText(res: Response): Promise<string> {\n  try {\n    return await res.text()\n  } catch {\n    return ''\n  }\n}\n\nfunction deriveOrigin(): string | null {\n  // When running in the browser, `location.origin` is correct for\n  // same-origin agent endpoints. Tests override `host.fetch` and\n  // short-circuit before this is reached.\n  if (typeof location !== 'undefined') return location.origin\n  return null\n}\n\nconst ABSOLUTE_URL_RE = /^https?:\\/\\//i\n\n/**\n * Resolve the absolute base URL for agent HTTP endpoints. Accepts both\n * absolute paths (`/agent`) and full URLs (`https://api.example/agent`)\n * — the absolute URL form lets consumers point at a cross-origin agent\n * server without pre-composing every endpoint URL. Trailing slashes\n * are normalized so callers can always concatenate `${base}/mint`.\n */\nfunction agentBase(host: EffectHandlerHost): string | null {\n  const raw = host.agentBasePath ?? '/agent'\n  const trimmed = raw.endsWith('/') ? raw.slice(0, -1) : raw\n  if (ABSOLUTE_URL_RE.test(trimmed)) return trimmed\n  const origin = deriveOrigin()\n  if (!origin) return null\n  return `${origin}${trimmed}`\n}\n"]}
+{"version":3,"file":"effect-handler.js","sourceRoot":"","sources":["../../src/client/effect-handler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentEffect } from './effects.js'\nimport type {\n  MintResponse,\n  ResumeListResponse,\n  ResumeClaimResponse,\n  SessionsResponse,\n} from '../protocol.js'\n\nexport type EffectHandlerHost = {\n  send(msg: unknown): void // root app send; wraps agent sub-msgs into the app Msg envelope\n  /** Wraps an agentConnect msg into an app-Msg. */\n  wrapAgentConnect(m: unknown): unknown\n  /** Called for AgentForwardMsg — the payload is re-dispatched via send. */\n  forward(payload: unknown): void\n  /** fetch for HTTP effects; override in tests. */\n  fetch?: typeof fetch\n  /** Called before opening WS / on WS lifecycle events. */\n  openWs(token: string, wsUrl: string): void\n  closeWs(): void\n  /**\n   * Base path for agent HTTP endpoints. Default: `'/agent'` (matches\n   * the canonical paths in `@llui/vite-plugin`'s dev middleware and\n   * `@llui/agent/server/http/router.ts`).\n   *\n   * Override when the consumer ships `@cloudflare/vite-plugin` in\n   * dev — that plugin routes every non-`/cdn-cgi/*` path to the\n   * worker, shadowing canonical `/agent/*` URLs. The vite-plugin\n   * registers a parallel handler at `/cdn-cgi/agent/*`; pass\n   * `agentBasePath: '/cdn-cgi/agent'` here so the client hits that.\n   *\n   * Production deployments without cloudflare-vite leave this\n   * unset; the agent server's router serves the canonical paths.\n   */\n  agentBasePath?: string\n}\n\ntype Fetch = typeof fetch\n\n/**\n * Top-level dispatcher. The switch is intentionally thin — each\n * `case` delegates to a per-effect function below. Splitting was\n * motivated by the previous 150-line monolith mixing HTTP, WS, and\n * browser-only side effects in one switch; per-effect handlers are\n * directly unit-testable and the dispatcher reads as a flat catalogue\n * of supported effect types.\n */\nexport function createEffectHandler(host: EffectHandlerHost) {\n  const doFetch = host.fetch ?? fetch.bind(globalThis)\n\n  return async function handle(effect: AgentEffect): Promise<void> {\n    switch (effect.type) {\n      case 'AgentMintRequest':\n        return handleMintRequest(host, effect, doFetch)\n      case 'AgentOpenWS':\n        return handleOpenWs(host, effect)\n      case 'AgentCloseWS':\n        return handleCloseWs(host)\n      case 'AgentResumeCheck':\n        return handleResumeCheck(host, effect, doFetch)\n      case 'AgentResumeClaim':\n        return handleResumeClaim(host, effect, doFetch)\n      case 'AgentRevoke':\n        return handleRevoke(host, effect, doFetch)\n      case 'AgentSessionsList':\n        return handleSessionsList(host, doFetch)\n      case 'AgentForwardMsg':\n        return handleForwardMsg(host, effect)\n      case 'AgentClipboardWrite':\n        return handleClipboardWrite(effect)\n      case 'AgentSessionPersist':\n      case 'AgentSessionClear':\n        // Host-handled (sessionStorage write/clear). The framework\n        // emits these alongside MintSucceeded / Revoke so the host\n        // can survive a page refresh without invalidating the agent's\n        // token; we no-op here so the host's effect router is the\n        // single source of truth for the storage policy.\n        return\n    }\n  }\n}\n\n// ── HTTP-bound handlers ─────────────────────────────────────────────\n\nasync function handleMintRequest(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentMintRequest' }>,\n  doFetch: Fetch,\n): Promise<void> {\n  // Derive a default `mintUrl` from `agentBasePath` so consumers can\n  // change the base path in one place (the effect handler) without\n  // also having to keep the `agentConnect` opts in sync. `agentBase`\n  // accepts both absolute paths and full URLs.\n  const base = agentBase(host)\n  if (!base) return\n  const mintUrl = effect.mintUrl ?? `${base}/mint`\n  try {\n    const res = await doFetch(mintUrl, { method: 'POST', credentials: 'include' })\n    if (!res.ok) {\n      const detail = await safeText(res)\n      host.send(\n        host.wrapAgentConnect({\n          type: 'MintFailed',\n          error: { code: `http-${res.status}`, detail },\n        }),\n      )\n      return\n    }\n    const body = (await res.json()) as MintResponse\n    host.send(\n      host.wrapAgentConnect({\n        type: 'MintSucceeded',\n        token: body.token,\n        tid: body.tid,\n        lapUrl: body.lapUrl,\n        wsUrl: body.wsUrl,\n        expiresAt: body.expiresAt,\n      }),\n    )\n  } catch (e) {\n    host.send(\n      host.wrapAgentConnect({\n        type: 'MintFailed',\n        error: { code: 'network', detail: String(e) },\n      }),\n    )\n  }\n}\n\nasync function handleResumeCheck(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentResumeCheck' }>,\n  doFetch: Fetch,\n): Promise<void> {\n  const base = agentBase(host)\n  if (!base) return\n  try {\n    const res = await doFetch(`${base}/resume/list`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ tids: effect.tids }),\n    })\n    if (!res.ok) return\n    const body = (await res.json()) as ResumeListResponse\n    host.send(host.wrapAgentConnect({ type: 'ResumeListLoaded', sessions: body.sessions }))\n  } catch {\n    /* quiet failure; user can retry */\n  }\n}\n\nasync function handleResumeClaim(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentResumeClaim' }>,\n  doFetch: Fetch,\n): Promise<void> {\n  const base = agentBase(host)\n  if (!base) return\n  try {\n    const res = await doFetch(`${base}/resume/claim`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ tid: effect.tid }),\n    })\n    if (!res.ok) return\n    const body = (await res.json()) as ResumeClaimResponse\n    host.openWs(body.token, body.wsUrl)\n    host.send(host.wrapAgentConnect({ type: 'WsOpened' }))\n  } catch {\n    /* quiet */\n  }\n}\n\nasync function handleRevoke(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentRevoke' }>,\n  doFetch: Fetch,\n): Promise<void> {\n  const base = agentBase(host)\n  if (!base) return\n  try {\n    await doFetch(`${base}/revoke`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ tid: effect.tid }),\n    })\n  } catch {\n    /* quiet */\n  }\n}\n\nasync function handleSessionsList(host: EffectHandlerHost, doFetch: Fetch): Promise<void> {\n  const base = agentBase(host)\n  if (!base) return\n  try {\n    const res = await doFetch(`${base}/sessions`, {\n      method: 'GET',\n      credentials: 'include',\n    })\n    if (!res.ok) return\n    const body = (await res.json()) as SessionsResponse\n    host.send(host.wrapAgentConnect({ type: 'SessionsLoaded', sessions: body.sessions }))\n  } catch {\n    /* quiet */\n  }\n}\n\n// ── WS-bound handlers ───────────────────────────────────────────────\n\nfunction handleOpenWs(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentOpenWS' }>,\n): void {\n  host.openWs(effect.token, effect.wsUrl)\n}\n\nfunction handleCloseWs(host: EffectHandlerHost): void {\n  host.closeWs()\n}\n\n// ── Local handlers (no network) ─────────────────────────────────────\n\nfunction handleForwardMsg(\n  host: EffectHandlerHost,\n  effect: Extract<AgentEffect, { type: 'AgentForwardMsg' }>,\n): void {\n  host.forward(effect.payload)\n}\n\nasync function handleClipboardWrite(\n  effect: Extract<AgentEffect, { type: 'AgentClipboardWrite' }>,\n): Promise<void> {\n  // Browser-only — `navigator.clipboard` is undefined in Node/jsdom\n  // test environments. Silently no-op rather than throw, matching the\n  // rest of the agent effect handlers' failure-quiet pattern.\n  if (typeof navigator === 'undefined' || !('clipboard' in navigator)) return\n  try {\n    await navigator.clipboard.writeText(effect.text)\n  } catch {\n    /* quiet — clipboard permission denied or document not focused */\n  }\n}\n\n// ── Helpers ─────────────────────────────────────────────────────────\n\nasync function safeText(res: Response): Promise<string> {\n  try {\n    return await res.text()\n  } catch {\n    return ''\n  }\n}\n\nfunction deriveOrigin(): string | null {\n  // When running in the browser, `location.origin` is correct for\n  // same-origin agent endpoints. Tests override `host.fetch` and\n  // short-circuit before this is reached.\n  if (typeof location !== 'undefined') return location.origin\n  return null\n}\n\nconst ABSOLUTE_URL_RE = /^https?:\\/\\//i\n\n/**\n * Resolve the absolute base URL for agent HTTP endpoints. Accepts both\n * absolute paths (`/agent`) and full URLs (`https://api.example/agent`)\n * — the absolute URL form lets consumers point at a cross-origin agent\n * server without pre-composing every endpoint URL. Trailing slashes\n * are normalized so callers can always concatenate `${base}/mint`.\n */\nfunction agentBase(host: EffectHandlerHost): string | null {\n  const raw = host.agentBasePath ?? '/agent'\n  const trimmed = raw.endsWith('/') ? raw.slice(0, -1) : raw\n  if (ABSOLUTE_URL_RE.test(trimmed)) return trimmed\n  const origin = deriveOrigin()\n  if (!origin) return null\n  return `${origin}${trimmed}`\n}\n"]}

package/dist/client/effects.d.ts

@@ -33,6 +33,28 @@ export type AgentEffect =
 } | {
     type: 'AgentClipboardWrite';
     text: string;
+}
+/**
+ * Persist active session credentials so a page refresh can restore
+ * the same WS without re-minting (and without invalidating the
+ * agent's token via the rotate-on-resume path). Hosts typically
+ * write to `sessionStorage` so the credentials are tab-scoped:
+ * survive refresh, die on tab close. The framework emits this on
+ * `MintSucceeded`; the matching `AgentSessionClear` is emitted on
+ * `Revoke` of the active tid. Hosts that don't implement the
+ * persist/restore loop can ignore both — the rest of the connect
+ * lifecycle still works (the page just falls back to "mint a new
+ * session" after refresh, same as before this effect existed).
+ */
+ | {
+    type: 'AgentSessionPersist';
+    token: AgentToken;
+    tid: string;
+    lapUrl: string;
+    wsUrl: string;
+    expiresAt: number;
+} | {
+    type: 'AgentSessionClear';
 };
 export type AgentEffectHandler = (effect: AgentEffect) => Promise<void>;
 //# sourceMappingURL=effects.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../src/client/effects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,MAAM,MAAM,WAAW;AACrB;;;;;;GAMG;AACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAK7C;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAGjD,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../src/client/effects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,MAAM,MAAM,WAAW;AACrB;;;;;;GAMG;AACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAK7C;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC/C;;;;;;;;;;;GAWG;GACD;IACE,IAAI,EAAE,qBAAqB,CAAA;IAC3B,KAAK,EAAE,UAAU,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB,GACD;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAA;AAGjC,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/client/effects.js.map

@@ -1 +1 @@
-{"version":3,"file":"effects.js","sourceRoot":"","sources":["../../src/client/effects.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentToken } from '../protocol.js'\n\nexport type AgentEffect =\n  /**\n   * Mint a fresh agent token. `mintUrl` is optional — when omitted the\n   * effect handler derives it from `EffectHandlerHost.agentBasePath`\n   * (default `/agent`), producing `<agentBasePath>/mint`. Pass an\n   * explicit value when the mint endpoint lives outside the configured\n   * base path.\n   */\n  | { type: 'AgentMintRequest'; mintUrl?: string }\n  | { type: 'AgentOpenWS'; token: AgentToken; wsUrl: string }\n  | { type: 'AgentCloseWS' }\n  | { type: 'AgentResumeCheck'; tids: string[] }\n  | { type: 'AgentResumeClaim'; tid: string }\n  | { type: 'AgentRevoke'; tid: string }\n  | { type: 'AgentSessionsList' }\n  | { type: 'AgentForwardMsg'; payload: unknown }\n  // Handler reads `text` (no state lookup needed at handler time —\n  // update() resolved it from the current state.pendingToken). Lets\n  // the static-bag `connect()` shape avoid leaking state-reads into\n  // event handlers.\n  | { type: 'AgentClipboardWrite'; text: string }\n\n// Handler implementation lands in Plan 7 alongside the WS client.\nexport type AgentEffectHandler = (effect: AgentEffect) => Promise<void>\n"]}
+{"version":3,"file":"effects.js","sourceRoot":"","sources":["../../src/client/effects.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentToken } from '../protocol.js'\n\nexport type AgentEffect =\n  /**\n   * Mint a fresh agent token. `mintUrl` is optional — when omitted the\n   * effect handler derives it from `EffectHandlerHost.agentBasePath`\n   * (default `/agent`), producing `<agentBasePath>/mint`. Pass an\n   * explicit value when the mint endpoint lives outside the configured\n   * base path.\n   */\n  | { type: 'AgentMintRequest'; mintUrl?: string }\n  | { type: 'AgentOpenWS'; token: AgentToken; wsUrl: string }\n  | { type: 'AgentCloseWS' }\n  | { type: 'AgentResumeCheck'; tids: string[] }\n  | { type: 'AgentResumeClaim'; tid: string }\n  | { type: 'AgentRevoke'; tid: string }\n  | { type: 'AgentSessionsList' }\n  | { type: 'AgentForwardMsg'; payload: unknown }\n  // Handler reads `text` (no state lookup needed at handler time —\n  // update() resolved it from the current state.pendingToken). Lets\n  // the static-bag `connect()` shape avoid leaking state-reads into\n  // event handlers.\n  | { type: 'AgentClipboardWrite'; text: string }\n  /**\n   * Persist active session credentials so a page refresh can restore\n   * the same WS without re-minting (and without invalidating the\n   * agent's token via the rotate-on-resume path). Hosts typically\n   * write to `sessionStorage` so the credentials are tab-scoped:\n   * survive refresh, die on tab close. The framework emits this on\n   * `MintSucceeded`; the matching `AgentSessionClear` is emitted on\n   * `Revoke` of the active tid. Hosts that don't implement the\n   * persist/restore loop can ignore both — the rest of the connect\n   * lifecycle still works (the page just falls back to \"mint a new\n   * session\" after refresh, same as before this effect existed).\n   */\n  | {\n      type: 'AgentSessionPersist'\n      token: AgentToken\n      tid: string\n      lapUrl: string\n      wsUrl: string\n      expiresAt: number\n    }\n  | { type: 'AgentSessionClear' }\n\n// Handler implementation lands in Plan 7 alongside the WS client.\nexport type AgentEffectHandler = (effect: AgentEffect) => Promise<void>\n"]}

package/dist/client/rpc/list-actions.js

@@ -210,6 +210,18 @@ function compileRouteGate(src) {
     routeGateCache.set(src, fn);
     return fn;
 }
+/**
+ * Sentinel returned by `synthesizeBare` for fields whose schema is
+ * `'unknown'` — the synthesizer can't make up a value, so it tells
+ * callers to omit the field from the synthesized example. Emitting
+ * `null` (the previous behavior) bit us in production: agents
+ * copied the literal `null`, the validator let it through (it
+ * exempts unknowns), and the consumer code crashed on `null.kind` /
+ * `null.length` etc. Symbol values are dropped silently by
+ * `JSON.stringify`, so even a missed filter site can't leak this
+ * to the wire.
+ */
+const OMIT = Symbol('synthesize.omit');
 function synthesizePayload(variant, fields) {
     const out = { type: variant };
     for (const [name, descriptor] of Object.entries(fields)) {
@@ -219,7 +231,10 @@ function synthesizePayload(variant, fields) {
         // fields always appear.
         if (optional && priority !== 'should')
             continue;
-        out[name] = exampleValue(descriptor);
+        const value = exampleValue(descriptor);
+        if (value === OMIT)
+            continue;
+        out[name] = value;
     }
     return out;
 }
@@ -320,16 +335,16 @@ function synthesizeBare(t) {
             return 0;
         if (t === 'boolean')
             return false;
-        return null; // 'unknown' or unrecognized keyword → placeholder
+        return OMIT; // 'unknown' or unrecognized — caller drops the field
     }
     if (t === null || typeof t !== 'object')
-        return null;
+        return OMIT;
     const obj = t;
     if ('enum' in obj && Array.isArray(obj.enum)) {
         // First option doubles as the canonical example. Native value type
         // round-trips (string/number/boolean) since the compiler preserved
         // the literal kind on emit.
-        return obj.enum[0] ?? null;
+        return obj.enum[0] ?? OMIT;
     }
     if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {
         // Recurse into the nested shape. Same optional-skip rule as the
@@ -341,14 +356,22 @@ function synthesizeBare(t) {
             const pri = isShould(descriptor);
             if (isOpt && pri !== 'should')
                 continue;
-            out[name] = exampleValue(descriptor);
+            const value = exampleValue(descriptor);
+            if (value === OMIT)
+                continue;
+            out[name] = value;
         }
         return out;
     }
     if (obj.kind === 'array') {
         // Wrap the synthesized element in a one-item array. Lets the LLM
         // see the per-entry shape without us guessing at array length.
-        return [synthesizeBare(obj.element)];
+        // If the element schema is 'unknown', return an empty array
+        // rather than `[null]` — the empty array signals "this is an
+        // array, shape unknown" without putting a misleading literal in
+        // the example.
+        const elementValue = synthesizeBare(obj.element);
+        return elementValue === OMIT ? [] : [elementValue];
     }
     if (obj.kind === 'discriminated-union') {
         // Synthesize the FIRST branch as the concrete example. The full
@@ -362,7 +385,7 @@ function synthesizeBare(t) {
         const discriminant = String(obj.discriminant);
         const firstEntry = Object.entries(variants).at(0);
         if (!firstEntry)
-            return null;
+            return OMIT;
         const [firstValue, firstFields] = firstEntry;
         const branch = { [discriminant]: firstValue };
         for (const [name, descriptor] of Object.entries(firstFields)) {
@@ -370,10 +393,13 @@ function synthesizeBare(t) {
             const pri = isShould(descriptor);
             if (isOpt && pri !== 'should')
                 continue;
-            branch[name] = exampleValue(descriptor);
+            const value = exampleValue(descriptor);
+            if (value === OMIT)
+                continue;
+            branch[name] = value;
         }
         return branch;
     }
-    return null;
+    return OMIT;
 }
 //# sourceMappingURL=list-actions.js.map

package/dist/client/rpc/list-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-actions.js","sourceRoot":"","sources":["../../../src/client/rpc/list-actions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MessageAnnotations } from '../../protocol.js'\nimport type { MsgSchemaShape, MsgSchemaField } from '../factory.js'\n\ntype Binding = { variant: string }\ntype Annotations = Record<string, MessageAnnotations>\n\nexport type ListActionsHost = {\n  getState(): unknown\n  getBindingDescriptors(): Binding[] | null\n  getMsgAnnotations(): Annotations | null\n  getMsgSchema(): MsgSchemaShape | null\n  getAgentAffordances(): ((state: unknown) => Array<{ type: string; [k: string]: unknown }>) | null\n}\n\n/**\n * `dispatchMode` on each action is `'shared'` (human can also click via\n * a UI affordance) or `'agent-only'` (no UI binding — agent is the only\n * dispatcher). `'human-only'` variants are filtered out before this\n * point — they never reach the LLM.\n *\n * `source` distinguishes WHERE the affordance came from:\n *   - `'binding'` — a tagged event handler is currently mounted in a\n *     live scope (refcount > 0). Variants inside dead branches —\n *     `show({when: false})`, unmounted `branch()` cases, removed `each`\n *     items — auto-vanish from this set as their lifetimes dispose.\n *     This is the framework's \"what can the user click right now\"\n *     answer, and it's the default surface for the agent.\n *   - `'always-affordable'` — either the app's `agentAffordances(state)`\n *     hook listed the variant, or the variant carries the\n *     `@alwaysAffordable` JSDoc tag. Both are the explicit \"agent can\n *     reach this even when no live UI binding maps to it\" knob — bulk\n *     seed ops (`Matrix/AddAlternatives`) and similar agent-driven\n *     paths typically land here.\n *   - `'schema'` — variant is annotated `@agentOnly` (the canonical\n *     \"no UI button maps to this; the agent is the only dispatcher\")\n *     and isn't already covered above. The payload is schema-synthesized\n *     and the agent fills it in.\n *\n * `'shared'` variants WITHOUT a live binding, without\n * `agentAffordances` mention, and without `@alwaysAffordable` are\n * **deliberately hidden**. They're reachable through UI navigation —\n * the human user can't click them right now, and dispatching them\n * blindly would mutate state that drives `show()`/`branch()` gates,\n * popping hidden UI subtrees into view in places the user didn't\n * navigate to.\n */\nexport type ListActionsResult = {\n  actions: Array<{\n    variant: string\n    /**\n     * Human-readable phrase from `@intent(\"…\")`, or `null` when the\n     * variant is unannotated. Mirror of LapActionsResponse.intent —\n     * callers should treat `null` as a documentation gap and not as\n     * \"missing label, fall back to variant name\".\n     */\n    intent: string | null\n    requiresConfirm: boolean\n    dispatchMode: 'shared' | 'agent-only'\n    source: 'binding' | 'always-affordable' | 'schema'\n    selectorHint: string | null\n    payloadHint: object | null\n    /** Cautionary text from `@warning` JSDoc, or null. */\n    warning: string | null\n    /** Concrete examples from `@example` JSDoc, in source order. */\n    examples: string[]\n    /**\n     * Effect kinds this variant emits, from `@emits(\"k1\", \"k2\")`.\n     * Empty when not annotated. Lets the agent know what side\n     * effects fire — useful for batching (\"100 dispatches × cloud-\n     * save = bad\") and for confirming destructive flows.\n     */\n    emits: string[]\n    /**\n     * Per-field guidance lifted from `@should(\"…\")` JSDoc on payload\n     * fields. Path is dot/bracket notation rooted at the payload\n     * (e.g. `\"cells\"` for a top-level field, `\"cells[].meta\"` for an\n     * array element's nested field). Useful when the field is typed\n     * as `unknown` or as a polymorphic shape — the hint says \"type\n     * matches the criterion's kind: number for quantity, …\" so the\n     * agent doesn't have to guess from the bare schema.\n     *\n     * Empty when no field on this variant carries an `@should` hint.\n     */\n    fieldHints: Array<{ path: string; hint: string }>\n  }>\n}\n\nexport function handleListActions(host: ListActionsHost): ListActionsResult {\n  const annotations = host.getMsgAnnotations() ?? {}\n  const state = host.getState()\n  const descriptors = host.getBindingDescriptors() ?? []\n  const affordancesFn = host.getAgentAffordances()\n  const affordances = affordancesFn ? affordancesFn(state) : []\n  // When the app provides `agentAffordances(state)`, it's opted into\n  // explicit affordance control: only state-relevant Msgs are listed.\n  // `@agentOnly` schema-source variants are then filtered to those the\n  // hook returned — so a bulk-edit Msg like `Matrix/AddCriteria`\n  // doesn't surface on the home page just because it's tagged\n  // `@agentOnly`. Apps without `agentAffordances` keep the previous\n  // permissive default (\"everything's available unless you say\n  // otherwise\") since flipping that without explicit opt-in would\n  // break consumers who rely on schema-source surfacing of\n  // bulk Msgs.\n  const explicitAffordances = affordancesFn !== null\n  const affordanceVariants = new Set(affordances.map((m) => m.type))\n  const schema = host.getMsgSchema()\n\n  const out: ListActionsResult['actions'] = []\n  const seen = new Set<string>()\n\n  // From bindings — these have UI affordances by definition, so they're\n  // either 'shared' (default) or, in the malformed case where someone\n  // bound an `@agentOnly` Msg in a view, 'agent-only'. Either way the\n  // agent can dispatch them.\n  //\n  // Filtered against the Msg schema: a binding whose variant isn't in\n  // the user's Msg union is a library-internal Msg leaking through\n  // `tagSend` translator wiring (the sortable component's `move`,\n  // `drop`, `cancel`, etc. — they're routed into the user's update.ts\n  // via a different shape but their lib names slip into the binding\n  // registry). The agent has no use for those names — `would_dispatch`\n  // / `send_message` would reject them as `unknown-variant` anyway —\n  // so they pollute the affordance list. When a schema is available,\n  // the schema's variant set is the source of truth.\n  for (const d of descriptors) {\n    if (schema && !(d.variant in schema.variants)) continue\n    const ann = annotations[d.variant]\n    if (ann?.dispatchMode === 'human-only') continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(d.variant)\n    const variantSchema = schema?.variants[d.variant]\n    out.push({\n      variant: d.variant,\n      intent: ann?.intent ?? null,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      dispatchMode: ann?.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'binding',\n      selectorHint: null,\n      payloadHint: null,\n      warning: ann?.warning ?? null,\n      examples: ann?.examples ?? [],\n      emits: ann?.emits ?? [],\n      fieldHints: variantSchema ? collectFieldHints(variantSchema) : [],\n    })\n  }\n\n  // From `agentAffordances(state)` — the integrator's explicit list of\n  // currently-reachable Msgs, with concrete payloads they author.\n  for (const msg of affordances) {\n    const ann = annotations[msg.type]\n    if (ann?.dispatchMode === 'human-only') continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(msg.type)\n    const { type, ...rest } = msg\n    const variantSchema = schema?.variants[type]\n    out.push({\n      variant: type,\n      intent: ann?.intent ?? null,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      dispatchMode: ann?.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'always-affordable',\n      selectorHint: null,\n      payloadHint: Object.keys(rest).length > 0 ? rest : null,\n      warning: ann?.warning ?? null,\n      examples: ann?.examples ?? [],\n      emits: ann?.emits ?? [],\n      fieldHints: variantSchema ? collectFieldHints(variantSchema) : [],\n    })\n  }\n\n  // From `@alwaysAffordable` annotations — the per-variant equivalent\n  // of `agentAffordances`. Variants tagged this way surface regardless\n  // of whether a live binding maps to them, so bulk seed ops\n  // (`Matrix/AddAlternatives`) and similar agent-driven paths are\n  // available even when their UI counterparts (if any) aren't mounted.\n  // The payload is schema-synthesized — `agentAffordances` is the way\n  // to ship a concrete pre-filled payload alongside the affordance.\n  for (const [variant, ann] of Object.entries(annotations)) {\n    if (seen.has(variant)) continue\n    if (ann.dispatchMode === 'human-only') continue\n    if (!ann.alwaysAffordable) continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(variant)\n    const fields = schema?.variants[variant]\n    out.push({\n      variant,\n      intent: ann.intent,\n      requiresConfirm: ann.requiresConfirm,\n      dispatchMode: ann.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'always-affordable',\n      selectorHint: null,\n      payloadHint: fields ? synthesizePayload(variant, fields) : null,\n      warning: ann.warning,\n      examples: ann.examples,\n      emits: ann.emits,\n      fieldHints: fields ? collectFieldHints(fields) : [],\n    })\n  }\n\n  // From schema — variants that aren't already surfaced above and that\n  // the author marked `@agentOnly`. The canonical \"no UI button maps\n  // to this; the agent is the only dispatcher.\" Bulk edits, imports,\n  // admin operations that have no human-facing affordance at all.\n  //\n  // `'shared'` variants WITHOUT a live binding stay hidden here — they\n  // are reachable through UI navigation, and dispatching them while\n  // their UI subtree is unmounted would pop hidden state in places the\n  // user didn't navigate to. The explicit knobs are `@alwaysAffordable`\n  // (handled above) or `agentAffordances(state)`.\n  //\n  // When the app provides `agentAffordances`, this pass is filtered:\n  // an `@agentOnly` variant only surfaces if the hook returned it.\n  // That makes route-gated bulk Msgs (`Matrix/AddCriteria` available\n  // only when a matrix is loaded) work as expected — they stop\n  // appearing on the home page just because they're tagged\n  // `@agentOnly`. Apps without `agentAffordances` keep the previous\n  // permissive default.\n  if (schema) {\n    for (const [variant, fields] of Object.entries(schema.variants)) {\n      if (seen.has(variant)) continue\n      const ann = annotations[variant]\n      if (ann?.dispatchMode !== 'agent-only') continue\n      if (explicitAffordances && !affordanceVariants.has(variant)) continue\n      if (!passesRouteGate(ann, state)) continue\n      out.push({\n        variant,\n        intent: ann.intent,\n        requiresConfirm: ann.requiresConfirm,\n        dispatchMode: 'agent-only',\n        source: 'schema',\n        selectorHint: null,\n        payloadHint: synthesizePayload(variant, fields),\n        warning: ann.warning,\n        examples: ann.examples,\n        emits: ann.emits,\n        fieldHints: collectFieldHints(fields),\n      })\n    }\n  }\n\n  return { actions: out }\n}\n\n/**\n * Build an example payload object the LLM can fill in. Required\n * fields always appear; optional fields appear only when annotated\n * `@should` (LLM is encouraged to fill them in). Fields without a\n * concrete primitive type (`'unknown'`) emit `null` placeholders the\n * LLM is expected to replace.\n *\n * The first key is `type` so the payload reads as a complete Msg\n * shape — copy-paste-ready into `send_message`.\n */\n/**\n * Evaluate `@routeGated(\"predicate\")` against the current state.\n * Returns true (variant passes) when:\n *   - the variant has no `@routeGated` annotation, OR\n *   - the predicate evaluates truthy with `state` bound.\n *\n * Predicate is compiled lazily via `new Function('state', 'return (' +\n * src + ')')` and cached in a module-level Map. Compile failures\n * (syntactically broken predicates) degrade to \"true\" so a single\n * malformed annotation doesn't paralyze the affordance pass — the\n * build-time linter is the right place to catch syntactic issues.\n * Evaluation throws fail-closed (return false) since a predicate that\n * crashes on the current state shouldn't surface the variant.\n */\nfunction passesRouteGate(ann: MessageAnnotations | undefined, state: unknown): boolean {\n  const src = ann?.routeGate\n  if (!src) return true\n  const predicate = compileRouteGate(src)\n  try {\n    return Boolean(predicate(state))\n  } catch {\n    return false\n  }\n}\n\nconst routeGateCache = new Map<string, (state: unknown) => boolean>()\nfunction compileRouteGate(src: string): (state: unknown) => boolean {\n  let fn = routeGateCache.get(src)\n  if (fn) return fn\n  try {\n    fn = new Function('state', `return (${src})`) as (state: unknown) => boolean\n  } catch {\n    fn = () => true\n  }\n  routeGateCache.set(src, fn)\n  return fn\n}\n\nfunction synthesizePayload(variant: string, fields: Record<string, MsgSchemaField>): object {\n  const out: Record<string, unknown> = { type: variant }\n  for (const [name, descriptor] of Object.entries(fields)) {\n    const optional = isOptional(descriptor)\n    const priority = isShould(descriptor)\n    // Skip optional fields unless they're @should-flagged. Required\n    // fields always appear.\n    if (optional && priority !== 'should') continue\n    out[name] = exampleValue(descriptor)\n  }\n  return out\n}\n\n/**\n * Walk a variant's field tree and collect every `@should` hint into a\n * flat list keyed by field path. Path conventions:\n *   - top-level field: `\"cells\"`\n *   - nested object property: `\"cells.value\"`\n *   - array element: `\"cells[]\"` for the element itself; descendants\n *     use `\"cells[].meta\"` and so on.\n *\n * Surfaces the same hints that show up nested inside\n * `description.messages.variants[X].field.hint` so callers don't have\n * to dig through the schema tree to find them.\n */\nfunction collectFieldHints(\n  fields: Record<string, MsgSchemaField>,\n): Array<{ path: string; hint: string }> {\n  const out: Array<{ path: string; hint: string }> = []\n  for (const [name, descriptor] of Object.entries(fields)) {\n    walkHint(name, descriptor, out)\n  }\n  return out\n}\n\nfunction walkHint(\n  path: string,\n  d: MsgSchemaField,\n  out: Array<{ path: string; hint: string }>,\n): void {\n  // Rich descriptor with a hint at this position.\n  if (typeof d === 'object' && d !== null && 'type' in d) {\n    if (typeof d.hint === 'string' && d.hint.length > 0) {\n      out.push({ path, hint: d.hint })\n    }\n    // `@validates(...)` predicates surface alongside `@should` hints\n    // so the agent sees the constraint at affordance time rather than\n    // only as a post-dispatch rejection. The verbatim predicate text\n    // is what the runtime evaluates; agents trained on JS read it\n    // directly. Prefix `validates: ` to disambiguate from freeform\n    // `@should` text.\n    if (typeof d.validates === 'string' && d.validates.length > 0) {\n      out.push({ path, hint: `validates: ${d.validates}` })\n    }\n    walkHintBare(path, d.type, out)\n    return\n  }\n  walkHintBare(path, d, out)\n}\n\nfunction walkHintBare(path: string, t: unknown, out: Array<{ path: string; hint: string }>): void {\n  if (t === null || typeof t !== 'object') return\n  const obj = t as Record<string, unknown>\n  if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {\n    for (const [name, descriptor] of Object.entries(obj.shape as Record<string, MsgSchemaField>)) {\n      walkHint(`${path}.${name}`, descriptor, out)\n    }\n    return\n  }\n  if (obj.kind === 'array') {\n    walkHint(`${path}[]`, obj.element as MsgSchemaField, out)\n  }\n  if (obj.kind === 'discriminated-union') {\n    // Synthetic hint at the union's path summarizing the legal\n    // discriminant values. Lets the agent see \"format expects one of:\n    // exact, range, compound\" without walking the full schema. Then\n    // walk each branch's per-field hints with a path-suffix that\n    // disambiguates which branch the hint applies to.\n    const variants = obj.variants as Record<string, Record<string, MsgSchemaField>>\n    const discriminant = String(obj.discriminant)\n    const legalValues = Object.keys(variants)\n    if (legalValues.length > 0) {\n      out.push({\n        path,\n        hint: `Discriminated union — set \\`${discriminant}\\` to one of: ${legalValues\n          .map((v) => `'${v}'`)\n          .join(', ')}.`,\n      })\n    }\n    for (const [discValue, fields] of Object.entries(variants)) {\n      for (const [fieldName, fieldDesc] of Object.entries(fields)) {\n        walkHint(`${path}(${discriminant}=${discValue}).${fieldName}`, fieldDesc, out)\n      }\n    }\n  }\n}\n\nfunction isOptional(d: MsgSchemaField): boolean {\n  return typeof d === 'object' && 'type' in d && d.optional === true\n}\n\nfunction isShould(d: MsgSchemaField): 'should' | undefined {\n  return typeof d === 'object' && 'type' in d ? d.priority : undefined\n}\n\nfunction exampleValue(d: MsgSchemaField): unknown {\n  // Unwrap rich descriptor to get the bare type for synthesis.\n  const t =\n    typeof d === 'object' && 'type' in d\n      ? d.type\n      : (d as\n          | Exclude<MsgSchemaField, object>\n          | Extract<MsgSchemaField, { kind?: string; enum?: string[] }>)\n  return synthesizeBare(t as never)\n}\n\nfunction synthesizeBare(t: unknown): unknown {\n  if (typeof t === 'string') {\n    if (t === 'string') return ''\n    if (t === 'number') return 0\n    if (t === 'boolean') return false\n    return null // 'unknown' or unrecognized keyword → placeholder\n  }\n  if (t === null || typeof t !== 'object') return null\n  const obj = t as Record<string, unknown>\n  if ('enum' in obj && Array.isArray(obj.enum)) {\n    // First option doubles as the canonical example. Native value type\n    // round-trips (string/number/boolean) since the compiler preserved\n    // the literal kind on emit.\n    return obj.enum[0] ?? null\n  }\n  if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {\n    // Recurse into the nested shape. Same optional-skip rule as the\n    // top-level synthesizer: required fields appear, optional ones\n    // appear only when @should-flagged.\n    const out: Record<string, unknown> = {}\n    for (const [name, descriptor] of Object.entries(obj.shape as Record<string, MsgSchemaField>)) {\n      const isOpt = isOptional(descriptor)\n      const pri = isShould(descriptor)\n      if (isOpt && pri !== 'should') continue\n      out[name] = exampleValue(descriptor)\n    }\n    return out\n  }\n  if (obj.kind === 'array') {\n    // Wrap the synthesized element in a one-item array. Lets the LLM\n    // see the per-entry shape without us guessing at array length.\n    return [synthesizeBare(obj.element)]\n  }\n  if (obj.kind === 'discriminated-union') {\n    // Synthesize the FIRST branch as the concrete example. The full\n    // shape (every legal branch + its payload) is preserved in\n    // `description.messages.variants[X]` from `describe_app`, so the\n    // agent that needs another branch reads the schema directly.\n    // `collectFieldHints` adds a synthetic enumeration of the legal\n    // `<discriminant>` values onto the hint surface so the agent\n    // doesn't have to dig into the schema for the simple case.\n    const variants = obj.variants as Record<string, Record<string, MsgSchemaField>>\n    const discriminant = String(obj.discriminant)\n    const firstEntry = Object.entries(variants).at(0)\n    if (!firstEntry) return null\n    const [firstValue, firstFields] = firstEntry\n    const branch: Record<string, unknown> = { [discriminant]: firstValue }\n    for (const [name, descriptor] of Object.entries(firstFields)) {\n      const isOpt = isOptional(descriptor)\n      const pri = isShould(descriptor)\n      if (isOpt && pri !== 'should') continue\n      branch[name] = exampleValue(descriptor)\n    }\n    return branch\n  }\n  return null\n}\n"]}
+{"version":3,"file":"list-actions.js","sourceRoot":"","sources":["../../../src/client/rpc/list-actions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MessageAnnotations } from '../../protocol.js'\nimport type { MsgSchemaShape, MsgSchemaField } from '../factory.js'\n\ntype Binding = { variant: string }\ntype Annotations = Record<string, MessageAnnotations>\n\nexport type ListActionsHost = {\n  getState(): unknown\n  getBindingDescriptors(): Binding[] | null\n  getMsgAnnotations(): Annotations | null\n  getMsgSchema(): MsgSchemaShape | null\n  getAgentAffordances(): ((state: unknown) => Array<{ type: string; [k: string]: unknown }>) | null\n}\n\n/**\n * `dispatchMode` on each action is `'shared'` (human can also click via\n * a UI affordance) or `'agent-only'` (no UI binding — agent is the only\n * dispatcher). `'human-only'` variants are filtered out before this\n * point — they never reach the LLM.\n *\n * `source` distinguishes WHERE the affordance came from:\n *   - `'binding'` — a tagged event handler is currently mounted in a\n *     live scope (refcount > 0). Variants inside dead branches —\n *     `show({when: false})`, unmounted `branch()` cases, removed `each`\n *     items — auto-vanish from this set as their lifetimes dispose.\n *     This is the framework's \"what can the user click right now\"\n *     answer, and it's the default surface for the agent.\n *   - `'always-affordable'` — either the app's `agentAffordances(state)`\n *     hook listed the variant, or the variant carries the\n *     `@alwaysAffordable` JSDoc tag. Both are the explicit \"agent can\n *     reach this even when no live UI binding maps to it\" knob — bulk\n *     seed ops (`Matrix/AddAlternatives`) and similar agent-driven\n *     paths typically land here.\n *   - `'schema'` — variant is annotated `@agentOnly` (the canonical\n *     \"no UI button maps to this; the agent is the only dispatcher\")\n *     and isn't already covered above. The payload is schema-synthesized\n *     and the agent fills it in.\n *\n * `'shared'` variants WITHOUT a live binding, without\n * `agentAffordances` mention, and without `@alwaysAffordable` are\n * **deliberately hidden**. They're reachable through UI navigation —\n * the human user can't click them right now, and dispatching them\n * blindly would mutate state that drives `show()`/`branch()` gates,\n * popping hidden UI subtrees into view in places the user didn't\n * navigate to.\n */\nexport type ListActionsResult = {\n  actions: Array<{\n    variant: string\n    /**\n     * Human-readable phrase from `@intent(\"…\")`, or `null` when the\n     * variant is unannotated. Mirror of LapActionsResponse.intent —\n     * callers should treat `null` as a documentation gap and not as\n     * \"missing label, fall back to variant name\".\n     */\n    intent: string | null\n    requiresConfirm: boolean\n    dispatchMode: 'shared' | 'agent-only'\n    source: 'binding' | 'always-affordable' | 'schema'\n    selectorHint: string | null\n    payloadHint: object | null\n    /** Cautionary text from `@warning` JSDoc, or null. */\n    warning: string | null\n    /** Concrete examples from `@example` JSDoc, in source order. */\n    examples: string[]\n    /**\n     * Effect kinds this variant emits, from `@emits(\"k1\", \"k2\")`.\n     * Empty when not annotated. Lets the agent know what side\n     * effects fire — useful for batching (\"100 dispatches × cloud-\n     * save = bad\") and for confirming destructive flows.\n     */\n    emits: string[]\n    /**\n     * Per-field guidance lifted from `@should(\"…\")` JSDoc on payload\n     * fields. Path is dot/bracket notation rooted at the payload\n     * (e.g. `\"cells\"` for a top-level field, `\"cells[].meta\"` for an\n     * array element's nested field). Useful when the field is typed\n     * as `unknown` or as a polymorphic shape — the hint says \"type\n     * matches the criterion's kind: number for quantity, …\" so the\n     * agent doesn't have to guess from the bare schema.\n     *\n     * Empty when no field on this variant carries an `@should` hint.\n     */\n    fieldHints: Array<{ path: string; hint: string }>\n  }>\n}\n\nexport function handleListActions(host: ListActionsHost): ListActionsResult {\n  const annotations = host.getMsgAnnotations() ?? {}\n  const state = host.getState()\n  const descriptors = host.getBindingDescriptors() ?? []\n  const affordancesFn = host.getAgentAffordances()\n  const affordances = affordancesFn ? affordancesFn(state) : []\n  // When the app provides `agentAffordances(state)`, it's opted into\n  // explicit affordance control: only state-relevant Msgs are listed.\n  // `@agentOnly` schema-source variants are then filtered to those the\n  // hook returned — so a bulk-edit Msg like `Matrix/AddCriteria`\n  // doesn't surface on the home page just because it's tagged\n  // `@agentOnly`. Apps without `agentAffordances` keep the previous\n  // permissive default (\"everything's available unless you say\n  // otherwise\") since flipping that without explicit opt-in would\n  // break consumers who rely on schema-source surfacing of\n  // bulk Msgs.\n  const explicitAffordances = affordancesFn !== null\n  const affordanceVariants = new Set(affordances.map((m) => m.type))\n  const schema = host.getMsgSchema()\n\n  const out: ListActionsResult['actions'] = []\n  const seen = new Set<string>()\n\n  // From bindings — these have UI affordances by definition, so they're\n  // either 'shared' (default) or, in the malformed case where someone\n  // bound an `@agentOnly` Msg in a view, 'agent-only'. Either way the\n  // agent can dispatch them.\n  //\n  // Filtered against the Msg schema: a binding whose variant isn't in\n  // the user's Msg union is a library-internal Msg leaking through\n  // `tagSend` translator wiring (the sortable component's `move`,\n  // `drop`, `cancel`, etc. — they're routed into the user's update.ts\n  // via a different shape but their lib names slip into the binding\n  // registry). The agent has no use for those names — `would_dispatch`\n  // / `send_message` would reject them as `unknown-variant` anyway —\n  // so they pollute the affordance list. When a schema is available,\n  // the schema's variant set is the source of truth.\n  for (const d of descriptors) {\n    if (schema && !(d.variant in schema.variants)) continue\n    const ann = annotations[d.variant]\n    if (ann?.dispatchMode === 'human-only') continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(d.variant)\n    const variantSchema = schema?.variants[d.variant]\n    out.push({\n      variant: d.variant,\n      intent: ann?.intent ?? null,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      dispatchMode: ann?.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'binding',\n      selectorHint: null,\n      payloadHint: null,\n      warning: ann?.warning ?? null,\n      examples: ann?.examples ?? [],\n      emits: ann?.emits ?? [],\n      fieldHints: variantSchema ? collectFieldHints(variantSchema) : [],\n    })\n  }\n\n  // From `agentAffordances(state)` — the integrator's explicit list of\n  // currently-reachable Msgs, with concrete payloads they author.\n  for (const msg of affordances) {\n    const ann = annotations[msg.type]\n    if (ann?.dispatchMode === 'human-only') continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(msg.type)\n    const { type, ...rest } = msg\n    const variantSchema = schema?.variants[type]\n    out.push({\n      variant: type,\n      intent: ann?.intent ?? null,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      dispatchMode: ann?.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'always-affordable',\n      selectorHint: null,\n      payloadHint: Object.keys(rest).length > 0 ? rest : null,\n      warning: ann?.warning ?? null,\n      examples: ann?.examples ?? [],\n      emits: ann?.emits ?? [],\n      fieldHints: variantSchema ? collectFieldHints(variantSchema) : [],\n    })\n  }\n\n  // From `@alwaysAffordable` annotations — the per-variant equivalent\n  // of `agentAffordances`. Variants tagged this way surface regardless\n  // of whether a live binding maps to them, so bulk seed ops\n  // (`Matrix/AddAlternatives`) and similar agent-driven paths are\n  // available even when their UI counterparts (if any) aren't mounted.\n  // The payload is schema-synthesized — `agentAffordances` is the way\n  // to ship a concrete pre-filled payload alongside the affordance.\n  for (const [variant, ann] of Object.entries(annotations)) {\n    if (seen.has(variant)) continue\n    if (ann.dispatchMode === 'human-only') continue\n    if (!ann.alwaysAffordable) continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(variant)\n    const fields = schema?.variants[variant]\n    out.push({\n      variant,\n      intent: ann.intent,\n      requiresConfirm: ann.requiresConfirm,\n      dispatchMode: ann.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'always-affordable',\n      selectorHint: null,\n      payloadHint: fields ? synthesizePayload(variant, fields) : null,\n      warning: ann.warning,\n      examples: ann.examples,\n      emits: ann.emits,\n      fieldHints: fields ? collectFieldHints(fields) : [],\n    })\n  }\n\n  // From schema — variants that aren't already surfaced above and that\n  // the author marked `@agentOnly`. The canonical \"no UI button maps\n  // to this; the agent is the only dispatcher.\" Bulk edits, imports,\n  // admin operations that have no human-facing affordance at all.\n  //\n  // `'shared'` variants WITHOUT a live binding stay hidden here — they\n  // are reachable through UI navigation, and dispatching them while\n  // their UI subtree is unmounted would pop hidden state in places the\n  // user didn't navigate to. The explicit knobs are `@alwaysAffordable`\n  // (handled above) or `agentAffordances(state)`.\n  //\n  // When the app provides `agentAffordances`, this pass is filtered:\n  // an `@agentOnly` variant only surfaces if the hook returned it.\n  // That makes route-gated bulk Msgs (`Matrix/AddCriteria` available\n  // only when a matrix is loaded) work as expected — they stop\n  // appearing on the home page just because they're tagged\n  // `@agentOnly`. Apps without `agentAffordances` keep the previous\n  // permissive default.\n  if (schema) {\n    for (const [variant, fields] of Object.entries(schema.variants)) {\n      if (seen.has(variant)) continue\n      const ann = annotations[variant]\n      if (ann?.dispatchMode !== 'agent-only') continue\n      if (explicitAffordances && !affordanceVariants.has(variant)) continue\n      if (!passesRouteGate(ann, state)) continue\n      out.push({\n        variant,\n        intent: ann.intent,\n        requiresConfirm: ann.requiresConfirm,\n        dispatchMode: 'agent-only',\n        source: 'schema',\n        selectorHint: null,\n        payloadHint: synthesizePayload(variant, fields),\n        warning: ann.warning,\n        examples: ann.examples,\n        emits: ann.emits,\n        fieldHints: collectFieldHints(fields),\n      })\n    }\n  }\n\n  return { actions: out }\n}\n\n/**\n * Build an example payload object the LLM can fill in. Required\n * fields always appear; optional fields appear only when annotated\n * `@should` (LLM is encouraged to fill them in). Fields without a\n * concrete primitive type (`'unknown'`) emit `null` placeholders the\n * LLM is expected to replace.\n *\n * The first key is `type` so the payload reads as a complete Msg\n * shape — copy-paste-ready into `send_message`.\n */\n/**\n * Evaluate `@routeGated(\"predicate\")` against the current state.\n * Returns true (variant passes) when:\n *   - the variant has no `@routeGated` annotation, OR\n *   - the predicate evaluates truthy with `state` bound.\n *\n * Predicate is compiled lazily via `new Function('state', 'return (' +\n * src + ')')` and cached in a module-level Map. Compile failures\n * (syntactically broken predicates) degrade to \"true\" so a single\n * malformed annotation doesn't paralyze the affordance pass — the\n * build-time linter is the right place to catch syntactic issues.\n * Evaluation throws fail-closed (return false) since a predicate that\n * crashes on the current state shouldn't surface the variant.\n */\nfunction passesRouteGate(ann: MessageAnnotations | undefined, state: unknown): boolean {\n  const src = ann?.routeGate\n  if (!src) return true\n  const predicate = compileRouteGate(src)\n  try {\n    return Boolean(predicate(state))\n  } catch {\n    return false\n  }\n}\n\nconst routeGateCache = new Map<string, (state: unknown) => boolean>()\nfunction compileRouteGate(src: string): (state: unknown) => boolean {\n  let fn = routeGateCache.get(src)\n  if (fn) return fn\n  try {\n    fn = new Function('state', `return (${src})`) as (state: unknown) => boolean\n  } catch {\n    fn = () => true\n  }\n  routeGateCache.set(src, fn)\n  return fn\n}\n\n/**\n * Sentinel returned by `synthesizeBare` for fields whose schema is\n * `'unknown'` — the synthesizer can't make up a value, so it tells\n * callers to omit the field from the synthesized example. Emitting\n * `null` (the previous behavior) bit us in production: agents\n * copied the literal `null`, the validator let it through (it\n * exempts unknowns), and the consumer code crashed on `null.kind` /\n * `null.length` etc. Symbol values are dropped silently by\n * `JSON.stringify`, so even a missed filter site can't leak this\n * to the wire.\n */\nconst OMIT = Symbol('synthesize.omit')\n\nfunction synthesizePayload(variant: string, fields: Record<string, MsgSchemaField>): object {\n  const out: Record<string, unknown> = { type: variant }\n  for (const [name, descriptor] of Object.entries(fields)) {\n    const optional = isOptional(descriptor)\n    const priority = isShould(descriptor)\n    // Skip optional fields unless they're @should-flagged. Required\n    // fields always appear.\n    if (optional && priority !== 'should') continue\n    const value = exampleValue(descriptor)\n    if (value === OMIT) continue\n    out[name] = value\n  }\n  return out\n}\n\n/**\n * Walk a variant's field tree and collect every `@should` hint into a\n * flat list keyed by field path. Path conventions:\n *   - top-level field: `\"cells\"`\n *   - nested object property: `\"cells.value\"`\n *   - array element: `\"cells[]\"` for the element itself; descendants\n *     use `\"cells[].meta\"` and so on.\n *\n * Surfaces the same hints that show up nested inside\n * `description.messages.variants[X].field.hint` so callers don't have\n * to dig through the schema tree to find them.\n */\nfunction collectFieldHints(\n  fields: Record<string, MsgSchemaField>,\n): Array<{ path: string; hint: string }> {\n  const out: Array<{ path: string; hint: string }> = []\n  for (const [name, descriptor] of Object.entries(fields)) {\n    walkHint(name, descriptor, out)\n  }\n  return out\n}\n\nfunction walkHint(\n  path: string,\n  d: MsgSchemaField,\n  out: Array<{ path: string; hint: string }>,\n): void {\n  // Rich descriptor with a hint at this position.\n  if (typeof d === 'object' && d !== null && 'type' in d) {\n    if (typeof d.hint === 'string' && d.hint.length > 0) {\n      out.push({ path, hint: d.hint })\n    }\n    // `@validates(...)` predicates surface alongside `@should` hints\n    // so the agent sees the constraint at affordance time rather than\n    // only as a post-dispatch rejection. The verbatim predicate text\n    // is what the runtime evaluates; agents trained on JS read it\n    // directly. Prefix `validates: ` to disambiguate from freeform\n    // `@should` text.\n    if (typeof d.validates === 'string' && d.validates.length > 0) {\n      out.push({ path, hint: `validates: ${d.validates}` })\n    }\n    walkHintBare(path, d.type, out)\n    return\n  }\n  walkHintBare(path, d, out)\n}\n\nfunction walkHintBare(path: string, t: unknown, out: Array<{ path: string; hint: string }>): void {\n  if (t === null || typeof t !== 'object') return\n  const obj = t as Record<string, unknown>\n  if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {\n    for (const [name, descriptor] of Object.entries(obj.shape as Record<string, MsgSchemaField>)) {\n      walkHint(`${path}.${name}`, descriptor, out)\n    }\n    return\n  }\n  if (obj.kind === 'array') {\n    walkHint(`${path}[]`, obj.element as MsgSchemaField, out)\n  }\n  if (obj.kind === 'discriminated-union') {\n    // Synthetic hint at the union's path summarizing the legal\n    // discriminant values. Lets the agent see \"format expects one of:\n    // exact, range, compound\" without walking the full schema. Then\n    // walk each branch's per-field hints with a path-suffix that\n    // disambiguates which branch the hint applies to.\n    const variants = obj.variants as Record<string, Record<string, MsgSchemaField>>\n    const discriminant = String(obj.discriminant)\n    const legalValues = Object.keys(variants)\n    if (legalValues.length > 0) {\n      out.push({\n        path,\n        hint: `Discriminated union — set \\`${discriminant}\\` to one of: ${legalValues\n          .map((v) => `'${v}'`)\n          .join(', ')}.`,\n      })\n    }\n    for (const [discValue, fields] of Object.entries(variants)) {\n      for (const [fieldName, fieldDesc] of Object.entries(fields)) {\n        walkHint(`${path}(${discriminant}=${discValue}).${fieldName}`, fieldDesc, out)\n      }\n    }\n  }\n}\n\nfunction isOptional(d: MsgSchemaField): boolean {\n  return typeof d === 'object' && 'type' in d && d.optional === true\n}\n\nfunction isShould(d: MsgSchemaField): 'should' | undefined {\n  return typeof d === 'object' && 'type' in d ? d.priority : undefined\n}\n\nfunction exampleValue(d: MsgSchemaField): unknown {\n  // Unwrap rich descriptor to get the bare type for synthesis.\n  const t =\n    typeof d === 'object' && 'type' in d\n      ? d.type\n      : (d as\n          | Exclude<MsgSchemaField, object>\n          | Extract<MsgSchemaField, { kind?: string; enum?: string[] }>)\n  return synthesizeBare(t as never)\n}\n\nfunction synthesizeBare(t: unknown): unknown {\n  if (typeof t === 'string') {\n    if (t === 'string') return ''\n    if (t === 'number') return 0\n    if (t === 'boolean') return false\n    return OMIT // 'unknown' or unrecognized — caller drops the field\n  }\n  if (t === null || typeof t !== 'object') return OMIT\n  const obj = t as Record<string, unknown>\n  if ('enum' in obj && Array.isArray(obj.enum)) {\n    // First option doubles as the canonical example. Native value type\n    // round-trips (string/number/boolean) since the compiler preserved\n    // the literal kind on emit.\n    return obj.enum[0] ?? OMIT\n  }\n  if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {\n    // Recurse into the nested shape. Same optional-skip rule as the\n    // top-level synthesizer: required fields appear, optional ones\n    // appear only when @should-flagged.\n    const out: Record<string, unknown> = {}\n    for (const [name, descriptor] of Object.entries(obj.shape as Record<string, MsgSchemaField>)) {\n      const isOpt = isOptional(descriptor)\n      const pri = isShould(descriptor)\n      if (isOpt && pri !== 'should') continue\n      const value = exampleValue(descriptor)\n      if (value === OMIT) continue\n      out[name] = value\n    }\n    return out\n  }\n  if (obj.kind === 'array') {\n    // Wrap the synthesized element in a one-item array. Lets the LLM\n    // see the per-entry shape without us guessing at array length.\n    // If the element schema is 'unknown', return an empty array\n    // rather than `[null]` — the empty array signals \"this is an\n    // array, shape unknown\" without putting a misleading literal in\n    // the example.\n    const elementValue = synthesizeBare(obj.element)\n    return elementValue === OMIT ? [] : [elementValue]\n  }\n  if (obj.kind === 'discriminated-union') {\n    // Synthesize the FIRST branch as the concrete example. The full\n    // shape (every legal branch + its payload) is preserved in\n    // `description.messages.variants[X]` from `describe_app`, so the\n    // agent that needs another branch reads the schema directly.\n    // `collectFieldHints` adds a synthetic enumeration of the legal\n    // `<discriminant>` values onto the hint surface so the agent\n    // doesn't have to dig into the schema for the simple case.\n    const variants = obj.variants as Record<string, Record<string, MsgSchemaField>>\n    const discriminant = String(obj.discriminant)\n    const firstEntry = Object.entries(variants).at(0)\n    if (!firstEntry) return OMIT\n    const [firstValue, firstFields] = firstEntry\n    const branch: Record<string, unknown> = { [discriminant]: firstValue }\n    for (const [name, descriptor] of Object.entries(firstFields)) {\n      const isOpt = isOptional(descriptor)\n      const pri = isShould(descriptor)\n      if (isOpt && pri !== 'should') continue\n      const value = exampleValue(descriptor)\n      if (value === OMIT) continue\n      branch[name] = value\n    }\n    return branch\n  }\n  return OMIT\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llui/agent",
-  "version": "0.0.42",
+  "version": "0.0.44",
   "type": "module",
   "sideEffects": false,
   "exports": {