lightclaw2 0.0.1

package/dist/src/media.js

@@ -0,0 +1,87 @@
+/**
+ * LightClaw — 媒体文件处理工具
+ */
+import * as path from "node:path";
+// ============================================================
+// 解析 data URL → Buffer
+// ============================================================
+export function parseDataUrl(dataUrl) {
+    const match = dataUrl.match(/^data:([^;]+);base64,(.+)$/);
+    if (!match)
+        return null;
+    return { mimeType: match[1], buffer: Buffer.from(match[2], "base64") };
+}
+// ============================================================
+// 格式化文件大小
+// ============================================================
+export function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}GB`;
+}
+// ============================================================
+// MIME 类型猜测
+// ============================================================
+export function guessMimeByExt(ext) {
+    const map = {
+        ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
+        ".gif": "image/gif", ".webp": "image/webp", ".svg": "image/svg+xml",
+        ".mp3": "audio/mpeg", ".wav": "audio/wav", ".ogg": "audio/ogg",
+        ".mp4": "video/mp4", ".webm": "video/webm",
+        ".pdf": "application/pdf", ".txt": "text/plain",
+    };
+    return map[ext] || "application/octet-stream";
+}
+// ============================================================
+// 将 AI 引擎返回的 mediaUrl 列表转为 files[] 格式
+// ============================================================
+export async function mediaUrlsToFiles(urls, log) {
+    const files = [];
+    const { readFileSync, existsSync } = await import("node:fs");
+    for (const url of urls) {
+        try {
+            let buffer;
+            let mimeType;
+            let name;
+            if (url.startsWith("data:")) {
+                const parsed = parseDataUrl(url);
+                if (!parsed)
+                    continue;
+                buffer = parsed.buffer;
+                mimeType = parsed.mimeType;
+                name = "file";
+            }
+            else if (url.startsWith("http://") || url.startsWith("https://")) {
+                const resp = await fetch(url);
+                if (!resp.ok)
+                    continue;
+                buffer = Buffer.from(await resp.arrayBuffer());
+                mimeType = resp.headers.get("content-type") || "application/octet-stream";
+                name = url.split("/").pop()?.split("?")[0] || "file";
+            }
+            else if (existsSync(url)) {
+                buffer = readFileSync(url);
+                const ext = path.extname(url).toLowerCase();
+                mimeType = guessMimeByExt(ext);
+                name = path.basename(url);
+            }
+            else {
+                continue;
+            }
+            files.push({
+                name,
+                mimeType,
+                bytes: `data:${mimeType};base64,${buffer.toString("base64")}`,
+            });
+        }
+        catch (err) {
+            log?.warn?.(`[mediaUrlsToFiles] Failed to convert ${url}: ${err}`);
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=media.js.map

package/dist/src/media.js.map

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

package/dist/src/outbound.d.ts

@@ -0,0 +1,28 @@
+/**
+ * LightClaw — 出站消息适配器
+ *
+ * 处理 OpenClaw 框架层的主动消息发送（非 deliver 回调场景）。
+ * 例如：用户通过 /message 命令发消息、cron 定时任务触发等。
+ *
+ * 发送策略：
+ *   1. 优先通过 gateway 的 WS 长连接发送（socket-registry）
+ *   2. WS 不可用时 fallback 到 REST API（需配置 apiBaseUrl）
+ */
+import type { ChannelOutboundContext } from "openclaw/plugin-sdk";
+/**
+ * 发送文本消息
+ * 由 channel.outbound.sendText 调用
+ */
+export declare function sendText(ctx: ChannelOutboundContext): Promise<{
+    channel: string;
+    messageId: string;
+}>;
+/**
+ * 发送媒体消息
+ * 由 channel.outbound.sendMedia 调用
+ */
+export declare function sendMedia(ctx: ChannelOutboundContext): Promise<{
+    channel: string;
+    messageId: string;
+}>;
+//# sourceMappingURL=outbound.d.ts.map

package/dist/src/outbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../../src/outbound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AA2ElE;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,sBAAsB;;;GA0CzD;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,sBAAsB;;;GAmD1D"}

package/dist/src/outbound.js

@@ -0,0 +1,172 @@
+/**
+ * LightClaw — 出站消息适配器
+ *
+ * 处理 OpenClaw 框架层的主动消息发送（非 deliver 回调场景）。
+ * 例如：用户通过 /message 命令发消息、cron 定时任务触发等。
+ *
+ * 发送策略：
+ *   1. 优先通过 gateway 的 WS 长连接发送（socket-registry）
+ *   2. WS 不可用时 fallback 到 REST API（需配置 apiBaseUrl）
+ */
+import { resolveAccount, CHANNEL_KEY, DEFAULT_ACCOUNT_ID } from "./config.js";
+import { getAssistantRuntime } from "./runtime.js";
+import { getSocket, bufferMessage, hasEntry, getBotClientId } from "./socket-registry.js";
+/** 获取日志器 */
+function getLogger() {
+    return getAssistantRuntime().logging.getChildLogger({ module: "outbound" });
+}
+/** 生成消息 ID */
+let outboundMsgCounter = 0;
+function generateOutboundMsgId() {
+    const ts = Date.now().toString(36);
+    const rand = Math.random().toString(36).substring(2, 8);
+    const seq = (outboundMsgCounter++).toString(36);
+    return `ob-${ts}-${rand}-${seq}`;
+}
+/**
+ * 解析目标用户 ID：去掉 channel 前缀和 dm/group 前缀
+ */
+function resolveTarget(to) {
+    return to
+        .replace(new RegExp(`^${CHANNEL_KEY}:`, "i"), "")
+        .replace(/^(dm|group):/, "");
+}
+/**
+ * 通过 WS 发送消息。
+ *
+ * 策略：
+ *   1. socket connected → 直接发送
+ *   2. socket 断开但 entry 存在（正在重连中）→ 缓冲消息，重连后自动 flush
+ *   3. entry 不存在 → 返回 null（gateway 尚未启动或已销毁）
+ */
+function sendViaSocket(accountId, target, text, replyToId) {
+    const resolvedAccountId = accountId || DEFAULT_ACCOUNT_ID;
+    const entry = getSocket(resolvedAccountId);
+    const msgId = generateOutboundMsgId();
+    const message = {
+        msgId,
+        from: entry?.botClientId ?? getBotClientId(resolvedAccountId) ?? "",
+        to: target,
+        content: text,
+        timestamp: Date.now(),
+        replyToMsgId: replyToId ?? undefined,
+    };
+    if (entry) {
+        // Socket connected，直接发送
+        try {
+            entry.socket.emit("message:private", message);
+            getLogger().info(`[${CHANNEL_KEY}] outbound sent via WS: to=${target} msgId=${msgId}`);
+            return msgId;
+        }
+        catch (err) {
+            getLogger().warn(`[${CHANNEL_KEY}] outbound WS emit failed: ${err}`);
+            return null;
+        }
+    }
+    // Socket 断开但 entry 存在（正在自动重连），缓冲消息
+    if (hasEntry(resolvedAccountId)) {
+        const buffered = bufferMessage(resolvedAccountId, message);
+        if (buffered) {
+            getLogger().info(`[${CHANNEL_KEY}] outbound buffered (WS reconnecting): to=${target} msgId=${msgId}`);
+            return msgId;
+        }
+    }
+    // Entry 不存在，gateway 未启动或已销毁
+    return null;
+}
+/**
+ * 发送文本消息
+ * 由 channel.outbound.sendText 调用
+ */
+export async function sendText(ctx) {
+    const log = getLogger();
+    try {
+        const account = resolveAccount(ctx.cfg, ctx.accountId);
+        const target = resolveTarget(ctx.to);
+        // 优先走 WS
+        const wsMsgId = sendViaSocket(account.accountId, target, ctx.text, ctx.replyToId);
+        if (wsMsgId) {
+            return { channel: CHANNEL_KEY, messageId: wsMsgId };
+        }
+        // Fallback: REST API
+        if (!account.apiBaseUrl) {
+            throw new Error("WS not connected and apiBaseUrl not configured, cannot send outbound message");
+        }
+        log.info(`[${CHANNEL_KEY}] outbound fallback to REST API: to=${target}`);
+        const resp = await fetch(`${account.apiBaseUrl}/send`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${account.apiKey}`,
+            },
+            body: JSON.stringify({
+                target,
+                text: ctx.text,
+                replyToMessageId: ctx.replyToId,
+            }),
+        });
+        if (!resp.ok) {
+            const errText = await resp.text();
+            throw new Error(`Send failed (${resp.status}): ${errText}`);
+        }
+        const data = (await resp.json());
+        return { channel: CHANNEL_KEY, messageId: data.messageId ?? `msg_${Date.now()}` };
+    }
+    catch (err) {
+        log.error(`[${CHANNEL_KEY}] outbound.sendText error: ${err}`);
+        throw err;
+    }
+}
+/**
+ * 发送媒体消息
+ * 由 channel.outbound.sendMedia 调用
+ */
+export async function sendMedia(ctx) {
+    const log = getLogger();
+    try {
+        const account = resolveAccount(ctx.cfg, ctx.accountId);
+        const target = resolveTarget(ctx.to);
+        // 优先走 WS（媒体消息只发文本部分，因为 WS 不方便传大文件）
+        // 如果有 mediaUrl 且没有 REST API，仍用 WS 发文本
+        if (!ctx.mediaUrl) {
+            const wsMsgId = sendViaSocket(account.accountId, target, ctx.text, ctx.replyToId);
+            if (wsMsgId) {
+                return { channel: CHANNEL_KEY, messageId: wsMsgId };
+            }
+        }
+        // Fallback: REST API
+        if (!account.apiBaseUrl) {
+            // 没有 REST API 也没有 mediaUrl，用 WS 发文本
+            const wsMsgId = sendViaSocket(account.accountId, target, ctx.text, ctx.replyToId);
+            if (wsMsgId) {
+                return { channel: CHANNEL_KEY, messageId: wsMsgId };
+            }
+            throw new Error("WS not connected and apiBaseUrl not configured, cannot send outbound media");
+        }
+        log.info(`[${CHANNEL_KEY}] outbound media via REST API: to=${target}`);
+        const resp = await fetch(`${account.apiBaseUrl}/send-media`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${account.apiKey}`,
+            },
+            body: JSON.stringify({
+                target,
+                text: ctx.text,
+                mediaUrl: ctx.mediaUrl,
+                replyToMessageId: ctx.replyToId,
+            }),
+        });
+        if (!resp.ok) {
+            const errText = await resp.text();
+            throw new Error(`Send media failed (${resp.status}): ${errText}`);
+        }
+        const data = (await resp.json());
+        return { channel: CHANNEL_KEY, messageId: data.messageId ?? `msg_${Date.now()}` };
+    }
+    catch (err) {
+        log.error(`[${CHANNEL_KEY}] outbound.sendMedia error: ${err}`);
+        throw err;
+    }
+}
+//# sourceMappingURL=outbound.js.map

package/dist/src/outbound.js.map

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

package/dist/src/runtime.d.ts

@@ -0,0 +1,4 @@
+import type { PluginRuntime } from "openclaw/plugin-sdk";
+export declare function setAssistantRuntime(rt: PluginRuntime): void;
+export declare function getAssistantRuntime(): PluginRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/src/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAGnD"}

package/dist/src/runtime.js

@@ -0,0 +1,11 @@
+import { CHANNEL_KEY } from "./config.js";
+let runtime;
+export function setAssistantRuntime(rt) {
+    runtime = rt;
+}
+export function getAssistantRuntime() {
+    if (!runtime)
+        throw new Error(`[${CHANNEL_KEY}] PluginRuntime not initialized — register() not called yet`);
+    return runtime;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,IAAI,OAAkC,CAAC;AAEvC,MAAM,UAAU,mBAAmB,CAAC,EAAiB;IACnD,OAAO,GAAG,EAAE,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,IAAI,WAAW,6DAA6D,CAAC,CAAC;IAC5G,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/session-history.d.ts

@@ -0,0 +1,88 @@
+/**
+ * LightClaw — Session History Reader
+ *
+ * 直接读取 OpenClaw Gateway 的 JSONL session 文件，获取持久化的对话历史。
+ * 文件路径: ~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl
+ *
+ * JSONL 每行格式:
+ *   { "type": "session", ... }                ← session header (第一行)
+ *   { "type": "message", "message": { ... }}  ← 对话消息
+ *   { "type": "compaction", ... }             ← 上下文压缩标记
+ *   { "type": "model_change", ... }           ← 模型切换（跳过）
+ *   { "type": "thinking_level_change", ... }  ← 思考级别变更（跳过）
+ *   { "type": "custom", ... }                 ← 自定义元数据（跳过）
+ */
+/** 文件附件信息（从消息文本中提取） */
+export interface FileAttachmentInfo {
+    /** 原始文件名 */
+    name: string;
+    /** MIME 类型 */
+    mimeType?: string;
+    /** 文件大小描述（如 "3.0KB"） */
+    size?: string;
+    /** 文件路径或 URI */
+    uri?: string;
+}
+/** 标准化后返回给前端的历史消息 */
+export interface HistoryMessage {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    timestamp?: number;
+    /** 消息中包含的工具调用（可选） */
+    toolCalls?: Array<{
+        name: string;
+        args?: string;
+    }>;
+    /** 消息中包含的工具结果（可选） */
+    toolResult?: {
+        toolCallId?: string;
+        name?: string;
+        output?: string;
+    };
+    /** AI 的思考过程（可选） */
+    thinking?: string;
+    /** 消息中包含的文件附件（可选） */
+    files?: FileAttachmentInfo[];
+    /** 压缩标记 */
+    isCompaction?: boolean;
+}
+/**
+ * 根据 sessionKey 找到对应的 .jsonl transcript 文件路径
+ */
+export declare function resolveTranscriptPath(sessionKey: string, agentId?: string): string | null;
+export interface ReadHistoryOptions {
+    /** 最大返回条数，默认 200 */
+    limit?: number;
+    /** Agent ID，默认 "default" */
+    agentId?: string;
+    /** 只返回 user/assistant 消息（过滤 system/tool），默认 false */
+    chatOnly?: boolean;
+}
+/**
+ * 读取指定 sessionKey 的历史对话消息
+ *
+ * @param sessionKey - 会话标识（与 gateway.ts 中 route.sessionKey 一致）
+ * @param opts - 选项
+ * @returns 历史消息数组（按时间正序），如果找不到 session 返回空数组
+ */
+export declare function readSessionHistory(sessionKey: string, opts?: ReadHistoryOptions): HistoryMessage[];
+/**
+ * 读取指定 sessionKey 的历史消息（从文件末尾读取，大文件性能更好）
+ *
+ * 对于大文件（>1MB），不读取整个文件，而是从末尾读取指定字节数。
+ */
+export declare function readSessionHistoryTail(sessionKey: string, opts?: ReadHistoryOptions & {
+    maxBytes?: number;
+}): HistoryMessage[];
+/**
+ * 列出所有已知的 session（从 sessions.json 索引读取）
+ */
+export declare function listSessions(agentId?: string): Array<{
+    sessionKey: string;
+    sessionId: string;
+    updatedAt?: number;
+    label?: string;
+    displayName?: string;
+    channel?: string;
+}>;
+//# sourceMappingURL=session-history.d.ts.map

package/dist/src/session-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-history.d.ts","sourceRoot":"","sources":["../../src/session-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,uBAAuB;AACvB,MAAM,WAAW,kBAAkB;IACjC,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAqB;AACrB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,qBAAqB;IACrB,UAAU,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW;IACX,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA4ED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0BzF;AAsVD,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,cAAc,EAAE,CA4DlG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,kBAAkB,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,cAAc,EAAE,CAuElB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAaD"}