tekimax-ts 0.2.0 → 0.2.3

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AIProvider, C as ChatOptions, a as ChatResult, S as StreamChunk, T as Tool$1, M as Message$1, G as GenerateTextResult, I as ImageAnalysisOptions, b as ImageAnalysisResult, V as VideoAnalysisOptions, c as VideoAnalysisResult, E as EmbeddingOptions, d as EmbeddingResult, e as SpeechGenerationOptions, f as SpeechResult, g as ImageGenerationOptions, h as ImageResult, i as TranscriptionOptions, j as TranscriptionResult, k as ImageEditOptions, l as VideoGenerationOptions, m as VideoResult } from './tekimax-Dav_a903.cjs';
-export { n as ContentPart, o as ImageContent, p as ImageContentPart, q as MessageRole, r as Tekimax, s as TekimaxOptions, t as TextContentPart, u as ToolCall, v as ToolDefinition, w as VideoContent } from './tekimax-Dav_a903.cjs';
+import { A as AIProvider, C as ChatOptions, a as ChatResult, S as StreamChunk, T as Tool$1, M as Message$1, b as TekimaxPlugin, G as GenerateTextResult, V as VisionCapability, I as ImageAnalysisOptions, c as ImageAnalysisResult, d as VideoAnalysisCapability, E as EmbeddingCapability, e as VideoAnalysisOptions, f as VideoAnalysisResult, g as EmbeddingOptions, h as EmbeddingResult, i as SpeechGenerationCapability, j as ImageGenerationCapability, k as ImageEditCapability, l as TranscriptionCapability, m as SpeechGenerationOptions, n as SpeechResult, o as ImageGenerationOptions, p as ImageResult, q as TranscriptionOptions, r as TranscriptionResult, s as ImageEditOptions, P as PluginContext } from './tekimax-DIIjg64-.cjs';
+export { t as ContentPart, u as ImageContent, v as ImageContentPart, w as MessageRole, x as ModelCost, y as ModelDefinition, z as ModelLimit, B as ModelModalities, O as OpenResponsesReasoningConfig, D as Tekimax, F as TekimaxOptions, H as TextContentPart, J as ToolCall, K as ToolDefinition, L as VideoContent, N as VideoGenerationCapability, Q as VideoGenerationOptions, R as VideoResult } from './tekimax-DIIjg64-.cjs';
 import { z } from 'zod';
 
 /**
@@ -2734,8 +2734,9 @@ interface GenerateTextOptions {
     temperature?: number;
     maxTokens?: number;
     signal?: AbortSignal;
+    plugins?: TekimaxPlugin[];
 }
-declare function generateText({ adapter, ...options }: GenerateTextOptions & {
+declare function generateText({ adapter, plugins, ...options }: GenerateTextOptions & {
     adapter: AIProvider;
 }): Promise<GenerateTextResult>;
 
@@ -2748,7 +2749,7 @@ declare const parseThinking: (content: string) => {
     rest: string;
 };
 
-declare class AnthropicProvider implements AIProvider {
+declare class AnthropicProvider implements AIProvider, VisionCapability {
     name: string;
     private client;
     constructor(options: {
@@ -2761,7 +2762,7 @@ declare class AnthropicProvider implements AIProvider {
     private mapTool;
 }
 
-declare class GeminiProvider implements AIProvider {
+declare class GeminiProvider implements AIProvider, VisionCapability, VideoAnalysisCapability, EmbeddingCapability {
     name: string;
     private client;
     constructor(options: {
@@ -2790,12 +2791,12 @@ declare class OllamaProvider implements AIProvider {
     private mapTool;
 }
 
-declare class OpenAIProvider implements AIProvider {
+declare class OpenAIProvider implements AIProvider, SpeechGenerationCapability, ImageGenerationCapability, ImageEditCapability, VisionCapability, TranscriptionCapability, EmbeddingCapability {
     name: string;
     private client;
     constructor(options: {
         apiKey: string;
-        dangerouslyAllowBrowser?: boolean;
+        baseURL?: string;
     });
     generateSpeech(options: SpeechGenerationOptions): Promise<SpeechResult>;
     generateImage(options: ImageGenerationOptions): Promise<ImageResult>;
@@ -2981,7 +2982,7 @@ declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Pro
  * // All calls through this client now auto-retry on failures
  * ```
  */
