@tyvm/knowhow 0.0.69 → 0.0.70

package/src/clients/pricing/anthropic.ts

@@ -0,0 +1,90 @@
+import { Models } from "../../types";
+
+export const AnthropicTextPricing = {
+  [Models.anthropic.Opus4_6]: {
+    input: 5.0,
+    input_gt_200k: 10.0,
+    cache_write: 6.25,
+    cache_hit: 0.5,
+    output: 25.0,
+    output_gt_200k: 37.5,
+  },
+  [Models.anthropic.Sonnet4_6]: {
+    input: 3.0,
+    input_gt_200k: 6.0,
+    cache_write: 3.75,
+    cache_hit: 0.3,
+    output: 15.0,
+    output_gt_200k: 22.5,
+  },
+  [Models.anthropic.Opus4_5]: {
+    input: 5.0,
+    cache_write: 6.25,
+    cache_hit: 0.5,
+    output: 25.0,
+  },
+  [Models.anthropic.Opus4_1]: {
+    input: 15.0,
+    cache_write: 18.75,
+    cache_hit: 1.5,
+    output: 75.0,
+  },
+  [Models.anthropic.Opus4]: {
+    input: 15.0,
+    cache_write: 18.75,
+    cache_hit: 1.5,
+    output: 75.0,
+  },
+  [Models.anthropic.Sonnet4]: {
+    input: 3.0,
+    input_gt_200k: 6.0,
+    cache_write: 3.75,
+    cache_hit: 0.3,
+    output: 15.0,
+    output_gt_200k: 22.5,
+  },
+  [Models.anthropic.Sonnet4_5]: {
+    input: 3.0,
+    input_gt_200k: 6.0,
+    cache_write: 3.75,
+    cache_hit: 0.3,
+    output: 15.0,
+    output_gt_200k: 22.5,
+  },
+  [Models.anthropic.Haiku4_5]: {
+    input: 1,
+    cache_write: 1.25,
+    cache_hit: 0.1,
+    output: 5,
+  },
+  [Models.anthropic.Sonnet3_7]: {
+    input: 3.0,
+    cache_write: 3.75,
+    cache_hit: 0.3,
+    output: 15.0,
+  },
+  [Models.anthropic.Sonnet3_5]: {
+    input: 3.0,
+    cache_write: 3.75,
+    cache_hit: 0.3,
+    output: 15.0,
+  },
+  [Models.anthropic.Haiku3_5]: {
+    input: 0.8,
+    cache_write: 1.0,
+    cache_hit: 0.08,
+    output: 4.0,
+  },
+  [Models.anthropic.Opus3]: {
+    input: 15.0,
+    cache_write: 18.75,
+    cache_hit: 1.5,
+    output: 75.0,
+  },
+  [Models.anthropic.Haiku3]: {
+    input: 0.25,
+    cache_write: 0.3125,
+    cache_hit: 0.025,
+    output: 1.25,
+  },
+};

package/src/clients/pricing/google.ts

@@ -0,0 +1,65 @@
+import { Models, EmbeddingModels } from "../../types";
+
+export const GeminiTextPricing = {
+  [Models.google.Gemini_3_Preview]: {
+    input: 2,
+    input_gt_200k: 4,
+    output: 12,
+    output_gt_200k: 18,
+    context_caching: 0.2,
+    context_caching_gt_200k: 0.4,
+  },
+  [Models.google.Gemini_25_Flash_Preview]: {
+    input: 0.3,
+    output: 2.5,
+    thinking_output: 3.5,
+    context_caching: 0.0375,
+  },
+  [Models.google.Gemini_25_Pro_Preview]: {
+    input: 1.25,
+    input_gt_200k: 2.5,
+    output: 10.0,
+    output_gt_200k: 15.0,
+    context_caching: 0.125,
+    context_caching_gt_200k: 0.25,
+  },
+  [Models.google.Gemini_20_Flash]: {
+    input: 0.1,
+    output: 0.4,
+    context_caching: 0.025,
+  },
+  [Models.google.Gemini_20_Flash_Preview_Image_Generation]: {
+    input: 0.1,
+    output: 0.4,
+    image_generation: 0.039,
+  },
+  [Models.google.Gemini_20_Flash_Lite]: {
+    input: 0.075,
+    output: 0.3,
+  },
+  [Models.google.Gemini_15_Flash]: {
+    input: 0.075,
+    output: 0.3,
+    context_caching: 0.01875,
+  },
+  [Models.google.Gemini_15_Flash_8B]: {
+    input: 0.0375,
+    output: 0.15,
+    context_caching: 0.01,
+  },
+  [Models.google.Gemini_15_Pro]: {
+    input: 1.25,
+    output: 5.0,
+    context_caching: 0.3125,
+  },
+  [Models.google.Imagen_3]: {
+    image_generation: 0.03,
+  },
+  [Models.google.Veo_2]: {
+    video_generation: 0.35,
+  },
+  [EmbeddingModels.google.Gemini_Embedding]: {
+    input: 0, // Free of charge
+    output: 0, // Free of charge
+  },
+};

