@ynhcj/xiaoyi-channel 0.0.197-beta → 0.0.198-beta

package/dist/src/acp-session-binding.d.ts

@@ -0,0 +1,37 @@
+import { type BindingTargetKind } from "openclaw/plugin-sdk/conversation-runtime";
+type XyBindingTargetKind = "subagent" | "acp";
+type XyAcpBindingRecord = {
+    accountId: string;
+    conversationId: string;
+    parentConversationId?: string;
+    deliveryTo?: string;
+    targetKind: XyBindingTargetKind;
+    targetSessionKey: string;
+    agentId?: string;
+    label?: string;
+    boundBy?: string;
+    boundAt: number;
+    lastActivityAt: number;
+};
+type XyAcpBindingManager = {
+    accountId: string;
+    getByConversationId: (conversationId: string) => XyAcpBindingRecord | undefined;
+    listBySessionKey: (targetSessionKey: string) => XyAcpBindingRecord[];
+    bindConversation: (params: {
+        conversationId: string;
+        parentConversationId?: string;
+        targetKind: BindingTargetKind;
+        targetSessionKey: string;
+        metadata?: Record<string, unknown>;
+    }) => XyAcpBindingRecord | null;
+    touchConversation: (conversationId: string, at?: number) => XyAcpBindingRecord | null;
+    unbindConversation: (conversationId: string) => XyAcpBindingRecord | null;
+    unbindBySessionKey: (targetSessionKey: string) => XyAcpBindingRecord[];
+    stop: () => void;
+};
+export declare function createXyAcpBindingManager(params: {
+    accountId?: string;
+    cfg: any;
+}): XyAcpBindingManager;
+export declare function getXyAcpBindingManager(accountId?: string): XyAcpBindingManager | null;
+export {};

package/dist/src/acp-session-binding.js

