@xgjktech/xg_cwork_im 1.12.8 → 1.13.1

package/dist/src/send-group-message-tool.js

@@ -7,6 +7,7 @@
  * 通过 api.registerTool() 注入，工具内部自动获取机器人 token。
  */
 import { Type } from "@sinclair/typebox";
+import { prefixProactiveOutboundText } from "./inbound-terminal-delivery.js";
 import { toolJsonResult } from "./tool-json-result.js";
 import { getToken } from "./auth.js";
 import { sendTextMessage } from "./send-service.js";
@@ -60,8 +61,9 @@ export function buildSendGroupMessageTool(config, hints) {
             }
             try {
                 const accountConfig = resolveAccountConfig(config, accountId);
-                await sendTextMessage(accountConfig, identity.token, groupId, text, atUserIds);
-                console.log(`[cwork_im][tool] xg_cwork_im_send_group_message success: groupId=${groupId} using accountId=${accountId ?? "0"}`);
+                const outboundText = prefixProactiveOutboundText(text, "cron");
+                await sendTextMessage(accountConfig, identity.token, groupId, outboundText, atUserIds);
+                console.log(`[cwork_im][tool] xg_cwork_im_send_group_message success: groupId=${groupId} trigger=cron using accountId=${accountId ?? "0"}`);
             }
             catch (err) {
                 return toolJsonResult({

package/dist/src/send-group-message-tool.js.map

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

package/dist/src/single-chat-no-reply-fallback.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 单聊轮次结束但未向 IM 发出正文时的兜底话术（如模型输出 NO_REPLY、deliver 未被调用）。
+ */
+import type { WsMessageParams } from "./types.js";
+export declare function shouldSendSingleChatNoReplyFallback(args: {
+    params: WsMessageParams;
+    hasFirstReply: boolean;
+    deliverCallCount: number;
+    dispatchError?: unknown;
+    lastDeliverError?: unknown;
+}): boolean;
+/** 单聊静默轮次兜底：简短告知并引导重试。 */
+export declare function buildSingleChatNoReplyFallbackText(): string;
+//# sourceMappingURL=single-chat-no-reply-fallback.d.ts.map

package/dist/src/single-chat-no-reply-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-chat-no-reply-fallback.d.ts","sourceRoot":"","sources":["../../src/single-chat-no-reply-fallback.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,mCAAmC,CAAC,IAAI,EAAE;IACtD,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B,GAAG,OAAO,CAMV;AAED,0BAA0B;AAC1B,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D"}

package/dist/src/single-chat-no-reply-fallback.js

@@ -0,0 +1,20 @@
+/**
+ * 单聊轮次结束但未向 IM 发出正文时的兜底话术（如模型输出 NO_REPLY、deliver 未被调用）。
+ */
+import { isImSingleChat } from "./inbound-chat-type.js";
+export function shouldSendSingleChatNoReplyFallback(args) {
+    if (args.hasFirstReply)
+        return false;
+    if (args.dispatchError !== undefined || args.lastDeliverError !== undefined)
+        return false;
+    if (!isImSingleChat(args.params))
+        return false;
+    if (args.deliverCallCount > 0)
+        return false;
+    return true;
+}
+/** 单聊静默轮次兜底：简短告知并引导重试。 */
+export function buildSingleChatNoReplyFallbackText() {
+    return "消息已收到，但这一轮没有生成回复。请换个说法或把需求说具体一些后再试。";
+}
+//# sourceMappingURL=single-chat-no-reply-fallback.js.map

package/dist/src/single-chat-no-reply-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-chat-no-reply-fallback.js","sourceRoot":"","sources":["../../src/single-chat-no-reply-fallback.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,MAAM,UAAU,mCAAmC,CAAC,IAMnD;IACG,IAAI,IAAI,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1F,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,kCAAkC;IAC9C,OAAO,qCAAqC,CAAC;AACjD,CAAC"}

package/dist/src/sync-mapping-types.d.ts

@@ -30,7 +30,10 @@ declare const upsertParamsSchema: z.ZodObject<{
         kind: "workspace_relative" | "host_absolute";
         path: string;
     }>;
-    remoteRootFolderPath: z.ZodString;
+    /** 知识库目录 fileId；与 remoteRootFolderPath 二选一，优先使用本字段 */
+    remoteRootFolderId: z.ZodOptional<z.ZodString>;
+    /** 知识库内逻辑路径；remoteRootFolderId 未填时必填 */
+    remoteRootFolderPath: z.ZodOptional<z.ZodString>;
     kbProjectId: z.ZodOptional<z.ZodString>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     sync: z.ZodOptional<z.ZodObject<{
@@ -54,8 +57,9 @@ declare const upsertParamsSchema: z.ZodObject<{
     appKey: string;
     action: "upsert";
     mappingId: string;
-    remoteRootFolderPath: string;
+    remoteRootFolderPath?: string | undefined;
     enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
     kbProjectId?: string | undefined;
     sync?: {
         direction?: "push" | "bidirectional" | "pull" | undefined;
@@ -70,8 +74,9 @@ declare const upsertParamsSchema: z.ZodObject<{
     appKey: string;
     action: "upsert";
     mappingId: string;
-    remoteRootFolderPath: string;
+    remoteRootFolderPath?: string | undefined;
     enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
     kbProjectId?: string | undefined;
     sync?: {
         direction?: "push" | "bidirectional" | "pull" | undefined;
@@ -89,7 +94,7 @@ declare const deleteParamsSchema: z.ZodObject<{
     action: "delete";
     mappingId: string;
 }>;
-export declare const syncMappingParamsSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+export declare const syncMappingParamsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
     action: z.ZodLiteral<"upsert">;
     mappingId: z.ZodString;
     appKey: z.ZodString;
@@ -103,7 +108,10 @@ export declare const syncMappingParamsSchema: z.ZodDiscriminatedUnion<"action",
         kind: "workspace_relative" | "host_absolute";
         path: string;
     }>;
-    remoteRootFolderPath: z.ZodString;
+    /** 知识库目录 fileId；与 remoteRootFolderPath 二选一，优先使用本字段 */
+    remoteRootFolderId: z.ZodOptional<z.ZodString>;
+    /** 知识库内逻辑路径；remoteRootFolderId 未填时必填 */
+    remoteRootFolderPath: z.ZodOptional<z.ZodString>;
     kbProjectId: z.ZodOptional<z.ZodString>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     sync: z.ZodOptional<z.ZodObject<{
@@ -127,8 +135,9 @@ export declare const syncMappingParamsSchema: z.ZodDiscriminatedUnion<"action",
     appKey: string;
     action: "upsert";
     mappingId: string;
-    remoteRootFolderPath: string;
+    remoteRootFolderPath?: string | undefined;
     enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
     kbProjectId?: string | undefined;
     sync?: {
         direction?: "push" | "bidirectional" | "pull" | undefined;
@@ -143,8 +152,9 @@ export declare const syncMappingParamsSchema: z.ZodDiscriminatedUnion<"action",
     appKey: string;
     action: "upsert";
     mappingId: string;
-    remoteRootFolderPath: string;
+    remoteRootFolderPath?: string | undefined;
     enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
     kbProjectId?: string | undefined;
     sync?: {
         direction?: "push" | "bidirectional" | "pull" | undefined;
@@ -160,7 +170,47 @@ export declare const syncMappingParamsSchema: z.ZodDiscriminatedUnion<"action",
 }, {
     action: "delete";
     mappingId: string;
-}>]>;
+}>]>, {
+    localRoot: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    };
+    appKey: string;
+    action: "upsert";
+    mappingId: string;
+    remoteRootFolderPath?: string | undefined;
+    enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
+    kbProjectId?: string | undefined;
+    sync?: {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    } | undefined;
+} | {
+    action: "delete";
+    mappingId: string;
+}, {
+    localRoot: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    };
+    appKey: string;
+    action: "upsert";
+    mappingId: string;
+    remoteRootFolderPath?: string | undefined;
+    enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
+    kbProjectId?: string | undefined;
+    sync?: {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    } | undefined;
+} | {
+    action: "delete";
+    mappingId: string;
+}>;
 export type SyncMappingParams = z.infer<typeof syncMappingParamsSchema>;
 export type SyncMappingUpsertParams = z.infer<typeof upsertParamsSchema>;
 export type SyncMappingDeleteParams = z.infer<typeof deleteParamsSchema>;

package/dist/src/sync-mapping-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-mapping-types.d.ts","sourceRoot":"","sources":["../../src/sync-mapping-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,iEAAiE;AACjE,eAAO,MAAM,eAAe,4CAA6C,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAU7D,yCAAyC;AACzC,QAAA,MAAM,eAAe;;;;;;;;;EAGnB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAStB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;EAGtB,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACzE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAEnE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAEtE"}
+{"version":3,"file":"sync-mapping-types.d.ts","sourceRoot":"","sources":["../../src/sync-mapping-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,iEAAiE;AACjE,eAAO,MAAM,eAAe,4CAA6C,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAU7D,yCAAyC;AACzC,QAAA,MAAM,eAAe;;;;;;;;;EAGnB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;IAKpB,sDAAsD;;IAEtD,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK1C,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;EAGtB,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;IAdhC,sDAAsD;;IAEtD,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBtC,CAAC;AAEP,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACzE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAEnE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAEtE"}

package/dist/src/sync-mapping-types.js

@@ -22,7 +22,10 @@ const upsertParamsSchema = z.object({
     mappingId: z.string().min(1),
     appKey: z.string().min(1),
     localRoot: localRootSchema,
-    remoteRootFolderPath: z.string().min(1),
+    /** 知识库目录 fileId；与 remoteRootFolderPath 二选一，优先使用本字段 */
+    remoteRootFolderId: z.string().min(1).optional(),
+    /** 知识库内逻辑路径；remoteRootFolderId 未填时必填 */
+    remoteRootFolderPath: z.string().min(1).optional(),
     kbProjectId: z.string().min(1).optional(),
     enabled: z.boolean().optional(),
     sync: syncOptionsSchema,
@@ -31,10 +34,21 @@ const deleteParamsSchema = z.object({
     action: z.literal("delete"),
     mappingId: z.string().min(1),
 });
-export const syncMappingParamsSchema = z.discriminatedUnion("action", [
-    upsertParamsSchema,
-    deleteParamsSchema,
-]);
+export const syncMappingParamsSchema = z
+    .discriminatedUnion("action", [upsertParamsSchema, deleteParamsSchema])
+    .superRefine((data, ctx) => {
+    if (data.action !== "upsert")
+        return;
+    const hasId = Boolean(data.remoteRootFolderId?.trim());
+    const hasPath = Boolean(data.remoteRootFolderPath?.trim());
+    if (!hasId && !hasPath) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "remoteRootFolderId 与 remoteRootFolderPath 至少填一个",
+            path: ["remoteRootFolderId"],
+        });
+    }
+});
 export function parseSyncMappingParams(raw) {
     return syncMappingParamsSchema.parse(raw);
 }

package/dist/src/sync-mapping-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync-mapping-types.js","sourceRoot":"","sources":["../../src/sync-mapping-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAG1E,MAAM,iBAAiB,GAAG,CAAC;KACtB,MAAM,CAAC;IACJ,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IAC7C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC;KACD,QAAQ,EAAE,CAAC;AAEhB,yCAAyC;AACzC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,SAAS,EAAE,eAAe;IAC1B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,iBAAiB;CAC1B,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IAClE,kBAAkB;IAClB,kBAAkB;CACrB,CAAC,CAAC;AAOH,MAAM,UAAU,sBAAsB,CAAC,GAAY;IAC/C,OAAO,uBAAuB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"sync-mapping-types.js","sourceRoot":"","sources":["../../src/sync-mapping-types.ts"],"names":[],"mappings":"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"}

package/dist/src/sync-service-client.d.ts

@@ -9,7 +9,9 @@ export interface SyncMappingUpsertBody {
     enabled?: boolean;
     appKey: string;
     projectId?: string;
-    remoteRootFolderPath: string;
+    /** 知识库远端根目录 fileId（IM 信令 remoteRootFolderId 映射而来） */
+    remoteRootFileId?: string;
+    remoteRootFolderPath?: string;
     filePatterns?: string[];
     excludePatterns?: string[];
     syncDirection?: SyncDirection;

package/dist/src/sync-service-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-service-client.d.ts","sourceRoot":"","sources":["../../src/sync-service-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC;AAuBD,qDAAqD;AACrD,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,qBAAqB,EAC3B,GAAG,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,uBAAuB,CAAC,CAyClC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAapG"}
+{"version":3,"file":"sync-service-client.d.ts","sourceRoot":"","sources":["../../src/sync-service-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC;AAuBD,qDAAqD;AACrD,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,qBAAqB,EAC3B,GAAG,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,uBAAuB,CAAC,CAyClC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAapG"}

package/dist/src/sync-service-client.js.map

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

package/dist/src/ws-inbound-schema.d.ts

@@ -0,0 +1,14 @@
+/**
+ * WebSocket 入站 robotMention / groupMessage 结构校验。
+ */
+import type { WsMessage } from "./types.js";
+export type ParseWsInboundResult = {
+    ok: true;
+    message: WsMessage;
+} | {
+    ok: false;
+    error: string;
+};
+/** 校验 IM WebSocket 入站信封；失败时返回可读错误（不含原始 payload）。 */
+export declare function parseWsInboundMessage(raw: unknown): ParseWsInboundResult;
+//# sourceMappingURL=ws-inbound-schema.d.ts.map

package/dist/src/ws-inbound-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-inbound-schema.d.ts","sourceRoot":"","sources":["../../src/ws-inbound-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkD5C,MAAM,MAAM,oBAAoB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,oDAAoD;AACpD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAkBxE"}

package/dist/src/ws-inbound-schema.js

@@ -0,0 +1,67 @@
+/**
+ * WebSocket 入站 robotMention / groupMessage 结构校验。
+ */
+import { z } from "zod";
+const msgFileVOSchema = z
+    .object({
+    url: z.string().optional(),
+    format: z.string().optional(),
+    source: z.string().optional(),
+    fileId: z.string().optional(),
+    size: z.number().optional(),
+    name: z.string().optional(),
+    content: z.string().optional(),
+    download: z.union([z.boolean(), z.string(), z.number()]).optional(),
+})
+    .passthrough();
+const msgContentSchema = z
+    .object({
+    type: z.string().min(1, "msgContent.type is required"),
+    text: z.string().optional(),
+    files: z.array(msgFileVOSchema).optional(),
+    ext: z.record(z.unknown()).optional(),
+})
+    .passthrough();
+const userInfoSchema = z.object({
+    id: z.string().min(1, "userInfo.id is required"),
+    name: z.string().optional(),
+    background: z.string().optional(),
+});
+const wsMessageParamsSchema = z
+    .object({
+    msgId: z.string().min(1, "msgId is required"),
+    groupId: z.string().min(1, "groupId is required"),
+    userInfo: userInfoSchema,
+    msgContent: msgContentSchema,
+    agentContext: z.unknown().optional(),
+    msgSendTime: z.number().optional(),
+    timestamp: z.number().optional(),
+    mentions: z.array(z.union([z.string(), z.number()])).nullable().optional(),
+    chatType: z.string().optional(),
+})
+    .passthrough();
+const wsInboundEnvelopeSchema = z.object({
+    cmd: z.enum(["robotMention", "groupMessage"]),
+    params: wsMessageParamsSchema,
+    ts: z.number().optional(),
+});
+/** 校验 IM WebSocket 入站信封；失败时返回可读错误（不含原始 payload）。 */
+export function parseWsInboundMessage(raw) {
+    const parsed = wsInboundEnvelopeSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issue = parsed.error.issues[0];
+        const path = issue?.path?.length ? issue.path.join(".") : "payload";
+        const detail = issue?.message ?? parsed.error.message;
+        return { ok: false, error: `${path}: ${detail}` };
+    }
+    const { cmd, params, ts } = parsed.data;
+    return {
+        ok: true,
+        message: {
+            cmd,
+            params: params,
+            ts: typeof ts === "number" ? ts : Date.now(),
+        },
+    };
+}
+//# sourceMappingURL=ws-inbound-schema.js.map

package/dist/src/ws-inbound-schema.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg_cwork_im",
-  "version": "1.12.8",
+  "version": "1.13.1",
   "description": "XG CWork IM channel plugin for OpenClaw",
   "keywords": [
     "bot",
@@ -22,6 +22,7 @@
     "build": "tsc -p tsconfig.json",
     "type-check": "tsc -p tsconfig.json --noEmit",
     "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test dist/src/inbound-terminal-state.test.js",
     "install:prod": "npm install --omit=dev",
     "prepublishOnly": "npm run build"
   },
@@ -68,4 +69,4 @@
       "defaultChoice": "local"
     }
   }
-}
+}