binario 0.1.0 → 0.2.0

package/dist/react.d.cts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import * as react from 'react';
 
 type Provider = 'openai' | 'anthropic' | 'google' | 'mistral' | 'cohere' | 'cloudflare' | 'lovable';
 interface Message {
@@ -31,7 +32,7 @@ interface StreamCallbacks {
     onComplete?: (response: ChatResponse) => void;
     onError?: (error: Error) => void;
 }
-interface ChatOptions {
+interface ChatOptions$1 {
     provider?: Provider;
     model?: string;
     temperature?: number;
@@ -147,9 +148,9 @@ declare class BinarioAI {
     private retryWithBackoff;
     private formatMessagesForProvider;
     private parseProviderResponse;
-    chat(messages: Message[], options?: ChatOptions): Promise<ChatResponse>;
+    chat(messages: Message[], options?: ChatOptions$1): Promise<ChatResponse>;
     private handleStructuredOutput;
-    streamChat(messages: Message[], options?: ChatOptions, callbacks?: StreamCallbacks): AsyncGenerator<string, ChatResponse, unknown>;
+    streamChat(messages: Message[], options?: ChatOptions$1, callbacks?: StreamCallbacks): AsyncGenerator<string, ChatResponse, unknown>;
     clearCache(): void;
 }
 
@@ -296,7 +297,7 @@ interface EmbeddingsProvider {
     embedMany(texts: string[]): Promise<BatchEmbeddingResult>;
 }
 
-interface UseBinarioChatOptions extends ChatOptions {
+interface UseBinarioChatOptions extends ChatOptions$1 {
     initialMessages?: Message[];
     onFinish?: (response: ChatResponse) => void;
     onError?: (error: Error) => void;
@@ -314,7 +315,7 @@ interface UseBinarioChatReturn {
     lastResponse: ChatResponse | null;
 }
 declare function useBinarioChat(binario: BinarioAI, options?: UseBinarioChatOptions): UseBinarioChatReturn;
-interface UseBinarioStreamOptions extends ChatOptions {
+interface UseBinarioStreamOptions extends ChatOptions$1 {
     initialMessages?: Message[];
     onToken?: (token: string) => void;
     onFinish?: (response: ChatResponse) => void;
@@ -332,7 +333,7 @@ interface UseBinarioStreamReturn {
     setMessages: (messages: Message[]) => void;
 }
 declare function useBinarioStream(binario: BinarioAI, options?: UseBinarioStreamOptions): UseBinarioStreamReturn;
-interface UseBinarioCompletionOptions extends ChatOptions {
+interface UseBinarioCompletionOptions extends ChatOptions$1 {
     onFinish?: (response: ChatResponse) => void;
     onError?: (error: Error) => void;
 }
@@ -367,7 +368,7 @@ interface UseBinarioAgentReturn<TContext> {
     stop: () => void;
 }
 declare function useBinarioAgent<TContext = unknown, TDeps = unknown>(agent: Agent<TContext, TDeps>, options?: UseBinarioAgentOptions): UseBinarioAgentReturn<TContext>;
-interface UseBinarioStructuredOptions<T> extends ChatOptions {
+interface UseBinarioStructuredOptions<T> extends ChatOptions$1 {
     schema: z.ZodType<T>;
     onFinish?: (data: T) => void;
     onError?: (error: Error) => void;
@@ -552,4 +553,196 @@ interface UseBinarioSemanticSearchReturn {
 }
 declare function useBinarioSemanticSearch(options?: UseBinarioSemanticSearchOptions): UseBinarioSemanticSearchReturn;
 
-export { type EmbeddingsProviderType, type HookTool, type MemoryType, type SearchDocument, type SearchResult, type UseBinarioAgentOptions, type UseBinarioAgentReturn, type UseBinarioChatOptions, type UseBinarioChatReturn, type UseBinarioChatWithMemoryOptions, type UseBinarioChatWithMemoryReturn, type UseBinarioCompletionOptions, type UseBinarioEmbedOptions, type UseBinarioEmbedReturn, type UseBinarioMemoryOptions, type UseBinarioMemoryReturn, type UseBinarioSemanticSearchOptions, type UseBinarioSemanticSearchReturn, type UseBinarioStreamOptions, type UseBinarioStreamReturn, type UseBinarioStructuredOptions, type UseBinarioStructuredReturn, type UseBinarioToolsOptions, type UseBinarioToolsReturn, useBinarioAgent, useBinarioChat, useBinarioChatWithMemory, useBinarioCompletion, useBinarioEmbed, useBinarioMemory, useBinarioSemanticSearch, useBinarioStream, useBinarioStructured, useBinarioTools };
+interface BinarioOptions {
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+interface ChatOptions {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    systemPrompt?: string;
+    tools?: Tool[];
+    stream?: boolean;
+}
+interface StreamOptions extends ChatOptions {
+    onToken?: (token: string) => void;
+    onComplete?: (response: ChatResponse) => void;
+    onError?: (error: Error) => void;
+}
+interface AgentOptions {
+    name?: string;
+    systemPrompt?: string;
+    tools: Tool[];
+    maxIterations?: number;
+    model?: string;
+}
+interface UsageInfo {
+    requestsUsed: number;
+    requestsLimit: number;
+    tokensUsed: number;
+    plan: 'free' | 'pro' | 'enterprise';
+    resetAt: string;
+}
+/**
+ * Binario - Ultra-simple AI SDK
+ *
+ * @example
+ * ```typescript
+ * import { Binario } from 'binario';
+ *
+ * const ai = new Binario('bsk_your_api_key');
+ *
+ * // Simple chat
+ * const response = await ai.chat('Hello!');
+ * console.log(response.content);
+ *
+ * // Streaming
+ * for await (const token of ai.stream('Tell me a story')) {
+ *   process.stdout.write(token);
+ * }
+ *
+ * // Agent with tools
+ * const agent = ai.agent({
+ *   tools: [searchTool, calculatorTool],
+ *   systemPrompt: 'You are a helpful assistant'
+ * });
+ * const result = await agent.run('Search for weather in Madrid');
+ * ```
+ */
+declare class Binario {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    private maxRetries;
+    constructor(apiKey: string, options?: BinarioOptions);
+    /**
+     * Simple chat completion
+     */
+    chat(messageOrMessages: string | Message[], options?: ChatOptions): Promise<ChatResponse>;
+    /**
+     * Streaming chat - returns async iterator
+     */
+    stream(messageOrMessages: string | Message[], options?: ChatOptions): AsyncGenerator<string, ChatResponse, unknown>;
+    /**
+     * Stream with callbacks (alternative API)
+     */
+    streamWithCallbacks(messageOrMessages: string | Message[], options: StreamOptions): Promise<ChatResponse>;
+    /**
+     * Create an agent with tools
+     */
+    agent(options: AgentOptions): BinarioAgent;
+    /**
+     * Get current usage
+     */
+    getUsage(): Promise<UsageInfo>;
+    /**
+     * List available models
+     */
+    listModels(): Promise<{
+        id: string;
+        name: string;
+        free: boolean;
+    }[]>;
+    private normalizeMessages;
+    private getHeaders;
+    private request;
+}
+/**
+ * Binario Agent - Multi-step reasoning with tools
+ */
+declare class BinarioAgent {
+    private client;
+    private options;
+    constructor(client: Binario, options: AgentOptions);
+    /**
+     * Run the agent with a user message
+     */
+    run(message: string): Promise<AgentResult>;
+    /**
+     * Run agent with streaming
+     */
+    runStream(message: string): AsyncGenerator<{
+        type: 'thinking' | 'tool_call' | 'tool_result' | 'response';
+        content: string;
+        tool?: string;
+    }>;
+}
+
+interface BinarioProviderProps {
+    apiKey: string;
+    baseUrl?: string;
+    children: React.ReactNode;
+}
+declare function BinarioProvider({ apiKey, baseUrl, children }: BinarioProviderProps): react.ReactNode;
+declare function useBinarioClient(): Binario;
+interface UseChatOptions {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    systemPrompt?: string;
+    initialMessages?: Message[];
+    onFinish?: (response: any) => void;
+    onError?: (error: Error) => void;
+}
+interface UseChatReturn {
+    messages: Message[];
+    input: string;
+    setInput: (input: string) => void;
+    isLoading: boolean;
+    error: Error | null;
+    send: (content?: string) => Promise<void>;
+    setMessages: (messages: Message[]) => void;
+    stop: () => void;
+}
+declare function useChat(client: Binario, options?: UseChatOptions): UseChatReturn;
+interface UseStreamOptions extends UseChatOptions {
+    onToken?: (token: string) => void;
+}
+interface UseStreamReturn {
+    messages: Message[];
+    input: string;
+    setInput: (input: string) => void;
+    isStreaming: boolean;
+    error: Error | null;
+    streamingContent: string;
+    send: (content?: string) => Promise<void>;
+    setMessages: (messages: Message[]) => void;
+    stop: () => void;
+}
+declare function useStream(client: Binario, options?: UseStreamOptions): UseStreamReturn;
+interface UseAgentOptions {
+    name?: string;
+    systemPrompt?: string;
+    tools: AgentOptions['tools'];
+    maxIterations?: number;
+    model?: string;
+    onToolCall?: (tool: string, args: unknown) => void;
+    onError?: (error: Error) => void;
+}
+interface UseAgentReturn {
+    output: string;
+    isRunning: boolean;
+    error: Error | null;
+    toolCalls: Array<{
+        tool: string;
+        args: unknown;
+    }>;
+    run: (message: string) => Promise<string | null>;
+    stop: () => void;
+}
+declare function useAgent(client: Binario, options: UseAgentOptions): UseAgentReturn;
+interface UseUsageReturn {
+    usage: {
+        requestsUsed: number;
+        tokensUsed: number;
+        plan: string;
+    } | null;
+    isLoading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+declare function useUsage(client: Binario): UseUsageReturn;
+
+export { BinarioProvider, type BinarioProviderProps, type EmbeddingsProviderType, type HookTool, type MemoryType, type SearchDocument, type SearchResult, type UseAgentOptions, type UseAgentReturn, type UseBinarioAgentOptions, type UseBinarioAgentReturn, type UseBinarioChatOptions, type UseBinarioChatReturn, type UseBinarioChatWithMemoryOptions, type UseBinarioChatWithMemoryReturn, type UseBinarioCompletionOptions, type UseBinarioEmbedOptions, type UseBinarioEmbedReturn, type UseBinarioMemoryOptions, type UseBinarioMemoryReturn, type UseBinarioSemanticSearchOptions, type UseBinarioSemanticSearchReturn, type UseBinarioStreamOptions, type UseBinarioStreamReturn, type UseBinarioStructuredOptions, type UseBinarioStructuredReturn, type UseBinarioToolsOptions, type UseBinarioToolsReturn, type UseChatOptions, type UseChatReturn, type UseStreamOptions, type UseStreamReturn, type UseUsageReturn, useAgent, useBinarioAgent, useBinarioChat, useBinarioChatWithMemory, useBinarioClient, useBinarioCompletion, useBinarioEmbed, useBinarioMemory, useBinarioSemanticSearch, useBinarioStream, useBinarioStructured, useBinarioTools, useChat, useStream, useUsage };

package/dist/react.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import * as react from 'react';
 
 type Provider = 'openai' | 'anthropic' | 'google' | 'mistral' | 'cohere' | 'cloudflare' | 'lovable';
 interface Message {
@@ -31,7 +32,7 @@ interface StreamCallbacks {
     onComplete?: (response: ChatResponse) => void;
     onError?: (error: Error) => void;
 }
-interface ChatOptions {
+interface ChatOptions$1 {
     provider?: Provider;
     model?: string;
     temperature?: number;
@@ -147,9 +148,9 @@ declare class BinarioAI {
     private retryWithBackoff;
     private formatMessagesForProvider;
     private parseProviderResponse;
-    chat(messages: Message[], options?: ChatOptions): Promise<ChatResponse>;
+    chat(messages: Message[], options?: ChatOptions$1): Promise<ChatResponse>;
     private handleStructuredOutput;
-    streamChat(messages: Message[], options?: ChatOptions, callbacks?: StreamCallbacks): AsyncGenerator<string, ChatResponse, unknown>;
+    streamChat(messages: Message[], options?: ChatOptions$1, callbacks?: StreamCallbacks): AsyncGenerator<string, ChatResponse, unknown>;
     clearCache(): void;
 }
 
@@ -296,7 +297,7 @@ interface EmbeddingsProvider {
     embedMany(texts: string[]): Promise<BatchEmbeddingResult>;
 }
 
-interface UseBinarioChatOptions extends ChatOptions {
+interface UseBinarioChatOptions extends ChatOptions$1 {
     initialMessages?: Message[];
     onFinish?: (response: ChatResponse) => void;
     onError?: (error: Error) => void;
@@ -314,7 +315,7 @@ interface UseBinarioChatReturn {
     lastResponse: ChatResponse | null;
 }
 declare function useBinarioChat(binario: BinarioAI, options?: UseBinarioChatOptions): UseBinarioChatReturn;
-interface UseBinarioStreamOptions extends ChatOptions {
+interface UseBinarioStreamOptions extends ChatOptions$1 {
     initialMessages?: Message[];
     onToken?: (token: string) => void;
     onFinish?: (response: ChatResponse) => void;
@@ -332,7 +333,7 @@ interface UseBinarioStreamReturn {
     setMessages: (messages: Message[]) => void;
 }
 declare function useBinarioStream(binario: BinarioAI, options?: UseBinarioStreamOptions): UseBinarioStreamReturn;
-interface UseBinarioCompletionOptions extends ChatOptions {
+interface UseBinarioCompletionOptions extends ChatOptions$1 {
     onFinish?: (response: ChatResponse) => void;
     onError?: (error: Error) => void;
 }
@@ -367,7 +368,7 @@ interface UseBinarioAgentReturn<TContext> {
     stop: () => void;
 }
 declare function useBinarioAgent<TContext = unknown, TDeps = unknown>(agent: Agent<TContext, TDeps>, options?: UseBinarioAgentOptions): UseBinarioAgentReturn<TContext>;
-interface UseBinarioStructuredOptions<T> extends ChatOptions {
+interface UseBinarioStructuredOptions<T> extends ChatOptions$1 {
     schema: z.ZodType<T>;
     onFinish?: (data: T) => void;
     onError?: (error: Error) => void;
@@ -552,4 +553,196 @@ interface UseBinarioSemanticSearchReturn {
 }
 declare function useBinarioSemanticSearch(options?: UseBinarioSemanticSearchOptions): UseBinarioSemanticSearchReturn;
 
-export { type EmbeddingsProviderType, type HookTool, type MemoryType, type SearchDocument, type SearchResult, type UseBinarioAgentOptions, type UseBinarioAgentReturn, type UseBinarioChatOptions, type UseBinarioChatReturn, type UseBinarioChatWithMemoryOptions, type UseBinarioChatWithMemoryReturn, type UseBinarioCompletionOptions, type UseBinarioEmbedOptions, type UseBinarioEmbedReturn, type UseBinarioMemoryOptions, type UseBinarioMemoryReturn, type UseBinarioSemanticSearchOptions, type UseBinarioSemanticSearchReturn, type UseBinarioStreamOptions, type UseBinarioStreamReturn, type UseBinarioStructuredOptions, type UseBinarioStructuredReturn, type UseBinarioToolsOptions, type UseBinarioToolsReturn, useBinarioAgent, useBinarioChat, useBinarioChatWithMemory, useBinarioCompletion, useBinarioEmbed, useBinarioMemory, useBinarioSemanticSearch, useBinarioStream, useBinarioStructured, useBinarioTools };
+interface BinarioOptions {
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+interface ChatOptions {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    systemPrompt?: string;
+    tools?: Tool[];
+    stream?: boolean;
+}
+interface StreamOptions extends ChatOptions {
+    onToken?: (token: string) => void;
+    onComplete?: (response: ChatResponse) => void;
+    onError?: (error: Error) => void;
+}
+interface AgentOptions {
+    name?: string;
+    systemPrompt?: string;
+    tools: Tool[];
+    maxIterations?: number;
+    model?: string;
+}
+interface UsageInfo {
+    requestsUsed: number;
+    requestsLimit: number;
+    tokensUsed: number;
+    plan: 'free' | 'pro' | 'enterprise';
+    resetAt: string;
+}
+/**
+ * Binario - Ultra-simple AI SDK
+ *
+ * @example
+ * ```typescript
+ * import { Binario } from 'binario';
+ *
+ * const ai = new Binario('bsk_your_api_key');
+ *
+ * // Simple chat
+ * const response = await ai.chat('Hello!');
+ * console.log(response.content);
+ *
+ * // Streaming
+ * for await (const token of ai.stream('Tell me a story')) {
+ *   process.stdout.write(token);
+ * }
+ *
+ * // Agent with tools
+ * const agent = ai.agent({
+ *   tools: [searchTool, calculatorTool],
+ *   systemPrompt: 'You are a helpful assistant'
+ * });
+ * const result = await agent.run('Search for weather in Madrid');
+ * ```
+ */
+declare class Binario {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    private maxRetries;
+    constructor(apiKey: string, options?: BinarioOptions);
+    /**
+     * Simple chat completion
+     */
+    chat(messageOrMessages: string | Message[], options?: ChatOptions): Promise<ChatResponse>;
+    /**
+     * Streaming chat - returns async iterator
+     */
+    stream(messageOrMessages: string | Message[], options?: ChatOptions): AsyncGenerator<string, ChatResponse, unknown>;
+    /**
+     * Stream with callbacks (alternative API)
+     */
+    streamWithCallbacks(messageOrMessages: string | Message[], options: StreamOptions): Promise<ChatResponse>;
+    /**
+     * Create an agent with tools
+     */
+    agent(options: AgentOptions): BinarioAgent;
+    /**
+     * Get current usage
+     */
+    getUsage(): Promise<UsageInfo>;
+    /**
+     * List available models
+     */
+    listModels(): Promise<{
+        id: string;
+        name: string;
+        free: boolean;
+    }[]>;
+    private normalizeMessages;
+    private getHeaders;
+    private request;
+}
+/**
+ * Binario Agent - Multi-step reasoning with tools
+ */
+declare class BinarioAgent {
+    private client;
+    private options;
+    constructor(client: Binario, options: AgentOptions);
+    /**
+     * Run the agent with a user message
+     */
+    run(message: string): Promise<AgentResult>;
+    /**
+     * Run agent with streaming
+     */
+    runStream(message: string): AsyncGenerator<{
+        type: 'thinking' | 'tool_call' | 'tool_result' | 'response';
+        content: string;
+        tool?: string;
+    }>;
+}
+
+interface BinarioProviderProps {
+    apiKey: string;
+    baseUrl?: string;
+    children: React.ReactNode;
+}
+declare function BinarioProvider({ apiKey, baseUrl, children }: BinarioProviderProps): react.ReactNode;
+declare function useBinarioClient(): Binario;
+interface UseChatOptions {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    systemPrompt?: string;
+    initialMessages?: Message[];
+    onFinish?: (response: any) => void;
+    onError?: (error: Error) => void;
+}
+interface UseChatReturn {
+    messages: Message[];
+    input: string;
+    setInput: (input: string) => void;
+    isLoading: boolean;
+    error: Error | null;
+    send: (content?: string) => Promise<void>;
+    setMessages: (messages: Message[]) => void;
+    stop: () => void;
+}
+declare function useChat(client: Binario, options?: UseChatOptions): UseChatReturn;
+interface UseStreamOptions extends UseChatOptions {
+    onToken?: (token: string) => void;
+}
+interface UseStreamReturn {
+    messages: Message[];
+    input: string;
+    setInput: (input: string) => void;
+    isStreaming: boolean;
+    error: Error | null;
+    streamingContent: string;
+    send: (content?: string) => Promise<void>;
+    setMessages: (messages: Message[]) => void;
+    stop: () => void;
+}
+declare function useStream(client: Binario, options?: UseStreamOptions): UseStreamReturn;
+interface UseAgentOptions {
+    name?: string;
+    systemPrompt?: string;
+    tools: AgentOptions['tools'];
+    maxIterations?: number;
+    model?: string;
+    onToolCall?: (tool: string, args: unknown) => void;
+    onError?: (error: Error) => void;
+}
+interface UseAgentReturn {
+    output: string;
+    isRunning: boolean;
+    error: Error | null;
+    toolCalls: Array<{
+        tool: string;
+        args: unknown;
+    }>;
+    run: (message: string) => Promise<string | null>;
+    stop: () => void;
+}
+declare function useAgent(client: Binario, options: UseAgentOptions): UseAgentReturn;
+interface UseUsageReturn {
+    usage: {
+        requestsUsed: number;
+        tokensUsed: number;
+        plan: string;
+    } | null;
+    isLoading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+declare function useUsage(client: Binario): UseUsageReturn;
+
+export { BinarioProvider, type BinarioProviderProps, type EmbeddingsProviderType, type HookTool, type MemoryType, type SearchDocument, type SearchResult, type UseAgentOptions, type UseAgentReturn, type UseBinarioAgentOptions, type UseBinarioAgentReturn, type UseBinarioChatOptions, type UseBinarioChatReturn, type UseBinarioChatWithMemoryOptions, type UseBinarioChatWithMemoryReturn, type UseBinarioCompletionOptions, type UseBinarioEmbedOptions, type UseBinarioEmbedReturn, type UseBinarioMemoryOptions, type UseBinarioMemoryReturn, type UseBinarioSemanticSearchOptions, type UseBinarioSemanticSearchReturn, type UseBinarioStreamOptions, type UseBinarioStreamReturn, type UseBinarioStructuredOptions, type UseBinarioStructuredReturn, type UseBinarioToolsOptions, type UseBinarioToolsReturn, type UseChatOptions, type UseChatReturn, type UseStreamOptions, type UseStreamReturn, type UseUsageReturn, useAgent, useBinarioAgent, useBinarioChat, useBinarioChatWithMemory, useBinarioClient, useBinarioCompletion, useBinarioEmbed, useBinarioMemory, useBinarioSemanticSearch, useBinarioStream, useBinarioStructured, useBinarioTools, useChat, useStream, useUsage };