@very_aq/codex-cli-web 0.0.1

package/server/dist/chat/threadTurnsProjector.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectThreadToChatItems = projectThreadToChatItems;
+exports.projectTurnsToChatItems = projectTurnsToChatItems;
+const attachmentPathRedaction_1 = require("./attachmentPathRedaction");
+const chatItemEnricher_1 = require("./chatItemEnricher");
+const fileChangeExtractor_1 = require("./fileChangeExtractor");
+/**
+ * 将历史 turn 里的完整 diff 收敛为摘要，避免在聊天记录中携带大 patch 内容。
+ */
+function toDiffSummaryChanges(changes) {
+    return changes.map((change) => ({
+        path: change.path,
+        kind: change.kind,
+        diff: "",
+    }));
+}
+/**
+ * 构造 reasoning summary 的稳定消息 id（与实时 chat_ops / SQLite 历史保持一致）。
+ */
+function buildReasoningSummaryMessageId(turnId, itemId, summaryIndex) {
+    const normalizedTurnId = String(turnId ?? "").trim();
+    const normalizedItemId = String(itemId ?? "").trim();
+    const normalizedSummaryIndex = Number.isFinite(summaryIndex) ? Math.max(0, Math.floor(summaryIndex)) : 0;
+    return `v2:rs-${normalizedTurnId}:${normalizedItemId}:${normalizedSummaryIndex}`;
+}
+/**
+ * 把 turns/item 中的 id 归一化为稳定字符串：
+ * - 支持 string/number；
+ * - 其他类型视为缺失，回退到既有的 best-effort id 生成逻辑。
+ */
+function normalizeStableId(rawId) {
+    if (typeof rawId === "string")
+        return rawId.trim();
+    if (typeof rawId === "number" && Number.isFinite(rawId))
+        return String(rawId);
+    return "";
+}
+/**
+ * 将 thread payload 中的 turns 转换为 ChatItem[]（用于 thread_opened 快照）。
+ */
+function projectThreadToChatItems(thread) {
+    const t = thread;
+    const turns = Array.isArray(t?.turns) ? t.turns : [];
+    const turnsStart = Number.isFinite(t?.turnsStart) ? Math.max(0, Math.floor(Number(t.turnsStart))) : 0;
+    const createdAtMs = Number.isFinite(t?.createdAt) ? Number(t.createdAt) * 1000 : Date.now();
+    return projectTurnsToChatItems(turns, { createdAtMs, turnsStart });
+}
+/**
+ * 将 thread turns slice 转换为 ChatItem[]（用于翻页加载旧消息）。
+ */
+function projectTurnsToChatItems(turns, opts) {
+    const out = [];
+    const baseTs = Number.isFinite(opts.createdAtMs) ? opts.createdAtMs : Date.now();
+    const start = Number.isFinite(opts.turnsStart) ? Math.max(0, Math.floor(opts.turnsStart)) : 0;
+    for (let turnIdx = 0; turnIdx < turns.length; turnIdx += 1) {
+        const turn = turns[turnIdx];
+        const stableTurnId = normalizeStableId(turn?.id);
+        const turnId = stableTurnId || `turn-${start + turnIdx}`;
+        const items = Array.isArray(turn?.items) ? turn.items : [];
+        const turnTsBase = baseTs + (start + turnIdx) * 1000;
+        for (let itemIdx = 0; itemIdx < items.length; itemIdx += 1) {
+            const item = items[itemIdx];
+            const changes = (0, fileChangeExtractor_1.extractFileChangesFromAny)(item);
+            const role = roleFromTurnItem(item);
+            const effectiveRole = role ?? (changes.length ? "system" : null);
+            if (!effectiveRole)
+                continue;
+            if (changes.length) {
+                const stableItemId = normalizeStableId(item?.id);
+                const itemId = stableItemId || `${role}-${out.length}`;
+                const title = "文件变更";
+                const summaryChanges = toDiffSummaryChanges(changes);
+                out.push((0, chatItemEnricher_1.enrichChatItemForUi)({
+                    id: `${turnId}:${itemId}`,
+                    ts: turnTsBase + itemIdx,
+                    role: effectiveRole === "assistant" ? "system" : effectiveRole,
+                    text: title,
+                    render: "diff",
+                    diff: { title, changes: summaryChanges },
+                }));
+                continue;
+            }
+            // reasoning summary 在 SQLite 历史中会按 summaryIndex 拆分为多条记录；
+            // turns 投影也需要使用相同 v2 id，否则前端合并历史时会产生重复卡片。
+            if (effectiveRole === "reasoning") {
+                const summaryItems = Array.isArray(item?.summary) ? item.summary : [];
+                const itemId = normalizeStableId(item?.id);
+                if (summaryItems.length && itemId) {
+                    for (let summaryIndex = 0; summaryIndex < summaryItems.length; summaryIndex += 1) {
+                        const summaryText = String(summaryItems[summaryIndex] ?? "").trim();
+                        if (!summaryText)
+                            continue;
+                        out.push((0, chatItemEnricher_1.enrichChatItemForUi)({
+                            id: buildReasoningSummaryMessageId(turnId, itemId, summaryIndex),
+                            // turns 的 ts 仅用于排序；这里用极小增量确保每条 summary 在同一 item 内保持稳定顺序。
+                            ts: turnTsBase + itemIdx + summaryIndex / 1000,
+                            role: "reasoning",
+                            text: summaryText,
+                        }));
+                    }
+                    continue;
+                }
+            }
+            const text = extractTurnItemText(item);
+            if (!text)
+                continue;
+            const displayText = effectiveRole === "user" ? (0, attachmentPathRedaction_1.redactAttachmentPathsForDisplay)(text) : text;
+            const stableItemId = normalizeStableId(item?.id);
+            const itemId = stableItemId || `${role}-${out.length}`;
+            const render = typeof item?.command === "string" ? "terminal" : undefined;
+            const itemType = typeof item?.type === "string" ? String(item.type).toLowerCase() : "";
+            const id = itemType.includes("plan") ? `v2:plan-${turnId}:${itemId}` : `${turnId}:${itemId}`;
+            out.push((0, chatItemEnricher_1.enrichChatItemForUi)({
+                id,
+                ts: turnTsBase + itemIdx,
+                role: effectiveRole,
+                text: displayText,
+                render,
+                deliveryStatus: effectiveRole === "user" ? "sent" : undefined,
+            }));
+        }
+    }
+    return out;
+}
+/**
+ * 从 turn item 推导其角色（兼容 `role` 字段与 `type` 字段）。
+ */
+function roleFromTurnItem(item) {
+    const it = item;
+    const role = typeof it?.role === "string" ? it.role.toLowerCase() : "";
+    if (role === "user" || role === "assistant" || role === "system" || role === "reasoning")
+        return role;
+    const t = it?.type;
+    if (typeof t !== "string")
+        return null;
+    const normalized = t.toLowerCase();
+    if (normalized.includes("user"))
+        return "user";
+    if (normalized.includes("system"))
+        return "system";
+    if (normalized.includes("reasoning"))
+        return "reasoning";
+    if (normalized.includes("assistant") || normalized.includes("agent"))
+        return "assistant";
+    if (normalized.includes("plan"))
+        return "assistant";
+    return null;
+}
+/**
+ * 将历史 plan step 的状态值归一化为 Web 侧统一状态。
+ */
+function normalizeStructuredPlanStepStatus(rawStatus) {
+    if (typeof rawStatus !== "string")
+        return null;
+    const normalized = rawStatus
+        .trim()
+        .replace(/([a-z])([A-Z])/g, "$1_$2")
+        .toLowerCase()
+        .replace(/[\s-]+/g, "_");
+    if (!normalized)
+        return null;
+    if (normalized === "pending")
+        return "pending";
+    if (normalized === "completed" || normalized === "done")
+        return "completed";
+    if (normalized === "in_progress" || normalized === "inprogress" || normalized === "doing")
+        return "in_progress";
+    return null;
+}
+/**
+ * 从结构化 step 对象中抽取可展示的文本。
+ */
+function extractStructuredPlanStepText(rawStep) {
+    if (typeof rawStep === "string")
+        return rawStep.trim();
+    if (!rawStep || typeof rawStep !== "object")
+        return "";
+    const step = rawStep;
+    const candidates = [step.step, step.text, step.title, step.description, step.name, step.task, step.label];
+    for (const candidate of candidates) {
+        if (typeof candidate !== "string")
+            continue;
+        const normalizedText = candidate.trim();
+        if (normalizedText)
+            return normalizedText;
+    }
+    return "";
+}
+/**
+ * 从结构化 plan item 中提取步骤数组（兼容 plan/steps/items 字段）。
+ */
+function extractStructuredPlanSteps(item) {
+    const stepSources = [item.plan, item.steps, item.items];
+    const parsedSteps = [];
+    for (const rawSource of stepSources) {
+        if (!Array.isArray(rawSource))
+            continue;
+        for (const rawStep of rawSource) {
+            const stepText = extractStructuredPlanStepText(rawStep);
+            if (!stepText)
+                continue;
+            const stepRecord = rawStep && typeof rawStep === "object" ? rawStep : {};
+            const statusFromStatusField = normalizeStructuredPlanStepStatus(stepRecord.status);
+            const statusFromStateField = normalizeStructuredPlanStepStatus(stepRecord.state);
+            const completedFlag = typeof stepRecord.completed === "boolean" ? stepRecord.completed : null;
+            const inProgressFlag = typeof stepRecord.inProgress === "boolean" ? stepRecord.inProgress : null;
+            const inProgressSnakeFlag = typeof stepRecord.in_progress === "boolean" ? stepRecord.in_progress : null;
+            const status = statusFromStatusField ??
+                statusFromStateField ??
+                (inProgressFlag || inProgressSnakeFlag ? "in_progress" : null) ??
+                (completedFlag === null ? null : completedFlag ? "completed" : "pending") ??
+                "pending";
+            parsedSteps.push({ status, step: stepText });
+        }
+        if (parsedSteps.length)
+            return parsedSteps;
+    }
+    return parsedSteps;
+}
+/**
+ * 当历史 plan item 缺少 `text` 时，将结构化字段拼成可复用的文本计划。
+ */
+function extractStructuredPlanText(item) {
+    const explanationFromField = typeof item.explanation === "string" ? item.explanation.trim() : "";
+    const summaryFromArray = Array.isArray(item.summary)
+        ? item.summary.map((value) => String(value ?? "").trim()).filter(Boolean).join("\n")
+        : "";
+    const explanation = explanationFromField || summaryFromArray;
+    const steps = extractStructuredPlanSteps(item);
+    if (!steps.length)
+        return explanation;
+    const stepLines = steps.map((step) => `- (${step.status}) ${step.step}`);
+    if (!explanation)
+        return stepLines.join("\n");
+    return `${explanation}\n${stepLines.join("\n")}`.trim();
+}
+/**
+ * 从 turn item 中抽取可展示的 text（兼容多种字段与结构化 plan）。
+ */
+function extractTurnItemText(item) {
+    const it = item;
+    const itemType = typeof it?.type === "string" ? String(it.type).toLowerCase() : "";
+    if (typeof it?.text === "string")
+        return it.text;
+    if (typeof it?.message === "string")
+        return it.message;
+    if (itemType.includes("plan")) {
+        const structuredPlanText = extractStructuredPlanText(it);
+        if (structuredPlanText)
+            return structuredPlanText;
+    }
+    if (Array.isArray(it?.summary) && it.summary.length) {
+        return it.summary.map(String).filter(Boolean).join("\n").trim();
+    }
+    if (typeof it?.command === "string") {
+        const aggregated = typeof it?.aggregatedOutput === "string" ? it.aggregatedOutput : "";
+        const exit = typeof it?.exitCode === "number" ? `exitCode=${it.exitCode}` : "";
+        const header = `command: ${it.command}${exit ? ` (${exit})` : ""}`;
+        if (aggregated && aggregated.trim())
+            return `${header}\n\n${aggregated}`.trim();
+        return header;
+    }
+    const content = Array.isArray(it?.content)
+        ? it.content
+        : Array.isArray(it?.contentItems)
+            ? it.contentItems
+            : null;
+    if (content) {
+        const parts = content
+            .map((p) => extractTextPart(p))
+            .filter((s) => Boolean(s && s.trim()));
+        return parts.join("\n").trim();
+    }
+    return "";
+}
+/**
+ * 从 content item 中提取文本字段。
+ */
+function extractTextPart(part) {
+    const p = part;
+    if (!p)
+        return null;
+    if (typeof p === "string")
+        return p;
+    if (typeof p?.text === "string")
+        return p.text;
+    if (typeof p?.value === "string")
+        return p.value;
+    return null;
+}
+//# sourceMappingURL=threadTurnsProjector.js.map

