@core-workspace/infoflow-openclaw-plugin 2026.3.9 → 2026.3.27-beta.0

package/src/commands/logs.ts

@@ -0,0 +1,449 @@
+/**
+ * /infoflow-logs command
+ *
+ * 读取 OpenClaw 网关的结构化日志文件，筛选 Infoflow 相关条目并格式化输出。
+ * 帮助用户快速了解"收到了哪些消息、回复了什么、有没有报错"。
+ *
+ * 日志文件位置：/tmp/openclaw/openclaw-YYYY-MM-DD.log（jsonl 格式）
+ *
+ * 用法：
+ *   /infoflow-logs          — 展示最近 20 条会话记录
+ *   /infoflow-logs 50       — 展示最近 50 条
+ *   /infoflow-logs error    — 只看 ERROR 级别
+ *   /infoflow-logs warn     — 只看 WARN 及以上（含 ERROR）
+ *   /infoflow-logs error 50 — 组合：最近 50 条 ERROR
+ *
+ * 长输出由框架的 textChunkLimit（默认 1800 字符/条）自动分片发送。
+ * 总输出上限由 LOGS_TOTAL_CHAR_LIMIT 控制（默认 20000 字符）。
+ */
+
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+const LOG_DIR = "/tmp/openclaw";
+const DEFAULT_EVENTS = 20;
+const MAX_EVENTS = 200;
+/** 总输出字符上限 */
+const LOGS_TOTAL_CHAR_LIMIT = 20_000;
+
+// ---------------------------------------------------------------------------
+// Raw log entry parsing
+// ---------------------------------------------------------------------------
+
+type RawEntry = {
+  msg: string;
+  level: number; // 30=info, 40=warn, 50=error
+  timeStr: string; // HH:MM:SS
+  tsMs: number; // unix ms for grouping
+};
+
+function parseRawEntry(line: string): RawEntry | null {
+  const trimmed = line.trim();
+  if (!trimmed) return null;
+  try {
+    const obj = JSON.parse(trimmed) as Record<string, unknown>;
+    const field0 = String(obj["0"] ?? "");
+    const field1 = String(obj["1"] ?? "");
+    let msg = field1 || (!field0.startsWith("{") ? field0 : "");
+    if (!msg) return null;
+
+    // Strip embedded SDK timestamp+level prefix
+    msg = msg.replace(/^\d{4}-\d{2}-\d{2}T[\d:.Z]+\s*\[InfoFlow\]\s*\[\w+\]\s*/, "").trim();
+
+    const meta = obj["_meta"] as Record<string, unknown> | undefined;
+    const levelName = String(meta?.["logLevelName"] ?? "");
+    const level = Number(
+      obj["level"] ?? (levelName === "ERROR" ? 50 : levelName === "WARN" ? 40 : 30),
+    );
+
+    const time = obj["time"] as string | undefined;
+    let timeStr = "";
+    let tsMs = 0;
+    if (time) {
+      try {
+        const d = new Date(time);
+        timeStr = d.toLocaleTimeString("en-US", { hour12: false });
+        tsMs = d.getTime();
+      } catch {
+        /* ignore */
+      }
+    }
+
+    return { msg, level, timeStr, tsMs };
+  } catch {
+    return null;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Event model — one "event" = one logical thing that happened
+// ---------------------------------------------------------------------------
+
+type LogEvent =
+  | {
+      kind: "exchange";
+      time: string;
+      from: string;
+      text: string;
+      elapsed?: number;
+      replyLen: number;
+      replyCount: number;
+      replyTypes: string[];
+    }
+  | { kind: "ws"; time: string; detail: string; level: number }
+  | { kind: "error"; time: string; detail: string; level: number }
+  | { kind: "system"; time: string; detail: string };
+
+// ---------------------------------------------------------------------------
+// Aggregation: raw entries → events
+// ---------------------------------------------------------------------------
+
+function aggregateEvents(entries: RawEntry[]): LogEvent[] {
+  const events: LogEvent[] = [];
+
+  // State for building an exchange
+  let inExchange = false;
+  let fromUser = "";
+  let inText = "";
+  let dispatchTime = "";
+  let dispatchMs = 0;
+  let replyLen = 0;
+  let replyCount = 0;
+  let replyTypes: string[] = [];
+
+  function flushExchange() {
+    if (!inExchange) return;
+    events.push({
+      kind: "exchange",
+      time: dispatchTime,
+      from: fromUser,
+      text: inText,
+      replyLen,
+      replyCount,
+      replyTypes,
+    });
+    inExchange = false;
+    fromUser = "";
+    inText = "";
+    replyLen = 0;
+    replyCount = 0;
+    replyTypes = [];
+  }
+
+  for (const e of entries) {
+    const { msg, level, timeStr, tsMs } = e;
+
+    // ---- 收到消息（inbound）→ 开始新会话轮次 ----
+    // 格式: [inbound:dm] from=xxx, name=yyy, msgType=text, msgId=zzz, text=内容, images=0
+    const inboundDm = msg.match(
+      /^\[inbound:dm\] from=([^,]+),.*msgType=(\w+),.*\btext=(.*),\s*images=\d+/,
+    );
+    const inboundGroup = msg.match(
+      /^\[inbound:group\] from=([^,]+),.*\bgroup=(\d+),.*\btext=(.*),\s*images=\d+/,
+    );
+    if (inboundDm || inboundGroup) {
+      // 跳过 event 类型（连接/断开事件，不是真正的消息）
+      const msgType = inboundDm ? inboundDm[2] : "";
+      if (msgType === "event") continue;
+      flushExchange();
+      inExchange = true;
+      dispatchTime = timeStr;
+      dispatchMs = tsMs;
+      if (inboundDm) {
+        fromUser = inboundDm[1].trim();
+        inText = inboundDm[3]?.trim() ?? "";
+      } else if (inboundGroup) {
+        fromUser = `${inboundGroup[1].trim()}@群${inboundGroup[2]}`;
+        inText = inboundGroup[3]?.trim() ?? "";
+      }
+      continue;
+    }
+
+    // ---- 回复完成（dispatch:done）→ 记录耗时 ----
+    if (inExchange && msg.includes("[dispatch:done]")) {
+      const m = msg.match(/elapsed=(\d+)ms/);
+      if (m) {
+        const elapsed = parseInt(m[1], 10);
+        events.push({
+          kind: "exchange",
+          time: dispatchTime,
+          from: fromUser,
+          text: inText,
+          elapsed,
+          replyLen,
+          replyCount,
+          replyTypes: [...new Set(replyTypes)],
+        });
+        inExchange = false;
+        fromUser = "";
+        inText = "";
+        replyLen = 0;
+        replyCount = 0;
+        replyTypes = [];
+      }
+      continue;
+    }
+
+    // ---- 发出消息 ----
+    // 入口行: "[outbound] sendMessage: to=..., items=1, types=[markdown]" → 取类型
+    if (inExchange && msg.startsWith("[outbound] sendMessage:")) {
+      const typesM = msg.match(/types=\[([^\]]+)\]/);
+      if (typesM) replyTypes.push(...typesM[1].split(",").map((t) => t.trim()));
+      continue;
+    }
+    // 跳过 "[outbound] to=" 确认行（字数改用 outbound:dm/group 的 bodyLen 统计，更准确）
+    if (msg.startsWith("[outbound] to=")) continue;
+    // outbound:dm/group 发送行: "[outbound:dm] to=..., bodyLen=1733" → 取字数、计条数
+    if (inExchange && (msg.startsWith("[outbound:dm]") || msg.startsWith("[outbound:group]"))) {
+      const bodyLenM = msg.match(/bodyLen=(\d+)/);
+      if (bodyLenM) {
+        replyLen += parseInt(bodyLenM[1], 10);
+        replyCount++;
+      }
+      continue;
+    }
+    // 过滤 outbound:dm/group 的其他细节行（response 等）
+    if (msg.startsWith("[outbound:")) continue;
+
+    // ---- WS 连接事件 ----
+    if (
+      msg.startsWith("[ws:connect]") ||
+      msg.startsWith("[ws:disconnect]") ||
+      msg.startsWith("[ws:error]") ||
+      msg.includes("[Phase 1]") ||
+      msg.includes("[Phase 2]") ||
+      msg.includes("========== 开始两阶段")
+    ) {
+      flushExchange();
+      const wsLevel = msg.startsWith("[ws:error]")
+        ? 50
+        : msg.startsWith("[ws:disconnect]")
+          ? 40
+          : 30;
+      events.push({ kind: "ws", time: timeStr, detail: msg, level: wsLevel });
+      continue;
+    }
+
+    // ---- 心跳（合并掉，不展示） ----
+    if (
+      msg.includes("Sending heartbeat ping") ||
+      msg.includes("分发事件: heartbeat") ||
+      msg.includes("[ws:frame]")
+    ) {
+      continue;
+    }
+
+    // ---- 策略拒绝 / warn / error ----
+    // 注意：不调用 flushExchange()，允许 warn/error 与正在进行的 exchange 共存
+    // 否则 "dropped" 类 warn 日志会提前重置 inExchange 状态，导致后续 outbound 统计丢失
+    if (level >= 40 || msg.includes("rejected") || msg.includes("dropped")) {
+      events.push({ kind: "error", time: timeStr, detail: msg, level });
+      continue;
+    }
+
+    // ---- 系统/连接事件（default、dispatch 内部流转、infoflow:bot 等）→ 过滤 ----
+    if (
+      msg.startsWith("[dispatch]") ||
+      msg.startsWith("[dispatch:") ||
+      msg.startsWith("[ws:inbound]") ||
+      msg.startsWith("[ws:frame]") ||
+      msg.startsWith("[infoflow:bot]") ||
+      msg.startsWith("[dispatchPrivateMessage]") ||
+      msg.startsWith("[default]") ||
+      msg.includes("client ready")
+    ) {
+      // 静默过滤内部流转细节
+      continue;
+    }
+
+    // ---- 其余有价值的行作为系统事件 ----
+    if (level >= 40) {
+      events.push({ kind: "error", time: timeStr, detail: msg, level });
+    }
+  }
+
+  flushExchange();
+  return events;
+}
+
+// ---------------------------------------------------------------------------
+// Render events → Markdown
+// ---------------------------------------------------------------------------
+
+function renderEvents(events: LogEvent[]): string[] {
+  const lines: string[] = [];
+  for (const ev of events) {
+    if (ev.kind === "exchange") {
+      const textPreview = ev.text.length > 60 ? ev.text.slice(0, 60) + "…" : ev.text || "(空)";
+      const elapsedStr = ev.elapsed != null ? ` ${ev.elapsed}ms` : "";
+      const replyStr =
+        ev.replyCount > 0
+          ? `${ev.replyLen}字${ev.replyCount > 1 ? ` ×${ev.replyCount}条` : ""}`
+          : ev.text.startsWith("/")
+            ? "指令"
+            : "无回复";
+      lines.push(`**${ev.time}** 💬 \`${ev.from}\` → ${textPreview} | 🤖${elapsedStr} ${replyStr}`);
+      lines.push("");
+    } else if (ev.kind === "ws") {
+      const icon = ev.level >= 50 ? "❌" : ev.level >= 40 ? "⚠️" : "🔗";
+      lines.push(`**${ev.time}** ${icon} ${ev.detail}`);
+      lines.push("");
+    } else if (ev.kind === "error") {
+      const icon = ev.level >= 50 ? "❌" : "⚠️";
+      lines.push(`**${ev.time}** ${icon} ${ev.detail}`);
+      lines.push("");
+    } else if (ev.kind === "system") {
+      lines.push(`**${ev.time}** ℹ️ ${ev.detail}`);
+      lines.push("");
+    }
+  }
+  return lines;
+}
+
+// ---------------------------------------------------------------------------
+// Log file discovery
+// ---------------------------------------------------------------------------
+
+function getTodayLogPath(): string {
+  const now = new Date();
+  const yyyy = now.getFullYear();
+  const mm = String(now.getMonth() + 1).padStart(2, "0");
+  const dd = String(now.getDate()).padStart(2, "0");
+  return join(LOG_DIR, `openclaw-${yyyy}-${mm}-${dd}.log`);
+}
+
+function getYesterdayLogPath(): string {
+  const yesterday = new Date(Date.now() - 86_400_000);
+  const yyyy = yesterday.getFullYear();
+  const mm = String(yesterday.getMonth() + 1).padStart(2, "0");
+  const dd = String(yesterday.getDate()).padStart(2, "0");
+  return join(LOG_DIR, `openclaw-${yyyy}-${mm}-${dd}.log`);
+}
+
+// ---------------------------------------------------------------------------
+// Command handler
+// ---------------------------------------------------------------------------
+
+export async function runLogsCommand(ctx: {
+  config?: unknown;
+  senderId?: string;
+  args?: string;
+}): Promise<{ text: string }> {
+  const tokens = (ctx.args?.trim() ?? "").split(/\s+/).filter(Boolean);
+
+  // 提取 level 过滤关键字
+  let minLevel = 0;
+  let levelLabel = "";
+  const remaining = tokens.filter((t) => {
+    if (t.toLowerCase() === "error") {
+      minLevel = 50;
+      levelLabel = "error";
+      return false;
+    }
+    if (t.toLowerCase() === "warn") {
+      minLevel = 40;
+      levelLabel = "warn";
+      return false;
+    }
+    return true;
+  });
+
+  const arg = remaining.join(" ");
+  let limit = DEFAULT_EVENTS;
+  if (arg) {
+    const n = parseInt(arg, 10);
+    limit = Number.isFinite(n) && n > 0 ? Math.min(n, MAX_EVENTS) : DEFAULT_EVENTS;
+  }
+
+  const todayPath = getTodayLogPath();
+  const yesterdayPath = getYesterdayLogPath();
+  const logPath = existsSync(todayPath)
+    ? todayPath
+    : existsSync(yesterdayPath)
+      ? yesterdayPath
+      : null;
+
+  if (!logPath) {
+    return {
+      text: [
+        "**Infoflow 日志**",
+        "",
+        "未找到日志文件。",
+        `期望位置：${todayPath}`,
+        "",
+        "可能的原因：",
+        "- Gateway 尚未启动过",
+        "- 日志路径与预期不符",
+      ].join("\n"),
+    };
+  }
+
+  let rawLines: string[];
+  try {
+    const content = readFileSync(logPath, "utf-8");
+    rawLines = content.split("\n");
+  } catch (err: unknown) {
+    return {
+      text: `**Infoflow 日志**\n\n读取日志文件失败：${err instanceof Error ? err.message : String(err)}`,
+    };
+  }
+
+  // Parse all raw entries
+  const allEntries: RawEntry[] = [];
+  for (const line of rawLines) {
+    const e = parseRawEntry(line);
+    if (e) allEntries.push(e);
+  }
+
+  // Aggregate into events
+  let events = aggregateEvents(allEntries);
+
+  // Level filter
+  if (minLevel > 0) {
+    events = events.filter((ev) => {
+      if (ev.kind === "error" || ev.kind === "ws") return ev.level >= minLevel;
+      return false; // exchange / system 不含 level，error/warn 模式下不显示
+    });
+  }
+
+  // Take last N events
+  if (events.length > limit) {
+    events = events.slice(events.length - limit);
+  }
+
+  const levelDesc = levelLabel ? ` [${levelLabel}]` : "";
+  const countDesc = `最近 ${events.length} 条`;
+
+  if (events.length === 0) {
+    return {
+      text: `**Infoflow 日志**${levelDesc} (${countDesc}，来自 ${logPath.split("/").pop()})\n\n暂无相关日志。`,
+    };
+  }
+
+  // Render
+  const rendered = renderEvents(events);
+
+  // Apply total char limit
+  let totalChars = 0;
+  let dropped = 0;
+  const kept: string[] = [];
+  for (const line of rendered) {
+    if (totalChars + line.length + 1 > LOGS_TOTAL_CHAR_LIMIT) {
+      dropped++;
+      continue;
+    }
+    kept.push(line);
+    totalChars += line.length + 1;
+  }
+
+  const title = `**Infoflow 日志**${levelDesc} (${countDesc}，来自 ${logPath.split("/").pop()})`;
+  const body = kept.join("\n");
+  const limitNote =
+    dropped > 0 ? `\n⚠️ 超出 ${LOGS_TOTAL_CHAR_LIMIT} 字符上限，已省略部分条目。` : "";
+
+  return { text: `${title}\n\n${body}${limitNote}` };
+}

package/src/commands/version.ts

@@ -0,0 +1,20 @@
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PACKAGE_JSON_PATH = resolve(__dirname, "../../package.json");
+
+let _version: string | undefined;
+
+/** 读取当前安装的插件版本号（来自 package.json）。 */
+export function getPluginVersion(): string {
+  if (_version !== undefined) return _version;
+  try {
+    const pkg = JSON.parse(readFileSync(PACKAGE_JSON_PATH, "utf-8")) as Record<string, unknown>;
+    _version = typeof pkg.version === "string" ? pkg.version : "unknown";
+  } catch {
+    _version = "unknown";
+  }
+  return _version;
+}

package/src/compat/openclaw-sdk.ts

@@ -0,0 +1,218 @@
+/**
+ * Compatibility shim for openclaw/plugin-sdk.
+ *
+ * Supports both:
+ *   - openclaw >= 2026.3.22: specific subpaths (infra-runtime, reply-history, …)
+ *   - openclaw <  2026.3.22: monolithic root export (openclaw/plugin-sdk)
+ *
+ * Strategy: try the new subpath first; if that module doesn't exist, fall back
+ * to the root export which contained all symbols in the older versions.
+ *
+ * IMPORTANT: Only runtime values are handled here.
+ * Pure `import type` declarations are erased by tsx at runtime and need no shim.
+ */
+
+import { createRequire } from "module";
+import { readdirSync, realpathSync } from "fs";
+
+const _require = createRequire(import.meta.url);
+
+/**
+ * Build additional require functions that can resolve `openclaw/plugin-sdk/*`
+ * even when the plugin's own node_modules doesn't contain openclaw.
+ *
+ * When openclaw gateway loads this plugin, the gateway process itself has
+ * openclaw in its module resolution scope. We exploit this by creating a
+ * require function rooted at `process.argv[1]` (the openclaw main script),
+ * which walks up to the global node_modules and finds openclaw there.
+ *
+ * Additional fallback: try to detect common openclaw installation paths.
+ */
+function buildRequirers(): NodeRequire[] {
+  const requirers: NodeRequire[] = [_require];
+
+  // Try the gateway main entry point first - most reliable when symlink is missing
+  if (process.argv[1]) {
+    try {
+      // Resolve symlink to real path so createRequire walks up from the actual
+      // node_modules directory, not the symlink's parent (e.g. bin/).
+      const realPath = realpathSync(process.argv[1]);
+      requirers.push(createRequire(realPath));
+    } catch {
+      // ignore
+    }
+  }
+
+  // Enumerate candidate openclaw main script paths (no glob - use fs to expand)
+  const candidateEntryFiles: string[] = [
+    '/opt/homebrew/lib/node_modules/openclaw/openclaw.mjs',
+    '/usr/local/lib/node_modules/openclaw/openclaw.mjs',
+    '/usr/lib/node_modules/openclaw/openclaw.mjs',
+  ];
+
+  // Honor custom npm prefix (e.g. npm_config_prefix=/home/work/opt/npm-global)
+  const npmPrefix = process.env.npm_config_prefix || process.env.NPM_CONFIG_PREFIX;
+  if (npmPrefix) {
+    candidateEntryFiles.push(`${npmPrefix}/lib/node_modules/openclaw/openclaw.mjs`);
+  }
+
+  // Expand nvm node versions without glob
+  const home = process.env.HOME;
+  if (home) {
+    const nvmNodeBase = `${home}/.nvm/versions/node`;
+    try {
+      const nodeVersions = readdirSync(nvmNodeBase);
+      for (const version of nodeVersions) {
+        candidateEntryFiles.push(
+          `${nvmNodeBase}/${version}/lib/node_modules/openclaw/openclaw.mjs`,
+        );
+      }
+    } catch {
+      // nvm not installed or directory unreadable
+    }
+  }
+
+  for (const entryFile of candidateEntryFiles) {
+    try {
+      const testReq = createRequire(entryFile);
+      testReq.resolve("openclaw/plugin-sdk");
+      requirers.push(testReq);
+      break;
+    } catch {
+      // ignore, try next path
+    }
+  }
+
+  return requirers;
+}
+
+const _requirers = buildRequirers();
+
+function tryLoad(...paths: string[]): Record<string, unknown> {
+  for (const path of paths) {
+    for (const req of _requirers) {
+      try {
+        return req(path) as Record<string, unknown>;
+      } catch {
+        // try next requirer / path
+      }
+    }
+  }
+  throw new Error(
+    `[infoflow-plugin] Failed to load openclaw SDK from any of: ${paths.join(", ")}`,
+  );
+}
+
+// ---------------------------------------------------------------------------
+// plugin-entry: emptyPluginConfigSchema, OpenClawPluginApi (type only)
+// ---------------------------------------------------------------------------
+const _pluginEntry = tryLoad("openclaw/plugin-sdk/plugin-entry", "openclaw/plugin-sdk");
+
+export const emptyPluginConfigSchema =
+  _pluginEntry.emptyPluginConfigSchema as typeof import("openclaw/plugin-sdk/plugin-entry").emptyPluginConfigSchema;
+
+// OpenClawPluginApi is a runtime type from newer openclaw versions (>=2026.3.23).
+// Older versions don't export it at runtime, only in .d.ts.
+// Define a compatible type here to avoid module resolution issues.
+// The actual type is validated by the gateway's type system, so this just needs
+// to be structurally compatible for the plugin's type checking.
+export type OpenClawPluginApi = {
+  runtime: unknown;
+  registerChannel(config: unknown): void;
+  registerHttpRoute(config: unknown): void;
+  registerCommand(config: unknown): void;
+  registerService(service: unknown): void;
+};
+
+// ---------------------------------------------------------------------------
+// core: channel lifecycle helpers
+// ---------------------------------------------------------------------------
+const _core = tryLoad("openclaw/plugin-sdk/core", "openclaw/plugin-sdk");
+
+export const applyAccountNameToChannelSection =
+  _core.applyAccountNameToChannelSection as typeof import("openclaw/plugin-sdk/core").applyAccountNameToChannelSection;
+
+export const deleteAccountFromConfigSection =
+  _core.deleteAccountFromConfigSection as typeof import("openclaw/plugin-sdk/core").deleteAccountFromConfigSection;
+
+export const formatPairingApproveHint =
+  _core.formatPairingApproveHint as typeof import("openclaw/plugin-sdk/core").formatPairingApproveHint;
+
+export const migrateBaseNameToDefaultAccount =
+  _core.migrateBaseNameToDefaultAccount as typeof import("openclaw/plugin-sdk/core").migrateBaseNameToDefaultAccount;
+
+export const setAccountEnabledInConfigSection =
+  _core.setAccountEnabledInConfigSection as typeof import("openclaw/plugin-sdk/core").setAccountEnabledInConfigSection;
+
+// ---------------------------------------------------------------------------
+// account-id: DEFAULT_ACCOUNT_ID, normalizeAccountId
+// In old openclaw these live in root; new openclaw has "account-id" subpath.
+// "core" also re-exports them in new openclaw, so we try "account-id" first.
+// ---------------------------------------------------------------------------
+const _accountId = tryLoad("openclaw/plugin-sdk/account-id", "openclaw/plugin-sdk");
+
+export const DEFAULT_ACCOUNT_ID =
+  _accountId.DEFAULT_ACCOUNT_ID as typeof import("openclaw/plugin-sdk/account-id").DEFAULT_ACCOUNT_ID;
+
+export const normalizeAccountId =
+  _accountId.normalizeAccountId as typeof import("openclaw/plugin-sdk/account-id").normalizeAccountId;
+
+// ---------------------------------------------------------------------------
+// infra-runtime: createDedupeCache
+// ---------------------------------------------------------------------------
+const _infraRuntime = tryLoad("openclaw/plugin-sdk/infra-runtime", "openclaw/plugin-sdk");
+
+export const createDedupeCache =
+  _infraRuntime.createDedupeCache as typeof import("openclaw/plugin-sdk/infra-runtime").createDedupeCache;
+
+// ---------------------------------------------------------------------------
+// reply-history
+// ---------------------------------------------------------------------------
+const _replyHistory = tryLoad("openclaw/plugin-sdk/reply-history", "openclaw/plugin-sdk");
+
+export const buildPendingHistoryContextFromMap =
+  _replyHistory.buildPendingHistoryContextFromMap as typeof import("openclaw/plugin-sdk/reply-history").buildPendingHistoryContextFromMap;
+
+export const clearHistoryEntriesIfEnabled =
+  _replyHistory.clearHistoryEntriesIfEnabled as typeof import("openclaw/plugin-sdk/reply-history").clearHistoryEntriesIfEnabled;
+
+export const DEFAULT_GROUP_HISTORY_LIMIT =
+  _replyHistory.DEFAULT_GROUP_HISTORY_LIMIT as typeof import("openclaw/plugin-sdk/reply-history").DEFAULT_GROUP_HISTORY_LIMIT;
+
+export const recordPendingHistoryEntryIfEnabled =
+  _replyHistory.recordPendingHistoryEntryIfEnabled as typeof import("openclaw/plugin-sdk/reply-history").recordPendingHistoryEntryIfEnabled;
+
+// ---------------------------------------------------------------------------
+// media-runtime: buildAgentMediaPayload
+// ---------------------------------------------------------------------------
+const _mediaRuntime = tryLoad("openclaw/plugin-sdk/media-runtime", "openclaw/plugin-sdk");
+
+export const buildAgentMediaPayload =
+  _mediaRuntime.buildAgentMediaPayload as typeof import("openclaw/plugin-sdk/media-runtime").buildAgentMediaPayload;
+
+// ---------------------------------------------------------------------------
+// tool-send: extractToolSend
+// ---------------------------------------------------------------------------
+const _toolSend = tryLoad("openclaw/plugin-sdk/tool-send", "openclaw/plugin-sdk");
+
+export const extractToolSend =
+  _toolSend.extractToolSend as typeof import("openclaw/plugin-sdk/tool-send").extractToolSend;
+
+// ---------------------------------------------------------------------------
+// agent-runtime: jsonResult, readStringParam
+// ---------------------------------------------------------------------------
+const _agentRuntime = tryLoad("openclaw/plugin-sdk/agent-runtime", "openclaw/plugin-sdk");
+
+export const jsonResult =
+  _agentRuntime.jsonResult as typeof import("openclaw/plugin-sdk/agent-runtime").jsonResult;
+
+export const readStringParam =
+  _agentRuntime.readStringParam as typeof import("openclaw/plugin-sdk/agent-runtime").readStringParam;
+
+// ---------------------------------------------------------------------------
+// channel-runtime: createReplyPrefixOptions
+// ---------------------------------------------------------------------------
+const _channelRuntime = tryLoad("openclaw/plugin-sdk/channel-runtime", "openclaw/plugin-sdk");
+
+export const createReplyPrefixOptions =
+  _channelRuntime.createReplyPrefixOptions as typeof import("openclaw/plugin-sdk/channel-runtime").createReplyPrefixOptions;