@wps365/openclaw-wpsxiezuo 1.6.0

package/dist/messaging/inbound/pairing-allow-store.d.ts

@@ -0,0 +1,11 @@
+type LogLike = {
+    debug?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+};
+export declare function loadPairingAllowFrom(opts: {
+    channelId: string;
+    accountId: string;
+    log?: LogLike;
+}): Promise<string[]>;
+export {};
+//# sourceMappingURL=pairing-allow-store.d.ts.map

package/dist/messaging/index.d.ts

@@ -0,0 +1,3 @@
+export { handleInbound, normalizeInboundMessage, parseCardContent } from "./inbound/index.js";
+export type { HandleInboundParams } from "./inbound/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/messaging/outbound.d.ts

@@ -0,0 +1,15 @@
+/**
+ * WPS 消息发送 - 最小实现
+ *
+ * 用于测试消息处理流程，发送即时确认消息
+ */
+import type { WpsConfig } from "../core/config.js";
+type SendMessageParams = {
+    config: WpsConfig;
+    chatId: string;
+    text: string;
+    log?: (...args: unknown[]) => void;
+};
+export declare function sendTextMessage(params: SendMessageParams): Promise<void>;
+export {};
+//# sourceMappingURL=outbound.d.ts.map

package/dist/session/idempotency.d.ts

@@ -0,0 +1,8 @@
+import type { IdempotencyStore } from "./types.js";
+export declare class MemoryIdempotencyStore implements IdempotencyStore {
+    private store;
+    check(key: string): Promise<boolean>;
+    mark(key: string, ttl: number): Promise<void>;
+    cleanup(): void;
+}
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/session/index.d.ts

@@ -0,0 +1,5 @@
+export { WpsSessionResolver } from "./resolver.js";
+export { MemoryIdempotencyStore } from "./idempotency.js";
+export { SessionResolverError } from "./types.js";
+export type { StandardizedEvent, SessionInfo, SessionResolverConfig, IdempotencyStore } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/session/resolver.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WPS 会话解析器。
+ *
+ * 将原始入站事件标准化为 StandardizedEvent，再解析出 SessionInfo。
+ * 从 v1 packages/channel-plugin/src/session/resolver.ts 迁移，逻辑保持一致。
+ */
+import type { StandardizedEvent, SessionInfo, SessionResolverConfig, IdempotencyStore } from "./types.js";
+export declare class WpsSessionResolver {
+    private readonly config;
+    private readonly idempotencyStore;
+    constructor(config: SessionResolverConfig, idempotencyStore: IdempotencyStore);
+    normalizeEvent(event: unknown): StandardizedEvent;
+    resolve(std: StandardizedEvent): SessionInfo | null;
+    checkIdempotency(key: string): Promise<boolean>;
+    markProcessed(key: string, ttl?: number): Promise<void>;
+}
+//# sourceMappingURL=resolver.d.ts.map

