@larksuite/openclaw-lark 2026.3.9

package/src/core/lark-logger.js.map

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

package/src/core/lark-ticket.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Request-level ticket for the Feishu plugin.
+ *
+ * Uses Node.js AsyncLocalStorage to propagate a ticket (message_id,
+ * chat_id, account_id) through the entire async call chain without passing
+ * parameters explicitly.  Call {@link withTicket} at the event entry point
+ * (monitor.ts) and use {@link getTicket} anywhere downstream.
+ */
+export interface LarkTicket {
+    messageId: string;
+    chatId: string;
+    accountId: string;
+    startTime: number;
+    senderOpenId?: string;
+    chatType?: 'p2p' | 'group';
+    threadId?: string;
+}
+/**
+ * Run `fn` within a ticket context.  All async operations spawned inside
+ * `fn` will inherit the context and can access it via {@link getTicket}.
+ */
+export declare function withTicket<T>(ticket: LarkTicket, fn: () => T | Promise<T>): T | Promise<T>;
+/** Return the current ticket, or `undefined` if not inside withTicket. */
+export declare function getTicket(): LarkTicket | undefined;
+/** Milliseconds elapsed since the current ticket was created, or 0. */
+export declare function ticketElapsed(): number;
+//# sourceMappingURL=lark-ticket.d.ts.map

package/src/core/lark-ticket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lark-ticket.d.ts","sourceRoot":"","sources":["../../../src/core/lark-ticket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAYD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1F;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,IAAI,UAAU,GAAG,SAAS,CAElD;AAED,uEAAuE;AACvE,wBAAgB,aAAa,IAAI,MAAM,CAGtC"}

package/src/core/lark-ticket.js

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Request-level ticket for the Feishu plugin.
+ *
+ * Uses Node.js AsyncLocalStorage to propagate a ticket (message_id,
+ * chat_id, account_id) through the entire async call chain without passing
+ * parameters explicitly.  Call {@link withTicket} at the event entry point
+ * (monitor.ts) and use {@link getTicket} anywhere downstream.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+// ---------------------------------------------------------------------------
+// Storage
+// ---------------------------------------------------------------------------
+const store = new AsyncLocalStorage();
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Run `fn` within a ticket context.  All async operations spawned inside
+ * `fn` will inherit the context and can access it via {@link getTicket}.
+ */
+export function withTicket(ticket, fn) {
+    return store.run(ticket, fn);
+}
+/** Return the current ticket, or `undefined` if not inside withTicket. */
+export function getTicket() {
+    return store.getStore();
+}
+/** Milliseconds elapsed since the current ticket was created, or 0. */
+export function ticketElapsed() {
+    const t = store.getStore();
+    return t ? Date.now() - t.startTime : 0;
+}
+//# sourceMappingURL=lark-ticket.js.map

