agim-cli 1.1.5 → 1.1.7

package/dist/core/viewer-local.d.ts

@@ -0,0 +1,34 @@
+export type PasteContentType = 'markdown' | 'plain';
+export interface PasteRow {
+    id: string;
+    content: string;
+    content_type: PasteContentType;
+    title: string | null;
+    source: string | null;
+    job_id: number | null;
+    created_at: number;
+    view_count: number;
+}
+export interface SavePasteOpts {
+    content: string;
+    content_type?: PasteContentType;
+    title?: string;
+    source?: string;
+    job_id?: number;
+}
+/**
+ * Save a paste. Returns the new row's id (uuidv4). Returns null if the
+ * underlying DB is broken (caller should fall back to truncation).
+ */
+export declare function savePaste(opts: SavePasteOpts): string | null;
+export declare function getPaste(id: string): PasteRow | null;
+export declare function bumpViewCount(id: string): void;
+export interface ListOpts {
+    limit?: number;
+    offset?: number;
+}
+export declare function listPastes(opts?: ListOpts): PasteRow[];
+export declare function deletePaste(id: string): boolean;
+export declare function countPastes(): number;
+export declare function closeViewerDb(): void;
+//# sourceMappingURL=viewer-local.d.ts.map

package/dist/core/viewer-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-local.d.ts","sourceRoot":"","sources":["../../src/core/viewer-local.ts"],"names":[],"mappings":"AA8CA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,CAAA;AAEnD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,gBAAgB,CAAA;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAWD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CA8C5D;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQpD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,UAAU,CAAC,IAAI,GAAE,QAAa,GAAG,QAAQ,EAAE,CAS1D;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAK/C;AAED,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/core/viewer-local.js

