senderPending: 0,

} as const;

export interface BuildFrameworkSlashContextInput {

interface BuildFrameworkSlashContextInput {

ctx: PluginCommandContext;

account: ResolvedQQBotAccount;

from: QQBotFromParseResult;

const UNEXPECTED_RESULT_TEXT = "⚠️ 命令返回了意外结果。";

export interface FrameworkSlashReply {

interface FrameworkSlashReply {

text: string;

}

export interface DispatchFrameworkSlashResultInput {

interface DispatchFrameworkSlashResultInput {

result: SlashCommandResult;

account: ResolvedQQBotAccount;

from: QQBotFromParseResult;

* engine's `debugLog` so that all logs flow through the OpenClaw log system.

*/

export interface BridgeLogger {

interface BridgeLogger {

info: (msg: string) => void;

error: (msg: string) => void;

warn?: (msg: string) => void;

type QQBotGroupPolicy,

} from "./types.js";

export interface QQBotAccessInput extends EffectivePolicyInput {

interface QQBotAccessInput extends EffectivePolicyInput {

/** Whether the inbound originated in a group (or guild) chat. */

isGroup: boolean;

/** The raw inbound sender id as provided by the QQ event. */

const DEFAULT_TIMEOUT_MS = 30_000;

const FILE_UPLOAD_TIMEOUT_MS = 120_000;

export interface RequestOptions {

interface RequestOptions {

/** Request timeout override in milliseconds. */

timeoutMs?: number;

/** Body keys to redact in debug logs (e.g. `['file_data']`). */

}

/** Chunked-upload progress callback payload. */

export interface ChunkedUploadProgress {

interface ChunkedUploadProgress {

completedParts: number;

totalParts: number;

uploadedBytes: number;

totalBytes: number;

}

/** Per-call options for {@link ChunkedMediaApi.uploadChunked}. */

export interface UploadChunkedOptions {

interface UploadChunkedOptions {

scope: ChatScope;

targetId: string;

fileType: MediaFileType;

}

/** Configuration for the {@link ChunkedMediaApi} constructor. */

export interface ChunkedMediaApiConfig {

interface ChunkedMediaApiConfig {

logger?: EngineLogger;

/** Upload cache adapter (optional; omit to disable caching). */

uploadCache?: UploadCacheAdapter;

/** File name sanitizer — injected to avoid importing platform-specific utils. */

export type SanitizeFileNameFn = (name: string) => string;

export interface MediaApiConfig {

interface MediaApiConfig {

logger?: EngineLogger;

/** Upload cache adapter (optional, omit to disable caching). */

uploadCache?: UploadCacheAdapter;

} from "./routes.js";

import { TokenManager } from "./token.js";

export interface MessageApiConfig {

interface MessageApiConfig {

/** Whether the QQ Bot has markdown permission. */

markdownSupport: boolean;

/** Logger for diagnostics. */

import { formatErrorMessage } from "../utils/format.js";

/** Standard retry policy with exponential or fixed backoff. */

export interface RetryPolicy {

interface RetryPolicy {

/** Maximum retry attempts (excluding the initial attempt). */

maxRetries: number;

/** Base delay in milliseconds. */

* the standard retry loop into a tight fixed-interval loop bounded

* only by the total timeout.

*/

export interface PersistentRetryPolicy {

interface PersistentRetryPolicy {

/** Total timeout in milliseconds for the persistent retry loop. */

timeoutMs: number;

/** Fixed interval between retries in milliseconds. */

appId: string;

}

export interface BackgroundRefreshOptions {

interface BackgroundRefreshOptions {

refreshAheadMs?: number;

randomOffsetMs?: number;

minRefreshIntervalMs?: number;