@llui/agent 0.0.29

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Franco Ponticelli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,210 @@
+# @llui/agent
+
+Server and browser-client libraries for the [LLui Agent Protocol (LAP)](../../docs/superpowers/specs/2026-04-19-llui-agent-design.md).
+
+## What this buys you
+
+Your app's users can install the `llui-agent` bridge into Claude Desktop once, paste a token you mint for them, and drive your LLui app from Claude. Same Msgs and State you're already using — Claude dispatches like a remote user.
+
+## Install
+
+```bash
+pnpm add @llui/agent @llui/effects ws
+pnpm add -D @llui/vite-plugin  # if not already present
+```
+
+Enable agent-metadata emission in `vite.config.ts`:
+
+```ts
+import llui from '@llui/vite-plugin'
+export default { plugins: [llui({ agent: true })] }
+```
+
+## Server
+
+```ts
+import { createLluiAgentServer } from '@llui/agent/server'
+import express from 'express'
+
+const agent = createLluiAgentServer({
+  signingKey: process.env.LLUI_AGENT_KEY!,
+  identityResolver: async (req) => req.cookies.user_id ?? null,
+})
+
+const app = express()
+// The router is Web-standards; adapt it:
+app.use('/agent', async (req, res) => {
+  const webReq = expressToWebRequest(req) // adapter
+  const webRes = await agent.router(webReq)
+  if (!webRes) {
+    res.status(404).end()
+    return
+  }
+  webRes.headers.forEach((v, k) => res.setHeader(k, v))
+  res.status(webRes.status).send(await webRes.text())
+})
+
+const server = app.listen(8787)
+server.on('upgrade', agent.wsUpgrade)
+```
+
+## Client
+
+```ts
+import { mountApp } from '@llui/dom'
+import { createAgentClient, agentConnect, agentConfirm, agentLog } from '@llui/agent/client'
+import { handleEffects } from '@llui/effects'
+import { App } from './App'
+
+const root = document.getElementById('app')!
+const handle = mountApp(root, App)
+
+const client = createAgentClient({
+  handle,
+  def: App,
+  rootElement: root,
+  slices: {
+    getConnect: (s) => s.agent.connect,
+    getConfirm: (s) => s.agent.confirm,
+    wrapConnectMsg: (m) => ({ type: 'agent', sub: 'connect', msg: m }),
+    wrapConfirmMsg: (m) => ({ type: 'agent', sub: 'confirm', msg: m }),
+  },
+})
+client.start()
+
+// Chain client.effectHandler into your onEffect:
+const onEffect = handleEffects<MyEffect | AgentEffect>()
+  .when('http', ...)
+  .else(client.effectHandler)
+```
+
+## App-side annotations
+
+```ts
+type Msg =
+  /** @intent("Increment the counter") */
+  | { type: 'inc' }
+  /** @intent("Delete item") @requiresConfirm */
+  | { type: 'delete', id: string }
+  /** @intent("Place order") @humanOnly */
+  | { type: 'checkout' }
+  /** @intent("Navigate") @alwaysAffordable */
+  | { type: 'nav', to: 'reports' | 'settings' | 'home' }
+
+export const App = component<State, Msg, Effect>({
+  name: 'App',
+  init: ...,
+  update: ...,
+  view: ...,
+  agentAffordances: (state) => [
+    { type: 'nav', to: 'reports' },
+    ...(state.user ? [{ type: 'signOut' }] : []),
+  ],
+  agentDocs: {
+    purpose: 'Kanban for a 3-person design team.',
+    overview: 'Columns: To do / Doing / Done. Cards carry owner, due date, tags.',
+    cautions: ['Moving to Done locks edits — reopen first.'],
+  },
+  agentContext: (state) => ({
+    summary: `Viewing board "${state.boardName}", ${state.cards.length} cards visible.`,
+    hints: state.selectedCard
+      ? ['Card focused; enter advances status.']
+      : ['Tab to list, arrow to select.'],
+  }),
+})
+```
+
+## Annotations reference
+
+| Tag                 | Semantics                                                    |
+| ------------------- | ------------------------------------------------------------ |
+| `@intent("...")`    | Human-readable label for Claude + confirmation UI + log      |
+| `@alwaysAffordable` | Surfaces to Claude even when no binding is currently visible |
+| `@requiresConfirm`  | Claude must propose; user approves before dispatch           |
+| `@humanOnly`        | Claude cannot dispatch; not in `list_actions`                |
+
+## App state shape (host integration)
+
+Wire your root state and Msg to include agent sub-slices:
+
+```ts
+type State = {
+  // ...your app state...
+  agent: {
+    connect: agentConnect.State
+    confirm: agentConfirm.State
+    log: agentLog.State
+  }
+}
+
+type Msg =
+  // ...your app msgs...
+  | { type: 'agent'; sub: 'connect'; msg: agentConnect.Msg }
+  | { type: 'agent'; sub: 'confirm'; msg: agentConfirm.Msg }
+  | { type: 'agent'; sub: 'log'; msg: agentLog.Msg }
+```
+
+Delegate in `update`:
+
+```ts
+update: (state, msg) => {
+  if (msg.type === 'agent') {
+    if (msg.sub === 'connect') {
+      const [connect, effects] = agentConnect.update(state.agent.connect, msg.msg)
+      return [{ ...state, agent: { ...state.agent, connect } }, effects]
+    }
+    if (msg.sub === 'confirm') {
+      const [confirm, effects] = agentConfirm.update(state.agent.confirm, msg.msg)
+      return [{ ...state, agent: { ...state.agent, confirm } }, effects]
+    }
+    if (msg.sub === 'log') {
+      const [log, effects] = agentLog.update(state.agent.log, msg.msg)
+      return [{ ...state, agent: { ...state.agent, log } }, effects]
+    }
+  }
+  // ...your app logic...
+}
+```
+
+## View wiring
+
+Render `agentConnect`, `agentConfirm`, and `agentLog` anywhere in your view tree:
+
+```ts
+view: ({ send, branch, show }) => {
+  const connectParts = agentConnect.connect(
+    (s) => s.agent.connect,
+    (m) => send({ type: 'agent', sub: 'connect', msg: m }),
+    { mintUrl: '/agent/mint' },
+  )
+
+  const confirmParts = agentConfirm.connect(
+    (s) => s.agent.confirm,
+    (m) => send({ type: 'agent', sub: 'confirm', msg: m }),
+  )
+
+  return [
+    // Renders the "Connect with Claude" button + token copy box + session list:
+    div(connectParts.root, [
+      button(connectParts.mintTrigger, ['Connect with Claude']),
+      ...show({
+        when: (s) => s.agent.connect.pendingToken !== null,
+        render: () => [
+          pre(connectParts.pendingTokenBox),
+          button(connectParts.copyConnectSnippetButton, ['Copy']),
+        ],
+      }),
+    ]),
+    // Renders pending confirmation cards:
+    div(confirmParts.root),
+  ]
+}
+```
+
+## Entry points
+
+- `@llui/agent/protocol` — all LAP types, WS frame types, token types, audit types.
+- `@llui/agent/server` — `createLluiAgentServer`, `InMemoryTokenStore`, `consoleAuditSink`, interfaces.
+- `@llui/agent/client` — `createAgentClient`, `agentConnect`, `agentConfirm`, `agentLog`, `AgentEffect`.
+
+See the [Agent Protocol doc](../../docs/designs/10%20Agent%20Protocol.md) for the full wire protocol and security model.

