@ai-setting/roy-agent-core 1.7.70 → 1.7.72

package/dist/env/session/__bench__/run-replay.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview 回放测试 runner (Task #4933)
+ *
+ * 建一个**最小但真实**的 Environment（只含 config/llm/agent/prompt 组件），
+ * 然后对本仓库的真实 session 做回放压缩。
+ *
+ * 用法：
+ *   cd <worktree>
+ *   bun run packages/core/src/env/session/__bench__/run-replay.ts \
+ *     --session <sessionId> [--limit N]
+ *
+ * 也可以一次跑多个：
+ *   bun run .../run-replay.ts --sessions id1,id2,id3 --limit 800
+ */
+export {};

package/dist/env/session/compact-checkpoint-content.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview C 方案 checkpoint 内容处理（Task #4933 重写）
+ *
+ * 用户决策（飞书群 oc_4afcc8f93c811e5371dd00674d16a6b1）：
+ *   压缩最终产物是**整段自然语言** checkpoint 正文（`content`），
+ *   不再有 summary/processKeyPoints/currentState/nextSteps/userIntents 五栏位，
+ *   也不再有固定 markdown 小节契约 + 章节解析器（上一轮方案被用户否定）。
+ *
+ * 本模块是**纯函数**集合：
+ *   1. normalizeCheckpointContent — 守护：只判「有没有实质文本」
+ *   2. buildCheckpointFromText    — LLM 自然语言输出 → { title, content }
+ *   3. adaptLegacyCheckpoint      — 旧格式（五栏位）读时适配 → 新格式
+ *   4. createCheckpointContent    — checkpoint 消息正文渲染
+ *
+ * 设计原则：
+ *   - 守护逻辑极简但必须保留：全空 → 拒绝归档（2026-10-16 生产事故，
+ *     曾静默吞掉 4731 条消息，绝对不能回归）
+ *   - 旧 checkpoint 的语义完整保留（读时适配，不写回数据库）
+ */
+import type { SessionCheckpoint } from "./types";
+/**
+ * 判断一段文本是否可作为 checkpoint 正文。
+ *
+ * 守护规则（极简）：
+ *   - 非空（trim 后有内容）
+ *   - 不是降级哨兵
+ *   - 长度 ≥ MIN_CONTENT_LENGTH
+ *
+ * @returns 归一化（trim）后的正文，不可用返回 undefined
+ */
+export declare function normalizeCheckpointContent(text?: string | null): string | undefined;
+export interface CheckpointFromText {
+    title: string;
+    content: string;
+}
+/**
+ * 把 LLM 输出的整段自然语言构造成 checkpoint 的 title + content。
+ *
+ * 标题策略：首个 markdown 标题行（`#`~`######`）→ 否则首个非空行；
+ * 超长截断到 80 字符。正文整段保留（含列表、代码块等自由形式）。
+ *
+ * @returns { title, content }，文本不可用返回 undefined
+ */
+export declare function buildCheckpointFromText(text?: string | null): CheckpointFromText | undefined;
+/**
+ * 把旧格式 checkpoint（summary/processKeyPoints/currentState/nextSteps/
+ * userIntents 五栏位）在**内存中**适配为新格式（content 整段自然语言）。
+ *
+ * ⚠️ 只做读时适配：不写回数据库、不修改原对象（纯函数）。
+ *    生产库 555 个存量 checkpoint 全是旧格式，靠本函数在读取时
+ *    合成 content，新代码无感知。
+ *
+ * 合成策略：title + summary + 各栏位编号串联，语义完整保留。
+ * 新格式原样返回（引用相等）。
+ */
+export declare function adaptLegacyCheckpoint(cp: SessionCheckpoint): SessionCheckpoint;
+/**
+ * 渲染 checkpoint 消息正文（存为 user 消息，进入 LLM 上下文）。
+ *
+ * 形态（无伪造小节标题）：
+ *   # Checkpoint: {title}
+ *
+ *   {整段 content}
+ *
+ *   {N} messages compacted at {ISO}
+ */
+export declare function createCheckpointContent(checkpoint: SessionCheckpoint): string;

package/dist/env/session/index.d.ts

@@ -10,6 +10,7 @@ SessionCheckpointsMeta, // (new)
 CreateSessionOptions, UpdateSessionOptions, ListSessionsOptions, AddMessageOptions, CompactOptions, // (new)
 CompactResult, // (new)
 CompactPreview, // (new)
+CheckpointAdaptReport, // Task #4933
 GetContextOptions, // (new)
 GetContextResult, // (new)
 GetMessagesOptions, } from "./types";

