clawdbot-dingtalk 0.1.21 → 0.2.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 declare const plugin: {
     id: string;
     name: string;
     description: string;
     configSchema: any;
-    register(api: ClawdbotPluginApi): void;
+    register(api: OpenClawPluginApi): void;
 };
 export default plugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,4 +1,4 @@
-import { emptyPluginConfigSchema } from "clawdbot/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
 import { dingtalkPlugin } from "./src/channel.js";
 import { DINGTALK_PLUGIN_ID } from "./src/config-schema.js";
 import { setDingTalkRuntime } from "./src/runtime.js";

package/dist/src/accounts.d.ts

@@ -1,4 +1,4 @@
-import type { ClawdbotConfig } from "clawdbot/plugin-sdk";
+import type { ClawdbotConfig } from "openclaw/plugin-sdk";
 import { type CoalesceConfig } from "./config-schema.js";
 /**
  * Resolved DingTalk account with normalized configuration.

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

@@ -3,5 +3,7 @@
  * Provides access token management and proactive message sending.
  */
 export { createTokenManager, createTokenManagerFromAccount, clearAllTokens, invalidateToken, type TokenManager, type TokenManagerOptions, } from "./token-manager.js";
-export { sendProactiveMessage, sendBatchDirectMessage, parseTarget, type MessageTarget, type SendMessageOptions, type SendMessageResult, } from "./send-message.js";
+export { sendProactiveMessage, sendBatchDirectMessage, sendImageMessage, sendImageMessageWithMediaId, sendFileMessage, sendActionCardMessage, sendMediaByPath, parseTarget, type MessageTarget, type SendMessageOptions, type SendMessageResult, type SendImageOptions, type SendFileOptions, type SendMediaByPathOptions, } from "./send-message.js";
+export { uploadMedia, downloadMedia, type UploadMediaResult, type DownloadMediaResult, } from "./media.js";
+export { uploadMediaToOAPI, uploadLocalFile, isLocalPath, normalizeLocalPath, isImageUrl, detectMediaType, type MediaType, type UploadMediaResult as UploadMediaToOAPIResult, } from "./media-upload.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EACd,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EACd,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,KAAK,SAAS,EACd,KAAK,iBAAiB,IAAI,uBAAuB,GAClD,MAAM,mBAAmB,CAAC"}

package/dist/src/api/index.js

@@ -3,5 +3,7 @@
  * Provides access token management and proactive message sending.
  */
 export { createTokenManager, createTokenManagerFromAccount, clearAllTokens, invalidateToken, } from "./token-manager.js";
-export { sendProactiveMessage, sendBatchDirectMessage, parseTarget, } from "./send-message.js";
+export { sendProactiveMessage, sendBatchDirectMessage, sendImageMessage, sendImageMessageWithMediaId, sendFileMessage, sendActionCardMessage, sendMediaByPath, parseTarget, } from "./send-message.js";
+export { uploadMedia, downloadMedia, } from "./media.js";
+export { uploadMediaToOAPI, uploadLocalFile, isLocalPath, normalizeLocalPath, isImageUrl, detectMediaType, } from "./media-upload.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EACd,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,GAIZ,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EACd,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,WAAW,GAOZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,aAAa,GAGd,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,eAAe,GAGhB,MAAM,mBAAmB,CAAC"}

package/dist/src/api/media-upload.d.ts

