@elizaos/plugin-openai 2.0.3-beta.2 → 2.0.3-beta.4

package/dist/types/index.d.ts

@@ -0,0 +1,367 @@
+/**
+ * Supported audio formats for transcription
+ */
+export type AudioFormat = "mp3" | "wav" | "webm" | "ogg" | "flac" | "mp4";
+/**
+ * Supported response formats for transcription
+ */
+export type TranscriptionResponseFormat = "json" | "text" | "srt" | "verbose_json" | "vtt";
+/**
+ * Timestamp granularity options for transcription
+ */
+export type TimestampGranularity = "word" | "segment";
+/**
+ * Supported TTS output formats
+ */
+export type TTSOutputFormat = "mp3" | "wav" | "flac" | "opus" | "aac" | "pcm";
+/**
+ * Supported TTS voices
+ */
+export type TTSVoice = "alloy" | "echo" | "fable" | "onyx" | "nova" | "shimmer";
+/**
+ * Image sizes for DALL-E
+ */
+export type ImageSize = "256x256" | "512x512" | "1024x1024" | "1792x1024" | "1024x1792";
+/**
+ * Image quality options
+ */
+export type ImageQuality = "standard" | "hd";
+/**
+ * Image style options
+ */
+export type ImageStyle = "vivid" | "natural";
+/**
+ * Parameters for audio transcription
+ */
+export interface TranscriptionParams {
+    /** The audio data to transcribe */
+    audio: Blob | File | Buffer;
+    /** The model to use for transcription */
+    model?: string;
+    /** The language of the audio (ISO-639-1 code) */
+    language?: string;
+    /** The format of the response */
+    responseFormat?: TranscriptionResponseFormat;
+    /** An optional prompt to guide the model's style */
+    prompt?: string;
+    /** Sampling temperature between 0 and 1 */
+    temperature?: number;
+    /** Timestamp granularity for verbose output */
+    timestampGranularities?: TimestampGranularity[];
+    /** MIME type hint for buffer audio data */
+    mimeType?: string;
+}
+/**
+ * Parameters for text-to-speech generation
+ */
+export interface TextToSpeechParams {
+    /** The text to convert to speech (max 4096 characters) */
+    text: string;
+    /** The model to use */
+    model?: string;
+    /** The voice to use */
+    voice?: TTSVoice;
+    /** The output format */
+    format?: TTSOutputFormat;
+    /** Additional instructions for the TTS model */
+    instructions?: string;
+}
+/**
+ * Parameters for embedding generation
+ */
+export interface EmbeddingParams {
+    /** The text to embed */
+    text: string;
+    /** The model to use */
+    model?: string;
+    /** The number of dimensions for the embedding */
+    dimensions?: number;
+}
+/**
+ * Parameters for image generation
+ */
+export interface ImageGenerationParams {
+    /** The prompt describing the image to generate */
+    prompt: string;
+    /** Number of images to generate (1-10) */
+    count?: number;
+    /** The size of the generated images */
+    size?: ImageSize;
+    /** The quality of the generated images */
+    quality?: ImageQuality;
+    /** The style of the generated images */
+    style?: ImageStyle;
+}
+/**
+ * Parameters for image description/analysis
+ */
+export interface ImageDescriptionParams {
+    /** URL of the image to analyze */
+    imageUrl: string;
+    /** Custom prompt for analysis */
+    prompt?: string;
+    /** Maximum tokens for the response */
+    maxTokens?: number;
+}
+/**
+ * Parameters for text generation
+ */
+export interface TextGenerationParams {
+    /** The prompt for generation */
+    prompt: string;
+    /** System message for the model */
+    system?: string;
+    /** Temperature for sampling (0-2) */
+    temperature?: number;
+    /** Maximum output tokens */
+    maxTokens?: number;
+    /** Frequency penalty (-2 to 2) */
+    frequencyPenalty?: number;
+    /** Presence penalty (-2 to 2) */
+    presencePenalty?: number;
+    /** Stop sequences */
+    stopSequences?: string[];
+    /** Whether to stream the response */
+    stream?: boolean;
+    /** Callback for streaming chunks */
+    onStreamChunk?: (chunk: string) => void;
+    /** Stable key for OpenAI prompt cache routing */
+    promptCacheKey?: string;
+    /** Optional OpenAI cache retention mode */
+    promptCacheRetention?: "in_memory" | "24h";
+    /** Provider-specific options for OpenAI requests */
+    providerOptions?: {
+        openai?: {
+            promptCacheKey?: string;
+            promptCacheRetention?: "in_memory" | "24h";
+        };
+    };
+}
+/**
+ * Parameters for tokenization
+ */
+export interface TokenizeParams {
+    /** The text to tokenize */
+    prompt: string;
+    /** The model whose tokenizer to use */
+    modelType?: string;
+}
+/**
+ * Parameters for detokenization
+ */
+export interface DetokenizeParams {
+    /** The tokens to decode */
+    tokens: number[];
+    /** The model whose tokenizer to use */
+    modelType?: string;
+}
+/**
+ * Result of image description/analysis
+ */
+export interface ImageDescriptionResult {
+    /** A title for the image */
+    title: string;
+    /** A detailed description of the image */
+    description: string;
+}
+/**
+ * Result of image generation
+ */
+export interface ImageGenerationResult {
+    /** URL of the generated image */
+    url: string;
+    /** Revised prompt (if applicable) */
+    revisedPrompt?: string;
+}
+/**
+ * Token usage statistics
+ */
+export interface TokenUsage {
+    /** Number of prompt tokens */
+    promptTokens: number;
+    /** Number of completion tokens */
+    completionTokens: number;
+    /** Total tokens used */
+    totalTokens: number;
+    /**
+     * Prompt tokens read from cache.
+     *
+     * Historical name kept for back-compat with OpenAI plugin consumers. New
+     * code should also read `cacheReadInputTokens` (the canonical v5 trajectory
+     * recorder field). The text adapter populates both when the AI SDK reports
+     * cached input.
+     */
+    cachedPromptTokens?: number;
+    /**
+     * Canonical v5 cache-read field. Mirrors `cachedPromptTokens` for the
+     * trajectory recorder + cost table, so consumers that expect either name
+     * resolve correctly.
+     */
+    cacheReadInputTokens?: number;
+    /**
+     * Canonical v5 cache-creation field. OpenAI does not differentiate cache
+     * write currently, so this is reserved for parity with Anthropic adapters.
+     */
+    cacheCreationInputTokens?: number;
+}
+/**
+ * Streaming text result
+ */
+export interface TextStreamResult {
+    /** Async iterable stream of text chunks */
+    textStream: AsyncIterable<string>;
+    /** Promise resolving to final complete text */
+    text: Promise<string>;
+    /** Promise resolving to token usage */
+    usage: Promise<TokenUsage | undefined>;
+    /** Promise resolving to finish reason */
+    finishReason: Promise<string | undefined>;
+}
+/**
+ * OpenAI embedding response structure
+ */
+export interface OpenAIEmbeddingResponse {
+    object: "list";
+    data: Array<{
+        object: "embedding";
+        embedding: number[];
+        index: number;
+    }>;
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+/**
+ * OpenAI chat completion response structure
+ */
+export interface OpenAIChatCompletionResponse {
+    id: string;
+    object: "chat.completion";
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: "assistant";
+            content: string | null;
+        };
+        finish_reason: "stop" | "length" | "content_filter" | "tool_calls";
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        prompt_tokens_details?: {
+            cached_tokens?: number;
+        };
+    };
+}
+/**
+ * OpenAI image generation response structure
+ */
+export interface OpenAIImageGenerationResponse {
+    created: number;
+    data: Array<{
+        url: string;
+        revised_prompt?: string;
+    }>;
+}
+/**
+ * OpenAI transcription response structure
+ */
+export interface OpenAITranscriptionResponse {
+    text: string;
+    language?: string;
+    duration?: number;
+    words?: Array<{
+        word: string;
+        start: number;
+        end: number;
+    }>;
+    segments?: Array<{
+        id: number;
+        start: number;
+        end: number;
+        text: string;
+    }>;
+}
+/**
+ * OpenAI models list response
+ */
+export interface OpenAIModelsResponse {
+    object: "list";
+    data: Array<{
+        id: string;
+        object: "model";
+        created: number;
+        owned_by: string;
+    }>;
+}
+/**
+ * OpenAI plugin configuration settings
+ */
+export interface OpenAIPluginConfig {
+    /** OpenAI API key */
+    OPENAI_API_KEY?: string;
+    /** Base URL for API requests */
+    OPENAI_BASE_URL?: string;
+    /** Small model identifier */
+    OPENAI_SMALL_MODEL?: string;
+    /** Large model identifier */
+    OPENAI_LARGE_MODEL?: string;
+    /** Embedding model identifier */
+    OPENAI_EMBEDDING_MODEL?: string;
+    /** Separate API key for embeddings */
+    OPENAI_EMBEDDING_API_KEY?: string;
+    /** Separate base URL for embeddings */
+    OPENAI_EMBEDDING_URL?: string;
+    /** Embedding dimensions */
+    OPENAI_EMBEDDING_DIMENSIONS?: string;
+    /** Separate API key for image description */
+    OPENAI_IMAGE_DESCRIPTION_API_KEY?: string;
+    /** Separate base URL for image description */
+    OPENAI_IMAGE_DESCRIPTION_BASE_URL?: string;
+    /** Image description model */
+    OPENAI_IMAGE_DESCRIPTION_MODEL?: string;
+    /** Max tokens for image description */
+    OPENAI_IMAGE_DESCRIPTION_MAX_TOKENS?: string;
+    /** TTS model */
+    OPENAI_TTS_MODEL?: string;
+    /** TTS voice */
+    OPENAI_TTS_VOICE?: string;
+    /** TTS instructions */
+    OPENAI_TTS_INSTRUCTIONS?: string;
+    /** Enable experimental telemetry */
+    OPENAI_EXPERIMENTAL_TELEMETRY?: string;
+    /** Browser-only proxy base URL */
+    OPENAI_BROWSER_BASE_URL?: string;
+    /** Browser-only embedding proxy URL */
+    OPENAI_BROWSER_EMBEDDING_URL?: string;
+    /** Transcription model */
+    OPENAI_TRANSCRIPTION_MODEL?: string;
+    /** Image generation model */
+    OPENAI_IMAGE_MODEL?: string;
+    /** Deep research model (o3-deep-research or o4-mini-deep-research) */
+    OPENAI_RESEARCH_MODEL?: string;
+    /** Timeout for deep research requests in milliseconds (default: 3600000 = 1 hour) */
+    OPENAI_RESEARCH_TIMEOUT?: string;
+}
+/**
+ * Validates that a string is non-empty
+ */
+export declare function requireNonEmptyString(value: string, fieldName: string): string;
+/**
+ * Validates that a number is within a range
+ */
+export declare function requireNumberInRange(value: number, min: number, max: number, fieldName: string): number;
+/**
+ * Validates that an array is non-empty
+ */
+export declare function requireNonEmptyArray<T>(arr: T[], fieldName: string): T[];
+/**
+ * Validates embedding dimensions
+ */
+export declare function validateEmbeddingDimension(dimension: number, validDimensions: readonly number[]): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/audio.d.ts

