/**
 * 企业微信渠道类型定义
 */
import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
import type { ResolvedWeComAccount } from "./utils.js";
import { WeComCommand } from "./const.js";
/**
 * Monitor 配置选项
 */
export type WeComMonitorOptions = {
    account: ResolvedWeComAccount;
    config: OpenClawConfig;
    runtime: RuntimeEnv;
    abortSignal?: AbortSignal;
    /** 框架层提供的状态更新回调，用于在致命错误场景中标记 channel 已停止 */
    setStatus?: (next: Record<string, unknown>) => void;
};
/**
 * 消息状态
 */
export interface MessageState {
    accumulatedText: string;
    /** 流式回复的 streamId，用于保持同一个流式回复使用相同的 streamId */
    streamId?: string;
    /** 是否已成功发送过媒体文件 */
    hasMedia?: boolean;
    /** 是否有媒体发送失败（权限不足、文件过大等） */
    hasMediaFailed?: boolean;
    /** 媒体发送失败时的纯文本错误摘要（用于替换 thinking 流展示给用户） */
    mediaErrorSummary?: string;
    /** 流式回复是否已过期（errcode 846608，>6分钟），需降级为主动发送 */
    streamExpired?: boolean;
    /** 是否已成功发送过模板卡片 */
    hasTemplateCard?: boolean;
}
/** 从文本中提取的模板卡片 */
export interface ExtractedTemplateCard {
    /** 原始 JSON 对象（已验证 card_type 合法） */
    cardJson: Record<string, unknown>;
    /** card_type 值 */
    cardType: string;
}
/** extractTemplateCards 返回值 */
export interface TemplateCardExtractionResult {
    /** 提取到的合法模板卡片列表 */
    cards: ExtractedTemplateCard[];
    /** 移除卡片代码块后的剩余文本 */
    remainingText: string;
}
/**
 * WebSocket 请求消息基础格式
 */
export interface WeComRequest {
    cmd: string;
    headers: {
        req_id: string;
    };
    body: any;
}
/**
 * WebSocket 响应消息格式
 */
export interface WeComResponse {
    headers: {
        req_id: string;
    };
    errcode: number;
    errmsg: string;
}
/**
 * 企业微信认证请求
 */
export interface WeComSubscribeRequest extends WeComRequest {
    cmd: WeComCommand.SUBSCRIBE;
    body: {
        secret: string;
        bot_id: string;
    };
}
/**
 * 企业微信推送消息格式
 */
export interface WeComCallbackMessage {
    cmd: WeComCommand.AIBOT_CALLBACK | "aibot_event_callback";
    headers: {
        req_id: string;
    };
    body: {
        msgid: string;
        aibotid: string;
        chatid?: string;
        chattype: "single" | "group";
        from: {
            userid: string;
        };
        response_url: string;
        msgtype: "text" | "image" | "voice" | "video" | "file" | "stream" | "mixed" | "event";
        text?: {
            content: string;
        };
        image?: {
            /** 图片 URL（通过 URL 方式接收图片时） */
            url?: string;
            /** 图片 base64 数据（直接传输时） */
            base64?: string;
            md5?: string;
        };
        /** 图文混排消息 */
        mixed?: {
            msg_item: Array<{
                msgtype: "text" | "image";
                text?: {
                    content: string;
                };
                image?: {
                    url?: string;
                    base64?: string;
                    md5?: string;
                };
            }>;
        };
        quote?: {
            msgtype: string;
            text?: {
                content: string;
            };
            image?: {
                url?: string;
                aeskey?: string;
            };
            file?: {
                url?: string;
                aeskey?: string;
            };
        };
        stream?: {
            id: string;
        };
        event?: {
            eventtype: string;
            template_card_event?: {
                card_type?: string;
                event_key?: string;
                task_id?: string;
                selected_items?: {
                    selected_item?: Array<{
                        question_key?: string;
                        option_ids?: {
                            option_id?: string[];
                        };
                    }>;
                };
            };
        };
    };
}
/**
 * 企业微信响应消息格式
 */
export interface WeComResponseMessage extends WeComRequest {
    cmd: WeComCommand.AIBOT_RESPONSE;
    body: {
        msgtype: "stream" | "text" | "markdown";
        stream?: {
            id: string;
            finish: boolean;
            content: string;
            msg_item?: Array<{
                msgtype: "image" | "file";
                image?: {
                    base64: string;
                    md5: string;
                };
            }>;
            feedback?: {
                id: string;
            };
        };
        text?: {
            content: string;
        };
        markdown?: {
            content: string;
        };
    };
}