@elizaos/plugin-openai 1.6.0 → 2.0.0-alpha.2

package/dist/types/index.d.ts

@@ -1,26 +1,329 @@
-export interface OpenAITranscriptionParams {
+/**
+ * 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;
-    response_format?: 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;
-    timestampGranularities?: string[];
+    /** Timestamp granularity for verbose output */
+    timestampGranularities?: TimestampGranularity[];
+    /** MIME type hint for buffer audio data */
     mimeType?: string;
 }
-export interface OpenAITextToSpeechParams {
+/**
+ * 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;
-    voice?: string;
-    format?: "mp3" | "wav" | "flac" | string;
+    /** The voice to use */
+    voice?: TTSVoice;
+    /** The output format */
+    format?: TTSOutputFormat;
+    /** Additional instructions for the TTS model */
     instructions?: string;
 }
-export interface OpenAIImageDescriptionResult {
+/**
+ * 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;
+}
+/**
+ * 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;
 }
-export interface OpenAIImageGenerationResult {
-    data: {
+/**
+ * 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;
+}
+/**
+ * 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;
+    };
+}
+/**
+ * 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;
+    /** 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

@@ -1,12 +1,6 @@
-/**
- * Detects audio MIME type from buffer by checking magic bytes (file signature)
- * @param buffer The audio buffer to analyze
- * @returns The detected MIME type or 'application/octet-stream' if unknown
- */
-export declare function detectAudioMimeType(buffer: Buffer): string;
-/**
- * Converts a Web ReadableStream to a Node.js Readable stream
- * Handles both browser and Node.js environments
- * Uses dynamic import to avoid bundling node:stream in browser builds
- */
-export declare function webStreamToNodeStream(webStream: ReadableStream<Uint8Array>): Promise<import("stream").Readable>;
+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

@@ -1,70 +1,27 @@
 import type { IAgentRuntime } from "@elizaos/core";
-/**
- * Retrieves a configuration setting from the runtime, falling back to environment variables or a default value if not found.
- *
- * @param key - The name of the setting to retrieve.
- * @param defaultValue - The value to return if the setting is not found in the runtime or environment.
- * @returns The resolved setting value, or {@link defaultValue} if not found.
- */
 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;
-/**
- * Determines whether we're running in a browser with a server-hosted proxy configured.
- * In this mode, we do not require a real API key on the client and rely on the proxy to inject it.
- */
 export declare function isProxyMode(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>;
-/**
- * Retrieves the OpenAI API base URL from runtime settings, environment variables, or defaults, using provider-aware resolution.
- *
- * @returns The resolved base URL for OpenAI API requests.
- */
 export declare function getBaseURL(runtime: IAgentRuntime): string;
-/**
- * Retrieves the OpenAI API base URL for embeddings, falling back to the general base URL.
- *
- * @returns The resolved base URL for OpenAI embedding requests.
- */
 export declare function getEmbeddingBaseURL(runtime: IAgentRuntime): string;
-/**
- * Helper function to get the API key for OpenAI
- *
- * @param runtime The runtime context
- * @returns The configured API key
- */
-export declare function getApiKey(runtime: IAgentRuntime): string | undefined;
-/**
- * Helper function to get the embedding API key for OpenAI, falling back to the general API key if not set.
- *
- * @param runtime The runtime context
- * @returns The configured API key
- */
-export declare function getEmbeddingApiKey(runtime: IAgentRuntime): string | undefined;
-/**
- * Helper function to get the small model name with fallbacks
- *
- * @param runtime The runtime context
- * @returns The configured small model name
- */
 export declare function getSmallModel(runtime: IAgentRuntime): string;
-/**
- * Helper function to get the large model name with fallbacks
- *
- * @param runtime The runtime context
- * @returns The configured large model name
- */
 export declare function getLargeModel(runtime: IAgentRuntime): string;
-/**
- * Helper function to get the image description model name with fallbacks
- *
- * @param runtime The runtime context
- * @returns The configured image description model name
- */
+export declare function getEmbeddingModel(runtime: IAgentRuntime): string;
 export declare function getImageDescriptionModel(runtime: IAgentRuntime): string;
-/**
- * Helper function to get experimental telemetry setting
- *
- * @param runtime The runtime context
- * @returns Whether experimental telemetry is enabled
- */
+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":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAWnD,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAMpB;AACD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAMR;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,MAAM,CAUR;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,OAAO,GACpB,OAAO,CAOT;AAED,wBAAgB,SAAS,IAAI,OAAO,CAKnC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE3D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAQ7E;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,aAAa,EACtB,YAAY,UAAQ,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAQzD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAalE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAI5D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE5D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEhE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEvE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEpE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE1D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEjE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE5D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAExE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAErE;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE3E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE/D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEjE"}

package/dist/utils/events.d.ts

@@ -1,10 +1,15 @@
 import type { IAgentRuntime, ModelTypeName } from "@elizaos/core";
-import type { LanguageModelUsage } from "ai";
-/**
- * Emits a model usage event
- * @param runtime The runtime context
- * @param type The model type
- * @param prompt The prompt used
- * @param usage The LLM usage data
- */
-export declare function emitModelUsageEvent(runtime: IAgentRuntime, type: ModelTypeName, prompt: string, usage: LanguageModelUsage): void;
+import type { TokenUsage } from "../types";
+interface AISDKUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+}
+interface OpenAIAPIUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: 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;AAiB3C,UAAU,UAAU;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,cAAc;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,CAAC;AAiC3D,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,GAChB,IAAI,CAiBN"}

package/dist/utils/index.d.ts

@@ -1,5 +1,6 @@
+export * from "./audio";
 export * from "./config";
 export * from "./events";
-export * from "./audio";
 export * from "./json";
 export * from "./tokenization";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC"}

package/dist/utils/json.d.ts

@@ -1,7 +1,10 @@
-/**
- * Returns a function to repair JSON text
- */
-export declare function getJsonRepairFunction(): (params: {
+interface JsonRepairParams {
     text: string;
-    error: unknown;
-}) => Promise<string | null>;
+    error: Error;
+}
+type JsonRepairFunction = (params: JsonRepairParams) => Promise<string | null>;
+export declare function getJsonRepairFunction(): JsonRepairFunction;
+export declare function parseJsonWithRepair<T>(text: string): T;
+export declare function safeStringify(value: unknown, indent?: number): string;
+export {};
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../utils/json.ts"],"names":[],"mappings":"AAGA,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd;AAED,KAAK,kBAAkB,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAO/E,wBAAgB,qBAAqB,IAAI,kBAAkB,CAe1D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAYtD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAI,GAAG,MAAM,CAwChE"}

package/dist/utils/tokenization.d.ts

@@ -1,17 +1,6 @@
 import type { IAgentRuntime, ModelTypeName } from "@elizaos/core";
-/**
- * Asynchronously tokenizes the given text based on the specified model and prompt.
- *
- * @param {ModelTypeName} model - The type of model to use for tokenization.
- * @param {string} prompt - The text prompt to tokenize.
- * @returns {number[]} - An array of tokens representing the encoded prompt.
- */
-export declare function tokenizeText(runtime: IAgentRuntime, model: ModelTypeName, prompt: string): Promise<number[]>;
-/**
- * Detokenize a sequence of tokens back into text using the specified model.
- *
- * @param {ModelTypeName} model - The type of model to use for detokenization.
- * @param {number[]} tokens - The sequence of tokens to detokenize.
- * @returns {string} The detokenized text.
- */
-export declare function detokenizeText(runtime: IAgentRuntime, model: ModelTypeName, tokens: number[]): Promise<string>;
+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"}