@@ -0,0 +1,6 @@
+export type AudioMimeType = "audio/wav" | "audio/mpeg" | "audio/ogg" | "audio/flac" | "audio/mp4" | "audio/webm" | "application/octet-stream";
+export declare function detectAudioMimeType(buffer: Buffer): AudioMimeType;
+export declare function getExtensionForMimeType(mimeType: AudioMimeType): string;
+export declare function getFilenameForMimeType(mimeType: AudioMimeType): string;
+export declare function validateAudioFormat(buffer: Buffer): AudioMimeType;
+//# sourceMappingURL=audio.d.ts.map

package/dist/utils/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../utils/audio.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,0BAA0B,CAAC;AAY/B,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CA6CjE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAiBvE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAGtE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAQjE"}

package/dist/utils/config.d.ts

@@ -0,0 +1,47 @@
+import type { IAgentRuntime } from "@elizaos/core";
+export declare function getSetting(runtime: IAgentRuntime, key: string, defaultValue?: string): string | undefined;
+export declare function getRequiredSetting(runtime: IAgentRuntime, key: string, errorMessage?: string): string;
+export declare function getNumericSetting(runtime: IAgentRuntime, key: string, defaultValue: number): number;
+export declare function getBooleanSetting(runtime: IAgentRuntime, key: string, defaultValue: boolean): boolean;
+export declare function isBrowser(): boolean;
+export declare function isProxyMode(runtime: IAgentRuntime): boolean;
+/**
+ * True when the resolved base URL or `ELIZA_PROVIDER` setting marks the
+ * runtime as using Cerebras's OpenAI-compatible endpoint. Used to scope
+ * the `CEREBRAS_API_KEY` alias so OpenAI users are not affected.
+ */
+export declare function isCerebrasMode(runtime: IAgentRuntime): boolean;
+/**
+ * True when the resolved base URL or `ELIZA_PROVIDER` setting marks the
+ * runtime as using EvoLink's OpenAI-compatible endpoint. Used to scope the
+ * `EVOLINK_API_KEY` alias so OpenAI users are not affected.
+ */
+export declare function isEvoLinkMode(runtime: IAgentRuntime): boolean;
+export declare function getApiKey(runtime: IAgentRuntime): string | undefined;
+export declare function getEmbeddingApiKey(runtime: IAgentRuntime): string | undefined;
+export declare function getAuthHeader(runtime: IAgentRuntime, forEmbedding?: boolean): Record<string, string>;
+export declare function getBaseURL(runtime: IAgentRuntime): string;
+export declare function getEmbeddingBaseURL(runtime: IAgentRuntime): string;
+export declare function getImageDescriptionApiKey(runtime: IAgentRuntime): string | undefined;
+export declare function getImageDescriptionAuthHeader(runtime: IAgentRuntime): Record<string, string>;
+export declare function getImageDescriptionBaseURL(runtime: IAgentRuntime): string;
+export declare function getSmallModel(runtime: IAgentRuntime): string;
+export declare function getNanoModel(runtime: IAgentRuntime): string;
+export declare function getMediumModel(runtime: IAgentRuntime): string;
+export declare function getLargeModel(runtime: IAgentRuntime): string;
+export declare function getMegaModel(runtime: IAgentRuntime): string;
+export declare function getResponseHandlerModel(runtime: IAgentRuntime): string;
+export declare function getActionPlannerModel(runtime: IAgentRuntime): string;
+export declare function getEmbeddingModel(runtime: IAgentRuntime): string;
+export declare function getImageDescriptionModel(runtime: IAgentRuntime): string;
+export declare function getTranscriptionModel(runtime: IAgentRuntime): string;
+export declare function getTTSModel(runtime: IAgentRuntime): string;
+export declare function getTTSVoice(runtime: IAgentRuntime): string;
+export declare function getTTSInstructions(runtime: IAgentRuntime): string;
+export declare function getImageModel(runtime: IAgentRuntime): string;
+export declare function getExperimentalTelemetry(runtime: IAgentRuntime): boolean;
+export declare function getEmbeddingDimensions(runtime: IAgentRuntime): number;
+export declare function getImageDescriptionMaxTokens(runtime: IAgentRuntime): number;
+export declare function getResearchModel(runtime: IAgentRuntime): string;
+export declare function getResearchTimeout(runtime: IAgentRuntime): number;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../utils/config.ts"],"names":[],"mappings":"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"}

