@zhin.js/adapter-dingtalk 4.0.1 → 4.0.3

package/agent/tools/update_chat.ts

@@ -0,0 +1,27 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getDingtalkAgentDeps } from '../../src/dingtalk-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }>({
+  description: '更新钉钉群聊设置（改名、换群主、增减成员）',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    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，逗号分隔（可选）'),
+  }),
+  platforms: ['dingtalk'],
+  tags: ['dingtalk'],
+  async execute({ endpoint_id, chat_id, name, owner, add_members, remove_members    }: { endpoint_id: string; chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }) {
+    const endpoint = getDingtalkAgentDeps().getEndpoint(endpoint_id);
+    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/lib/dingtalk-agent-deps.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Agent tool deps for dingtalk (user / dept / chat / work notice).
+ * Endpoints register themselves on start; tools look up by endpoint id.
+ */
+export interface DingtalkAgentEndpoint {
+    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>;
+}
+export interface DingtalkAgentDeps {
+    getEndpoint: (endpointId: string) => DingtalkAgentEndpoint;
+}
+export declare function registerDingtalkAgentEndpoint(endpointId: string, endpoint: DingtalkAgentEndpoint): () => void;
+/** Optional override used by tests / transitional callers. Pass `null` to clear. */
+export declare function setDingtalkAgentDeps(deps: DingtalkAgentDeps | null): void;
+export declare function getDingtalkAgentDeps(): DingtalkAgentDeps;

package/lib/dingtalk-agent-deps.js

@@ -0,0 +1,30 @@
+/**
+ * Agent tool deps for dingtalk (user / dept / chat / work notice).
+ * Endpoints register themselves on start; tools look up by endpoint id.
+ */
+const endpoints = new Map();
+let override = null;
+export function registerDingtalkAgentEndpoint(endpointId, endpoint) {
+    endpoints.set(endpointId, endpoint);
+    return () => {
+        if (endpoints.get(endpointId) === endpoint) {
+            endpoints.delete(endpointId);
+        }
+    };
+}
+/** Optional override used by tests / transitional callers. Pass `null` to clear. */
+export function setDingtalkAgentDeps(deps) {
+    override = deps;
+}
+export function getDingtalkAgentDeps() {
+    if (override)
+        return override;
+    return {
+        getEndpoint(endpointId) {
+            const endpoint = endpoints.get(endpointId);
+            if (!endpoint)
+                throw new Error(`Endpoint ${endpointId} 不存在`);
+            return endpoint;
+        },
+    };
+}

package/lib/endpoint.d.ts

@@ -1,41 +1,51 @@
 /**
- * 钉钉 Endpoint 实现
+ * DingTalkEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
-import { Endpoint, Message, SendOptions } from 'zhin.js';
-import type { DingTalkEndpointConfig, DingTalkMessage } from "./types.js";
-import type { DingTalkAdapter } from "./adapter.js";
-export declare class DingTalkEndpoint implements Endpoint<DingTalkEndpointConfig, DingTalkMessage> {
-    adapter: DingTalkAdapter;
-    $config: DingTalkEndpointConfig;
-    $connected: boolean;
-    private router;
-    private accessToken;
-    private baseURL;
-    private sessionWebhooks;
-    get $id(): string;
-    get logger(): import("zhin.js").Logger;
-    constructor(adapter: DingTalkAdapter, router: any, $config: DingTalkEndpointConfig);
-    private request;
-    private setupWebhookRoute;
-    private handleWebhook;
-    private verifySignature;
-    private handleEvent;
-    private ensureAccessToken;
-    private refreshAccessToken;
-    $formatMessage(msg: DingTalkMessage): Message<DingTalkMessage>;
-    private parseMessageContent;
-    $sendMessage(options: SendOptions): Promise<string>;
-    $recallMessage(id: string): Promise<void>;
-    private formatSendContent;
-    $connect(): Promise<void>;
-    $disconnect(): Promise<void>;
-    getUserInfo(userId: string): Promise<any>;
-    getDepartmentUsers(deptId: number): Promise<any[]>;
-    sendWorkNotice(userIdList: string[], content: any): Promise<boolean>;
-    getDepartmentList(deptId?: number): Promise<any[]>;
-    getDepartmentInfo(deptId: number): Promise<any>;
+import type { EndpointInstance } from '@zhin.js/adapter';
+import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { HttpHost } from '@zhin.js/host-http';
+import type { CapabilityId } from '@zhin.js/plugin-runtime';
+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 gateway: MessageGateway;
+    readonly http: HttpHost;
+    readonly config: ResolvedDingTalkConfig;
+    readonly fetch?: DingTalkFetch;
+}
+export declare class DingTalkEndpoint implements EndpointInstance {
+    #private;
+    constructor(options: DingTalkEndpointOptions);
+    /** Used by webhook handler. */
+    get isOpen(): boolean;
+    get config(): ResolvedDingTalkConfig;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ target, payload }: {
+        readonly target: string;
+        readonly payload: unknown;
+    }): Promise<string>;
+    /** Test / internal: admit a parsed event when open (non-webhook path). */
+    admit(event: DingTalkEvent | DingTalkMessage): void;
+    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<any>;
+    getChatInfo(chatId: string): Promise<unknown>;
     updateChat(chatId: string, options: {
         name?: string;
         owner?: string;
@@ -43,4 +53,3 @@ export declare class DingTalkEndpoint implements Endpoint<DingTalkEndpointConfig
         del_useridlist?: string[];
     }): Promise<boolean>;
 }
-//# sourceMappingURL=endpoint.d.ts.map