package/dist/session/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 会话解析与幂等去重类型定义。
+ * 从 v1 packages/channel-plugin/src/session/types.ts 迁移。
+ */
+export interface StandardizedEvent {
+    event_id: string;
+    message_id: string;
+    company_id: string;
+    user_id: string;
+    group_id?: string;
+    message: string;
+    is_at_bot: boolean;
+    is_reply_to_bot: boolean;
+}
+export interface SessionInfo {
+    scene: "p2p" | "group";
+    session_key: string;
+    idempotency_key: string;
+    message_id: string;
+    company_id: string;
+    user_id: string;
+    group_id?: string;
+}
+export interface SessionResolverConfig {
+    botId: string;
+    accountId?: string;
+}
+export declare class SessionResolverError extends Error {
+    readonly code: string;
+    readonly name = "SessionResolverError";
+    constructor(code: string, message: string);
+}
+export interface IdempotencyStore {
+    check(key: string): Promise<boolean>;
+    mark(key: string, ttl: number): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/oapi/calendar.d.ts

@@ -0,0 +1,106 @@
+/**
+ * WPS 日程工具 — create / list events / list instances（日历级与单条 event）。
+ *
+ * 列表接口与官方一致：
+ * - **事件列表**：`GET /v7/calendars/{calendar_id}/events`，主日历 `calendar_id=primary`
+ * - **日历级实例列表**：`GET /v7/calendars/{calendar_id}/event_instances`（按时间窗扫主日历下展开实例）
+ * - **单条日程详情**（官方「查询日程」）：`GET /v7/calendars/{calendar_id}/events/{event_id}`（需 `event_id`；`data` 为单个日程对象，含 `recurrence` 等）
+ * - **单条日程实例**（官方「查询日程实例」）：`GET /v7/calendars/{calendar_id}/events/{event_id}/event_instances`（需 `event_id`，可从事件列表取）
+ * - **答复日程邀请**：`POST /v7/calendars/{calendar_id}/events/{event_id}/respond`（body：`mod_type`、`response_status`、`which_day_time` 毫秒时间戳）
+ * - **参与者列表**：`GET /v7/calendars/{calendar_id}/events/{event_id}/attendees`（可选 `page_size`≤100、`page_token`）
+ * - 时间范围：`start_time` / `end_time` 为 **RFC3339** 字符串（URL 编码由客户端处理）
+ * - 时间窗长度：文档要求 **0～31 天**；超出则截断到 31 天
+ * - 事件列表增量：`sync_token`、`anchor_time`（RFC3339）、`with_cancelled`
+ *
+ * 文档：[查询日程列表](https://365.kdocs.cn/3rd/open/documents/app-integration-dev/wps365/server/calendar/calendar-event/get-calendar-event-list)
+ * · 查询日程实例列表（`event_instances`）见开放平台同域日历文档章节。
+ *
+ * 创建：用户 delegated token + POST `/v7/calendars/primary/events/create`
+ *
+ * **鉴权 / 签名**：与创建日程完全一致——均通过 `createUserWpsClient`（`UserAuthProvider`）仅注入
+ * `Authorization: Bearer <用户 access_token>`，无单独 KSO-1 或其它请求头分叉。
+ */
+import type { WpsClient } from "../../core/wps-client.js";
+import type { ToolRegistration } from "../../channel/types.js";
+/**
+ * 解析主日历「事件列表 / 实例列表」共用的时间窗（RFC3339 边界日期，跨度 ≤ 31 天）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function resolvePrimaryCalendarTimeRange(input: {
+    startRfc?: string;
+    endRfc?: string;
+    now?: Date;
+}): {
+    start: Date;
+    end: Date;
+};
+/**
+ * 构建 **日历级** `.../calendars/{id}/event_instances` GET 查询参数（RFC3339 时间窗 + 可选分页）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildPrimaryCalendarEventInstancesQuery(input: {
+    startRfc?: string;
+    endRfc?: string;
+    pageSize?: number;
+    pageToken?: string;
+    now?: Date;
+}): Record<string, string | number>;
+/**
+ * 单条日程「查询日程实例」GET query（文档仅 `start_time` / `end_time`，RFC3339，0～31 天）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildEventScopedEventInstancesQuery(input: {
+    startRfc?: string;
+    endRfc?: string;
+    now?: Date;
+}): Record<string, string>;
+/**
+ * 构建主日历事件列表 GET 查询参数（与开放平台「查询日程列表」一致）。
+ *
+ * - 带 `sync_token` 时：仅传增量相关字段，不再自动补 `start_time`/`end_time`。
+ * - 否则：补全或默认时间窗，并保证跨度 ≤ 31 天。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildPrimaryCalendarEventsListQuery(input: {
+    startRfc?: string;
+    endRfc?: string;
+    pageSize?: number;
+    pageToken?: string;
+    withCancelled?: boolean;
+    syncToken?: string;
+    anchorTime?: string;
+    now?: Date;
+}): Record<string, string | number | boolean>;
+/**
+ * `.../calendars/{calendar_id}/events/{event_id}` 路径段（查询单条日程；亦为 event_instances 的前缀）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildCalendarGetEventPath(calendarId: string, eventId: string): string;
+/**
+ * `POST .../events/{event_id}/respond`（答复日程邀请）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildCalendarRespondInvitationPath(calendarId: string, eventId: string): string;
+/**
+ * `GET .../events/{event_id}/attendees`（获取日程参与者列表）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildCalendarEventAttendeesPath(calendarId: string, eventId: string): string;
+/**
+ * 参与者列表 GET query：`page_size`（默认 30，最大 100）、可选 `page_token`。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildEventAttendeesQuery(input: {
+    pageSize?: number;
+    pageToken?: string;
+}): Record<string, string | number>;
+export declare function registerCalendarTools(_client: WpsClient, registerTool: (opts: ToolRegistration) => void): void;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/tools/oapi/chat.d.ts

@@ -0,0 +1,10 @@
+/**
+ * WPS OpenAPI chat session tools (create, list, get, members).
+ */
+import type { WpsClient } from "../../core/wps-client.js";
+import type { ToolRegistration } from "../../channel/types.js";
+/**
+ * Registers WPS chat OpenAPI tools.
+ */
+export declare function registerChatTools(client: WpsClient, registerTool: (opts: ToolRegistration) => void): void;
+//# sourceMappingURL=chat.d.ts.map

package/dist/tools/oapi/delegated-auth.d.ts

@@ -0,0 +1,14 @@
+import type { WpsClient } from "../../core/wps-client.js";
+type NeedsAuthResult = {
+    needsAuth: true;
+    message: string;
+};
+export declare function withDelegatedUserClient(opts: {
+    wpsUserId: string;
+    authCardOriginalMessage: string;
+    needsAuthMessage: string;
+    logTag: string;
+    run: (client: WpsClient) => Promise<unknown>;
+}): Promise<unknown | NeedsAuthResult>;
+export {};
+//# sourceMappingURL=delegated-auth.d.ts.map

package/dist/tools/oapi/drive.d.ts

@@ -0,0 +1,112 @@
+/**
+ * WPS 云文档工具 — 盘列表 / 新建文件（夹）（用户 delegated OAuth）。
+ *
+ * - **获取盘列表**：`GET /v7/drives`
+ * - **新建文件（夹）**：`POST /v7/drives/{drive_id}/files/{parent_id}/create`
+ * - 文档权限：`kso.drive.readwrite`、`kso.file.readwrite`（或控制台等价 delegated）
+ */
+import type { WpsClient } from "../../core/wps-client.js";
+import type { ToolRegistration } from "../../channel/types.js";
+/**
+ * 构建「获取盘列表」query。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildDriveListQuery(input: {
+    alloteeType: "user" | "group" | "app";
+    alloteeId?: string;
+    withExtAttrs?: boolean;
+    pageSize?: number;
+    pageToken?: string;
+    sources?: string[];
+}): Record<string, string | number | boolean | string[]>;
+/**
+ * 构建「新建文件（夹）」path。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildDriveCreateFilePath(driveId: string, parentId: string): string;
+/**
+ * 构建「新建文件（夹）」body。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildDriveCreateFileBody(input: {
+    fileType: "folder" | "file" | "shortcut";
+    name: string;
+    fileId?: string;
+    onNameConflict?: "fail" | "rename" | "overwrite" | "replace";
+    parentPath?: string[];
+}): Record<string, unknown>;
+/**
+ * 构建「文档内容抽取」path。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildDriveExtractContentPath(driveId: string, fileId: string): string;
+/**
+ * 构建「文档内容抽取」query。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildDriveExtractContentQuery(input: {
+    format?: string;
+    includeElements?: string[];
+    mode?: string;
+    taskId?: string;
+}): Record<string, string | string[]>;
+/**
+ * 构建「获取文件信息」path。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildDriveFileMetaPath(fileId: string): string;
+/**
+ * 构建「获取文件信息」query。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildDriveFileMetaQuery(input: {
+    withPermission?: boolean;
+    withExtAttrs?: boolean;
+    withDrive?: boolean;
+}): Record<string, boolean>;
+/**
+ * 构建「文件搜索」query。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildDriveFileSearchQuery(input: {
+    keyword?: string;
+    type: "file_name" | "content" | "all";
+    fileType?: "folder" | "file" | "shortcut";
+    fileExts?: string[];
+    driveIds?: string[];
+    parentIds?: string[];
+    creatorIds?: string[];
+    modifierIds?: string[];
+    sharerIds?: string[];
+    receiverIds?: string[];
+    timeType?: "ctime" | "mtime" | "otime" | "stime";
+    startTime?: number;
+    endTime?: number;
+    withPermission?: boolean;
+    withLink?: boolean;
+    withTotal?: boolean;
+    pageSize?: number;
+    pageToken?: string;
+    channels?: string[];
+    deviceIds?: string[];
+    excludeChannels?: string[];
+    excludeFileExts?: string[];
+    filterUserId?: number;
+    fileExtGroups?: string[];
+    withFolder?: boolean;
+    withDrive?: boolean;
+    order?: "desc" | "asc";
+    orderBy?: "ctime" | "mtime";
+    scope?: string[];
+    searchOperatorName?: boolean;
+}): Record<string, string | number | boolean | string[]>;
+export declare function registerDriveTools(_client: WpsClient, registerTool: (opts: ToolRegistration) => void): void;
+//# sourceMappingURL=drive.d.ts.map

package/dist/tools/oapi/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * WPS OpenAPI tool registrations for OpenClaw (barrel).
+ *
+ * 所有工具在 register() 阶段注册为工厂函数。
+ * 工厂在 agent dispatch 时被调用，此时 lazy client 已就绪。
+ */
+export { registerMessagingTools } from "./messaging.js";
+export { registerUserTools } from "./user.js";
+export { registerChatTools } from "./chat.js";
+export { registerMediaTools } from "./media.js";
+export { registerCalendarTools } from "./calendar.js";
+export { registerTodoTools } from "./todo.js";
+export { registerDriveTools } from "./drive.js";
+/**
+ * Registers all WPS OAPI tools as factory functions during register() phase.
+ *
+ * Uses a Proxy client that defers actual WPS API calls to after startAccount().
+ *
+ * @returns Number of tools registered
+ */
+export declare function registerAllOapiToolFactories(rawRegisterTool: (tool: unknown, opts?: {
+    name?: string;
+}) => void): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/oapi/media.d.ts

@@ -0,0 +1,32 @@
+/**
+ * WPS OpenAPI media tools (download URL, upload phase-1 entry).
+ */
+import type { WpsClient } from "../../core/wps-client.js";
+import type { ToolRegistration, LogFacade } from "../../channel/types.js";
+/**
+ * SHA256 digest of file bytes as lowercase hex, for POST `/v7/chats/resources/upload` field `checksum`.
+ * If the platform rejects the value, confirm the latest WPS OpenAPI doc for the required algorithm.
+ */
+export declare function computeWpsUploadChecksum(bytes: Buffer): string;
+/**
+ * True when `s` is almost certainly a local filesystem path (OpenClaw passes prefetched
+ * attachment paths here), not a WPS `storage_key`.
+ */
+export declare function isLikelyLocalMediaPath(s: string): boolean;
+export type WpsUploadBytesResult = {
+    storage_key: string;
+    file_name: string;
+    file_size: number;
+};
+/**
+ * POST /v7/chats/resources/upload + PUT to pre-signed URL. Shared by `wps_media_upload_base64` and channel sendMedia.
+ */
+export declare function uploadBytesToWpsStorage(client: WpsClient, fileName: string, fileType: string, rawBytes: Buffer, log?: {
+    info?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+}): Promise<WpsUploadBytesResult>;
+/**
+ * Registers WPS media OpenAPI tools (pre-signed download URL, upload entry).
+ */
+export declare function registerMediaTools(client: WpsClient, registerTool: (opts: ToolRegistration) => void, log?: LogFacade): void;
+//# sourceMappingURL=media.d.ts.map

package/dist/tools/oapi/messaging.d.ts

@@ -0,0 +1,10 @@
+/**
+ * WPS OpenAPI messaging tools (create, reply, list, get).
+ */
+import type { WpsClient } from "../../core/wps-client.js";
+import type { ToolRegistration } from "../../channel/types.js";
+/**
+ * Registers WPS IM message tools against the OpenClaw plugin API.
+ */
+export declare function registerMessagingTools(client: WpsClient, registerTool: (opts: ToolRegistration) => void): void;
+//# sourceMappingURL=messaging.d.ts.map

package/dist/tools/oapi/todo.d.ts

@@ -0,0 +1,96 @@
+/**
+ * WPS 个人待办工具 — 创建 / 列表（开放平台用户 delegated OAuth）。
+ *
+ * - **创建个人待办**：`POST /v7/todo/personal_tasks`
+ * - **获取个人待办列表**：`POST /v7/todo/personal_tasks/batch_get`
+ * - **获取个人待办详情**：`GET /v7/todo/personal_tasks/{task_id}`
+ * - **更新个人待办**：`POST /v7/todo/personal_tasks/{task_id}/update`（文档要求 `kso.task.readwrite`）
+ * - **更新个人待办状态**：`POST /v7/todo/personal_tasks/{task_id}/update_status`
+ * - 文档权限：`kso.task.readwrite` / `kso.task.read`（或控制台等价 delegated）
+ *
+ * HTTP 调用与日历工具一致：用户 `access_token` + `Authorization: Bearer`（`createUserWpsClient`）。
+ * 开放平台文档虽标注 KSO-1，与本插件其它用户态 OpenAPI 用法对齐。
+ */
+import type { WpsClient } from "../../core/wps-client.js";
+import type { ToolRegistration } from "../../channel/types.js";
+/**
+ * `GET .../personal_tasks/{task_id}`（获取个人待办详情）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildPersonalTaskDetailPath(taskId: string): string;
+/**
+ * `POST .../personal_tasks/{task_id}/update`（更新个人待办）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildPersonalTaskUpdatePath(taskId: string): string;
+/**
+ * `POST .../personal_tasks/{task_id}/update_status`（更新个人待办状态）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildPersonalTaskUpdateStatusPath(taskId: string): string;
+/**
+ * 构建「创建个人待办」请求体。必填只有 `title`（对象，含 `subject`；可选 `prefix`）。
+ * 时间与文档一致：`due_time` 为毫秒时间戳。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildPersonalTaskCreateBody(input: {
+    titleSubject: string;
+    titlePrefix?: string;
+    description?: string;
+    dueTimeMs?: number;
+    status?: "todo" | "finish";
+    executors?: string[];
+}): Record<string, unknown>;
+/**
+ * 构建「获取个人待办列表」`batch_get` 请求体（字段均可选）。
+ * 时间字段与文档示例一致，单位为毫秒时间戳。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildPersonalTasksBatchGetBody(input: {
+    keyword?: string;
+    executor?: string;
+    status?: "todo" | "finish";
+    pageSize?: number;
+    pageToken?: string;
+    createdTimeStartMs?: number;
+    createdTimeEndMs?: number;
+    dueTimeStartMs?: number;
+    dueTimeEndMs?: number;
+}): Record<string, unknown>;
+/**
+ * 构建「更新个人待办」请求体（字段均可选；至少须有一项，否则抛错）。
+ *
+ * @internal 导出供单元测试。
+ */
+export declare function buildPersonalTaskUpdateBody(input: {
+    titleSubject?: string;
+    titlePrefix?: string;
+    description?: string;
+    dueTimeMs?: number;
+    extAttrs?: Array<{
+        name: string;
+        value: string;
+    }>;
+    notifyConfig?: Record<string, unknown>;
+}): Record<string, unknown>;
+/**
+ * 开放平台 `POST .../update_status` 请求体：仅含 **`action`**，枚举与文档一致。
+ *
+ * @internal 导出供单元测试。
+ * @see parsePersonalTaskUpdateStatusAction
+ */
+export type PersonalTaskUpdateStatusAction = "finish" | "unfinish" | "finish_all" | "unfinish_all";
+/** 仅接受开放平台文档枚举；不接受历史错误拼写（如 unfinished），不做兼容映射。 */
+export declare function parsePersonalTaskUpdateStatusAction(raw: string): PersonalTaskUpdateStatusAction;
+export declare function buildPersonalTaskUpdateStatusBody(input: {
+    action: string;
+}): {
+    action: PersonalTaskUpdateStatusAction;
+};
+export declare function registerTodoTools(_client: WpsClient, registerTool: (opts: ToolRegistration) => void): void;
+//# sourceMappingURL=todo.d.ts.map

package/dist/tools/oapi/user.d.ts

@@ -0,0 +1,10 @@
+/**
+ * WPS OpenAPI user tools (current user, search).
+ */
+import type { WpsClient } from "../../core/wps-client.js";
+import type { ToolRegistration } from "../../channel/types.js";
+/**
+ * Registers WPS user-related OpenAPI tools.
+ */
+export declare function registerUserTools(client: WpsClient, registerTool: (opts: ToolRegistration) => void): void;
+//# sourceMappingURL=user.d.ts.map

package/dist/tools/oauth/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * WPS 用户 OAuth 授权模块。
+ *
+ * 职责：
+ * - 构建授权 URL（buildAuthorizeUrl）
+ * - 构建授权前/后卡片消息（buildAuthCard / buildAuthSuccessCard）
+ * - 发送授权卡片给用户（sendAuthCard）
+ * - 处理授权事件（handleAuthEvent：code 换 token；成功卡片优先使用 state 内记录的本次 scope 名称）
+ * - state 编解码（encode/decode，nonce Map + 10 分钟 TTL）
+ */
+import type { AppCredentials, WpsConfig } from "../../core/index.js";
+import type { LogFacade } from "../../channel/types.js";
+export type OAuthState = {
+    wpsUserId: string;
+    receiverType: "user" | "chat";
+    receiverId: string;
+    nonce: string;
+    messageId?: string;
+    originalMessage?: string;
+    /** 本次 authorize URL 中的权限点名称（与卡片列表一致）；授权回调更新「已完成」卡片时优先使用 */
+    requestedScopeNames?: string[];
+};
+export declare function encodeState(state: OAuthState): string;
+export declare function decodeState(key: string): OAuthState | null;
+export declare function buildAuthorizeUrl(opts: {
+    baseUrl: string;
+    appId: string;
+    scopes: string[];
+    state: string;
+    redirectUri: string;
+}): string;
+/** `scopes` 为权限点 **名称**（如 `kso.xxx`），用于卡片列表展示，须与 OAuth `scope=` 一致。 */
+export declare function buildAuthCard(authorizeUrl: string, scopes: string[]): unknown;
+/** `scopes` 为权限点 **名称**（如 `kso.xxx`），用于「已完成授权」列表展示。 */
+export declare function buildAuthSuccessCard(scopes: string[]): unknown;
+/** 卡片「将要授权的权限」列表展示权限点名称（`kso.*`）。未传 `scopes` 时使用 `GET /v7/developer/apps` 同步的全量 delegated。 */
+export declare function sendAuthCard(opts: {
+    creds: AppCredentials;
+    wpsCfg: WpsConfig;
+    wpsUserId: string;
+    receiverType: "user" | "chat";
+    receiverId: string;
+    originalMessage?: string;
+    /** 若传入，OAuth `scope=` 与卡片列表均使用其中的名称（通常来自开放平台 delegated）。 */
+    scopes?: {
+        names: string[];
+    };
+}): Promise<{
+    messageId: string;
+    authorizeUrl: string;
+} | null>;
+/**
+ * 处理 SDK 推送的用户授权事件。
+ * 从事件 payload 拿 code + state，换 token，更新卡片。
+ * state 可能为空（事件 payload 不一定包含 state），此时走 userId 兜底。
+ */
+export declare function handleAuthEvent(opts: {
+    code: string;
+    state: string;
+    creds: AppCredentials;
+    wpsCfg: WpsConfig;
+    log?: LogFacade;
+    userId?: string;
+}): Promise<void>;
+//# sourceMappingURL=index.d.ts.map