package/server/dist/chat/threadTurnsProjector.js.map

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

package/server/dist/chat/todoPlanProjector.d.ts

@@ -0,0 +1,8 @@
+import type { TodoPlanUpdate } from "./todoPlanTypes";
+/**
+ * 解析 Codex 通知 payload（{method, params}），提取 TODO/Checklist 更新。
+ *
+ * 支持来源：
+ * - app-server v2：`turn/plan/updated`
+ */
+export declare function extractTodoPlanUpdateFromCodexPayload(payload: unknown): TodoPlanUpdate | null;

package/server/dist/chat/todoPlanProjector.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTodoPlanUpdateFromCodexPayload = extractTodoPlanUpdateFromCodexPayload;
+/**
+ * 判断值是否为普通对象，避免把 `null`/数组误判为可索引对象。
+ */
+function isPlainRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+/**
+ * 归一化 threadId/turnId：空值返回 `null`。
+ */
+function normalizeId(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
+/**
+ * 归一化 explanation：空白字符串返回 `null`。
+ */
+function normalizeExplanation(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
+/**
+ * 将不同协议里的 step status 统一映射为 Web 内部的 snake_case。
+ */
+function normalizeTodoPlanStepStatus(value) {
+    if (typeof value !== "string")
+        return null;
+    const raw = value.trim();
+    if (!raw)
+        return null;
+    // app-server v2 使用 `inProgress`；v1/工具参数使用 `in_progress`。
+    if (raw === "inProgress")
+        return "in_progress";
+    const lower = raw.toLowerCase();
+    if (lower === "pending")
+        return "pending";
+    if (lower === "completed")
+        return "completed";
+    if (lower === "in_progress" || lower === "inprogress")
+        return "in_progress";
+    return null;
+}
+/**
+ * 将未知结构的 plan 数组解析为 `TodoPlanStep[]`，并过滤非法条目。
+ */
+function normalizeTodoPlanSteps(value) {
+    const steps = Array.isArray(value) ? value : [];
+    const out = [];
+    for (const stepItem of steps) {
+        if (!isPlainRecord(stepItem))
+            continue;
+        const stepText = typeof stepItem.step === "string" ? stepItem.step.trim() : "";
+        if (!stepText)
+            continue;
+        const status = normalizeTodoPlanStepStatus(stepItem.status);
+        if (!status)
+            continue;
+        out.push({ status, step: stepText });
+    }
+    return out;
+}
+/**
+ * 解析 Codex 通知 payload（{method, params}），提取 TODO/Checklist 更新。
+ *
+ * 支持来源：
+ * - app-server v2：`turn/plan/updated`
+ */
+function extractTodoPlanUpdateFromCodexPayload(payload) {
+    if (!isPlainRecord(payload))
+        return null;
+    const method = typeof payload.method === "string" ? payload.method : "";
+    const params = payload.params;
+    if (method === "turn/plan/updated") {
+        if (!isPlainRecord(params))
+            return null;
+        const threadId = normalizeId(params.threadId ?? params.thread_id);
+        if (!threadId)
+            return null;
+        const turnId = normalizeId(params.turnId ?? params.turn_id);
+        const explanation = normalizeExplanation(params.explanation);
+        const plan = normalizeTodoPlanSteps(params.plan);
+        return { threadId, turnId, explanation, plan };
+    }
+    return null;
+}
+//# sourceMappingURL=todoPlanProjector.js.map

package/server/dist/chat/todoPlanProjector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todoPlanProjector.js","sourceRoot":"","sources":["../../src/chat/todoPlanProjector.ts"],"names":[],"mappings":";;AAyEA,sFAiBC;AAtFD;;GAEG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,2BAA2B,CAAC,KAAc;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,yDAAyD;IACzD,IAAI,GAAG,KAAK,YAAY;QAAE,OAAO,aAAa,CAAC;IAE/C,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IAC9C,IAAI,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,YAAY;QAAE,OAAO,aAAa,CAAC;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,KAAc;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,GAAG,GAAmB,EAAE,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvC,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,MAAM,GAAG,2BAA2B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qCAAqC,CAAC,OAAgB;IACpE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,MAAM,KAAK,mBAAmB,EAAE,CAAC;QACnC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/server/dist/chat/todoPlanTypes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Codex CLI 的 TODO/Checklist（由 `turn/plan/updated` 等事件驱动）。
+ * 说明：状态统一收敛为 snake_case，便于前端样式与统计。
+ */
+export type TodoPlanStepStatus = "pending" | "in_progress" | "completed";
+/**
+ * TODO/Checklist 的单步条目。
+ */
+export type TodoPlanStep = {
+    status: TodoPlanStepStatus;
+    step: string;
+};
+/**
+ * WS 事件解析后的 TODO 更新载荷（用于上报到 App 状态）。
+ */
+export type TodoPlanUpdate = {
+    threadId: string;
+    turnId: string | null;
+    explanation: string | null;
+    plan: TodoPlanStep[];
+};

package/server/dist/chat/todoPlanTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=todoPlanTypes.js.map

package/server/dist/chat/todoPlanTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todoPlanTypes.js","sourceRoot":"","sources":["../../src/chat/todoPlanTypes.ts"],"names":[],"mappings":""}

package/server/dist/chat/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * WS/HTTP 层下发给 Web UI 的聊天消息角色值。
+ */
+export type ChatRole = "user" | "assistant" | "system" | "reasoning";
+/**
+ * Web UI 渲染类型：用于切换 terminal/diff/approval 等卡片样式。
+ */
+export type ChatRender = "text" | "terminal" | "diff" | "approval";
+/**
+ * 文本指标：用于前端折叠阈值与高度估算。
+ */
+export type TextMetrics = {
+    lines: number;
+    chars: number;
+};
+/**
+ * 后端解析后的 Markdown AST（HAST 精简版，可 JSON 序列化）。
+ *
+ * 说明：
+ * - 前端不再解析 Markdown 字符串；
+ * - 前端仅负责把 AST 渲染为 React 节点。
+ */
+export type UiMarkdownAst = {
+    type: "root" | "element" | "text";
+    tagName?: string;
+    properties?: Record<string, unknown>;
+    children?: UiMarkdownAst[];
+    value?: string;
+};
+/**
+ * CLI 风格 system 工具调用摘要里的“阶段”节点。
+ */
+export type SystemToolCallStage = {
+    title: string;
+    steps: string[];
+};
+/**
+ * 解析后的 system 工具调用摘要结构。
+ */
+export type SystemToolCallSummary = {
+    stages: SystemToolCallStage[];
+    statusLines: string[];
+};
+/**
+ * 单条文件变更记录（diff 渲染的最小单元）。
+ */
+export type FileChange = {
+    path: string;
+    kind: string;
+    diff: string;
+};
+/**
+ * 文件变更渲染数据（包含变更列表与可选工具输出）。
+ */
+export type DiffData = {
+    title: string;
+    changes: FileChange[];
+    output?: string;
+};
+/**
+ * 消息投递状态：用于本地乐观消息展示。
+ */
+export type MessageDeliveryStatus = "pending" | "sent" | "failed";
+/**
+ * Web UI 的单条聊天消息结构（用于渲染与历史合并）。
+ */
+export type ChatItem = {
+    id: string;
+    ts: number;
+    role: ChatRole;
+    text: string;
+    /**
+     * plainText：用于复制/折叠预览的“纯文本”（terminal 会做转义与擦除序列归一化）。
+     */
+    plainText?: string;
+    /**
+     * metrics：文本指标；优先由后端/增量合并逻辑维护，避免前端重复扫描大字符串。
+     */
+    metrics?: TextMetrics;
+    clientMessageId?: string;
+    deliveryStatus?: MessageDeliveryStatus;
+    deliveryError?: string;
+    streaming?: boolean;
+    render?: ChatRender;
+    diff?: DiffData;
+    /**
+     * markdownAst：后端解析后的 Markdown AST（仅对 text 渲染场景生效）。
+     */
+    markdownAst?: UiMarkdownAst | null;
+    /**
+     * systemToolCallSummary：后端解析后的 system 工具调用摘要（仅对 system/text 生效）。
+     */
+    systemToolCallSummary?: SystemToolCallSummary | null;
+};
+/**
+ * ChatItem 的补丁结构：仅覆盖需要变更的字段。
+ */
+export type ChatItemPatch = {
+    text?: string;
+    plainText?: string;
+    metrics?: TextMetrics;
+    render?: ChatRender;
+    diff?: DiffData;
+    markdownAst?: UiMarkdownAst | null;
+    systemToolCallSummary?: SystemToolCallSummary | null;
+};
+/**
+ * 后端投影后的增量操作；前端只需要按 op 合并并渲染即可。
+ */
+export type ChatOp = {
+    op: "upsert";
+    item: ChatItem;
+    preserveTs?: boolean;
+} | {
+    op: "text_delta";
+    id: string;
+    ts: number;
+    role: ChatRole;
+    delta: string;
+    render?: ChatRender;
+} | {
+    op: "diff_output_delta";
+    id: string;
+    ts: number;
+    delta: string;
+} | {
+    op: "finalize";
+    id: string;
+    ts: number;
+    patch?: ChatItemPatch;
+} | {
+    op: "mark_all_streaming_done";
+    ts: number;
+} | {
+    op: "mark_streaming_done_by_prefix";
+    ts: number;
+    prefix: string;
+};

package/server/dist/chat/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/server/dist/chat/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/chat/types.ts"],"names":[],"mappings":""}

package/server/dist/cli/configArg.d.ts

@@ -0,0 +1,21 @@
+/**
+ * config 启动参数解析结果。
+ * Parsed result for config startup argument.
+ */
+export type ConfigArgParseResult = {
+    /**
+     * 解析出的配置值；未传入时为 null。
+     * Parsed config value; null when not provided.
+     */
+    configValue: string | null;
+};
+/**
+ * 从 argv 中解析 `--config` / `---config` 参数。
+ * Parse `--config` / `---config` from argv.
+ */
+export declare function parseConfigArgFromArgv(argv: string[]): ConfigArgParseResult;
+/**
+ * 将 argv 中的 config 参数同步到环境变量 `CODEX_CONFIG`。
+ * Sync parsed config arg into env var `CODEX_CONFIG`.
+ */
+export declare function applyConfigArgToEnv(argv: string[], env?: NodeJS.ProcessEnv): void;