@@ -0,0 +1,140 @@
+// Viewer-local — local SQLite store for long IM-message payloads that get
+// rendered as web pages via /v/:id on the agim web console.
+//
+// Why local: privacy — content stays on the operator's machine, full stop.
+// IM messages carry only a short link to the operator's own publicly-reachable
+// agim web (cloudflared / caddy / tailscale at operator's discretion). The
+// link resolves to a row in this SQLite, rendered by the web console.
+//
+// Permanence: rows have NO TTL. They are kept until the operator hits the
+// per-instance cap (`IMHUB_VIEWER_MAX_PASTES`, default 10_000), at which point
+// the oldest rows are pruned LRU. Rationale: this is the operator's own data,
+// equivalent to their memos / job history — they should keep it unless they
+// explicitly delete.
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { logger as rootLogger } from './logger.js';
+import { createSqliteHelper } from './sqlite-helper.js';
+import { AGIM_HOME } from './agim-paths.js';
+const VIEWER_DB = join(AGIM_HOME, 'viewer.db');
+const SCHEMA = `
+  CREATE TABLE IF NOT EXISTS pastes (
+    id TEXT PRIMARY KEY,
+    content TEXT NOT NULL,
+    content_type TEXT NOT NULL DEFAULT 'markdown',
+    title TEXT,
+    source TEXT,
+    job_id INTEGER,
+    created_at INTEGER NOT NULL,
+    view_count INTEGER NOT NULL DEFAULT 0
+  );
+  CREATE INDEX IF NOT EXISTS idx_pastes_created ON pastes(created_at DESC);
+  CREATE INDEX IF NOT EXISTS idx_pastes_job ON pastes(job_id);
+`;
+const viewerLog = rootLogger.child({ component: 'viewer-local' });
+const helper = createSqliteHelper({
+    file: VIEWER_DB,
+    schema: SCHEMA,
+    logger: viewerLog,
+    component: 'viewer-local',
+});
+const DEFAULT_MAX_PASTES = 10_000;
+function maxPastes() {
+    const raw = process.env.IMHUB_VIEWER_MAX_PASTES;
+    if (!raw)
+        return DEFAULT_MAX_PASTES;
+    const n = parseInt(raw, 10);
+    return Number.isFinite(n) && n > 0 ? n : DEFAULT_MAX_PASTES;
+}
+/**
+ * Save a paste. Returns the new row's id (uuidv4). Returns null if the
+ * underlying DB is broken (caller should fall back to truncation).
+ */
+export function savePaste(opts) {
+    const db = helper.get();
+    if (!db)
+        return null;
+    const id = randomUUID();
+    const now = Math.floor(Date.now() / 1000);
+    const ct = opts.content_type === 'plain' ? 'plain' : 'markdown';
+    try {
+        db.prepare(`
+      INSERT INTO pastes (id, content, content_type, title, source, job_id, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(id, opts.content, ct, opts.title ?? null, opts.source ?? null, opts.job_id ?? null, now);
+    }
+    catch (err) {
+        viewerLog.warn({ event: 'viewer.save.failed', err: String(err) });
+        return null;
+    }
+    // LRU prune (cheap — only fires when over cap)
+    try {
+        const cap = maxPastes();
+        const total = db.prepare('SELECT COUNT(*) AS n FROM pastes').get();
+        if (total.n > cap) {
+            const over = total.n - cap;
+            const r = db.prepare(`
+        DELETE FROM pastes WHERE id IN (
+          SELECT id FROM pastes ORDER BY created_at ASC LIMIT ?
+        )
+      `).run(over);
+            if (r.changes > 0) {
+                viewerLog.info({ event: 'viewer.prune.lru', removed: r.changes, cap });
+            }
+        }
+    }
+    catch (err) {
+        viewerLog.warn({ event: 'viewer.prune.failed', err: String(err) });
+    }
+    return id;
+}
+export function getPaste(id) {
+    const db = helper.get();
+    if (!db)
+        return null;
+    const row = db.prepare(`
+    SELECT id, content, content_type, title, source, job_id, created_at, view_count
+    FROM pastes WHERE id = ?
+  `).get(id);
+    return row ?? null;
+}
+export function bumpViewCount(id) {
+    const db = helper.get();
+    if (!db)
+        return;
+    try {
+        db.prepare('UPDATE pastes SET view_count = view_count + 1 WHERE id = ?').run(id);
+    }
+    catch (err) {
+        viewerLog.warn({ event: 'viewer.bump.failed', err: String(err) });
+    }
+}
+export function listPastes(opts = {}) {
+    const db = helper.get();
+    if (!db)
+        return [];
+    const limit = Math.min(Math.max(opts.limit ?? 50, 1), 500);
+    const offset = Math.max(opts.offset ?? 0, 0);
+    return db.prepare(`
+    SELECT id, content, content_type, title, source, job_id, created_at, view_count
+    FROM pastes ORDER BY created_at DESC LIMIT ? OFFSET ?
+  `).all(limit, offset);
+}
+export function deletePaste(id) {
+    const db = helper.get();
+    if (!db)
+        return false;
+    const r = db.prepare('DELETE FROM pastes WHERE id = ?').run(id);
+    return r.changes > 0;
+}
+export function countPastes() {
+    const db = helper.get();
+    if (!db)
+        return 0;
+    const row = db.prepare('SELECT COUNT(*) AS n FROM pastes').get();
+    return row.n;
+}
+export function closeViewerDb() {
+    helper.close();
+}
+//# sourceMappingURL=viewer-local.js.map

package/dist/core/viewer-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-local.js","sourceRoot":"","sources":["../../src/core/viewer-local.ts"],"names":[],"mappings":"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"}

package/dist/web/public/settings.html

@@ -151,6 +151,23 @@
         approvalPolicySave: 'Save',
         approvalPolicySaved: 'Saved — applies to the next pending approval, no restart needed.',
         approvalPolicyLoadFailed: 'Failed to load approval policy',
+
+        // ── Viewer (long-message web rendering) ────────────────────
+        viewerTitle: 'IM Long-Message Viewer',
+        viewerHint: 'When an agent reply is too long or contains a markdown table / large code block, Agim stores it locally in ~/.agim/viewer.db (permanent, never leaves this host) and sends the IM a short summary + a link. Set the public URL of your reverse-proxied Agim web here so the link is reachable from your phone.',
+        viewerEnabled: 'Enabled',
+        viewerDisabled: 'Disabled',
+        viewerEnabledLabel: 'Viewer mode',
+        viewerPublicUrl: 'Public base URL',
+        viewerPublicUrlHint: 'Your public URL pointing at this Agim web (e.g. https://agim.example.com). Use cloudflared / caddy / tailscale to expose port 3000.',
+        viewerChars: 'Char threshold',
+        viewerLines: 'Line threshold',
+        viewerCodeLines: 'Code-block line threshold',
+        viewerMaxPastes: 'Max stored pastes (LRU prune)',
+        viewerSave: 'Save',
+        viewerSaved: 'Saved — change takes effect on the next reply.',
+        viewerSaveFailed: 'Failed to save viewer settings',
+        viewerMissingUrl: '⚠️ Public URL is empty — Agim will fall back to inline text for long replies (no link can be built).',
       },
       zh: {
         title: 'Agim — 设置',
@@ -288,6 +305,23 @@
         approvalPolicySave: '保存',
         approvalPolicySaved: '已保存 — 下一个挂起的审批起就生效，无需重启。',
         approvalPolicyLoadFailed: '加载审批策略失败',
+
+        // ── Viewer (长内容 web 渲染) ─────────────────────────────
+        viewerTitle: 'IM 长内容 Viewer',
+        viewerHint: 'Agent 回答过长或含 markdown 表格 / 大段代码时，Agim 把全文存到本机 ~/.agim/viewer.db（永久保存，绝不离开本机），IM 里只发短摘要 + 跳转链接。这里填你反代到本机 Agim web 的公网域名，链接才能让手机/微信打开。',
+        viewerEnabled: '开启',
+        viewerDisabled: '关闭',
+        viewerEnabledLabel: 'Viewer 状态',
+        viewerPublicUrl: '公网域名',
+        viewerPublicUrlHint: '指向本机 Agim web 的公网域名（例如 https://agim.example.com）。用 cloudflared / caddy / tailscale 把 3000 端口暴露出去即可。',
+        viewerChars: '字符阈值',
+        viewerLines: '行数阈值',
+        viewerCodeLines: '代码块行数阈值',
+        viewerMaxPastes: '本机最多保留条数（LRU 淘汰）',
+        viewerSave: '保存',
+        viewerSaved: '已保存 — 下一条回复生效。',
+        viewerSaveFailed: '保存 Viewer 配置失败',
+        viewerMissingUrl: '⚠️ 公网域名为空 — 长回复将退回到内联文本（无法构造跳转链接）。',
       },
     };
     function t(key) { return T[window.__lang][key] || T.en[key] || key; }
@@ -1369,6 +1403,47 @@
           <p class="muted" id="smtpStatus" style="margin-top:8px;font-size:12px"></p>
         </div>
 
+        <!-- Viewer (env-file) — long-message web rendering -->
+        <div class="card">
+          <h2>📄 ${t('viewerTitle')}</h2>
+          <p class="muted" style="margin-top:-4px;margin-bottom:12px;font-size:13px">${t('viewerHint')}</p>
+
+          <div style="display:flex;gap:16px;flex-wrap:wrap;align-items:center;margin-bottom:12px">
+            <label style="display:flex;gap:8px;align-items:center;font-weight:600">
+              <input type="checkbox" id="viewerEnabled" />
+              ${t('viewerEnabledLabel')}
+            </label>
+          </div>
+
+          <label>${t('viewerPublicUrl')}</label>
+          <input type="text" id="viewerPublicUrl" placeholder="https://agim.example.com" style="max-width:480px" />
+          <p class="muted" style="margin-top:4px;font-size:12px">${t('viewerPublicUrlHint')}</p>
+
+          <div style="display:grid;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:12px;margin-top:12px;max-width:720px">
+            <div>
+              <label>${t('viewerChars')}</label>
+              <input type="number" id="viewerChars" min="100" max="10000" placeholder="500" />
+            </div>
+            <div>
+              <label>${t('viewerLines')}</label>
+              <input type="number" id="viewerLines" min="5" max="200" placeholder="12" />
+            </div>
+            <div>
+              <label>${t('viewerCodeLines')}</label>
+              <input type="number" id="viewerCodeLines" min="5" max="200" placeholder="10" />
+            </div>
+            <div>
+              <label>${t('viewerMaxPastes')}</label>
+              <input type="number" id="viewerMaxPastes" min="100" max="1000000" placeholder="10000" />
+            </div>
+          </div>
+
+          <div class="actions" style="margin-top:12px">
+            <button type="button" class="btn btn-primary" id="saveViewer">${t('viewerSave')}</button>
+          </div>
+          <p class="muted" id="viewerStatus" style="margin-top:8px;font-size:12px"></p>
+        </div>
+
         <!-- Baidu Maps AK (env-file) — feeds /memo address geocoding -->
         <div class="card">
           <h2>🗺 Baidu Maps AK</h2>
@@ -1404,6 +1479,28 @@
         const sec = document.getElementById('smtpSecure');
         if (sec) sec.value = env['IMHUB_SMTP_SECURE'] || 'auto';
         set('baiduAk', 'IMHUB_BAIDU_MAP_AK');
+        // Viewer card fields
+        const vEnabled = document.getElementById('viewerEnabled');
+        if (vEnabled) {
+          const v = (env['IMHUB_VIEWER_ENABLED'] || '').toLowerCase();
+          vEnabled.checked = v === '1' || v === 'true' || v === 'yes';
+        }
+        set('viewerPublicUrl', 'IMHUB_VIEWER_PUBLIC_BASE_URL');
+        set('viewerChars', 'IMHUB_VIEWER_CHARS');
+        set('viewerLines', 'IMHUB_VIEWER_LINES');
+        set('viewerCodeLines', 'IMHUB_VIEWER_CODE_LINES');
+        set('viewerMaxPastes', 'IMHUB_VIEWER_MAX_PASTES');
+        const viewerStatus = document.getElementById('viewerStatus');
+        if (viewerStatus) {
+          if (!env['IMHUB_VIEWER_PUBLIC_BASE_URL']) {
+            viewerStatus.textContent = t('viewerMissingUrl');
+          } else if ((env['IMHUB_VIEWER_ENABLED'] || '').toLowerCase() === '1' ||
+                     (env['IMHUB_VIEWER_ENABLED'] || '').toLowerCase() === 'true') {
+            viewerStatus.textContent = `✓ ${t('viewerEnabled')} → ${env['IMHUB_VIEWER_PUBLIC_BASE_URL']}`;
+          } else {
+            viewerStatus.textContent = `${t('viewerDisabled')} (${env['IMHUB_VIEWER_PUBLIC_BASE_URL']})`;
+          }
+        }
         const smtpStatus = document.getElementById('smtpStatus');
         const baiduStatus = document.getElementById('baiduStatus');
         if (smtpStatus) smtpStatus.textContent = env['IMHUB_SMTP_HOST']
@@ -1704,6 +1801,37 @@
       });
       document.getElementById('revealBaidu')?.addEventListener('click', () => loadEnvSection(true));
 
+      // Viewer card — save toggle + URL + thresholds in one round-trip.
+      document.getElementById('saveViewer')?.addEventListener('click', async () => {
+        const enabled = document.getElementById('viewerEnabled')?.checked ? '1' : '0';
+        const url = (document.getElementById('viewerPublicUrl')?.value || '').trim();
+        const chars = (document.getElementById('viewerChars')?.value || '').trim();
+        const lines = (document.getElementById('viewerLines')?.value || '').trim();
+        const codeLines = (document.getElementById('viewerCodeLines')?.value || '').trim();
+        const maxPastes = (document.getElementById('viewerMaxPastes')?.value || '').trim();
+        const status = document.getElementById('viewerStatus');
+        try {
+          await authFetch('/api/env', {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+              updates: {
+                IMHUB_VIEWER_ENABLED: enabled,
+                IMHUB_VIEWER_PUBLIC_BASE_URL: url || null,
+                IMHUB_VIEWER_CHARS: chars || null,
+                IMHUB_VIEWER_LINES: lines || null,
+                IMHUB_VIEWER_CODE_LINES: codeLines || null,
+                IMHUB_VIEWER_MAX_PASTES: maxPastes || null,
+              },
+            }),
+          });
+          if (status) status.textContent = t('viewerSaved');
+          await loadEnvSection();
+        } catch (err) {
+          if (status) status.textContent = t('viewerSaveFailed') + ': ' + (err && err.message ? err.message : err);
+        }
+      });
+
       // ==========================================
       // Workspaces (PR-C)
       // ==========================================

package/dist/web/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAsDA,wBAAgB,iBAAiB,IAAI,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAOrE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAsqB/C"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAsDA,wBAAgB,iBAAiB,IAAI,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAOrE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA+rB/C"}

package/dist/web/server.js

@@ -106,6 +106,15 @@ export async function startWebServer(options) {
         if (url.pathname === '/loc' && req.method === 'GET') {
             return serveStatic(res, join(PUBLIC_DIR, 'loc.html'), 'text/html; charset=utf-8');
         }
+        // v1.2 — Viewer: rendered markdown for long IM messages. URL is
+        // unguessable uuidv4; same trust model as /loc (public-on-purpose,
+        // operator fronts the web with their reverse proxy / tunnel).
+        // Content stays in ~/.agim/viewer.db on this host — the public URL
+        // is just a proxy back to here. See src/core/viewer-local.ts.
+        const viewerMatch = url.pathname.match(/^\/v\/([0-9a-f-]{8,})$/i);
+        if (viewerMatch && req.method === 'GET') {
+            return handleViewerPage(res, viewerMatch[1]);
+        }
         // Short alias: /l/<token> serves the same H5 page. The page auto-detects
         // either ?t= query or /l/<token> path. Lets us issue ~38-char URLs
         // (vs 70+ for /loc?t=<32-hex>) which keeps WeChat chat cleaner.
@@ -396,6 +405,20 @@ export async function startWebServer(options) {
         if (artifactsFileMatch && req.method === 'GET') {
             return handleArtifactsFile(req, res, parseInt(artifactsFileMatch[1], 10), artifactsFileMatch[2]);
         }
+        // v1.2 — Viewer pastes (long markdown stash for IM short-link replies).
+        // GET /api/viewer        — list pastes (newest first), for the web console.
+        // GET /api/viewer/:id    — raw JSON of one paste.
+        // DELETE /api/viewer/:id — remove a paste (operator can clean up).
+        if (url.pathname === '/api/viewer' && req.method === 'GET') {
+            return handleViewerList(req, res, url);
+        }
+        const viewerIdMatch = url.pathname.match(/^\/api\/viewer\/([0-9a-f-]{8,})$/i);
+        if (viewerIdMatch && req.method === 'GET') {
+            return handleViewerGet(req, res, viewerIdMatch[1]);
+        }
+        if (viewerIdMatch && req.method === 'DELETE') {
+            return handleViewerDelete(req, res, viewerIdMatch[1]);
+        }
         // PR-B: agent health snapshot (circuit breaker + rate-limiter remaining
         // + latency p50/95/99) consumed by the Health tab in /tasks.
         if (url.pathname === '/api/agent-health' && req.method === 'GET') {
@@ -1608,6 +1631,15 @@ const ENV_EDITABLE_KEYS = [
     // Hot-reload: handlePutEnv mutates process.env so approval-bus picks up the
     // new value on the next timer fire, no restart needed.
     'IMHUB_TIMEOUT_DEFAULT',
+    // v1.2 — IM long-message viewer. Operator sets the public URL pointing at
+    // their reverse-proxied agim web port; thresholds tune when routing kicks
+    // in. Hot-reload works because viewer-config reads process.env every call.
+    'IMHUB_VIEWER_ENABLED',
+    'IMHUB_VIEWER_PUBLIC_BASE_URL',
+    'IMHUB_VIEWER_CHARS',
+    'IMHUB_VIEWER_LINES',
+    'IMHUB_VIEWER_CODE_LINES',
+    'IMHUB_VIEWER_MAX_PASTES',
 ];
 const SECRET_KEYS = new Set(['IMHUB_SMTP_PASS', 'IMHUB_BAIDU_MAP_AK']);
 function maskSecret(v) {
@@ -2694,6 +2726,66 @@ async function handleArtifactsFile(_req, res, jobId, name) {
         sendJson(res, 500, { error: err instanceof Error ? err.message : String(err) });
     }
 }
+// ─── Viewer handlers ───
+// v1.2 — Render a stored paste as an HTML page. URL is unguessable uuidv4
+// (32 hex chars including dashes); we still cap the length match to a
+// reasonable max in the router to avoid pathological lookups.
+async function handleViewerPage(res, id) {
+    const { getPaste, bumpViewCount } = await import('../core/viewer-local.js');
+    const { renderPasteHtml, renderNotFoundHtml } = await import('./viewer-render.js');
+    const row = getPaste(id);
+    if (!row) {
+        res.writeHead(404, {
+            'Content-Type': 'text/html; charset=utf-8',
+            'X-Robots-Tag': 'noindex, nofollow',
+        });
+        res.end(renderNotFoundHtml());
+        return;
+    }
+    bumpViewCount(id);
+    res.writeHead(200, {
+        'Content-Type': 'text/html; charset=utf-8',
+        'X-Robots-Tag': 'noindex, nofollow',
+        'Cache-Control': 'no-store',
+    });
+    res.end(renderPasteHtml(row));
+}
+async function handleViewerList(_req, res, url) {
+    const { listPastes, countPastes } = await import('../core/viewer-local.js');
+    const limit = Math.min(Math.max(parseInt(url.searchParams.get('limit') || '50', 10) || 50, 1), 500);
+    const offset = Math.max(parseInt(url.searchParams.get('offset') || '0', 10) || 0, 0);
+    const rows = listPastes({ limit, offset });
+    // Strip content from list response to keep payload light; UI loads full row via GET /api/viewer/:id.
+    const items = rows.map((r) => ({
+        id: r.id,
+        content_type: r.content_type,
+        title: r.title,
+        source: r.source,
+        job_id: r.job_id,
+        created_at: r.created_at,
+        view_count: r.view_count,
+        bytes: Buffer.byteLength(r.content, 'utf8'),
+    }));
+    sendJson(res, 200, { total: countPastes(), limit, offset, items });
+}
+async function handleViewerGet(_req, res, id) {
+    const { getPaste } = await import('../core/viewer-local.js');
+    const row = getPaste(id);
+    if (!row) {
+        sendJson(res, 404, { error: 'not_found' });
+        return;
+    }
+    sendJson(res, 200, row);
+}
+async function handleViewerDelete(_req, res, id) {
+    const { deletePaste } = await import('../core/viewer-local.js');
+    const ok = deletePaste(id);
+    if (!ok) {
+        sendJson(res, 404, { error: 'not_found' });
+        return;
+    }
+    sendJson(res, 200, { ok: true });
+}
 // ============================================
 // WebSocket chat handlers
 // ============================================