package/src/core/lark-ticket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lark-ticket.js","sourceRoot":"","sources":["../../../src/core/lark-ticket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAgBrD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAElD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAI,MAAkB,EAAE,EAAwB;IACxE,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,SAAS;IACvB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/src/core/message-unavailable.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * 消息不可用（已撤回/已删除）状态管理。
+ *
+ * 目标：
+ * 1) 当命中飞书终止错误码（230011/231003）时，按 message_id 标记不可用；
+ * 2) 后续针对该 message_id 的 API 调用直接短路，避免持续报错刷屏。
+ */
+import { LARK_ERROR } from './auth-errors';
+export type TerminalMessageApiCode = typeof LARK_ERROR.MESSAGE_RECALLED | typeof LARK_ERROR.MESSAGE_DELETED;
+export interface MessageUnavailableState {
+    apiCode: TerminalMessageApiCode;
+    markedAtMs: number;
+    operation?: string;
+}
+export declare function isTerminalMessageApiCode(code: unknown): code is TerminalMessageApiCode;
+export declare function markMessageUnavailable(params: {
+    messageId: string;
+    apiCode: TerminalMessageApiCode;
+    operation?: string;
+}): void;
+export declare function getMessageUnavailableState(messageId: string | undefined): MessageUnavailableState | undefined;
+export declare function isMessageUnavailable(messageId: string | undefined): boolean;
+export declare function markMessageUnavailableFromError(params: {
+    messageId: string | undefined;
+    error: unknown;
+    operation?: string;
+}): TerminalMessageApiCode | undefined;
+export declare class MessageUnavailableError extends Error {
+    readonly messageId: string;
+    readonly apiCode: TerminalMessageApiCode;
+    readonly operation?: string;
+    constructor(params: {
+        messageId: string;
+        apiCode: TerminalMessageApiCode;
+        operation?: string;
+    });
+}
+export declare function isMessageUnavailableError(error: unknown): error is MessageUnavailableError;
+export declare function assertMessageAvailable(messageId: string | undefined, operation?: string): void;
+/**
+ * 针对 message_id 的统一保护：
+ * - 调用前检查是否已标记不可用；
+ * - 调用报错后识别 230011/231003 并标记；
+ * - 命中时抛出 MessageUnavailableError 供上游快速终止流程。
+ */
+export declare function runWithMessageUnavailableGuard<T>(params: {
+    messageId: string | undefined;
+    operation: string;
+    fn: () => Promise<T>;
+}): Promise<T>;
+//# sourceMappingURL=message-unavailable.d.ts.map

package/src/core/message-unavailable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-unavailable.d.ts","sourceRoot":"","sources":["../../../src/core/message-unavailable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,eAAe,CAAC;AAInE,MAAM,MAAM,sBAAsB,GAAG,OAAO,UAAU,CAAC,gBAAgB,GAAG,OAAO,UAAU,CAAC,eAAe,CAAC;AAE5G,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,sBAAsB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAeD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,sBAAsB,CAEtF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAaP;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,uBAAuB,GAAG,SAAS,CAa7G;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE3E;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,sBAAsB,GAAG,SAAS,CAarC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,sBAAsB,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;CAU/F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAK1F;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAY9F;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAAC,CAAC,EAAE,MAAM,EAAE;IAC9D,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;CACtB,GAAG,OAAO,CAAC,CAAC,CAAC,CAyBb"}

package/src/core/message-unavailable.js