-declare function createRetryProvider(provider: AIProvider, options?: RetryOptions): AIProvider;
+declare function createRetryProvider<TProvider extends AIProvider>(provider: TProvider, options?: RetryOptions): TProvider;
 
 /**
  * Middleware interface for intercepting provider calls.
@@ -3040,7 +3041,7 @@ interface Middleware {
  * const client = new Tekimax({ provider })
  * ```
  */
-declare function wrapProvider(provider: AIProvider, middlewares: Middleware[]): AIProvider;
+declare function wrapProvider<TProvider extends AIProvider>(provider: TProvider, middlewares: Middleware[]): TProvider;
 /**
  * Logging middleware — logs model, token usage, and latency to console.
  *
@@ -3090,154 +3091,20 @@ declare class FallbackProvider implements AIProvider {
     constructor(providers: AIProvider[], options?: FallbackProviderOptions);
     chat(options: ChatOptions): Promise<ChatResult>;
     chatStream(options: ChatOptions): AsyncIterable<StreamChunk>;
-    get generateImage(): ((options: ImageGenerationOptions) => Promise<ImageResult>) | undefined;
-    get editImage(): ((options: ImageEditOptions) => Promise<ImageResult>) | undefined;
-    get analyzeImage(): ((options: ImageAnalysisOptions) => Promise<ImageAnalysisResult>) | undefined;
-    get generateSpeech(): ((options: SpeechGenerationOptions) => Promise<SpeechResult>) | undefined;
-    get transcribeAudio(): ((options: TranscriptionOptions) => Promise<TranscriptionResult>) | undefined;
-    get generateVideo(): ((options: VideoGenerationOptions) => Promise<VideoResult>) | undefined;
-    get analyzeVideo(): ((options: VideoAnalysisOptions) => Promise<VideoAnalysisResult>) | undefined;
-    get embed(): ((options: EmbeddingOptions) => Promise<EmbeddingResult>) | undefined;
+    get generateImage(): any;
+    get editImage(): any;
+    get analyzeImage(): any;
+    get generateSpeech(): any;
+    get transcribeAudio(): any;
+    get generateVideo(): any;
+    get analyzeVideo(): any;
+    get embed(): any;
     /**
      * Try each provider in order. On failure, fall back to the next.
      */
     private tryProviders;
 }
 
