@zhin.js/adapter-dingtalk 1.0.81 → 1.1.2

package/agents/dingtalk/skills/dingtalk/tools/dept_info/index.ts

@@ -0,0 +1,15 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ dept_id: string }>({
+  description: '获取钉钉部门详细信息',
+  inputSchema: z.object({
+    dept_id: z.string().describe('部门 ID'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ dept_id    }: { dept_id: string }, context) {
+    const endpoint = context.$client;
+    return await endpoint.getDepartmentInfo(Number(dept_id));
+  },
+});
+

package/agents/dingtalk/skills/dingtalk/tools/get_dept_users/index.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取钉钉部门用户列表',
+    inputSchema: z.object({
+        dept_id: z.string().describe('部门 ID'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    async execute({ dept_id }, context) {
+        const endpoint = context.$client;
+        const users = await endpoint.getDepartmentUsers(Number(dept_id));
+        return { users, count: users.length };
+    },
+});

package/agents/dingtalk/skills/dingtalk/tools/get_dept_users/index.ts

@@ -0,0 +1,16 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ dept_id: string }>({
+  description: '获取钉钉部门用户列表',
+  inputSchema: z.object({
+    dept_id: z.string().describe('部门 ID'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ dept_id    }: { dept_id: string }, context) {
+    const endpoint = context.$client;
+    const users = await endpoint.getDepartmentUsers(Number(dept_id));
+    return { users, count: users.length };
+  },
+});
+

package/agents/dingtalk/skills/dingtalk/tools/get_user/index.js

@@ -0,0 +1,15 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取钉钉用户信息',
+    inputSchema: z.object({
+        user_id: z.string().describe('用户 ID'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    async execute({ user_id }, context) {
+        const endpoint = context.$client;
+        return await endpoint.getUserInfo(user_id);
+    },
+});

package/agents/dingtalk/skills/dingtalk/tools/get_user/index.ts

@@ -0,0 +1,15 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ user_id: string }>({
+  description: '获取钉钉用户信息',
+  inputSchema: z.object({
+    user_id: z.string().describe('用户 ID'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ user_id    }: { user_id: string }, context) {
+    const endpoint = context.$client;
+    return await endpoint.getUserInfo(user_id);
+  },
+});
+

package/agents/dingtalk/skills/dingtalk/tools/list_departments/index.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取钉钉部门列表',
+    inputSchema: z.object({
+        dept_id: z.string().optional().describe('父部门 ID，默认 1（根部门）'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    async execute({ dept_id }, context) {
+        const endpoint = context.$client;
+        const departments = await endpoint.getDepartmentList(Number(dept_id || '1'));
+        return { departments, count: departments.length };
+    },
+});

package/agents/dingtalk/skills/dingtalk/tools/list_departments/index.ts

@@ -0,0 +1,16 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ dept_id?: string }>({
+  description: '获取钉钉部门列表',
+  inputSchema: z.object({
+    dept_id: z.string().optional().describe('父部门 ID，默认 1（根部门）'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ dept_id    }: { dept_id?: string }, context) {
+    const endpoint = context.$client;
+    const departments = await endpoint.getDepartmentList(Number(dept_id || '1'));
+    return { departments, count: departments.length };
+  },
+});
+

package/agents/dingtalk/skills/dingtalk/tools/send_work_notice/index.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '向指定用户发送钉钉工作通知',
+    inputSchema: z.object({
+        user_ids: z.string().describe('用户 ID 列表，逗号分隔'),
+        content: z.string().describe('通知内容'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    async execute({ user_ids, content }, context) {
+        const endpoint = context.$client;
+        const msgContent = { msgtype: 'text', text: { content } };
+        const success = await endpoint.sendWorkNotice(user_ids.split(','), msgContent);
+        return { success, message: success ? '工作通知已发送' : '发送失败' };
+    },
+});

package/agents/dingtalk/skills/dingtalk/tools/send_work_notice/index.ts

@@ -0,0 +1,18 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ user_ids: string; content: string }>({
+  description: '向指定用户发送钉钉工作通知',
+  inputSchema: z.object({
+    user_ids: z.string().describe('用户 ID 列表，逗号分隔'),
+    content: z.string().describe('通知内容'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ user_ids, content    }: { user_ids: string; content: string }, context) {
+    const endpoint = context.$client;
+    const msgContent = { msgtype: 'text', text: { content } };
+    const success = await endpoint.sendWorkNotice(user_ids.split(','), msgContent);
+    return { success, message: success ? '工作通知已发送' : '发送失败' };
+  },
+});
+

package/agents/dingtalk/skills/dingtalk/tools/update_chat/index.js

@@ -0,0 +1,29 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '更新钉钉群聊设置（改名、换群主、增减成员）',
+    inputSchema: z.object({
+        chat_id: z.string().describe('群聊 ID'),
+        name: z.string().optional().describe('新群名（可选）'),
+        owner: z.string().optional().describe('新群主 userId（可选）'),
+        add_members: z.string().optional().describe('要添加的成员 userId，逗号分隔（可选）'),
+        remove_members: z.string().optional().describe('要移除的成员 userId，逗号分隔（可选）'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    async execute({ chat_id, name, owner, add_members, remove_members }, context) {
+        const endpoint = context.$client;
+        const options = {};
+        if (name)
+            options.name = name;
+        if (owner)
+            options.owner = owner;
+        if (add_members)
+            options.add_useridlist = add_members.split(',').map((s) => s.trim());
+        if (remove_members)
+            options.del_useridlist = remove_members.split(',').map((s) => s.trim());
+        await endpoint.updateChat(chat_id, options);
+        return { success: true, message: '群聊设置已更新' };
+    },
+});

package/agents/dingtalk/skills/dingtalk/tools/update_chat/index.ts

@@ -0,0 +1,25 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }>({
+  description: '更新钉钉群聊设置（改名、换群主、增减成员）',
+  inputSchema: z.object({
+    chat_id: z.string().describe('群聊 ID'),
+    name: z.string().optional().describe('新群名（可选）'),
+    owner: z.string().optional().describe('新群主 userId（可选）'),
+    add_members: z.string().optional().describe('要添加的成员 userId，逗号分隔（可选）'),
+    remove_members: z.string().optional().describe('要移除的成员 userId，逗号分隔（可选）'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ chat_id, name, owner, add_members, remove_members    }: { chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }, context) {
+    const endpoint = context.$client;
+    const options: Record<string, unknown> = {};
+    if (name) options.name = name;
+    if (owner) options.owner = owner;
+    if (add_members) options.add_useridlist = add_members.split(',').map((s: string) => s.trim());
+    if (remove_members) options.del_useridlist = remove_members.split(',').map((s: string) => s.trim());
+    await endpoint.updateChat(chat_id, options);
+    return { success: true, message: '群聊设置已更新' };
+  },
+});
+

package/agents/dingtalk/system.md

@@ -0,0 +1,3 @@
+# DINGTALK Platform Agent
+
+You are the dingtalk platform specialist. Interpret requests in the current dingtalk conversation and load only the narrowest private Skill needed for the task.

package/commands/dingtalk/endpoint/add/[id]/index.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { dingtalkEndpointCommands } from '../../definition.js';
+export default dingtalkEndpointCommands.add;

package/commands/dingtalk/endpoint/add/[id]/index.ts

@@ -0,0 +1,3 @@
+import { dingtalkEndpointCommands } from '../../definition.js';
+
+export default dingtalkEndpointCommands.add;

package/commands/dingtalk/endpoint/definition.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+/**
+ * `dingtalk endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/dingtalk/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ */
+import { createEndpointCommands } from 'zhin.js/adapter';
+import { defineCommand } from 'zhin.js/command';
+import { dingtalkRuntimeStateToken } from "../../../lib/dingtalk-runtime-state.js";
+export const dingtalkEndpointCommands = createEndpointCommands({
+    adapterKey: 'dingtalk',
+    adapterDisplayName: 'DingTalk',
+    fields: [
+        { key: 'appKey', required: true, env: true, description: '钉钉 AppKey' },
+        { key: 'appSecret', required: true, env: true, description: '钉钉 AppSecret' },
+        { key: 'robotCode', required: true, env: true, description: '机器人 Code（出站 senderStaffId）' },
+    ],
+    running: (use) => use(dingtalkRuntimeStateToken).endpoints.values(),
+    describeEntry: (entry) => `appKey: ${String(entry.appKey)}`,
+}, defineCommand);

package/commands/dingtalk/endpoint/definition.ts

@@ -0,0 +1,19 @@
+/**
+ * `dingtalk endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/dingtalk/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ */
+import { createEndpointCommands } from 'zhin.js/adapter';
+import { defineCommand } from 'zhin.js/command';
+import { dingtalkRuntimeStateToken } from '../../../src/dingtalk-runtime-state.js';
+
+export const dingtalkEndpointCommands = createEndpointCommands({
+  adapterKey: 'dingtalk',
+  adapterDisplayName: 'DingTalk',
+  fields: [
+    { key: 'appKey', required: true, env: true, description: '钉钉 AppKey' },
+    { key: 'appSecret', required: true, env: true, description: '钉钉 AppSecret' },
+    { key: 'robotCode', required: true, env: true, description: '机器人 Code（出站 senderStaffId）' },
+  ],
+  running: (use) => use(dingtalkRuntimeStateToken).endpoints.values(),
+  describeEntry: (entry) => `appKey: ${String(entry.appKey)}`,
+}, defineCommand);

package/commands/dingtalk/endpoint/list/index.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { dingtalkEndpointCommands } from '../definition.js';
+export default dingtalkEndpointCommands.list;

package/commands/dingtalk/endpoint/list/index.ts

@@ -0,0 +1,3 @@
+import { dingtalkEndpointCommands } from '../definition.js';
+
+export default dingtalkEndpointCommands.list;

package/commands/dingtalk/endpoint/remove/[id]/index.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { dingtalkEndpointCommands } from '../../definition.js';
+export default dingtalkEndpointCommands.remove;

package/commands/dingtalk/endpoint/remove/[id]/index.ts

@@ -0,0 +1,3 @@
+import { dingtalkEndpointCommands } from '../../definition.js';
+
+export default dingtalkEndpointCommands.remove;

package/lib/client.d.ts

@@ -0,0 +1,12 @@
+import type { DingTalkClient } from './endpoint.js';
+import type { DingTalkEvent } from './protocol.js';
+export type DingtalkClientEventMap = Record<string, DingTalkEvent>;
+declare module '@zhin.js/feature-kit' {
+    interface AdapterClientRegistry {
+        readonly dingtalk: {
+            readonly client: DingTalkClient;
+            readonly events: DingtalkClientEventMap;
+        };
+    }
+}
+export declare const dingtalkClient: import("@zhin.js/adapter").EndpointClientToken<DingTalkClient, DingtalkClientEventMap>;

package/lib/client.js

@@ -0,0 +1,2 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+export const dingtalkClient = defineEndpointClient('dingtalk');

package/lib/dingtalk-runtime-state.d.ts

@@ -0,0 +1 @@
+export declare const dingtalkRuntimeStateToken: import("zhin.js").Token<import("@zhin.js/adapter").EndpointRuntimeState>;

package/lib/dingtalk-runtime-state.js

@@ -0,0 +1,6 @@
+/**
+ * DingTalk 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
+ * 由 plugin.ts setup() provide，adapter create 与 `dingtalk endpoint` 命令共享（同一 owner generation）。
+ */
+import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
+export const dingtalkRuntimeStateToken = defineEndpointRuntimeStateToken('dingtalk');

package/lib/endpoint.d.ts

@@ -0,0 +1,72 @@
+import { Endpoint } from 'zhin.js/adapter';
+/**
+ * DingTalkEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
+ */
+import { type EndpointSendRequest } from 'zhin.js/adapter';
+import type { HttpHost } from '@zhin.js/host-http';
+import type { CapabilityId } from 'zhin.js';
+import { type DingTalkEvent, type DingTalkMessage, type ResolvedDingTalkConfig } from './protocol.js';
+export type DingTalkFetch = (url: string, init?: {
+    readonly method?: string;
+    readonly headers?: Record<string, string>;
+    readonly body?: string;
+}) => Promise<{
+    readonly ok: boolean;
+    readonly status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+export interface DingTalkEndpointOptions {
+    readonly id: CapabilityId;
+    readonly http: HttpHost;
+    readonly config: ResolvedDingTalkConfig;
+    readonly fetch?: DingTalkFetch;
+}
+export interface DingTalkClientApi {
+    getUserInfo(userId: string): Promise<unknown>;
+    getDepartmentUsers(deptId: number): Promise<unknown[]>;
+    sendWorkNotice(userIdList: string[], content: unknown): Promise<boolean>;
+    getDepartmentList(deptId?: number): Promise<unknown[]>;
+    getDepartmentInfo(deptId: number): Promise<unknown>;
+    createChat(name: string, ownerUserId: string, userIdList: string[]): Promise<string | null>;
+    getChatInfo(chatId: string): Promise<unknown>;
+    updateChat(chatId: string, options: {
+        name?: string;
+        owner?: string;
+        add_useridlist?: string[];
+        del_useridlist?: string[];
+    }): Promise<boolean>;
+}
+/** SDK-like DingTalk OpenAPI surface available on every Endpoint event. */
+export declare class DingTalkClient implements DingTalkClientApi {
+    readonly api: DingTalkClientApi;
+    constructor(api: DingTalkClientApi);
+    getUserInfo: (userId: string) => Promise<unknown>;
+    getDepartmentUsers: (deptId: number) => Promise<unknown[]>;
+    sendWorkNotice: (userIds: string[], content: unknown) => Promise<boolean>;
+    getDepartmentList: (deptId?: number) => Promise<unknown[]>;
+    getDepartmentInfo: (deptId: number) => Promise<unknown>;
+    createChat: (name: string, owner: string, users: string[]) => Promise<string | null>;
+    getChatInfo: (chatId: string) => Promise<unknown>;
+    updateChat: (chatId: string, options: Parameters<DingTalkClientApi["updateChat"]>[1]) => Promise<boolean>;
+}
+/**
+ * 钉钉机器人（webhook/stream 模式）无常规群列表 API——机器人不持有
+ * 「我所在的群」枚举面，仅能收发消息；
+ * 因此本 endpoint 不暴露 EndpointManagement（Console 社交面 RPC 对该平台保持未接线）。
+ */
+export declare class DingTalkEndpoint extends Endpoint<DingTalkClient> {
+    #private;
+    readonly client: DingTalkClient;
+    constructor(options: DingTalkEndpointOptions);
+    /** Used by webhook handler. */
+    get isOpen(): boolean;
+    get config(): ResolvedDingTalkConfig;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    /** Test / internal: admit a parsed event when open (non-webhook path). */
+    admit(event: DingTalkEvent | DingTalkMessage): void;
+}