package/dist/env/session/index.js

@@ -3,11 +3,10 @@ import {
   MIN_SESSION_ID_LENGTH,
   SessionComponent,
   isValidSessionId
-} from "../../shared/@ai-setting/roy-agent-core-9bshyqjn.js";
+} from "../../shared/@ai-setting/roy-agent-core-pakhchy7.js";
 import {
   MemorySessionStore
-} from "../../shared/@ai-setting/roy-agent-core-hy3zn2q2.js";
-import"../../shared/@ai-setting/roy-agent-core-ze068vc9.js";
+} from "../../shared/@ai-setting/roy-agent-core-sm0sf6sb.js";
 import"../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
 import {
   SessionMessageConverter

package/dist/env/session/session-component.d.ts

@@ -8,6 +8,7 @@ import { type SessionConfig, type Session, type CreateSessionOptions, type Updat
 type CompactOptions, // (new)
 type CompactResult, // (new)
 type CompactPreview, // (new)
+type CheckpointAdaptReport, // Task #4933
 type GetContextOptions, // (new)
 type GetContextResult, // (new)
 type SearchMessagesOptions, // (new)
@@ -15,11 +16,11 @@ type SearchResult, // (new)
 type ChatTaskBinding, // Task #4023
 type UpsertChatTaskBindingOptions } from "./types";
 import type { ConfigComponent } from "../../config/config-component";
-import type { SummaryAgentResult } from "../agent/types";
 export type { SessionConfig, Session, SessionMessage, CreateSessionOptions, UpdateSessionOptions, ListSessionsOptions, AddMessageOptions, SessionCheckpoint, // (new)
 CompactOptions, // (new)
 CompactResult, // (new)
 CompactPreview, // (new)
+CheckpointAdaptReport, // Task #4933
 GetContextOptions, // (new)
 GetContextResult, // (new)
 SearchMessagesOptions, // (new) Search
@@ -27,35 +28,6 @@ SearchResult, // (new) Search
 MessageMatch, // (new) Search
 ChatTaskBinding, // Task #4023
 UpsertChatTaskBindingOptions, } from "./types";
-/**
- * 把 compact agent 通过 `workflow_submit_output` 提交的数据归一化。
- */
-export declare function normalizeAgentCheckpoint(data: Record<string, unknown>): SummaryAgentResult;
-/**
- * 判断一段文本是否可作为 checkpoint 正文（拒绝空白与降级哨兵）。
- */
-export declare function isUsableCheckpointText(text?: string | null): boolean;
-/**
- * 降级路径：compact agent 没有调用 `workflow_submit_output` 时，用它输出的
- * 纯文本 `finalText` 兜底构造 checkpoint。
- *
- * 为什么需要（2026-10-16 生产事故 traceId=83eadac2316d5be7529ca42ce7057d63）：
- *   compact 是子 agent。首轮若没调提交工具，`checkpointData` 就是 undefined，
- *   旧代码会写出全空 checkpoint（`"Untitled Checkpoint"`）**然后照样归档几百条消息**
- *   （实测生产 9 次 / 累计吞掉 4731 条 / 单次最多 2710 条）→ 上下文永久丢失且用户无感知。
- *
- *   而实际上模型往往已经产出了可用的 checkpoint 内容，只是以纯文本形式落在
- *   `finalText` 里（例：`"## 📌 Checkpoint: lark-cli profile 配置 ..."`），
- *   或者包在 ```json 代码块里。这些内容全部可以救回来。
- *
- * 策略：
- *   1. 先从文本里抠 JSON（```json 代码块 / 裸 JSON / 第一个 {...}）→ 结构化解析；
- *   2. 否则把整段文本作为 `currentState`，title 取首个 markdown 标题行（或首行）；
- *   3. 文本为空 / 是降级哨兵 → 返回 undefined（调用方继续降级或抛错）
- *
- * @returns 归一化后的 checkpoint，或 undefined（无可用文本）
- */
-export declare function buildCheckpointFromFinalText(finalText?: string): SummaryAgentResult | undefined;
 /**
  * Marker error class so callers can distinguish "lock exhausted after
  * retries" from "validation rejected on first attempt". Previously both
@@ -345,6 +317,19 @@ export declare class SessionComponent extends BaseComponent {
     private executeBeforeHooks;
     private executeAfterHooks;
     private generateTitle;
+    /**
+     * 读取压缩专用模型（`session.compactModel`）。
+     *
+     * ★ Task #4933：两阶段压缩（compact-hint / compact）统一走该模型。
+     *   实现方式：读配置后作为 `AgentContext.model`（run option）传入，
+     *   run option 在 agent-component.ts:1518
+     *   `model: (context?.model) ?? agent.config.model` 处优先级最高，
+     *   因此**会覆盖**用户级 `~/.local/share/roy-agent/agents/compact.yaml`
+     *   里写死的 model 字段。
+     *
+     * @returns 模型 id（如 `minimax/MiniMax-M3.1-Flash`），未配置返回 undefined
+     */
+    private getCompactModel;
     /**
      * 生成场景化压缩提示 (Compact Hint)
      *
@@ -408,12 +393,44 @@ export declare class SessionComponent extends BaseComponent {
     previewCompact(sessionId: string): Promise<CompactPreview>;
     /**
      * Get all checkpoints for a session
+     *
+     * ★ C 方案：旧格式（五栏位）读时适配为新格式（content），
+     *   不写回数据库（lazy adapter）。
      */
     getCheckpoints(sessionId: string): Promise<SessionCheckpoint[]>;
     /**
      * Get a specific checkpoint
+     *
+     * ★ C 方案：旧格式读时适配（见 getCheckpoints）。
      */
     getCheckpoint(sessionId: string, checkpointId: string): Promise<SessionCheckpoint | undefined>;
+    /**
+     * 读取 checkpoint 的**原始存储形态**（不做适配）。
+     *
+     * 用途：存量 checkpoint 检查脚本 / adaptStoredCheckpoints 内部统计 ——
+     * 需要区分「库里到底存的是旧格式还是新格式」。
+     */
+    readStoredCheckpointsRaw(sessionId: string): Promise<SessionCheckpoint[]>;
+    /**
+     * 存量 checkpoint 适配（C 方案 Task #4933）。
+     *
+     * 生产库有 555 个旧格式 checkpoint（五栏位，无 content）。默认**读时适配**
+     * 已能让新代码无感知；本方法提供**显式迁移**能力（把旧格式写回新格式）。
+     *
+     * ⚠️ 默认 dry-run（`apply: false`）：只统计 + 抽样，不写数据库。
+     * ⚠️ `apply: true` 会重写 session.metadata —— 如果 roy-agent daemon 正在运行
+     *    并持有 sessions.db 的内存缓存，外部进程的写入可能被 daemon 的后续
+     *    saveCheckpoint 覆盖。建议在 daemon 重启后（或停机时）执行。
+     */
+    adaptStoredCheckpoints(sessionId: string, options?: {
+        apply?: boolean;
+    }): Promise<CheckpointAdaptReport>;
+    /**
+     * 把一组 checkpoint 整体写回 session.metadata.checkpointDetails。
+     *
+     * 只做「按 id 覆盖」，不动 checkpoints 索引里的 meta（id/title/createdAt 不变）。
+     */
+    private writeCheckpointsBack;
     /**
      * Delete a checkpoint and restore archived messages
      */

package/dist/env/session/storage/index.js

@@ -3,7 +3,7 @@ import {
   SQLiteSessionStore,
   getDefaultDataDir,
   getDefaultSessionDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-hy3zn2q2.js";
+} from "../../../shared/@ai-setting/roy-agent-core-sm0sf6sb.js";
 import"../../../shared/@ai-setting/roy-agent-core-kmbct9yg.js";
 import"../../../shared/@ai-setting/roy-agent-core-40rv283c.js";
 import"../../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";

package/dist/env/session/storage/sqlite.d.ts

@@ -92,6 +92,14 @@ export declare class SQLiteSessionStore extends BaseSessionStore {
     getMessageIndexes(sessionId: string, role: string): Promise<number[]>;
     saveCheckpoint(sessionId: string, checkpoint: SessionCheckpoint): Promise<void>;
     getCheckpoints(sessionId: string): Promise<SessionCheckpoint[]>;
+    /**
+     * 按 id 覆盖写回一组 checkpoint 明细（Task #4933 存量格式迁移用）。
+     *
+     * 只改 `metadata.checkpointDetails`，不动 `metadata.checkpoints` 索引
+     * （id / title / messageIndex / createdAt 都是不变的元数据）。
+     * 返回是否有任何变更被写入。
+     */
+    replaceCheckpointDetails(sessionId: string, checkpoints: SessionCheckpoint[]): Promise<boolean>;
     getCheckpoint(sessionId: string, checkpointId: string): Promise<SessionCheckpoint | undefined>;
     deleteCheckpoint(sessionId: string, checkpointId: string): Promise<boolean>;
     archiveMessages(sessionId: string, checkpointId: string, beforeIndex: number): Promise<number>;

package/dist/env/session/types.d.ts

@@ -83,10 +83,6 @@ export interface CheckpointMeta {
     createdAt: number;
     type: CheckpointType;
 }
-/**
- * User Intent type - represents a user's intent extracted from conversation
- */
-export type UserIntent = string;
 /**
  * Recent message for checkpoint
  *
@@ -100,14 +96,18 @@ export interface RecentMessage {
  * Complete checkpoint information (includes generated content)
  */
 export interface SessionCheckpoint extends CheckpointMeta {
-    summary: string;
-    processKeyPoints: string[];
-    currentState: string;
-    nextSteps: string[];
+    /**
+     * ★ C 方案（Task #4933 重写）：整段自然语言 checkpoint 正文。
+     *
+     * 用户决策：压缩产物不再结构化 —— 没有 summary /
+     * processKeyPoints / currentState / nextSteps / userIntents 五栏位，
+     * 也没有固定 markdown 小节契约。正文形式自由（段落/列表/代码块都行）。
+     *
+     * 旧格式存量数据（生产 555 个）由 adaptLegacyCheckpoint()
+     * 在读取时合成 content，不写回数据库。
+     */
+    content: string;
     messageCountBefore: number;
-    metadata?: Record<string, unknown>;
-    /** User intents extracted from the conversation */
-    userIntents: UserIntent[];
     /**
      * Recent messages preserved from the compacted conversation
      *
@@ -378,16 +378,10 @@ export interface CheckpointPart {
     type: "checkpoint";
     /** Checkpoint ID reference */
     checkpointId: string;
-    /** Markdown content summarizing the checkpoint */
+    /** Checkpoint content (整段自然语言正文) */
     content: string;
     /** Title of the checkpoint */
     title?: string;
-    /** Process key points */
-    processKeyPoints?: string[];
-    /** Current state description */
-    currentState?: string;
-    /** Next steps */
-    nextSteps?: string[];
     /** Number of messages that were compacted */
     messageCountBefore?: number;
     /** Creation timestamp */
@@ -515,30 +509,27 @@ export interface AddMessageOptions {
 }
 /**
  * Options for compact operation
+ *
+ * ★ Task #4933（C 方案）：只剩 `scenarioHint` 一个语义字段。
+ *   旧的 processKeyPoints / currentState / nextSteps 三栏位 hint 已删除
+ *   （它们是「五栏位结构化」时代的遗留 —— C 方案下压缩产物是整段自然语言，
+ *   用户/CLI 再拼装结构化栏位没有意义，且会让后续开发者误以为五栏位仍是契约）。
+ *   `summary` 同样未在 compact() 中被读取（HEAD 之前即如此），一并移除。
  */
 export interface CompactOptions {
-    /** User-provided summary hint for checkpoint generation */
-    summary?: string;
-    /** User-provided process key points hint */
-    processKeyPoints?: string[];
-    /** User-provided current state hint */
-    currentState?: string;
-    /** User-provided next steps hint */
-    nextSteps?: string[];
     /** Whether this is auto-triggered compact */
     auto?: boolean;
     /**
      * Scenario hint for guiding checkpoint generation
      *
      * A natural language description that provides context about the current scenario.
-     * This helps the SummaryAgent generate more relevant checkpoints based on the specific
-     * situation. Examples:
+     * This helps the checkpoint generator produce more relevant content based on the
+     * specific situation. Examples:
      * - "Task execution in progress: implementing feature X, current working directory is /path/to/project"
      * - "Bug investigation: analyzing crash dump, current hypothesis is memory corruption"
      * - "Code review session: reviewing PR #123, focus on security implications"
      *
-     * When provided, this will be prepended to the system prompt to guide the checkpoint
-     * generation with scenario-specific emphasis.
+     * When provided, it is injected into the compact agent's query as a focus hint.
      */
     scenarioHint?: string;
 }
@@ -559,6 +550,30 @@ export interface CompactPreview {
     estimatedCheckpointTokens: number;
     wouldTrigger: boolean;
 }
+/**
+ * 存量 checkpoint 适配报告（Task #4933 C 方案）
+ *
+ * 生产库有 555 个旧格式 checkpoint（五栏位，无 content）。
+ * `adaptStoredCheckpoints()` 默认 dry-run，返回本报告用于人工核对。
+ */
+export interface CheckpointAdaptReport {
+    sessionId: string;
+    /** checkpoint 总数 */
+    total: number;
+    /** 旧格式（无 content）数量 */
+    legacy: number;
+    /** 新格式（已有 content）数量 */
+    modern: number;
+    /** 实际写回的数量（dry-run 时恒为 0） */
+    applied: number;
+    /** 抽样（最多 3 条），用于人工确认合成正文质量 */
+    samples: Array<{
+        id: string;
+        title: string;
+        contentLength: number;
+        contentPreview: string;
+    }>;
+}
 /**
  * Options for getting session context
  */

package/dist/env/task/delegate/delegate-tool.js

@@ -12,13 +12,13 @@ import {
   deriveTriggerEventIdFromEnvContext,
   getSubAgentSpec,
   handleBackgroundTask
-} from "../../../shared/@ai-setting/roy-agent-core-0j94tj1z.js";
+} from "../../../shared/@ai-setting/roy-agent-core-7qvw65jt.js";
 import"../../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
+import"../../../shared/@ai-setting/roy-agent-core-yhwxpj12.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../../shared/@ai-setting/roy-agent-core-vaz9350j.js";
-import"../../../shared/@ai-setting/roy-agent-core-6m4bw8jy.js";
-import"../../../shared/@ai-setting/roy-agent-core-07fvy74y.js";
+import"../../../shared/@ai-setting/roy-agent-core-4jjwewvw.js";
+import"../../../shared/@ai-setting/roy-agent-core-vm8h5zyj.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";

package/dist/env/task/delegate/index.js

@@ -5,13 +5,13 @@ import {
   BackgroundTaskEventTypes,
   BackgroundTaskManager,
   createDelegateTool
-} from "../../../shared/@ai-setting/roy-agent-core-0j94tj1z.js";
+} from "../../../shared/@ai-setting/roy-agent-core-7qvw65jt.js";
 import"../../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
+import"../../../shared/@ai-setting/roy-agent-core-yhwxpj12.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../../shared/@ai-setting/roy-agent-core-vaz9350j.js";
-import"../../../shared/@ai-setting/roy-agent-core-6m4bw8jy.js";
-import"../../../shared/@ai-setting/roy-agent-core-07fvy74y.js";
+import"../../../shared/@ai-setting/roy-agent-core-4jjwewvw.js";
+import"../../../shared/@ai-setting/roy-agent-core-vm8h5zyj.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";

package/dist/env/task/index.js

@@ -5,27 +5,27 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-nersksh1.js";
+} from "../../shared/@ai-setting/roy-agent-core-2gzt2q8c.js";
 import"../../shared/@ai-setting/roy-agent-core-58804s3j.js";
 import"../../shared/@ai-setting/roy-agent-core-jm136jzh.js";