@@ -0,0 +1,237 @@
+// ACP Session Binding Adapter for xiaoyi-channel.
+// Follows the feishu thread-bindings.ts pattern.
+//
+// Maps A2A sessionId (stable conversation identifier) to ACP/subagent
+// session keys so that openclaw can bind spawned sessions to the
+// current xiaoyi conversation.
+//
+// Key design: xiaoyi-channel only supports `placement: "current"` —
+// it cannot create child threads (unlike Discord). All spawned sessions
+// are bound to the current A2A conversation identified by sessionId.
+// NOTE: Using `any` for cfg type to avoid version mismatch between
+// local and global openclaw installs (auth.profiles.aws-sdk union).
+import { resolveThreadBindingIdleTimeoutMsForChannel, resolveThreadBindingMaxAgeMsForChannel, resolveThreadBindingConversationIdFromBindingId, registerSessionBindingAdapter, unregisterSessionBindingAdapter, } from "openclaw/plugin-sdk/conversation-runtime";
+import { normalizeAccountId, resolveAgentIdFromSessionKey } from "openclaw/plugin-sdk/routing";
+import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { logger } from "./utils/logger.js";
+// ─── Global state (survives module dedup) ─────────────────────
+const XY_ACP_BINDINGS_KEY = Symbol.for("openclaw.xyAcpBindingsState");
+let state;
+function getState() {
+    if (!state) {
+        const globalStore = globalThis;
+        state = globalStore[XY_ACP_BINDINGS_KEY] ?? {
+            managersByAccountId: new Map(),
+            bindingsByAccountConversation: new Map(),
+        };
+        globalStore[XY_ACP_BINDINGS_KEY] = state;
+    }
+    return state;
+}
+function resolveBindingKey(params) {
+    return `${params.accountId}:${params.conversationId}`;
+}
+// ─── Kind conversion ──────────────────────────────────────────
+function toSessionBindingTargetKind(raw) {
+    return raw === "subagent" ? "subagent" : "session";
+}
+function toXyTargetKind(raw) {
+    return raw === "subagent" ? "subagent" : "acp";
+}
+// ─── Record conversion ────────────────────────────────────────
+function toSessionBindingRecord(record, defaults) {
+    const idleExpiresAt = defaults.idleTimeoutMs > 0 ? record.lastActivityAt + defaults.idleTimeoutMs : undefined;
+    const maxAgeExpiresAt = defaults.maxAgeMs > 0 ? record.boundAt + defaults.maxAgeMs : undefined;
+    const expiresAt = idleExpiresAt != null && maxAgeExpiresAt != null
+        ? Math.min(idleExpiresAt, maxAgeExpiresAt)
+        : (idleExpiresAt ?? maxAgeExpiresAt);
+    return {
+        bindingId: resolveBindingKey({
+            accountId: record.accountId,
+            conversationId: record.conversationId,
+        }),
+        targetSessionKey: record.targetSessionKey,
+        targetKind: toSessionBindingTargetKind(record.targetKind),
+        conversation: {
+            channel: "xiaoyi-channel",
+            accountId: record.accountId,
+            conversationId: record.conversationId,
+            parentConversationId: record.parentConversationId,
+        },
+        status: "active",
+        boundAt: record.boundAt,
+        expiresAt,
+        metadata: {
+            agentId: record.agentId,
+            label: record.label,
+            boundBy: record.boundBy,
+            deliveryTo: record.deliveryTo,
+            lastActivityAt: record.lastActivityAt,
+            idleTimeoutMs: defaults.idleTimeoutMs,
+            maxAgeMs: defaults.maxAgeMs,
+        },
+    };
+}
+// ─── Manager factory ──────────────────────────────────────────
+export function createXyAcpBindingManager(params) {
+    const accountId = normalizeAccountId(params.accountId);
+    const existing = getState().managersByAccountId.get(accountId);
+    if (existing) {
+        return existing;
+    }
+    const idleTimeoutMs = resolveThreadBindingIdleTimeoutMsForChannel({
+        cfg: params.cfg,
+        channel: "xiaoyi-channel",
+        accountId,
+    });
+    const maxAgeMs = resolveThreadBindingMaxAgeMsForChannel({
+        cfg: params.cfg,
+        channel: "xiaoyi-channel",
+        accountId,
+    });
+    const log = logger.withContext("", "");
+    const manager = {
+        accountId,
+        getByConversationId: (conversationId) => getState().bindingsByAccountConversation.get(resolveBindingKey({ accountId, conversationId })),
+        listBySessionKey: (targetSessionKey) => [...getState().bindingsByAccountConversation.values()].filter((record) => record.accountId === accountId && record.targetSessionKey === targetSessionKey),
+        bindConversation: ({ conversationId, parentConversationId, targetKind, targetSessionKey, metadata, }) => {
+            const normalizedConversationId = conversationId.trim();
+            const normalizedTargetSessionKey = targetSessionKey.trim();
+            if (!normalizedConversationId || !normalizedTargetSessionKey) {
+                return null;
+            }
+            const existingLocal = getState().bindingsByAccountConversation.get(resolveBindingKey({ accountId, conversationId: normalizedConversationId }));
+            const now = Date.now();
+            const record = {
+                accountId,
+                conversationId: normalizedConversationId,
+                parentConversationId: normalizeOptionalString(parentConversationId) ?? existingLocal?.parentConversationId,
+                deliveryTo: typeof metadata?.deliveryTo === "string" && metadata.deliveryTo.trim()
+                    ? metadata.deliveryTo.trim()
+                    : existingLocal?.deliveryTo,
+                targetKind: toXyTargetKind(targetKind),
+                targetSessionKey: normalizedTargetSessionKey,
+                agentId: typeof metadata?.agentId === "string" && metadata.agentId.trim()
+                    ? metadata.agentId.trim()
+                    : (existingLocal?.agentId ?? resolveAgentIdFromSessionKey(normalizedTargetSessionKey)),
+                label: typeof metadata?.label === "string" && metadata.label.trim()
+                    ? metadata.label.trim()
+                    : existingLocal?.label,
+                boundBy: typeof metadata?.boundBy === "string" && metadata.boundBy.trim()
+                    ? metadata.boundBy.trim()
+                    : existingLocal?.boundBy,
+                boundAt: now,
+                lastActivityAt: now,
+            };
+            getState().bindingsByAccountConversation.set(resolveBindingKey({ accountId, conversationId: normalizedConversationId }), record);
+            log.log(`[XY-ACP-BIND] Bound ${targetKind} session ${normalizedTargetSessionKey.slice(0, 30)} to conversation ${normalizedConversationId.slice(0, 12)}`);
+            return record;
+        },
+        touchConversation: (conversationId, at = Date.now()) => {
+            const key = resolveBindingKey({ accountId, conversationId });
+            const existingRecord = getState().bindingsByAccountConversation.get(key);
+            if (!existingRecord) {
+                return null;
+            }
+            const updated = { ...existingRecord, lastActivityAt: at };
+            getState().bindingsByAccountConversation.set(key, updated);
+            return updated;
+        },
+        unbindConversation: (conversationId) => {
+            const key = resolveBindingKey({ accountId, conversationId });
+            const existingRecord = getState().bindingsByAccountConversation.get(key);
+            if (!existingRecord) {
+                return null;
+            }
+            getState().bindingsByAccountConversation.delete(key);
+            return existingRecord;
+        },
+        unbindBySessionKey: (targetSessionKey) => {
+            const removed = [];
+            for (const record of getState().bindingsByAccountConversation.values()) {
+                if (record.accountId !== accountId || record.targetSessionKey !== targetSessionKey) {
+                    continue;
+                }
+                getState().bindingsByAccountConversation.delete(resolveBindingKey({ accountId, conversationId: record.conversationId }));
+                removed.push(record);
+            }
+            return removed;
+        },
+        stop: () => {
+            for (const key of getState().bindingsByAccountConversation.keys()) {
+                if (key.startsWith(`${accountId}:`)) {
+                    getState().bindingsByAccountConversation.delete(key);
+                }
+            }
+            getState().managersByAccountId.delete(accountId);
+            unregisterSessionBindingAdapter({
+                channel: "xiaoyi-channel",
+                accountId,
+                adapter: sessionBindingAdapter,
+            });
+            log.log(`[XY-ACP-BIND] Stopped binding manager for account ${accountId}`);
+        },
+    };
+    const sessionBindingAdapter = {
+        channel: "xiaoyi-channel",
+        accountId,
+        capabilities: {
+            placements: ["current"],
+        },
+        bind: async (input) => {
+            if (input.conversation.channel !== "xiaoyi-channel" || input.placement === "child") {
+                return null;
+            }
+            const bound = manager.bindConversation({
+                conversationId: input.conversation.conversationId,
+                parentConversationId: input.conversation.parentConversationId,
+                targetKind: input.targetKind,
+                targetSessionKey: input.targetSessionKey,
+                metadata: input.metadata,
+            });
+            return bound ? toSessionBindingRecord(bound, { idleTimeoutMs, maxAgeMs }) : null;
+        },
+        listBySession: (targetSessionKey) => manager
+            .listBySessionKey(targetSessionKey)
+            .map((entry) => toSessionBindingRecord(entry, { idleTimeoutMs, maxAgeMs })),
+        resolveByConversation: (ref) => {
+            if (ref.channel !== "xiaoyi-channel") {
+                return null;
+            }
+            const found = manager.getByConversationId(ref.conversationId);
+            return found ? toSessionBindingRecord(found, { idleTimeoutMs, maxAgeMs }) : null;
+        },
+        touch: (bindingId, at) => {
+            const conversationId = resolveThreadBindingConversationIdFromBindingId({
+                accountId,
+                bindingId,
+            });
+            if (conversationId) {
+                manager.touchConversation(conversationId, at);
+            }
+        },
+        unbind: async (input) => {
+            if (input.targetSessionKey?.trim()) {
+                return manager
+                    .unbindBySessionKey(input.targetSessionKey.trim())
+                    .map((entry) => toSessionBindingRecord(entry, { idleTimeoutMs, maxAgeMs }));
+            }
+            const conversationId = resolveThreadBindingConversationIdFromBindingId({
+                accountId,
+                bindingId: input.bindingId,
+            });
+            if (!conversationId) {
+                return [];
+            }
+            const removed = manager.unbindConversation(conversationId);
+            return removed ? [toSessionBindingRecord(removed, { idleTimeoutMs, maxAgeMs })] : [];
+        },
+    };
+    registerSessionBindingAdapter(sessionBindingAdapter);
+    getState().managersByAccountId.set(accountId, manager);
+    log.log(`[XY-ACP-BIND] Created binding manager for account ${accountId} (idleTimeout=${idleTimeoutMs}ms, maxAge=${maxAgeMs}ms)`);
+    return manager;
+}
+export function getXyAcpBindingManager(accountId) {
+    return getState().managersByAccountId.get(normalizeAccountId(accountId)) ?? null;
+}