package/dist/utils/events.d.ts

@@ -0,0 +1,21 @@
+import type { IAgentRuntime, ModelTypeName } from "@elizaos/core";
+import type { TokenUsage } from "../types";
+interface AISDKUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cachedInputTokens?: number;
+}
+interface OpenAIAPIUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    cachedPromptTokens?: number;
+    promptTokensDetails?: {
+        cachedTokens?: number;
+    };
+}
+type ModelUsage = TokenUsage | AISDKUsage | OpenAIAPIUsage;
+export declare function emitModelUsageEvent(runtime: IAgentRuntime, type: ModelTypeName, prompt: string, usage: ModelUsage): void;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/utils/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../utils/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAkB3C,UAAU,UAAU;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,cAAc;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,KAAK,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,CAAC;AAuC3D,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,GAChB,IAAI,CAoBN"}

package/dist/utils/tokenization.d.ts

@@ -0,0 +1,6 @@
+import type { IAgentRuntime, ModelTypeName } from "@elizaos/core";
+export declare function tokenizeText(runtime: IAgentRuntime, modelType: ModelTypeName, text: string): number[];
+export declare function detokenizeText(runtime: IAgentRuntime, modelType: ModelTypeName, tokens: number[]): string;
+export declare function countTokens(runtime: IAgentRuntime, modelType: ModelTypeName, text: string): number;
+export declare function truncateToTokenLimit(runtime: IAgentRuntime, modelType: ModelTypeName, text: string, maxTokens: number): string;
+//# sourceMappingURL=tokenization.d.ts.map