-import"../../shared/@ai-setting/roy-agent-core-0j94tj1z.js";
+import"../../shared/@ai-setting/roy-agent-core-7qvw65jt.js";
 import"../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import"../../shared/@ai-setting/roy-agent-core-ntq0gz7q.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-h5vmff8w.js";
+import"../../shared/@ai-setting/roy-agent-core-7sj9xs9c.js";
 import"../../shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
 import"../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
+import"../../shared/@ai-setting/roy-agent-core-yhwxpj12.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../shared/@ai-setting/roy-agent-core-vaz9350j.js";
 import"../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
-import"../../shared/@ai-setting/roy-agent-core-6m4bw8jy.js";
-import"../../shared/@ai-setting/roy-agent-core-07fvy74y.js";
+import"../../shared/@ai-setting/roy-agent-core-4jjwewvw.js";
+import"../../shared/@ai-setting/roy-agent-core-vm8h5zyj.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";

package/dist/env/task/mcp/index.js

@@ -6,13 +6,13 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-h5vmff8w.js";
+} from "../../../shared/@ai-setting/roy-agent-core-7sj9xs9c.js";
 import {
   createOperationTool,
   listOperationsTool
 } from "../../../shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
 import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
-import"../../../shared/@ai-setting/roy-agent-core-6m4bw8jy.js";
+import"../../../shared/@ai-setting/roy-agent-core-4jjwewvw.js";
 import"../../../shared/@ai-setting/roy-agent-core-7cbpmk4q.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";