package/dist/client/agentConfirm.d.ts

@@ -0,0 +1,60 @@
+import type { AgentEffect } from './effects.js';
+export type ConfirmEntry = {
+    id: string;
+    variant: string;
+    payload: unknown;
+    intent: string;
+    reason: string | null;
+    proposedAt: number;
+    status: 'pending' | 'approved' | 'rejected';
+};
+export type AgentConfirmState = {
+    pending: ConfirmEntry[];
+};
+export type AgentConfirmMsg = {
+    type: 'Propose';
+    entry: ConfirmEntry;
+} | {
+    type: 'Approve';
+    id: string;
+} | {
+    type: 'Reject';
+    id: string;
+} | {
+    type: 'ExpireStale';
+    now: number;
+    maxAgeMs: number;
+};
+export declare function init(): [AgentConfirmState, AgentEffect[]];
+export declare function update(state: AgentConfirmState, msg: AgentConfirmMsg): [AgentConfirmState, AgentEffect[]];
+import { type Send } from '@llui/dom';
+type ConnectBag = {
+    root: {
+        'data-scope': string;
+    };
+    entry: (id: string) => {
+        card: {
+            'data-part': string;
+            'data-status': string;
+            'data-id': string;
+        };
+        approveButton: {
+            onClick: () => void;
+            disabled: boolean;
+        };
+        rejectButton: {
+            onClick: () => void;
+            disabled: boolean;
+        };
+        intentText: string;
+        reasonText: string | null;
+        payloadText: string;
+    } | null;
+    empty: {
+        'data-part': string;
+        'data-visible': boolean;
+    };
+};
+export declare function connect<S>(get: (s: S) => AgentConfirmState, send: Send<AgentConfirmMsg>): (state: S) => ConnectBag;
+export {};
+//# sourceMappingURL=agentConfirm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentConfirm.d.ts","sourceRoot":"","sources":["../../src/client/agentConfirm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAAE,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,CAAA;AAE3D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,wBAAgB,IAAI,IAAI,CAAC,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAEzD;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,eAAe,GACnB,CAAC,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAgCpC;AAGD,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9B,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QACrB,IAAI,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;QACvE,aAAa,EAAE;YAAE,OAAO,EAAE,MAAM,IAAI,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,CAAA;QACzD,YAAY,EAAE;YAAE,OAAO,EAAE,MAAM,IAAI,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,CAAA;QACxD,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;QACzB,WAAW,EAAE,MAAM,CAAA;KACpB,GAAG,IAAI,CAAA;IACR,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAA;CACxD,CAAA;AAED,wBAAgB,OAAO,CAAC,CAAC,EACvB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,iBAAiB,EAChC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,GAC1B,CAAC,KAAK,EAAE,CAAC,KAAK,UAAU,CA0B1B"}

