@wps365/openclaw-wpsxiezuo 1.6.0

package/dist/core/config.d.ts

@@ -0,0 +1,267 @@
+/**
+ * WPS 渠道运行时配置 — Zod Schema + 类型导出。
+ *
+ * 从 v1 packages/channel-plugin/src/types.ts 迁移并重构：
+ * - 配置定义集中在此文件
+ * - 凭证解析逻辑内聚
+ * - 预留 userAuth 扩展点
+ */
+import { z } from "zod";
+import type { AppCredentials } from "./token-store.js";
+export declare const DmPolicySchema: z.ZodDefault<z.ZodEnum<{
+    disabled: "disabled";
+    open: "open";
+    allowlist: "allowlist";
+    pairing: "pairing";
+}>>;
+export declare const GroupConfigSchema: z.ZodObject<{
+    requireMention: z.ZodOptional<z.ZodBoolean>;
+    toolPolicy: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        limited: "limited";
+        none: "none";
+    }>>;
+}, z.core.$loose>;
+export declare const McpConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    mode: z.ZodDefault<z.ZodLiteral<"app">>;
+    clientId: z.ZodOptional<z.ZodString>;
+    clientSecret: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    toolAllowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const InstantAckSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    text: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const SdkConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    logLevel: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+    }>>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    connectTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    pongTimeout: z.ZodDefault<z.ZodNumber>;
+    autoReconnect: z.ZodDefault<z.ZodBoolean>;
+    reconnectBaseInterval: z.ZodDefault<z.ZodNumber>;
+    reconnectMaxInterval: z.ZodDefault<z.ZodNumber>;
+    reconnectMultiplier: z.ZodDefault<z.ZodNumber>;
+    reconnectMaxRetry: z.ZodDefault<z.ZodNumber>;
+    reconnectJitter: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const WebhookConfigSchema: z.ZodObject<{
+    path: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * 用户 OAuth `redirect_uri`（插件内置，**须**与 WPS 开放平台「安全设置 → 用户授权回调地址」登记**完全一致**）。
+ */
+export declare const DEFAULT_USER_OAUTH_REDIRECT_URI = "https://o.wpsgo.com/app/41000207/aY5vaqfh9T0o/";
+export declare const WpsConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    appId: z.ZodString;
+    appSecret: z.ZodString;
+    companyId: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodDefault<z.ZodString>;
+    enableEncryption: z.ZodDefault<z.ZodBoolean>;
+    webhook: z.ZodOptional<z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        port: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    sdk: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        logLevel: z.ZodDefault<z.ZodEnum<{
+            error: "error";
+            debug: "debug";
+            info: "info";
+            warn: "warn";
+        }>>;
+        endpoint: z.ZodOptional<z.ZodString>;
+        connectTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        pongTimeout: z.ZodDefault<z.ZodNumber>;
+        autoReconnect: z.ZodDefault<z.ZodBoolean>;
+        reconnectBaseInterval: z.ZodDefault<z.ZodNumber>;
+        reconnectMaxInterval: z.ZodDefault<z.ZodNumber>;
+        reconnectMultiplier: z.ZodDefault<z.ZodNumber>;
+        reconnectMaxRetry: z.ZodDefault<z.ZodNumber>;
+        reconnectJitter: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    dmPolicy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        disabled: "disabled";
+        open: "open";
+        allowlist: "allowlist";
+        pairing: "pairing";
+    }>>>;
+    allowFrom: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    groupPolicy: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        allowlist: "allowlist";
+    }>>;
+    groups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        requireMention: z.ZodOptional<z.ZodBoolean>;
+        toolPolicy: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            limited: "limited";
+            none: "none";
+        }>>;
+    }, z.core.$loose>>>;
+    instantAck: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        text: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    robotJoinGroupMessage: z.ZodOptional<z.ZodString>;
+    mcp: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        mode: z.ZodDefault<z.ZodLiteral<"app">>;
+        clientId: z.ZodOptional<z.ZodString>;
+        clientSecret: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        toolAllowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const WpsChannelConfigSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    appId: z.ZodOptional<z.ZodString>;
+    appSecret: z.ZodOptional<z.ZodString>;
+    companyId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    baseUrl: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    enableEncryption: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    webhook: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        port: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    sdk: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        logLevel: z.ZodDefault<z.ZodEnum<{
+            error: "error";
+            debug: "debug";
+            info: "info";
+            warn: "warn";
+        }>>;
+        endpoint: z.ZodOptional<z.ZodString>;
+        connectTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        pongTimeout: z.ZodDefault<z.ZodNumber>;
+        autoReconnect: z.ZodDefault<z.ZodBoolean>;
+        reconnectBaseInterval: z.ZodDefault<z.ZodNumber>;
+        reconnectMaxInterval: z.ZodDefault<z.ZodNumber>;
+        reconnectMultiplier: z.ZodDefault<z.ZodNumber>;
+        reconnectMaxRetry: z.ZodDefault<z.ZodNumber>;
+        reconnectJitter: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    dmPolicy: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        disabled: "disabled";
+        open: "open";
+        allowlist: "allowlist";
+        pairing: "pairing";
+    }>>>>;
+    allowFrom: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    groupPolicy: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        allowlist: "allowlist";
+    }>>>;
+    groups: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        requireMention: z.ZodOptional<z.ZodBoolean>;
+        toolPolicy: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            limited: "limited";
+            none: "none";
+        }>>;
+    }, z.core.$loose>>>>;
+    instantAck: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        text: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>>;
+    robotJoinGroupMessage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    mcp: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        mode: z.ZodDefault<z.ZodLiteral<"app">>;
+        clientId: z.ZodOptional<z.ZodString>;
+        clientSecret: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        toolAllowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    defaultAccountId: z.ZodOptional<z.ZodString>;
+    accounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        appId: z.ZodString;
+        appSecret: z.ZodString;
+        companyId: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodDefault<z.ZodString>;
+        enableEncryption: z.ZodDefault<z.ZodBoolean>;
+        webhook: z.ZodOptional<z.ZodObject<{
+            path: z.ZodDefault<z.ZodString>;
+            port: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        sdk: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            logLevel: z.ZodDefault<z.ZodEnum<{
+                error: "error";
+                debug: "debug";
+                info: "info";
+                warn: "warn";
+            }>>;
+            endpoint: z.ZodOptional<z.ZodString>;
+            connectTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            pongTimeout: z.ZodDefault<z.ZodNumber>;
+            autoReconnect: z.ZodDefault<z.ZodBoolean>;
+            reconnectBaseInterval: z.ZodDefault<z.ZodNumber>;
+            reconnectMaxInterval: z.ZodDefault<z.ZodNumber>;
+            reconnectMultiplier: z.ZodDefault<z.ZodNumber>;
+            reconnectMaxRetry: z.ZodDefault<z.ZodNumber>;
+            reconnectJitter: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        dmPolicy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            disabled: "disabled";
+            open: "open";
+            allowlist: "allowlist";
+            pairing: "pairing";
+        }>>>;
+        allowFrom: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        groupPolicy: z.ZodOptional<z.ZodEnum<{
+            open: "open";
+            allowlist: "allowlist";
+        }>>;
+        groups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            requireMention: z.ZodOptional<z.ZodBoolean>;
+            toolPolicy: z.ZodOptional<z.ZodEnum<{
+                full: "full";
+                limited: "limited";
+                none: "none";
+            }>>;
+        }, z.core.$loose>>>;
+        instantAck: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            text: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>;
+        robotJoinGroupMessage: z.ZodOptional<z.ZodString>;
+        mcp: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            mode: z.ZodDefault<z.ZodLiteral<"app">>;
+            clientId: z.ZodOptional<z.ZodString>;
+            clientSecret: z.ZodOptional<z.ZodString>;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            toolAllowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type WpsConfig = z.infer<typeof WpsConfigSchema>;
+export type WpsChannelConfig = z.infer<typeof WpsChannelConfigSchema>;
+export type DmPolicy = z.infer<typeof DmPolicySchema>;
+export type GroupConfig = z.infer<typeof GroupConfigSchema>;
+export type McpConfig = z.infer<typeof McpConfigSchema>;
+export type InstantAckConfig = z.infer<typeof InstantAckSchema>;
+export type SdkConfig = z.infer<typeof SdkConfigSchema>;
+export type WebhookConfig = z.infer<typeof WebhookConfigSchema>;
+/** 始终返回插件内置用户 OAuth 回调地址（忽略 channel 配置）。 */
+export declare function resolveUserOAuthRedirectUri(_wpsCfg?: WpsConfig | null): string;
+export declare function resolveDefaultWpsAccountId(cfg?: WpsChannelConfig): string;
+export declare function resolveWpsAccounts(cfg?: WpsChannelConfig): Record<string, WpsConfig>;
+export declare function resolveAppCredentials(cfg?: WpsConfig): AppCredentials | null;
+export declare function resolveMcpCredentials(cfg?: WpsConfig): AppCredentials | null;
+export declare const WPS_CHANNEL_ID = "wps-xiezuo";
+export declare const WPS_PLUGIN_ID = "wps-xiezuo";
+export declare const DEFAULT_ACCOUNT_ID = "default";
+//# sourceMappingURL=config.d.ts.map