package/dist/env/task/plugins/index.js

@@ -17,13 +17,13 @@ import {
   formatExtractorInputFromDescription,
   getDefaultLarkCardDbPath,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-hx46nhh1.js";
+} from "../../../shared/@ai-setting/roy-agent-core-5gw0qa8m.js";
 import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
+import"../../../shared/@ai-setting/roy-agent-core-yhwxpj12.js";
 import"../../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../../shared/@ai-setting/roy-agent-core-vaz9350j.js";
 import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
-import"../../../shared/@ai-setting/roy-agent-core-6m4bw8jy.js";
+import"../../../shared/@ai-setting/roy-agent-core-4jjwewvw.js";
 import {
   DEFAULT_APP_LINK_BASE,
   LarkCardPatchNotifier,
@@ -42,7 +42,7 @@ import {
   renderWorkflowInfoLines,
   resolveTaskTitleForDisplay,
   sanitizeInlineText
-} from "../../../shared/@ai-setting/roy-agent-core-tadj19vp.js";
+} from "../../../shared/@ai-setting/roy-agent-core-46rv4d7d.js";
 import"../../../shared/@ai-setting/roy-agent-core-yr1mryb8.js";
 import"../../../shared/@ai-setting/roy-agent-core-mds8tqd0.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";

package/dist/env/task/plugins/lark-card-patch-notifier.d.ts

