@xgjktech/xg_cwork_im 1.19.28 → 1.19.30

package/dist/src/inbound-media-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-media-local.d.ts","sourceRoot":"","sources":["../../src/inbound-media-local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,2BAA2B;AAC3B,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED,wBAAgB,mCAAmC,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAWxG;AAED,wBAAsB,+BAA+B,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CASrG;AASD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAKrD;AAED,oCAAoC;AACpC,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAMvD;AAcD;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3G;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,GAC1B,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAC3D,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,MAAM,CAgBT;AAED,6BAA6B;AAC7B,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,MAAM,CAMrF;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACpD,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAsEvB"}

package/dist/src/inbound-media-local.js

@@ -0,0 +1,194 @@
+/**
+ * 入站附件：可选落盘到当前 Agent workspace 下指定子目录（相对路径）。
+ *
+ * 目录约定：{subdir}/{userId}/{YYYY-MM-DD}/{stem}_{HHmmssmmm}{ext}
+ * 时间取写入时的本地时区。
+ */
+import { mkdir, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { downloadMediaBuffer, resolveMaxAttachmentBytes } from "./resource-file.js";
+/** 校验：非空、相对路径、不含 `..` 段 */
+export function normalizeInboundWorkspaceSubdir(subdir) {
+    const t = subdir.trim().replace(/\\/g, "/");
+    if (!t || t === "." || t === "..")
+        return null;
+    const parts = t.split("/").filter(Boolean);
+    for (const p of parts) {
+        if (p === "..")
+            return null;
+    }
+    if (path.isAbsolute(t))
+        return null;
+    return parts.join("/");
+}
+export function resolveAgentWorkspaceDirFromRuntime(rt, cfg) {
+    const agent = rt?.agent;
+    const fn = agent?.resolveAgentWorkspaceDir;
+    if (typeof fn !== "function")
+        return undefined;
+    try {
+        const out = fn(cfg);
+        if (typeof out === "string" && out.trim())
+            return path.resolve(out.trim());
+    }
+    catch {
+        /* ignore */
+    }
+    return undefined;
+}
+export async function ensureAgentWorkspaceFromRuntime(rt, cfg) {
+    const agent = rt?.agent;
+    const fn = agent?.ensureAgentWorkspace;
+    if (typeof fn !== "function")
+        return;
+    try {
+        await fn(cfg);
+    }
+    catch {
+        /* 落盘前仍会 mkdir，不阻断 */
+    }
+}
+function sanitizeUserIdForPath(id) {
+    const t = id.trim();
+    if (/^-?\d+$/.test(t) && t.length <= 32)
+        return t;
+    const safe = t.replace(/[^\w.-]/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "");
+    return safe.slice(0, 64) || "unknown";
+}
+export function formatDateFolderLocal(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
+/** `HHmmss` + 三位毫秒，如 `120459237` */
+export function formatInboundTimeSuffix(d) {
+    const h = String(d.getHours()).padStart(2, "0");
+    const min = String(d.getMinutes()).padStart(2, "0");
+    const s = String(d.getSeconds()).padStart(2, "0");
+    const ms = String(d.getMilliseconds()).padStart(3, "0");
+    return `${h}${min}${s}${ms}`;
+}
+const MAX_STEM_LEN = 120;
+function sanitizeStem(stem) {
+    const s = stem
+        .replace(/[<>:"/\\|?*\u0000-\u001f]/g, "_")
+        .replace(/_+/g, "_")
+        .replace(/^\.+|\.+$/g, "")
+        .trim();
+    const out = s || "file";
+    return out.length > MAX_STEM_LEN ? out.slice(0, MAX_STEM_LEN) : out;
+}
+/**
+ * 将落盘绝对路径转为 OpenClaw / 沙箱可用的 workspace 相对引用（POSIX 风格，带 `./` 前缀）。
+ * 若文件不在 workspaceRoot 之下则返回 null（调用方应回退 file:// 或报错）。
+ */
+export function absPathToWorkspaceRelativeOpenClawRef(workspaceRoot, absPath) {
+    const root = path.resolve(workspaceRoot.trim());
+    const abs = path.resolve(absPath);
+    const rel = path.relative(root, abs);
+    if (rel.startsWith("..") || path.isAbsolute(rel))
+        return null;
+    const piece = rel.length > 0 ? rel : path.basename(abs);
+    const posix = piece.split(path.sep).join("/");
+    return posix.startsWith("./") ? posix : `./${posix}`;
+}
+/**
+ * 沙箱内常用挂载点（如 `/workspace`）+ 相对 workspace 的路径，供 read 等工具按「绝对路径」解析。
+ * 若未配置 sandboxRootPrefix，则仍用 `./xg_im_inbound/...`（相对当前 cwd，部分沙箱工具会误判为不可访问）。
+ */
+export function sandboxWorkspaceMediaRef(workspaceRoot, absPath, sandboxRootPrefix) {
+    const rel = absPathToWorkspaceRelativeOpenClawRef(workspaceRoot, absPath);
+    if (!rel)
+        return null;
+    const root = sandboxRootPrefix.trim().replace(/\/+$/, "") || "/workspace";
+    const relStrip = rel.replace(/^\.\/+/, "").replace(/^\/+/, "");
+    return `${root}/${relStrip}`;
+}
+export function openClawMediaRefForSavedFile(args) {
+    const { workspaceRoot, absPath, style, sandboxRootPrefix, log } = args;
+    if (style === "absoluteFileUrl") {
+        return pathToFileURL(absPath).href;
+    }
+    const prefix = sandboxRootPrefix?.trim();
+    if (prefix) {
+        const boxed = sandboxWorkspaceMediaRef(workspaceRoot, absPath, prefix);
+        if (boxed)
+            return boxed;
+    }
+    const rel = absPathToWorkspaceRelativeOpenClawRef(workspaceRoot, absPath);
+    if (rel)
+        return rel;
+    log?.warn?.(`[cwork_im:inbound-local] file not under workspace root, fallback to file:// absPath=${absPath.slice(0, 120)}`);
+    return pathToFileURL(absPath).href;
+}
+/** `report_120459237.pdf` */
+export function buildInboundStoredFilename(originalFilename, at) {
+    const base = path.basename(originalFilename) || "file";
+    const ext = path.extname(base);
+    const stem = ext ? base.slice(0, -ext.length) : base;
+    const suffix = formatInboundTimeSuffix(at);
+    return `${sanitizeStem(stem)}_${suffix}${ext.toLowerCase()}`;
+}
+/**
+ * 将入站附件下载到 workspace 下子目录；失败项保留原 URL。
+ */
+export async function saveInboundFilesToWorkspace(args) {
+    const { rt, cfg, config, workspaceSubdir, senderUserId, fileItems, log } = args;
+    const normalized = normalizeInboundWorkspaceSubdir(workspaceSubdir);
+    if (!normalized || fileItems.length === 0)
+        return fileItems;
+    const workspaceRoot = resolveAgentWorkspaceDirFromRuntime(rt, cfg);
+    if (!workspaceRoot) {
+        log?.warn?.("[cwork_im:inbound-local] resolveAgentWorkspaceDir unavailable, skip inbound download; keep remote URLs");
+        return fileItems;
+    }
+    await ensureAgentWorkspaceFromRuntime(rt, cfg);
+    const maxBytes = resolveMaxAttachmentBytes(config);
+    const userSeg = sanitizeUserIdForPath(senderUserId ?? "unknown");
+    const relParts = normalized.split("/");
+    const pathStyle = config.inboundMediaOpenClawPath ?? "workspaceRelative";
+    const sandboxPrefix = config.inboundMediaSandboxRootPrefix?.trim() || "";
+    log?.info?.(`[cwork_im:inbound-local] begin files=${fileItems.length} cwd=${process.cwd()} workspaceRoot=${workspaceRoot} subdir=${normalized} user=${userSeg} style=${pathStyle} sandboxPrefix=${sandboxPrefix || "(none)"}`);
+    const out = [];
+    for (const item of fileItems) {
+        const srcUrl = item.url?.trim();
+        if (!srcUrl) {
+            out.push(item);
+            continue;
+        }
+        const now = new Date();
+        const dateFolder = formatDateFolderLocal(now);
+        const localName = buildInboundStoredFilename(item.name?.trim() || "file", now);
+        const dir = path.join(workspaceRoot, ...relParts, userSeg, dateFolder);
+        const absPath = path.join(dir, localName);
+        try {
+            log?.info?.(`[cwork_im:inbound-local] prepare src=${srcUrl.slice(0, 120)} dir=${dir} abs=${absPath}`);
+            await mkdir(dir, { recursive: true });
+            const { buffer } = await downloadMediaBuffer(srcUrl, maxBytes, log);
+            await writeFile(absPath, buffer);
+            const mediaRef = openClawMediaRefForSavedFile({
+                workspaceRoot,
+                absPath,
+                style: pathStyle,
+                sandboxRootPrefix: sandboxPrefix,
+                log,
+            });
+            const st = await stat(absPath);
+            log?.info?.(`[cwork_im:inbound-local] saved ${localName} bytes=${buffer.length} stat.size=${st.size} stat.mtime=${st.mtime.toISOString()} abs=${absPath} openclawRef=${mediaRef}`);
+            out.push({
+                ...item,
+                url: mediaRef,
+                size: buffer.length,
+                name: localName,
+            });
+        }
+        catch (e) {
+            log?.warn?.(`[cwork_im:inbound-local] download/save failed, degrade to OpenClaw URL: ${String(e)} ref=${srcUrl.slice(0, 80)}`);
+            out.push(item);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=inbound-media-local.js.map

package/dist/src/inbound-media-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-media-local.js","sourceRoot":"","sources":["../../src/inbound-media-local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGpF,2BAA2B;AAC3B,MAAM,UAAU,+BAA+B,CAAC,MAAc;IAC1D,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,EAAW,EAAE,GAAmB;IAChF,MAAM,KAAK,GAAI,EAAgF,EAAE,KAAK,CAAC;IACvG,MAAM,EAAE,GAAG,KAAK,EAAE,wBAAwB,CAAC;IAC3C,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACL,YAAY;IAChB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,EAAW,EAAE,GAAmB;IAClF,MAAM,KAAK,GAAI,EAAkF,EAAE,KAAK,CAAC;IACzG,MAAM,EAAE,GAAG,KAAK,EAAE,oBAAoB,CAAC;IACvC,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,OAAO;IACrC,IAAI,CAAC;QACD,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACL,qBAAqB;IACzB,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,EAAU;IACrC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACpB,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAAO;IACzC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,uBAAuB,CAAC,CAAO;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB,SAAS,YAAY,CAAC,IAAY;IAC9B,MAAM,CAAC,GAAG,IAAI;SACT,OAAO,CAAC,4BAA4B,EAAE,GAAG,CAAC;SAC1C,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,IAAI,EAAE,CAAC;IACZ,MAAM,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC;IACxB,OAAO,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qCAAqC,CAAC,aAAqB,EAAE,OAAe;IACxF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACpC,aAAqB,EACrB,OAAe,EACf,iBAAyB;IAEzB,MAAM,GAAG,GAAG,qCAAqC,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC1E,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC;IAC1E,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/D,OAAO,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAO5C;IACG,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACvE,IAAI,KAAK,KAAK,iBAAiB,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IACD,MAAM,MAAM,GAAG,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,wBAAwB,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACvE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC5B,CAAC;IACD,MAAM,GAAG,GAAG,qCAAqC,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC1E,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,GAAG,EAAE,IAAI,EAAE,CACP,uFAAuF,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACjH,CAAC;IACF,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,0BAA0B,CAAC,gBAAwB,EAAE,EAAQ;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC3C,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,IAQjD;IACG,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAChF,MAAM,UAAU,GAAG,+BAA+B,CAAC,eAAe,CAAC,CAAC;IACpE,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5D,MAAM,aAAa,GAAG,mCAAmC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACnE,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,GAAG,EAAE,IAAI,EAAE,CACP,wGAAwG,CAC3G,CAAC;QACF,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,+BAA+B,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,qBAAqB,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,MAAM,CAAC,wBAAwB,IAAI,mBAAmB,CAAC;IACzE,MAAM,aAAa,GAAG,MAAM,CAAC,6BAA6B,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAEzE,GAAG,EAAE,IAAI,EAAE,CACP,wCAAwC,SAAS,CAAC,MAAM,QAAQ,OAAO,CAAC,GAAG,EAAE,kBAAkB,aAAa,WAAW,UAAU,SAAS,OAAO,UAAU,SAAS,kBAAkB,aAAa,IAAI,QAAQ,EAAE,CACpN,CAAC;IAEF,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACb,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAE1C,IAAI,CAAC;YACD,GAAG,EAAE,IAAI,EAAE,CACP,wCAAwC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,OAAO,EAAE,CAC3F,CAAC;YACF,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YACpE,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,4BAA4B,CAAC;gBAC1C,aAAa;gBACb,OAAO;gBACP,KAAK,EAAE,SAAS;gBAChB,iBAAiB,EAAE,aAAa;gBAChC,GAAG;aACN,CAAC,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/B,GAAG,EAAE,IAAI,EAAE,CACP,kCAAkC,SAAS,UAAU,MAAM,CAAC,MAAM,cAAc,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,OAAO,gBAAgB,QAAQ,EAAE,CACxK,CAAC;YACF,GAAG,CAAC,IAAI,CAAC;gBACL,GAAG,IAAI;gBACP,GAAG,EAAE,QAAQ;gBACb,IAAI,EAAE,MAAM,CAAC,MAAM;gBACnB,IAAI,EAAE,SAAS;aAClB,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YAClB,GAAG,EAAE,IAAI,EAAE,CACP,2EAA2E,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CACpH,CAAC;YACF,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/src/inbound-model.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 入站模型选择：从 msgContent.ext.ai_model 解析三种模式（default / auto / explicit）。
+ * - default：未传或空值或控制命令 → 使用 Agent 默认配置。
+ * - auto：由 Auto Router 同时决定模型与推理等级。
+ * - explicit：严格使用指定模型，推理等级用该模型默认配置。
+ * 另从 msgContent.ext.ai_thinking 解析单轮推理强度（客户端按条指定）。
+ * 不注入正文、不伪造 /model 指令、不写 session。
+ */
+import type { WsMessageContent } from "./types.js";
+/** 客户端可按条指定的推理强度（与 OpenClaw ThinkLevel 的规范值对齐）。 */
+export declare const INBOUND_THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "adaptive", "max", "ultra"];
+export type InboundThinkingLevel = (typeof INBOUND_THINKING_LEVELS)[number];
+/**
+ * 从 ext.ai_thinking 解析单轮推理强度（大小写不敏感，仅接受规范值）。
+ * 未传、非字符串、空白或非法值一律返回 undefined（由上层回落到既有默认）。
+ */
+export declare function parseInboundThinkingLevel(msgExt: WsMessageContent["ext"]): InboundThinkingLevel | undefined;
+/** 首行去掉 @ 前缀后是否为 slash 控制命令（/stop、/reset、/model、/think 等） */
+export declare function isInboundControlCommandMessage(displayText: string): boolean;
+/**
+ * 正文任意位置是否出现 `/think` 指令（含行内写法，如 `帮我总结 /think high`）。
+ * 首行控制命令已由 isInboundControlCommandMessage 排除，这里兜底行内指令：
+ * 只要存在用户显式 /think，Auto Router / 模型默认的 thinking 就让位。
+ */
+export declare function hasUserThinkDirective(displayText: string): boolean;
+export type InboundModelSelection = {
+    mode: "default";
+} | {
+    mode: "auto";
+} | {
+    mode: "explicit";
+    model: string;
+};
+/**
+ * 从 ext.ai_model 解析本条消息的模型选择模式。
+ * 控制命令忽略 IM 元数据；`auto`（不区分大小写、忽略首尾空白）为模式标识，不是真实模型名。
+ */
+export declare function extractInboundModelSelection(msgExt: WsMessageContent["ext"], displayText: string): InboundModelSelection;
+//# sourceMappingURL=inbound-model.d.ts.map

package/dist/src/inbound-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-model.d.ts","sourceRoot":"","sources":["../../src/inbound-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,2FAU1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAChC,oBAAoB,GAAG,SAAS,CAOlC;AAED,6DAA6D;AAC7D,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,MAAM,MAAM,qBAAqB,GAC3B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,4BAA4B,CACxC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAC/B,WAAW,EAAE,MAAM,GACpB,qBAAqB,CAgBvB"}

package/dist/src/inbound-model.js

@@ -0,0 +1,66 @@
+/**
+ * 入站模型选择：从 msgContent.ext.ai_model 解析三种模式（default / auto / explicit）。
+ * - default：未传或空值或控制命令 → 使用 Agent 默认配置。
+ * - auto：由 Auto Router 同时决定模型与推理等级。
+ * - explicit：严格使用指定模型，推理等级用该模型默认配置。
+ * 另从 msgContent.ext.ai_thinking 解析单轮推理强度（客户端按条指定）。
+ * 不注入正文、不伪造 /model 指令、不写 session。
+ */
+/** 客户端可按条指定的推理强度（与 OpenClaw ThinkLevel 的规范值对齐）。 */
+export const INBOUND_THINKING_LEVELS = [
+    "off",
+    "minimal",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "adaptive",
+    "max",
+    "ultra",
+];
+/**
+ * 从 ext.ai_thinking 解析单轮推理强度（大小写不敏感，仅接受规范值）。
+ * 未传、非字符串、空白或非法值一律返回 undefined（由上层回落到既有默认）。
+ */
+export function parseInboundThinkingLevel(msgExt) {
+    const raw = msgExt?.ai_thinking;
+    if (typeof raw !== "string" || !raw.trim())
+        return undefined;
+    const key = raw.trim().toLowerCase();
+    return INBOUND_THINKING_LEVELS.includes(key)
+        ? key
+        : undefined;
+}
+/** 首行去掉 @ 前缀后是否为 slash 控制命令（/stop、/reset、/model、/think 等） */
+export function isInboundControlCommandMessage(displayText) {
+    const head = displayText.trim().split(/\r?\n/)[0]?.trim() ?? "";
+    const withoutLeads = head.replace(/^(@\S+\s+)+/u, "").trim();
+    return withoutLeads.startsWith("/");
+}
+/**
+ * 正文任意位置是否出现 `/think` 指令（含行内写法，如 `帮我总结 /think high`）。
+ * 首行控制命令已由 isInboundControlCommandMessage 排除，这里兜底行内指令：
+ * 只要存在用户显式 /think，Auto Router / 模型默认的 thinking 就让位。
+ */
+export function hasUserThinkDirective(displayText) {
+    return /\/think\b/i.test(displayText);
+}
+/**
+ * 从 ext.ai_model 解析本条消息的模型选择模式。
+ * 控制命令忽略 IM 元数据；`auto`（不区分大小写、忽略首尾空白）为模式标识，不是真实模型名。
+ */
+export function extractInboundModelSelection(msgExt, displayText) {
+    if (isInboundControlCommandMessage(displayText)) {
+        return { mode: "default" };
+    }
+    const raw = msgExt?.ai_model;
+    if (typeof raw !== "string" || !raw.trim()) {
+        return { mode: "default" };
+    }
+    const normalized = raw.trim();
+    if (normalized.toLowerCase() === "auto") {
+        return { mode: "auto" };
+    }
+    return { mode: "explicit", model: normalized };
+}
+//# sourceMappingURL=inbound-model.js.map

package/dist/src/inbound-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-model.js","sourceRoot":"","sources":["../../src/inbound-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,mDAAmD;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,KAAK;IACL,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;IACP,UAAU;IACV,KAAK;IACL,OAAO;CACD,CAAC;AAIX;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACrC,MAA+B;IAE/B,MAAM,GAAG,GAAG,MAAM,EAAE,WAAW,CAAC;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7D,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAQ,uBAA6C,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC/D,CAAC,CAAE,GAA4B;QAC/B,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,8BAA8B,CAAC,WAAmB;IAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,OAAO,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACrD,OAAO,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CACxC,MAA+B,EAC/B,WAAmB;IAEnB,IAAI,8BAA8B,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,EAAE,QAAQ,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/dist/src/inbound-model.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inbound-model.test.d.ts.map

package/dist/src/inbound-model.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-model.test.d.ts","sourceRoot":"","sources":["../../src/inbound-model.test.ts"],"names":[],"mappings":""}

package/dist/src/inbound-model.test.js

@@ -0,0 +1,88 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { extractInboundModelSelection, hasUserThinkDirective, isInboundControlCommandMessage, parseInboundThinkingLevel, } from "./inbound-model.js";
+const ext = (v) => (v === undefined ? undefined : { ai_model: v });
+describe("inbound-model selection", () => {
+    it("no ai_model → default", () => {
+        assert.deepEqual(extractInboundModelSelection(ext(undefined), "你好"), { mode: "default" });
+    });
+    it("empty string → default", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("   "), "你好"), { mode: "default" });
+    });
+    it("non-string ai_model → default", () => {
+        assert.deepEqual(extractInboundModelSelection({ ai_model: 42 }, "你好"), { mode: "default" });
+    });
+    it("auto → auto", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "你好"), { mode: "auto" });
+    });
+    it("AUTO → auto (case-insensitive)", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("AUTO"), "你好"), { mode: "auto" });
+    });
+    it("' auto ' → auto (trimmed)", () => {
+        assert.deepEqual(extractInboundModelSelection(ext(" auto "), "你好"), { mode: "auto" });
+    });
+    it("specific model → explicit", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("openai/gpt-5.6-terra"), "你好"), {
+            mode: "explicit",
+            model: "openai/gpt-5.6-terra",
+        });
+    });
+    it("/model control command ignores IM metadata", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "/model openai/gpt-5.6-terra 切换"), {
+            mode: "default",
+        });
+    });
+    it("/think control command ignores IM metadata", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "/think high"), { mode: "default" });
+    });
+    it("/reset control command ignores IM metadata", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "/reset"), { mode: "default" });
+    });
+    it("@robot-prefixed /model still detected as control command", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "@bot /model foo"), { mode: "default" });
+    });
+});
+describe("inbound-model think directive", () => {
+    it("detects inline /think in body", () => {
+        assert.equal(hasUserThinkDirective("帮我总结这段 /think high"), true);
+    });
+    it("detects leading /think", () => {
+        assert.equal(hasUserThinkDirective("/think medium"), true);
+    });
+    it("case-insensitive", () => {
+        assert.equal(hasUserThinkDirective("请分析 /THINK max"), true);
+    });
+    it("no /think → false", () => {
+        assert.equal(hasUserThinkDirective("请分析这个系统"), false);
+    });
+    it("distinct word boundaries", () => {
+        assert.equal(hasUserThinkDirective("请你考虑一下思考方式"), false);
+    });
+    it("isInboundControlCommandMessage true for first-line slash", () => {
+        assert.equal(isInboundControlCommandMessage("/stop"), true);
+        assert.equal(isInboundControlCommandMessage("普通问题 /stop 后面"), false);
+    });
+});
+describe("inbound-model ai_thinking", () => {
+    it("parses canonical levels case-insensitively and trimmed", () => {
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "high" }), "high");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: " HIGH " }), "high");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "max" }), "max");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "xhigh" }), "xhigh");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "adaptive" }), "adaptive");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "off" }), "off");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "ultra" }), "ultra");
+    });
+    it("returns undefined for missing/blank/non-string/invalid values", () => {
+        assert.equal(parseInboundThinkingLevel(undefined), undefined);
+        assert.equal(parseInboundThinkingLevel({}), undefined);
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "" }), undefined);
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "   " }), undefined);
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: 42 }), undefined);
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "superhigh" }), undefined);
+    });
+    it("does not read ai_model", () => {
+        assert.equal(parseInboundThinkingLevel({ ai_model: "high" }), undefined);
+    });
+});
+//# sourceMappingURL=inbound-model.test.js.map