package/src/clients/pricing/index.ts

@@ -0,0 +1,4 @@
+export { OpenAiTextPricing } from "./openai";
+export { GeminiTextPricing } from "./google";
+export { AnthropicTextPricing } from "./anthropic";
+export { XaiTextPricing, XaiImagePricing, XaiVideoPricing } from "./xai";

package/src/clients/pricing/openai.ts

@@ -0,0 +1,134 @@
+import { Models, EmbeddingModels } from "../../types";
+
+export const OpenAiTextPricing = {
+  [Models.openai.GPT_4o]: {
+    input: 2.5,
+    cached_input: 1.25,
+    output: 10.0,
+  },
+  [Models.openai.GPT_4o_Mini]: {
+    input: 0.15,
+    cached_input: 0.075,
+    output: 0.6,
+  },
+  [Models.openai.o1]: {
+    input: 15.0,
+    cached_input: 7.5,
+    output: 60.0,
+  },
+  [Models.openai.o1_Mini]: {
+    input: 1.1,
+    cached_input: 0.55,
+    output: 4.4,
+  },
+  [Models.openai.o3_Mini]: {
+    input: 1.1,
+    cached_input: 0.55,
+    output: 4.4,
+  },
+  [Models.openai.GPT_41]: {
+    input: 2.0,
+    cached_input: 0.5,
+    output: 8.0,
+  },
+  [Models.openai.GPT_41_Mini]: {
+    input: 0.4,
+    cached_input: 0.1,
+    output: 1.6,
+  },
+  [Models.openai.GPT_41_Nano]: {
+    input: 0.1,
+    cached_input: 0.025,
+    output: 0.4,
+  },
+  [Models.openai.GPT_45]: {
+    input: 75.0,
+    cached_input: 37.5,
+    output: 150.0,
+  },
+  [Models.openai.GPT_4o_Audio]: {
+    input: 2.5,
+    cached_input: 0,
+    output: 10.0,
+  },
+  [Models.openai.GPT_4o_Realtime]: {
+    input: 5.0,
+    cached_input: 2.5,
+    output: 20.0,
+  },
+  [Models.openai.GPT_4o_Mini_Audio]: {
+    input: 0.15,
+    cached_input: 0,
+    output: 0.6,
+  },
+  [Models.openai.GPT_4o_Mini_Realtime]: {
+    input: 0.6,
+    cached_input: 0.3,
+    output: 2.4,
+  },
+  [Models.openai.o1_Pro]: {
+    input: 150.0,
+    cached_input: 0,
+    output: 600.0,
+  },
+  [Models.openai.o3]: {
+    input: 2.0,
+    cached_input: 0.5,
+    output: 8.0,
+  },
+  [Models.openai.o4_Mini]: {
+    input: 1.1,
+    cached_input: 0.275,
+    output: 4.4,
+  },
+  [Models.openai.GPT_4o_Mini_Search]: {
+    input: 0.15,
+    cached_input: 0,
+    output: 0.6,
+  },
+  [Models.openai.GPT_4o_Search]: {
+    input: 2.5,
+    cached_input: 0,
+    output: 10.0,
+  },
+  [Models.openai.GPT_5_2]: {
+    input: 1.75,
+    cached_input: 0.175,
+    output: 14,
+  },
+  [Models.openai.GPT_5_1]: {
+    input: 1.25,
+    cached_input: 0.125,
+    output: 10,
+  },
+  [Models.openai.GPT_5]: {
+    input: 1.25,
+    cached_input: 0.125,
+    output: 10,
+  },
+  [Models.openai.GPT_5_Mini]: {
+    input: 0.25,
+    cached_input: 0.025,
+    output: 2,
+  },
+  [Models.openai.GPT_5_Nano]: {
+    input: 0.05,
+    cached_input: 0.005,
+    output: 0.4,
+  },
+  [EmbeddingModels.openai.EmbeddingAda2]: {
+    input: 0.1,
+    cached_input: 0,
+    output: 0,
+  },
+  [EmbeddingModels.openai.EmbeddingLarge3]: {
+    input: 0.13,
+    cached_input: 0,
+    output: 0,
+  },
+  [EmbeddingModels.openai.EmbeddingSmall3]: {
+    input: 0.02,
+    cached_input: 0,
+    output: 0,
+  },
+};

