@blinkdotnew/sdk 0.3.0 → 0.4.0

package/README.md

@@ -75,7 +75,7 @@ This SDK powers every Blink-generated app with:
 
 - **🔐 Authentication**: JWT-based auth with automatic token management
 - **🗄️ Database**: PostgREST-compatible CRUD operations with advanced filtering  
-- **🤖 AI**: Text generation, object generation, image creation, speech synthesis, and transcription
+- **🤖 AI**: Text generation with web search, object generation, image creation, speech synthesis, and transcription
 - **📄 Data**: Extract text content from documents, spreadsheets, and more
 - **📁 Storage**: File upload, download, and management
 - **🌐 Universal**: Works on client-side and server-side
@@ -184,6 +184,19 @@ const { text } = await blink.ai.generateText({
   maxTokens: 150
 })
 
+// Web search (OpenAI only) - get real-time information
+const { text, sources } = await blink.ai.generateText({
+  prompt: 'Who is the current US president?',
+  search: true // Returns current info + source URLs
+})
+
+// Multi-step reasoning - for complex analysis
+const { text } = await blink.ai.generateText({
+  prompt: 'Research and analyze tech trends',
+  search: true,
+  maxSteps: 5 // Default: 25 when tools used
+})
+
 // Text generation with image content
 const { text } = await blink.ai.generateText({
   messages: [
@@ -247,6 +260,12 @@ await blink.ai.streamText(
   { prompt: 'Write a story...' },
   (chunk) => console.log(chunk)
 )
+
+// Streaming with web search
+await blink.ai.streamText(
+  { prompt: 'Latest AI news', search: true },
+  (chunk) => console.log(chunk)
+)
 ```
 
 ### Data Operations

package/dist/index.d.mts

@@ -320,7 +320,7 @@ declare class BlinkAIImpl implements BlinkAI {
      * @param options - An object containing either:
      *   - `prompt`: a simple string prompt
      *   - OR `messages`: an array of chat messages for conversation
-     *   - Plus optional model, maxTokens, temperature, signal parameters
+     *   - Plus optional model, search, maxSteps, experimental_continueSteps, maxTokens, temperature, signal parameters
      *
      * @example
      * ```ts
@@ -371,6 +371,22 @@ declare class BlinkAIImpl implements BlinkAI {
      *   maxTokens: 150,
      *   temperature: 0.7
      * });
+     *
+     * // With web search (OpenAI models only)
+     * const { text, sources } = await blink.ai.generateText({
+     *   prompt: "What are the latest developments in AI?",
+     *   model: "gpt-4o-mini",
+     *   search: true // Enables web search
+     * });
+     *
+     * // With advanced multi-step configuration
+     * const { text } = await blink.ai.generateText({
+     *   prompt: "Research and analyze recent tech trends",
+     *   model: "gpt-4o",
+     *   search: true,
+     *   maxSteps: 10, // Allow up to 10 reasoning steps
+     *   experimental_continueSteps: true // Enable continued reasoning
+     * });
      * ```
      *
      * @returns Promise<TextGenerationResponse> - Object containing:
@@ -382,7 +398,7 @@ declare class BlinkAIImpl implements BlinkAI {
     /**
      * Streams text generation with real-time updates as the AI generates content.
      *
-     * @param options - Same as generateText: either `prompt` or `messages` with optional parameters
+     * @param options - Same as generateText: either `prompt` or `messages` with optional parameters including search, maxSteps, experimental_continueSteps
      * @param onChunk - Callback function that receives each text chunk as it's generated
      *
      * @example

package/dist/index.d.ts

@@ -320,7 +320,7 @@ declare class BlinkAIImpl implements BlinkAI {
      * @param options - An object containing either:
      *   - `prompt`: a simple string prompt
      *   - OR `messages`: an array of chat messages for conversation
-     *   - Plus optional model, maxTokens, temperature, signal parameters
+     *   - Plus optional model, search, maxSteps, experimental_continueSteps, maxTokens, temperature, signal parameters
      *
      * @example
      * ```ts
@@ -371,6 +371,22 @@ declare class BlinkAIImpl implements BlinkAI {
      *   maxTokens: 150,
      *   temperature: 0.7
      * });
+     *
+     * // With web search (OpenAI models only)
+     * const { text, sources } = await blink.ai.generateText({
+     *   prompt: "What are the latest developments in AI?",
+     *   model: "gpt-4o-mini",
+     *   search: true // Enables web search
+     * });
+     *
+     * // With advanced multi-step configuration
+     * const { text } = await blink.ai.generateText({
+     *   prompt: "Research and analyze recent tech trends",
+     *   model: "gpt-4o",
+     *   search: true,
+     *   maxSteps: 10, // Allow up to 10 reasoning steps
+     *   experimental_continueSteps: true // Enable continued reasoning
+     * });
      * ```
      *
      * @returns Promise<TextGenerationResponse> - Object containing:
@@ -382,7 +398,7 @@ declare class BlinkAIImpl implements BlinkAI {
     /**
      * Streams text generation with real-time updates as the AI generates content.
      *
-     * @param options - Same as generateText: either `prompt` or `messages` with optional parameters
+     * @param options - Same as generateText: either `prompt` or `messages` with optional parameters including search, maxSteps, experimental_continueSteps
      * @param onChunk - Callback function that receives each text chunk as it's generated
      *
      * @example

package/dist/index.js

@@ -1707,7 +1707,7 @@ var BlinkAIImpl = class {
    * @param options - An object containing either:
    *   - `prompt`: a simple string prompt
    *   - OR `messages`: an array of chat messages for conversation
-   *   - Plus optional model, maxTokens, temperature, signal parameters
+   *   - Plus optional model, search, maxSteps, experimental_continueSteps, maxTokens, temperature, signal parameters
    * 
    * @example
    * ```ts
@@ -1758,6 +1758,22 @@ var BlinkAIImpl = class {
    *   maxTokens: 150,
    *   temperature: 0.7
    * });