package/dist/core/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * WPS OpenAPI 统一错误体系。
+ *
+ * 错误分三个阶段：
+ * - http:     HTTP 层错误（4xx/5xx）
+ * - business: 业务层错误（code ≠ 0）
+ * - parse:    响应解析错误（非法 JSON）
+ */
+export type WpsErrorStage = "http" | "business" | "parse";
+export type WpsErrorDetail = {
+    stage: WpsErrorStage;
+    method: string;
+    path: string;
+    httpStatus?: number;
+    wpsCode?: number | string;
+    hint?: string;
+    retriable?: boolean;
+    requestId?: string;
+};
+export declare class WpsRequestError extends Error {
+    readonly detail: WpsErrorDetail;
+    readonly name = "WpsRequestError";
+    constructor(message: string, detail: WpsErrorDetail);
+    get retriable(): boolean;
+    get stage(): WpsErrorStage;
+}
+export declare class WpsTokenError extends Error {
+    readonly cause?: unknown | undefined;
+    readonly name = "WpsTokenError";
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare function httpStatusHint(status: number): {
+    hint: string;
+    retriable: boolean;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * core/ 公共导出。
+ * 上层模块统一从 `@/core/index.js` 或具体文件导入。
+ */
+export { WpsRequestError, WpsTokenError, httpStatusHint } from "./errors.js";
+export type { WpsErrorStage, WpsErrorDetail } from "./errors.js";
+export { AppTokenStore, getAppTokenStore, clearAllTokenStores } from "./token-store.js";
+export type { TokenEntry, AppCredentials } from "./token-store.js";
+export { exchangeCodeForToken, putUserToken, getUserToken, takeUserToken, hasUserToken, setRefreshContext } from "./user-token-store.js";
+export type { UserTokenEntry, OAuthCodeExchangeParams } from "./user-token-store.js";
+export { WpsClient, AppAuthProvider, UserAuthProvider, createWpsClient, createUserWpsClient } from "./wps-client.js";
+export type { AuthProvider, WpsRequestOptions } from "./wps-client.js";
+export { resolveDownloadUrl, resolveDownloadUrlOrThrow } from "./media-utils.js";
+export { addThinkingReaction, removeThinkingReaction, REACTION_TYPE } from "./reaction.js";
+export type { ThinkingIndicatorState } from "./reaction.js";
+export { WpsConfigSchema, WpsChannelConfigSchema, DmPolicySchema, GroupConfigSchema, McpConfigSchema, InstantAckSchema, SdkConfigSchema, WebhookConfigSchema, resolveAppCredentials, resolveMcpCredentials, resolveDefaultWpsAccountId, resolveWpsAccounts, resolveUserOAuthRedirectUri, DEFAULT_USER_OAUTH_REDIRECT_URI, WPS_CHANNEL_ID, WPS_PLUGIN_ID, DEFAULT_ACCOUNT_ID, } from "./config.js";
+export type { WpsConfig, WpsChannelConfig, DmPolicy, GroupConfig, McpConfig, InstantAckConfig, SdkConfig, WebhookConfig, } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/lazy-client-store.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 延迟初始化的 WpsClient 存储。
+ *
+ * 工具在 register() 阶段注册（此时无凭据），
+ * 凭据在 startAccount() 阶段设置，
+ * 工具执行时通过 getClient() 获取已初始化的 client。
+ */
+import type { WpsClient } from "./wps-client.js";
+import type { WpsConfig } from "./config.js";
+import type { AppCredentials } from "./token-store.js";
+declare let _log: {
+    info?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+} | null;
+export declare function setLazyClient(client: WpsClient, log?: typeof _log, wpsCfg?: WpsConfig, creds?: AppCredentials): void;
+export declare function getLazyClient(): WpsClient;
+export declare function getLazyLog(): typeof _log;
+export declare function getLazyWpsCfg(): WpsConfig;
+export declare function getLazyCreds(): AppCredentials;
+export type DelegatedScope = {
+    name: string;
+    description: string;
+};
+export declare function setDelegatedScopes(scopes: DelegatedScope[]): void;
+export declare function getDelegatedScopes(): DelegatedScope[];
+export {};
+//# sourceMappingURL=lazy-client-store.d.ts.map

package/dist/core/media-utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * WPS 媒体相关公共工具。
+ *
+ * resolveDownloadUrl — 从 WPS download API 响应中提取预签名下载 URL。
+ * 统一供 tools/oapi/media.ts 和 messaging/inbound/media-prefetch.ts 使用。
+ */
+/**
+ * 从 WPS download API 的 JSON 响应中解析出预签名下载 URL。
+ * 支持顶层字段和 `data` 嵌套（最多 2 层）。
+ *
+ * @returns URL string, or `null` if none found.
+ */
+export declare function resolveDownloadUrl(data: unknown, depth?: number): string | null;
+/**
+ * 同 resolveDownloadUrl，但找不到时抛出 Error（工具调用场景）。
+ */
+export declare function resolveDownloadUrlOrThrow(data: unknown): string;
+/**
+ * Parse image width/height from raw bytes.
+ * Delegates to `image-size` (supports 20+ formats including JPEG, PNG, GIF, WebP, BMP, TIFF, etc.).
+ * Returns null if format is unrecognized or header is malformed.
+ */
+export declare function parseImageDimensions(buf: Buffer | Uint8Array): {
+    width: number;
+    height: number;
+} | null;
+//# sourceMappingURL=media-utils.d.ts.map

package/dist/core/reaction.d.ts

@@ -0,0 +1,29 @@
+/**
+ * WPS 消息表情回复（Reaction）封装。
+ *
+ * 用于入站消息处理链路的"正在思考"指示器：
+ * 收到消息后添加 reaction，Agent 处理完成后删除。
+ */
+import type { AppCredentials } from "./token-store.js";
+export declare const REACTION_TYPE = "emoji_busy";
+export type ThinkingIndicatorState = {
+    kind: "reaction";
+    chatId: string;
+    messageId: string;
+} | {
+    kind: "text-fallback";
+};
+/**
+ * 对指定消息添加 thinking reaction。
+ * 失败时抛出异常，由调用方决定降级策略。
+ */
+export declare function addThinkingReaction(creds: AppCredentials, chatId: string, messageId: string): Promise<void>;
+/**
+ * 删除指定消息上的 thinking reaction。
+ * 内部捕获所有异常，不抛出（仅通过 log 记录）。
+ */
+export declare function removeThinkingReaction(creds: AppCredentials, chatId: string, messageId: string, log?: {
+    info?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+}): Promise<void>;
+//# sourceMappingURL=reaction.d.ts.map

package/dist/core/token-store.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 双轨 Token 管理。
+ *
+ * 本轮实现企业应用级（client_credentials）。
+ * 用户委托级（authorization_code + refresh_token）预留接口，后续补齐。
+ */
+export type TokenEntry = {
+    accessToken: string;
+    expiresAt: number;
+};
+export type AppCredentials = {
+    clientId: string;
+    clientSecret: string;
+    baseUrl: string;
+};
+export declare class AppTokenStore {
+    private readonly creds;
+    private token;
+    private inFlight;
+    constructor(creds: AppCredentials);
+    getToken(): Promise<string>;
+    invalidate(): void;
+    private requestToken;
+}
+/**
+ * 获取或创建一个 AppTokenStore 实例。
+ * 以 clientId 为 key 做单例管理，避免同一应用创建多个 store。
+ */
+export declare function getAppTokenStore(creds: AppCredentials): AppTokenStore;
+/**
+ * 清除所有缓存的 TokenStore（用于测试或热重载）。
+ */
+export declare function clearAllTokenStores(): void;
+//# sourceMappingURL=token-store.d.ts.map

package/dist/core/user-token-store.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 用户级 OAuth Token 管理 — 内存存储 + 定时刷新。
+ *
+ * - 授权回调拿到 access_token / refresh_token / expires_in 后存入
+ * - 工具取 token 时不删除，可重复使用
+ * - 过期前自动用 refresh_token 续期
+ * - refresh_token 失败则清除，下次使用时触发重新授权
+ */
+export type UserTokenEntry = {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    openid: string;
+};
+export type OAuthCodeExchangeParams = {
+    appId: string;
+    appSecret: string;
+    baseUrl: string;
+    code: string;
+    redirectUri?: string;
+};
+export type RefreshContext = {
+    appId: string;
+    appSecret: string;
+    baseUrl: string;
+};
+/** 设置 refresh 所需的应用凭证（启动时调一次） */
+export declare function setRefreshContext(ctx: RefreshContext): void;
+export declare function putUserToken(wpsUserId: string, entry: UserTokenEntry): void;
+export declare function getUserToken(wpsUserId: string): string | null;
+/** 兼容旧调用方 — 行为改为不删除 */
+export declare function takeUserToken(wpsUserId: string): string | null;
+export declare function hasUserToken(wpsUserId: string): boolean;
+export declare function exchangeCodeForToken(params: OAuthCodeExchangeParams): Promise<UserTokenEntry>;
+//# sourceMappingURL=user-token-store.d.ts.map

package/dist/core/wps-client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * WPS OpenAPI 统一 HTTP 客户端。
+ *
+ * - 自动注入 Authorization header（通过 AuthProvider 抽象）
+ * - 统一请求构造、响应解析、错误映射
+ * - 预留 KSO-1 签名注入点（后续补齐）
+ */
+import type { AppTokenStore } from "./token-store.js";
+export interface AuthProvider {
+    getHeaders(): Promise<Record<string, string>>;
+}
+export declare class AppAuthProvider implements AuthProvider {
+    private readonly tokenStore;
+    constructor(tokenStore: AppTokenStore);
+    getHeaders(): Promise<Record<string, string>>;
+}
+/**
+ * 一次性 user token provider — 拿一个 accessToken 字符串直接用。
+ */
+export declare class UserAuthProvider implements AuthProvider {
+    private readonly accessToken;
+    constructor(accessToken: string);
+    getHeaders(): Promise<Record<string, string>>;
+}
+export type WpsRequestOptions = {
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    path: string;
+    query?: Record<string, string | number | boolean | string[] | undefined>;
+    body?: unknown;
+    headers?: Record<string, string>;
+};
+export declare class WpsClient {
+    private readonly baseUrl;
+    private readonly auth;
+    constructor(baseUrl: string, auth: AuthProvider);
+    request<T = unknown>(opts: WpsRequestOptions): Promise<T>;
+    private buildUrl;
+    private parseResponse;
+}
+export declare function createWpsClient(baseUrl: string, tokenStore: AppTokenStore): WpsClient;
+export declare function createUserWpsClient(baseUrl: string, accessToken: string): WpsClient;
+//# sourceMappingURL=wps-client.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * OpenClaw WPS Xiezuo 插件入口。
+ *
+ * 工具必须在 register() 阶段注册（OpenClaw 在此之后冻结工具列表）。
+ * WpsClient 在 startAccount() 阶段通过 lazy-client-store 初始化，
+ * 工具执行时通过 getLazyClient() 获取。
+ */
+import type { OpenClawPluginApi } from "./channel/types.js";
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: unknown;
+    register(api: OpenClawPluginApi): void;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map