opencode-pollinations-plugin 6.1.0-beta.2 → 6.1.0-beta.22

package/dist/tools/pollinations/shared.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Shared utilities for Pollinations API tools
+ *
+ * Updated: 2026-02-18 - Sprint 2: Dynamic ModelRegistry integration
+ * Hardcoded model lists replaced by ModelRegistry lookups with static fallback.
+ */
+export interface PollinationsConfig {
+    apiKey?: string;
+    mode?: string;
+}
+export interface ModelInfo {
+    name: string;
+    pricing: {
+        currency: string;
+        completionImageTokens?: number;
+        completionVideoSeconds?: number;
+        completionVideoTokens?: number;
+        completionAudioTokens?: number;
+        completionAudioSeconds?: number;
+        promptAudioSeconds?: number;
+        promptTextTokens?: number;
+        completionTextTokens?: number;
+    };
+    paid_only?: boolean;
+    input_modalities?: string[];
+    output_modalities?: string[];
+    description?: string;
+}
+export interface GenerationResult {
+    success: boolean;
+    url?: string;
+    localPath?: string;
+    cost: number;
+    model: string;
+    error?: string;
+}
+export interface CostTracking {
+    imageTokens?: number;
+    videoSeconds?: number;
+    videoTokens?: number;
+    costUsd?: number;
+    modelUsed?: string;
+    requestId?: string;
+}
+export declare function getApiKey(): string | undefined;
+export declare function hasApiKey(): boolean;
+/**
+ * FREE Image Models (DEPRECATED - image.pollinations.ai is dead)
+ */
+export declare const FREE_IMAGE_MODELS: {};
+/**
+ * Dynamic Paid Image Models accessor.
+ * Returns data from ModelRegistry if ready, otherwise falls back to static data.
+ *
+ * BACKWARD COMPATIBLE: Same shape as the old hardcoded PAID_IMAGE_MODELS
+ */
+export declare function getPaidImageModels(): Record<string, {
+    desc: string;
+    cost: string;
+    t2i: boolean;
+    i2i: boolean;
+    params: string[];
+    notes?: string;
+}>;
+/**
+ * Dynamic Video Models accessor.
+ * BACKWARD COMPATIBLE: Same shape as old VIDEO_MODELS
+ */
+export declare function getVideoModels(): Record<string, {
+    desc: string;
+    cost: string;
+    t2v: boolean;
+    i2v: boolean;
+    audio: boolean;
+    duration: [number, number];
+    aspectRatios: string[];
+    costHeader: string;
+    genTime: string;
+}>;
+/**
+ * Dynamic Audio Models accessor.
+ * BACKWARD COMPATIBLE: Same shape as old AUDIO_MODELS
+ */
+export declare function getAudioModels(): Record<string, {
+    desc: string;
+    type: 'tts' | 'stt' | 'both';
+    endpoint: string;
+    params: string[];
+    voices?: string[];
+    notes?: string;
+}>;
+/**
+ * Music Model accessor (backward compatible)
+ */
+export declare function getMusicModel(): Record<string, {
+    desc: string;
+    endpoint: string;
+    params: string[];
+    duration: [number, number];
+}>;
+export declare function httpsGet(url: string, headers?: Record<string, string>): Promise<{
+    data: Buffer;
+    headers: Record<string, string>;
+}>;
+export declare function httpsPost(url: string, body: any, headers?: Record<string, string>): Promise<{
+    data: Buffer;
+    headers: Record<string, string>;
+}>;
+/**
+ * Multipart POST for file uploads (STT)
+ */
+export declare function httpsPostMultipart(url: string, fields: Record<string, string | Buffer>, headers?: Record<string, string>): Promise<{
+    data: Buffer;
+    headers: Record<string, string>;
+}>;
+/**
+ * @deprecated Use ModelRegistry.list() directly
+ */
+export declare function fetchModels(type: 'image' | 'audio' | 'text'): Promise<ModelInfo[]>;
+/**
+ * @deprecated Use ModelRegistry.get() directly
+ */
+export declare function getModelInfo(type: 'image' | 'audio' | 'text', name: string): Promise<ModelInfo | undefined>;
+/**
+ * Extract cost tracking from response headers
+ */
+export declare function extractCostFromHeaders(headers: Record<string, string>): CostTracking;
+/**
+ * Fetch current Enter balance (`/account/balance`) for Real Cost calculation.
+ */
+export declare function fetchEnterBalance(): Promise<number | null>;
+/**
+ * Check if cost estimator is enabled in config
+ */
+export declare function isCostEstimatorEnabled(): boolean;
+export declare function per1pollen(cost: number | null): string;
+export declare function estimateImageCost(model: string): number;
+export declare function estimateVideoCost(model: string, duration: number): number;
+export declare function estimateTtsCost(textLength: number): number;
+export declare function estimateMusicCost(duration: number): number;
+export declare function ensureDir(dir: string): void;
+export declare function generateFilename(type: string, model: string, ext: string): string;
+export declare function getDefaultOutputDir(type: string): string;
+export declare function formatCost(cost: number): string;
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Check if model supports Image-to-Image
+ */
+export declare function supportsI2I(model: string): boolean;
+/**
+ * Check if video model supports Image-to-Video
+ */
+export declare function supportsI2V(model: string): boolean;
+/**
+ * Check if video model requires Image-to-Video (no T2V)
+ */
+export declare function requiresI2V(model: string): boolean;
+/**
+ * Validate aspect ratio for video model
+ */
+export declare function validateAspectRatio(model: string, ratio: string): boolean;
+/**
+ * Get valid duration range for video model
+ */
+export declare function getDurationRange(model: string): [number, number];