-interface ConvexManagerOptions {
-    /** Convex team access token. Defaults to process.env.CONVEX_ACCESS_TOKEN */
-    accessToken?: string;
-    /** Convex team ID. If omitted, auto-resolved from token via /token_details */
-    teamId?: string | number;
-}
-interface ConvexProject {
-    id: number;
-    name: string;
-    slug: string;
-    teamId: number;
-    createTime: number;
-}
-interface ConvexCreateProjectResult {
-    projectId: number;
-    deploymentName: string;
-    deploymentUrl: string;
-}
-interface ConvexCreateProjectOptions {
-    /** Deployment type. Default: 'prod' */
-    deploymentType?: 'dev' | 'prod';
-    /** Deployment region. Default: server-chosen. Use getRegions() to list valid IDs. */
-    region?: string;
-}
-interface ConvexEnvVar {
-    name: string;
-    value: string;
-}
-interface ConvexRegion {
-    id: string;
-    name: string;
-}
-interface ConvexTokenDetails {
-    type: string;
-    teamId: number;
-    name: string;
-    createTime: number;
-}
-interface ConvexDeployOptions {
-    /** Path to the Convex project directory (where convex/ folder lives). */
-    projectDir?: string;
-    /** Additional CLI flags for `npx convex deploy`. */
-    flags?: string[];
-}
-interface ConvexOpenAPISpecOptions {
-    /** Path to the Convex project directory. Defaults to cwd. */
-    projectDir?: string;
-    /** Output file path. Defaults to 'convex-spec.yaml'. */
-    output?: string;
-    /** Additional CLI flags for `npx convex-helpers open-api-spec`. */
-    flags?: string[];
-}
-/**
- * Programmatic interface to the Convex Management API.
- *
- * Provision projects, push schemas, manage env vars, and deploy — all from code.
- *
- * @example
- * ```ts
- * import { ConvexManager } from 'tekimax-ts'
- *
- * const convex = new ConvexManager({
- *   accessToken: process.env.CONVEX_ACCESS_TOKEN,
- *   teamId: process.env.CONVEX_TEAM_ID,
- * })
- *
- * // Create a project
- * const project = await convex.createProject('my-ai-app')
- *
- * // Set env vars on the deployment
- * await convex.setEnvVars(project.deploymentName, [
- *   { name: 'OPENAI_API_KEY', value: 'sk-...' },
- * ])
- *
- * // Push schema & functions
- * const deployKey = await convex.createDeployKey(project.deploymentName)
- * await convex.deploy(deployKey, { projectDir: './my-convex-app' })
- * ```
- */
-declare class ConvexManager {
-    private accessToken;
-    private teamId;
-    constructor(options?: ConvexManagerOptions);
-    /**
-     * Create a new Convex project (includes an initial deployment).
-     */
-    createProject(name: string, options?: ConvexCreateProjectOptions): Promise<ConvexCreateProjectResult>;
-    /**
-     * List all projects for the team.
-     */
-    listProjects(): Promise<ConvexProject[]>;
-    /**
-     * Delete a project by ID.
-     */
-    deleteProject(projectId: number): Promise<void>;
-    /**
-     * Generate a deploy key for a deployment (needed for schema push / deploy).
-     */
-    createDeployKey(deploymentName: string): Promise<string>;
-    /**
-     * Set environment variables on a deployment (bulk upsert).
-     */
-    setEnvVars(deploymentName: string, vars: ConvexEnvVar[]): Promise<void>;
-    /**
-     * List environment variables on a deployment.
-     */
-    getEnvVars(deploymentName: string): Promise<ConvexEnvVar[]>;
-    /**
-     * Push Convex functions and schema to a deployment.
-     * Shells out to `npx convex deploy` with the given deploy key.
-     */
-    deploy(deployKey: string, options?: ConvexDeployOptions): void;
-    /**
-     * Resolve token details (type, teamId, name) from the access token.
-     */
-    getTokenDetails(): Promise<ConvexTokenDetails>;
-    /**
-     * List available deployment regions.
-     */
-    getRegions(): Promise<ConvexRegion[]>;
-    /**
-     * Generate an OpenAPI specification from a Convex deployment.
-     *
-     * Uses `npx convex-helpers open-api-spec` to introspect the deployment
-     * and produce a `convex-spec.yaml` file. You can then use tools like
-     * openapi-generator-cli to create type-safe clients in Go, Java, etc.
-     *
-     * @see https://docs.convex.dev/client/open-api
-     */
-    generateOpenAPISpec(options?: ConvexOpenAPISpecOptions): void;
-    private resolveTeamId;
-    private request;
-}
-
 /**
  * Minimal Redis client interface.
  * Compatible with `ioredis`, `@upstash/redis`, `redis` (node-redis), etc.
@@ -3400,4 +3267,42 @@ declare class SessionStore {
     touch(sessionId: string): Promise<void>;
 }
 
-export { AIProvider, AnthropicProvider, types as ApiTypes, type CacheOptions, ChatOptions, ChatResult, type ConvexCreateProjectOptions, type ConvexCreateProjectResult, type ConvexDeployOptions, type ConvexEnvVar, ConvexManager, type ConvexManagerOptions, type ConvexOpenAPISpecOptions, type ConvexProject, type ConvexRegion, type ConvexTokenDetails, type CostEstimate, EmbeddingOptions, EmbeddingResult, FallbackProvider, type FallbackProviderOptions, GeminiProvider, type GenerateObjectOptions, type GenerateObjectResult, type GenerateTextOptions, GenerateTextResult, GrokProvider, ImageAnalysisOptions, ImageAnalysisResult, ImageEditOptions, ImageGenerationOptions, ImageResult, Message$1 as Message, type Middleware, OllamaProvider, OpenAIProvider, OpenRouterProvider, type RateLimitOptions, type RateLimitResult, RateLimiter, type RedisClient, ResponseCache, type RetryOptions, type SessionOptions, SessionStore, SpeechGenerationOptions, SpeechResult, StreamChunk, TekimaxClient, TekimaxProvider, TokenBudget, type TokenBudgetOptions, type TokenBudgetResult, type TokenUsage, Tool$1 as Tool, TranscriptionOptions, TranscriptionResult, VideoAnalysisOptions, VideoAnalysisResult, VideoGenerationOptions, VideoResult, createRetryProvider, estimateCost, fileToBase64, generateObject, generateText, getSupportedCostModels, loggingMiddleware, parseThinking, registerModelPrice, tool, withRetry, wrapProvider };
+/**
+ * Telemetry: basic Logger Plugin
+ * Logs payloads, streaming chunks, and tool execution boundaries.
+ */
+declare class LoggerPlugin implements TekimaxPlugin {
+    name: string;
+    onInit(): void;
+    beforeRequest(context: PluginContext): Promise<void>;
+    afterResponse(context: PluginContext, result: ChatResult): Promise<void>;
+    onStreamChunk(context: PluginContext, chunk: StreamChunk): void;
+    beforeToolExecute(toolName: string, args: unknown): Promise<void>;
+    afterToolExecute(toolName: string, result: unknown): Promise<void>;
+}
+
+/**
+ * Security: PII Filter Plugin
+ * Redacts sensitive standard patterns (like emails and SSNs) from messages
+ * before they are sent to the provider.
+ */
+declare class PIIFilterPlugin implements TekimaxPlugin {
+    name: string;
+    private patterns;
+    beforeRequest(context: PluginContext): Promise<PluginContext | void>;
+}
+
+/**
+ * Scalability: Max Context Overflow Plugin
+ * Prevents token overflow in long-running loops by aggressively
+ * shifting out the oldest messages (excluding the system prompt)
+ * when the message array exceeds the configured limit.
+ */
+declare class MaxContextOverflowPlugin implements TekimaxPlugin {
+    private maxMessages;
+    name: string;
+    constructor(maxMessages?: number);
+    beforeRequest(context: PluginContext): Promise<PluginContext | void>;
+}
+
+export { AIProvider, AnthropicProvider, types as ApiTypes, type CacheOptions, ChatOptions, ChatResult, type CostEstimate, EmbeddingCapability, EmbeddingOptions, EmbeddingResult, FallbackProvider, type FallbackProviderOptions, GeminiProvider, type GenerateObjectOptions, type GenerateObjectResult, type GenerateTextOptions, GenerateTextResult, GrokProvider, ImageAnalysisOptions, ImageAnalysisResult, ImageEditCapability, ImageEditOptions, ImageGenerationCapability, ImageGenerationOptions, ImageResult, LoggerPlugin, MaxContextOverflowPlugin, Message$1 as Message, type Middleware, OllamaProvider, OpenAIProvider, OpenRouterProvider, PIIFilterPlugin, PluginContext, type RateLimitOptions, type RateLimitResult, RateLimiter, type RedisClient, ResponseCache, type RetryOptions, type SessionOptions, SessionStore, SpeechGenerationCapability, SpeechGenerationOptions, SpeechResult, StreamChunk, TekimaxClient, TekimaxPlugin, TekimaxProvider, TokenBudget, type TokenBudgetOptions, type TokenBudgetResult, type TokenUsage, Tool$1 as Tool, TranscriptionCapability, TranscriptionOptions, TranscriptionResult, VideoAnalysisCapability, VideoAnalysisOptions, VideoAnalysisResult, VisionCapability, createRetryProvider, estimateCost, fileToBase64, generateObject, generateText, getSupportedCostModels, loggingMiddleware, parseThinking, registerModelPrice, tool, withRetry, wrapProvider };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AIProvider, C as ChatOptions, a as ChatResult, S as StreamChunk, T as Tool$1, M as Message$1, G as GenerateTextResult, I as ImageAnalysisOptions, b as ImageAnalysisResult, V as VideoAnalysisOptions, c as VideoAnalysisResult, E as EmbeddingOptions, d as EmbeddingResult, e as SpeechGenerationOptions, f as SpeechResult, g as ImageGenerationOptions, h as ImageResult, i as TranscriptionOptions, j as TranscriptionResult, k as ImageEditOptions, l as VideoGenerationOptions, m as VideoResult } from './tekimax-Dav_a903.js';
-export { n as ContentPart, o as ImageContent, p as ImageContentPart, q as MessageRole, r as Tekimax, s as TekimaxOptions, t as TextContentPart, u as ToolCall, v as ToolDefinition, w as VideoContent } from './tekimax-Dav_a903.js';
+import { A as AIProvider, C as ChatOptions, a as ChatResult, S as StreamChunk, T as Tool$1, M as Message$1, b as TekimaxPlugin, G as GenerateTextResult, V as VisionCapability, I as ImageAnalysisOptions, c as ImageAnalysisResult, d as VideoAnalysisCapability, E as EmbeddingCapability, e as VideoAnalysisOptions, f as VideoAnalysisResult, g as EmbeddingOptions, h as EmbeddingResult, i as SpeechGenerationCapability, j as ImageGenerationCapability, k as ImageEditCapability, l as TranscriptionCapability, m as SpeechGenerationOptions, n as SpeechResult, o as ImageGenerationOptions, p as ImageResult, q as TranscriptionOptions, r as TranscriptionResult, s as ImageEditOptions, P as PluginContext } from './tekimax-DIIjg64-.js';
+export { t as ContentPart, u as ImageContent, v as ImageContentPart, w as MessageRole, x as ModelCost, y as ModelDefinition, z as ModelLimit, B as ModelModalities, O as OpenResponsesReasoningConfig, D as Tekimax, F as TekimaxOptions, H as TextContentPart, J as ToolCall, K as ToolDefinition, L as VideoContent, N as VideoGenerationCapability, Q as VideoGenerationOptions, R as VideoResult } from './tekimax-DIIjg64-.js';
 import { z } from 'zod';
 
 /**
@@ -2734,8 +2734,9 @@ interface GenerateTextOptions {
     temperature?: number;
     maxTokens?: number;
     signal?: AbortSignal;
+    plugins?: TekimaxPlugin[];
 }
-declare function generateText({ adapter, ...options }: GenerateTextOptions & {
+declare function generateText({ adapter, plugins, ...options }: GenerateTextOptions & {
     adapter: AIProvider;
 }): Promise<GenerateTextResult>;
 
@@ -2748,7 +2749,7 @@ declare const parseThinking: (content: string) => {
     rest: string;
 };
 
-declare class AnthropicProvider implements AIProvider {
+declare class AnthropicProvider implements AIProvider, VisionCapability {
     name: string;
     private client;
     constructor(options: {
@@ -2761,7 +2762,7 @@ declare class AnthropicProvider implements AIProvider {
     private mapTool;
 }
 
-declare class GeminiProvider implements AIProvider {
+declare class GeminiProvider implements AIProvider, VisionCapability, VideoAnalysisCapability, EmbeddingCapability {
     name: string;
     private client;
     constructor(options: {
@@ -2790,12 +2791,12 @@ declare class OllamaProvider implements AIProvider {
     private mapTool;
 }
 
-declare class OpenAIProvider implements AIProvider {
+declare class OpenAIProvider implements AIProvider, SpeechGenerationCapability, ImageGenerationCapability, ImageEditCapability, VisionCapability, TranscriptionCapability, EmbeddingCapability {
     name: string;
     private client;
     constructor(options: {
         apiKey: string;
-        dangerouslyAllowBrowser?: boolean;
+        baseURL?: string;
     });
     generateSpeech(options: SpeechGenerationOptions): Promise<SpeechResult>;
     generateImage(options: ImageGenerationOptions): Promise<ImageResult>;
@@ -2981,7 +2982,7 @@ declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Pro
  * // All calls through this client now auto-retry on failures
  * ```
  */
