nexus-agentd 0.2.6 → 0.3.1

package/dist/webui/icons.d.ts

@@ -1,6 +1,7 @@
 export declare const icons: {
     overview: string;
     runs: string;
+    artifacts: string;
     agents: string;
     workspaces: string;
     keys: string;

package/dist/webui/icons.js

@@ -2,6 +2,7 @@ const base = (paths) => `<svg viewBox="0 0 24 24" aria-hidden="true" focusable="
 export const icons = {
     overview: base('<rect x="3" y="3" width="7" height="9" rx="1.5"/><rect x="14" y="3" width="7" height="5" rx="1.5"/><rect x="14" y="12" width="7" height="9" rx="1.5"/><rect x="3" y="16" width="7" height="5" rx="1.5"/>'),
     runs: base('<path d="M22 12h-2.5a2 2 0 0 0-1.93 1.46l-2.1 7.4a.25.25 0 0 1-.48 0L9.24 3.14a.25.25 0 0 0-.48 0l-2.1 7.4A2 2 0 0 1 4.73 12H2"/>'),
+    artifacts: base('<path d="M21 8v8a2 2 0 0 1-1 1.73l-7 4a2 2 0 0 1-2 0l-7-4A2 2 0 0 1 3 16V8a2 2 0 0 1 1-1.73l7-4a2 2 0 0 1 2 0l7 4A2 2 0 0 1 21 8Z"/><path d="m3.3 7 8.7 5 8.7-5"/><path d="M12 22V12"/>'),
     agents: base('<path d="M12 8V4.5"/><circle cx="12" cy="3" r="1.1"/><rect x="4" y="8" width="16" height="12" rx="3"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M9.5 13v1.6"/><path d="M14.5 13v1.6"/><path d="M9.5 17.2h5"/>'),
     workspaces: base('<path d="M20 20a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-7.1a2 2 0 0 1-1.66-.89l-.75-1.12A2 2 0 0 0 8.83 4H4a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2Z"/>'),
     keys: base('<circle cx="8" cy="15" r="4.2"/><path d="m11.1 12 8-8"/><path d="m15.4 7.7 2.9 2.9"/><path d="m17.6 5.5 2.9 2.9"/>'),

package/dist/webui/markup.js

@@ -5,6 +5,7 @@ export const markup = String.raw `
   <form id="setup-form" class="auth-card">
     <header><span class="brand-mark">N</span><h1>初始化 Agent Nexus</h1></header>
     <p>此密码仅用于登录控制台；客户端 API 密钥在登录后单独创建。</p>
+    <div class="field"><label for="setup-token">初始化令牌</label><input id="setup-token" name="setupToken" type="password" autocomplete="off" required><small class="field-help">从网关启动终端复制 Setup token。重启后令牌会更新；远程初始化请使用可信网络或 HTTPS。</small></div>
     <div class="field"><label for="setup-password">控制台密码</label><input id="setup-password" name="password" type="password" minlength="12" autocomplete="new-password" required></div>
     <div class="field"><label for="setup-confirm">确认密码</label><input id="setup-confirm" name="confirmPassword" type="password" minlength="12" autocomplete="new-password" required></div>
     <button class="button primary auth-submit" type="submit">完成初始化</button>
@@ -29,6 +30,7 @@ export const markup = String.raw `
         <p class="nav-group-label" id="nav-group-run">运行</p>
         <button class="nav-item active" data-page="overview">${icons.overview}<span>总览</span></button>
         <button class="nav-item" data-page="runs">${icons.runs}<span>运行记录</span></button>
+        <button class="nav-item" data-page="artifacts">${icons.artifacts}<span>产物</span></button>
       </div>
       <div class="nav-group" role="group" aria-labelledby="nav-group-config">
         <p class="nav-group-label" id="nav-group-config">网关配置</p>
@@ -48,6 +50,7 @@ export const markup = String.raw `
       <div id="page-actions" class="page-actions"></div>
     </header>
     <section id="page-content" class="page-content">
+      <p id="connection-status" class="connection-status hidden" role="status"></p>
       <div id="page-stats"></div>
       <div id="page-toolbar"></div>
       <div id="page-results"></div>

package/dist/webui/styles.js

@@ -39,11 +39,11 @@ export const styles = String.raw `
   --sp-1: 4px; --sp-2: 8px; --sp-3: 12px; --sp-4: 16px;
   --sp-5: 20px; --sp-6: 24px; --sp-8: 32px;
 
-  /* 字号阶梯，全站只用这六级：
+  /* 字号阶梯，全站只用这六级（面向中文正文做了整体上调）：
      2xs 大写微标签（表头 / badge）· xs 辅助说明 · sm 正文与表格
      md 面板与 drawer 标题 · lg 页面标题 · stat 统计数字 */
-  --fs-2xs: 11px; --fs-xs: 12px; --fs-sm: 13px;
-  --fs-md: 14px; --fs-lg: 16px; --fs-stat: 28px;
+  --fs-2xs: 12px; --fs-xs: 13px;
+  --fs-sm: 14px; --fs-md: 15px; --fs-lg: 17px; --fs-stat: 28px;
 
   --radius: 6px;
   --radius-lg: calc(var(--radius) + 2px);
@@ -117,7 +117,7 @@ body {
   margin: 0;
   background: hsl(var(--background));
   color: hsl(var(--foreground));
-  font: var(--fs-sm)/1.5 -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans",
+  font: var(--fs-sm)/1.6 -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans",
         "PingFang SC", "Microsoft YaHei", Helvetica, Arial, sans-serif;
   -webkit-font-smoothing: antialiased;
   text-rendering: optimizeLegibility;
@@ -126,7 +126,7 @@ h1, h2, h3, p { margin: 0; }
 button, input, select, textarea { font: inherit; color: inherit; }
 button { background: none; border: 0; cursor: pointer; padding: 0; }
 code, .mono { font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; }
-.hidden { display: none !important; }
+.hidden, [hidden] { display: none !important; }
 .muted { color: hsl(var(--muted-foreground)); font-size: var(--fs-xs); }
 
 :focus-visible {
@@ -220,6 +220,7 @@ input[type="checkbox"] { width: 14px; height: 14px; padding: 0; accent-color: hs
 .button.solid-danger:hover:not(:disabled) { background: hsl(var(--destructive) / .9); color: hsl(var(--destructive-foreground)); }
 .button.small { height: 26px; padding: 0 var(--sp-2); font-size: var(--fs-xs); }
 .button svg { width: 14px; height: 14px; fill: none; stroke: currentColor; stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; flex-shrink: 0; }
+a.button { color: hsl(var(--foreground)); text-decoration: none; }
 
 .icon-button {
   display: inline-flex; align-items: center; justify-content: center;
@@ -327,7 +328,7 @@ button[aria-busy="true"]::after { content: '…'; margin-left: var(--sp-1); }
 .empty-state .button { margin-top: var(--sp-3); }
 
 /* Stats */
-.stats { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: var(--sp-4); }
+.stats { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: var(--sp-4); }
 .stat {
   padding: var(--sp-4) var(--sp-5);
   background: hsl(var(--card));
@@ -337,6 +338,8 @@ button[aria-busy="true"]::after { content: '…'; margin-left: var(--sp-1); }
 }
 .stat span { color: hsl(var(--muted-foreground)); font-size: var(--fs-xs); font-weight: 500; }
 .stat strong { font-size: var(--fs-stat); font-weight: 600; letter-spacing: -.02em; line-height: 1.2; font-variant-numeric: tabular-nums; }
+a.stat { color: inherit; text-decoration: none; }
+a.stat:hover { border-color: hsl(var(--muted-foreground) / .4); box-shadow: var(--shadow-sm); }
 
 /* ── Toolbar ──────────────────────────────────────────────────────── */
 .toolbar { display: flex; align-items: center; gap: var(--sp-2); flex-wrap: wrap; }
@@ -359,12 +362,14 @@ tbody tr:last-child td { border-bottom: 0; }
 tbody tr:hover { background: hsl(var(--muted) / .5); }
 tr[data-run-detail] { cursor: pointer; }
 
-.agent-name { display: grid; gap: 2px; min-width: 0; }
+.agent-name { display: grid; gap: var(--sp-1); min-width: 0; }
 .agent-name strong { font-size: var(--fs-sm); font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .agent-name small { color: hsl(var(--muted-foreground)); font-size: var(--fs-xs); font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
 .error-detail { color: hsl(var(--destructive-text)); font-size: var(--fs-sm); overflow-wrap: anywhere; line-height: 1.4; }
 .row-actions { display: flex; justify-content: flex-end; gap: var(--sp-2); }
 .agent-table { min-width: 1050px; table-layout: fixed; }
+.connection-status { padding: var(--sp-3) var(--sp-4); border: 1px solid currentColor; border-radius: var(--radius-lg); color: hsl(var(--destructive-text)); margin-bottom: var(--sp-4); overflow-wrap: anywhere; }
+.run-pagination { display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 12px; margin-bottom: 16px; }
 .agent-table th:nth-child(1) { width: 22%; }
 .agent-table th:nth-child(2) { width: 8%; }
 .agent-table th:nth-child(3), .agent-table th:nth-child(4), .agent-table th:nth-child(6) { width: 10%; }
@@ -375,7 +380,7 @@ tr[data-run-detail] { cursor: pointer; }
 /* ── Badges & status ──────────────────────────────────────────────── */
 .badge {
   display: inline-flex; align-items: center;
-  height: 20px; padding: 0 var(--sp-2);
+  height: 22px; padding: 0 var(--sp-2);
   border: 1px solid hsl(var(--border));
   border-radius: 4px;
   background: hsl(var(--secondary));
@@ -384,7 +389,7 @@ tr[data-run-detail] { cursor: pointer; }
 }
 .status {
   display: inline-flex; align-items: center; gap: var(--sp-2);
-  height: 22px; padding: 0 var(--sp-2);
+  height: 24px; padding: 0 var(--sp-2);
   border-radius: 9999px;
   background: hsl(var(--secondary));
   color: hsl(var(--muted-foreground));
@@ -431,11 +436,11 @@ tr[data-run-detail] { cursor: pointer; }
   display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical;
   overflow: hidden;
   color: hsl(var(--foreground));
-  font-size: var(--fs-sm); line-height: 1.5;
+  font-size: var(--fs-sm); line-height: 1.6;
   white-space: pre-wrap;
   overflow-wrap: anywhere;
 }
-.run-progress { display: grid; gap: 2px; }
+.run-progress { display: grid; gap: var(--sp-1); }
 .run-progress strong { font-size: var(--fs-xs); font-weight: 600; }
 .run-progress small { color: hsl(var(--muted-foreground)); font-size: var(--fs-xs); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .run-meta {
@@ -456,6 +461,13 @@ tr[data-run-detail] { cursor: pointer; }
 .run-task-cell small { display: block; margin-top: 2px; color: hsl(var(--muted-foreground)); font-size: var(--fs-2xs); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 
 /* Run detail (drawer) */
+.run-detail-actions { display: flex; flex-wrap: wrap; gap: var(--sp-2); margin-bottom: var(--sp-3); }
+.run-output-heading { display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: var(--sp-2); margin-bottom: var(--sp-2); }
+.run-output-heading h3 { margin: 0; }
+.run-pending { padding: var(--sp-3); margin-bottom: var(--sp-4); border: 1px solid hsl(var(--border)); border-radius: var(--radius); }
+.run-pending-prompt { white-space: pre-wrap; overflow-wrap: anywhere; }
+.run-pending h3 { font-size: var(--fs-md); }
+.run-pending .row-actions { flex-wrap: wrap; }
 .run-detail-grid {
   display: grid; grid-template-columns: 1fr 1fr; gap: 1px;
   margin-bottom: var(--sp-4);
@@ -464,6 +476,11 @@ tr[data-run-detail] { cursor: pointer; }
   overflow: hidden;
   background: hsl(var(--border));
 }
+/* 紧凑指标网格（总览系统状态等）：复用 run-detail-item 的视觉，密度更高 */
+.run-detail-grid.compact { grid-template-columns: repeat(4, minmax(0, 1fr)); margin-bottom: 0; }
+.run-detail-grid.compact .run-detail-item { padding: var(--sp-2) var(--sp-3); }
+/* 嵌在 panel 里时通到边框，避免双层描边 */
+.panel > .run-detail-grid.compact { border: 0; border-radius: 0; }
 .run-detail-item { padding: var(--sp-3); background: hsl(var(--card)); display: grid; gap: var(--sp-1); align-content: start; }
 .run-detail-item span { color: hsl(var(--muted-foreground)); font-size: var(--fs-2xs); font-weight: 600; letter-spacing: .05em; text-transform: uppercase; }
 .run-detail-item strong { font-size: var(--fs-sm); font-weight: 500; overflow-wrap: anywhere; }
@@ -493,12 +510,19 @@ tr[data-run-detail] { cursor: pointer; }
   transition: border-color var(--duration-fast) var(--ease-standard);
 }
 .list-row:hover { border-color: hsl(var(--muted-foreground) / .4); }
-.list-row-main { display: grid; gap: 2px; min-width: 0; }
+.list-row-main { display: grid; gap: var(--sp-1); min-width: 0; }
 .list-row-main > * { min-width: 0; }
 .list-row-main strong, .path { font-size: var(--fs-sm); font-weight: 600; overflow-wrap: anywhere; }
 .list-row-main small { color: hsl(var(--muted-foreground)); font-size: var(--fs-xs); overflow-wrap: anywhere; }
-.panel-body > .workspace-list, .panel-body > .overview-list { gap: var(--sp-2); }
-.panel-body .list-row { border-radius: var(--radius); }
+/* panel 里嵌套的列表去掉卡片套卡片：压平成分隔线行 */
+.panel-body .overview-list, .panel-body .workspace-list { gap: 0; }
+.panel-body .list-row {
+  border: 0; border-radius: 0; background: transparent;
+  border-bottom: 1px solid hsl(var(--border));
+  padding: var(--sp-3) 0;
+  min-height: 0;
+}
+.panel-body .list-row:last-child { border-bottom: 0; }
 
 /* ── API keys ─────────────────────────────────────────────────────── */
 .key-table { min-width: 760px; width: 100%; table-layout: fixed; }
@@ -580,6 +604,35 @@ tr[data-run-detail] { cursor: pointer; }
   font-size: var(--fs-xs);
 }
 
+/* ── Artifacts page ───────────────────────────────────────────────── */
+.artifact-table { min-width: 760px; table-layout: fixed; }
+.artifact-table th:nth-child(1) { width: 64px; }
+.artifact-table th:nth-child(3) { width: 18%; }
+.artifact-table th:nth-child(4), .artifact-table th:nth-child(5) { width: 120px; }
+.artifact-table th:nth-child(6) { width: 180px; }
+.artifact-table td { height: 56px; }
+.artifact-thumb-button {
+  display: block; width: 44px; height: 44px;
+  padding: 0; border-radius: var(--radius);
+  overflow: hidden;
+}
+.artifact-thumb { display: block; width: 44px; height: 44px; object-fit: cover; border: 1px solid hsl(var(--border)); border-radius: var(--radius); background: hsl(var(--muted) / .4); }
+/* 非图片产物的类型图标瓦片 */
+.artifact-tile {
+  display: grid; place-items: center;
+  width: 44px; height: 44px;
+  border: 1px solid hsl(var(--border));
+  border-radius: var(--radius);
+  background: hsl(var(--muted) / .4);
+  color: hsl(var(--muted-foreground));
+  transition: background-color var(--duration-fast) var(--ease-standard), color var(--duration-fast) var(--ease-standard);
+}
+.artifact-tile:hover { background: hsl(var(--accent)); color: hsl(var(--accent-foreground)); }
+.artifact-tile svg { width: 20px; height: 20px; fill: none; stroke: currentColor; stroke-width: 1.8; stroke-linecap: round; stroke-linejoin: round; }
+.artifact-preview-wrap { display: grid; justify-items: center; gap: var(--sp-2); margin-bottom: var(--sp-4); }
+.artifact-preview { max-width: 100%; max-height: 320px; border: 1px solid hsl(var(--border)); border-radius: var(--radius); background: hsl(var(--muted) / .4); }
+.artifact-preview-wrap audio { width: 100%; }
+
 /* ── Drawer ───────────────────────────────────────────────────────── */
 .drawer-backdrop { position: fixed; inset: 0; background: rgb(0 0 0 / .4); z-index: var(--z-backdrop); animation: fadeIn var(--duration-fade) var(--ease-out); }
 .drawer {
@@ -723,7 +776,8 @@ tr[data-run-detail] { cursor: pointer; }
   .settings-section-heading { margin-bottom: 24px; }
   .settings-account-row { grid-template-columns: 1fr; gap: var(--sp-4); }
   .search-box { max-width: none; }
-  .stats { grid-template-columns: 1fr; }
+  .stats { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+  .run-detail-grid.compact { grid-template-columns: repeat(2, minmax(0, 1fr)); }
   .run-summary { grid-template-columns: repeat(2, 1fr); }
   .run-live-grid { grid-template-columns: minmax(0, 1fr); }
   .toolbar input[type="search"], .toolbar select { max-width: none; width: 100%; }
@@ -734,6 +788,42 @@ tr[data-run-detail] { cursor: pointer; }
   .toast-region { right: var(--sp-4); bottom: var(--sp-4); left: var(--sp-4); max-width: none; }
 }
 
+/* Keep row actions and task context in the viewport on laptops and phones. */
+@media (max-width: 1400px) {
+  .agent-table, .run-table { min-width: 0; }
+  .agent-table thead, .run-table thead {
+    position: absolute; width: 1px; height: 1px; padding: 0;
+    overflow: hidden; clip-path: inset(50%); white-space: nowrap;
+  }
+  .agent-table tbody, .run-table tbody { display: grid; }
+  .agent-table tbody tr, .run-table tbody tr {
+    display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+    gap: var(--sp-3) var(--sp-6); padding: var(--sp-4); border-bottom: 1px solid hsl(var(--border));
+  }
+  .agent-table td, .run-table td {
+    min-width: 0; max-width: none !important; padding: 0; height: auto;
+    border: 0; white-space: normal !important; overflow-wrap: anywhere; text-align: left !important;
+  }
+  .agent-table td::before, .run-table td::before { display: block; font-size: var(--fs-xs); color: hsl(var(--muted-foreground)); margin-bottom: var(--sp-1); }
+  .agent-table td:nth-child(2)::before { content: '协议'; }
+  .agent-table td:nth-child(3)::before { content: '驱动'; }
+  .agent-table td:nth-child(4)::before { content: '探测状态'; }
+  .agent-table td:nth-child(5)::before { content: '默认工作区'; }
+  .agent-table td:nth-child(6)::before { content: '权限策略'; }
+  .run-table td:nth-child(2)::before { content: '任务'; }
+  .run-table td:nth-child(3)::before { content: '结果'; }
+  .run-table td:nth-child(4)::before { content: '状态'; }
+  .run-table td:nth-child(5)::before { content: '开始时间'; }
+  .run-table td:nth-child(6)::before { content: '耗时'; }
+  .agent-table td:last-child, .run-table td:last-child, td[colspan] { grid-column: 1 / -1; }
+  .agent-table .row-actions { justify-content: flex-start; }
+  .agent-table .button.small, .run-table .button.small { min-height: 36px; }
+}
+@media (max-width: 560px) {
+  .agent-table tbody tr, .run-table tbody tr { grid-template-columns: minmax(0, 1fr); }
+  .run-pagination { align-items: flex-start; }
+}
+
 /* ── Reduced motion ───────────────────────────────────────────────── */
 /* 统一压制而不是逐个列举消费者，这样以后新增的 transition 不会漏掉。
    running/waiting 的 pulse 停下后，色点和文字标签仍然表达状态。 */

package/examples/client.mjs

@@ -0,0 +1,102 @@
+import { setTimeout as delay } from 'node:timers/promises'
+
+/** Minimal Node 20+ client. Keep API Keys out of URLs and browser storage. */
+export function createGatewayClient(baseUrl, apiKey) {
+    const base = new URL(baseUrl)
+    const headers = { Authorization: `Bearer ${apiKey}` }
+    const route = (sessionId) => `/v1/sessions/${encodeURIComponent(sessionId)}`
+    async function request(path, method = 'GET', body, signal) {
+        const response = await fetch(new URL(path, base), {
+            method, headers: { ...headers, ...(body === undefined ? {} : { 'Content-Type': 'application/json' }) },
+            body: body === undefined ? undefined : JSON.stringify(body),
+            signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(30_000)]) : AbortSignal.timeout(30_000),
+            redirect: 'error'
+        })
+        if (!response.ok) {
+            const error = new Error(`Gateway request failed (${response.status})`)
+            error.status = response.status
+            await response.body?.cancel()
+            throw error
+        }
+        return response.json()
+    }
+    return {
+        createSession: (agentId, workspace) => request('/v1/sessions', 'POST', { agentId, workspace }),
+        snapshot: (id) => request(route(id)),
+        message: (id, message) => request(`${route(id)}/message`, 'POST', { message }),
+        resolve: (id, requestId, answer) => request(`${route(id)}/requests/${encodeURIComponent(requestId)}/resolve`, 'POST', answer),
+        cancel: (id) => request(`${route(id)}/cancel`, 'POST', {}),
+        close: (id) => request(route(id), 'DELETE'),
+        /** A reset yields a replacement snapshot; old discarded events are not replayed. */
+        async *events(id, { after, signal = new AbortController().signal } = {}) {
+            let cursor = after
+            let retries = 0
+            while (!signal.aborted) {
+                const connection = new AbortController()
+                const combined = AbortSignal.any([signal, connection.signal])
+                let timer = setTimeout(() => connection.abort(new Error('SSE connection timeout')), 15_000)
+                let reader
+                let reset = false
+                try {
+                    const response = await fetch(new URL(`${route(id)}/events`, base), {
+                        headers: { ...headers, ...(cursor === undefined ? {} : { 'Last-Event-ID': cursor }) },
+                        signal: combined, redirect: 'error'
+                    })
+                    clearTimeout(timer)
+                    if (!response.ok) {
+                        const error = new Error(`SSE request failed (${response.status})`)
+                        error.status = response.status
+                        await response.body?.cancel()
+                        throw error
+                    }
+                    reader = response.body.getReader()
+                    const decoder = new TextDecoder()
+                    let buffer = ''
+                    while (!signal.aborted && !reset) {
+                        timer = setTimeout(() => connection.abort(new Error('SSE heartbeat timeout')), 45_000)
+                        const { value, done } = await reader.read()
+                        clearTimeout(timer)
+                        if (done) break
+                        buffer += decoder.decode(value, { stream: true }).replace(/\r/g, '')
+                        if (buffer.length > 2 * 1024 * 1024) throw new Error('SSE frame limit exceeded')
+                        let end
+                        while ((end = buffer.indexOf('\n\n')) >= 0) {
+                            const frame = buffer.slice(0, end)
+                            buffer = buffer.slice(end + 2)
+                            const lines = frame.split('\n')
+                            const data = lines.filter((line) => line.startsWith('data:')).map((line) => line.slice(5).trimStart()).join('\n')
+                            if (!data) continue // Heartbeat comments carry no event.
+                            const type = lines.find((line) => line.startsWith('event:'))?.slice(6).trim()
+                            const eventId = lines.find((line) => line.startsWith('id:'))?.slice(3).trim()
+                            if (type === 'reset') {
+                                // Use our fixed same-origin Session route, never a remote recovery URL.
+                                const snapshot = await request(route(id), 'GET', undefined, signal)
+                                cursor = snapshot.lastEventId || '0'
+                                yield { type: 'reset', data: snapshot, recovery: JSON.parse(data) }
+                                reset = true
+                                break
+                            }
+                            if (!eventId || !/^\d+$/.test(eventId)) continue
+                            if (cursor !== undefined && BigInt(eventId) <= BigInt(cursor)) continue
+                            cursor = eventId
+                            retries = 0
+                            yield JSON.parse(data)
+                        }
+                    }
+                } catch (error) {
+                    if (signal.aborted) return
+                    // A revoked Key, narrowed scope or deleted/restarted Session needs user action.
+                    if ([401, 403, 404].includes(error.status)) throw error
+                } finally {
+                    clearTimeout(timer)
+                    connection.abort()
+                    await reader?.cancel().catch(() => {})
+                }
+                if (!reset && !signal.aborted) {
+                    await delay(Math.min(30_000, 500 * 2 ** Math.min(retries++, 6)) + Math.random() * 250,
+                        undefined, { signal }).catch((error) => { if (!signal.aborted) throw error })
+                }
+            }
+        }
+    }
+}

package/nexus-agentd.example.json

@@ -17,7 +17,26 @@
   "maxSseConnections": 128,
   "maxConnections": 256,
   "sessionTtlMs": 86400000,
+  "quotas": {
+    "maxSessionsPerKey": 16,
+    "maxRunningRunsPerKey": 4,
+    "maxSsePerKey": 8,
+    "maxUploadBytesPerKey": 33554432
+  },
+  "history": { "maxRuns": 1000, "retentionDays": 30, "maxBytes": 67108864 },
+  "artifacts": { "retentionDays": 30, "maxBytes": 536870912, "maxArtifactBytes": 12582912, "maxQueuedBytes": 67108864 },
   "agents": {
+    "custom": {
+      "protocol": "acp",
+      "driver": "stdio",
+      "name": "Custom ACP",
+      "enabled": false,
+      "command": "your-acp-agent",
+      "args": [],
+      "probeArgs": ["--version"],
+      "workspace": "/data/repos/project",
+      "permissionPolicy": "ask"
+    },
     "codex": {
       "protocol": "acp",
       "driver": "codex",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-agentd",
-  "version": "0.2.6",
+  "version": "0.3.1",
   "description": "Local Nexus Gateway daemon with an HTTP/SSE API and WebUI for allowlisted ACP and remote A2A agents",
   "type": "module",
   "main": "dist/index.js",
@@ -10,6 +10,7 @@
   },
   "files": [
     "dist",
+    "examples",
     "nexus-agentd.example.json",
     "README.md"
   ],
@@ -34,7 +35,7 @@
   ],
   "scripts": {
     "build": "node scripts/generate-webui-sources.mjs && node scripts/clean-dist.mjs && tsc -p tsconfig.json",
-    "typecheck": "node scripts/generate-webui-sources.mjs && tsc -p tsconfig.json --noEmit",
+    "typecheck": "node scripts/generate-webui-sources.mjs && tsc -p tsconfig.json --noEmit && tsc -p tsconfig.webui.json",
     "test": "tsx --test test/*.test.ts",
     "test:webui": "node scripts/generate-webui-sources.mjs && playwright test",
     "prepack": "npm run build"