@@ -0,0 +1,71 @@
+/**
+ * DingTalk Media Upload API for local files.
+ * Uses the OAPI media upload endpoint to get mediaId for local files.
+ */
+import type { ResolvedDingTalkAccount } from "../accounts.js";
+import type { StreamLogger } from "../stream/types.js";
+import { type TokenManager } from "./token-manager.js";
+/**
+ * Media type for DingTalk upload API.
+ */
+export type MediaType = "image" | "voice" | "video" | "file";
+/**
+ * Result of uploading media to OAPI.
+ */
+export interface UploadMediaResult {
+    ok: boolean;
+    mediaId?: string;
+    type?: MediaType;
+    error?: Error;
+}
+/**
+ * Detect media type based on file extension.
+ */
+export declare function detectMediaType(fileName: string): MediaType;
+/**
+ * Check if a string is a local file path (not a URL).
+ *
+ * Local path patterns:
+ * - Absolute paths: /tmp/foo.png, /Users/xxx/image.jpg
+ * - Windows paths: C:\Users\xxx\image.jpg
+ * - Home paths: ~/Downloads/image.png
+ * - file:// protocol: file:///tmp/foo.png
+ * - MEDIA: prefix: MEDIA:/tmp/foo.png
+ * - attachment:// prefix: attachment:///tmp/foo.png
+ */
+export declare function isLocalPath(urlOrPath: string): boolean;
+/**
+ * Normalize a local path by removing special prefixes.
+ */
+export declare function normalizeLocalPath(rawPath: string): string;
+/**
+ * Upload media to DingTalk OAPI and get mediaId.
+ *
+ * This uses the old OAPI endpoint (oapi.dingtalk.com/media/upload) which
+ * returns a media_id that can be used with sessionWebhook image messages.
+ *
+ * API: POST https://oapi.dingtalk.com/media/upload?access_token=xxx&type=image
+ */
+export declare function uploadMediaToOAPI(opts: {
+    account: ResolvedDingTalkAccount;
+    media: Buffer;
+    fileName: string;
+    mediaType?: MediaType;
+    tokenManager?: TokenManager;
+    logger?: StreamLogger;
+}): Promise<UploadMediaResult>;
+/**
+ * Upload a local file to DingTalk OAPI.
+ * Reads the file from disk and uploads it.
+ */
+export declare function uploadLocalFile(opts: {
+    account: ResolvedDingTalkAccount;
+    filePath: string;
+    tokenManager?: TokenManager;
+    logger?: StreamLogger;
+}): Promise<UploadMediaResult>;
+/**
+ * Check if a URL points to an image based on extension.
+ */
+export declare function isImageUrl(url: string): boolean;
+//# sourceMappingURL=media-upload.d.ts.map

package/dist/src/api/media-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-upload.d.ts","sourceRoot":"","sources":["../../../src/api/media-upload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQtF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAiBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAM3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAuCtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0B1D;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,uBAAuB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkG7B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,uBAAuB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0B7B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAY/C"}

package/dist/src/api/media-upload.js