package/dist/utils/tokenization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenization.d.ts","sourceRoot":"","sources":["../../utils/tokenization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAgClE,wBAAgB,YAAY,CAC1B,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAIV;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,CAIR;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,MAAM,CAOR"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-openai",
-  "version": "2.0.3-beta.2",
+  "version": "2.0.3-beta.4",
   "type": "module",
   "main": "dist/node/index.node.js",
   "module": "dist/node/index.node.js",
@@ -35,6 +35,7 @@
     }
   },
   "files": [
+    "registry-entry.json",
     "dist",
     "rust",
     "auto-enable.ts"
@@ -59,7 +60,8 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
-    "@elizaos/core": "2.0.3-beta.2",
+    "@elizaos/core": "2.0.3-beta.4",
+    "@elizaos/test-harness": "2.0.3-beta.4",
     "@types/bun": "^1.3.8",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25.0.3",
@@ -68,7 +70,7 @@
     "vitest": "^4.0.0"
   },
   "peerDependencies": {
-    "@elizaos/core": "2.0.3-beta.2",
+    "@elizaos/core": "2.0.3-beta.4",
     "zod": "^4.4.3"
   },
   "scripts": {
@@ -82,6 +84,7 @@
     "typecheck": "tsgo --noEmit",
     "test": "vitest run --config ./vitest.config.ts",
     "test:ts": "vitest run --config ./vitest.config.ts",
+    "test:harness": "bunx vitest run --config vitest.harness.config.ts",
     "build": "bun run build.ts"
   },
   "publishConfig": {
@@ -242,7 +245,7 @@
       }
     }
   },
-  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc",
+  "gitHead": "f76f55793a0fb8d6b869dd8ddce03970de061e34",
   "eliza": {
     "platforms": [
       "browser",