@@ -0,0 +1,131 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * 消息不可用（已撤回/已删除）状态管理。
+ *
+ * 目标：
+ * 1) 当命中飞书终止错误码（230011/231003）时，按 message_id 标记不可用；
+ * 2) 后续针对该 message_id 的 API 调用直接短路，避免持续报错刷屏。
+ */
+import { MESSAGE_TERMINAL_CODES } from './auth-errors';
+import { extractLarkApiCode } from './api-error';
+import { normalizeMessageId } from './targets';
+const UNAVAILABLE_CACHE_TTL_MS = 30 * 60 * 1000;
+const MAX_CACHE_SIZE_BEFORE_PRUNE = 512;
+const unavailableMessageCache = new Map();
+function pruneExpired(nowMs = Date.now()) {
+    for (const [messageId, state] of unavailableMessageCache) {
+        if (nowMs - state.markedAtMs > UNAVAILABLE_CACHE_TTL_MS) {
+            unavailableMessageCache.delete(messageId);
+        }
+    }
+}
+export function isTerminalMessageApiCode(code) {
+    return typeof code === 'number' && MESSAGE_TERMINAL_CODES.has(code);
+}
+export function markMessageUnavailable(params) {
+    const normalizedId = normalizeMessageId(params.messageId);
+    if (!normalizedId)
+        return;
+    if (unavailableMessageCache.size >= MAX_CACHE_SIZE_BEFORE_PRUNE) {
+        pruneExpired();
+    }
+    unavailableMessageCache.set(normalizedId, {
+        apiCode: params.apiCode,
+        operation: params.operation,
+        markedAtMs: Date.now(),
+    });
+}
+export function getMessageUnavailableState(messageId) {
+    const normalizedId = normalizeMessageId(messageId);
+    if (!normalizedId)
+        return undefined;
+    const state = unavailableMessageCache.get(normalizedId);
+    if (!state)
+        return undefined;
+    if (Date.now() - state.markedAtMs > UNAVAILABLE_CACHE_TTL_MS) {
+        unavailableMessageCache.delete(normalizedId);
+        return undefined;
+    }
+    return state;
+}
+export function isMessageUnavailable(messageId) {
+    return !!getMessageUnavailableState(messageId);
+}
+export function markMessageUnavailableFromError(params) {
+    const normalizedId = normalizeMessageId(params.messageId);
+    if (!normalizedId)
+        return undefined;
+    const code = extractLarkApiCode(params.error);
+    if (!isTerminalMessageApiCode(code))
+        return undefined;
+    markMessageUnavailable({
+        messageId: normalizedId,
+        apiCode: code,
+        operation: params.operation,
+    });
+    return code;
+}
+export class MessageUnavailableError extends Error {
+    messageId;
+    apiCode;
+    operation;
+    constructor(params) {
+        const operationText = params.operation ? `, op=${params.operation}` : '';
+        super(`[feishu-message-unavailable] message ${params.messageId} unavailable (code=${params.apiCode}${operationText})`);
+        this.name = 'MessageUnavailableError';
+        this.messageId = params.messageId;
+        this.apiCode = params.apiCode;
+        this.operation = params.operation;
+    }
+}
+export function isMessageUnavailableError(error) {
+    return (error instanceof MessageUnavailableError ||
+        (typeof error === 'object' && error !== null && error.name === 'MessageUnavailableError'));
+}
+export function assertMessageAvailable(messageId, operation) {
+    const normalizedId = normalizeMessageId(messageId);
+    if (!normalizedId)
+        return;
+    const state = getMessageUnavailableState(normalizedId);
+    if (!state)
+        return;
+    throw new MessageUnavailableError({
+        messageId: normalizedId,
+        apiCode: state.apiCode,
+        operation: operation ?? state.operation,
+    });
+}
+/**
+ * 针对 message_id 的统一保护：
+ * - 调用前检查是否已标记不可用；
+ * - 调用报错后识别 230011/231003 并标记；
+ * - 命中时抛出 MessageUnavailableError 供上游快速终止流程。
+ */
+export async function runWithMessageUnavailableGuard(params) {
+    const normalizedId = normalizeMessageId(params.messageId);
+    if (!normalizedId) {
+        return params.fn();
+    }
+    assertMessageAvailable(normalizedId, params.operation);
+    try {
+        return await params.fn();
+    }
+    catch (error) {
+        const code = markMessageUnavailableFromError({
+            messageId: normalizedId,
+            error,
+            operation: params.operation,
+        });
+        if (code) {
+            throw new MessageUnavailableError({
+                messageId: normalizedId,
+                apiCode: code,
+                operation: params.operation,
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=message-unavailable.js.map

package/src/core/message-unavailable.js.map

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

package/src/core/owner-policy.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * owner-policy.ts — 应用 Owner 访问控制策略。
+ *
+ * 从 uat-client.ts 迁移 owner 检查逻辑到独立 policy 层。
+ * 提供 fail-close 策略（安全优先：授权发起路径）。
+ */
+import type { ConfiguredLarkAccount } from './types';
+/**
+ * 非应用 owner 尝试执行 owner-only 操作时抛出。
+ *
+ * 注意：`appOwnerId` 仅用于内部日志，不应序列化到用户可见的响应中，
+ * 以避免泄露 owner 的 open_id。
+ */
+export declare class OwnerAccessDeniedError extends Error {
+    readonly userOpenId: string;
+    readonly appOwnerId: string;
+    constructor(userOpenId: string, appOwnerId: string);
+}
+/**
+ * 校验用户是否为应用 owner（fail-close 版本）。
+ *
+ * - 获取 owner 失败时 → 拒绝（安全优先）
+ * - owner 不匹配时 → 拒绝
+ *
+ * 适用于：`executeAuthorize`（OAuth 授权发起）、`commands/auth.ts`（批量授权）等
+ * 赋予实质性权限的入口。
+ */
+export declare function assertOwnerAccessStrict(account: ConfiguredLarkAccount, sdk: any, userOpenId: string): Promise<void>;
+//# sourceMappingURL=owner-policy.d.ts.map

package/src/core/owner-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-policy.d.ts","sourceRoot":"","sources":["../../../src/core/owner-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAOrD;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAMnD;AAMD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,qBAAqB,EAE9B,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/src/core/owner-policy.js

@@ -0,0 +1,53 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * owner-policy.ts — 应用 Owner 访问控制策略。
+ *
+ * 从 uat-client.ts 迁移 owner 检查逻辑到独立 policy 层。
+ * 提供 fail-close 策略（安全优先：授权发起路径）。
+ */
+import { getAppOwnerFallback } from './app-owner-fallback';
+// ---------------------------------------------------------------------------
+// Error class
+// ---------------------------------------------------------------------------
+/**
+ * 非应用 owner 尝试执行 owner-only 操作时抛出。
+ *
+ * 注意：`appOwnerId` 仅用于内部日志，不应序列化到用户可见的响应中，
+ * 以避免泄露 owner 的 open_id。
+ */
+export class OwnerAccessDeniedError extends Error {
+    userOpenId;
+    appOwnerId;
+    constructor(userOpenId, appOwnerId) {
+        super('Permission denied: Only the app owner is authorized to use this feature.');
+        this.name = 'OwnerAccessDeniedError';
+        this.userOpenId = userOpenId;
+        this.appOwnerId = appOwnerId;
+    }
+}
+// ---------------------------------------------------------------------------
+// Policy functions
+// ---------------------------------------------------------------------------
+/**
+ * 校验用户是否为应用 owner（fail-close 版本）。
+ *
+ * - 获取 owner 失败时 → 拒绝（安全优先）
+ * - owner 不匹配时 → 拒绝
+ *
+ * 适用于：`executeAuthorize`（OAuth 授权发起）、`commands/auth.ts`（批量授权）等
+ * 赋予实质性权限的入口。
+ */
+export async function assertOwnerAccessStrict(account, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+sdk, userOpenId) {
+    const ownerOpenId = await getAppOwnerFallback(account, sdk);
+    if (!ownerOpenId) {
+        throw new OwnerAccessDeniedError(userOpenId, 'unknown');
+    }
+    if (ownerOpenId !== userOpenId) {
+        throw new OwnerAccessDeniedError(userOpenId, ownerOpenId);
+    }
+}
+//# sourceMappingURL=owner-policy.js.map

package/src/core/owner-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-policy.js","sourceRoot":"","sources":["../../../src/core/owner-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,UAAU,CAAS;IACnB,UAAU,CAAS;IAE5B,YAAY,UAAkB,EAAE,UAAkB;QAChD,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAA8B;AAC9B,8DAA8D;AAC9D,GAAQ,EACR,UAAkB;IAElB,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE5D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,sBAAsB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,sBAAsB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/src/core/permission-url.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Permission URL extraction utilities.
+ *
+ * Shared functions for extracting and processing permission grant URLs
+ * from Feishu API error messages.
+ */
+/**
+ * Extract permission grant URL from a Feishu error message and optimize it
+ * by keeping only the highest-priority permission.
+ *
+ * @param msg - The error message containing the grant URL
+ * @returns The optimized grant URL with single permission, or empty string if not found
+ */
+export declare function extractPermissionGrantUrl(msg: string): string;
+/**
+ * Extract permission scopes from a Feishu error message.
+ * Looks for scopes in the format [scope1,scope2,...]
+ */
+export declare function extractPermissionScopes(msg: string): string;
+//# sourceMappingURL=permission-url.d.ts.map

package/src/core/permission-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-url.d.ts","sourceRoot":"","sources":["../../../src/core/permission-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmCH;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB7D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/src/core/permission-url.js

@@ -0,0 +1,73 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Permission URL extraction utilities.
+ *
+ * Shared functions for extracting and processing permission grant URLs
+ * from Feishu API error messages.
+ */
+// ---------------------------------------------------------------------------
+// Permission priority
+// ---------------------------------------------------------------------------
+/**
+ * Permission priority for sorting.
+ * Lower number = higher priority.
+ * - read: 1 (highest)
+ * - write: 2
+ * - other / both read+write: 3 (lowest)
+ */
+function getPermissionPriority(scope) {
+    const lowerScope = scope.toLowerCase();
+    const hasRead = lowerScope.includes('read');
+    const hasWrite = lowerScope.includes('write');
+    if (hasRead && !hasWrite)
+        return 1;
+    if (hasWrite && !hasRead)
+        return 2;
+    return 3;
+}
+/**
+ * Extract the highest-priority permission from a scope list.
+ * Returns the permission with the lowest priority number (read > write > other).
+ */
+function extractHighestPriorityScope(scopeList) {
+    return scopeList.split(',').sort((a, b) => getPermissionPriority(a) - getPermissionPriority(b))[0] ?? '';
+}
+// ---------------------------------------------------------------------------
+// Permission URL extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract permission grant URL from a Feishu error message and optimize it
+ * by keeping only the highest-priority permission.
+ *
+ * @param msg - The error message containing the grant URL
+ * @returns The optimized grant URL with single permission, or empty string if not found
+ */
+export function extractPermissionGrantUrl(msg) {
+    const urlMatch = msg.match(/https:\/\/[^\s]+\/app\/[^\s]+/);
+    if (!urlMatch?.[0]) {
+        return '';
+    }
+    try {
+        const url = new URL(urlMatch[0]);
+        const scopeListParam = url.searchParams.get('q') ?? '';
+        const firstScope = extractHighestPriorityScope(scopeListParam);
+        if (firstScope) {
+            url.searchParams.set('q', firstScope);
+        }
+        return url.href;
+    }
+    catch {
+        return urlMatch[0];
+    }
+}
+/**
+ * Extract permission scopes from a Feishu error message.
+ * Looks for scopes in the format [scope1,scope2,...]
+ */
+export function extractPermissionScopes(msg) {
+    const scopeMatch = msg.match(/\[([^\]]+)\]/);
+    return scopeMatch?.[1] ?? 'unknown';
+}
+//# sourceMappingURL=permission-url.js.map

package/src/core/permission-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-url.js","sourceRoot":"","sources":["../../../src/core/permission-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,KAAa;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE9C,IAAI,OAAO,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC;IACnC,IAAI,QAAQ,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,SAAS,2BAA2B,CAAC,SAAiB;IACpD,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3G,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,cAAc,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;QAC/D,IAAI,UAAU,EAAE,CAAC;YACf,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7C,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AACtC,CAAC"}

package/src/core/raw-request.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * raw-request.ts — 飞书 Open API 裸 HTTP 请求工具。
+ *
+ * 从 tool-client.ts 提取，提供不依赖 SDK 的直接 API 调用能力。
+ * 用于 SDK 未覆盖的 API 或需要精细控制请求的场景。
+ */
+import type { LarkBrand } from './types';
+/** 将 LarkBrand 映射为 API base URL。 */
+export declare function resolveDomainUrl(brand: LarkBrand): string;
+export interface RawLarkRequestOptions {
+    brand: LarkBrand;
+    path: string;
+    method?: string;
+    body?: unknown;
+    query?: Record<string, string>;
+    headers?: Record<string, string>;
+    accessToken?: string;
+}
+/**
+ * 发起 raw HTTP 请求到飞书 API，自动处理域名解析、header 注入和错误检测。
+ *
+ * 飞书 API 统一错误模式：返回 JSON 中 `code !== 0` 表示失败。
+ */
+export declare function rawLarkRequest<T>(options: RawLarkRequestOptions): Promise<T>;
+//# sourceMappingURL=raw-request.d.ts.map

package/src/core/raw-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-request.d.ts","sourceRoot":"","sources":["../../../src/core/raw-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAOzC,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAMzD;AAMD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,CAAC,CAAC,CAwClF"}

package/src/core/raw-request.js

@@ -0,0 +1,63 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * raw-request.ts — 飞书 Open API 裸 HTTP 请求工具。
+ *
+ * 从 tool-client.ts 提取，提供不依赖 SDK 的直接 API 调用能力。
+ * 用于 SDK 未覆盖的 API 或需要精细控制请求的场景。
+ */
+import { feishuFetch } from './feishu-fetch';
+// ---------------------------------------------------------------------------
+// Domain URL resolution
+// ---------------------------------------------------------------------------
+/** 将 LarkBrand 映射为 API base URL。 */
+export function resolveDomainUrl(brand) {
+    const map = {
+        feishu: 'https://open.feishu.cn',
+        lark: 'https://open.larksuite.com',
+    };
+    return map[brand] ?? `https://${brand}`;
+}
+/**
+ * 发起 raw HTTP 请求到飞书 API，自动处理域名解析、header 注入和错误检测。
+ *
+ * 飞书 API 统一错误模式：返回 JSON 中 `code !== 0` 表示失败。
+ */
+export async function rawLarkRequest(options) {
+    const baseUrl = resolveDomainUrl(options.brand);
+    const url = new URL(options.path, baseUrl);
+    if (options.query) {
+        for (const [k, v] of Object.entries(options.query)) {
+            url.searchParams.set(k, v);
+        }
+    }
+    const headers = {};
+    if (options.accessToken) {
+        headers['Authorization'] = `Bearer ${options.accessToken}`;
+    }
+    if (options.body !== undefined) {
+        headers['Content-Type'] = 'application/json';
+    }
+    if (options.headers) {
+        Object.assign(headers, options.headers);
+    }
+    const resp = await feishuFetch(url.toString(), {
+        method: options.method ?? 'GET',
+        headers,
+        ...(options.body !== undefined ? { body: JSON.stringify(options.body) } : {}),
+    });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const data = (await resp.json());
+    // 飞书 API 统一错误模式：code !== 0
+    if (data.code !== undefined && data.code !== 0) {
+        const err = new Error(data.msg ?? `Lark API error: code=${data.code}`);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        err.code = data.code;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        err.msg = data.msg;
+        throw err;
+    }
+    return data;
+}
+//# sourceMappingURL=raw-request.js.map

package/src/core/raw-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-request.js","sourceRoot":"","sources":["../../../src/core/raw-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,oCAAoC;AACpC,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC/C,MAAM,GAAG,GAA2B;QAClC,MAAM,EAAE,wBAAwB;QAChC,IAAI,EAAE,4BAA4B;KACnC,CAAC;IACF,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,WAAW,KAAK,EAAE,CAAC;AAC1C,CAAC;AAgBD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,OAA8B;IACpE,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,OAAO,CAAC,WAAW,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;QAC7C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9E,CAAC,CAAC;IAEH,8DAA8D;IAC9D,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAQ,CAAC;IAExC,2BAA2B;IAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,wBAAwB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACvE,8DAA8D;QAC7D,GAAW,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAC9B,8DAA8D;QAC7D,GAAW,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAC5B,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,IAAS,CAAC;AACnB,CAAC"}