@llui/agent 0.0.29

package/dist/client/rpc/describe-visible-content.js

@@ -0,0 +1,66 @@
+/**
+ * Walk data-agent-tagged subtrees and produce a structured outline.
+ * Buttons cross-reference __bindingDescriptors so Claude can tie
+ * visible text to variant names.
+ */
+export function handleDescribeVisibleContent(host) {
+    const root = host.getRootElement();
+    if (!root)
+        return { outline: [] };
+    const out = [];
+    const allZones = Array.from(root.querySelectorAll('[data-agent]'));
+    // Only walk top-level zones; skip zones that are descendants of other zones
+    const topLevel = allZones.filter((zone) => !allZones.some((other) => other !== zone && other.contains(zone)));
+    for (const zone of topLevel) {
+        walk(zone, out);
+    }
+    return { outline: out };
+}
+function walk(el, out) {
+    const tag = el.tagName.toLowerCase();
+    const text = (el.textContent ?? '').trim();
+    if (/^h[1-6]$/.test(tag)) {
+        out.push({ kind: 'heading', level: Number(tag[1]), text });
+        return;
+    }
+    if (tag === 'button') {
+        out.push({
+            kind: 'button',
+            text,
+            disabled: el.disabled,
+            actionVariant: el.getAttribute('data-agent') ?? null,
+        });
+        return;
+    }
+    if (tag === 'a' && el.getAttribute('href')) {
+        out.push({ kind: 'link', text, href: el.getAttribute('href') ?? '' });
+        return;
+    }
+    if (tag === 'input') {
+        out.push({
+            kind: 'input',
+            label: el.getAttribute('aria-label') ?? el.getAttribute('name') ?? null,
+            value: el.value ?? null,
+            type: el.type ?? 'text',
+        });
+        return;
+    }
+    if (tag === 'ul' || tag === 'ol') {
+        const items = [];
+        for (const child of Array.from(el.children)) {
+            if (child.tagName.toLowerCase() === 'li') {
+                items.push({ kind: 'item', text: (child.textContent ?? '').trim() });
+            }
+        }
+        out.push({ kind: 'list', items });
+        return;
+    }
+    if (text.length > 0 && el.children.length === 0) {
+        out.push({ kind: 'text', text });
+        return;
+    }
+    for (const child of Array.from(el.children)) {
+        walk(child, out);
+    }
+}
+//# sourceMappingURL=describe-visible-content.js.map