package/dist/src/inbound-model.test.js.map

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

package/dist/src/inbound-terminal-delivery.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 入站 IM 消息终态投递：幂等、结构化日志、HTTP 兜底发送。
+ */
+import type { Logger } from "./channel-log.js";
+import { type InboundTrigger, type NoReplyCause, type TerminalState } from "./inbound-terminal-state.js";
+import type { FirstReplyTimeoutCause } from "./user-facing-errors.js";
+import type { SendMessageReply } from "./types.js";
+export type TerminalSendFn = (text: string) => Promise<void>;
+export declare class InboundTerminalController {
+    private readonly messageId;
+    private readonly groupId;
+    private readonly sessionKey;
+    private readonly trigger;
+    private readonly log;
+    private readonly logPrefix;
+    private runId;
+    private hasBusinessReply;
+    private timeoutFired;
+    private compactionShown;
+    private compactionIncomplete;
+    private runtimeErrorHint;
+    private normalizerSilentSkip;
+    private normalizerHeartbeatSkip;
+    private normalizerSkipReasons;
+    private localTerminalSent;
+    private lastResolvedState;
+    constructor(args: {
+        messageId: string;
+        groupId: string;
+        sessionKey: string;
+        trigger?: InboundTrigger;
+        log: Logger;
+        logPrefix: string;
+    });
+    setRunId(runId: string): void;
+    markBusinessReplySent(): void;
+    markTimeoutFired(): void;
+    /** OpenClaw reply normalizer 跳过 payload 时记录（onSkip reason）。 */
+    noteNormalizerSkip(reason: string): void;
+    noteCompactionNotice(text: string): void;
+    noteCompactionWsEvent(phase: "start" | "end"): void;
+    noteRuntimeErrorFromPayload(text: string): void;
+    noteRuntimeError(err: unknown): void;
+    /**
+     * 尝试发送终态 HTTP。返回是否已向 IM 发送（含此前已发送的幂等命中）。
+     * no_reply / timeout 等由 shouldSendTerminalHttpForState 拦截；文案为空亦不发。
+     */
+    trySendTerminal(state: TerminalState, sendFn: TerminalSendFn, extra?: {
+        errorMessage?: string;
+        noReplyCause?: NoReplyCause;
+        deliverInvokeCount?: number;
+        deliverCallCount?: number;
+        timeoutCause?: FirstReplyTimeoutCause;
+    }): Promise<boolean>;
+    finalizeAndDeliver(args: {
+        sendFn: TerminalSendFn;
+        dispatchThrew: boolean;
+        dispatchError?: unknown;
+        lastDeliverError?: unknown;
+        beforeAgentRunBlocked?: boolean;
+        deliverInvokeCount: number;
+        deliverCallCount: number;
+    }): Promise<TerminalState>;
+    getLastResolvedState(): TerminalState | undefined;
+    getRunId(): string | undefined;
+    didTimeoutFire(): boolean;
+    wasTerminalDelivered(): boolean;
+    private logTerminal;
+}
+export declare function buildTerminalSendFn(args: {
+    sendText: (text: string, replyMeta?: SendMessageReply) => Promise<void>;
+    replyMeta?: SendMessageReply;
+    isSingleChat: boolean;
+}): TerminalSendFn;
+/** cron / 工具主动推送前缀，避免与用户消息回复混淆。 */
+export declare function prefixProactiveOutboundText(text: string, trigger?: "cron" | "tool"): string;
+//# sourceMappingURL=inbound-terminal-delivery.d.ts.map

package/dist/src/inbound-terminal-delivery.d.ts.map

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