-declare function createRetryProvider(provider: AIProvider, options?: RetryOptions): AIProvider;
+declare function createRetryProvider<TProvider extends AIProvider>(provider: TProvider, options?: RetryOptions): TProvider;
 
 /**
  * Middleware interface for intercepting provider calls.
@@ -3040,7 +3041,7 @@ interface Middleware {
  * const client = new Tekimax({ provider })
  * ```
  */
-declare function wrapProvider(provider: AIProvider, middlewares: Middleware[]): AIProvider;
+declare function wrapProvider<TProvider extends AIProvider>(provider: TProvider, middlewares: Middleware[]): TProvider;
 /**
  * Logging middleware — logs model, token usage, and latency to console.
  *
@@ -3090,154 +3091,20 @@ declare class FallbackProvider implements AIProvider {
     constructor(providers: AIProvider[], options?: FallbackProviderOptions);
     chat(options: ChatOptions): Promise<ChatResult>;
     chatStream(options: ChatOptions): AsyncIterable<StreamChunk>;
-    get generateImage(): ((options: ImageGenerationOptions) => Promise<ImageResult>) | undefined;
-    get editImage(): ((options: ImageEditOptions) => Promise<ImageResult>) | undefined;
-    get analyzeImage(): ((options: ImageAnalysisOptions) => Promise<ImageAnalysisResult>) | undefined;
-    get generateSpeech(): ((options: SpeechGenerationOptions) => Promise<SpeechResult>) | undefined;
-    get transcribeAudio(): ((options: TranscriptionOptions) => Promise<TranscriptionResult>) | undefined;
-    get generateVideo(): ((options: VideoGenerationOptions) => Promise<VideoResult>) | undefined;
-    get analyzeVideo(): ((options: VideoAnalysisOptions) => Promise<VideoAnalysisResult>) | undefined;
-    get embed(): ((options: EmbeddingOptions) => Promise<EmbeddingResult>) | undefined;
+    get generateImage(): any;
+    get editImage(): any;
+    get analyzeImage(): any;
+    get generateSpeech(): any;
+    get transcribeAudio(): any;
+    get generateVideo(): any;
+    get analyzeVideo(): any;
+    get embed(): any;
     /**
      * Try each provider in order. On failure, fall back to the next.
      */
     private tryProviders;
 }
 
