@very_aq/codex-cli-web 0.0.1

package/server/dist/history/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebHistoryRuntime = createWebHistoryRuntime;
+/**
+ * 历史模块统一出口：集中导出公共类型与运行时构造器。
+ */
+const historyIngestService_1 = require("./ingest/historyIngestService");
+const historyQueryService_1 = require("./query/historyQueryService");
+const sqliteHistoryStore_1 = require("./sqlite/sqliteHistoryStore");
+/**
+ * 根据配置模式创建历史运行时：
+ * - off: 不创建任何历史资源；
+ * - shadow/primary: 初始化 SQLite store 与 ingest 服务。
+ */
+function createWebHistoryRuntime(options) {
+    if (options.mode === "off")
+        return null;
+    // SQLite store 负责底层读写，ingest 负责事件编排与投影。
+    const store = (0, sqliteHistoryStore_1.createSqliteHistoryStore)({ dbPath: options.dbPath });
+    const ingest = (0, historyIngestService_1.createHistoryIngestService)({ store });
+    const query = (0, historyQueryService_1.createHistoryQueryService)({ store });
+    return {
+        ingest,
+        query,
+        async close() {
+            await ingest.flushAndClose();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/server/dist/history/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":";;AAsCA,0DAeC;AArDD;;GAEG;AACH,wEAA2E;AAC3E,qEAAwE;AACxE,oEAAuE;AA4BvE;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,OAAuC;IAC7E,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAExC,wCAAwC;IACxC,MAAM,KAAK,GAAG,IAAA,6CAAwB,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAA,iDAA0B,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAA,+CAAyB,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAEnD,OAAO;QACL,MAAM;QACN,KAAK;QACL,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/server/dist/history/ingest/historyIngestService.d.ts

@@ -0,0 +1,15 @@
+import type { SqliteHistoryStore } from "../sqlite/sqliteHistoryStore";
+import type { HistoryIngestService } from "../types";
+/**
+ * 创建历史写入服务时的依赖参数。
+ */
+export type CreateHistoryIngestServiceOptions = {
+    store: SqliteHistoryStore;
+    nowMs?: () => number;
+};
+/**
+ * 构造历史写入编排服务：
+ * - 为每条事件分配 thread 内递增 seq；
+ * - 使用事务保证 raw/message/chunk 的原子写入。
+ */
+export declare function createHistoryIngestService(options: CreateHistoryIngestServiceOptions): HistoryIngestService;

package/server/dist/history/ingest/historyIngestService.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHistoryIngestService = createHistoryIngestService;
+const projectCodexEvent_1 = require("../projector/projectCodexEvent");
+/**
+ * 构造历史写入编排服务：
+ * - 为每条事件分配 thread 内递增 seq；
+ * - 使用事务保证 raw/message/chunk 的原子写入。
+ */
+function createHistoryIngestService(options) {
+    const nowMsProvider = options.nowMs ?? (() => Date.now());
+    return {
+        /**
+         * 记录一条 Codex 事件并投影到结构化历史表。
+         */
+        async recordCodexEvent(input) {
+            const nowMs = nowMsProvider();
+            const payload = { method: input.method, params: input.params };
+            options.store.withTransaction(() => {
+                const projected = (0, projectCodexEvent_1.projectCodexEvent)({
+                    threadId: input.threadId,
+                    event: payload,
+                    nowMs,
+                });
+                if (projected.message)
+                    options.store.upsertMessage(projected.message);
+                if (projected.messages?.length) {
+                    for (const message of projected.messages) {
+                        options.store.upsertMessage(message);
+                    }
+                }
+            });
+        },
+        /**
+         * 刷新并关闭写入资源。
+         */
+        async flushAndClose() {
+            options.store.close();
+        },
+    };
+}
+//# sourceMappingURL=historyIngestService.js.map

package/server/dist/history/ingest/historyIngestService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyIngestService.js","sourceRoot":"","sources":["../../../src/history/ingest/historyIngestService.ts"],"names":[],"mappings":";;AAiBA,gEAiCC;AAlDD,sEAAmE;AAYnE;;;;GAIG;AACH,SAAgB,0BAA0B,CAAC,OAA0C;IACnF,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAE1D,OAAO;QACL;;WAEG;QACH,KAAK,CAAC,gBAAgB,CAAC,KAA4B;YACjD,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAsB,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YAElF,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE;gBACjC,MAAM,SAAS,GAAG,IAAA,qCAAiB,EAAC;oBAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,KAAK,EAAE,OAAO;oBACd,KAAK;iBACN,CAAC,CAAC;gBACH,IAAI,SAAS,CAAC,OAAO;oBAAE,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACtE,IAAI,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;oBAC/B,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;wBACzC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;oBACvC,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED;;WAEG;QACH,KAAK,CAAC,aAAa;YACjB,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/server/dist/history/projector/extractIds.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 从事件参数中提取 turnId，兼容 camelCase/snake_case 与嵌套结构。
+ */
+export declare function extractTurnId(params: unknown): string | null;
+/**
+ * 从事件参数中提取 itemId，兼容多种字段路径。
+ */
+export declare function extractItemId(params: unknown): string | null;
+/**
+ * 构造 assistant message 的稳定消息 id。
+ */
+export declare function buildAgentMessageId(turnId: string | null, itemId: string | null): string | null;
+/**
+ * 构造 commandExecution message 的稳定消息 id。
+ */
+export declare function buildCommandExecutionMessageId(turnId: string | null, itemId: string | null): string | null;
+/**
+ * 构造 fileChange message 的稳定消息 id。
+ */
+export declare function buildFileChangeMessageId(turnId: string | null, itemId: string | null): string | null;
+/**
+ * 构造 user message 的稳定消息 id。
+ */
+export declare function buildUserMessageId(turnId: string | null, itemId: string | null): string | null;
+/**
+ * 构造 plan message 的稳定消息 id。
+ */
+export declare function buildPlanMessageId(turnId: string | null, itemId: string | null): string | null;
+/**
+ * 构造 reasoning summary message 的稳定消息 id。
+ */
+export declare function buildReasoningSummaryMessageId(turnId: string | null, itemId: string | null, summaryIndex: number): string | null;
+/**
+ * 构造 user input 审核轨迹消息 id（required / resolved）。
+ */
+export declare function buildUserInputAuditMessageId(threadId: string, requestId: unknown, phase: "required" | "resolved"): string;

package/server/dist/history/projector/extractIds.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTurnId = extractTurnId;
+exports.extractItemId = extractItemId;
+exports.buildAgentMessageId = buildAgentMessageId;
+exports.buildCommandExecutionMessageId = buildCommandExecutionMessageId;
+exports.buildFileChangeMessageId = buildFileChangeMessageId;
+exports.buildUserMessageId = buildUserMessageId;
+exports.buildPlanMessageId = buildPlanMessageId;
+exports.buildReasoningSummaryMessageId = buildReasoningSummaryMessageId;
+exports.buildUserInputAuditMessageId = buildUserInputAuditMessageId;
+/**
+ * 从候选字段中选择第一个非空 id 字符串。
+ */
+function pickFirstNonEmptyId(candidates) {
+    for (const candidate of candidates) {
+        if (candidate === null || candidate === undefined)
+            continue;
+        const normalizedId = String(candidate).trim();
+        if (normalizedId)
+            return normalizedId;
+    }
+    return null;
+}
+/**
+ * 从事件参数中提取 turnId，兼容 camelCase/snake_case 与嵌套结构。
+ */
+function extractTurnId(params) {
+    const payload = params;
+    return pickFirstNonEmptyId([
+        payload?.turnId,
+        payload?.turn_id,
+        payload?.turn?.id,
+        payload?.item?.turnId,
+        payload?.item?.turn_id,
+        payload?.item?.turn?.id,
+    ]);
+}
+/**
+ * 从事件参数中提取 itemId，兼容多种字段路径。
+ */
+function extractItemId(params) {
+    const payload = params;
+    return pickFirstNonEmptyId([
+        payload?.itemId,
+        payload?.item_id,
+        payload?.item?.id,
+        payload?.id,
+    ]);
+}
+/**
+ * 构造 assistant message 的稳定消息 id。
+ */
+function buildAgentMessageId(turnId, itemId) {
+    if (!turnId || !itemId)
+        return null;
+    return `v2:am-${turnId}:${itemId}`;
+}
+/**
+ * 构造 commandExecution message 的稳定消息 id。
+ */
+function buildCommandExecutionMessageId(turnId, itemId) {
+    if (!turnId || !itemId)
+        return null;
+    return `v2:cmd-${turnId}:${itemId}`;
+}
+/**
+ * 构造 fileChange message 的稳定消息 id。
+ */
+function buildFileChangeMessageId(turnId, itemId) {
+    if (!turnId || !itemId)
+        return null;
+    return `v2:fc-${turnId}:${itemId}`;
+}
+/**
+ * 构造 user message 的稳定消息 id。
+ */
+function buildUserMessageId(turnId, itemId) {
+    if (!turnId || !itemId)
+        return null;
+    return `v2:um-${turnId}:${itemId}`;
+}
+/**
+ * 构造 plan message 的稳定消息 id。
+ */
+function buildPlanMessageId(turnId, itemId) {
+    if (!turnId || !itemId)
+        return null;
+    return `v2:plan-${turnId}:${itemId}`;
+}
+/**
+ * 构造 reasoning summary message 的稳定消息 id。
+ */
+function buildReasoningSummaryMessageId(turnId, itemId, summaryIndex) {
+    if (!turnId || !itemId)
+        return null;
+    const normalizedSummaryIndex = Number.isFinite(summaryIndex)
+        ? Math.max(0, Math.floor(summaryIndex))
+        : 0;
+    return `v2:rs-${turnId}:${itemId}:${normalizedSummaryIndex}`;
+}
+/**
+ * 构造 user input 审核轨迹消息 id（required / resolved）。
+ */
+function buildUserInputAuditMessageId(threadId, requestId, phase) {
+    const normalizedThreadId = String(threadId ?? "").trim() || "unknown-thread";
+    const normalizedRequestId = String(requestId ?? "").trim() || "unknown-request";
+    const safeRequestId = normalizedRequestId.replace(/[^a-zA-Z0-9._-]/g, "_");
+    return `v2:uia-${phase}-${normalizedThreadId}:${safeRequestId}`;
+}
+//# sourceMappingURL=extractIds.js.map

package/server/dist/history/projector/extractIds.js.map

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

package/server/dist/history/projector/projectCodexEvent.d.ts

@@ -0,0 +1,27 @@
+import type { UpsertMessageInput } from "../sqlite/sqliteHistoryStore";
+/**
+ * 可投影的 Codex 事件结构。
+ */
+export type ProjectableCodexEvent = {
+    method: string;
+    params: unknown;
+};
+/**
+ * 投影输入参数。
+ */
+export type ProjectCodexEventInput = {
+    threadId: string;
+    event: ProjectableCodexEvent;
+    nowMs: number;
+};
+/**
+ * 投影输出：可选消息更新（已移除 chunk/raw 存储）。
+ */
+export type ProjectCodexEventOutput = {
+    message?: UpsertMessageInput;
+    messages?: UpsertMessageInput[];
+};
+/**
+ * 将 Codex 事件投影为结构化消息与增量片段。
+ */
+export declare function projectCodexEvent(input: ProjectCodexEventInput): ProjectCodexEventOutput;