@gguf/claw/dist/plugin-sdk/telegram/model-buttons.d.ts

Multi-channel AI gateway with extensible messaging integrations

/**
 * Telegram inline button utilities for model selection.
 *
 * Callback data patterns (max 64 bytes for Telegram):
 * - mdl_prov              - show providers list
 * - mdl_list_{prov}_{pg}  - show models for provider (page N, 1-indexed)
 * - mdl_sel_{provider/id} - select model
 * - mdl_back              - back to providers list
 */
export type ButtonRow = Array<{
    text: string;
    callback_data: string;
}>;
export type ParsedModelCallback = {
    type: "providers";
} | {
    type: "list";
    provider: string;
    page: number;
} | {
    type: "select";
    provider: string;
    model: string;
} | {
    type: "back";
};
export type ProviderInfo = {
    id: string;
    count: number;
};
export type ModelsKeyboardParams = {
    provider: string;
    models: string[];
    currentModel?: string;
    currentPage: number;
    totalPages: number;
    pageSize?: number;
};
/**
 * Parse a model callback_data string into a structured object.
 * Returns null if the data doesn't match a known pattern.
 */
export declare function parseModelCallbackData(data: string): ParsedModelCallback | null;
/**
 * Build provider selection keyboard with 2 providers per row.
 */
export declare function buildProviderKeyboard(providers: ProviderInfo[]): ButtonRow[];
/**
 * Build model list keyboard with pagination and back button.
 */
export declare function buildModelsKeyboard(params: ModelsKeyboardParams): ButtonRow[];
/**
 * Build "Browse providers" button for /model summary.
 */
export declare function buildBrowseProvidersButton(): ButtonRow[];
/**
 * Get page size for model list pagination.
 */
export declare function getModelsPageSize(): number;
/**
 * Calculate total pages for a model list.
 */
export declare function calculateTotalPages(totalModels: number, pageSize?: number): number;