im-connector 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 im-connector contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,86 @@
-# Temporary Holding Version
+# im-connector
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+让 AI Agent 通过 MCP 调用**钉钉（dws）**和**企业微信（wecom-cli）**的 CLI，在渠道里干活：发消息、写日志/日报、建待办、查日程、处理审批。
+
+> 本包只负责「Agent → 渠道」方向。在群里/私聊里与机器人对话（渠道 → Agent）请用 dsh-im 插件。
+
+## 前置条件
+
+- Node.js >= 18
+- **钉钉**：`npm i -g dingtalk-workspace-cli`，然后 `dws auth login --recommend`
+- **企业微信**：`npm i -g @wecom/cli`，然后 `wecom-cli auth init --noninteractive` 扫码授权
+
+连接器不保存任何凭据，直接用两个 CLI 自己的登录态。
+
+## 安装
+
+```bash
+npx -y im-connector          # 直接用，无需安装
+npm i -g im-connector        # 或全局安装
+```
+
+## 配置 MCP 客户端
+
+通用 MCP 客户端（如 Claude Desktop）：
+
+```json
+{
+  "mcpServers": {
+    "im": { "command": "npx", "args": ["-y", "im-connector"] }
+  }
+}
+```
+
+**DSH 用户**一条命令即可（装包 + 注册 MCP 连接）：
+
+```
+plugin_manager install_bundle  target: im-connector
+```
+
+安装后工具名为 `mcp__im__run`。
+
+## 使用
+
+Agent 调用 `mcp__im__run`，参数是 `{ provider, args }`，`args` 就是对应 CLI 的原生命令参数：
+
+```json
+// 发消息
+{ "provider": "dingtalk", "args": ["chat", "+messages-send", "--group", "<群ID>", "--markdown", "内容", "--yes"] }
+
+// 待办
+{ "provider": "dingtalk", "args": ["todo", "+create", "--title", "整理今日测试报告", "--due", "2026-10-23 18:00"] }
+{ "provider": "dingtalk", "args": ["todo", "+get-my-tasks"] }
+
+// 日志 / 日报周报
+{ "provider": "dingtalk", "args": ["report", "+create", "--template", "日报", "--content", "..."] }
+
+// 日程 / 审批 / 通讯录
+{ "provider": "dingtalk", "args": ["calendar", "+today"] }
+{ "provider": "dingtalk", "args": ["oa", "approval", "list-pending"] }
+{ "provider": "dingtalk", "args": ["contact", "+me"] }
+
+// 企业微信
+{ "provider": "wecom", "args": ["contact", "users", "search", "--keywords", "张三"] }
+```
+
+完整命令见各 CLI 的 `--help`（如 `dws chat --help`、`wecom-cli message --help`）。
+
+## 说明
+
+- **写操作**（发消息、提交审批等）请先让 Agent 确认意图；不确定时用 `--dry-run` 预览（两平台都支持）
+- 参数会原样透传给 CLI，返回其 JSON 输出
+- 支持的 provider：`dingtalk`、`wecom`
+
+## 开发
+
+```bash
+pnpm install
+pnpm verify     # typecheck + 测试 + 构建 + MCP 冒烟
+```
+
+发布（维护者）：
+
+```bash
+npm version patch
+npm publish --registry=https://registry.npmjs.org/
+```

package/dist/cli/errors.d.ts

@@ -0,0 +1,45 @@
+/** CLI 错误信封（dws 风格；其它 CLI 若无结构化信封则回退到原始 stderr）。 */
+export interface CliErrorEnvelope {
+    error?: {
+        code?: number | string;
+        category?: string;
+        message?: string;
+        reason?: string;
+        retryable?: boolean;
+        retry_after_seconds?: number;
+        hint?: string;
+        actions?: string[];
+        details?: unknown;
+        trace_id?: string;
+        server_error_code?: string;
+    };
+}
+/** 由底层 CLI 命令失败引发的统一错误。 */
+export declare class CliError extends Error {
+    readonly code?: number | string;
+    readonly category?: string;
+    readonly reason?: string;
+    readonly retryable?: boolean;
+    readonly hint?: string;
+    readonly actions?: string[];
+    readonly command: string;
+    readonly stderr: string;
+    readonly exitCode: number | null;
+    constructor(init: {
+        message: string;
+        command: string;
+        stderr?: string;
+        exitCode?: number | null;
+        code?: number | string;
+        category?: string;
+        reason?: string;
+        retryable?: boolean;
+        hint?: string;
+        actions?: string[];
+    });
+    toJSON(): Record<string, unknown>;
+}
+export declare function isCliError(e: unknown): e is CliError;
+/** 从 stderr 文本提取结构化错误信封；失败返回 undefined（调用方回退原始文本）。 */
+export declare function parseErrorEnvelope(stderr: string): CliErrorEnvelope | undefined;
+//# sourceMappingURL=errors.d.ts.map

