webtape 1.7.0

package/dist/server.js

@@ -0,0 +1,122 @@
+import { createServer } from 'node:http';
+import { performance } from 'node:perf_hooks';
+import { join } from 'node:path';
+import { saveRecording } from './storage.js';
+import { analyzeRecording } from './analyzer.js';
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        req.on('error', reject);
+    });
+}
+function json(res, status, body) {
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Access-Control-Allow-Origin': '*',
+    });
+    res.end(JSON.stringify(body));
+}
+function handleCors(req, res) {
+    if (req.method === 'OPTIONS') {
+        res.writeHead(204, {
+            'Access-Control-Allow-Origin': '*',
+            'Access-Control-Allow-Methods': 'POST, GET, OPTIONS',
+            'Access-Control-Allow-Headers': 'Content-Type',
+            'Access-Control-Max-Age': '86400',
+        });
+        res.end();
+        return true;
+    }
+    return false;
+}
+export function createWebhookServer(opts) {
+    const { port, workspace, autoAnalyze, analyzerBackend, analyzerModel, onReceive, onAnalyzeLog, onAnalyzeDone, onError } = opts;
+    const server = createServer(async (req, res) => {
+        if (handleCors(req, res))
+            return;
+        // Health check
+        if (req.method === 'GET' && (req.url === '/' || req.url === '/health')) {
+            json(res, 200, {
+                status: 'ok',
+                service: 'webtape-receiver',
+                workspace: workspace.root,
+            });
+            return;
+        }
+        // Webhook endpoint
+        if (req.method === 'POST' && (req.url === '/' || req.url === '/webhook')) {
+            try {
+                const t0 = performance.now();
+                const body = await readBody(req);
+                const t1 = performance.now();
+                const payload = JSON.parse(body);
+                if (!payload.meta || !payload.content) {
+                    json(res, 400, { error: 'Invalid WebTape payload: missing meta or content' });
+                    return;
+                }
+                const t2 = performance.now();
+                const sessionDir = saveRecording(workspace, payload);
+                const t3 = performance.now();
+                const metrics = {
+                    readBodyMs: t1 - t0,
+                    parseValidateMs: t2 - t1,
+                    persistMs: t3 - t2,
+                    totalNonAiMs: t3 - t0,
+                };
+                onReceive?.(sessionDir, payload, metrics);
+                if (autoAnalyze) {
+                    runAnalysis(workspace, sessionDir, analyzerBackend, analyzerModel, onAnalyzeLog, onAnalyzeDone, onError);
+                }
+                json(res, 200, {
+                    status: 'received',
+                    session: sessionDir,
+                    autoAnalyze,
+                    timingMs: {
+                        readBody: Math.round(metrics.readBodyMs * 10) / 10,
+                        parseValidate: Math.round(metrics.parseValidateMs * 10) / 10,
+                        persist: Math.round(metrics.persistMs * 10) / 10,
+                        totalNonAi: Math.round(metrics.totalNonAiMs * 10) / 10,
+                    },
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                onError?.(err instanceof Error ? err : new Error(message));
+                json(res, 500, { error: message });
+            }
+            return;
+        }
+        // Trigger analysis for a specific session
+        if (req.method === 'POST' && req.url?.startsWith('/analyze/')) {
+            const sessionName = req.url.slice('/analyze/'.length);
+            const sessionDir = join(workspace.recordings, sessionName);
+            try {
+                runAnalysis(workspace, sessionDir, analyzerBackend, analyzerModel, onAnalyzeLog, onAnalyzeDone, onError);
+                json(res, 200, { status: 'analysis_started', session: sessionDir });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                json(res, 500, { error: message });
+            }
+            return;
+        }
+        json(res, 404, { error: 'Not found' });
+    });
+    return {
+        start: () => new Promise((resolve) => {
+            server.listen(port, () => resolve());
+        }),
+        stop: () => new Promise((resolve, reject) => {
+            server.close((err) => (err ? reject(err) : resolve()));
+        }),
+        server,
+    };
+}
+function runAnalysis(workspace, sessionDir, backend, model, onLog, onDone, onError) {
+    analyzeRecording({ backend, workspace, sessionDir, model, onLog })
+        .then((result) => onDone?.(result))
+        .catch((err) => onError?.(err instanceof Error ? err : new Error(String(err))));
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,48 @@
+import type { WorkspacePaths } from './workspace.js';
+import type { WebTapePayload } from './types.js';
+/**
+ * Extract the full hostname from a URL string.
+ * e.g. "https://www.github.com/page" → "www.github.com"
+ */
+export declare function extractHostname(url: string): string;
+/**
+ * Parse a session directory name back into its components.
+ * New format: ${hostname}/${MMDD}-${HHmmss}
+ * Legacy format: ${domain}-${MMDD}-${HHmmss}
+ */
+export declare function parseSessionName(name: string): {
+    domain: string;
+    date: string;
+    time: string;
+};
+/**
+ * Format a time string "HHmmss" → "HH:mm:ss".
+ */
+export declare function formatTime(time: string): string;
+/**
+ * Persist a webhook payload to the workspace as structured files:
+ *
+ *   recordings/<session>/
+ *     index.json
+ *     requests/
+ *       req_0001.json
+ *     responses/
+ *       res_0001.json
+ *
+ * Returns the absolute path of the session directory.
+ */
+export declare function saveRecording(workspace: WorkspacePaths, payload: WebTapePayload): string;
+/**
+ * List existing recording sessions sorted newest-first.
+ * Supports both new format (hostname/MMDD-HHmmss) and legacy flat format.
+ */
+export declare function listRecordings(workspace: WorkspacePaths): string[];
+/**
+ * Check whether a recording session has an analysis report.
+ */
+export declare function hasAnalysisReport(workspace: WorkspacePaths, sessionName: string): boolean;
+/**
+ * List recordings that do NOT have an analysis report.
+ */
+export declare function listUnanalyzedRecordings(workspace: WorkspacePaths): string[];
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAqC,MAAM,YAAY,CAAC;AAwBpF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD;AAmBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAoB7F;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,cAAc,GACtB,MAAM,CA4IR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,EAAE,CAuClE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAEzF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,EAAE,CAE5E"}

package/dist/storage.js

@@ -0,0 +1,271 @@
+import { mkdirSync, writeFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { extractSiteUrl, renderAnalysisContext } from './context.js';
+/**
+ * Format unix-ms as Asia/Shanghai wall time with milliseconds (+08:00).
+ */
+function formatTimestampCST(ts) {
+    const d = new Date(ts);
+    const parts = new Intl.DateTimeFormat('en-CA', {
+        timeZone: 'Asia/Shanghai',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+        fractionalSecondDigits: 3,
+    }).formatToParts(d);
+    const g = (type) => parts.find((p) => p.type === type)?.value ?? '';
+    return `${g('year')}-${g('month')}-${g('day')}T${g('hour')}:${g('minute')}:${g('second')}+08:00`;
+}
+/**
+ * Extract the full hostname from a URL string.
+ * e.g. "https://www.github.com/page" → "www.github.com"
+ */
+export function extractHostname(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Build the session directory name from the payload.
+ * Format: ${hostname}/${MMDD}-${HHmmss}
+ * e.g. "www.github.com/0305-123000"
+ */
+function sessionDirName(payload) {
+    const firstTs = payload.content['index.json'][0]?.timestamp ?? Date.now();
+    const d = new Date(firstTs);
+    const pad = (n, len = 2) => String(n).padStart(len, '0');
+    const hostname = extractHostname(extractSiteUrl(payload)) || 'unknown';
+    const datePart = `${pad(d.getMonth() + 1)}${pad(d.getDate())}`;
+    const timePart = `${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
+    return `${hostname}/${datePart}-${timePart}`;
+}
+/**
+ * Parse a session directory name back into its components.
+ * New format: ${hostname}/${MMDD}-${HHmmss}
+ * Legacy format: ${domain}-${MMDD}-${HHmmss}
+ */
+export function parseSessionName(name) {
+    const slashIdx = name.lastIndexOf('/');
+    if (slashIdx !== -1) {
+        // New format: hostname/MMDD-HHmmss
+        const domain = name.slice(0, slashIdx);
+        const timePart = name.slice(slashIdx + 1);
+        const dashIdx = timePart.indexOf('-');
+        if (dashIdx !== -1) {
+            return { domain, date: timePart.slice(0, dashIdx), time: timePart.slice(dashIdx + 1) };
+        }
+        return { domain, date: timePart, time: '' };
+    }
+    // Legacy format: domain-MMDD-HHmmss
+    const lastDash = name.lastIndexOf('-');
+    const time = name.slice(lastDash + 1);
+    const rest = name.slice(0, lastDash);
+    const secondLastDash = rest.lastIndexOf('-');
+    const date = rest.slice(secondLastDash + 1);
+    const domain = rest.slice(0, secondLastDash);
+    return { domain, date, time };
+}
+/**
+ * Format a time string "HHmmss" → "HH:mm:ss".
+ */
+export function formatTime(time) {
+    if (time.length !== 6)
+        return time;
+    return `${time.slice(0, 2)}:${time.slice(2, 4)}:${time.slice(4, 6)}`;
+}
+/**
+ * If `body` is a JSON string, parse it into an object so it is saved as
+ * nested JSON rather than an escaped string.
+ */
+function withParsedJsonBody(entry) {
+    if (typeof entry.body === 'string') {
+        try {
+            const parsed = JSON.parse(entry.body);
+            if (typeof parsed === 'object' && parsed !== null) {
+                return { ...entry, body: parsed };
+            }
+        }
+        catch {
+            // not valid JSON – keep the original string
+        }
+    }
+    return entry;
+}
+/**
+ * Persist a webhook payload to the workspace as structured files:
+ *
+ *   recordings/<session>/
+ *     index.json
+ *     requests/
+ *       req_0001.json
+ *     responses/
+ *       res_0001.json
+ *
+ * Returns the absolute path of the session directory.
+ */
+export function saveRecording(workspace, payload) {
+    const dirName = sessionDirName(payload);
+    const sessionDir = join(workspace.recordings, dirName);
+    const reqDir = join(sessionDir, 'requests');
+    const resDir = join(sessionDir, 'responses');
+    const snapshotDir = join(sessionDir, 'snapshots');
+    mkdirSync(reqDir, { recursive: true });
+    mkdirSync(resDir, { recursive: true });
+    mkdirSync(snapshotDir, { recursive: true });
+    // Create a mapping of original req_id → sequential suffix 0001, 0002, …
+    const allReqIds = Object.keys(payload.content.requests)
+        .map((filename) => filename.replace(/\.json$/, ''))
+        .sort((a, b) => {
+        const nA = parseInt(a.replace(/^req_/, ''), 10);
+        const nB = parseInt(b.replace(/^req_/, ''), 10);
+        if (!Number.isNaN(nA) && !Number.isNaN(nB))
+            return nA - nB;
+        return a.localeCompare(b);
+    });
+    const idMap = new Map();
+    allReqIds.forEach((oldId, index) => {
+        idMap.set(oldId, String(index + 1).padStart(4, '0'));
+    });
+    function seqFromReqId(oldReqId) {
+        const mapped = idMap.get(oldReqId);
+        if (mapped)
+            return mapped;
+        const m = /^req_(\d+)$/.exec(oldReqId);
+        return m ? m[1] : oldReqId.replace(/^req_/, '');
+    }
+    // Update index.json: remap req_ids and keep detail_path in sync
+    const updatedIndex = payload.content['index.json'].map((block) => ({
+        ...block,
+        triggered_network: block.triggered_network?.map((net) => {
+            const seq = seqFromReqId(net.req_id);
+            const newReqId = `req_${seq}`;
+            return {
+                ...net,
+                req_id: newReqId,
+                detail_path: {
+                    request: `requests/${newReqId}.json`,
+                    response: `responses/res_${seq}.json`,
+                },
+            };
+        }),
+    }));
+    const savedTimeline = updatedIndex.map((block) => {
+        const { timestamp, timestamp_cst, ...rest } = block;
+        return {
+            ...rest,
+            timestamp: timestamp_cst ?? formatTimestampCST(timestamp),
+        };
+    });
+    const savedIndex = {
+        meta: {
+            version: payload.meta.version,
+            recording_started_at_cst: payload.meta.recording_started_at_cst,
+            recording_started_at_epoch_ms: payload.meta.recording_started_at_epoch_ms,
+            recording_ended_at_cst: payload.meta.recording_ended_at_cst,
+            recording_ended_at_epoch_ms: payload.meta.recording_ended_at_epoch_ms,
+        },
+        timeline: savedTimeline,
+    };
+    writeFileSync(join(sessionDir, 'index.json'), JSON.stringify(savedIndex, null, 2), 'utf-8');
+    const remappedRequests = {};
+    const remappedResponses = {};
+    for (const [filename, data] of Object.entries(payload.content.requests)) {
+        const oldStem = filename.replace(/\.json$/, '');
+        const seq = idMap.get(oldStem) ?? seqFromReqId(oldStem);
+        const newReqId = `req_${seq}`;
+        const newFilename = `${newReqId}.json`;
+        const parsedReq = withParsedJsonBody(data);
+        const enrichedData = { ...parsedReq, req_id: newReqId, _original_id: oldStem };
+        remappedRequests[newFilename] = enrichedData;
+        writeFileSync(join(reqDir, newFilename), JSON.stringify(enrichedData, null, 2), 'utf-8');
+    }
+    for (const [filename, data] of Object.entries(payload.content.responses)) {
+        const oldResStem = filename.replace(/\.json$/, '');
+        const oldReqStem = oldResStem.startsWith('res_')
+            ? oldResStem.replace(/^res_/, 'req_')
+            : oldResStem;
+        const seq = idMap.get(oldReqStem) ?? seqFromReqId(oldReqStem);
+        const newFilename = `res_${seq}.json`;
+        const pairedReqId = `req_${seq}`;
+        const parsedRes = withParsedJsonBody(data);
+        const resPayload = { ...parsedRes, req_id: pairedReqId };
+        remappedResponses[newFilename] = resPayload;
+        writeFileSync(join(resDir, newFilename), JSON.stringify(resPayload, null, 2), 'utf-8');
+    }
+    if (payload.content.snapshots) {
+        for (const [contextId, snapshotText] of Object.entries(payload.content.snapshots)) {
+            writeFileSync(join(snapshotDir, `snapshot_${contextId}.md`), snapshotText, 'utf-8');
+        }
+    }
+    const siteUrl = extractSiteUrl(payload);
+    const contextPayload = {
+        ...payload,
+        content: {
+            ...payload.content,
+            'index.json': updatedIndex,
+            requests: remappedRequests,
+            responses: remappedResponses,
+        },
+    };
+    writeFileSync(join(sessionDir, '_context.md'), renderAnalysisContext(contextPayload, siteUrl), 'utf-8');
+    return sessionDir;
+}
+/**
+ * List existing recording sessions sorted newest-first.
+ * Supports both new format (hostname/MMDD-HHmmss) and legacy flat format.
+ */
+export function listRecordings(workspace) {
+    try {
+        const results = [];
+        const topDirs = readdirSync(workspace.recordings, { withFileTypes: true })
+            .filter((d) => d.isDirectory());
+        for (const dir of topDirs) {
+            const dirPath = join(workspace.recordings, dir.name);
+            // Legacy flat format: session dir contains index.json directly
+            if (existsSync(join(dirPath, 'index.json'))) {
+                results.push(dir.name);
+                continue;
+            }
+            // New format: hostname dir contains session subdirectories
+            const subDirs = readdirSync(dirPath, { withFileTypes: true })
+                .filter((d) => d.isDirectory());
+            for (const sub of subDirs) {
+                if (existsSync(join(dirPath, sub.name, 'index.json'))) {
+                    results.push(`${dir.name}/${sub.name}`);
+                }
+            }
+        }
+        // Sort by date-time newest-first
+        results.sort((a, b) => {
+            const aParsed = parseSessionName(a);
+            const bParsed = parseSessionName(b);
+            const aKey = `${aParsed.date}-${aParsed.time}`;
+            const bKey = `${bParsed.date}-${bParsed.time}`;
+            return bKey.localeCompare(aKey);
+        });
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Check whether a recording session has an analysis report.
+ */
+export function hasAnalysisReport(workspace, sessionName) {
+    return existsSync(join(workspace.recordings, sessionName, 'analysis_report.md'));
+}
+/**
+ * List recordings that do NOT have an analysis report.
+ */
+export function listUnanalyzedRecordings(workspace) {
+    return listRecordings(workspace).filter((name) => !hasAnalysisReport(workspace, name));
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/templates/context.md.ejs

@@ -0,0 +1,79 @@
+# 录制数据分析上下文
+
+> 此文件由 webtape-receiver 自动生成，将录制的时间线、请求和响应整合为单一文档。
+> 已过滤无关请求头（缓存、安全策略、编码等）；综述中不展示响应头。超过长度阈值的请求/响应体不在此展开，并附带按体积分级的提示；完整内容请查阅 requests/ 与 responses/ 目录。
+
+## 元数据
+
+- 导出时间: <%- meta.timestamp %>（epoch_ms: <%- meta.epoch %>）
+<% if (meta.recording_started_at_cst) { -%>
+- 录制开始: <%- meta.recording_started_at_cst %><% if (meta.recording_started_at_epoch_ms != null) { %>（epoch_ms: <%- meta.recording_started_at_epoch_ms %>）<% } %>
+<% } -%>
+<% if (meta.recording_ended_at_cst) { -%>
+- 录制结束: <%- meta.recording_ended_at_cst %><% if (meta.recording_ended_at_epoch_ms != null) { %>（epoch_ms: <%- meta.recording_ended_at_epoch_ms %>）<% } %>
+<% } -%>
+<% if (meta.hostname) { -%>
+- 网站: <%- meta.hostname %>
+<% } -%>
+<% if (siteUrl) { -%>
+- 入口 URL: <%- siteUrl %>
+<% } -%>
+- 时间线条目: <%- timeline.length %>
+- 请求总数: <%- requestCount %>
+
+## 操作时间线与接口详情
+
+<% timeline.forEach((block, i) => { -%>
+### [<%- i + 1 %>] <%- describeBlock(block) %>
+
+<% if (block.state) { -%>
+<% if (block.state.type === 'URL_CHANGE') { -%>
+- 变更前 → 当前 URL: <%- block.state.url %>
+<% if (block.state.title) { -%>
+- 页面标题: <%- block.state.title %>
+<% } -%>
+<% } else { -%>
+- URL: <%- block.state.url %>
+- 标题: <%- block.state.title %>
+<% } -%>
+
+<% } -%>
+<% if (block.action) { -%>
+- 操作类型: <%- block.action.type %>
+- 目标元素: `<%- block.action.tag %><%- block.action.id ? '#' + block.action.id : '' %>`<%- block.action.target_element ? ' — ' + block.action.target_element : '' %>
+<% if (block.action.aria_label) { -%>
+- aria-label: <%- block.action.aria_label %>
+<% } -%>
+
+<% } -%>
+<% if (block.triggered_network && block.triggered_network.length > 0) { -%>
+**触发的网络请求 (<%- block.triggered_network.length %> 个):**
+
+<% block.triggered_network.forEach((net) => { -%>
+<%- renderNetworkEntry(net) %>
+<% }); -%>
+<% } -%>
+<% if (block.snapshot_id) { -%>
+<% const _snapshotText = snapshots[block.snapshot_id]; -%>
+<details>
+<summary>操作后页面状态 (a11y tree 快照 → <code>snapshots/snapshot_<%- block.snapshot_id %>.md</code><%= _snapshotText ? ', ' + _snapshotText.length + ' chars' : '' %>)</summary>
+
+<% if (_snapshotText) { -%>
+```
+<%- _snapshotText %>
+```
+<% } -%>
+
+</details>
+
+<% } -%>
+---
+
+<% }); -%>
+<% if (orphanRequests.length > 0) { -%>
+## 其他网络请求（未关联到操作时间线）
+
+<% orphanRequests.forEach((req) => { -%>
+- **[<%- req.id %>] <%- req.method %> <%- req.url %>** → <%- req.status %><%- req.sizeHint %>
+<% }); -%>
+<% } -%>

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Webhook payload sent by the WebTape Chrome extension (background.js).
+ */
+export interface WebTapePayload {
+    meta: {
+        timestamp: string;
+        epoch: number;
+        version: string;
+        source: string;
+        hostname?: string;
+        /** 插件开始录制（INITIAL 块就绪）的 wall time */
+        recording_started_at_cst?: string;
+        recording_started_at_epoch_ms?: number;
+        /** 插件结束录制（进入导出）的 wall time */
+        recording_ended_at_cst?: string;
+        recording_ended_at_epoch_ms?: number;
+    };
+    content: {
+        'index.json': ContextBlock[];
+        /** context_id → a11y tree text for each post-action snapshot */
+        snapshots?: Record<string, string>;
+        requests: Record<string, RequestEntry>;
+        responses: Record<string, ResponseEntry>;
+    };
+}
+/**
+ * ContextBlock as written to disk: timestamp is converted from unix ms to a
+ * local-timezone ISO string (e.g. "2026-03-20T14:30:45.123+08:00").
+ */
+export type SavedContextBlock = Omit<ContextBlock, 'timestamp'> & {
+    timestamp: string;
+};
+/**
+ * Shape of the index.json file written to disk for each recording session.
+ * meta.json is not written separately; only version (unique to meta) is kept here.
+ * All other meta fields (epoch, timestamp, source, hostname) are derivable from timeline.
+ */
+export interface SavedIndexFile {
+    meta: {
+        version: string;
+        recording_started_at_cst?: string;
+        recording_started_at_epoch_ms?: number;
+        recording_ended_at_cst?: string;
+        recording_ended_at_epoch_ms?: number;
+    };
+    timeline: SavedContextBlock[];
+}
+export interface ContextBlock {
+    context_id: string;
+    timestamp: number;
+    /** Asia/Shanghai (+08:00) instant from the extension, e.g. 2026-03-28T15:30:45.123+08:00 */
+    timestamp_cst?: string;
+    state?: {
+        type: string;
+        url: string;
+        title: string;
+        fav_icon_url: string;
+        a11y_tree_summary: string;
+    };
+    action?: {
+        type: string;
+        target_element: string;
+        tag: string;
+        id: string;
+        aria_label: string;
+    };
+    triggered_network?: NetworkSummary[] | null;
+    /** ID pointing to the post-action a11y snapshot file: snapshots/snapshot_${snapshot_id}.md */
+    snapshot_id?: string | null;
+}
+export interface NetworkSummary {
+    req_id: string;
+    method: string;
+    url: string;
+    status: number | null;
+    type: 'http' | 'sse' | 'websocket';
+    detail_path: {
+        request: string;
+        response: string;
+    };
+    response_body_bytes?: number;
+}
+export interface RequestEntry {
+    req_id: string;
+    /** Asia/Shanghai (+08:00), request start wall time */
+    timestamp_cst?: string;
+    type: 'http' | 'sse' | 'websocket';
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body: string | null;
+}
+export interface ResponseEntry {
+    req_id: string;
+    /** Asia/Shanghai (+08:00), response completion wall time when available */
+    timestamp_cst?: string;
+    type: 'http' | 'sse' | 'websocket';
+    status: number | null;
+    headers: Record<string, string> | null;
+    mime_type?: string;
+    body: string | object | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,qCAAqC;QACrC,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,6BAA6B,CAAC,EAAE,MAAM,CAAC;QACvC,8BAA8B;QAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,2BAA2B,CAAC,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,OAAO,EAAE;QACP,YAAY,EAAE,YAAY,EAAE,CAAC;QAC7B,gEAAgE;QAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;KAC1C,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG;IAChE,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,6BAA6B,CAAC,EAAE,MAAM,CAAC;QACvC,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,2BAA2B,CAAC,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,iBAAiB,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAC5C,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IACnC,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map