@@ -0,0 +1,223 @@
+/**
+ * DingTalk Media Upload API for local files.
+ * Uses the OAPI media upload endpoint to get mediaId for local files.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createTokenManagerFromAccount } from "./token-manager.js";
+/**
+ * DingTalk OAPI base URL for media upload.
+ * This is different from the new API (api.dingtalk.com) used for other operations.
+ */
+const DINGTALK_OAPI_BASE = "https://oapi.dingtalk.com";
+/**
+ * Image file extensions.
+ */
+const IMAGE_EXTENSIONS = new Set([".jpg", ".jpeg", ".png", ".gif", ".bmp", ".webp"]);
+/**
+ * Voice file extensions.
+ */
+const VOICE_EXTENSIONS = new Set([".mp3", ".wav", ".amr", ".opus", ".ogg"]);
+/**
+ * Video file extensions.
+ */
+const VIDEO_EXTENSIONS = new Set([".mp4", ".mov", ".avi", ".mkv", ".webm"]);
+/**
+ * Detect media type based on file extension.
+ */
+export function detectMediaType(fileName) {
+    const ext = path.extname(fileName).toLowerCase();
+    if (IMAGE_EXTENSIONS.has(ext))
+        return "image";
+    if (VOICE_EXTENSIONS.has(ext))
+        return "voice";
+    if (VIDEO_EXTENSIONS.has(ext))
+        return "video";
+    return "file";
+}
+/**
+ * Check if a string is a local file path (not a URL).
+ *
+ * Local path patterns:
+ * - Absolute paths: /tmp/foo.png, /Users/xxx/image.jpg
+ * - Windows paths: C:\Users\xxx\image.jpg
+ * - Home paths: ~/Downloads/image.png
+ * - file:// protocol: file:///tmp/foo.png
+ * - MEDIA: prefix: MEDIA:/tmp/foo.png
+ * - attachment:// prefix: attachment:///tmp/foo.png
+ */
+export function isLocalPath(urlOrPath) {
+    if (!urlOrPath || typeof urlOrPath !== "string")
+        return false;
+    const trimmed = urlOrPath.trim();
+    // Check for special local path prefixes
+    if (trimmed.startsWith("file://") ||
+        trimmed.startsWith("MEDIA:") ||
+        trimmed.startsWith("attachment://")) {
+        return true;
+    }
+    // Check for Unix absolute paths
+    if (trimmed.startsWith("/")) {
+        return true;
+    }
+    // Check for home directory paths
+    if (trimmed.startsWith("~")) {
+        return true;
+    }
+    // Check for Windows absolute paths (C:\ or D:\)
+    if (/^[a-zA-Z]:[\\/]/.test(trimmed)) {
+        return true;
+    }
+    // Check if it's a valid URL (http://, https://, etc.)
+    try {
+        const url = new URL(trimmed);
+        // If it parses as a URL with http/https, it's not a local path
+        return url.protocol === "file:";
+    }
+    catch {
+        // If it doesn't parse as a URL, it might be a relative path
+        // For safety, we treat unrecognized patterns as non-local
+        return false;
+    }
+}
+/**
+ * Normalize a local path by removing special prefixes.
+ */
+export function normalizeLocalPath(rawPath) {
+    let p = rawPath.trim();
+    // Remove special prefixes
+    if (p.startsWith("file://")) {
+        p = p.slice(7);
+    }
+    else if (p.startsWith("MEDIA:")) {
+        p = p.slice(6);
+    }
+    else if (p.startsWith("attachment://")) {
+        p = p.slice(13);
+    }
+    // Handle URL encoding
+    try {
+        p = decodeURIComponent(p);
+    }
+    catch {
+        // Ignore decoding errors
+    }
+    // Expand home directory
+    if (p.startsWith("~")) {
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
+        p = path.join(home, p.slice(1));
+    }
+    return p;
+}
+/**
+ * Upload media to DingTalk OAPI and get mediaId.
+ *
+ * This uses the old OAPI endpoint (oapi.dingtalk.com/media/upload) which
+ * returns a media_id that can be used with sessionWebhook image messages.
+ *
+ * API: POST https://oapi.dingtalk.com/media/upload?access_token=xxx&type=image
+ */
+export async function uploadMediaToOAPI(opts) {
+    const { account, media, fileName, mediaType = detectMediaType(fileName), tokenManager: providedTokenManager, logger, } = opts;
+    const tokenManager = providedTokenManager ?? createTokenManagerFromAccount(account, logger);
+    let accessToken;
+    try {
+        accessToken = await tokenManager.getToken();
+    }
+    catch (err) {
+        logger?.error?.({ err: { message: err?.message } }, "Failed to get access token for OAPI media upload");
+        return { ok: false, error: err };
+    }
+    const url = `${DINGTALK_OAPI_BASE}/media/upload?access_token=${accessToken}&type=${mediaType}`;
+    try {
+        // Create FormData for file upload
+        const formData = new FormData();
+        const blob = new Blob([media], { type: "application/octet-stream" });
+        formData.append("media", blob, fileName);
+        logger?.debug?.({ fileName, mediaType, size: media.length }, "Uploading media to OAPI");
+        const resp = await fetch(url, {
+            method: "POST",
+            body: formData,
+            signal: AbortSignal.timeout(60_000), // 60s timeout for file upload
+        });
+        if (!resp.ok) {
+            const errorText = await resp.text().catch(() => "");
+            logger?.error?.({ status: resp.status, error: errorText.slice(0, 200), fileName }, "OAPI media upload failed (HTTP error)");
+            return {
+                ok: false,
+                error: new Error(`HTTP ${resp.status}: ${errorText.slice(0, 200)}`),
+            };
+        }
+        const data = (await resp.json());
+        // Check for API-level errors
+        if (data.errcode && data.errcode !== 0) {
+            logger?.error?.({ errcode: data.errcode, errmsg: data.errmsg, fileName }, "OAPI media upload failed (API error)");
+            return {
+                ok: false,
+                error: new Error(`DingTalk API error: ${data.errmsg} (code: ${data.errcode})`),
+            };
+        }
+        if (!data.media_id) {
+            logger?.error?.({ data, fileName }, "OAPI media upload failed (no media_id)");
+            return {
+                ok: false,
+                error: new Error("DingTalk API returned no media_id"),
+            };
+        }
+        logger?.debug?.({ mediaId: data.media_id, type: data.type, fileName }, "OAPI media uploaded successfully");
+        return {
+            ok: true,
+            mediaId: data.media_id,
+            type: data.type ?? mediaType,
+        };
+    }
+    catch (err) {
+        logger?.error?.({ err: { message: err?.message }, fileName }, "OAPI media upload error");
+        return { ok: false, error: err };
+    }
+}
+/**
+ * Upload a local file to DingTalk OAPI.
+ * Reads the file from disk and uploads it.
+ */
+export async function uploadLocalFile(opts) {
+    const { account, filePath, tokenManager, logger } = opts;
+    // Normalize the path
+    const normalizedPath = normalizeLocalPath(filePath);
+    // Check if file exists
+    if (!fs.existsSync(normalizedPath)) {
+        logger?.error?.({ filePath: normalizedPath }, "Local file not found");
+        return {
+            ok: false,
+            error: new Error(`File not found: ${normalizedPath}`),
+        };
+    }
+    // Read the file
+    const fileBuffer = fs.readFileSync(normalizedPath);
+    const fileName = path.basename(normalizedPath);
+    return uploadMediaToOAPI({
+        account,
+        media: fileBuffer,
+        fileName,
+        tokenManager,
+        logger,
+    });
+}
+/**
+ * Check if a URL points to an image based on extension.
+ */
+export function isImageUrl(url) {
+    if (!url || typeof url !== "string")
+        return false;
+    try {
+        const pathname = new URL(url).pathname;
+        const ext = path.extname(pathname).toLowerCase();
+        return IMAGE_EXTENSIONS.has(ext);
+    }
+    catch {
+        // If URL parsing fails, try direct extension check
+        const ext = path.extname(url.split("?")[0] ?? "").toLowerCase();
+        return IMAGE_EXTENSIONS.has(ext);
+    }
+}
+//# sourceMappingURL=media-upload.js.map

