@xgjktech/xg_cwork_im 1.19.41 → 1.19.43

package/dist/src/register-per-message-model-hook.js

@@ -0,0 +1,22 @@
+/**
+ * before_model_resolve：消费 IM ext.ai_model 登记的单轮模型，优先于 session autoFallback 探测。
+ */
+import { takePendingPerMessageModel } from "./per-message-model-pending.js";
+export function registerPerMessageModelHook(api) {
+    api.on("before_model_resolve", async (_event, ctx) => {
+        const pending = takePendingPerMessageModel(ctx.sessionKey);
+        if (!pending)
+            return;
+        if (pending.provider) {
+            api.logger.info(`[xg_cwork_im] [model] before_model_resolve session=${ctx.sessionKey} ` +
+                `provider=${pending.provider} model=${pending.model}`);
+            return {
+                providerOverride: pending.provider,
+                modelOverride: pending.model,
+            };
+        }
+        api.logger.info(`[xg_cwork_im] [model] before_model_resolve session=${ctx.sessionKey} model=${pending.raw}`);
+        return { modelOverride: pending.raw };
+    }, { priority: 100 });
+}
+//# sourceMappingURL=register-per-message-model-hook.js.map

package/dist/src/register-per-message-model-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-per-message-model-hook.js","sourceRoot":"","sources":["../../src/register-per-message-model-hook.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,UAAU,2BAA2B,CAAC,GAAsB;IAC9D,GAAG,CAAC,EAAE,CACF,sBAAsB,EACtB,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAClB,MAAM,OAAO,GAAG,0BAA0B,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,GAAG,CAAC,MAAM,CAAC,IAAI,CACX,sDAAsD,GAAG,CAAC,UAAU,GAAG;gBACnE,YAAY,OAAO,CAAC,QAAQ,UAAU,OAAO,CAAC,KAAK,EAAE,CAC5D,CAAC;YACF,OAAO;gBACH,gBAAgB,EAAE,OAAO,CAAC,QAAQ;gBAClC,aAAa,EAAE,OAAO,CAAC,KAAK;aAC/B,CAAC;QACN,CAAC;QAED,GAAG,CAAC,MAAM,CAAC,IAAI,CACX,sDAAsD,GAAG,CAAC,UAAU,UAAU,OAAO,CAAC,GAAG,EAAE,CAC9F,CAAC;QACF,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,CAAC,EACD,EAAE,QAAQ,EAAE,GAAG,EAAE,CACpB,CAAC;AACN,CAAC"}

package/dist/src/resolve-inbound-group-prompt.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 合并通道静态 systemPrompt、IM 下发的 userInfo 用户块与 agentContext 项目块。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import type { Log } from "./auth.js";
+import type { RobotMentionAgentContext } from "./agent-context-types.js";
+import type { XgImConfig } from "./types.js";
+export interface ResolveInboundGroupSystemPromptArgs {
+    cfg: OpenClawConfig;
+    accountId: string;
+    config: XgImConfig;
+    agentContext?: RobotMentionAgentContext;
+    senderId?: string;
+    senderName?: string;
+    senderBackground?: string;
+    workspaceHostRoot?: string;
+    log?: Log;
+    logPrefix?: string;
+}
+export declare function resolveInboundGroupSystemPrompt(args: ResolveInboundGroupSystemPromptArgs): string | undefined;
+//# sourceMappingURL=resolve-inbound-group-prompt.d.ts.map

package/dist/src/resolve-inbound-group-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-inbound-group-prompt.d.ts","sourceRoot":"","sources":["../../src/resolve-inbound-group-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,mCAAmC;IAChD,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,mCAAmC,GAAG,MAAM,GAAG,SAAS,CAgD7G"}

package/dist/src/resolve-inbound-group-prompt.js