package/dist/src/log-reporter/config-loader.d.ts

@@ -0,0 +1,11 @@
+import type { LogReporterConfig } from "./types.js";
+/**
+ * Load and validate the JSON config file.
+ * Falls back to defaults for optional fields.
+ */
+export declare function loadConfig(configPath: string): LogReporterConfig;
+/**
+ * Resolve a path template with date wildcards to actual file paths on disk.
+ * Scans the directory and returns all files matching the pattern.
+ */
+export declare function resolveLogFiles(templatePath: string): string[];

package/dist/src/log-reporter/config-loader.js

@@ -0,0 +1,68 @@
+// Config loader: reads JSON config file, validates fields, resolves date wildcards to actual files
+import { readFileSync, readdirSync } from "fs";
+import { dirname, basename, join } from "path";
+// Replace longer tokens first to avoid partial matches
+const WILDCARD_TOKENS = [
+    ["{year-month-day}", "\\d{4}-\\d{2}-\\d{2}"],
+    ["{year}{month}{day}", "\\d{8}"],
+    ["{year}", "\\d{4}"],
+    ["{month}", "\\d{2}"],
+    ["{day}", "\\d{2}"],
+];
+/**
+ * Load and validate the JSON config file.
+ * Falls back to defaults for optional fields.
+ */
+export function loadConfig(configPath) {
+    const raw = readFileSync(configPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!parsed.logFiles || !Array.isArray(parsed.logFiles) || parsed.logFiles.length === 0) {
+        throw new Error("log-reporter config: 'logFiles' must be a non-empty array");
+    }
+    for (const lf of parsed.logFiles) {
+        if (!lf.path || !lf.name) {
+            throw new Error(`log-reporter config: each logFile must have 'path' and 'name', got ${JSON.stringify(lf)}`);
+        }
+    }
+    return {
+        scanIntervalMs: parsed.scanIntervalMs ?? 600000,
+        bakDir: parsed.bakDir ?? "/tmp/openclaw",
+        reportUrl: parsed.reportUrl ?? "",
+        logFiles: parsed.logFiles,
+    };
+}
+/**
+ * Convert a path with date wildcards into a RegExp that matches the filename part only.
+ * Returns { dir, regex } where dir is the directory portion and regex matches filenames.
+ */
+function pathToPattern(templatePath) {
+    const dir = dirname(templatePath);
+    let pattern = basename(templatePath);
+    // Escape regex special chars in the literal parts, then replace tokens
+    pattern = escapeRegex(pattern);
+    for (const [token, replacement] of WILDCARD_TOKENS) {
+        pattern = pattern.replaceAll(escapeRegex(token), replacement);
+    }
+    return { dir, regex: new RegExp(`^${pattern}$`) };
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Resolve a path template with date wildcards to actual file paths on disk.
+ * Scans the directory and returns all files matching the pattern.
+ */
+export function resolveLogFiles(templatePath) {
+    const { dir, regex } = pathToPattern(templatePath);
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((f) => regex.test(f))
+        .map((f) => join(dir, f))
+        .sort(); // chronological order for date-named logs
+}

package/dist/src/log-reporter/cursor-store.d.ts

@@ -0,0 +1,5 @@
+import type { CursorStore, FileCursor } from "./types.js";
+export declare function loadCursorStore(storePath: string): CursorStore;
+export declare function saveCursorStore(storePath: string, store: CursorStore): void;
+export declare function getCursor(store: CursorStore, filePath: string): FileCursor | undefined;
+export declare function setCursor(store: CursorStore, filePath: string, cursor: FileCursor): void;

package/dist/src/log-reporter/cursor-store.js

@@ -0,0 +1,26 @@
+// Cursor state persistence — reads/writes FileCursor entries keyed by file path
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { dirname } from "path";
+export function loadCursorStore(storePath) {
+    try {
+        const raw = readFileSync(storePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return { files: parsed.files ?? {} };
+    }
+    catch {
+        return { files: {} };
+    }
+}
+export function saveCursorStore(storePath, store) {
+    try {
+        mkdirSync(dirname(storePath), { recursive: true });
+    }
+    catch { }
+    writeFileSync(storePath, JSON.stringify(store, null, 2), "utf-8");
+}
+export function getCursor(store, filePath) {
+    return store.files[filePath];
+}
+export function setCursor(store, filePath, cursor) {
+    store.files[filePath] = cursor;
+}

package/dist/src/log-reporter/index.d.ts

@@ -0,0 +1,10 @@
+import type { LogReporterOptions } from "./types.js";
+/**
+ * Start the log reporter. Runs the first scan immediately, then on the configured interval.
+ * Returns a stop function.
+ */
+export declare function startLogReporter(options: LogReporterOptions): Promise<() => void>;
+/**
+ * Stop the log reporter timer.
+ */
+export declare function stopLogReporter(): void;

package/dist/src/log-reporter/index.js

@@ -0,0 +1,77 @@
+// Log Reporter Framework
+// Self-contained periodic log scanner + uploader + reporter.
+// Start via startLogReporter(), stop via stopLogReporter().
+import { resolveLogFiles, loadConfig } from "./config-loader.js";
+import { scanFile } from "./scanner.js";
+import { uploadIncrementalContent } from "./uploader.js";
+import { sendReport } from "./reporter.js";
+import { loadCursorStore, saveCursorStore, setCursor } from "./cursor-store.js";
+import { join } from "path";
+let intervalId = null;
+let isRunning = false;
+/**
+ * Start the log reporter. Runs the first scan immediately, then on the configured interval.
+ * Returns a stop function.
+ */
+export async function startLogReporter(options) {
+    const config = loadConfig(options.configPath);
+    const cursorPath = join(config.bakDir, ".log-reporter-cursor.json");
+    console.log(`[log-reporter] Starting with interval ${config.scanIntervalMs}ms, ${config.logFiles.length} log file(s) configured`);
+    async function doScan() {
+        if (isRunning)
+            return; // skip if previous scan still running
+        isRunning = true;
+        try {
+            const cursorStore = loadCursorStore(cursorPath);
+            for (const logFile of config.logFiles) {
+                const resolvedFiles = resolveLogFiles(logFile.path);
+                console.log(`[log-reporter] Scanning "${logFile.name}": pattern=${logFile.path}, resolved ${resolvedFiles.length} file(s)`);
+                for (const filePath of resolvedFiles) {
+                    await processFile(filePath, logFile.name, config, cursorStore, options);
+                }
+            }
+            saveCursorStore(cursorPath, cursorStore);
+        }
+        catch (err) {
+            console.error("[log-reporter] Scan failed:", err);
+        }
+        finally {
+            isRunning = false;
+        }
+    }
+    // Run first scan immediately
+    await doScan();
+    // Schedule periodic scans
+    intervalId = setInterval(doScan, config.scanIntervalMs);
+    intervalId.unref?.();
+    return () => stopLogReporter();
+}
+async function processFile(filePath, name, config, cursorStore, options) {
+    try {
+        const result = await scanFile(filePath, name, cursorStore);
+        if (!result)
+            return;
+        console.log(`[log-reporter] New content in "${name}": ${filePath} lines ${result.lineStart}-${result.lineEnd} (${result.newLineCount} lines)`);
+        // Upload .bak → get URL
+        const url = await uploadIncrementalContent(result, config.bakDir, options.uploadService);
+        console.log(`[log-reporter] Uploaded .bak for "${name}", url: ${url}`);
+        // Send report (mock)
+        await sendReport(config.reportUrl, url, result);
+        // Only persist cursor after successful upload + report
+        setCursor(cursorStore, filePath, result.newCursor);
+    }
+    catch (err) {
+        console.error(`[log-reporter] Failed processing "${name}" (${filePath}):`, err);
+        // Cursor NOT updated — will retry on next scan
+    }
+}
+/**
+ * Stop the log reporter timer.
+ */
+export function stopLogReporter() {
+    if (intervalId !== null) {
+        clearInterval(intervalId);
+        intervalId = null;
+        console.log("[log-reporter] Stopped");
+    }
+}

package/dist/src/log-reporter/reporter.d.ts

@@ -0,0 +1,6 @@
+import type { ScanResult } from "./types.js";
+/**
+ * Send a log report to the server with the uploaded file URL.
+ * MOCK implementation — real request logic will be added later.
+ */
+export declare function sendReport(reportUrl: string, fileUrl: string, result: ScanResult): Promise<void>;

package/dist/src/log-reporter/reporter.js

@@ -0,0 +1,17 @@
+/**
+ * Send a log report to the server with the uploaded file URL.
+ * MOCK implementation — real request logic will be added later.
+ */
+export async function sendReport(reportUrl, fileUrl, result) {
+    // TODO: Replace with actual HTTP request
+    const payload = {
+        logName: result.name,
+        filePath: result.filePath,
+        lineStart: result.lineStart,
+        lineEnd: result.lineEnd,
+        newLineCount: result.newLineCount,
+        fileUrl,
+        timestamp: new Date().toISOString(),
+    };
+    console.log(`[log-reporter] Mock report to ${reportUrl}:`, JSON.stringify(payload, null, 2));
+}

package/dist/src/log-reporter/scanner.d.ts

@@ -0,0 +1,6 @@
+import type { ScanResult, CursorStore } from "./types.js";
+/**
+ * Scan a single log file for new content.
+ * Returns a ScanResult if there are new lines, or null if no changes.
+ */
+export declare function scanFile(filePath: string, name: string, cursorStore: CursorStore): Promise<ScanResult | null>;

package/dist/src/log-reporter/scanner.js

@@ -0,0 +1,82 @@
+// Core scanner: resolves wildcard paths, reads incremental log content using byte-offset cursors
+import { statSync, createReadStream } from "fs";
+import { getCursor } from "./cursor-store.js";
+/**
+ * Read file content starting from a byte offset.
+ * Returns the full text content from that offset to end of file.
+ */
+function readFromOffset(filePath, startByte) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        const stream = createReadStream(filePath, {
+            start: startByte,
+            encoding: "utf-8",
+        });
+        stream.on("data", (chunk) => chunks.push(chunk));
+        stream.on("end", () => resolve(chunks.join("")));
+        stream.on("error", reject);
+    });
+}
+/**
+ * Determine the byte offset to start reading from, based on file state and cursor.
+ * Returns the startByte (0-based) or null if no new content.
+ */
+function resolveStartByte(currentSize, currentMtimeMs, cursor) {
+    if (!cursor) {
+        // New file: first scan — read from beginning
+        return 0;
+    }
+    if (currentSize > cursor.lastSize) {
+        // File grew: read from where we left off
+        return cursor.lastSize;
+    }
+    if (currentSize < cursor.lastSize && currentMtimeMs > cursor.lastModified) {
+        // File was rotated (truncated + rewritten): reset to beginning
+        return 0;
+    }
+    // No change (currentSize === cursor.lastSize) or edge case — skip
+    return null;
+}
+/**
+ * Scan a single log file for new content.
+ * Returns a ScanResult if there are new lines, or null if no changes.
+ */
+export async function scanFile(filePath, name, cursorStore) {
+    let stats;
+    try {
+        stats = statSync(filePath);
+    }
+    catch {
+        // File doesn't exist (yet) or was deleted — skip
+        return null;
+    }
+    const currentSize = stats.size;
+    const currentMtimeMs = stats.mtimeMs;
+    const cursor = getCursor(cursorStore, filePath);
+    const startByte = resolveStartByte(currentSize, currentMtimeMs, cursor);
+    if (startByte === null) {
+        return null; // no new content
+    }
+    const content = await readFromOffset(filePath, startByte);
+    // Count new lines — each \n represents one log line
+    const newLineCount = content.length > 0 ? content.split("\n").length - 1 : 0;
+    if (newLineCount === 0) {
+        // No complete lines yet (partial write), don't report
+        return null;
+    }
+    const prevLine = cursor?.lastLine ?? 0;
+    const newCursor = {
+        lastSize: currentSize,
+        lastLine: prevLine + newLineCount,
+        lastModified: currentMtimeMs,
+    };
+    return {
+        filePath,
+        name,
+        content,
+        lineStart: prevLine + 1,
+        lineEnd: prevLine + newLineCount,
+        newLineCount,
+        newCursor,
+    };
+}