package/src/clients/pricing/xai.ts

@@ -0,0 +1,62 @@
+import { Models } from "../../types";
+
+export const XaiTextPricing = {
+  [Models.xai.Grok4_1_Fast_NonReasoning]: {
+    input: 0.2,
+    cache_hit: 0.05,
+    output: 0.5,
+  },
+  [Models.xai.Grok4_1_Fast_Reasoning]: {
+    input: 0.2,
+    cache_hit: 0.05,
+    output: 0.5,
+  },
+  [Models.xai.GrokCodeFast]: {
+    input: 0.2,
+    cache_hit: 0.02,
+    output: 1.5,
+  },
+  [Models.xai.Grok4]: {
+    input: 3.0,
+    output: 15.0,
+  },
+  [Models.xai.Grok3Beta]: {
+    input: 3.0,
+    output: 15.0,
+  },
+  [Models.xai.Grok3MiniBeta]: {
+    input: 0.3,
+    output: 0.5,
+  },
+  [Models.xai.Grok3FastBeta]: {
+    input: 5.0,
+    output: 25.0,
+  },
+  [Models.xai.Grok3MiniFastBeta]: {
+    input: 0.6,
+    output: 4.0,
+  },
+  [Models.xai.Grok21212]: {
+    input: 2.0,
+    output: 10.0,
+  },
+  [Models.xai.Grok2Vision1212]: {
+    input: 2.0,
+    output: 10.0,
+    image_input: 2.0,
+  },
+};
+
+// Image generation pricing: per image
+// Based on https://docs.x.ai/developers/models
+export const XaiImagePricing = {
+  "grok-imagine-image-pro": 0.07,
+  "grok-imagine-image": 0.02,
+  "grok-2-image-1212": 0.07,
+};
+
+// Video generation pricing: $0.05 per second
+// Based on https://docs.x.ai/developers/models
+export const XaiVideoPricing = {
+  "grok-imagine-video": 0.05, // per second
+};

package/src/clients/types.ts

@@ -1,6 +1,8 @@
 export type MessageContent =
   | { type: "text"; text: string }