package/dist/src/api/media-upload.js.map

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

package/dist/src/api/send-message.d.ts

@@ -112,4 +112,35 @@ export interface SendFileOptions {
  * Uses msgKey: sampleFile
  */
 export declare function sendFileMessage(opts: SendFileOptions): Promise<SendMessageResult>;
+/**
+ * Options for sending media by path (local or remote).
+ */
+export interface SendMediaByPathOptions {
+    account: ResolvedDingTalkAccount;
+    to: string;
+    mediaUrl: string;
+    text?: string;
+    tokenManager?: TokenManager;
+    logger?: StreamLogger;
+}
+/**
+ * Send an image message using mediaId.
+ * Used when you have already uploaded a file and have the mediaId.
+ */
+export declare function sendImageMessageWithMediaId(opts: Omit<SendImageOptions, "picUrl"> & {
+    mediaId: string;
+}): Promise<SendMessageResult>;
+/**
+ * Send media by path (supports both local files and remote URLs).
+ *
+ * For local files:
+ * - Reads the file from disk
+ * - Uploads to DingTalk to get mediaId
+ * - Sends as image or file message
+ *
+ * For remote URLs:
+ * - Images: Sends directly using picUrl
+ * - Files: Downloads, uploads to DingTalk, then sends
+ */
+export declare function sendMediaByPath(opts: SendMediaByPathOptions): Promise<SendMessageResult>;
 //# sourceMappingURL=send-message.d.ts.map

package/dist/src/api/send-message.d.ts.map

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

package/dist/src/api/send-message.js

@@ -2,9 +2,12 @@
  * DingTalk Proactive Message Sending API.
  * Supports sending messages to users (1:1) and groups without sessionWebhook.
  */
+import * as fs from "node:fs";
+import * as path from "node:path";
 import { createTokenManagerFromAccount } from "./token-manager.js";
 import { chunkText, chunkMarkdownText, normalizeForTextMessage } from "../send/chunker.js";
 import { convertMarkdownForDingTalk } from "../send/markdown.js";
+import { isLocalPath, normalizeLocalPath, isImageUrl, uploadMediaToOAPI, uploadLocalFile, detectMediaType, } from "./media-upload.js";
 /**
  * Parse target string to determine message type.
  *
@@ -472,4 +475,215 @@ export async function sendFileMessage(opts) {
         return { ok: false, error: err };
     }
 }
+/**
+ * Send an image message using mediaId.
+ * Used when you have already uploaded a file and have the mediaId.
+ */
+export async function sendImageMessageWithMediaId(opts) {
+    const { account, to, mediaId, text, logger, tokenManager: providedTokenManager, } = opts;
+    const target = parseTarget(to);
+    const tokenManager = providedTokenManager ?? createTokenManagerFromAccount(account, logger);
+    let accessToken;
+    try {
+        accessToken = await tokenManager.getToken();
+    }
+    catch (err) {
+        logger?.error?.({ err: { message: err?.message } }, "Failed to get access token for image message (mediaId)");
+        return { ok: false, error: err };
+    }
+    // For image messages with mediaId, use sampleImageMsg with the mediaId as photoURL
+    // DingTalk's sampleImageMsg supports both URL and mediaId in the photoURL field
+    const msgKey = "sampleImageMsg";
+    const msgParam = JSON.stringify({ photoURL: mediaId });
+    const url = target.type === "group"
+        ? `${account.apiBase}/v1.0/robot/groupMessages/send`
+        : `${account.apiBase}/v1.0/robot/oToMessages/batchSend`;
+    try {
+        const body = target.type === "group"
+            ? {
+                robotCode: account.clientId,
+                openConversationId: target.id,
+                msgKey,
+                msgParam,
+            }
+            : {
+                robotCode: account.clientId,
+                userIds: [target.id],
+                msgKey,
+                msgParam,
+            };
+        const resp = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-acs-dingtalk-access-token": accessToken,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!resp.ok) {
+            const errorText = await resp.text().catch(() => "");
+            logger?.error?.({ status: resp.status, error: errorText.slice(0, 200), mediaId }, "Image message (mediaId) failed");
+            return {
+                ok: false,
+                error: new Error(`HTTP ${resp.status}: ${errorText.slice(0, 200)}`),
+            };
+        }
+        const data = (await resp.json());
+        logger?.debug?.({ processQueryKey: data.processQueryKey, mediaId }, "Image message (mediaId) sent");
+        // If there's accompanying text, send it separately
+        if (text?.trim()) {
+            await sendProactiveMessage({
+                account,
+                to,
+                text,
+                replyMode: account.replyMode,
+                logger,
+                tokenManager,
+            });
+        }
+        return {
+            ok: true,
+            processQueryKey: data.processQueryKey,
+        };
+    }
+    catch (err) {
+        logger?.error?.({ err: { message: err?.message }, mediaId }, "Image message (mediaId) error");
+        return { ok: false, error: err };
+    }
+}
+/**
+ * Send media by path (supports both local files and remote URLs).
+ *
+ * For local files:
+ * - Reads the file from disk
+ * - Uploads to DingTalk to get mediaId
+ * - Sends as image or file message
+ *
+ * For remote URLs:
+ * - Images: Sends directly using picUrl
+ * - Files: Downloads, uploads to DingTalk, then sends
+ */
+export async function sendMediaByPath(opts) {
+    const { account, to, mediaUrl, text, tokenManager: providedTokenManager, logger } = opts;
+    const tokenManager = providedTokenManager ?? createTokenManagerFromAccount(account, logger);
+    // Check if it's a local path
+    if (isLocalPath(mediaUrl)) {
+        const localPath = normalizeLocalPath(mediaUrl);
+        const fileName = path.basename(localPath);
+        const mediaType = detectMediaType(fileName);
+        logger?.debug?.({ localPath, mediaType }, "Sending local media");
+        // Check if file exists
+        if (!fs.existsSync(localPath)) {
+            logger?.error?.({ localPath }, "Local file not found");
+            return {
+                ok: false,
+                error: new Error(`File not found: ${localPath}`),
+            };
+        }
+        // Upload the file
+        const uploadResult = await uploadLocalFile({
+            account,
+            filePath: localPath,
+            tokenManager,
+            logger,
+        });
+        if (!uploadResult.ok || !uploadResult.mediaId) {
+            return {
+                ok: false,
+                error: uploadResult.error ?? new Error("Failed to upload local file"),
+            };
+        }
+        // Send based on media type
+        if (mediaType === "image") {
+            return sendImageMessageWithMediaId({
+                account,
+                to,
+                mediaId: uploadResult.mediaId,
+                text,
+                tokenManager,
+                logger,
+            });
+        }
+        else {
+            return sendFileMessage({
+                account,
+                to,
+                mediaId: uploadResult.mediaId,
+                fileName,
+                fileType: mediaType,
+                tokenManager,
+                logger,
+            });
+        }
+    }
+    // Remote URL handling
+    const isImage = isImageUrl(mediaUrl);
+    if (isImage) {
+        // For remote images, try sending directly with URL
+        logger?.debug?.({ mediaUrl }, "Sending remote image via URL");
+        return sendImageMessage({
+            account,
+            to,
+            picUrl: mediaUrl,
+            text,
+            tokenManager,
+            logger,
+        });
+    }
+    // For non-image remote files, download first, then upload and send
+    logger?.debug?.({ mediaUrl }, "Downloading remote file for upload");
+    try {
+        const response = await fetch(mediaUrl, {
+            signal: AbortSignal.timeout(60_000),
+        });
+        if (!response.ok) {
+            return {
+                ok: false,
+                error: new Error(`Failed to download file: HTTP ${response.status}`),
+            };
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        const buffer = Buffer.from(arrayBuffer);
+        // Extract filename from URL
+        let fileName;
+        try {
+            const pathname = new URL(mediaUrl).pathname;
+            fileName = path.basename(pathname) || "file";
+        }
+        catch {
+            fileName = "file";
+        }
+        const mediaType = detectMediaType(fileName);
+        // Upload to DingTalk
+        const uploadResult = await uploadMediaToOAPI({
+            account,
+            media: buffer,
+            fileName,
+            mediaType,
+            tokenManager,
+            logger,
+        });
+        if (!uploadResult.ok || !uploadResult.mediaId) {
+            return {
+                ok: false,
+                error: uploadResult.error ?? new Error("Failed to upload remote file"),
+            };
+        }
+        // Send as file
+        return sendFileMessage({
+            account,
+            to,
+            mediaId: uploadResult.mediaId,
+            fileName,
+            fileType: mediaType,
+            tokenManager,
+            logger,
+        });
+    }
+    catch (err) {
+        logger?.error?.({ err: { message: err?.message }, mediaUrl }, "Failed to download and send remote file");
+        return { ok: false, error: err };
+    }
+}
 //# sourceMappingURL=send-message.js.map