@ynhcj/xiaoyi-channel 0.0.214-beta → 0.0.214-next

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-import { definePluginEntry } from "openclaw/plugin-sdk/core";
-declare const pluginEntry: ReturnType<typeof definePluginEntry>;
-export default pluginEntry;
+import { type OpenClawPluginDefinition } from "openclaw/plugin-sdk/core";
+declare const plugin: OpenClawPluginDefinition;
+export default plugin;

package/dist/index.js

@@ -1,5 +1,6 @@
 import { definePluginEntry } from "openclaw/plugin-sdk/core";
 import { xiaoyiProvider } from "./src/provider.js";
+import { xiaoyiCompactionProvider } from "./src/compaction-provider.js";
 import { xyPlugin } from "./src/channel.js";
 import registerSentinelHook from "./src/cspl/sentinel_hook.js";
 import { setXYRuntime } from "./src/runtime.js";
@@ -11,7 +12,9 @@ import { registerSelfEvolutionToolResultNudge } from "./src/self-evolution-tool-
 import { createBeforePromptBuildHandler } from "./src/skill-retriever/hooks.js";
 import { normalizeToolRetrieverConfig } from "./src/skill-retriever/config.js";
 import { registerCLIHook } from "./src/tools/hmos-cli.js";
+import { recoverCronState } from "./src/cron-recovery.js";
 import { writeSkillUsage } from "./src/utils/skills-logger.js";
+import { logger } from "./src/utils/logger.js";
 /**
  * Parse a file path string to detect if it refers to a SKILL.md file within
  * a skills directory. Returns the skill name (parent directory) if so.
@@ -205,6 +208,72 @@ function readJobIdFromResult(result) {
     }
     return undefined;
 }
+// ── Gateway startup: cron state recovery ────────────────────────────────────
+/**
+ * Register the gateway_start hook for cron state recovery.
+ *
+ * On gateway startup, checks .openclaw/cron/ for legacy JSON/JSONL files
+ * and migrates them into the SQLite state database:
+ *  - Reads legacy jobs.json + jobs-state.json → imports into cron_jobs table
+ *  - Reads legacy runs/*.jsonl → imports into cron_run_logs table
+ *  - Archives migrated files with .migrated suffix
+ *
+ * Pattern follows legacy-store-migration.ts and legacy-run-log-migration.ts:
+ * check → load → import into SQLite → archive old files.
+ */
+function registerCronRecoveryHook(api) {
+    api.on("gateway_start", async (_event, _ctx) => {
+        const logTag = "[CRON-RECOVERY-HOOK]";
+        const startTime = Date.now();
+        logger.log(`${logTag} ═══════════════════════════════════════════`);
+        logger.log(`${logTag} gateway_start fired — checking for legacy cron files`);
+        logger.log(`${logTag} Timestamp: ${new Date().toISOString()}`);
+        logger.log(`${logTag} Plugin registration mode: ${api.registrationMode ?? "unknown"}`);
+        let result;
+        try {
+            result = await recoverCronState();
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            const errStack = err instanceof Error ? err.stack : undefined;
+            logger.error(`${logTag} cron state recovery threw: ${errMsg}`);
+            if (errStack)
+                logger.error(`${logTag} Stack: ${errStack}`);
+            // Don't let a recovery failure block gateway startup.
+            logger.log(`${logTag} Recovery failed after ${Date.now() - startTime}ms — gateway startup continues`);
+            return;
+        }
+        const elapsed = Date.now() - startTime;
+        if (result.recovered) {
+            logger.log(`${logTag} ✅ Migration performed successfully in ${elapsed}ms:` +
+                ` storeMigrated=${result.storeMigrated}, ` +
+                ` runLogFilesImported=${result.runLogFilesImported}`);
+        }
+        else {
+            logger.log(`${logTag} ℹ️ No legacy cron files migrated in ${elapsed}ms ` +
+                `(nothing to migrate or database unavailable)`);
+        }
+        // Log diagnostics summary
+        const warnings = result.diagnostics.filter((d) => d.includes("skipping") || d.includes("locked") || d.includes("unavailable"));
+        const errors = result.diagnostics.filter((d) => d.includes("error") || d.includes("failed") || d.includes("Failed"));
+        if (warnings.length > 0) {
+            logger.warn(`${logTag} ${warnings.length} warning(s) from migration:`);
+            for (const w of warnings) {
+                logger.warn(`${logTag}   ⚠ ${w}`);
+            }
+        }
+        if (errors.length > 0) {
+            logger.error(`${logTag} ${errors.length} error(s) from migration:`);
+            for (const e of errors) {
+                logger.error(`${logTag}   ✗ ${e}`);
+            }
+        }
+        if (warnings.length === 0 && errors.length === 0) {
+            logger.log(`${logTag} All diagnostics clean, no warnings or errors`);
+        }
+        logger.log(`${logTag} ═══════════════════════════════════════════`);
+    });
+}
 function registerFullHooks(api) {
     // SKILL RETRIEVER HOOK: before_prompt_build hook
     const pluginConfig = api.pluginConfig || {};
@@ -216,10 +285,13 @@ function registerFullHooks(api) {
         timeoutMs: pluginConfig.skillRetrieverTimeoutMs ?? 1000,
     });
     const beforePromptBuildHandler = createBeforePromptBuildHandler(skillRetrieverConfig);