+   * 
+   * // With web search (OpenAI models only)
+   * const { text, sources } = await blink.ai.generateText({
+   *   prompt: "What are the latest developments in AI?",
+   *   model: "gpt-4o-mini",
+   *   search: true // Enables web search
+   * });
+   * 
+   * // With advanced multi-step configuration
+   * const { text } = await blink.ai.generateText({
+   *   prompt: "Research and analyze recent tech trends",
+   *   model: "gpt-4o",
+   *   search: true,
+   *   maxSteps: 10, // Allow up to 10 reasoning steps
+   *   experimental_continueSteps: true // Enable continued reasoning
+   * });
    * ```
    * 
    * @returns Promise<TextGenerationResponse> - Object containing:
@@ -1779,6 +1795,9 @@ var BlinkAIImpl = class {
       const requestBody = {
         model: options.model,
         stream: false,
+        search: options.search,
+        maxSteps: options.maxSteps,
+        experimental_continueSteps: options.experimental_continueSteps,
         maxTokens: options.maxTokens,
         temperature: options.temperature,
         signal: options.signal
@@ -1814,7 +1833,7 @@ var BlinkAIImpl = class {
   /**
    * Streams text generation with real-time updates as the AI generates content.
    * 
-   * @param options - Same as generateText: either `prompt` or `messages` with optional parameters
+   * @param options - Same as generateText: either `prompt` or `messages` with optional parameters including search, maxSteps, experimental_continueSteps
    * @param onChunk - Callback function that receives each text chunk as it's generated
    * 
    * @example
@@ -1857,6 +1876,9 @@ var BlinkAIImpl = class {
         {
           model: options.model,
           messages: options.messages,
+          search: options.search,
+          maxSteps: options.maxSteps,
+          experimental_continueSteps: options.experimental_continueSteps,
           maxTokens: options.maxTokens,
           temperature: options.temperature,
           signal: options.signal