package/dist/client/agentConfirm.js

@@ -0,0 +1,66 @@
+export function init() {
+    return [{ pending: [] }, []];
+}
+export function update(state, msg) {
+    switch (msg.type) {
+        case 'Propose':
+            return [{ pending: [...state.pending, msg.entry] }, []];
+        case 'Approve': {
+            const entry = state.pending.find((e) => e.id === msg.id);
+            if (!entry || entry.status !== 'pending')
+                return [state, []];
+            return [
+                { pending: state.pending.map((e) => (e.id === msg.id ? { ...e, status: 'approved' } : e)) },
+                [
+                    {
+                        type: 'AgentForwardMsg',
+                        payload: { type: entry.variant, ...entry.payload },
+                    },
+                ],
+            ];
+        }
+        case 'Reject':
+            return [
+                { pending: state.pending.map((e) => (e.id === msg.id ? { ...e, status: 'rejected' } : e)) },
+                [],
+            ];
+        case 'ExpireStale':
+            return [
+                {
+                    pending: state.pending.filter((e) => msg.now - e.proposedAt <= msg.maxAgeMs || e.status !== 'pending'),
+                },
+                [],
+            ];
+    }
+}
+// Connect bag:
+import {} from '@llui/dom';
+export function connect(get, send) {
+    return (state) => {
+        const s = get(state);
+        return {
+            root: { 'data-scope': 'agent-confirm' },
+            entry: (id) => {
+                const e = s.pending.find((x) => x.id === id);
+                if (!e)
+                    return null;
+                return {
+                    card: { 'data-part': 'entry', 'data-status': e.status, 'data-id': e.id },
+                    approveButton: {
+                        onClick: () => send({ type: 'Approve', id }),
+                        disabled: e.status !== 'pending',
+                    },
+                    rejectButton: {
+                        onClick: () => send({ type: 'Reject', id }),
+                        disabled: e.status !== 'pending',
+                    },
+                    intentText: e.intent,
+                    reasonText: e.reason,
+                    payloadText: JSON.stringify(e.payload, null, 2),
+                };
+            },
+            empty: { 'data-part': 'empty', 'data-visible': s.pending.length === 0 },
+        };
+    };
+}
+//# sourceMappingURL=agentConfirm.js.map