-    api.on("before_prompt_build", beforePromptBuildHandler);
+    api.on("before_prompt_build", async (event, ctx) => {
+        logger.log(`[BEFORE_PROMPT_BUILD] hook fired, sessionKey=${ctx.sessionKey || "undefined"}, sessionId=${ctx.sessionId || "undefined"}`);
+        return beforePromptBuildHandler(event, ctx);
+    });
     registerSelfEvolutionToolResultNudge(api);
 }
-const pluginEntry = definePluginEntry({
+const plugin = definePluginEntry({
     id: "xiaoyi-channel",
     name: "Xiaoyi Channel",
     description: "Xiaoyi channel plugin - Xiaoyi A2A protocol integration",
@@ -227,6 +299,10 @@ const pluginEntry = definePluginEntry({
         // Always register the provider so wrapStreamFn/prepareExtraParams work
         // in ALL registration modes (not just "full").
         api.registerProvider(xiaoyiProvider);
+        // Register the compaction provider so openclaw's safeguard hook uses
+        // our summarization path (which injects x-hag-trace-id) instead of the
+        // built-in LLM path that bypasses wrapStreamFn.
+        api.registerCompactionProvider(xiaoyiCompactionProvider);
         if (api.registrationMode === "cli-metadata") {
             return;
         }
@@ -248,9 +324,11 @@ const pluginEntry = definePluginEntry({
             registerCronDetectionHook(api);
             // CLI exec hook: intercepts built-in exec for HarmonyOS CLI skill tools
             registerCLIHook(api);
+            // Cron recovery hook: prunes stale cron-push-map and pushData on gateway startup
+            registerCronRecoveryHook(api);
             // Skills diagnostic hook: log skill usage (detected via SKILL.md reads)
             registerSkillsDiagnosticHook(api);
         }
     },
 });
-export default pluginEntry;
+export default plugin;

package/dist/src/bot.js

@@ -7,7 +7,6 @@ import { downloadFilesFromParts } from "./file-download.js";
 import { resolveXYConfig } from "./config.js";
 import { sendStatusUpdate, sendClearContextResponse, sendTasksCancelResponse, sendA2AResponse } from "./formatter.js";
 import { appendSelfEvolutionKeywordNudge, shouldNudgeForSelfEvolutionKeyword, } from "./self-evolution-keyword.js";
-import { queueAgentHarnessMessage } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { runWithSessionContext } from "./tools/session-manager.js";
 import { configManager } from "./utils/config-manager.js";
 import { addPushId } from "./utils/pushid-manager.js";
@@ -16,6 +15,7 @@ import { selfEvolutionManager } from "./utils/self-evolution-manager.js";
 import { saveRuntimeInfo } from "./utils/runtime-manager.js";
 import { toolCallNudgeManager } from "./utils/tool-call-nudge-manager.js";
 import { setCsplSteerContext } from "./cspl/steer-context.js";
+import { resolveActiveEmbeddedRunSessionId, queueAgentHarnessMessage, } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { registerTaskId, decrementTaskIdRef, hasActiveTask, } from "./task-manager.js";
 import { logger } from "./utils/logger.js";
 /**
@@ -242,18 +242,20 @@ export async function handleXYMessage(params) {
                     log.error(`[BOT] Failed to patch session model override:`, patchErr);
                 }
             }
-            // 🔑 发送初始状态更新
-            log.log(`[BOT] Sending initial status update`);
-            void sendStatusUpdate({
-                config,
-                sessionId: parsed.sessionId,
-                taskId: parsed.taskId,
-                messageId: parsed.messageId,
-                text: "任务正在处理中，请稍候~",
-                state: "working",
-            }).catch((err) => {
-                log.error(`Failed to send initial status update:`, err);
-            });
+            // 🔑 发送初始状态更新（仅首条消息，steer 不重复发送）
+            if (!isUpdate) {
+                log.log(`[BOT] Sending initial status update`);
+                void sendStatusUpdate({
+                    config,
+                    sessionId: parsed.sessionId,
+                    taskId: parsed.taskId,
+                    messageId: parsed.messageId,
+                    text: "任务正在处理中，请稍候~",
+                    state: "working",
+                }).catch((err) => {
+                    log.error(`Failed to send initial status update:`, err);
+                });
+            }
         }
         // Extract text and files from parts
         const text = extractTextFromParts(parsed.parts);
@@ -278,46 +280,50 @@ export async function handleXYMessage(params) {
                 log.error(`[SELF_EVOLUTION] Failed to append inline keyword nudge: ${String(selfEvolutionError)}`);
             }
         }
-        // 🔑 Steer消息: 跳过旧路径直接进入 streaming-signal 队列
-        // /steer 前缀由 dispatchSteerWhenReady 内部添加
-        if (isUpdate) {
-            // 立即释放 init gate——steer 不走 withReplyDispatcher 的 run()
-            // 回调，onInitComplete 永远不会被触发。如果不释放，后续消息
-            // 会被 globalDispatchInitGate 永久阻塞。
-            params.onInitComplete?.();
-            // Steer 也支持文件 —— 提取并下载，附带到 mediaPayload
-            const steerFileParts = extractFileParts(parsed.parts);
-            const steerDownloadedFiles = await downloadFilesFromParts(steerFileParts);
-            const steerMediaPayload = buildXYMediaPayload(steerDownloadedFiles);
-            if (steerFileParts.length > 0) {
-                log.log(`[BOT] Steer message with ${steerFileParts.length} file(s), enqueuing to streaming-signal queue`);
-            }
-            else {
-                log.log(`[BOT] Steer message — enqueuing to streaming-signal queue`);
-            }
-            await enqueueSteer({
-                sessionId: parsed.sessionId,
-                sessionKey: route.sessionKey,
-                steerText: textForAgent, // 原始文本，不带 /steer 前缀
-                mediaPayload: steerMediaPayload,
-                cfg,
-                runtime,
-                parsed,
-                route,
-                deviceType,
-            });
-            log.log(`[BOT] Steer queue completed`);
-            return;
-        }
-        // ── First message (non-steer) path below ──────────────────────
-        // File download — only for real user messages, steer injections have no files
+        // ── Build message and dispatch via auto-reply pipeline ──────────
+        // OpenClaw's auto-reply pipeline (src/auto-reply/reply/agent-runner.ts)
+        // detects active runs and handles steer injection natively — the channel
+        // does not need its own steer detection or polling logic.
+        // File download
         let mediaPayload = {};
-        if (!skipReg) {
+        if (!skipReg || isUpdate) {
             const fileParts = extractFileParts(parsed.parts);
             const downloadedFiles = await downloadFilesFromParts(fileParts);
             log.log(`[BOT] Downloaded ${downloadedFiles.length} file(s)`);
             mediaPayload = buildXYMediaPayload(downloadedFiles);
         }
+        // 🔑 对于 steer 消息，将文件路径附加到消息文本中。
+        // auto-reply 管道的 steer 注入只携带 prompt 文本（followupRun.prompt），
+        // 不携带 mediaPayload，所以模型需要以文本形式看到附件路径。
+        if (isUpdate && mediaPayload.MediaPaths?.length) {
+            const fileHint = `\n【用户上传附件】：${JSON.stringify(mediaPayload.MediaPaths)}`;
+            textForAgent = `${textForAgent}${fileHint}`;
+            log.log(`[BOT] Steer: appended file paths to text`);
+        }
+        // 🔑 Direct steer: bypass dispatchReplyFromConfig entirely and inject the
+        // message directly into the active embedded agent run. This avoids the
+        // per-session ReplyOperation lock in admitReplyTurn which would otherwise
+        // block the steer message until the first message completes — making steer
+        // indistinguishable from a followup.
+        if (isUpdate && !skipReg && route.sessionKey) {
+            const activeSessionId = resolveActiveEmbeddedRunSessionId(route.sessionKey);
+            if (activeSessionId) {
+                log.log(`[BOT-STEER] Direct steer attempt: activeSessionId=${activeSessionId}, textLen=${textForAgent.length}`);
+                const queued = queueAgentHarnessMessage(activeSessionId, textForAgent, {
+                    steeringMode: "all",
+                });
+                if (queued) {
+                    log.log(`[BOT-STEER] Direct steer succeeded — message injected into active run`);
+                    // Steer message taskId refCount is no longer needed since we skip the dispatcher.
+                    decrementTaskIdRef(parsed.sessionId);
+                    return;
+                }
+                log.log(`[BOT-STEER] Direct steer failed (queued=false), falling through to dispatchReplyFromConfig`);
+            }
+            else {
+                log.log(`[BOT-STEER] No active embedded run session for key=${route.sessionKey}, falling through to dispatchReplyFromConfig`);
+            }
+        }
         // Resolve envelope format options (following feishu pattern)
         const envelopeOptions = core.channel.reply.resolveEnvelopeFormatOptions(cfg);
         // Build message body with speaker prefix (following feishu pattern)
@@ -333,12 +339,20 @@ export async function handleXYMessage(params) {
             envelope: envelopeOptions,
             body: messageBody,
         });
+        // 🔑 Steer messages use /steer prefix + CommandSource "native" to trigger
+        // the native slash command fast path, which calls handleSteerCommand →
+        // queueEmbeddedAgentMessageWithOutcomeAsync before admitReplyTurn blocks.
+        const steerCommandBody = isUpdate ? `/steer ${textForAgent}` : textForAgent;
+        if (isUpdate) {
+            log.log(`[BOT-STEER] Dispatching via /steer fast path, sessionKey=${route.sessionKey}, cmdLen=${steerCommandBody.length}`);
+        }
         // ✅ Finalize inbound context (following feishu pattern)
         // Use route.accountId and route.sessionKey instead of parsed fields
         const ctxPayload = core.channel.reply.finalizeInboundContext({
             Body: body,
-            RawBody: textForAgent,
-            CommandBody: textForAgent,
+            RawBody: steerCommandBody,
+            CommandBody: steerCommandBody,
+            ...(isUpdate ? { CommandSource: "native" } : {}),
             From: parsed.sessionId,
             To: parsed.sessionId, // ✅ Simplified: use sessionId as target (context is managed by SessionKey)
             SessionKey: route.sessionKey, // ✅ Use route.sessionKey
@@ -358,10 +372,11 @@ export async function handleXYMessage(params) {
             ReplyToBody: undefined, // A2A protocol doesn't support reply/quote
             ...mediaPayload,
         });
-        // 🔑 Streaming 信号已在上方创建（在文件下载之前）
-        const steerState = { steered: false };
+        // 🔑 For steer messages, pre-set steered=true so the dispatcher skips final
+        // response and cleanup — the first message's dispatcher handles those.
+        const steerState = { steered: isUpdate };
         // 🔑 创建dispatcher
-        log.log(`[BOT-DISPATCHER] Creating reply dispatcher`);
+        log.log(`[BOT-DISPATCHER] Creating reply dispatcher, isSteer=${isUpdate}, sessionKey=${route.sessionKey}`);
         // Cleanup: 必须在 onIdle 内部执行（参见 reply-dispatcher.ts 中 onIdleComplete 的注释）
         let cleaned = false;
         const cleanup = () => {
@@ -384,8 +399,9 @@ export async function handleXYMessage(params) {
         });
         // 🔑 注册 dispatcher 的 fallback taskId 更新函数，供 steer 路径调用
         dispatcherUpdaters.set(parsed.sessionId, updateFallbackTaskId);
-        // Steer injections don't need status intervals
-        if (!skipReg) {
+        // Steer messages don't need a status interval — the first message's
+        // dispatcher already has one running.
+        if (!isUpdate) {
             startStatusInterval();
         }
         // Build session context for AsyncLocalStorage
@@ -423,8 +439,9 @@ export async function handleXYMessage(params) {
                 // signal init complete to release the global dispatch gate
                 // for the next session.
                 const dispatchPromise = runWithSessionContext(sessionContext, async () => {
-                    log.log(`[ALS-PROOF] bot entered dispatch scope sessionId=${sessionContext.sessionId} taskId=${sessionContext.taskId} isSteer=false`);
-                    log.log(`[BOT-DISPATCH] dispatchReplyFromConfig starting, body.length=${ctxPayload.Body?.length ?? 0}`);
+                    const isSteerDispatch = isUpdate && !skipReg;
+                    log.log(`[ALS-PROOF] bot entered dispatch scope sessionId=${sessionContext.sessionId} taskId=${sessionContext.taskId} isSteer=${isSteerDispatch}`);
+                    log.log(`[BOT-DISPATCH] dispatchReplyFromConfig starting, body.length=${ctxPayload.Body?.length ?? 0}, isSteer=${isSteerDispatch}`);
                     try {
                         const result = await core.channel.reply.dispatchReplyFromConfig({
                             ctx: ctxPayload,
@@ -432,7 +449,13 @@ export async function handleXYMessage(params) {
                             dispatcher,
                             replyOptions,
                         });
-                        log.log(`[BOT-DISPATCH] dispatchReplyFromConfig returned, result=${JSON.stringify(result)}`);
+                        // 区分 steer 成功（undefined）和 steer 失败/正常 run（有结果）
+                        if (result === undefined) {
+                            log.log(`[BOT-STEER] dispatchReplyFromConfig returned undefined — steer injected via fast path OK, sessionKey=${route.sessionKey}`);
+                        }
+                        else {
+                            log.log(`[BOT-DISPATCH] dispatchReplyFromConfig returned, resultType=${typeof result}, isSteer=${isSteerDispatch}, steered=${steerState.steered}`);
+                        }
                         return result;
                     }
                     catch (dispatchErr) {
@@ -492,85 +515,11 @@ function buildXYMediaPayload(mediaList) {
     };
 }
 // ─────────────────────────────────────────────────────────────
-// Steer 串行队列
+// Dispatcher updaters (cross-chain taskId bridging)
 // ─────────────────────────────────────────────────────────────
 // Use globalThis to survive module deduplication — provider.ts may load a
 // different copy of bot.ts, so a plain module-level Map would be two objects.
 const _g = globalThis;
-if (!_g.__xySteerQueues)
-    _g.__xySteerQueues = new Map();
 if (!_g.__xyDispatcherUpdaters)
     _g.__xyDispatcherUpdaters = new Map();
-const steerQueues = _g.__xySteerQueues;
 const dispatcherUpdaters = _g.__xyDispatcherUpdaters;
-/**
- * 将 steer 消息放入 per-session 串行队列。
- * 通过指数退避轮询注入（queueAgentHarnessMessage），直到 Pi agent 接受消息或 run 结束。
- * 多个 steer 按到达顺序串行处理。
- */
-function enqueueSteer(params) {
-    const { sessionId } = params;
-    const log = logger.withContext(sessionId, params.parsed.taskId);
-    // 取出当前队列尾部（或 undefined），然后链上新的 Promise
-    const prev = steerQueues.get(sessionId);
-    const next = (prev ?? Promise.resolve()).then(() => dispatchSteerWhenReady(params));
-    steerQueues.set(sessionId, next);
-    // 链条结束后清理
-    next.catch((err) => {
-        log.error(`[STEER-QUEUE] Steer chain failed: ${String(err)}`);
-    }).finally(() => {
-        if (steerQueues.get(sessionId) === next) {
-            steerQueues.delete(sessionId);
-        }
-    });
-    return next;
-}
-/**
- * Poll the active embedded run with exponential backoff until the steer message
- * is accepted or the run completes.
- *
- * Replaces the previous signal-based approach (notifyModelStreaming) which fired
- * from wrapStreamFn too early — before the Pi agent had set state.isStreaming=true.
- * queueAgentHarnessMessage internally checks isStreaming(), so we retry until the
- * Pi agent is ready to accept messages.
- */
-async function dispatchSteerWhenReady(params) {
-    const { sessionId, steerText } = params;
-    const log = logger.withContext(sessionId, params.parsed.taskId);
-    const mediaPaths = params.mediaPayload?.MediaPaths;
-    const fileHint = mediaPaths && mediaPaths.length > 0
-        ? `\n【用户上传附件】：${JSON.stringify(mediaPaths)}`
-        : "";
-    const steerMessage = `${steerText}${fileHint}`;
-    log.log(`[STEER-QUEUE] Injecting steer message directly into active run`);
-    // Exponential backoff polling until:
-    //   1. Injection succeeds (queueAgentHarnessMessage returns true)
-    //   2. The original run has completed (hasActiveTask returns false)
-    //   3. Maximum total wait time exceeded
-    const MAX_WAIT_MS = 30_000;
-    const MAX_BACKOFF_MS = 4_000;
-    const BASE_DELAY_MS = 500;
-    const startedAt = Date.now();
-    let attempt = 0;
-    while (Date.now() - startedAt < MAX_WAIT_MS) {
-        // Termination: first message's run has already finished
-        if (!hasActiveTask(sessionId)) {
-            log.log(`[STEER-QUEUE] First message completed, skip steer`);
-            return;
-        }
-        const injected = queueAgentHarnessMessage(sessionId, steerMessage, {
-            steeringMode: "all",
-        });
-        if (injected) {
-            log.log(`[STEER-QUEUE] Steer injected successfully on attempt ${attempt}`);
-            return;
-        }
-        // Exponential backoff: min(BASE_DELAY_MS * 2^attempt, MAX_BACKOFF_MS)
-        const delay = Math.min(BASE_DELAY_MS * Math.pow(2, attempt), MAX_BACKOFF_MS);
-        log.log(`[STEER-QUEUE] Attempt ${attempt}: run not accepting, retrying in ${delay}ms`);
-        await new Promise(r => setTimeout(r, delay));
-        attempt++;
-    }
-    // Max wait exceeded — model may still be in provider retry loop or unresponsive
-    log.log(`[STEER-QUEUE] Steer injection failed after ${MAX_WAIT_MS}ms timeout`);
-}

package/dist/src/compaction-provider.d.ts

@@ -0,0 +1,44 @@
+interface CompactionConfig {
+    uid: string;
+    baseUrl: string;
+    modelName: string;
+    apiKey?: string;
+}
+/**
+ * Snapshot of the resolved session context, captured from the last normal
+ * LLM request before compaction is triggered. When available, the
+ * CompactionProvider reuses the same A2A traceId/sessionId so the
+ * compaction summarization request is linked to the same user session
+ * in backend tracing.
+ */
+interface CompactionSessionSnapshot {
+    traceId: string;
+    sessionId: string;
+    interactionId: string;
+    deviceType?: string;
+    appVer?: string;
+    sdkApiVersion?: string;
+}
+/** Store config captured from prepareExtraParams so summarize() can read it. */
+export declare function setCompactionConfig(config: CompactionConfig | null): void;
+/**
+ * Store a snapshot of the resolved session headers captured from the
+ * most recent wrapStreamFn call. This lets the CompactionProvider reuse
+ * the A2A traceId/sessionId during compaction summarization.
+ */
+export declare function setCompactionSessionSnapshot(snapshot: CompactionSessionSnapshot | null): void;
+export declare const xiaoyiCompactionProvider: {
+    id: string;
+    label: string;
+    summarize(params: {
+        messages: unknown[];
+        signal?: AbortSignal;
+        customInstructions?: string;
+        summarizationInstructions?: {
+            identifierPolicy?: string;
+            identifierInstructions?: string;
+        };
+        previousSummary?: string;
+    }): Promise<string>;
+};
+export {};

package/dist/src/compaction-provider.js

@@ -0,0 +1,183 @@
+/**
+ * CompactionProvider for xiaoyi-channel.
+ *
+ * During compaction, the safeguard's built-in summarization path
+ * (summarizeInStages -> generateSummary -> completeSimple) bypasses the
+ * plugin's wrapStreamFn, so x-hag-trace-id is never injected. Registering
+ * a CompactionProvider intercepts the safeguard before it reaches the LLM
+ * path and makes the summarization API call ourselves with proper headers.
+ */
+import { createHash } from "crypto";
+import { logger } from "./utils/logger.js";
+// ── Header constants (mirrors provider.ts) ────────────────────────
+const HEADER_TRACE_ID = "x-hag-trace-id";
+const HEADER_SESSION_ID = "x-session-id";
+const HEADER_INTERACTION_ID = "x-interaction-id";
+// ── Summarization prompt ──────────────────────────────────────────
+const SUMMARIZATION_SYSTEM_PROMPT = "You are a structured conversation summarization assistant. " +
+    "Produce a concise summary that preserves key facts, decisions, " +
+    "in-progress tasks, tool results, and the latest user intent.";
+let storedConfig = null;
+let storedSessionSnapshot = null;
+/** Store config captured from prepareExtraParams so summarize() can read it. */
+export function setCompactionConfig(config) {
+    storedConfig = config;
+    if (config) {
+        logger.log(`[compaction-provider] config stored uid=${config.uid.slice(0, 8)}... ` +
+            `baseUrl=${config.baseUrl} model=${config.modelName}`);
+    }
+    else {
+        logger.warn("[compaction-provider] config cleared (uid or baseUrl missing)");
+    }
+}
+/**
+ * Store a snapshot of the resolved session headers captured from the
+ * most recent wrapStreamFn call. This lets the CompactionProvider reuse
+ * the A2A traceId/sessionId during compaction summarization.
+ */
+export function setCompactionSessionSnapshot(snapshot) {
+    storedSessionSnapshot = snapshot;
+}
+// ── Helpers ───────────────────────────────────────────────────────
+function encodeUid(uid) {
+    return createHash("sha256").update(uid).digest("hex").slice(0, 32);
+}
+function extractMessageText(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((block) => {
+            if (block && typeof block === "object" && block.type === "text") {
+                return String(block.text ?? "");
+            }
+            return "";
+        })
+            .filter(Boolean)
+            .join("\n");
+    }
+    return "";
+}
+function formatMessagesForSummarization(messages) {
+    const lines = [];
+    for (const msg of messages) {
+        if (!msg || typeof msg !== "object")
+            continue;
+        const m = msg;
+        if (m.role === "custom")
+            continue; // skip internal runtime messages
+        const role = String(m.role ?? "unknown");
+        const text = extractMessageText(m.content).trim();
+        if (!text)
+            continue;
+        let label;
+        if (role === "assistant") {
+            label = "Assistant";
+        }
+        else if (role === "user") {
+            label = "User";
+        }
+        else if (role === "toolResult") {
+            const toolName = typeof m.toolName === "string" && m.toolName ? m.toolName : "tool";
+            label = `Tool result (${toolName})`;
+        }
+        else {
+            label = role;
+        }
+        lines.push(`[${label}]: ${text}`);
+    }
+    return lines.join("\n\n");
+}
+// ── CompactionProvider ────────────────────────────────────────────
+export const xiaoyiCompactionProvider = {
+    id: "xiaoyiprovider",
+    label: "Xiaoyi Compaction Provider",
+    async summarize(params) {
+        const cfg = storedConfig;
+        if (!cfg) {
+            // No stored config: let the safeguard fall through to the LLM path.
+            // Throwing here is intentional — tryProviderSummarize catches and
+            // falls through.
+            throw new Error("Compaction config not available (uid or baseUrl missing)");
+        }
+        // Use the A2A session snapshot when available (captured from the last
+        // normal wrapStreamFn call before compaction was triggered). Otherwise
+        // fall back to the uid_timestamp pattern.
+        const session = storedSessionSnapshot;
+        const traceId = session?.traceId ?? `${encodeUid(cfg.uid)}_${Date.now()}`;
+        const sessionId = session?.sessionId ?? traceId;
+        const interactionId = session?.interactionId ?? traceId;
+        logger.log(`[compaction-provider] summarize traceId=${traceId} source=${session ? "a2a-snapshot" : "uid-fallback"} msgCount=${params.messages.length}`);
+        // ── Build prompt ──────────────────────────────────────────────
+        const conversationText = formatMessagesForSummarization(params.messages);
+        let promptText = `<conversation>\n${conversationText}\n</conversation>`;
+        if (params.previousSummary) {
+            promptText += `\n\n<previous-summary>\n${params.previousSummary}\n</previous-summary>`;
+        }
+        let instructions = "Provide a concise but comprehensive summary of the conversation above. " +
+            "Include: key decisions, in-progress tasks, tool results, file operations, " +
+            "and the latest user request. Preserve exact file paths, URLs, identifiers, " +
+            "and error messages.";
+        if (params.customInstructions) {
+            instructions += `\n\nAdditional focus: ${params.customInstructions}`;
+        }
+        promptText += `\n\n${instructions}`;
+        // ── Build request ─────────────────────────────────────────────
+        const headers = {
+            "Content-Type": "application/json",
+            [HEADER_TRACE_ID]: traceId,
+            [HEADER_SESSION_ID]: sessionId,
+            [HEADER_INTERACTION_ID]: interactionId,
+        };
+        if (session?.deviceType) {
+            headers["x-device-type"] = session.deviceType;
+        }
+        if (session?.appVer) {
+            headers["x-app-ver"] = session.appVer;
+        }
+        if (session?.sdkApiVersion) {
+            headers["x-sdk-api-version"] = session.sdkApiVersion;
+        }
+        if (cfg.apiKey) {
+            headers["Authorization"] = `Bearer ${cfg.apiKey}`;
+        }
+        const body = {
+            model: cfg.modelName,
+            messages: [
+                { role: "system", content: SUMMARIZATION_SYSTEM_PROMPT },
+                { role: "user", content: promptText },
+            ],
+            max_tokens: 4096,
+            temperature: 0.3,
+        };
+        const url = `${cfg.baseUrl.replace(/\/+$/, "")}/chat/completions`;
+        logger.log(`[compaction-provider] POST ${url}`);
+        // ── Call ──────────────────────────────────────────────────────
+        let response;
+        try {
+            response = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: params.signal,
+            });
+        }
+        catch (err) {
+            logger.error(`[compaction-provider] fetch failed: ${String(err)}`);
+            throw err;
+        }
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => "");
+            logger.error(`[compaction-provider] API error status=${response.status} body=${errorText.slice(0, 500)}`);
+            throw new Error(`Compaction API returned ${response.status}`);
+        }
+        const data = (await response.json());
+        const summary = data.choices?.[0]?.message?.content;
+        if (!summary?.trim()) {
+            logger.warn("[compaction-provider] empty summary returned");
+            throw new Error("Empty summary from compaction API");
+        }
+        logger.log(`[compaction-provider] done summaryLen=${summary.length}`);
+        return summary;
+    },
+};