package/dist/src/log-reporter/types.d.ts

@@ -0,0 +1,59 @@
+/** Configuration for a single log file to monitor */
+export interface LogFileConfig {
+    /** File path with optional date wildcards: {year}, {month}, {day}, {year-month-day}, {year}{month}{day} */
+    path: string;
+    /** Logical name used in .bak filename and reporting */
+    name: string;
+}
+/** Top-level log reporter configuration (loaded from JSON file) */
+export interface LogReporterConfig {
+    /** Scan interval in milliseconds (default: 600000 = 10 min) */
+    scanIntervalMs: number;
+    /** Directory for .bak files and cursor state */
+    bakDir: string;
+    /** Report server URL (mock for now) */
+    reportUrl: string;
+    /** Log files to monitor */
+    logFiles: LogFileConfig[];
+}
+/** Cursor state for a single log file */
+export interface FileCursor {
+    /** Byte offset we last read to */
+    lastSize: number;
+    /** Cumulative line count read so far */
+    lastLine: number;
+    /** File mtime (ms) at last read */
+    lastModified: number;
+}
+/** Persisted cursor store structure */
+export interface CursorStore {
+    files: Record<string, FileCursor>;
+}
+/** Result of scanning a single log file */
+export interface ScanResult {
+    /** Resolved absolute file path */
+    filePath: string;
+    /** Logical name from config */
+    name: string;
+    /** The new log lines (incremental content) */
+    content: string;
+    /** Start line number (1-based, inclusive) */
+    lineStart: number;
+    /** End line number (1-based, inclusive) */
+    lineEnd: number;
+    /** Number of new lines */
+    newLineCount: number;
+    /** Updated cursor to persist after successful upload */
+    newCursor: FileCursor;
+}
+/** Options passed to startLogReporter */
+export interface LogReporterOptions {
+    /** Absolute path to the JSON config file */
+    configPath: string;
+    /** File upload service instance (from xy_channel) */
+    uploadService: UploadService;
+}
+/** Minimal interface for the upload service (duck-typed from XYFileUploadService) */
+export interface UploadService {
+    uploadFileAndGetUrl(filePath: string, objectType?: string): Promise<string>;
+}