@@ -103,6 +103,43 @@ export interface ProcessStep {
     description?: string;
     /** 步骤分类（如 research / code / test），有值时追加到标题括号内 */
     category?: string;
+    /**
+     * ★ Task #4889 —— 这条过程步骤的**语义来源**。
+     *
+     * ## 为什么需要这个字段
+     *
+     * 「过程信息」区历史上混装了两种**语义完全不同**的东西：
+     *
+     *   1. **operation** —— 真正的任务操作记录（`task_operation_create` 写的）。
+     *      core 自己派生（`deriveTimelineFromOperation`），title 是人写的
+     *      里程碑标题，形如「勘查反转：manifest 并非残废」。
+     *   2. **tool-trace** —— 工具调用轨迹。插件派生（`describeToolUse`），
+     *      title 是**动作名**，形如「执行命令」「记录进展」。
+     *
+     * 两者在卡片上同属一个「🔧 过程信息」区块、底部统一计「N 个过程」，
+     * 用户读起来就等同于「**每个工具调用都记了一条操作记录**」
+     * —— 这正是 Task #4889 用户反馈的核心不满。
+     *
+     * 所以：卡片按 source **分区呈现**，让两种语义在 UI 上泾渭分明。
+     *
+     * - `"tool-trace"` → 渲染进「🔧 执行轨迹（工具调用）」区
+     * - `"operation"` / 缺省 → 渲染进「📝 操作记录」区
+     *
+     * 缺省视为 operation：**旧数据（没有这个字段）必须继续渲染在操作记录区**，
+     * 不能因为新增字段就丢掉历史内容。
+     */
+    source?: "operation" | "tool-trace";
+    /**
+     * ★ Task #4889 —— 该步骤的**唯一标识**（可选）。
+     *
+     * 有 id 时，去重完全按 id 进行 —— 于是「同一个工具被连续调用两次」
+     * （title 相同、timestamp 可能同毫秒）不会撞成同一条而被**静默吞掉**。
+     *
+     * 缺省时退化为「内容 key」去重（同 title+timestamp+description+category+source
+     * 视为同一条）—— 对 operation 记录是对的（同一 operation 重复上报就是同一条），
+     * 对 tool-trace 则要求生产方补 id（插件已补）。
+     */
+    id?: string;
 }
 /**
  * 任务元信息（卡片顶部"任务栏位"区块的数据源）
@@ -454,6 +491,19 @@ export declare function renderMilestones(milestones: Milestone[]): string;
  * 样式：`- **HH:mm:ss → 现在** <title>` + 可选缩进说明行
  */
 export declare function renderProcessSteps(steps: ProcessStep[]): string;