-  | { type: "image_url"; image_url: { url: string } };
+  | { type: "image_url"; image_url: { url: string } }
+  | { type: "audio_url"; audio_url: { url: string } }
+  | { type: "video_url"; video_url: { url: string } };
 
 export interface Message {
   role: "system" | "user" | "assistant" | "tool";
@@ -84,9 +86,176 @@ export interface EmbeddingResponse {
   usd_cost?: number;
 }
 
+export interface AudioTranscriptionOptions {
+  file: Blob | File | any; // Support for Node.js ReadStream or web File/Blob
+  model?: string;
+  language?: string;
+  prompt?: string;
+  response_format?: "json" | "text" | "srt" | "verbose_json" | "vtt";
+  temperature?: number;
+  /** Optional file name hint used when constructing multipart form data */
+  fileName?: string;
+}
+
+export interface AudioTranscriptionResponse {
+  text: string;
+  language?: string;
+  duration?: number;
+  segments?: Array<{
+    id: number;
+    seek: number;
+    start: number;
+    end: number;
+    text: string;
+    tokens: number[];
+    temperature: number;
+    avg_logprob: number;
+    compression_ratio: number;
+    no_speech_prob: number;
+  }>;
+  usd_cost?: number;
+}
+
+export interface AudioGenerationOptions {
+  model: string;
+  input: string;
+  voice: string; // e.g. "alloy", "echo", "fable", "onyx", "nova", "shimmer" for OpenAI; "Kore", "Puck" etc. for Gemini
+  response_format?: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+  speed?: number;
+}
+
+export interface AudioGenerationResponse {
+  audio: Buffer;
+  format: string;
+  usd_cost?: number;
+}
+
+export interface ImageGenerationOptions {
+  model: string;
+  prompt: string;
+  n?: number;
+  size?: "256x256" | "512x512" | "1024x1024" | "1792x1024" | "1024x1792";
+  quality?: "standard" | "hd";
+  style?: "vivid" | "natural";
+  response_format?: "url" | "b64_json";
+  user?: string;
+}
+
+export interface ImageGenerationResponse {
+  created: number;
+  data: Array<{
+    url?: string;
+    b64_json?: string;
+    revised_prompt?: string;
+  }>;
+  usd_cost?: number;
+}
+
+export interface VideoGenerationOptions {
+  model: string;
+  prompt: string;
+  duration?: number;        // seconds
+  resolution?: string;      // e.g. "1080p", "720p"
+  aspect_ratio?: string;    // e.g. "16:9", "9:16", "1:1"
+  n?: number;               // number of videos to generate
+  image_url?: string;       // for image-to-video (XAI)
+  video_url?: string;       // for video editing (XAI)
+}
+
+export interface VideoGenerationResponse {
+  created: number;
+  data: Array<{
+    url?: string;
+    b64_json?: string;
+    video?: Buffer;
+  }>;
+  /** Opaque provider-specific job/operation ID used for status polling */
+  jobId?: string;
+  usd_cost?: number;
+}
+
+export interface VideoStatusOptions {
+  /** The job/operation ID returned from createVideoGeneration */
+  jobId: string;
+  model?: string;
+}
+
+export interface VideoStatusResponse {
+  jobId: string;
+  /** "queued" | "in_progress" | "completed" | "failed" | "expired" */
+  status: "queued" | "in_progress" | "completed" | "failed" | "expired";
+  /** Available when status === "completed" */
+  data?: Array<{
+    url?: string;
+    b64_json?: string;
+    /** File resource name (Google) or asset identifier (other providers) */
+    fileUri?: string;
+  }>;
+  error?: string;
+  progress?: number;
+}
+
+// ─── File API ────────────────────────────────────────────────────────────────
+
+export interface FileUploadOptions {
+  /** Raw bytes to upload */
+  data: Buffer;
+  /** MIME type of the file, e.g. "video/mp4", "image/png" */
+  mimeType: string;
+  /** Optional display name */
+  displayName?: string;
+  /** Optional file name hint (used as key / object key on some providers) */
+  fileName?: string;
+}
+
+export interface FileUploadResponse {
+  /** Opaque file identifier that can be passed to downloadFile */
+  fileId: string;
+  /** Public or signed URL (if available) */
+  url?: string;
+  /** The file's URI on the provider's storage (Google files API uri) */
+  uri?: string;
+  mimeType?: string;
+  sizeBytes?: number;
+}
+
+export interface FileDownloadOptions {
+  /** Opaque file identifier returned by uploadFile / VideoStatusResponse */
+  fileId: string;
+  /** Optional: full URI / URL if you already have it */
+  uri?: string;
+  /** Optional: local file path to save the downloaded file to directly */
+  filePath?: string;
+}
+
+export interface FileDownloadResponse {
+  data: Buffer;
+  mimeType?: string;
+}
+
 export interface GenericClient {
   setKey(key: string): void;
   createChatCompletion(options: CompletionOptions): Promise<CompletionResponse>;
   createEmbedding(options: EmbeddingOptions): Promise<EmbeddingResponse>;
+  createAudioTranscription?(
+    options: AudioTranscriptionOptions
+  ): Promise<AudioTranscriptionResponse>;
+  createAudioGeneration?(
+    options: AudioGenerationOptions
+  ): Promise<AudioGenerationResponse>;
+  createImageGeneration?(
+    options: ImageGenerationOptions
+  ): Promise<ImageGenerationResponse>;
+  createVideoGeneration?(
+    options: VideoGenerationOptions
+  ): Promise<VideoGenerationResponse>;
+  /** Poll or fetch the current status of a video generation job */
+  getVideoStatus?(options: VideoStatusOptions): Promise<VideoStatusResponse>;
+  /** Download the generated video as a Buffer */
+  downloadVideo?(options: FileDownloadOptions): Promise<FileDownloadResponse>;
+  /** Upload a file to the provider's file storage */
+  uploadFile?(options: FileUploadOptions): Promise<FileUploadResponse>;
+  /** Download a file from the provider's file storage */
+  downloadFile?(options: FileDownloadOptions): Promise<FileDownloadResponse>;
   getModels(): Promise<{ id: string }[]>;
 }