package/dist/client/agentConfirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentConfirm.js","sourceRoot":"","sources":["../../src/client/agentConfirm.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentEffect } from './effects.js'\n\nexport type ConfirmEntry = {\n  id: string\n  variant: string\n  payload: unknown\n  intent: string\n  reason: string | null\n  proposedAt: number\n  status: 'pending' | 'approved' | 'rejected'\n}\n\nexport type AgentConfirmState = { pending: ConfirmEntry[] }\n\nexport type AgentConfirmMsg =\n  | { type: 'Propose'; entry: ConfirmEntry }\n  | { type: 'Approve'; id: string }\n  | { type: 'Reject'; id: string }\n  | { type: 'ExpireStale'; now: number; maxAgeMs: number }\n\nexport function init(): [AgentConfirmState, AgentEffect[]] {\n  return [{ pending: [] }, []]\n}\n\nexport function update(\n  state: AgentConfirmState,\n  msg: AgentConfirmMsg,\n): [AgentConfirmState, AgentEffect[]] {\n  switch (msg.type) {\n    case 'Propose':\n      return [{ pending: [...state.pending, msg.entry] }, []]\n    case 'Approve': {\n      const entry = state.pending.find((e) => e.id === msg.id)\n      if (!entry || entry.status !== 'pending') return [state, []]\n      return [\n        { pending: state.pending.map((e) => (e.id === msg.id ? { ...e, status: 'approved' } : e)) },\n        [\n          {\n            type: 'AgentForwardMsg',\n            payload: { type: entry.variant, ...(entry.payload as object) },\n          },\n        ],\n      ]\n    }\n    case 'Reject':\n      return [\n        { pending: state.pending.map((e) => (e.id === msg.id ? { ...e, status: 'rejected' } : e)) },\n        [],\n      ]\n    case 'ExpireStale':\n      return [\n        {\n          pending: state.pending.filter(\n            (e) => msg.now - e.proposedAt <= msg.maxAgeMs || e.status !== 'pending',\n          ),\n        },\n        [],\n      ]\n  }\n}\n\n// Connect bag:\nimport { type Send } from '@llui/dom'\n\ntype ConnectBag = {\n  root: { 'data-scope': string }\n  entry: (id: string) => {\n    card: { 'data-part': string; 'data-status': string; 'data-id': string }\n    approveButton: { onClick: () => void; disabled: boolean }\n    rejectButton: { onClick: () => void; disabled: boolean }\n    intentText: string\n    reasonText: string | null\n    payloadText: string\n  } | null\n  empty: { 'data-part': string; 'data-visible': boolean }\n}\n\nexport function connect<S>(\n  get: (s: S) => AgentConfirmState,\n  send: Send<AgentConfirmMsg>,\n): (state: S) => ConnectBag {\n  return (state) => {\n    const s = get(state)\n    return {\n      root: { 'data-scope': 'agent-confirm' },\n      entry: (id) => {\n        const e = s.pending.find((x) => x.id === id)\n        if (!e) return null\n        return {\n          card: { 'data-part': 'entry', 'data-status': e.status, 'data-id': e.id },\n          approveButton: {\n            onClick: () => send({ type: 'Approve', id }),\n            disabled: e.status !== 'pending',\n          },\n          rejectButton: {\n            onClick: () => send({ type: 'Reject', id }),\n            disabled: e.status !== 'pending',\n          },\n          intentText: e.intent,\n          reasonText: e.reason,\n          payloadText: JSON.stringify(e.payload, null, 2),\n        }\n      },\n      empty: { 'data-part': 'empty', 'data-visible': s.pending.length === 0 },\n    }\n  }\n}\n"]}

package/dist/client/agentConnect.d.ts