@@ -0,0 +1,43 @@
+/**
+ * 合并通道静态 systemPrompt、IM 下发的 userInfo 用户块与 agentContext 项目块。
+ */
+import { buildAgentContextPromptBlock, buildUserContextPromptBlock } from "./build-project-prompt.js";
+import { resolveXgImGroupSystemPrompt } from "./channel-config.js";
+function joinPromptParts(...parts) {
+    const joined = parts
+        .map((part) => part?.trim())
+        .filter((part) => Boolean(part))
+        .join("\n\n");
+    return joined || undefined;
+}
+export function resolveInboundGroupSystemPrompt(args) {
+    const { cfg, accountId, config, agentContext, senderId, senderName, senderBackground, workspaceHostRoot, log, logPrefix, } = args;
+    const staticPart = resolveXgImGroupSystemPrompt(cfg, accountId);
+    const userBlock = buildUserContextPromptBlock({
+        senderId,
+        senderName,
+        senderBackground,
+        config,
+    });
+    let projectBlock;
+    let built;
+    if (agentContext) {
+        try {
+            built = buildAgentContextPromptBlock({
+                agentContext,
+                config,
+                workspaceHostRoot,
+                log,
+            });
+            projectBlock = built.block;
+        }
+        catch (e) {
+            log?.error?.(`${logPrefix ?? ""} [agent-context] failed to build project prompt: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    if (config.debug && built) {
+        log?.info?.(`${logPrefix ?? ""} [agent-context] sandbox=${built.sandboxProjectPath ?? "?"} projectPromptLen=${projectBlock?.length ?? 0}`);
+    }
+    return joinPromptParts(staticPart, userBlock, projectBlock);
+}
+//# sourceMappingURL=resolve-inbound-group-prompt.js.map

package/dist/src/resolve-inbound-group-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-inbound-group-prompt.js","sourceRoot":"","sources":["../../src/resolve-inbound-group-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAEtG,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAgBnE,SAAS,eAAe,CAAC,GAAG,KAAgC;IACxD,MAAM,MAAM,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;SAC3B,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC/C,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,OAAO,MAAM,IAAI,SAAS,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAAyC;IACrF,MAAM,EACF,GAAG,EACH,SAAS,EACT,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,GAAG,EACH,SAAS,GACZ,GAAG,IAAI,CAAC;IAET,MAAM,UAAU,GAAG,4BAA4B,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,2BAA2B,CAAC;QAC1C,QAAQ;QACR,UAAU;QACV,gBAAgB;QAChB,MAAM;KACT,CAAC,CAAC;IAEH,IAAI,YAAgC,CAAC;IACrC,IAAI,KAAkE,CAAC;IAEvE,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,CAAC;YACD,KAAK,GAAG,4BAA4B,CAAC;gBACjC,YAAY;gBACZ,MAAM;gBACN,iBAAiB;gBACjB,GAAG;aACN,CAAC,CAAC;YACH,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;QAC/B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,GAAG,EAAE,KAAK,EAAE,CACR,GAAG,SAAS,IAAI,EAAE,oDAAoD,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACrH,CAAC;QACN,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;QACxB,GAAG,EAAE,IAAI,EAAE,CACP,GAAG,SAAS,IAAI,EAAE,4BAA4B,KAAK,CAAC,kBAAkB,IAAI,GAAG,qBAAqB,YAAY,EAAE,MAAM,IAAI,CAAC,EAAE,CAChI,CAAC;IACN,CAAC;IAED,OAAO,eAAe,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAChE,CAAC"}

package/dist/src/resource-file.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 资源中心整文件上传 + OpenClaw deliver 媒体 URL 拉取
+ *
+ * 上传地址固定为 `baseUrl + /file/upDownload/uploadWholeFile`，与 IM 同域，使用与发消息相同的 access-token。
+ */
+import type { Log } from "./auth.js";
+/** 沙箱/项目常见根段：`/project/...`、`/xg-cwork-im/...` 等伪绝对路径会按 workspace 相对段解析 */
+export declare const WORKSPACE_MEDIA_ROOT_SEGMENTS: Set<string>;
+/** IM 整文件上传超时（毫秒）；超时后抛错，由 send-service 降级为纯文本并提示用户。 */
+export declare const IM_FILE_UPLOAD_TIMEOUT_MS = 60000;
+/** HTTP(S) 媒体下载超时（毫秒）；超时后入站保留原始 URL 交给 OpenClaw，出站降级为带链接的文本。 */
+export declare const IM_FILE_DOWNLOAD_TIMEOUT_MS = 90000;
+/** 整文件上传接口路径（拼在 channels.xg_cwork_im.baseUrl 上） */
+export declare const RESOURCE_UPLOAD_PATH = "/file/upDownload/uploadWholeFile";
+export declare function resolveResourceUploadUrl(baseUrl: string): string;
+/** 从上传接口 JSON 中解析 fileId（兼容常见嵌套 data） */
+export declare function extractFileIdFromUploadResponse(data: unknown): string | undefined;
+export declare function formatFromFilename(filename: string): string;
+/** 仅当含 %XX 序列时 decodeURIComponent，避免对已解码的 Unicode 再 decode 抛错 */
+export declare function safeDecodeUriFilenameSegment(segment: string): string;
+/**
+ * 从 HTTP Content-Disposition 解析文件名（优先 RFC 5987 `filename*=` UTF-8，再普通 filename=）。
+ */
+export declare function parseFilenameFromContentDisposition(header: string | undefined): string | undefined;
+export declare function displayNameFromUrl(url: string): string;
+/** 日志用：截断过长路径/URL */
+export declare function summarizeMediaRef(ref: string, maxLen?: number): string;
+/**
+ * 将字符串解析为可交给 readFile 的本机路径（兼容 Windows / macOS / Linux）。
+ * - 使用当前进程的 path.isAbsolute（各 OS 语义正确）。
+ * - Windows：Git Bash / MSYS 的 `/c/Users/...`、Cygwin `/cygdrive/c/...`。
+ * - 非 Windows：若传入 `D:\...` 形式仍做一次规范化（多用于日志/失败提示，读文件通常会失败）。
+ */
+export declare function resolveLocalFsPath(ref: string): {
+    fsPath: string;
+    via: string;
+} | null;
+/**
+ * 将 Agent 常写的 workspace 相对媒体引用规范为「相对 workspace 根」的段（不含 `/workspace/` 前缀）。
+ *
+ * 支持：`project/...`、`./xg-cwork-im/...`、`/project/...`（沙箱内伪绝对，非本机根目录）。
+ * 不处理：`/workspace/...`（另见 resolveWorkspaceCandidatePaths）、`file://`、`http(s)://`、本机真实绝对路径。
+ */
+export declare function parseWorkspaceRelativeMediaRef(raw: string): string | null;
+/**
+ * 将 workspace 相对段解析为宿主机候选绝对路径（优先 agentWorkspaceDir，其次 cwd、容器 `/workspace`）。
+ */
+export declare function resolveWorkspaceRelativeCandidatePaths(rel: string, agentWorkspaceDir?: string): string[];
+/**
+ * 将 OpenClaw 约定的 `/workspace/<rel>` 路径解析为本机绝对路径列表（通常 1 条）。
+ *
+ * **已能定位 agent 时（传入非空的 agentWorkspaceDir）**：
+ * 只返回该 agent 在宿主机上的 workspace 根目录拼出的唯一路径，不再尝试 `cwd` 或字面量 `/workspace`，
+ * 避免多个 agent 存在相同相对路径（如都叫 `output/report.pdf`）时误读他人文件。
+ *
+ * **无法解析出 agentWorkspaceDir 时**（例如 SDK 解析失败、或未传入）：
+ * 退化为依次尝试 `process.cwd()` 与 `/workspace`（容器挂载），由调用方 readFile 试错；
+ * 此模式下存在跨会话路径混淆的理论风险，应尽量保证上游传入 agentWorkspaceDir。
+ *
+ * 返回空数组表示路径不符合 /workspace/ 格式。
+ */
+export declare function resolveWorkspaceCandidatePaths(raw: string, agentWorkspaceDir?: string): string[];
+/**
+ * @deprecated 使用 resolveWorkspaceCandidatePaths 替代（支持多沙箱 agent）。
+ * 保留此函数避免外部直接引用时编译报错，内部逻辑已切换到多候选方式。
+ */
+export declare function resolveWorkspacePrefixPath(raw: string): string | null;
+export declare function downloadMediaBuffer(url: string, maxBytes: number, log?: Log, 
+/** Agent workspace 宿主机路径（由 resolveAgentWorkspaceDir 得到），用于多沙箱场景下准确解析 /workspace/ 路径 */
+agentWorkspaceDir?: string, timeoutMs?: number): Promise<{
+    buffer: Buffer;
+    filename: string;
+}>;
+/**
+ * multipart 上传整文件，返回 fileId 与字节数。
+ */
+export declare function uploadWholeResourceFile(args: {
+    fileUploadUrl: string;
+    token: string;
+    buffer: Buffer;
+    filename: string;
+    formField: string;
+    log?: Log;
+    /** 默认 {@link IM_FILE_UPLOAD_TIMEOUT_MS}（60s） */
+    timeoutMs?: number;
+}): Promise<{
+    fileId: string;
+    size: number;
+}>;
+export declare function resolveMaxAttachmentBytes(config: {
+    maxAttachmentBytes?: number;
+}): number;
+/**
+ * 资源整文件上传错误：携带 HTTP 状态与是否可重试标记。
+ *
+ * 判定规则（与 send-service 的消息重试对齐）：
+ * - 网络错误 / 超时 / 408 / 429 / 5xx → 可重试
+ * - 其它 4xx / 业务 resultCode 错误 / 缺少 fileId → 永久失败，不重试
+ */
+export declare class ResourceUploadError extends Error {
+    readonly status?: number;
+    readonly retryable: boolean;
+    constructor(message: string, opts: {
+        status?: number;
+        retryable: boolean;
+    });
+}
+/**
+ * 带重试的整文件上传：默认最多 3 次（首次 + 2 次重试），间隔 1s、3s。
+ * 仅对 {@link ResourceUploadError.retryable} 为真的错误重试；业务错误、非可重试 4xx、缺少 fileId 立即抛出。
+ */
+export declare function uploadWholeResourceFileWithRetry(args: Parameters<typeof uploadWholeResourceFile>[0], retry?: {
+    maxAttempts?: number;
+    delaysMs?: number[];
+}): Promise<{
+    fileId: string;
+    size: number;
+}>;
+//# sourceMappingURL=resource-file.d.ts.map

package/dist/src/resource-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-file.d.ts","sourceRoot":"","sources":["../../src/resource-file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGrC,2EAA2E;AAC3E,eAAO,MAAM,6BAA6B,aAAuD,CAAC;AAOlG,uDAAuD;AACvD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,qCAAqC,CAAC;AAEvE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,yCAAyC;AACzC,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAcjF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,iEAAiE;AACjE,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASpE;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CA0BlG;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBtD;AAED,qBAAqB;AACrB,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAInE;AAWD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiCtF;AAqDD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBzE;AAED;;GAEG;AACH,wBAAgB,sCAAsC,CAClD,GAAG,EAAE,MAAM,EACX,iBAAiB,CAAC,EAAE,MAAM,GAC3B,MAAM,EAAE,CAsBV;AA6BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAehG;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrE;AAED,wBAAsB,mBAAmB,CACrC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,GAAG;AACT,uFAAuF;AACvF,iBAAiB,CAAC,EAAE,MAAM,EAC1B,SAAS,GAAE,MAAoC,GAChD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiF/C;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAwE5C;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzF;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAChB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;CAM7E;AAMD;;;GAGG;AACH,wBAAsB,gCAAgC,CAClD,IAAI,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC,EACnD,KAAK,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACtD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B3C"}