-interface ConvexManagerOptions {
-    /** Convex team access token. Defaults to process.env.CONVEX_ACCESS_TOKEN */
-    accessToken?: string;
-    /** Convex team ID. If omitted, auto-resolved from token via /token_details */
-    teamId?: string | number;
-}
-interface ConvexProject {
-    id: number;
-    name: string;
-    slug: string;
-    teamId: number;
-    createTime: number;
-}
-interface ConvexCreateProjectResult {
-    projectId: number;
-    deploymentName: string;
-    deploymentUrl: string;
-}
-interface ConvexCreateProjectOptions {
-    /** Deployment type. Default: 'prod' */
-    deploymentType?: 'dev' | 'prod';
-    /** Deployment region. Default: server-chosen. Use getRegions() to list valid IDs. */
-    region?: string;
-}
-interface ConvexEnvVar {
-    name: string;
-    value: string;
-}
-interface ConvexRegion {
-    id: string;
-    name: string;
-}
-interface ConvexTokenDetails {
-    type: string;
-    teamId: number;
-    name: string;
-    createTime: number;
-}
-interface ConvexDeployOptions {
-    /** Path to the Convex project directory (where convex/ folder lives). */
-    projectDir?: string;
-    /** Additional CLI flags for `npx convex deploy`. */
-    flags?: string[];
-}
-interface ConvexOpenAPISpecOptions {
-    /** Path to the Convex project directory. Defaults to cwd. */
-    projectDir?: string;
-    /** Output file path. Defaults to 'convex-spec.yaml'. */
-    output?: string;
-    /** Additional CLI flags for `npx convex-helpers open-api-spec`. */
-    flags?: string[];
-}
-/**
- * Programmatic interface to the Convex Management API.
- *
- * Provision projects, push schemas, manage env vars, and deploy — all from code.
- *
- * @example
- * ```ts
- * import { ConvexManager } from 'tekimax-ts'
- *
- * const convex = new ConvexManager({
- *   accessToken: process.env.CONVEX_ACCESS_TOKEN,
- *   teamId: process.env.CONVEX_TEAM_ID,
- * })
- *
- * // Create a project
- * const project = await convex.createProject('my-ai-app')
- *
- * // Set env vars on the deployment
- * await convex.setEnvVars(project.deploymentName, [
- *   { name: 'OPENAI_API_KEY', value: 'sk-...' },
- * ])
- *
- * // Push schema & functions
- * const deployKey = await convex.createDeployKey(project.deploymentName)
- * await convex.deploy(deployKey, { projectDir: './my-convex-app' })
- * ```
- */
-declare class ConvexManager {
-    private accessToken;
-    private teamId;
-    constructor(options?: ConvexManagerOptions);
-    /**
-     * Create a new Convex project (includes an initial deployment).
-     */
-    createProject(name: string, options?: ConvexCreateProjectOptions): Promise<ConvexCreateProjectResult>;
-    /**
-     * List all projects for the team.
-     */
-    listProjects(): Promise<ConvexProject[]>;
-    /**
-     * Delete a project by ID.
-     */
-    deleteProject(projectId: number): Promise<void>;
-    /**
-     * Generate a deploy key for a deployment (needed for schema push / deploy).
-     */
-    createDeployKey(deploymentName: string): Promise<string>;
-    /**
-     * Set environment variables on a deployment (bulk upsert).
-     */
-    setEnvVars(deploymentName: string, vars: ConvexEnvVar[]): Promise<void>;
-    /**
-     * List environment variables on a deployment.
-     */
-    getEnvVars(deploymentName: string): Promise<ConvexEnvVar[]>;
-    /**
-     * Push Convex functions and schema to a deployment.
-     * Shells out to `npx convex deploy` with the given deploy key.
-     */
-    deploy(deployKey: string, options?: ConvexDeployOptions): void;
-    /**
-     * Resolve token details (type, teamId, name) from the access token.
-     */
-    getTokenDetails(): Promise<ConvexTokenDetails>;
-    /**
-     * List available deployment regions.
-     */
-    getRegions(): Promise<ConvexRegion[]>;
-    /**
-     * Generate an OpenAPI specification from a Convex deployment.
-     *
-     * Uses `npx convex-helpers open-api-spec` to introspect the deployment
-     * and produce a `convex-spec.yaml` file. You can then use tools like
-     * openapi-generator-cli to create type-safe clients in Go, Java, etc.
-     *
-     * @see https://docs.convex.dev/client/open-api
-     */
-    generateOpenAPISpec(options?: ConvexOpenAPISpecOptions): void;
-    private resolveTeamId;
-    private request;
-}
-
 /**
  * Minimal Redis client interface.
  * Compatible with `ioredis`, `@upstash/redis`, `redis` (node-redis), etc.
@@ -3400,4 +3267,42 @@ declare class SessionStore {
     touch(sessionId: string): Promise<void>;
 }
 
-export { AIProvider, AnthropicProvider, types as ApiTypes, type CacheOptions, ChatOptions, ChatResult, type ConvexCreateProjectOptions, type ConvexCreateProjectResult, type ConvexDeployOptions, type ConvexEnvVar, ConvexManager, type ConvexManagerOptions, type ConvexOpenAPISpecOptions, type ConvexProject, type ConvexRegion, type ConvexTokenDetails, type CostEstimate, EmbeddingOptions, EmbeddingResult, FallbackProvider, type FallbackProviderOptions, GeminiProvider, type GenerateObjectOptions, type GenerateObjectResult, type GenerateTextOptions, GenerateTextResult, GrokProvider, ImageAnalysisOptions, ImageAnalysisResult, ImageEditOptions, ImageGenerationOptions, ImageResult, Message$1 as Message, type Middleware, OllamaProvider, OpenAIProvider, OpenRouterProvider, type RateLimitOptions, type RateLimitResult, RateLimiter, type RedisClient, ResponseCache, type RetryOptions, type SessionOptions, SessionStore, SpeechGenerationOptions, SpeechResult, StreamChunk, TekimaxClient, TekimaxProvider, TokenBudget, type TokenBudgetOptions, type TokenBudgetResult, type TokenUsage, Tool$1 as Tool, TranscriptionOptions, TranscriptionResult, VideoAnalysisOptions, VideoAnalysisResult, VideoGenerationOptions, VideoResult, createRetryProvider, estimateCost, fileToBase64, generateObject, generateText, getSupportedCostModels, loggingMiddleware, parseThinking, registerModelPrice, tool, withRetry, wrapProvider };
+/**
+ * Telemetry: basic Logger Plugin
+ * Logs payloads, streaming chunks, and tool execution boundaries.
+ */
+declare class LoggerPlugin implements TekimaxPlugin {
+    name: string;
+    onInit(): void;
+    beforeRequest(context: PluginContext): Promise<void>;
+    afterResponse(context: PluginContext, result: ChatResult): Promise<void>;
+    onStreamChunk(context: PluginContext, chunk: StreamChunk): void;
+    beforeToolExecute(toolName: string, args: unknown): Promise<void>;
+    afterToolExecute(toolName: string, result: unknown): Promise<void>;
+}
+
+/**
+ * Security: PII Filter Plugin
+ * Redacts sensitive standard patterns (like emails and SSNs) from messages
+ * before they are sent to the provider.
+ */
+declare class PIIFilterPlugin implements TekimaxPlugin {
+    name: string;
+    private patterns;
+    beforeRequest(context: PluginContext): Promise<PluginContext | void>;
+}
+
+/**
+ * Scalability: Max Context Overflow Plugin
+ * Prevents token overflow in long-running loops by aggressively
+ * shifting out the oldest messages (excluding the system prompt)
+ * when the message array exceeds the configured limit.
+ */
+declare class MaxContextOverflowPlugin implements TekimaxPlugin {
+    private maxMessages;
+    name: string;
+    constructor(maxMessages?: number);
+    beforeRequest(context: PluginContext): Promise<PluginContext | void>;
+}
+
+export { AIProvider, AnthropicProvider, types as ApiTypes, type CacheOptions, ChatOptions, ChatResult, type CostEstimate, EmbeddingCapability, EmbeddingOptions, EmbeddingResult, FallbackProvider, type FallbackProviderOptions, GeminiProvider, type GenerateObjectOptions, type GenerateObjectResult, type GenerateTextOptions, GenerateTextResult, GrokProvider, ImageAnalysisOptions, ImageAnalysisResult, ImageEditCapability, ImageEditOptions, ImageGenerationCapability, ImageGenerationOptions, ImageResult, LoggerPlugin, MaxContextOverflowPlugin, Message$1 as Message, type Middleware, OllamaProvider, OpenAIProvider, OpenRouterProvider, PIIFilterPlugin, PluginContext, type RateLimitOptions, type RateLimitResult, RateLimiter, type RedisClient, ResponseCache, type RetryOptions, type SessionOptions, SessionStore, SpeechGenerationCapability, SpeechGenerationOptions, SpeechResult, StreamChunk, TekimaxClient, TekimaxPlugin, TekimaxProvider, TokenBudget, type TokenBudgetOptions, type TokenBudgetResult, type TokenUsage, Tool$1 as Tool, TranscriptionCapability, TranscriptionOptions, TranscriptionResult, VideoAnalysisCapability, VideoAnalysisOptions, VideoAnalysisResult, VisionCapability, createRetryProvider, estimateCost, fileToBase64, generateObject, generateText, getSupportedCostModels, loggingMiddleware, parseThinking, registerModelPrice, tool, withRetry, wrapProvider };