package/dist/client/rpc/describe-visible-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-visible-content.js","sourceRoot":"","sources":["../../../src/client/rpc/describe-visible-content.ts"],"names":[],"mappings":"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","sourcesContent":["import type { OutlineNode } from '../../protocol.js'\n\nexport type DescribeVisibleArgs = Record<string, never>\nexport type DescribeVisibleResult = { outline: OutlineNode[] }\n\nexport type DescribeVisibleHost = {\n  getRootElement(): Element | null\n  getBindingDescriptors(): Array<{ variant: string }> | null\n  getMsgAnnotations(): Record<string, { intent: string | null; humanOnly: boolean }> | null\n}\n\n/**\n * Walk data-agent-tagged subtrees and produce a structured outline.\n * Buttons cross-reference __bindingDescriptors so Claude can tie\n * visible text to variant names.\n */\nexport function handleDescribeVisibleContent(host: DescribeVisibleHost): DescribeVisibleResult {\n  const root = host.getRootElement()\n  if (!root) return { outline: [] }\n  const out: OutlineNode[] = []\n  const allZones = Array.from(root.querySelectorAll('[data-agent]'))\n  // Only walk top-level zones; skip zones that are descendants of other zones\n  const topLevel = allZones.filter(\n    (zone) => !allZones.some((other) => other !== zone && other.contains(zone)),\n  )\n  for (const zone of topLevel) {\n    walk(zone, out)\n  }\n  return { outline: out }\n}\n\nfunction walk(el: Element, out: OutlineNode[]): void {\n  const tag = el.tagName.toLowerCase()\n  const text = (el.textContent ?? '').trim()\n  if (/^h[1-6]$/.test(tag)) {\n    out.push({ kind: 'heading', level: Number(tag[1]), text })\n    return\n  }\n  if (tag === 'button') {\n    out.push({\n      kind: 'button',\n      text,\n      disabled: (el as HTMLButtonElement).disabled,\n      actionVariant: el.getAttribute('data-agent') ?? null,\n    })\n    return\n  }\n  if (tag === 'a' && el.getAttribute('href')) {\n    out.push({ kind: 'link', text, href: el.getAttribute('href') ?? '' })\n    return\n  }\n  if (tag === 'input') {\n    out.push({\n      kind: 'input',\n      label: el.getAttribute('aria-label') ?? el.getAttribute('name') ?? null,\n      value: (el as HTMLInputElement).value ?? null,\n      type: (el as HTMLInputElement).type ?? 'text',\n    })\n    return\n  }\n  if (tag === 'ul' || tag === 'ol') {\n    const items: OutlineNode[] = []\n    for (const child of Array.from(el.children)) {\n      if (child.tagName.toLowerCase() === 'li') {\n        items.push({ kind: 'item', text: (child.textContent ?? '').trim() })\n      }\n    }\n    out.push({ kind: 'list', items })\n    return\n  }\n  if (text.length > 0 && el.children.length === 0) {\n    out.push({ kind: 'text', text })\n    return\n  }\n  for (const child of Array.from(el.children)) {\n    walk(child, out)\n  }\n}\n"]}

package/dist/client/rpc/get-state.d.ts

@@ -0,0 +1,15 @@
+export type GetStateArgs = {
+    path?: string;
+};
+export type GetStateResult = {
+    state: unknown;
+};
+export type GetStateHost = {
+    getState(): unknown;
+};
+/**
+ * Spec §8.2: get_state returns a JSON-pointer-scoped slice of the
+ * app's current state, or the whole root state if no path is given.
+ */
+export declare function handleGetState(host: GetStateHost, args: GetStateArgs): GetStateResult;
+//# sourceMappingURL=get-state.d.ts.map

package/dist/client/rpc/get-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-state.d.ts","sourceRoot":"","sources":["../../../src/client/rpc/get-state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAC5C,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAC/C,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,IAAI,OAAO,CAAA;CAAE,CAAA;AAElD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,cAAc,CAIrF"}

package/dist/client/rpc/get-state.js

@@ -0,0 +1,37 @@
+/**
+ * Spec §8.2: get_state returns a JSON-pointer-scoped slice of the
+ * app's current state, or the whole root state if no path is given.
+ */
+export function handleGetState(host, args) {
+    const state = host.getState();
+    if (!args.path)
+        return { state };
+    return { state: resolveJsonPointer(state, args.path) };
+}
+function resolveJsonPointer(root, pointer) {
+    if (pointer === '' || pointer === '/')
+        return root;
+    // Accept either "/a/b" or "a/b"
+    const parts = pointer.split('/').filter((p) => p !== '');
+    let cur = root;
+    for (const raw of parts) {
+        // RFC 6901 escaping: ~1 → /, ~0 → ~
+        const key = raw.replace(/~1/g, '/').replace(/~0/g, '~');
+        if (cur === null || cur === undefined)
+            return undefined;
+        if (Array.isArray(cur)) {
+            const idx = Number(key);
+            if (!Number.isInteger(idx))
+                return undefined;
+            cur = cur[idx];
+        }
+        else if (typeof cur === 'object') {
+            cur = cur[key];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return cur;
+}
+//# sourceMappingURL=get-state.js.map

package/dist/client/rpc/get-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-state.js","sourceRoot":"","sources":["../../../src/client/rpc/get-state.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB,EAAE,IAAkB;IACnE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC7B,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IAChC,OAAO,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;AACxD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa,EAAE,OAAe;IACxD,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAClD,gCAAgC;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;IACxD,IAAI,GAAG,GAAY,IAAI,CAAA;IACvB,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,oCAAoC;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QACvD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACvD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;YACvB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAA;YAC5C,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;aAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,GAAG,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAA;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["export type GetStateArgs = { path?: string }\nexport type GetStateResult = { state: unknown }\nexport type GetStateHost = { getState(): unknown }\n\n/**\n * Spec §8.2: get_state returns a JSON-pointer-scoped slice of the\n * app's current state, or the whole root state if no path is given.\n */\nexport function handleGetState(host: GetStateHost, args: GetStateArgs): GetStateResult {\n  const state = host.getState()\n  if (!args.path) return { state }\n  return { state: resolveJsonPointer(state, args.path) }\n}\n\nfunction resolveJsonPointer(root: unknown, pointer: string): unknown {\n  if (pointer === '' || pointer === '/') return root\n  // Accept either \"/a/b\" or \"a/b\"\n  const parts = pointer.split('/').filter((p) => p !== '')\n  let cur: unknown = root\n  for (const raw of parts) {\n    // RFC 6901 escaping: ~1 → /, ~0 → ~\n    const key = raw.replace(/~1/g, '/').replace(/~0/g, '~')\n    if (cur === null || cur === undefined) return undefined\n    if (Array.isArray(cur)) {\n      const idx = Number(key)\n      if (!Number.isInteger(idx)) return undefined\n      cur = cur[idx]\n    } else if (typeof cur === 'object') {\n      cur = (cur as Record<string, unknown>)[key]\n    } else {\n      return undefined\n    }\n  }\n  return cur\n}\n"]}

package/dist/client/rpc/list-actions.d.ts

@@ -0,0 +1,27 @@
+import type { MessageAnnotations } from '../../protocol.js';
+type Binding = {
+    variant: string;
+};
+type Annotations = Record<string, MessageAnnotations>;
+export type ListActionsHost = {
+    getState(): unknown;
+    getBindingDescriptors(): Binding[] | null;
+    getMsgAnnotations(): Annotations | null;
+    getAgentAffordances(): ((state: unknown) => Array<{
+        type: string;
+        [k: string]: unknown;
+    }>) | null;
+};
+export type ListActionsResult = {
+    actions: Array<{
+        variant: string;
+        intent: string;
+        requiresConfirm: boolean;
+        source: 'binding' | 'always-affordable';
+        selectorHint: string | null;
+        payloadHint: object | null;
+    }>;
+};
+export declare function handleListActions(host: ListActionsHost): ListActionsResult;
+export {};
+//# sourceMappingURL=list-actions.d.ts.map

package/dist/client/rpc/list-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-actions.d.ts","sourceRoot":"","sources":["../../../src/client/rpc/list-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,KAAK,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAClC,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;AAErD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,IAAI,OAAO,CAAA;IACnB,qBAAqB,IAAI,OAAO,EAAE,GAAG,IAAI,CAAA;IACzC,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAAA;IACvC,mBAAmB,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC,GAAG,IAAI,CAAA;CAClG,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;QACd,eAAe,EAAE,OAAO,CAAA;QACxB,MAAM,EAAE,SAAS,GAAG,mBAAmB,CAAA;QACvC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3B,CAAC,CAAA;CACH,CAAA;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAsC1E"}

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

@@ -0,0 +1,38 @@
+export function handleListActions(host) {
+    const annotations = host.getMsgAnnotations() ?? {};
+    const state = host.getState();
+    const descriptors = host.getBindingDescriptors() ?? [];
+    const affordances = host.getAgentAffordances()?.(state) ?? [];
+    const out = [];
+    // From bindings
+    for (const d of descriptors) {
+        const ann = annotations[d.variant];
+        if (ann?.humanOnly)
+            continue;
+        out.push({
+            variant: d.variant,
+            intent: ann?.intent ?? d.variant,
+            requiresConfirm: ann?.requiresConfirm ?? false,
+            source: 'binding',
+            selectorHint: null,
+            payloadHint: null,
+        });
+    }
+    // From always-affordable
+    for (const msg of affordances) {
+        const ann = annotations[msg.type];
+        if (ann?.humanOnly)
+            continue;
+        const { type, ...rest } = msg;
+        out.push({
+            variant: type,
+            intent: ann?.intent ?? type,
+            requiresConfirm: ann?.requiresConfirm ?? false,
+            source: 'always-affordable',
+            selectorHint: null,
+            payloadHint: Object.keys(rest).length > 0 ? rest : null,
+        });
+    }
+    return { actions: out };
+}
+//# sourceMappingURL=list-actions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-actions.js","sourceRoot":"","sources":["../../../src/client/rpc/list-actions.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAA;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAA;IACtD,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IAE7D,MAAM,GAAG,GAAiC,EAAE,CAAA;IAE5C,gBAAgB;IAChB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAClC,IAAI,GAAG,EAAE,SAAS;YAAE,SAAQ;QAC5B,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC,CAAC,OAAO;YAChC,eAAe,EAAE,GAAG,EAAE,eAAe,IAAI,KAAK;YAC9C,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,yBAAyB;IACzB,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,GAAG,EAAE,SAAS;YAAE,SAAQ;QAC5B,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAA;QAC7B,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;YAC3B,eAAe,EAAE,GAAG,EAAE,eAAe,IAAI,KAAK;YAC9C,MAAM,EAAE,mBAAmB;YAC3B,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;SACxD,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAA;AACzB,CAAC","sourcesContent":["import type { MessageAnnotations } from '../../protocol.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  getAgentAffordances(): ((state: unknown) => Array<{ type: string; [k: string]: unknown }>) | null\n}\n\nexport type ListActionsResult = {\n  actions: Array<{\n    variant: string\n    intent: string\n    requiresConfirm: boolean\n    source: 'binding' | 'always-affordable'\n    selectorHint: string | null\n    payloadHint: object | null\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 affordances = host.getAgentAffordances()?.(state) ?? []\n\n  const out: ListActionsResult['actions'] = []\n\n  // From bindings\n  for (const d of descriptors) {\n    const ann = annotations[d.variant]\n    if (ann?.humanOnly) continue\n    out.push({\n      variant: d.variant,\n      intent: ann?.intent ?? d.variant,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      source: 'binding',\n      selectorHint: null,\n      payloadHint: null,\n    })\n  }\n\n  // From always-affordable\n  for (const msg of affordances) {\n    const ann = annotations[msg.type]\n    if (ann?.humanOnly) continue\n    const { type, ...rest } = msg\n    out.push({\n      variant: type,\n      intent: ann?.intent ?? type,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      source: 'always-affordable',\n      selectorHint: null,\n      payloadHint: Object.keys(rest).length > 0 ? rest : null,\n    })\n  }\n\n  return { actions: out }\n}\n"]}

package/dist/client/rpc/query-dom.d.ts

@@ -0,0 +1,20 @@
+export type QueryDomArgs = {
+    name: string;
+    multiple?: boolean;
+};
+export type QueryDomResult = {
+    elements: Array<{
+        text: string;
+        attrs: Record<string, string>;
+        path: number[];
+    }>;
+};
+export type QueryDomHost = {
+    getRootElement(): Element | null;
+};
+/**
+ * Spec §7.7 / §8.2: reads only elements explicitly tagged
+ * `data-agent="<name>"`. No full-DOM access in v1.
+ */
+export declare function handleQueryDom(host: QueryDomHost, args: QueryDomArgs): QueryDomResult;
+//# sourceMappingURL=query-dom.d.ts.map

package/dist/client/rpc/query-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dom.d.ts","sourceRoot":"","sources":["../../../src/client/rpc/query-dom.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAC/D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CACjF,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,IAAI,OAAO,GAAG,IAAI,CAAA;CACjC,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,cAAc,CAerF"}

package/dist/client/rpc/query-dom.js

@@ -0,0 +1,37 @@
+/**
+ * Spec §7.7 / §8.2: reads only elements explicitly tagged
+ * `data-agent="<name>"`. No full-DOM access in v1.
+ */
+export function handleQueryDom(host, args) {
+    const root = host.getRootElement();
+    if (!root)
+        return { elements: [] };
+    const selector = `[data-agent="${cssEscape(args.name)}"]`;
+    const nodes = args.multiple
+        ? Array.from(root.querySelectorAll(selector))
+        : [root.querySelector(selector)].filter(Boolean);
+    return {
+        elements: nodes.map((n) => ({
+            text: (n.textContent ?? '').trim(),
+            attrs: Object.fromEntries(Array.from(n.attributes).map((a) => [a.name, a.value])),
+            path: computePath(root, n),
+        })),
+    };
+}
+function cssEscape(s) {
+    // Simple escape for double-quotes; most data-agent names won't need it.
+    return s.replace(/"/g, '\\"');
+}
+function computePath(root, target) {
+    const out = [];
+    let cur = target;
+    while (cur !== null && cur !== root) {
+        const parent = cur.parentElement;
+        if (!parent)
+            break;
+        out.unshift(Array.from(parent.children).indexOf(cur));
+        cur = parent;
+    }
+    return out;
+}
+//# sourceMappingURL=query-dom.js.map

package/dist/client/rpc/query-dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dom.js","sourceRoot":"","sources":["../../../src/client/rpc/query-dom.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB,EAAE,IAAkB;IACnE,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAClC,MAAM,QAAQ,GAAG,gBAAgB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ;QACzB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC,CAAE,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAe,CAAA;IAEjE,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAClC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACjF,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;SAC3B,CAAC,CAAC;KACJ,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,wEAAwE;IACxE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AAC/B,CAAC;AAED,SAAS,WAAW,CAAC,IAAa,EAAE,MAAe;IACjD,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,IAAI,GAAG,GAAmB,MAAM,CAAA;IAChC,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,MAAM,GAAmB,GAAG,CAAC,aAAa,CAAA;QAChD,IAAI,CAAC,MAAM;YAAE,MAAK;QAClB,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;QACrD,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["export type QueryDomArgs = { name: string; multiple?: boolean }\nexport type QueryDomResult = {\n  elements: Array<{ text: string; attrs: Record<string, string>; path: number[] }>\n}\n\nexport type QueryDomHost = {\n  getRootElement(): Element | null\n}\n\n/**\n * Spec §7.7 / §8.2: reads only elements explicitly tagged\n * `data-agent=\"<name>\"`. No full-DOM access in v1.\n */\nexport function handleQueryDom(host: QueryDomHost, args: QueryDomArgs): QueryDomResult {\n  const root = host.getRootElement()\n  if (!root) return { elements: [] }\n  const selector = `[data-agent=\"${cssEscape(args.name)}\"]`\n  const nodes = args.multiple\n    ? Array.from(root.querySelectorAll(selector))\n    : ([root.querySelector(selector)].filter(Boolean) as Element[])\n\n  return {\n    elements: nodes.map((n) => ({\n      text: (n.textContent ?? '').trim(),\n      attrs: Object.fromEntries(Array.from(n.attributes).map((a) => [a.name, a.value])),\n      path: computePath(root, n),\n    })),\n  }\n}\n\nfunction cssEscape(s: string): string {\n  // Simple escape for double-quotes; most data-agent names won't need it.\n  return s.replace(/\"/g, '\\\\\"')\n}\n\nfunction computePath(root: Element, target: Element): number[] {\n  const out: number[] = []\n  let cur: Element | null = target\n  while (cur !== null && cur !== root) {\n    const parent: Element | null = cur.parentElement\n    if (!parent) break\n    out.unshift(Array.from(parent.children).indexOf(cur))\n    cur = parent\n  }\n  return out\n}\n"]}

package/dist/client/rpc/send-message.d.ts

@@ -0,0 +1,28 @@
+import type { LapMessageResponse, MessageAnnotations } from '../../protocol.js';
+export type SendMessageArgs = {
+    msg: {
+        type: string;
+        [k: string]: unknown;
+    };
+    reason?: string;
+    waitFor?: 'idle' | 'none';
+    timeoutMs?: number;
+};
+export type SendMessageHost = {
+    getState(): unknown;
+    send(msg: unknown): void;
+    flush(): void;
+    getMsgAnnotations(): Record<string, MessageAnnotations> | null;
+    /** Called when @requiresConfirm; caller stores a ConfirmEntry in state. */
+    proposeConfirm(entry: {
+        id: string;
+        variant: string;
+        payload: unknown;
+        intent: string;
+        reason: string | null;
+        proposedAt: number;
+        status: 'pending';
+    }): void;
+};
+export declare function handleSendMessage(host: SendMessageHost, args: SendMessageArgs): Promise<LapMessageResponse>;
+//# sourceMappingURL=send-message.d.ts.map

package/dist/client/rpc/send-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-message.d.ts","sourceRoot":"","sources":["../../../src/client/rpc/send-message.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE/E,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,IAAI,OAAO,CAAA;IACnB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,KAAK,IAAI,IAAI,CAAA;IACb,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAAA;IAC9D,2EAA2E;IAC3E,cAAc,CAAC,KAAK,EAAE;QACpB,EAAE,EAAE,MAAM,CAAA;QACV,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,OAAO,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;QACrB,UAAU,EAAE,MAAM,CAAA;QAClB,MAAM,EAAE,SAAS,CAAA;KAClB,GAAG,IAAI,CAAA;CACT,CAAA;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAwC7B"}

package/dist/client/rpc/send-message.js

@@ -0,0 +1,40 @@
+import { randomUUID } from '../uuid.js';
+export async function handleSendMessage(host, args) {
+    if (!args.msg || typeof args.msg.type !== 'string') {
+        return { status: 'rejected', reason: 'invalid' };
+    }
+    const annotations = host.getMsgAnnotations() ?? {};
+    const ann = annotations[args.msg.type];
+    // If annotations map is non-empty and this variant isn't in it, it's an
+    // unknown msg type that the app never declared — reject early so the
+    // browser never dispatches an unrecognised variant into update().
+    const hasAnnotations = Object.keys(annotations).length > 0;
+    if (hasAnnotations && !ann) {
+        return { status: 'rejected', reason: 'invalid', detail: `unknown variant: ${args.msg.type}` };
+    }
+    if (ann?.humanOnly) {
+        return { status: 'rejected', reason: 'humanOnly' };
+    }
+    if (ann?.requiresConfirm) {
+        const id = randomUUID();
+        const { type: _type, ...payload } = args.msg;
+        host.proposeConfirm({
+            id,
+            variant: args.msg.type,
+            payload,
+            intent: ann?.intent ?? args.msg.type,
+            reason: args.reason ?? null,
+            proposedAt: Date.now(),
+            status: 'pending',
+        });
+        return { status: 'pending-confirmation', confirmId: id };
+    }
+    host.send(args.msg);
+    if (args.waitFor !== 'none') {
+        host.flush();
+        // Let the microtask queue settle:
+        await Promise.resolve();
+    }
+    return { status: 'dispatched', stateAfter: host.getState() };
+}
+//# sourceMappingURL=send-message.js.map

package/dist/client/rpc/send-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-message.js","sourceRoot":"","sources":["../../../src/client/rpc/send-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AA2BvC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAqB,EACrB,IAAqB;IAErB,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;IAClD,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAA;IAClD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAEtC,wEAAwE;IACxE,qEAAqE;IACrE,kEAAkE;IAClE,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAC1D,IAAI,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAA;IAC/F,CAAC;IAED,IAAI,GAAG,EAAE,SAAS,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;IACpD,CAAC;IACD,IAAI,GAAG,EAAE,eAAe,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAA;QACvB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAA;QAC5C,IAAI,CAAC,cAAc,CAAC;YAClB,EAAE;YACF,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;YACtB,OAAO;YACP,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI;YACpC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;YAC3B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAA;QACF,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAC1D,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACnB,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAA;QACZ,kCAAkC;QAClC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;IACzB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAA;AAC9D,CAAC","sourcesContent":["import { randomUUID } from '../uuid.js'\nimport type { LapMessageResponse, MessageAnnotations } from '../../protocol.js'\n\nexport type SendMessageArgs = {\n  msg: { type: string; [k: string]: unknown }\n  reason?: string\n  waitFor?: 'idle' | 'none'\n  timeoutMs?: number\n}\n\nexport type SendMessageHost = {\n  getState(): unknown\n  send(msg: unknown): void\n  flush(): void\n  getMsgAnnotations(): Record<string, MessageAnnotations> | null\n  /** Called when @requiresConfirm; caller stores a ConfirmEntry in state. */\n  proposeConfirm(entry: {\n    id: string\n    variant: string\n    payload: unknown\n    intent: string\n    reason: string | null\n    proposedAt: number\n    status: 'pending'\n  }): void\n}\n\nexport async function handleSendMessage(\n  host: SendMessageHost,\n  args: SendMessageArgs,\n): Promise<LapMessageResponse> {\n  if (!args.msg || typeof args.msg.type !== 'string') {\n    return { status: 'rejected', reason: 'invalid' }\n  }\n  const annotations = host.getMsgAnnotations() ?? {}\n  const ann = annotations[args.msg.type]\n\n  // If annotations map is non-empty and this variant isn't in it, it's an\n  // unknown msg type that the app never declared — reject early so the\n  // browser never dispatches an unrecognised variant into update().\n  const hasAnnotations = Object.keys(annotations).length > 0\n  if (hasAnnotations && !ann) {\n    return { status: 'rejected', reason: 'invalid', detail: `unknown variant: ${args.msg.type}` }\n  }\n\n  if (ann?.humanOnly) {\n    return { status: 'rejected', reason: 'humanOnly' }\n  }\n  if (ann?.requiresConfirm) {\n    const id = randomUUID()\n    const { type: _type, ...payload } = args.msg\n    host.proposeConfirm({\n      id,\n      variant: args.msg.type,\n      payload,\n      intent: ann?.intent ?? args.msg.type,\n      reason: args.reason ?? null,\n      proposedAt: Date.now(),\n      status: 'pending',\n    })\n    return { status: 'pending-confirmation', confirmId: id }\n  }\n\n  host.send(args.msg)\n  if (args.waitFor !== 'none') {\n    host.flush()\n    // Let the microtask queue settle:\n    await Promise.resolve()\n  }\n  return { status: 'dispatched', stateAfter: host.getState() }\n}\n"]}

package/dist/client/uuid.d.ts

@@ -0,0 +1,2 @@
+export declare function randomUUID(): string;
+//# sourceMappingURL=uuid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/client/uuid.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,IAAI,MAAM,CAmBnC"}

package/dist/client/uuid.js

@@ -0,0 +1,24 @@
+export function randomUUID() {
+    if (typeof crypto !== 'undefined' && 'randomUUID' in crypto) {
+        return crypto.randomUUID();
+    }
+    // Simple v4 fallback for environments without crypto.randomUUID
+    const chars = '0123456789abcdef';
+    let s = '';
+    for (let i = 0; i < 36; i++) {
+        if (i === 8 || i === 13 || i === 18 || i === 23) {
+            s += '-';
+        }
+        else if (i === 14) {
+            s += '4';
+        }
+        else if (i === 19) {
+            s += chars[((Math.random() * 4) | 0) + 8];
+        }
+        else {
+            s += chars[(Math.random() * 16) | 0];
+        }
+    }
+    return s;
+}
+//# sourceMappingURL=uuid.js.map

package/dist/client/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/client/uuid.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU;IACxB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,YAAY,IAAI,MAAM,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,UAAU,EAAE,CAAA;IAC5B,CAAC;IACD,gEAAgE;IAChE,MAAM,KAAK,GAAG,kBAAkB,CAAA;IAChC,IAAI,CAAC,GAAG,EAAE,CAAA;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YAChD,CAAC,IAAI,GAAG,CAAA;QACV,CAAC;aAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACpB,CAAC,IAAI,GAAG,CAAA;QACV,CAAC;aAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACpB,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAC3C,CAAC;aAAM,CAAC;YACN,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC","sourcesContent":["export function randomUUID(): string {\n  if (typeof crypto !== 'undefined' && 'randomUUID' in crypto) {\n    return crypto.randomUUID()\n  }\n  // Simple v4 fallback for environments without crypto.randomUUID\n  const chars = '0123456789abcdef'\n  let s = ''\n  for (let i = 0; i < 36; i++) {\n    if (i === 8 || i === 13 || i === 18 || i === 23) {\n      s += '-'\n    } else if (i === 14) {\n      s += '4'\n    } else if (i === 19) {\n      s += chars[((Math.random() * 4) | 0) + 8]\n    } else {\n      s += chars[(Math.random() * 16) | 0]\n    }\n  }\n  return s\n}\n"]}

package/dist/client/ws-client.d.ts

@@ -0,0 +1,44 @@
+import type { HelloFrame, LogEntry } from '../protocol.js';
+import { type GetStateHost } from './rpc/get-state.js';
+import { type SendMessageHost } from './rpc/send-message.js';
+import { type ListActionsHost } from './rpc/list-actions.js';
+import { type QueryDomHost } from './rpc/query-dom.js';
+import { type DescribeVisibleHost } from './rpc/describe-visible-content.js';
+import { type DescribeContextHost } from './rpc/describe-context.js';
+export interface WsLike {
+    send(data: string): void;
+    close(): void;
+    addEventListener(event: 'message', h: (e: {
+        data: string | ArrayBuffer;
+    }) => void): void;
+    addEventListener(event: 'open' | 'close', h: () => void): void;
+}
+export type RpcHosts = GetStateHost & SendMessageHost & ListActionsHost & QueryDomHost & DescribeVisibleHost & DescribeContextHost;
+export type HelloBuilder = () => HelloFrame;
+export type WsClient = {
+    /** Resolve a pending confirmation; emits confirm-resolved frame to the server. */
+    resolveConfirm(confirmId: string, outcome: 'confirmed' | 'user-cancelled', stateAfter?: unknown): void;
+    /** Emit a state-update frame so the server can resolve waitForChange promises. */
+    emitStateUpdate(path: string, stateAfter: unknown): void;
+    /** Emit a log-append frame so the server can mirror client-observed actions to the audit sink. */
+    emitLogAppend(entry: LogEntry): void;
+    /** Close the socket cleanly. */
+    close(): void;
+};
+export type WsClientOpts = {
+    /** Called once when the server sends an `{t: 'active'}` frame. Idempotent. */
+    onActivated?: () => void;
+    /**
+     * Called with every LogEntry emitted by the ws-client (one per rpc
+     * dispatched or errored). Used by the factory to mirror the entries
+     * into the app's local `agent.log` slice so the UI can show activity.
+     * The ws-client still sends the outbound `log-append` frame to the
+     * server regardless.
+     */
+    onLogEntry?: (entry: LogEntry) => void;
+};
+/**
+ * Wires up a WebSocket to serve rpc requests from the server. See spec §9.4.
+ */
+export declare function attachWsClient(ws: WsLike, rpc: RpcHosts, hello: HelloBuilder, opts?: WsClientOpts): WsClient;
+//# sourceMappingURL=ws-client.d.ts.map

package/dist/client/ws-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.d.ts","sourceRoot":"","sources":["../../src/client/ws-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,UAAU,EACV,QAAQ,EAGT,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC/E,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC/E,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAE3F,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,IAAI,IAAI,CAAA;IACb,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IACxF,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;CAC/D;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GACjC,eAAe,GACf,eAAe,GACf,YAAY,GACZ,mBAAmB,GACnB,mBAAmB,CAAA;AAErB,MAAM,MAAM,YAAY,GAAG,MAAM,UAAU,CAAA;AAE3C,MAAM,MAAM,QAAQ,GAAG;IACrB,kFAAkF;IAClF,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GAAG,gBAAgB,EACvC,UAAU,CAAC,EAAE,OAAO,GACnB,IAAI,CAAA;IACP,kFAAkF;IAClF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAA;IACxD,kGAAkG;IAClG,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAA;IACpC,gCAAgC;IAChC,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;CACvC,CAAA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,YAAY,EACnB,IAAI,GAAE,YAAiB,GACtB,QAAQ,CAsFV"}

package/dist/client/ws-client.js

@@ -0,0 +1,176 @@
+import { handleGetState } from './rpc/get-state.js';
+import { handleSendMessage } from './rpc/send-message.js';
+import { handleListActions } from './rpc/list-actions.js';
+import { handleQueryDom } from './rpc/query-dom.js';
+import { handleDescribeVisibleContent, } from './rpc/describe-visible-content.js';
+import { handleDescribeContext } from './rpc/describe-context.js';
+/**
+ * Wires up a WebSocket to serve rpc requests from the server. See spec §9.4.
+ */
+export function attachWsClient(ws, rpc, hello, opts = {}) {
+    let activated = false;
+    ws.addEventListener('open', () => {
+        ws.send(JSON.stringify(hello()));
+    });
+    ws.addEventListener('message', async (ev) => {
+        let frame;
+        try {
+            const raw = typeof ev.data === 'string' ? ev.data : new TextDecoder().decode(ev.data);
+            frame = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (frame.t === 'revoked') {
+            ws.close();
+            return;
+        }
+        if (frame.t === 'active') {
+            if (!activated) {
+                activated = true;
+                opts.onActivated?.();
+            }
+            return;
+        }
+        if (frame.t !== 'rpc')
+            return;
+        let result;
+        let rpcErr = null;
+        try {
+            result = await dispatch(frame.tool, frame.args, rpc);
+            const reply = { t: 'rpc-reply', id: frame.id, result };
+            ws.send(JSON.stringify(reply));
+        }
+        catch (e) {
+            rpcErr = e;
+            // When a plain JS exception bubbles up (TypeError, RangeError, etc.),
+            // rpcErr has no .code/.detail. Enrich the detail with the actual
+            // message + stack so the server/Claude can see the real cause.
+            const detail = rpcErr.detail ??
+                (e instanceof Error
+                    ? `${e.name}: ${e.message}${e.stack ? '\n' + e.stack.split('\n').slice(0, 5).join('\n') : ''}`
+                    : undefined);
+            const errFrame = {
+                t: 'rpc-error',
+                id: frame.id,
+                code: rpcErr.code ?? 'internal',
+                detail,
+            };
+            ws.send(JSON.stringify(errFrame));
+            // Also log to the browser console so operators see the real cause even
+            // when the server/Claude just show "internal".
+            console.error(`[llui-agent] rpc handler threw for ${frame.tool}:`, e);
+        }
+        const kind = getLogKindForTool(frame.tool, result, rpcErr);
+        const logEntry = {
+            id: frame.id,
+            at: Date.now(),
+            kind,
+            variant: extractVariant(frame.tool, frame.args),
+            intent: buildIntent(frame.tool, frame.args, rpc.getMsgAnnotations()),
+        };
+        opts.onLogEntry?.(logEntry);
+        ws.send(JSON.stringify({ t: 'log-append', entry: logEntry }));
+    });
+    return {
+        resolveConfirm(confirmId, outcome, stateAfter) {
+            const frame = {
+                t: 'confirm-resolved',
+                confirmId,
+                outcome,
+                stateAfter,
+            };
+            ws.send(JSON.stringify(frame));
+        },
+        emitStateUpdate(path, stateAfter) {
+            const frame = { t: 'state-update', path, stateAfter };
+            ws.send(JSON.stringify(frame));
+        },
+        emitLogAppend(entry) {
+            const frame = { t: 'log-append', entry };
+            ws.send(JSON.stringify(frame));
+        },
+        close() {
+            ws.close();
+        },
+    };
+}
+async function dispatch(tool, args, rpc) {
+    switch (tool) {
+        case 'get_state':
+            return handleGetState(rpc, (args ?? {}));
+        case 'list_actions':
+            return handleListActions(rpc);
+        case 'send_message':
+            return handleSendMessage(rpc, args);
+        case 'query_dom':
+            return handleQueryDom(rpc, args);
+        case 'describe_visible_content':
+            return handleDescribeVisibleContent(rpc);
+        case 'describe_context':
+            return handleDescribeContext(rpc);
+        default:
+            throw { code: 'invalid', detail: `unknown tool: ${tool}` };
+    }
+}
+const READ_TOOLS = new Set([
+    'get_state',
+    'list_actions',
+    'describe_context',
+    'query_dom',
+    'describe_visible_content',
+]);
+function getLogKindForTool(tool, result, err) {
+    if (err !== null)
+        return 'error';
+    if (tool === 'send_message') {
+        const r = result;
+        const status = r?.status;
+        if (status === 'dispatched' || status === 'confirmed')
+            return 'dispatched';
+        if (status === 'pending-confirmation')
+            return 'proposed';
+        if (status === 'rejected')
+            return 'blocked';
+        return 'dispatched';
+    }
+    if (READ_TOOLS.has(tool))
+        return 'read';
+    return 'read';
+}
+function extractVariant(tool, args) {
+    if (tool === 'send_message') {
+        const a = args;
+        const t = a?.msg?.type;
+        return typeof t === 'string' ? t : undefined;
+    }
+    return undefined;
+}
+// Human-readable label for each rpc. For send_message, prefer the @intent
+// annotation authored on the Msg union; fall back to the raw variant name.
+// For read tools, return a short fixed label so the activity feed doesn't
+// show opaque tool ids like "describe_visible_content".
+function buildIntent(tool, args, annotations) {
+    if (tool === 'send_message') {
+        const a = args;
+        const variant = typeof a?.msg?.type === 'string' ? a.msg.type : undefined;
+        const annotated = variant ? annotations?.[variant]?.intent : null;
+        if (annotated)
+            return annotated;
+        return variant ?? 'Send message';
+    }
+    if (tool === 'get_state')
+        return 'Read app state';
+    if (tool === 'list_actions')
+        return 'List available actions';
+    if (tool === 'describe_context')
+        return 'Read current context';
+    if (tool === 'describe_visible_content')
+        return 'Read visible content';
+    if (tool === 'query_dom') {
+        const a = args;
+        return a?.name ? `Query DOM: ${a.name}` : 'Query DOM';
+    }
+    return tool;
+}
+//# sourceMappingURL=ws-client.js.map