@@ -0,0 +1,125 @@
+import type { Send } from '@llui/dom';
+import type { AgentSession, AgentToken } from '../protocol.js';
+import type { AgentEffect } from './effects.js';
+export type AgentConnectStatus = 'idle' | 'minting' | 'pending-claude' | 'active' | 'error';
+export type AgentConnectPendingToken = {
+    token: AgentToken;
+    tid: string;
+    lapUrl: string;
+    connectSnippet: string;
+    expiresAt: number;
+};
+export type AgentConnectState = {
+    status: AgentConnectStatus;
+    pendingToken: AgentConnectPendingToken | null;
+    sessions: AgentSession[];
+    resumable: AgentSession[];
+    error: {
+        code: string;
+        detail: string;
+    } | null;
+};
+export type AgentConnectMsg = {
+    type: 'Mint';
+} | {
+    type: 'MintSucceeded';
+    token: AgentToken;
+    tid: string;
+    lapUrl: string;
+    wsUrl: string;
+    expiresAt: number;
+} | {
+    type: 'MintFailed';
+    error: {
+        code: string;
+        detail: string;
+    };
+} | {
+    type: 'WsOpened';
+} | {
+    type: 'WsClosed';
+} | {
+    type: 'ActivatedByClaude';
+} | {
+    type: 'ResumeList';
+    tids: string[];
+} | {
+    type: 'ResumeListLoaded';
+    sessions: AgentSession[];
+} | {
+    type: 'Resume';
+    tid: string;
+} | {
+    type: 'Revoke';
+    tid: string;
+} | {
+    type: 'ClearError';
+} | {
+    type: 'SessionsLoaded';
+    sessions: AgentSession[];
+} | {
+    type: 'RefreshSessions';
+};
+export type AgentConnectInitOpts = {
+    mintUrl: string;
+};
+/** Component shape is [State, Effect[]] — consistent with @llui/components. */
+export declare function init(_opts: AgentConnectInitOpts): [AgentConnectState, AgentEffect[]];
+export declare function update(state: AgentConnectState, msg: AgentConnectMsg, opts: AgentConnectInitOpts): [AgentConnectState, AgentEffect[]];
+export type AgentConnectConnectOptions = {
+    id?: string;
+};
+type ConnectBag = {
+    root: {
+        'data-scope': string;
+        'data-state': string;
+    };
+    mintTrigger: {
+        onClick: () => void;
+        disabled: boolean;
+    };
+    pendingTokenBox: {
+        'data-part': string;
+        'data-visible': boolean;
+    };
+    copyConnectSnippetButton: {
+        onClick: () => void;
+        disabled: boolean;
+    };
+    sessionsList: {
+        'data-part': string;
+    };
+    sessionItem: (tid: string) => {
+        'data-part': string;
+        'data-tid': string;
+    };
+    revokeButton: (tid: string) => {
+        onClick: () => void;
+    };
+    resumeBanner: {
+        'data-part': string;
+        'data-visible': boolean;
+    };
+    resumeItem: (tid: string) => {
+        'data-part': string;
+        'data-tid': string;
+    };
+    resumeButton: (tid: string) => {
+        onClick: () => void;
+    };
+    dismissButton: (tid: string) => {
+        onClick: () => void;
+    };
+    error: {
+        'data-part': string;
+        'data-visible': boolean;
+        onClick: () => void;
+    };
+};
+/**
+ * Builds prop bags for the view. See spec §9.1 and the @llui/components
+ * dialog.ts pattern.
+ */
+export declare function connect<S>(get: (s: S) => AgentConnectState, send: Send<AgentConnectMsg>, _opts?: AgentConnectConnectOptions): (state: S) => ConnectBag;
+export {};
+//# sourceMappingURL=agentConnect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentConnect.d.ts","sourceRoot":"","sources":["../../src/client/agentConnect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE3F,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,UAAU,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,YAAY,EAAE,wBAAwB,GAAG,IAAI,CAAA;IAC7C,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,SAAS,EAAE,YAAY,EAAE,CAAA;IACzB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC/C,CAAA;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACE,IAAI,EAAE,eAAe,CAAA;IACrB,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,YAAY,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAE/B,MAAM,MAAM,oBAAoB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD,+EAA+E;AAC/E,wBAAgB,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,CAAC,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAWpF;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,oBAAoB,GACzB,CAAC,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAqDpC;AAID,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;IACpD,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,IAAI,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAA;IACvD,eAAe,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAA;IACjE,wBAAwB,EAAE;QAAE,OAAO,EAAE,MAAM,IAAI,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAA;IACpE,YAAY,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACzE,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IACtD,YAAY,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAA;IAC9D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACxE,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IACtD,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IACvD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;CAC7E,CAAA;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,iBAAiB,EAChC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,EAC3B,KAAK,GAAE,0BAA+B,GACrC,CAAC,KAAK,EAAE,CAAC,KAAK,UAAU,CAyC1B"}

package/dist/client/agentConnect.js