package/dist/src/log-reporter/types.js

@@ -0,0 +1,2 @@
+// Type definitions for log reporter framework
+export {};

package/dist/src/log-reporter/uploader.d.ts

@@ -0,0 +1,6 @@
+import type { UploadService, ScanResult } from "./types.js";
+/**
+ * Write incremental content to .bak file, upload, and return the URL.
+ * Cleans up .bak file regardless of success/failure.
+ */
+export declare function uploadIncrementalContent(result: ScanResult, bakDir: string, uploadService: UploadService): Promise<string>;

package/dist/src/log-reporter/uploader.js

@@ -0,0 +1,32 @@
+// Uploader: creates .bak file, uploads via XYFileUploadService, cleans up
+import { writeFileSync, unlinkSync } from "fs";
+import { join } from "path";
+import { mkdirSync } from "fs";
+/**
+ * Write incremental content to .bak file, upload, and return the URL.
+ * Cleans up .bak file regardless of success/failure.
+ */
+export async function uploadIncrementalContent(result, bakDir, uploadService) {
+    const timestamp = Date.now();
+    const bakFileName = `${result.name}_${timestamp}.bak`;
+    const bakPath = join(bakDir, bakFileName);
+    // Ensure bakDir exists
+    try {
+        mkdirSync(bakDir, { recursive: true });
+    }
+    catch { }
+    try {
+        // Write incremental content to .bak file
+        writeFileSync(bakPath, result.content, "utf-8");
+        // Upload and get URL
+        const url = await uploadService.uploadFileAndGetUrl(bakPath);
+        return url;
+    }
+    finally {
+        // Always clean up the .bak file
+        try {
+            unlinkSync(bakPath);
+        }
+        catch { }
+    }
+}

package/dist/src/memory-query-handler.js

@@ -267,7 +267,7 @@ function handleMemoryHistory() {
     // Build ans array sorted by date ascending, each entry is { <date>: [...] }.
     const ans = Array.from(byDate.keys())
         .sort()
-        .map((dateStr) => ({ [dateStr]: byDate.get(dateStr) }));
+        .map((dateStr) => ({ [dateStr]: byDate.get(dateStr).reverse() }));
     // Prune memory.log: keep only the last 30 days.
     try {
         const newContent = keptLines.length > 0 ? `${keptLines.join("\n")}\n` : "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ynhcj/xiaoyi-channel",
-  "version": "0.0.197-beta",
+  "version": "0.0.198-beta",
   "description": "OpenClaw Xiaoyi Channel plugin - Xiaoyi A2A protocol integration",
   "type": "module",
   "main": "./dist/index.js",