clawdbot-dingtalk 0.1.0

package/dist/src/stream/client.js.map

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

package/dist/src/stream/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Stream module exports.
+ */
+export { startDingTalkStreamClient } from "./client.js";
+export { extractChatbotMessage, buildAck, buildSessionKey, startsWithPrefix } from "./message-parser.js";
+export type { ChatbotMessage, RawStreamMessage, StreamAck, StreamClientHandle, StreamClientOptions, StreamConnectionInfo, StreamLogger, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/stream/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stream/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACzG,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/src/stream/index.js

@@ -0,0 +1,6 @@
+/**
+ * Stream module exports.
+ */
+export { startDingTalkStreamClient } from "./client.js";
+export { extractChatbotMessage, buildAck, buildSessionKey, startsWithPrefix } from "./message-parser.js";
+//# sourceMappingURL=index.js.map

package/dist/src/stream/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stream/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/stream/message-parser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Multi-path field extraction for DingTalk's unstable API schemas.
+ * DingTalk stream payloads can have different field names/paths across versions.
+ */
+import type { ChatbotMessage, RawStreamMessage, StreamAck } from "./types.js";
+/**
+ * Extract chatbot message from raw stream event.
+ * Returns null if this doesn't look like a chatbot message.
+ */
+export declare function extractChatbotMessage(raw: RawStreamMessage): ChatbotMessage | null;
+/**
+ * Build ACK message for stream protocol.
+ */
+export declare function buildAck(raw: RawStreamMessage): StreamAck | null;
+/**
+ * Build session key from chat message.
+ * Groups share a conversation key, DMs use sender ID.
+ */
+export declare function buildSessionKey(chat: ChatbotMessage): string;
+/**
+ * Check if message text starts with required prefix (case-insensitive).
+ */
+export declare function startsWithPrefix(text: string, prefix: string | undefined): boolean;
+//# sourceMappingURL=message-parser.d.ts.map

package/dist/src/stream/message-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-parser.d.ts","sourceRoot":"","sources":["../../../src/stream/message-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAuC9E;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,cAAc,GAAG,IAAI,CAgJlF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAuBhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAM5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGlF"}

package/dist/src/stream/message-parser.js

@@ -0,0 +1,211 @@
+/**
+ * Multi-path field extraction for DingTalk's unstable API schemas.
+ * DingTalk stream payloads can have different field names/paths across versions.
+ */
+/**
+ * Safely access nested object property by dot-separated path.
+ */
+function get(obj, path) {
+    if (!obj || typeof obj !== "object")
+        return undefined;
+    const parts = path.split(".");
+    let cur = obj;
+    for (const p of parts) {
+        if (cur && typeof cur === "object" && p in cur) {
+            cur = cur[p];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return cur;
+}
+/**
+ * Try multiple paths and return the first non-empty value.
+ */
+function first(obj, paths) {
+    for (const p of paths) {
+        const v = get(obj, p);
+        if (v !== undefined && v !== null && v !== "")
+            return v;
+    }
+    return undefined;
+}
+/**
+ * Convert value to string, handling null/undefined.
+ */
+function asString(v) {
+    if (v === undefined || v === null)
+        return "";
+    if (typeof v === "string")
+        return v;
+    return String(v);
+}
+/**
+ * Extract chatbot message from raw stream event.
+ * Returns null if this doesn't look like a chatbot message.
+ */
+export function extractChatbotMessage(raw) {
+    // Common wrappers: { headers, data } / { header, payload } / etc
+    const headers = raw?.headers ?? raw?.header ?? raw?.meta ?? {};
+    let data = raw?.data ?? raw?.payload ?? raw?.body ?? raw?.event ?? raw?.content ?? raw;
+    // DingTalk Stream may wrap data as a JSON string - parse it
+    if (typeof data === "string" && data.startsWith("{")) {
+        try {
+            data = JSON.parse(data);
+        }
+        catch {
+            // ignore parse errors
+        }
+    }
+    const eventType = asString(first(raw, [
+        "type",
+        "eventType",
+        "event_type",
+        "headers.eventType",
+        "headers.event_type",
+        "header.eventType",
+        "header.event_type",
+        "headers.type",
+    ]));
+    const messageId = asString(first(raw, [
+        "headers.messageId",
+        "headers.message_id",
+        "header.messageId",
+        "header.message_id",
+        "messageId",
+        "message_id",
+        "id",
+        "uuid",
+    ]));
+    const sessionWebhook = asString(first(data, [
+        "sessionWebhook",
+        "session_webhook",
+        "conversationSessionWebhook",
+        "conversation.sessionWebhook",
+        "context.sessionWebhook",
+        "webhook",
+    ]));
+    // Try multiple paths for text content
+    const text = asString(first(data, [
+        "text.content",
+        "text",
+        "content.text",
+        "content",
+        "message.text",
+        "msg.text",
+        "data.text",
+        "data.text.content",
+    ]));
+    const conversationId = asString(first(data, [
+        "conversationId",
+        "conversation_id",
+        "conversation.conversationId",
+        "conversation.id",
+        "chatId",
+        "chat_id",
+        "openConversationId",
+        "open_conversation_id",
+    ]));
+    const chatType = asString(first(data, [
+        "conversationType",
+        "conversation_type",
+        "conversation.conversationType",
+        "chatType",
+        "chat_type",
+    ]));
+    const senderId = asString(first(data, [
+        "senderStaffId",
+        "sender.staffId",
+        "senderId",
+        "sender.id",
+        "sender.userid",
+        "userId",
+        "user_id",
+        "staffId",
+    ]));
+    const senderName = asString(first(data, [
+        "senderNick",
+        "sender.nick",
+        "sender.name",
+        "senderName",
+        "userName",
+        "user_name",
+    ]));
+    // DingTalk may wrap actual content in a JSON string
+    let finalText = text;
+    try {
+        if (finalText && finalText.startsWith("{") && finalText.endsWith("}")) {
+            const parsed = JSON.parse(finalText);
+            const maybe = asString(first(parsed, ["text.content", "content", "text"]));
+            if (maybe)
+                finalText = maybe;
+        }
+    }
+    catch {
+        // ignore
+    }
+    // Decide whether this looks like a chatbot message
+    const looksLikeChatbot = Boolean(sessionWebhook) ||
+        /chatbot|bot|im\.|message/i.test(eventType) ||
+        /chatbot|bot/i.test(asString(first(headers, ["topic", "eventType", "type"])));
+    if (!looksLikeChatbot)
+        return null;
+    if (!finalText)
+        return null;
+    return {
+        messageId,
+        eventType,
+        text: finalText,
+        sessionWebhook,
+        conversationId,
+        chatType,
+        senderId,
+        senderName,
+        raw,
+    };
+}
+/**
+ * Build ACK message for stream protocol.
+ */
+export function buildAck(raw) {
+    const messageId = asString(first(raw, [
+        "headers.messageId",
+        "headers.message_id",
+        "header.messageId",
+        "header.message_id",
+        "messageId",
+        "message_id",
+        "id",
+        "uuid",
+    ]));
+    if (!messageId)
+        return null;
+    return {
+        code: 200,
+        headers: {
+            messageId,
+        },
+        message: "OK",
+    };
+}
+/**
+ * Build session key from chat message.
+ * Groups share a conversation key, DMs use sender ID.
+ */
+export function buildSessionKey(chat) {
+    const conv = chat.conversationId || "unknownConv";
+    const sender = chat.senderId || "unknownSender";
+    const chatType = (chat.chatType || "").toLowerCase();
+    const isGroup = /group|chat|2|multi/.test(chatType);
+    return isGroup ? `dingtalk:group:${conv}` : `dingtalk:dm:${sender}`;
+}
+/**
+ * Check if message text starts with required prefix (case-insensitive).
+ */
+export function startsWithPrefix(text, prefix) {
+    if (!prefix)
+        return true;
+    return text.trim().toLowerCase().startsWith(prefix.trim().toLowerCase());
+}
+//# sourceMappingURL=message-parser.js.map

package/dist/src/stream/message-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-parser.js","sourceRoot":"","sources":["../../../src/stream/message-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,SAAS,GAAG,CAAC,GAAY,EAAE,IAAY;IACrC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,IAAK,GAA+B,EAAE,CAAC;YAC5E,GAAG,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAS,KAAK,CAAC,GAAY,EAAE,KAAe;IAC1C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE;YAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,CAAU;IAC1B,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAqB;IACzD,iEAAiE;IACjE,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,IAAI,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;IAC/D,IAAI,IAAI,GAAY,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,KAAK,IAAI,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC;IAEhG,4DAA4D;IAC5D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CACxB,KAAK,CAAC,GAAG,EAAE;QACT,MAAM;QACN,WAAW;QACX,YAAY;QACZ,mBAAmB;QACnB,oBAAoB;QACpB,kBAAkB;QAClB,mBAAmB;QACnB,cAAc;KACf,CAAC,CACH,CAAC;IAEF,MAAM,SAAS,GAAG,QAAQ,CACxB,KAAK,CAAC,GAAG,EAAE;QACT,mBAAmB;QACnB,oBAAoB;QACpB,kBAAkB;QAClB,mBAAmB;QACnB,WAAW;QACX,YAAY;QACZ,IAAI;QACJ,MAAM;KACP,CAAC,CACH,CAAC;IAEF,MAAM,cAAc,GAAG,QAAQ,CAC7B,KAAK,CAAC,IAAI,EAAE;QACV,gBAAgB;QAChB,iBAAiB;QACjB,4BAA4B;QAC5B,6BAA6B;QAC7B,wBAAwB;QACxB,SAAS;KACV,CAAC,CACH,CAAC;IAEF,sCAAsC;IACtC,MAAM,IAAI,GAAG,QAAQ,CACnB,KAAK,CAAC,IAAI,EAAE;QACV,cAAc;QACd,MAAM;QACN,cAAc;QACd,SAAS;QACT,cAAc;QACd,UAAU;QACV,WAAW;QACX,mBAAmB;KACpB,CAAC,CACH,CAAC;IAEF,MAAM,cAAc,GAAG,QAAQ,CAC7B,KAAK,CAAC,IAAI,EAAE;QACV,gBAAgB;QAChB,iBAAiB;QACjB,6BAA6B;QAC7B,iBAAiB;QACjB,QAAQ;QACR,SAAS;QACT,oBAAoB;QACpB,sBAAsB;KACvB,CAAC,CACH,CAAC;IAEF,MAAM,QAAQ,GAAG,QAAQ,CACvB,KAAK,CAAC,IAAI,EAAE;QACV,kBAAkB;QAClB,mBAAmB;QACnB,+BAA+B;QAC/B,UAAU;QACV,WAAW;KACZ,CAAC,CACH,CAAC;IAEF,MAAM,QAAQ,GAAG,QAAQ,CACvB,KAAK,CAAC,IAAI,EAAE;QACV,eAAe;QACf,gBAAgB;QAChB,UAAU;QACV,WAAW;QACX,eAAe;QACf,QAAQ;QACR,SAAS;QACT,SAAS;KACV,CAAC,CACH,CAAC;IAEF,MAAM,UAAU,GAAG,QAAQ,CACzB,KAAK,CAAC,IAAI,EAAE;QACV,YAAY;QACZ,aAAa;QACb,aAAa;QACb,YAAY;QACZ,UAAU;QACV,WAAW;KACZ,CAAC,CACH,CAAC;IAEF,oDAAoD;IACpD,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,SAAS,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAA4B,CAAC;YAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YAC3E,IAAI,KAAK;gBAAE,SAAS,GAAG,KAAK,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IAED,mDAAmD;IACnD,MAAM,gBAAgB,GACpB,OAAO,CAAC,cAAc,CAAC;QACvB,2BAA2B,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3C,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhF,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,OAAO;QACL,SAAS;QACT,SAAS;QACT,IAAI,EAAE,SAAS;QACf,cAAc;QACd,cAAc;QACd,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,GAAG;KACJ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAqB;IAC5C,MAAM,SAAS,GAAG,QAAQ,CACxB,KAAK,CAAC,GAAG,EAAE;QACT,mBAAmB;QACnB,oBAAoB;QACpB,kBAAkB;QAClB,mBAAmB;QACnB,WAAW;QACX,YAAY;QACZ,IAAI;QACJ,MAAM;KACP,CAAC,CACH,CAAC;IAEF,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,OAAO;QACL,IAAI,EAAE,GAAG;QACT,OAAO,EAAE;YACP,SAAS;SACV;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAoB;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,IAAI,aAAa,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC;IAChD,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,CAAC,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC,eAAe,MAAM,EAAE,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAA0B;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/src/stream/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * DingTalk message types extracted from stream events.
+ */
+/**
+ * Raw stream message envelope (varies across DingTalk versions)
+ */
+export interface RawStreamMessage {
+    type?: string;
+    eventType?: string;
+    event_type?: string;
+    headers?: RawHeaders;
+    header?: RawHeaders;
+    meta?: RawHeaders;
+    data?: unknown;
+    payload?: unknown;
+    body?: unknown;
+    event?: unknown;
+    content?: unknown;
+    messageId?: string;
+    message_id?: string;
+    id?: string;
+    uuid?: string;
+}
+export interface RawHeaders {
+    eventType?: string;
+    event_type?: string;
+    type?: string;
+    topic?: string;
+    messageId?: string;
+    message_id?: string;
+    contentType?: string;
+}
+/**
+ * Parsed chatbot message with normalized fields.
+ */
+export interface ChatbotMessage {
+    messageId: string;
+    eventType: string;
+    text: string;
+    sessionWebhook: string;
+    conversationId: string;
+    chatType: string;
+    senderId: string;
+    senderName: string;
+    raw: RawStreamMessage;
+}
+/**
+ * Stream connection info from open API.
+ */
+export interface StreamConnectionInfo {
+    endpoint: string;
+    ticket?: string;
+    raw: unknown;
+}
+/**
+ * ACK message format for stream protocol.
+ */
+export interface StreamAck {
+    code: number;
+    headers: {
+        messageId: string;
+    };
+    message: string;
+}
+/**
+ * Stream client handle for stopping the connection.
+ */
+export interface StreamClientHandle {
+    stop: () => void;
+}
+/**
+ * Options for starting the stream client.
+ */
+export interface StreamClientOptions {
+    clientId: string;
+    clientSecret: string;
+    apiBase: string;
+    openPath: string;
+    openBody?: Record<string, unknown>;
+    logger?: StreamLogger;
+    onChatMessage: (message: ChatbotMessage) => Promise<void>;
+}
+/**
+ * Logger interface for stream client.
+ */
+export interface StreamLogger {
+    debug?: (obj: Record<string, unknown>, msg?: string) => void;
+    info?: (obj: Record<string, unknown> | string, msg?: string) => void;
+    warn?: (obj: Record<string, unknown> | string, msg?: string) => void;
+    error?: (obj: Record<string, unknown>, msg?: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/stream/types.d.ts.map

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

package/dist/src/stream/types.js

@@ -0,0 +1,5 @@
+/**
+ * DingTalk message types extracted from stream events.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/stream/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/stream/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "clawdbot-dingtalk",
+  "version": "0.1.0",
+  "description": "DingTalk (钉钉) channel plugin for Clawdbot - enables AI agent messaging via DingTalk Stream API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "clawdbot.plugin.json"
+  ],
+  "clawdbot": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "clawdbot",
+    "clawdbot-plugin",
+    "dingtalk",
+    "钉钉",
+    "chatbot",
+    "ai-agent",
+    "enterprise-messaging"
+  ],
+  "author": "Aliyun",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aliyun/tech-solution-clawdbot-extension.git",
+    "directory": "extensions/dingtalk"
+  },
+  "bugs": {
+    "url": "https://github.com/aliyun/tech-solution-clawdbot-extension/issues"
+  },
+  "homepage": "https://github.com/aliyun/tech-solution-clawdbot-extension#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "ws": "^8.18.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.7.0"
+  },
+  "peerDependencies": {
+    "clawdbot": ">=0.1.0"
+  }
+}