@@ -0,0 +1,114 @@
+/** Component shape is [State, Effect[]] — consistent with @llui/components. */
+export function init(_opts) {
+    return [
+        {
+            status: 'idle',
+            pendingToken: null,
+            sessions: [],
+            resumable: [],
+            error: null,
+        },
+        [],
+    ];
+}
+export function update(state, msg, opts) {
+    switch (msg.type) {
+        case 'Mint':
+            return [
+                { ...state, status: 'minting' },
+                [{ type: 'AgentMintRequest', mintUrl: opts.mintUrl }],
+            ];
+        case 'MintSucceeded': {
+            const pending = {
+                token: msg.token,
+                tid: msg.tid,
+                lapUrl: msg.lapUrl,
+                connectSnippet: `/llui-connect ${msg.lapUrl} ${msg.token}`,
+                expiresAt: msg.expiresAt,
+            };
+            return [
+                { ...state, status: 'pending-claude', pendingToken: pending, error: null },
+                [{ type: 'AgentOpenWS', token: msg.token, wsUrl: msg.wsUrl }],
+            ];
+        }
+        case 'MintFailed':
+            return [{ ...state, status: 'error', error: msg.error }, []];
+        case 'WsOpened':
+            // WS is open but Claude hasn't bound yet; stay at pending-claude.
+            return [state, []];
+        case 'WsClosed':
+            return [{ ...state, status: 'idle', pendingToken: null }, []];
+        case 'ActivatedByClaude':
+            return [{ ...state, status: 'active' }, []];
+        case 'ResumeList':
+            return [state, [{ type: 'AgentResumeCheck', tids: msg.tids }]];
+        case 'ResumeListLoaded':
+            return [{ ...state, resumable: msg.sessions }, []];
+        case 'Resume':
+            return [state, [{ type: 'AgentResumeClaim', tid: msg.tid }]];
+        case 'Revoke': {
+            // Optimistically remove from sessions + resumable.
+            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 }],
+            ];
+        }
+        case 'ClearError':
+            return [{ ...state, error: null }, []];
+        case 'SessionsLoaded':
+            return [{ ...state, sessions: msg.sessions }, []];
+        case 'RefreshSessions':
+            return [state, [{ type: 'AgentSessionsList' }]];
+    }
+}
+/**
+ * Builds prop bags for the view. See spec §9.1 and the @llui/components
+ * dialog.ts pattern.
+ */
+export function connect(get, send, _opts = {}) {
+    return (state) => {
+        const s = get(state);
+        return {
+            root: { 'data-scope': 'agent-connect', 'data-state': s.status },
+            mintTrigger: {
+                onClick: () => send({ type: 'Mint' }),
+                disabled: s.status === 'minting' || s.status === 'pending-claude' || s.status === 'active',
+            },
+            pendingTokenBox: { 'data-part': 'pending-token', 'data-visible': s.pendingToken !== null },
+            copyConnectSnippetButton: {
+                onClick: () => {
+                    if (s.pendingToken && typeof navigator !== 'undefined' && 'clipboard' in navigator) {
+                        void navigator.clipboard.writeText(s.pendingToken.connectSnippet);
+                    }
+                },
+                disabled: s.pendingToken === null,
+            },
+            sessionsList: { 'data-part': 'sessions-list' },
+            sessionItem: (tid) => ({ 'data-part': 'session-item', 'data-tid': tid }),
+            revokeButton: (tid) => ({ onClick: () => send({ type: 'Revoke', tid }) }),
+            resumeBanner: { 'data-part': 'resume-banner', 'data-visible': s.resumable.length > 0 },
+            resumeItem: (tid) => ({ 'data-part': 'resume-item', 'data-tid': tid }),
+            resumeButton: (tid) => ({ onClick: () => send({ type: 'Resume', tid }) }),
+            dismissButton: (tid) => ({
+                // For dismiss, we currently just remove the resumable record locally.
+                // A "dismiss forever" flag could land in a follow-up; for v1, dismiss
+                // is a client-side-only state prune by reusing the Revoke Msg path
+                // with intent-split; for now Emit Revoke which both revokes server-side
+                // AND removes locally. Alternative: emit a new DismissResume msg —
+                // spec §9.1 lists dismissButton but doesn't spell out the emitted msg.
+                // V1 pragmatic choice: same as revoke (mark revoked on server).
+                onClick: () => send({ type: 'Revoke', tid }),
+            }),
+            error: {
+                'data-part': 'error',
+                'data-visible': s.error !== null,
+                onClick: () => send({ type: 'ClearError' }),
+            },
+        };
+    };
+}
+//# sourceMappingURL=agentConnect.js.map