package/dist/cli/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,2BAA2B;AAC3B,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;gBAErB,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB;IAcD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAclC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,QAAQ,CAEpD;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAgB/E"}

package/dist/cli/errors.js

@@ -0,0 +1,75 @@
+/** 由底层 CLI 命令失败引发的统一错误。 */
+export class CliError extends Error {
+    code;
+    category;
+    reason;
+    retryable;
+    hint;
+    actions;
+    command;
+    stderr;
+    exitCode;
+    constructor(init) {
+        super(init.message);
+        this.name = "CliError";
+        this.code = init.code;
+        this.category = init.category;
+        this.reason = init.reason;
+        this.retryable = init.retryable;
+        this.hint = init.hint;
+        this.actions = init.actions;
+        this.command = init.command;
+        this.stderr = init.stderr ?? "";
+        this.exitCode = init.exitCode ?? null;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            command: this.command,
+            code: this.code,
+            category: this.category,
+            reason: this.reason,
+            retryable: this.retryable,
+            hint: this.hint,
+            actions: this.actions,
+            exitCode: this.exitCode,
+        };
+    }
+}
+export function isCliError(e) {
+    return e instanceof CliError;
+}
+/** 从 stderr 文本提取结构化错误信封；失败返回 undefined（调用方回退原始文本）。 */
+export function parseErrorEnvelope(stderr) {
+    const text = stderr.trim();
+    if (!text)
+        return undefined;
+    const direct = tryParse(text);
+    if (direct?.error)
+        return direct;
+    const start = text.indexOf("{");
+    const end = text.lastIndexOf("}");
+    if (start >= 0 && end > start) {
+        const parsed = tryParse(text.slice(start, end + 1));
+        if (parsed?.error)
+            return parsed;
+    }
+    for (const line of text.split(/\r?\n/)) {
+        const parsed = tryParse(line.trim());
+        if (parsed?.error)
+            return parsed;
+    }
+    return undefined;
+}
+function tryParse(text) {
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

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

package/dist/cli/runner.d.ts

@@ -0,0 +1,33 @@
+import type { ImProviderSpec } from "../providers/types.js";
+export interface CliRunOptions {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    signal?: AbortSignal;
+    /** 覆盖 bin（测试注入 fake CLI 用）。 */
+    bin?: string;
+}
+export interface CliExecution {
+    /** 人类可读命令，如 `wecom-cli contact users search`。 */
+    command: string;
+    args: string[];
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    /** stdout 解析后的 JSON（无法解析时为原始文本）。 */
+    data: unknown;
+}
+/**
+ * 通用 CLI 透传执行器：按 provider 规格定位 CLI（npm 全局 bin 脚本 → node 直跑，
+ * 规避 Windows shim），追加 provider 的 formatArgs，收集 stdout/stderr，解析 JSON，
+ * 非零退出时映射错误信封为 CliError。
+ */
+export declare class CliRunner {
+    private readonly spec;
+    constructor(spec: ImProviderSpec);
+    get providerId(): string;
+    /** 运行并返回解析后的 stdout JSON；失败抛 CliError。 */
+    runJson(args: string[], opts?: CliRunOptions): Promise<unknown>;
+    run(args: string[], opts?: CliRunOptions): Promise<CliExecution>;
+    private launch;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/cli/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;CACf;AAQD;;;;GAIG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,cAAc;IAEjD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,0CAA0C;IACpC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAmExD,MAAM;CAwBrB"}

package/dist/cli/runner.js

@@ -0,0 +1,136 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, parseErrorEnvelope } from "./errors.js";
+/**
+ * 通用 CLI 透传执行器：按 provider 规格定位 CLI（npm 全局 bin 脚本 → node 直跑，
+ * 规避 Windows shim），追加 provider 的 formatArgs，收集 stdout/stderr，解析 JSON，
+ * 非零退出时映射错误信封为 CliError。
+ */
+export class CliRunner {
+    spec;
+    constructor(spec) {
+        this.spec = spec;
+    }
+    get providerId() {
+        return this.spec.id;
+    }
+    /** 运行并返回解析后的 stdout JSON；失败抛 CliError。 */
+    async runJson(args, opts) {
+        const exec = await this.run(args, opts);
+        return exec.data;
+    }
+    async run(args, opts) {
+        const spec = await this.launch(opts?.bin);
+        const finalArgs = [...spec.prefix, ...args, ...this.spec.formatArgs];
+        const command = `${this.spec.bin} ${args.join(" ")}`;
+        return new Promise((resolve, reject) => {
+            const child = spawn(spec.command, finalArgs, {
+                shell: spec.shell,
+                cwd: opts?.cwd,
+                env: { ...process.env, ...opts?.env },
+                stdio: ["ignore", "pipe", "pipe"],
+                windowsHide: true,
+            });
+            let stdout = "";
+            let stderr = "";
+            child.stdout.on("data", (d) => {
+                stdout += d.toString("utf8");
+            });
+            child.stderr.on("data", (d) => {
+                stderr += d.toString("utf8");
+            });
+            const onAbort = () => {
+                try {
+                    child.kill("SIGTERM");
+                }
+                catch {
+                    /* ignore */
+                }
+            };
+            if (opts?.signal) {
+                if (opts.signal.aborted)
+                    onAbort();
+                else
+                    opts.signal.addEventListener("abort", onAbort, { once: true });
+            }
+            child.on("error", (e) => {
+                reject(new CliError({
+                    message: `Failed to launch ${this.spec.bin} (${spec.command}): ${e.message}`,
+                    command,
+                    retryable: true,
+                }));
+            });
+            child.on("exit", (code) => {
+                opts?.signal?.removeEventListener("abort", onAbort);
+                const parsed = parseStdoutJson(stdout);
+                if (code !== 0) {
+                    const envelope = parseErrorEnvelope(stderr);
+                    reject(new CliError({
+                        message: envelope?.error?.message ?? stderr.trim() ?? `${this.spec.bin} exited with code ${code}`,
+                        command,
+                        stderr,
+                        exitCode: code,
+                        code: envelope?.error?.code,
+                        category: envelope?.error?.category,
+                        reason: envelope?.error?.reason,
+                        retryable: envelope?.error?.retryable,
+                        hint: envelope?.error?.hint,
+                        actions: envelope?.error?.actions,
+                    }));
+                    return;
+                }
+                resolve({ command, args: finalArgs, stdout, stderr, exitCode: code, data: parsed });
+            });
+        });
+    }
+    async launch(binOverride) {
+        const env = process.env[this.spec.envBin ?? ""]?.trim();
+        const bin = binOverride?.trim() || env || this.spec.bin;
+        // 1) 显式 node 脚本
+        if (bin !== this.spec.bin && /\.(c?js|mjs)$/i.test(bin) && existsSync(bin)) {
+            return { command: process.execPath, prefix: [bin], shell: false };
+        }
+        // 2) 显式可执行文件
+        if (bin !== this.spec.bin && existsSync(bin)) {
+            return { command: bin, prefix: [], shell: false };
+        }
+        // 3) 默认 bin：解析 npm 全局包内脚本
+        if (bin === this.spec.bin) {
+            const globalRoot = await npmGlobalRoot();
+            if (globalRoot) {
+                const script = join(globalRoot, ...this.spec.binScript.split("/"));
+                if (existsSync(script)) {
+                    return { command: process.execPath, prefix: [script], shell: false };
+                }
+            }
+        }
+        // 4) 回退：shell 执行（Windows shim）
+        return { command: bin, prefix: [], shell: process.platform === "win32" };
+    }
+}
+function parseStdoutJson(stdout) {
+    const text = stdout.trim();
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+async function npmGlobalRoot() {
+    try {
+        const { execFile } = await import("node:child_process");
+        const { promisify } = await import("node:util");
+        const run = promisify(execFile);
+        const { stdout } = await run("npm", ["root", "-g"], { timeout: 10_000, windowsHide: true });
+        const root = String(stdout).trim();
+        return root || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/cli/runner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { CliError, isCliError, parseErrorEnvelope, type CliErrorEnvelope } from "./cli/errors.js";
+export { CliRunner, type CliExecution, type CliRunOptions } from "./cli/runner.js";
+export type { ImProviderSpec } from "./providers/types.js";
+export { dingtalk } from "./providers/dingtalk.js";
+export { wecom } from "./providers/wecom.js";
+export { getProvider, listProviders } from "./providers/registry.js";
+export { buildMcpServer, type McpServerOptions } from "./mcp/server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { CliError, isCliError, parseErrorEnvelope } from "./cli/errors.js";
+export { CliRunner } from "./cli/runner.js";
+export { dingtalk } from "./providers/dingtalk.js";
+export { wecom } from "./providers/wecom.js";
+export { getProvider, listProviders } from "./providers/registry.js";
+export { buildMcpServer } from "./mcp/server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAyB,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,SAAS,EAAyC,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAyB,MAAM,iBAAiB,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/**
+ * 构建统一 IM 透传 MCP server：暴露一个 `run { provider, args }` 工具，
+ * 按 provider 注册表路由到底层 CLI。新增平台只需在 registry 追加 spec。
+ */
+export interface McpServerOptions {
+    name?: string;
+    version?: string;
+    /** 测试/覆盖用：provider id → CLI 入口路径。 */
+    binOverrides?: Record<string, string>;
+}
+export declare function buildMcpServer(options?: McpServerOptions): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA6CnE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,MAAM,CA+DrE"}

package/dist/mcp/server.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "node:url";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { getProvider, listProviders } from "../providers/registry.js";
+import { CliRunner } from "../cli/runner.js";
+import { isCliError } from "../cli/errors.js";
+function buildRunTool() {
+    const providers = listProviders();
+    const lines = providers
+        .map((p) => {
+        const ex = p.examples.map((e) => `    ${e}`).join("\n");
+        return `- ${p.id}（${p.displayName}，\`${p.bin}\`）:\n${ex}`;
+    })
+        .join("\n");
+    return {
+        name: "run",
+        description: `统一 IM 透传：执行指定平台的 CLI 命令并返回其 JSON 输出。已接入平台：\n${lines}\n\n` +
+            `provider 选平台，args 是该平台 CLI 的命令字符串数组。写操作（发消息/提交/审批等）需用户明确意图，必要时加 --yes（钉钉）或先用 --dry-run 预览。`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                provider: {
+                    type: "string",
+                    enum: providers.map((p) => p.id),
+                    description: `IM 平台标识：${providers.map((p) => `${p.id}=${p.displayName}`).join("，")}`,
+                },
+                args: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "对应平台 CLI 的命令及参数（字符串数组）。",
+                },
+            },
+            required: ["provider", "args"],
+        },
+    };
+}
+export function buildMcpServer(options = {}) {
+    const server = new Server({ name: options.name ?? "im", version: options.version ?? "0.1.0" }, { capabilities: { tools: {} } });
+    const runTool = buildRunTool();
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [runTool],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        if (request.params.name !== "run") {
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${request.params.name}. Only "run" is available.` }],
+                isError: true,
+            };
+        }
+        const { provider, args } = request.params.arguments ?? {};
+        const spec = getProvider(provider);
+        if (!spec) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `未知平台 "${provider}"。可用：${listProviders().map((p) => p.id).join("，")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!Array.isArray(args) || args.length === 0 || !args.every((a) => typeof a === "string")) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: '参数 args 必须是非空字符串数组，例如 {"provider":"dingtalk","args":["contact","+me"]}',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const runner = new CliRunner(spec);
+            const result = await runner.runJson(args, {
+                bin: options.binOverrides?.[spec.id],
+            });
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (e) {
+            const message = isCliError(e)
+                ? JSON.stringify(e.toJSON())
+                : e instanceof Error
+                    ? e.message
+                    : String(e);
+            return {
+                content: [{ type: "text", text: `${spec.displayName} run failed: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+async function main() {
+    const server = buildMcpServer();
+    await server.connect(new StdioServerTransport());
+}
+const invokedDirectly = process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (invokedDirectly) {
+    main().catch((e) => {
+        console.error(e);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/providers/dingtalk.d.ts

@@ -0,0 +1,4 @@
+import type { ImProviderSpec } from "./types.js";
+/** 钉钉：通过 dws（dingtalk-workspace-cli）透传。 */
+export declare const dingtalk: ImProviderSpec;
+//# sourceMappingURL=dingtalk.d.ts.map

package/dist/providers/dingtalk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dingtalk.d.ts","sourceRoot":"","sources":["../../src/providers/dingtalk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,2CAA2C;AAC3C,eAAO,MAAM,QAAQ,EAAE,cAoBtB,CAAC"}

package/dist/providers/dingtalk.js

@@ -0,0 +1,23 @@
+/** 钉钉：通过 dws（dingtalk-workspace-cli）透传。 */
+export const dingtalk = {
+    id: "dingtalk",
+    displayName: "钉钉",
+    bin: "dws",
+    npmPackage: "dingtalk-workspace-cli",
+    binScript: "dingtalk-workspace-cli/bin/dws.js",
+    formatArgs: ["--format", "json"],
+    envBin: "DINGTALK_DWS_BIN",
+    examples: [
+        '["contact","+me"]',
+        '["contact","+search-user","--query","张三"]',
+        '["calendar","+today"]',
+        '["todo","+get-my-tasks"]',
+        '["oa","approval","list-pending"] / ["oa","approval","detail","--instance-id","<id>"]',
+        '["attendance","+check-result","--users","u1,u2","--start","2026-10-01","--end","2026-10-10"]',
+        '["report","inbox","list"] / ["report","entry","get","--report-id","<id>"]',
+        '["doc","read","--node","<docId|url>"] / ["wiki","+space-list"]',
+        '["chat","+chat-messages","--group","<群名|id>","--limit","20"] / ["chat","+search-msg","--query","<kw>"]',
+        '写：["chat","+messages-send","--group","<cid>","--markdown","内容","--title","标题","--yes"]',
+    ],
+};
+//# sourceMappingURL=dingtalk.js.map

package/dist/providers/dingtalk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dingtalk.js","sourceRoot":"","sources":["../../src/providers/dingtalk.ts"],"names":[],"mappings":"AAEA,2CAA2C;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACtC,EAAE,EAAE,UAAU;IACd,WAAW,EAAE,IAAI;IACjB,GAAG,EAAE,KAAK;IACV,UAAU,EAAE,wBAAwB;IACpC,SAAS,EAAE,mCAAmC;IAC9C,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;IAChC,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE;QACR,mBAAmB;QACnB,2CAA2C;QAC3C,uBAAuB;QACvB,0BAA0B;QAC1B,sFAAsF;QACtF,8FAA8F;QAC9F,2EAA2E;QAC3E,gEAAgE;QAChE,wGAAwG;QACxG,wFAAwF;KACzF;CACF,CAAC"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,4 @@
+import type { ImProviderSpec } from "./types.js";
+export declare function listProviders(): ImProviderSpec[];
+export declare function getProvider(id: string): ImProviderSpec | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjD,wBAAgB,aAAa,IAAI,cAAc,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAElE"}

package/dist/providers/registry.js

@@ -0,0 +1,11 @@
+import { dingtalk } from "./dingtalk.js";
+import { wecom } from "./wecom.js";
+/** 已注册的 IM 平台。新增飞书 / Discord 时在此追加。 */
+const providers = [dingtalk, wecom];
+export function listProviders() {
+    return providers;
+}
+export function getProvider(id) {
+    return providers.find((p) => p.id === id);
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,uCAAuC;AACvC,MAAM,SAAS,GAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAEtD,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 一个 IM 平台（provider）接入规格：如何找到它的 CLI、如何请求 JSON 输出。
+ * 未来接入飞书 / Discord 等，只需新增一个 spec 并注册进 registry。
+ */
+export interface ImProviderSpec {
+    /** 稳定 id，用于 MCP 工具的 provider 参数，如 "dingtalk" / "wecom"。 */
+    id: string;
+    /** 人类可读名称。 */
+    displayName: string;
+    /** 默认命令名（PATH 上的 shim），如 "dws" / "wecom-cli"。 */
+    bin: string;
+    /** npm 全局包名，用于解析 bin 脚本（规避 Windows .cmd/.ps1 shim）。 */
+    npmPackage: string;
+    /** 包内 bin 脚本相对路径（含作用域，用 / 分隔），如 "@wecom/cli/bin/wecom.js"。 */
+    binScript: string;
+    /** 追加在业务参数之后、用于请求 JSON 输出的 flag；JSON 为默认输出的 CLI 用空数组。 */
+    formatArgs: string[];
+    /** 覆盖 bin 的环境变量名（可选），如 "DINGTALK_DWS_BIN"。 */
+    envBin?: string;
+    /** 展示在 MCP 工具描述里的示例命令（数组形式，便于模型理解）。 */
+    examples: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

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

package/dist/providers/wecom.d.ts

@@ -0,0 +1,4 @@
+import type { ImProviderSpec } from "./types.js";
+/** 企业微信：通过 wecom-cli（@wecom/cli）透传。JSON 为默认输出，无需 --format。 */
+export declare const wecom: ImProviderSpec;
+//# sourceMappingURL=wecom.d.ts.map

package/dist/providers/wecom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wecom.d.ts","sourceRoot":"","sources":["../../src/providers/wecom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,8DAA8D;AAC9D,eAAO,MAAM,KAAK,EAAE,cAcnB,CAAC"}

package/dist/providers/wecom.js

@@ -0,0 +1,17 @@
+/** 企业微信：通过 wecom-cli（@wecom/cli）透传。JSON 为默认输出，无需 --format。 */
+export const wecom = {
+    id: "wecom",
+    displayName: "企业微信",
+    bin: "wecom-cli",
+    npmPackage: "@wecom/cli",
+    binScript: "@wecom/cli/bin/wecom.js",
+    formatArgs: [],
+    envBin: "WECOM_CLI_BIN",
+    examples: [
+        '["contact","users","search","--keywords","张三"]',
+        '["chat","messages","list","--chat-id","<id>","--begin-time","2026-10-01 00:00:00","--end-time","2026-10-21 00:00:00"]',
+        '["auth","show","--status"]',
+        '通用形态：["<service>","<resource>","<operation>",...flags]；--schema 查看方法 schema，--dry-run 预览不发送。',
+    ],
+};
+//# sourceMappingURL=wecom.js.map

package/dist/providers/wecom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wecom.js","sourceRoot":"","sources":["../../src/providers/wecom.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,KAAK,GAAmB;IACnC,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,MAAM;IACnB,GAAG,EAAE,WAAW;IAChB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,yBAAyB;IACpC,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,eAAe;IACvB,QAAQ,EAAE;QACR,gDAAgD;QAChD,uHAAuH;QACvH,4BAA4B;QAC5B,8FAA8F;KAC/F;CACF,CAAC"}

package/mcp-bundle/README.md

@@ -0,0 +1,49 @@
+# mcp-bundle：DSH MCP 连接 bundle
+
+按 DSH 官方推荐方式（`references/mcp-bundle.md`「Connect an MCP server」）做的**配置型 bundle**：只插入一条 `@deepseek-ai/dsh-mcp-client` 行，把 `im-connector` 注册成一个 MCP 连接，模型侧工具名为 `mcp__im__run`。
+
+## 推荐安装（一步到位）
+
+npm 包 `im-connector` 本身声明了 `dsh.bundle.patch`（指向本目录的 patch），所以装上包即完成注册：
+
+```
+plugin_manager install_bundle  target: im-connector
+```
+
+安装后 DSH 会：装包 → 应用 patch → 新增 MCP 连接（`serverName: im`），工具为 `mcp__im__run`。
+
+## 手工安装（已有包或本地调试）
+
+把本目录复制到任意位置，直接 `plugin_manager install_bundle`（target 指向该目录）。patch 用的是官方 stdio 形式：
+
+```yaml
+- insert:
+    - id: im-connector-mcp
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: im
+        transport: stdio
+        command: npx
+        args: ['-y', 'im-connector']
+        failOnStartupError: true
+```
+
+要点：
+- `command: npx` 跨平台可用（MCP SDK 的 stdio 传输基于 cross-spawn，Windows 能解析 `npx.cmd`）。
+- **不需要配 env**：`im-connector` 会通过 `npm root -g` 自动解析 `dws` / `wecom-cli` 的 bin 脚本。需要覆盖时再加 env，且**不要把凭据写进 patch**（可用 Loader 的 `!!js process.env.X` 引用环境变量）。
+- `failOnStartupError: true`：连接失败时让该行激活失败，便于发现问题（官方模板同款）。
+- 对照官方 `templates/mcp/`：manifest 只需 name/version/`dsh.bundle.patch`（配置型 bundle 无 Host/Client 入口文件），display 元数据走 `locale/*.json` + `icon.svg`。
+
+> ⚠️ 个别 Windows 环境下 `npx` 转发 stdio 到本包 server 不稳定（`npx --version` 与其它包正常，但管道下 MCP 握手被关闭）。遇到这种情况改用 node + 绝对路径：
+
+```yaml
+      config:
+        serverName: im
+        transport: stdio
+        command: node
+        args: ['<npm root -g>/im-connector/dist/mcp/server.js']
+```
+
+## 验证
+
+安装后在会话里调用 `mcp__im__run`（例如 `{ provider: "dingtalk", args: ["contact", "+me"] }`）确认连接可用。

package/mcp-bundle/cordis.patch.yml

@@ -0,0 +1,9 @@
+- insert:
+    - id: im-connector-mcp
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: im
+        transport: stdio
+        command: npx
+        args: ['-y', 'im-connector']
+        failOnStartupError: true

package/mcp-bundle/icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect x="4" y="20" width="14" height="24" rx="5" fill="#0089ff"/>
+  <rect x="22" y="12" width="14" height="24" rx="5" fill="#0089ff"/>
+  <rect x="40" y="20" width="14" height="24" rx="5" fill="#0089ff"/>
+  <path d="M20 32h16" stroke="#0089ff" stroke-width="3" stroke-linecap="round"/>
+  <circle cx="32" cy="44" r="3" fill="#4aa3ff"/>
+</svg>

package/mcp-bundle/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "IM Connector",
+    "description": "Unified IM passthrough for DingTalk (dws) and WeCom (wecom-cli); extensible to Feishu, Discord and more."
+  }
+}

package/mcp-bundle/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "IM 连接器",
+    "description": "统一 IM 透传：钉钉（dws）与企业微信（wecom-cli），可扩展飞书、Discord 等平台。"
+  }
+}

package/mcp-bundle/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@local/im-connector-mcp",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "exports": { "./locale/*.json": "./locale/*.json", "./icon": "./icon.svg" },
+  "files": ["cordis.patch.yml", "locale/*.json", "icon.svg"],
+  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
+}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "im-connector",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "MCP server that lets agents drive DingTalk (dws) and WeCom (wecom-cli) CLIs: send messages, write reports, create todos, query calendars and approvals. Extensible provider registry for more IM platforms.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./locale/*.json": "./mcp-bundle/locale/*.json",
+    "./icon": "./mcp-bundle/icon.svg"
+  },
+  "bin": {
+    "im-connector": "dist/mcp/server.js"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./mcp-bundle/cordis.patch.yml"
+    }
+  },
+  "files": [
+    "dist",
+    "mcp-bundle",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "mcp": "node dist/mcp/server.js",
+    "smoke:mcp": "node scripts/mcp-smoke.mjs",
+    "verify": "pnpm typecheck && pnpm test && pnpm build && pnpm smoke:mcp",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build && npm run smoke:mcp"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "modelcontextprotocol",
+    "im",
+    "dingtalk",
+    "dws",
+    "wecom",
+    "wecom-cli",
+    "connector",
+    "agent",
+    "feishu",
+    "discord"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}