@ai-setting/roy-agent-core 1.7.71 → 1.7.75

package/dist/shared/@ai-setting/{roy-agent-core-mwa6apzx.js → roy-agent-core-4gr3k7qg.js}

@@ -1,19 +1,22 @@
 import {
+  compactSessionTool,
+  createCompactSessionTool,
   createQueryBackgroundProcessTool
-} from "./roy-agent-core-58804s3j.js";
+} from "./roy-agent-core-2akfd64z.js";
 import {
   createStopTool
 } from "./roy-agent-core-jm136jzh.js";
 import {
   BackgroundTaskManager,
   createDelegateTool
-} from "./roy-agent-core-101qtkyc.js";
+} from "./roy-agent-core-jg65qnwa.js";
 import {
   TaskEntityEventTypes
 } from "./roy-agent-core-8gxth0eh.js";
 import {
   batchArchiveTaskTool,
   batchDeleteTaskTool,
+  cancelTaskTool,
   completeTaskTool,
   createTaskTool,
   deleteTaskTool,
@@ -22,7 +25,7 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "./roy-agent-core-7sj9xs9c.js";
+} from "./roy-agent-core-hnyk1by7.js";
 import {
   createOperationTool,
   deleteOperationTool,
@@ -336,6 +339,9 @@ class TaskComponent extends BaseComponent {
       await this.registerTools();
       this.toolComponent.register(createQueryBackgroundProcessTool(this.backgroundTaskManager), "built-in");
       logger2.debug("[TaskComponent] Injected BackgroundTaskManager into query_background_process tool (factory pattern)");
+      const sessionComponent = this.env?.getComponent("session");
+      this.toolComponent.register(createCompactSessionTool(this.backgroundTaskManager, sessionComponent ?? null), "built-in");
+      logger2.debug("[TaskComponent] Registered compact_session tool (factory pattern)");
     } else {
       logger2.warn("[TaskComponent] ToolComponent not found, skipping tool registration");
     }
@@ -352,6 +358,12 @@ class TaskComponent extends BaseComponent {
       } catch (err) {
         logger2.warn(`[TaskComponent] Failed to reset query_background_process tool: ${err.message}`);
       }
+      try {
+        this.toolComponent.register(compactSessionTool, "built-in");
+        logger2.debug("[TaskComponent] Reset compact_session tool to no-deps default (cleanup)");
+      } catch (err) {
+        logger2.warn(`[TaskComponent] Failed to reset compact_session tool: ${err.message}`);
+      }
     }
     if (this.backgroundTaskManager) {
       await this.backgroundTaskManager.dispose(this.skipAbortRunningTasksOnDispose ? {
@@ -378,7 +390,8 @@ class TaskComponent extends BaseComponent {
       batchDeleteTaskTool(this),
       updateTaskTool(this),
       deleteTaskTool(this),
-      completeTaskTool(this)
+      completeTaskTool(this),
+      cancelTaskTool(this)
     ];
     const operationToolsList = [
       createOperationTool(this),

package/dist/shared/@ai-setting/{roy-agent-core-zsbh9bfv.js → roy-agent-core-60jbrfye.js}

@@ -1,9 +1,6 @@
 import {
   defaultLarkCliRunner
 } from "./roy-agent-core-bxkjk7zx.js";
-import {
-  notifyReactFailure
-} from "./roy-agent-core-add1zqsh.js";
 import {
   cliCommandHandler
 } from "./roy-agent-core-v0hf14bj.js";
@@ -13,17 +10,20 @@ import {
   createPerTaskGroupChatPlugin,
   extractPerTaskChatId,
   extractPerTaskChatName
-} from "./roy-agent-core-k13pxrpk.js";
+} from "./roy-agent-core-y7x2qzwc.js";
 import {
   getSharedEventStore
 } from "./roy-agent-core-na18zwj0.js";
 import {
   createLarkCliWorkflowNotifyHook
-} from "./roy-agent-core-1w9y7mxj.js";
+} from "./roy-agent-core-p3zv1mx5.js";
 import {
   LarkCardPatchNotifier,
   buildTaskCard
-} from "./roy-agent-core-46rv4d7d.js";
+} from "./roy-agent-core-nmx9934r.js";
+import {
+  notifyReactFailure
+} from "./roy-agent-core-6cy43nss.js";
 import {
   normalizeLarkAtMentions
 } from "./roy-agent-core-m880qz3y.js";

package/dist/shared/@ai-setting/{roy-agent-core-add1zqsh.js → roy-agent-core-6cy43nss.js}

@@ -401,6 +401,27 @@ function __resetFailureReplyDedupForTest() {
   repliedTriggers.clear();
 }
 var DEFAULT_REPLY_TIMEOUT_MS = 5000;
+async function deliverAskUserMessage(options) {
+  const { chatId, messageId, profile, content } = options;
+  if (!chatId && !messageId) {
+    return { sent: false, error: "no-target" };
+  }
+  try {
+    await spawnLarkReply({
+      chatId,
+      messageId,
+      content,
+      profile,
+      timeoutMs: options.timeoutMs ?? DEFAULT_REPLY_TIMEOUT_MS
+    });
+    return { sent: true };
+  } catch (err) {
+    return {
+      sent: false,
+      error: err instanceof Error ? err.message : String(err)
+    };
+  }
+}
 function spawnLarkReply(options) {
   return new Promise((resolve, reject) => {
     const { chatId, messageId, content, profile } = options;
@@ -521,4 +542,4 @@ async function notifyReactFailure(options) {
   }
 }
 
-export { extractRetryAfterSeconds, humanizeRetryAfter, getFailureRuleIds, classifyReactFailure, buildFailureReplyMarkdown, formatCliFailureLine, __resetFailureReplyDedupForTest, notifyReactFailure };
+export { extractRetryAfterSeconds, humanizeRetryAfter, getFailureRuleIds, classifyReactFailure, buildFailureReplyMarkdown, formatCliFailureLine, __resetFailureReplyDedupForTest, deliverAskUserMessage, notifyReactFailure };

package/dist/shared/@ai-setting/{roy-agent-core-mw2cen6s.js → roy-agent-core-6rh8k6ba.js}

@@ -7,7 +7,7 @@ import {
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-002g6nfk.js";
+} from "./roy-agent-core-dqxec05w.js";
 import {
   PythonCallNode,
   SkillNode,
@@ -37,23 +37,23 @@ import {
 import {
   TemplateResolver,
   init_template_resolver
-} from "./roy-agent-core-sjr1kmfz.js";
+} from "./roy-agent-core-acj8ag08.js";
 import {
   DAGManager,
   init_dag_manager
-} from "./roy-agent-core-mds8tqd0.js";
+} from "./roy-agent-core-cgtq6427.js";
 import {
   WorkflowError,
   createWorkflowEvent,
   init_event,
   init_types,
   init_workflow_error
-} from "./roy-agent-core-jrj30vq3.js";
+} from "./roy-agent-core-er070zjq.js";
 import {
   AskUserError,
   createNodeInterruptEvent,
   init_workflow_hil
-} from "./roy-agent-core-e25xkv53.js";
+} from "./roy-agent-core-mkc3zshb.js";
 import {
   TracedAs,
   init_decorator

package/dist/shared/@ai-setting/{roy-agent-core-kpg25s2q.js → roy-agent-core-8ez6mccb.js}

@@ -2,8 +2,9 @@ import {
   understandImageTool
 } from "./roy-agent-core-xwm8zavb.js";
 import {
+  compactSessionTool,
   queryBackgroundProcessTool
-} from "./roy-agent-core-58804s3j.js";
+} from "./roy-agent-core-2akfd64z.js";
 import {
   getCurrentProcessRegistry,
   killProcessTree
@@ -939,7 +940,8 @@ function getAllBuiltInTools() {
     editFileTool,
     grepTool,
     understandImageTool,
-    queryBackgroundProcessTool
+    queryBackgroundProcessTool,
+    compactSessionTool
   ];
 }
 function getBuiltInTool(name) {

package/dist/shared/@ai-setting/{roy-agent-core-sjr1kmfz.js → roy-agent-core-acj8ag08.js}

@@ -7,7 +7,7 @@ import {
   nodeNotFound,
   pathNotFound,
   unresolvedVariable
-} from "./roy-agent-core-jrj30vq3.js";
+} from "./roy-agent-core-er070zjq.js";
 import {
   TracedAs,
   init_decorator

package/dist/shared/@ai-setting/{roy-agent-core-mds8tqd0.js → roy-agent-core-cgtq6427.js}

@@ -1,7 +1,7 @@
 import {
   LoopGuardConfigSchema,
   init_types
-} from "./roy-agent-core-jrj30vq3.js";
+} from "./roy-agent-core-er070zjq.js";
 import {
   TracedAs,
   init_decorator

package/dist/shared/@ai-setting/{roy-agent-core-9bshyqjn.js → roy-agent-core-ddyk1rc0.js}

@@ -1,11 +1,7 @@
 import {
   MemorySessionStore,
   SQLiteSessionStore
-} from "./roy-agent-core-hy3zn2q2.js";
-import {
-  init_loose_json,
-  tryParseJsonFromText
-} from "./roy-agent-core-ze068vc9.js";
+} from "./roy-agent-core-0qyrk5k0.js";
 import {
   init_search_query_parser,
   matchesQuery,
@@ -47,7 +43,8 @@ var SESSION_DEFAULTS = {
   "session.storage.dbPath": undefined,
   "session.checkpoint.enabled": false,
   "session.contextLimit": 1e5,
-  "session.maxSessions": 100
+  "session.maxSessions": 100,
+  "session.compactModel": undefined
 };
 var SESSION_CONFIG_REGISTRATION = {
   name: "session",
@@ -64,56 +61,108 @@ var SESSION_CONFIG_REGISTRATION = {
     { key: "session.storage.dbPath", sources: ["env", "file"] },
     { key: "session.checkpoint.enabled", sources: ["env", "file"] },
     { key: "session.contextLimit", sources: ["env", "file"] },
-    { key: "session.maxSessions", sources: ["env", "file"] }
+    { key: "session.maxSessions", sources: ["env", "file"] },
+    { key: "session.compactModel", sources: ["env", "file"] }
   ]
 };
 
 // src/env/session/session-component.ts
 init_search_query_parser();
-init_loose_json();
 import path from "path";
-import { z } from "zod";
-var logger = createLogger("session");
-function normalizeAgentCheckpoint(data) {
-  return {
-    title: data.title || "Untitled Checkpoint",
-    processKeyPoints: data.processKeyPoints || [],
-    currentState: data.currentState || "",
-    nextSteps: data.nextSteps || [],
-    userIntents: data.userIntents || [],
-    rawResponse: JSON.stringify(data)
-  };
-}
+
+// src/env/session/compact-checkpoint-content.ts
 var DEGRADED_TEXT_SENTINELS = new Set([
-  "[hint extraction failed]"
+  "[hint extraction failed]",
+  "maximum iterations reached",
+  "no usable checkpoint output"
 ]);
-function isUsableCheckpointText(text) {
+var MIN_CONTENT_LENGTH = 20;
+function normalizeCheckpointContent(text) {
   const raw = (text ?? "").trim();
   if (!raw)
-    return false;
-  return !DEGRADED_TEXT_SENTINELS.has(raw.toLowerCase());
+    return;
+  if (DEGRADED_TEXT_SENTINELS.has(raw.toLowerCase()))
+    return;
+  if (raw.length < MIN_CONTENT_LENGTH)
+    return;
+  return raw;
 }
-function buildCheckpointFromFinalText(finalText) {
-  if (!isUsableCheckpointText(finalText))
+function buildCheckpointFromText(text) {
+  const content = normalizeCheckpointContent(text);
+  if (!content)
     return;
-  const raw = finalText.trim();
-  const parsed = tryParseJsonFromText(raw);
-  if (parsed && (parsed.title || parsed.currentState || parsed.processKeyPoints)) {
-    return normalizeAgentCheckpoint(parsed);
-  }
-  const lines = raw.split(`
+  const lines = content.split(`
 `).map((l) => l.trim()).filter(Boolean);
   const heading = lines.find((l) => /^#{1,6}\s+/.test(l)) ?? lines[0] ?? "";
   const title = heading.replace(/^#{1,6}\s+/, "").replace(/^[*_`\s]+|[*_`\s]+$/g, "").slice(0, 80);
   return {
     title: title || "Untitled Checkpoint",
-    processKeyPoints: [],
-    currentState: raw,
-    nextSteps: [],
-    userIntents: [],
-    rawResponse: raw
+    content
+  };
+}
+function isModernCheckpoint(cp) {
+  return typeof cp.content === "string" && (cp.content ?? "").trim().length > 0;
+}
+function adaptLegacyCheckpoint(cp) {
+  if (isModernCheckpoint(cp))
+    return cp;
+  const legacy = cp;
+  const sections = [];
+  const summary = (legacy.summary ?? "").trim();
+  if (summary)
+    sections.push(summary);
+  const points = legacy.processKeyPoints ?? [];
+  if (points.length) {
+    sections.push(points.map((p, i) => `${i + 1}. ${p}`).join(`
+`));
+  }
+  const state = (legacy.currentState ?? "").trim();
+  if (state)
+    sections.push(state);
+  const steps = legacy.nextSteps ?? [];
+  if (steps.length) {
+    sections.push(steps.map((s, i) => `${i + 1}. ${s}`).join(`
+`));
+  }
+  const intents = legacy.userIntents ?? [];
+  if (intents.length) {
+    sections.push(intents.map((u, i) => `${i + 1}. ${u}`).join(`
+`));
+  }
+  let content = sections.join(`
+
+`).trim();
+  if (!content)
+    content = cp.title ?? "";
+  if (!normalizeCheckpointContent(content)) {
+    content = cp.id ? `Checkpoint ${cp.id}` : "";
+  }
+  return {
+    id: cp.id,
+    messageIndex: cp.messageIndex,
+    title: cp.title,
+    content,
+    messageCountBefore: cp.messageCountBefore,
+    createdAt: cp.createdAt,
+    type: cp.type,
+    ...cp.recentMessages ? { recentMessages: cp.recentMessages } : {}
   };
 }
+function createCheckpointContent(checkpoint) {
+  const adapted = adaptLegacyCheckpoint(checkpoint);
+  const lines = [
+    `# Checkpoint: ${checkpoint.title}`,
+    "",
+    adapted.content,
+    "",
+    `${checkpoint.messageCountBefore} messages compacted at ${new Date(checkpoint.createdAt).toISOString()}`
+  ];
+  return lines.join(`
+`);
+}
+
+// src/env/session/session-component.ts
+var logger = createLogger("session");
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -612,6 +661,10 @@ class SessionComponent extends BaseComponent {
     const date = new Date().toISOString().replace("T", " ").substring(0, 19);
     return template.replace("{date}", date);
   }
+  getCompactModel() {
+    const model = this.configComponent?.get("session.compactModel");
+    return typeof model === "string" && model.trim() ? model.trim() : undefined;
+  }
   async generateCompactHint(sessionId) {
     const session = await this.get(sessionId);
     if (!session) {
@@ -626,29 +679,14 @@ class SessionComponent extends BaseComponent {
       return "";
     }
     const agentComponent = this.env.getComponent("agent");
-    let hintData;
-    const submitTool = {
-      name: "workflow_submit_output",
-      description: "Submit the final result. Call this with your guidance_prompt.",
-      parameters: z.object({
-        guidance_prompt: z.string().describe("The compact guidance prompt (3-4 sentences)")
-      }),
-      execute: async (args) => {
-        const parsed = z.object({
-          guidance_prompt: z.string()
-        }).parse(args);
-        hintData = parsed;
-        return { success: true, output: "OK" };
-      }
-    };
-    await agentComponent.run("compact-hint", "Analyze this conversation and generate a compact guidance prompt for checkpoint generation.", {
+    const hintRun = await agentComponent.run("compact-hint", "Analyze this conversation and generate a compact guidance prompt for checkpoint generation.", {
       sessionId,
       persistSession: false,
-      extraTools: [submitTool]
+      model: this.getCompactModel()
     });
-    const hint = hintData?.guidance_prompt || "";
+    const hint = normalizeCheckpointContent(hintRun?.finalText) ?? "";
     if (!hint) {
-      logger.warn("[SessionComponent] Compact hint unavailable (compact-hint did not submit) — returning empty hint", { sessionId });
+      logger.warn("[SessionComponent] Compact hint unavailable (no usable finalText) — returning empty hint", { sessionId });
     }
     logger.info("[SessionComponent] Compact hint generated", {
       sessionId,
@@ -670,53 +708,36 @@ class SessionComponent extends BaseComponent {
     }
     const recentMessages = this.extractRecentMessages(messages, 2);
     await this.executeBeforeHooks("compact", { session, options });
-    let summaryResult;
+    let checkpointText;
     try {
-      const userQuery = options?.scenarioHint ? options.scenarioHint : "Generate a checkpoint from this conversation.";
-      let checkpointData;
-      const submitTool = {
-        name: "workflow_submit_output",
-        description: "Submit the checkpoint result with title, processKeyPoints, currentState, nextSteps, userIntents.",
-        parameters: z.object({
-          title: z.string().describe("Brief checkpoint title (max 30 chars)"),
-          processKeyPoints: z.array(z.string()).describe("Key discoveries or decisions"),
-          currentState: z.string().describe("Current progress and status"),
-          nextSteps: z.array(z.string()).describe("Follow-up items"),
-          userIntents: z.array(z.string()).describe("User's core intents (2-5 items)")
-        }),
-        execute: async (args) => {
-          const parsed = z.object({
-            title: z.string(),
-            processKeyPoints: z.array(z.string()),
-            currentState: z.string(),
-            nextSteps: z.array(z.string()),
-            userIntents: z.array(z.string())
-          }).parse(args);
-          checkpointData = parsed;
-          return { success: true, output: "OK" };
-        }
-      };
+      const userQuery = options?.scenarioHint ? [
+        "Generate a checkpoint from this conversation.",
+        "",
+        "Scenario hint (focus points from phase 1):",
+        options.scenarioHint
+      ].join(`
+`) : "Generate a checkpoint from this conversation.";
       const agentComponent = this.env.getComponent("agent");
       const runResult = await agentComponent.run("compact", userQuery, {
         sessionId,
         persistSession: false,
-        extraTools: [submitTool]
+        model: this.getCompactModel()
       });
-      const data = checkpointData;
-      if (data) {
-        summaryResult = normalizeAgentCheckpoint(data);
+      const fromText = buildCheckpointFromText(runResult?.finalText);
+      const fromHint = fromText ? undefined : buildCheckpointFromText(options?.scenarioHint);
+      const built = fromText ?? fromHint;
+      if (!built) {
+        throw new Error(`compact agent returned no usable checkpoint output ` + `(no usable finalText or scenarioHint); ` + `refusing to archive ${messages.length} messages for session ${sessionId}`);
+      }
+      if (fromText) {
+        logger.info("[SessionComponent] compact agent produced natural-language checkpoint", {
+          sessionId,
+          contentLength: built.content.length
+        });
       } else {
-        const fallback = buildCheckpointFromFinalText(runResult?.finalText) ?? buildCheckpointFromFinalText(options?.scenarioHint);
-        if (!fallback) {
-          throw new Error(`compact agent returned no usable checkpoint output ` + `(no workflow_submit_output call, no usable finalText or scenarioHint); ` + `refusing to archive ${messages.length} messages for session ${sessionId}`);
-        }
-        if (runResult?.finalText?.trim()) {
-          logger.warn(`[SessionComponent] compact agent did not call workflow_submit_output; ` + `falling back to its finalText for the checkpoint (session=${sessionId}, ` + `finalTextLength=${runResult.finalText.length})`);
-        } else {
-          logger.warn(`[SessionComponent] compact agent produced neither a tool call nor text; ` + `falling back to scenarioHint for the checkpoint (session=${sessionId})`);
-        }
-        summaryResult = fallback;
+        logger.warn(`[SessionComponent] compact agent produced no usable text; ` + `falling back to scenarioHint for the checkpoint (session=${sessionId})`);
       }
+      checkpointText = built;
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       logger.error(`[SessionComponent] Compact agent failed: ${errorMessage}`);
@@ -726,16 +747,8 @@ class SessionComponent extends BaseComponent {
     const checkpoint = {
       id: checkpointId,
       messageIndex: startIndex,
-      title: summaryResult.title,
-      summary: [
-        `Process: ${summaryResult.processKeyPoints.join("; ")}`,
-        `State: ${summaryResult.currentState}`
-      ].join(`
-`),
-      processKeyPoints: summaryResult.processKeyPoints,
-      currentState: summaryResult.currentState,
-      nextSteps: summaryResult.nextSteps,
-      userIntents: summaryResult.userIntents,
+      title: checkpointText.title,
+      content: checkpointText.content,
       messageCountBefore: messages.length,
       createdAt: Date.now(),
       type: "compact",
@@ -833,10 +846,68 @@ class SessionComponent extends BaseComponent {
     };
   }
   async getCheckpoints(sessionId) {
-    return await this.store.getCheckpoints(sessionId);
+    const checkpoints = await this.store.getCheckpoints(sessionId);
+    return checkpoints.map((cp) => adaptLegacyCheckpoint(cp));
   }
   async getCheckpoint(sessionId, checkpointId) {
-    return await this.store.getCheckpoint(sessionId, checkpointId);
+    const cp = await this.store.getCheckpoint(sessionId, checkpointId);
+    return cp ? adaptLegacyCheckpoint(cp) : undefined;
+  }
+  async readStoredCheckpointsRaw(sessionId) {
+    return await this.store.getCheckpoints(sessionId);
+  }
+  async adaptStoredCheckpoints(sessionId, options) {
+    const apply = options?.apply === true;
+    const raw = await this.store.getCheckpoints(sessionId);
+    const report = {
+      sessionId,
+      total: raw.length,
+      legacy: 0,
+      modern: 0,
+      applied: 0,
+      samples: []
+    };
+    const adapted = [];
+    for (const cp of raw) {
+      const o = cp;
+      const hasContent = typeof o.content === "string" && o.content.trim().length > 0;
+      if (hasContent) {
+        report.modern++;
+        adapted.push(cp);
+        continue;
+      }
+      report.legacy++;
+      const fixed = adaptLegacyCheckpoint(cp);
+      adapted.push(fixed);
+      if (report.samples.length < 3) {
+        report.samples.push({
+          id: cp.id,
+          title: cp.title,
+          contentLength: fixed.content.length,
+          contentPreview: fixed.content.slice(0, 200)
+        });
+      }
+    }
+    if (apply && report.legacy > 0) {
+      await this.writeCheckpointsBack(sessionId, adapted);
+      report.applied = report.legacy;
+    }
+    logger.info("[SessionComponent] adaptStoredCheckpoints", {
+      sessionId,
+      total: report.total,
+      legacy: report.legacy,
+      modern: report.modern,
+      applied: report.applied,
+      dryRun: !apply
+    });
+    return report;
+  }
+  async writeCheckpointsBack(sessionId, checkpoints) {
+    const store = this.store;
+    if (typeof store.replaceCheckpointDetails !== "function") {
+      throw new Error("adaptStoredCheckpoints: current store does not support replaceCheckpointDetails " + "(only SQLiteSessionStore does); refusing to write partial data");
+    }
+    await store.replaceCheckpointDetails(sessionId, checkpoints);
   }
   async deleteCheckpoint(sessionId, checkpointId) {
     await this.executeBeforeHooks("deleteCheckpoint", { sessionId, checkpointId });
@@ -870,7 +941,7 @@ class SessionComponent extends BaseComponent {
     } else {
       const latestCheckpointId = session.metadata?.checkpoints?.latestCheckpointId;
       if (latestCheckpointId) {
-        startCheckpoint = await this.store.getCheckpoint(sessionId, latestCheckpointId);
+        startCheckpoint = await this.getCheckpoint(sessionId, latestCheckpointId);
         if (startCheckpoint) {
           const MAX_SAFE_MESSAGES = Number.MAX_SAFE_INTEGER;
           contextMessages = await this.store.getMessages(sessionId, startCheckpoint.messageIndex, MAX_SAFE_MESSAGES, { includeArchived: false });
@@ -898,7 +969,7 @@ class SessionComponent extends BaseComponent {
     if (options?.messageLimit) {
       contextMessages = contextMessages.slice(-options.messageLimit);
     }
-    const checkpoints = contextMessages.filter((m) => m.metadata?.isCheckpoint).map((m) => m.metadata.checkpointMeta);
+    const checkpoints = contextMessages.filter((m) => m.metadata?.isCheckpoint && m.metadata?.checkpointMeta).map((m) => adaptLegacyCheckpoint(m.metadata.checkpointMeta));
     const estimatedTokens = contextMessages.reduce((sum, m) => sum + m.content.length * 0.25, 0);
     return {
       session,
@@ -997,28 +1068,11 @@ class SessionComponent extends BaseComponent {
     const latestId = session.metadata?.checkpoints?.latestCheckpointId;
     if (!latestId)
       return;
-    return session.metadata?.checkpointDetails?.[latestId];
+    const raw = session.metadata?.checkpointDetails?.[latestId];
+    return raw ? adaptLegacyCheckpoint(raw) : undefined;
   }
   createCheckpointMessage(checkpoint) {
-    const lines = [
-      `# Checkpoint: ${checkpoint.title}`,
-      "",
-      "## Process Key Points",
-      ...checkpoint.processKeyPoints.map((p, i) => `${i + 1}. ${p}`),
-      "",
-      "## Current State",
-      checkpoint.currentState,
-      ""
-    ];
-    if (checkpoint.nextSteps?.length) {
-      lines.push("## Next Steps");
-      checkpoint.nextSteps.forEach((s, i) => lines.push(`${i + 1}. ${s}`));
-      lines.push("");
-    }
-    lines.push("## Messages Compacted");
-    lines.push(`${checkpoint.messageCountBefore} messages compacted at ${new Date(checkpoint.createdAt).toISOString()}`);
-    const content = lines.join(`
-`);
+    const content = createCheckpointContent(checkpoint);
     return {
       role: "user",
       content,
@@ -1027,9 +1081,6 @@ class SessionComponent extends BaseComponent {
         checkpointId: checkpoint.id,
         content,
         title: checkpoint.title,
-        processKeyPoints: checkpoint.processKeyPoints,
-        currentState: checkpoint.currentState,
-        nextSteps: checkpoint.nextSteps,
         messageCountBefore: checkpoint.messageCountBefore,
         createdAt: checkpoint.createdAt
       }],