package/dist/client/agentConnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentConnect.js","sourceRoot":"","sources":["../../src/client/agentConnect.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Send } from '@llui/dom'\nimport type { AgentSession, AgentToken } from '../protocol.js'\nimport type { AgentEffect } from './effects.js'\n\nexport type AgentConnectStatus = 'idle' | 'minting' | 'pending-claude' | 'active' | 'error'\n\nexport type AgentConnectPendingToken = {\n  token: AgentToken\n  tid: string\n  lapUrl: string\n  connectSnippet: string // \"/llui-connect <lapUrl> <token>\"\n  expiresAt: number\n}\n\nexport type AgentConnectState = {\n  status: AgentConnectStatus\n  pendingToken: AgentConnectPendingToken | null\n  sessions: AgentSession[]\n  resumable: AgentSession[]\n  error: { code: string; detail: string } | null\n}\n\nexport type AgentConnectMsg =\n  | { type: 'Mint' }\n  | {\n      type: 'MintSucceeded'\n      token: AgentToken\n      tid: string\n      lapUrl: string\n      wsUrl: string\n      expiresAt: number\n    }\n  | { type: 'MintFailed'; error: { code: string; detail: string } }\n  | { type: 'WsOpened' }\n  | { type: 'WsClosed' }\n  | { type: 'ActivatedByClaude' }\n  | { type: 'ResumeList'; tids: string[] }\n  | { type: 'ResumeListLoaded'; sessions: AgentSession[] }\n  | { type: 'Resume'; tid: string }\n  | { type: 'Revoke'; tid: string }\n  | { type: 'ClearError' }\n  | { type: 'SessionsLoaded'; sessions: AgentSession[] }\n  | { type: 'RefreshSessions' }\n\nexport type AgentConnectInitOpts = { mintUrl: string }\n\n/** Component shape is [State, Effect[]] — consistent with @llui/components. */\nexport function init(_opts: AgentConnectInitOpts): [AgentConnectState, AgentEffect[]] {\n  return [\n    {\n      status: 'idle',\n      pendingToken: null,\n      sessions: [],\n      resumable: [],\n      error: null,\n    },\n    [],\n  ]\n}\n\nexport function update(\n  state: AgentConnectState,\n  msg: AgentConnectMsg,\n  opts: AgentConnectInitOpts,\n): [AgentConnectState, AgentEffect[]] {\n  switch (msg.type) {\n    case 'Mint':\n      return [\n        { ...state, status: 'minting' },\n        [{ type: 'AgentMintRequest', mintUrl: opts.mintUrl }],\n      ]\n    case 'MintSucceeded': {\n      const pending: AgentConnectPendingToken = {\n        token: msg.token,\n        tid: msg.tid,\n        lapUrl: msg.lapUrl,\n        connectSnippet: `/llui-connect ${msg.lapUrl} ${msg.token}`,\n        expiresAt: msg.expiresAt,\n      }\n      return [\n        { ...state, status: 'pending-claude', pendingToken: pending, error: null },\n        [{ type: 'AgentOpenWS', token: msg.token, wsUrl: msg.wsUrl }],\n      ]\n    }\n    case 'MintFailed':\n      return [{ ...state, status: 'error', error: msg.error }, []]\n    case 'WsOpened':\n      // WS is open but Claude hasn't bound yet; stay at pending-claude.\n      return [state, []]\n    case 'WsClosed':\n      return [{ ...state, status: 'idle', pendingToken: null }, []]\n    case 'ActivatedByClaude':\n      return [{ ...state, status: 'active' }, []]\n    case 'ResumeList':\n      return [state, [{ type: 'AgentResumeCheck', tids: msg.tids }]]\n    case 'ResumeListLoaded':\n      return [{ ...state, resumable: msg.sessions }, []]\n    case 'Resume':\n      return [state, [{ type: 'AgentResumeClaim', tid: msg.tid }]]\n    case 'Revoke': {\n      // Optimistically remove from sessions + resumable.\n      return [\n        {\n          ...state,\n          sessions: state.sessions.filter((s) => s.tid !== msg.tid),\n          resumable: state.resumable.filter((s) => s.tid !== msg.tid),\n        },\n        [{ type: 'AgentRevoke', tid: msg.tid }],\n      ]\n    }\n    case 'ClearError':\n      return [{ ...state, error: null }, []]\n    case 'SessionsLoaded':\n      return [{ ...state, sessions: msg.sessions }, []]\n    case 'RefreshSessions':\n      return [state, [{ type: 'AgentSessionsList' }]]\n  }\n}\n\n// ── Connect helper ────────────────────────────────────────────────────────────\n\nexport type AgentConnectConnectOptions = {\n  id?: string // optional DOM id prefix\n}\n\ntype ConnectBag = {\n  root: { 'data-scope': string; 'data-state': string }\n  mintTrigger: { onClick: () => void; disabled: boolean }\n  pendingTokenBox: { 'data-part': string; 'data-visible': boolean }\n  copyConnectSnippetButton: { onClick: () => void; disabled: boolean }\n  sessionsList: { 'data-part': string }\n  sessionItem: (tid: string) => { 'data-part': string; 'data-tid': string }\n  revokeButton: (tid: string) => { onClick: () => void }\n  resumeBanner: { 'data-part': string; 'data-visible': boolean }\n  resumeItem: (tid: string) => { 'data-part': string; 'data-tid': string }\n  resumeButton: (tid: string) => { onClick: () => void }\n  dismissButton: (tid: string) => { onClick: () => void }\n  error: { 'data-part': string; 'data-visible': boolean; onClick: () => void }\n}\n\n/**\n * Builds prop bags for the view. See spec §9.1 and the @llui/components\n * dialog.ts pattern.\n */\nexport function connect<S>(\n  get: (s: S) => AgentConnectState,\n  send: Send<AgentConnectMsg>,\n  _opts: AgentConnectConnectOptions = {},\n): (state: S) => ConnectBag {\n  return (state) => {\n    const s = get(state)\n    return {\n      root: { 'data-scope': 'agent-connect', 'data-state': s.status },\n      mintTrigger: {\n        onClick: () => send({ type: 'Mint' }),\n        disabled: s.status === 'minting' || s.status === 'pending-claude' || s.status === 'active',\n      },\n      pendingTokenBox: { 'data-part': 'pending-token', 'data-visible': s.pendingToken !== null },\n      copyConnectSnippetButton: {\n        onClick: () => {\n          if (s.pendingToken && typeof navigator !== 'undefined' && 'clipboard' in navigator) {\n            void navigator.clipboard.writeText(s.pendingToken.connectSnippet)\n          }\n        },\n        disabled: s.pendingToken === null,\n      },\n      sessionsList: { 'data-part': 'sessions-list' },\n      sessionItem: (tid) => ({ 'data-part': 'session-item', 'data-tid': tid }),\n      revokeButton: (tid) => ({ onClick: () => send({ type: 'Revoke', tid }) }),\n      resumeBanner: { 'data-part': 'resume-banner', 'data-visible': s.resumable.length > 0 },\n      resumeItem: (tid) => ({ 'data-part': 'resume-item', 'data-tid': tid }),\n      resumeButton: (tid) => ({ onClick: () => send({ type: 'Resume', tid }) }),\n      dismissButton: (tid) => ({\n        // For dismiss, we currently just remove the resumable record locally.\n        // A \"dismiss forever\" flag could land in a follow-up; for v1, dismiss\n        // is a client-side-only state prune by reusing the Revoke Msg path\n        // with intent-split; for now Emit Revoke which both revokes server-side\n        // AND removes locally. Alternative: emit a new DismissResume msg —\n        // spec §9.1 lists dismissButton but doesn't spell out the emitted msg.\n        // V1 pragmatic choice: same as revoke (mark revoked on server).\n        onClick: () => send({ type: 'Revoke', tid }),\n      }),\n      error: {\n        'data-part': 'error',\n        'data-visible': s.error !== null,\n        onClick: () => send({ type: 'ClearError' }),\n      },\n    }\n  }\n}\n"]}