/**
 * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
 * SPDX-License-Identifier: MIT
 *
 * Interactive card building for Feishu/Lark.
 *
 * Provides utilities to construct Feishu Interactive Message Cards for
 * different agent response states (thinking, streaming, complete, confirm).
 */
/**
 * Element ID used for the streaming text area in cards. The CardKit
 * `cardElement.content()` API targets this element for typewriter-effect
 * streaming updates.
 */
export declare const STREAMING_ELEMENT_ID = "streaming_content";
export declare const REASONING_ELEMENT_ID = "reasoning_content";
export interface ToolCallInfo {
    name: string;
    status: "running" | "complete" | "error";
    args?: Record<string, unknown>;
    result?: string;
}
export interface CardElement {
    tag: string;
    [key: string]: unknown;
}
export interface FeishuCard {
    config: {
        wide_screen_mode: boolean;
        update_multi?: boolean;
        summary?: {
            content: string;
        };
    };
    header?: {
        title: {
            tag: "plain_text";
            content: string;
        };
        template: string;
    };
    elements: CardElement[];
}
export type CardState = "thinking" | "streaming" | "complete" | "confirm";
export interface ConfirmData {
    operationDescription: string;
    pendingOperationId: string;
    preview?: string;
}
/**
 * Split a payload text into optional `reasoningText` and `answerText`.
 *
 * Handles two formats produced by the framework:
 * 1. "Reasoning:\n_italic line_\n…" prefix (from `formatReasoningMessage`)
 * 2. `<think>…</think>` / `<thinking>…</thinking>` XML tags
 *
 * Equivalent to the framework's `splitTelegramReasoningText()`.
 */
export declare function splitReasoningText(text?: string): {
    reasoningText?: string;
    answerText?: string;
};
/**
 * Strip reasoning blocks — both XML tags with their content and any
 * "Reasoning:\n" prefixed content.
 */
export declare function stripReasoningTags(text: string): string;
/**
 * Format reasoning duration into a human-readable string.
 * e.g. "Thought for 3.2s" or "Thought for 1m 15s"
 */
export declare function formatReasoningDuration(ms: number): string;
/**
 * Format milliseconds into a human-readable duration string.
 */
export declare function formatElapsed(ms: number): string;
/**
 * Build a full Feishu Interactive Message Card JSON object for the
 * given state.
 */
export declare function buildCardContent(state: CardState, data?: {
    text?: string;
    reasoningText?: string;
    reasoningElapsedMs?: number;
    toolCalls?: ToolCallInfo[];
    confirmData?: ConfirmData;
    elapsedMs?: number;
    isError?: boolean;
    isAborted?: boolean;
    footer?: {
        status?: boolean;
        elapsed?: boolean;
    };
}): FeishuCard;
/**
 * Convert an old-format FeishuCard to CardKit JSON 2.0 format.
 * JSON 2.0 uses `body.elements` instead of top-level `elements`.
 */
export declare function toCardKit2(card: FeishuCard): Record<string, unknown>;
//# sourceMappingURL=builder.d.ts.map