+/**
+ * ★ Task #4889 —— 按语义来源把过程步骤分成两组。
+ *
+ * - `operations` —— 真正的 task operation 记录（缺省 source 也归这里）
+ * - `toolTraces` —— 工具调用轨迹
+ *
+ * 分区是**呈现层**的职责：语义（这条到底是不是一条操作记录）在生产方决定，
+ * core 只负责不把两者混在一个区块里。
+ */
+export declare function partitionProcessSteps(steps: ProcessStep[]): {
+    operations: ProcessStep[];
+    toolTraces: ProcessStep[];
+};
 /**
  * 构造 card JSON payload（Card 2.0 schema，用户验收样式 Task #4230 v2）
  *

package/dist/env/task/plugins/lark-card-patch-notifier.js

@@ -11,6 +11,7 @@ import {
   humanizeValue,
   isTerminalStatusForTimeline,
   isTerminalStatusForWorkflowTimeline,
+  partitionProcessSteps,
   renderContextAsLines,
   renderMilestones,
   renderProcessSteps,
@@ -19,7 +20,7 @@ import {
   renderWorkflowInfoLines,
   resolveTaskTitleForDisplay,
   sanitizeInlineText
-} from "../../../shared/@ai-setting/roy-agent-core-tadj19vp.js";
+} from "../../../shared/@ai-setting/roy-agent-core-46rv4d7d.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
@@ -33,6 +34,7 @@ export {
   renderProcessSteps,
   renderMilestones,
   renderContextAsLines,
+  partitionProcessSteps,
   isTerminalStatusForWorkflowTimeline,
   isTerminalStatusForTimeline,
   humanizeValue,

package/dist/env/task/prompt/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Task #4889 — 任务纪律子路径公开导出面
+ *
+ * 消费方式：
+ *   import { TASK_DISCIPLINE_PROMPT } from "@ai-setting/roy-agent-core/env/task/prompt";
+ *
+ * 设计（/tmp/4889-phase1-design.md §1.3-1.6）：
+ *   TASK_DISCIPLINE_PROMPT 是唯一真相源；4 个分片供
+ *   「部分缺失」的 runtime 只补自己缺的那块。
+ */
+export { TASK_DISCIPLINE_PROMPT, TASK_DISCIPLINE_LIFECYCLE, TASK_DISCIPLINE_OPERATION, TASK_DISCIPLINE_GOALS, TASK_DISCIPLINE_COMPLETE, } from "./task-discipline";

package/dist/env/task/prompt/index.js

@@ -0,0 +1,16 @@
+import"../../../shared/@ai-setting/roy-agent-core-qkdegdvc.js";
+import {
+  TASK_DISCIPLINE_COMPLETE,
+  TASK_DISCIPLINE_GOALS,
+  TASK_DISCIPLINE_LIFECYCLE,
+  TASK_DISCIPLINE_OPERATION,
+  TASK_DISCIPLINE_PROMPT
+} from "../../../shared/@ai-setting/roy-agent-core-4jjwewvw.js";
+import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
+export {
+  TASK_DISCIPLINE_PROMPT,
+  TASK_DISCIPLINE_OPERATION,
+  TASK_DISCIPLINE_LIFECYCLE,
+  TASK_DISCIPLINE_GOALS,
+  TASK_DISCIPLINE_COMPLETE
+};