@blinkdotnew/sdk 2.3.3 → 2.3.4

package/dist/index.d.mts

@@ -2244,6 +2244,13 @@ interface SandboxCreateOptions {
     timeoutMs?: number;
     /** Custom metadata for tracking */
     metadata?: Record<string, string>;
+    /**
+     * Secret names to inject as environment variables.
+     * Secrets are resolved server-side from project secrets vault.
+     * Add secrets via Workspace > Secrets or request_secret tool.
+     * @example ['ANTHROPIC_API_KEY', 'GITHUB_TOKEN']
+     */
+    secrets?: string[];
 }
 interface SandboxConnectOptions {
     /** Reset inactivity timeout in ms (default: 5 min) */
@@ -2306,6 +2313,23 @@ declare class BlinkSandboxImpl implements BlinkSandbox {
  * Factory function and client class for the Blink SDK
  */
 
+/**
+ * Get the default Blink client instance.
+ * Returns the client created by createClient().
+ *
+ * @throws Error if createClient() hasn't been called yet
+ * @returns The default BlinkClient instance
+ *
+ * @example
+ * ```ts
+ * // First, create client somewhere in your app
+ * createClient({ projectId: '...', secretKey: '...' })
+ *
+ * // Later, get the default client
+ * const client = getDefaultClient()
+ * ```
+ */
+declare function getDefaultClient(): BlinkClientImpl;
 interface BlinkClient {
     auth: BlinkAuth;
     db: BlinkDatabase;
@@ -2320,8 +2344,39 @@ interface BlinkClient {
     rag: BlinkRAG;
     sandbox: BlinkSandbox;
 }
+declare class BlinkClientImpl implements BlinkClient {
+    auth: BlinkAuth;
+    db: BlinkDatabase;
+    storage: BlinkStorage;
+    ai: BlinkAI;
+    data: BlinkData;
+    realtime: BlinkRealtime;
+    notifications: BlinkNotifications;
+    analytics: BlinkAnalytics;
+    connectors: BlinkConnectors;
+    functions: BlinkFunctions;
+    rag: BlinkRAG;
+    sandbox: BlinkSandbox;
+    /** @internal HTTP client for Agent auto-binding */
+    _httpClient: HttpClient;
+    constructor(config: BlinkClientConfig);
+}
 /**
- * Create a new Blink client instance
+ * Create a new Blink client instance.
+ * This also sets the default client for Agent auto-binding.
+ *
+ * @example
+ * ```ts
+ * // Create client (call once in your app)
+ * const blink = createClient({
+ *   projectId: 'my-project',
+ *   secretKey: 'sk_...',
+ * })
+ *
+ * // Now Agent works without explicit binding
+ * const agent = new Agent({ model: 'openai/gpt-4o' })
+ * await agent.generate({ prompt: 'Hello!' })
+ * ```
  */
 declare function createClient(config: BlinkClientConfig): BlinkClient;
 
@@ -2620,6 +2675,8 @@ interface AgentResponse {
  * - Create agent instance with config
  * - Call agent.generate() for non-streaming
  * - Call agent.stream() for streaming
+ *
+ * Auto-binds to default client when createClient() has been called.
  */
 
 /**
@@ -2679,34 +2736,38 @@ interface StreamOptions {
  * - `agent.generate({ prompt })` for non-streaming one-shot generation
  * - `agent.stream({ prompt })` for streaming real-time generation
  *
+ * **Auto-binding:** After calling `createClient()`, agents automatically
+ * bind to the default client. No need for `blink.ai.createAgent()`.
+ *
  * @example
  * ```ts
- * import { Agent, webSearch, fetchUrl } from '@blinkdotnew/sdk'
+ * import { createClient, Agent, webSearch } from '@blinkdotnew/sdk'
  *
+ * // Initialize client once
+ * createClient({ projectId: '...', secretKey: '...' })
+ *
+ * // Create agent - auto-binds to default client
  * const weatherAgent = new Agent({
  *   model: 'anthropic/claude-sonnet-4-20250514',
  *   system: 'You are a helpful weather assistant.',
- *   tools: [webSearch, fetchUrl],
+ *   tools: [webSearch],
  *   maxSteps: 10,
  * })
  *
- * // Non-streaming
+ * // Works immediately - no binding needed!
  * const result = await weatherAgent.generate({
  *   prompt: 'What is the weather in San Francisco?',
  * })
  * console.log(result.text)
- *
- * // Streaming
- * const stream = await weatherAgent.stream({
- *   prompt: 'Tell me about weather patterns',
- * })
  * ```
  */
 declare class Agent {
     private httpClient;
     private readonly config;
     /**
-     * Create a new Agent instance
+     * Create a new Agent instance.
+     * Auto-binds to default client if createClient() was called.
+     *
      * @param options - Agent configuration options
      */
     constructor(options: AgentOptions);
@@ -3661,4 +3722,4 @@ declare const mediaTools: readonly ["generate_image", "edit_image", "generate_vi
  */
 declare function serializeTools(tools: string[]): string[];
 
-export { type AISearchOptions, Agent, type AgentBilling, type AgentConfig, type AgentNonStreamMessagesRequest, type AgentNonStreamPromptRequest, type AgentOptions, type AgentRequest, type AgentResponse, type AgentStep, type AgentStreamRequest, type TokenUsage as AgentTokenUsage, type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkRAG, BlinkRAGImpl, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkSandbox, BlinkSandboxImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkTokenType, type BlinkUser, type ClientTool, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type ContextPolicy, type CreateCollectionOptions, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type GenerateOptions, type ImageGenerationRequest, type ImageGenerationResponse, type JSONSchema, type ListDocumentsOptions, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type RAGAISearchResult, type RAGAISearchSource, type RAGCollection, type RAGDocument, type RAGSearchResponse, type RAGSearchResult, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, SANDBOX_TEMPLATES, type Sandbox, type SandboxConnectOptions, SandboxConnectionError, type SandboxCreateOptions, type SandboxTemplate, type SearchOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StopCondition, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type StreamOptions, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenIntrospectionResult, type TokenUsage$1 as TokenUsage, type ToolCall, type ToolResult, type TranscriptionRequest, type TranscriptionResponse, type UIMessage, type UIMessagePart, type UpdateOptions, type UploadOptions, type UpsertOptions, type WaitForReadyOptions, type WebBrowserModule, WebStorageAdapter, type WebhookTool, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };
+export { type AISearchOptions, Agent, type AgentBilling, type AgentConfig, type AgentNonStreamMessagesRequest, type AgentNonStreamPromptRequest, type AgentOptions, type AgentRequest, type AgentResponse, type AgentStep, type AgentStreamRequest, type TokenUsage as AgentTokenUsage, type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkRAG, BlinkRAGImpl, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkSandbox, BlinkSandboxImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkTokenType, type BlinkUser, type ClientTool, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type ContextPolicy, type CreateCollectionOptions, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type GenerateOptions, type ImageGenerationRequest, type ImageGenerationResponse, type JSONSchema, type ListDocumentsOptions, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type RAGAISearchResult, type RAGAISearchSource, type RAGCollection, type RAGDocument, type RAGSearchResponse, type RAGSearchResult, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, SANDBOX_TEMPLATES, type Sandbox, type SandboxConnectOptions, SandboxConnectionError, type SandboxCreateOptions, type SandboxTemplate, type SearchOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StopCondition, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type StreamOptions, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenIntrospectionResult, type TokenUsage$1 as TokenUsage, type ToolCall, type ToolResult, type TranscriptionRequest, type TranscriptionResponse, type UIMessage, type UIMessagePart, type UpdateOptions, type UploadOptions, type UpsertOptions, type WaitForReadyOptions, type WebBrowserModule, WebStorageAdapter, type WebhookTool, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultClient, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };

package/dist/index.d.ts

@@ -2244,6 +2244,13 @@ interface SandboxCreateOptions {
     timeoutMs?: number;
     /** Custom metadata for tracking */
     metadata?: Record<string, string>;
+    /**
+     * Secret names to inject as environment variables.
+     * Secrets are resolved server-side from project secrets vault.
+     * Add secrets via Workspace > Secrets or request_secret tool.
+     * @example ['ANTHROPIC_API_KEY', 'GITHUB_TOKEN']
+     */
+    secrets?: string[];
 }
 interface SandboxConnectOptions {
     /** Reset inactivity timeout in ms (default: 5 min) */
@@ -2306,6 +2313,23 @@ declare class BlinkSandboxImpl implements BlinkSandbox {
  * Factory function and client class for the Blink SDK
  */
 
+/**
+ * Get the default Blink client instance.
+ * Returns the client created by createClient().
+ *
+ * @throws Error if createClient() hasn't been called yet
+ * @returns The default BlinkClient instance
+ *
+ * @example
+ * ```ts
+ * // First, create client somewhere in your app
+ * createClient({ projectId: '...', secretKey: '...' })
+ *
+ * // Later, get the default client
+ * const client = getDefaultClient()
+ * ```
+ */
+declare function getDefaultClient(): BlinkClientImpl;
 interface BlinkClient {
     auth: BlinkAuth;
     db: BlinkDatabase;
@@ -2320,8 +2344,39 @@ interface BlinkClient {
     rag: BlinkRAG;
     sandbox: BlinkSandbox;
 }
+declare class BlinkClientImpl implements BlinkClient {
+    auth: BlinkAuth;
+    db: BlinkDatabase;
+    storage: BlinkStorage;
+    ai: BlinkAI;
+    data: BlinkData;
+    realtime: BlinkRealtime;
+    notifications: BlinkNotifications;
+    analytics: BlinkAnalytics;
+    connectors: BlinkConnectors;
+    functions: BlinkFunctions;
+    rag: BlinkRAG;
+    sandbox: BlinkSandbox;
+    /** @internal HTTP client for Agent auto-binding */
+    _httpClient: HttpClient;
+    constructor(config: BlinkClientConfig);
+}
 /**
- * Create a new Blink client instance
+ * Create a new Blink client instance.
+ * This also sets the default client for Agent auto-binding.
+ *
+ * @example
+ * ```ts
+ * // Create client (call once in your app)
+ * const blink = createClient({
+ *   projectId: 'my-project',
+ *   secretKey: 'sk_...',
+ * })
+ *
+ * // Now Agent works without explicit binding
+ * const agent = new Agent({ model: 'openai/gpt-4o' })
+ * await agent.generate({ prompt: 'Hello!' })
+ * ```
  */
 declare function createClient(config: BlinkClientConfig): BlinkClient;
 
@@ -2620,6 +2675,8 @@ interface AgentResponse {
  * - Create agent instance with config
  * - Call agent.generate() for non-streaming
  * - Call agent.stream() for streaming
+ *
+ * Auto-binds to default client when createClient() has been called.
  */
 
 /**
@@ -2679,34 +2736,38 @@ interface StreamOptions {
  * - `agent.generate({ prompt })` for non-streaming one-shot generation
  * - `agent.stream({ prompt })` for streaming real-time generation
  *
+ * **Auto-binding:** After calling `createClient()`, agents automatically
+ * bind to the default client. No need for `blink.ai.createAgent()`.
+ *
  * @example
  * ```ts
- * import { Agent, webSearch, fetchUrl } from '@blinkdotnew/sdk'
+ * import { createClient, Agent, webSearch } from '@blinkdotnew/sdk'
  *
+ * // Initialize client once
+ * createClient({ projectId: '...', secretKey: '...' })
+ *
+ * // Create agent - auto-binds to default client
  * const weatherAgent = new Agent({
  *   model: 'anthropic/claude-sonnet-4-20250514',
  *   system: 'You are a helpful weather assistant.',
- *   tools: [webSearch, fetchUrl],
+ *   tools: [webSearch],
  *   maxSteps: 10,
  * })
  *
- * // Non-streaming
+ * // Works immediately - no binding needed!
  * const result = await weatherAgent.generate({
  *   prompt: 'What is the weather in San Francisco?',
  * })
  * console.log(result.text)
- *
- * // Streaming
- * const stream = await weatherAgent.stream({
- *   prompt: 'Tell me about weather patterns',
- * })
  * ```
  */
 declare class Agent {
     private httpClient;
     private readonly config;
     /**
-     * Create a new Agent instance
+     * Create a new Agent instance.
+     * Auto-binds to default client if createClient() was called.
+     *
      * @param options - Agent configuration options
      */
     constructor(options: AgentOptions);
@@ -3661,4 +3722,4 @@ declare const mediaTools: readonly ["generate_image", "edit_image", "generate_vi
  */
 declare function serializeTools(tools: string[]): string[];
 
-export { type AISearchOptions, Agent, type AgentBilling, type AgentConfig, type AgentNonStreamMessagesRequest, type AgentNonStreamPromptRequest, type AgentOptions, type AgentRequest, type AgentResponse, type AgentStep, type AgentStreamRequest, type TokenUsage as AgentTokenUsage, type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkRAG, BlinkRAGImpl, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkSandbox, BlinkSandboxImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkTokenType, type BlinkUser, type ClientTool, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type ContextPolicy, type CreateCollectionOptions, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type GenerateOptions, type ImageGenerationRequest, type ImageGenerationResponse, type JSONSchema, type ListDocumentsOptions, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type RAGAISearchResult, type RAGAISearchSource, type RAGCollection, type RAGDocument, type RAGSearchResponse, type RAGSearchResult, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, SANDBOX_TEMPLATES, type Sandbox, type SandboxConnectOptions, SandboxConnectionError, type SandboxCreateOptions, type SandboxTemplate, type SearchOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StopCondition, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type StreamOptions, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenIntrospectionResult, type TokenUsage$1 as TokenUsage, type ToolCall, type ToolResult, type TranscriptionRequest, type TranscriptionResponse, type UIMessage, type UIMessagePart, type UpdateOptions, type UploadOptions, type UpsertOptions, type WaitForReadyOptions, type WebBrowserModule, WebStorageAdapter, type WebhookTool, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };
+export { type AISearchOptions, Agent, type AgentBilling, type AgentConfig, type AgentNonStreamMessagesRequest, type AgentNonStreamPromptRequest, type AgentOptions, type AgentRequest, type AgentResponse, type AgentStep, type AgentStreamRequest, type TokenUsage as AgentTokenUsage, type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkRAG, BlinkRAGImpl, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkSandbox, BlinkSandboxImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkTokenType, type BlinkUser, type ClientTool, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type ContextPolicy, type CreateCollectionOptions, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type GenerateOptions, type ImageGenerationRequest, type ImageGenerationResponse, type JSONSchema, type ListDocumentsOptions, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type RAGAISearchResult, type RAGAISearchSource, type RAGCollection, type RAGDocument, type RAGSearchResponse, type RAGSearchResult, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, SANDBOX_TEMPLATES, type Sandbox, type SandboxConnectOptions, SandboxConnectionError, type SandboxCreateOptions, type SandboxTemplate, type SearchOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StopCondition, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type StreamOptions, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenIntrospectionResult, type TokenUsage$1 as TokenUsage, type ToolCall, type ToolResult, type TranscriptionRequest, type TranscriptionResponse, type UIMessage, type UIMessagePart, type UpdateOptions, type UploadOptions, type UpsertOptions, type WaitForReadyOptions, type WebBrowserModule, WebStorageAdapter, type WebhookTool, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultClient, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };

package/dist/index.js

@@ -6454,7 +6454,9 @@ var Agent = class {
   httpClient = null;
   config;
   /**
-   * Create a new Agent instance
+   * Create a new Agent instance.
+   * Auto-binds to default client if createClient() was called.
+   * 
    * @param options - Agent configuration options
    */
   constructor(options) {
@@ -6462,6 +6464,10 @@ var Agent = class {
       throw new BlinkAIError("Agent model is required");
     }
     this.config = options;
+    try {
+      this.httpClient = _getDefaultHttpClient();
+    } catch {
+    }
   }
   /**
    * Internal: Set the HTTP client (called by BlinkClient)
@@ -6504,7 +6510,7 @@ var Agent = class {
   async generate(options) {
     if (!this.httpClient) {
       throw new BlinkAIError(
-        "Agent not initialized. Use blink.ai.createAgent() or pass the agent to useAgent()."
+        "Agent not initialized. Call createClient() first, or use useAgent() in React."
       );
     }
     if (!options.prompt && !options.messages) {
@@ -6561,7 +6567,7 @@ var Agent = class {
   async stream(options) {
     if (!this.httpClient) {
       throw new BlinkAIError(
-        "Agent not initialized. Use blink.ai.createAgent() or pass the agent to useAgent()."
+        "Agent not initialized. Call createClient() first, or use useAgent() in React."
       );
     }
     if (!options.prompt && !options.messages) {
@@ -9173,7 +9179,8 @@ var BlinkSandboxImpl = class {
     const body = {
       template: options.template,
       timeout_ms: options.timeoutMs,
-      metadata: options.metadata
+      metadata: options.metadata,
+      secrets: options.secrets
     };
     const response = await this.httpClient.post(this.url("/create"), body);
     const { id, template, host_pattern } = response.data;
@@ -9211,6 +9218,18 @@ var BlinkSandboxImpl = class {
 };
 
 // src/client.ts
+var defaultClient = null;
+function getDefaultClient() {
+  if (!defaultClient) {
+    throw new Error(
+      "No Blink client initialized. Call createClient() first before using Agent or other SDK features."
+    );
+  }
+  return defaultClient;
+}
+function _getDefaultHttpClient() {
+  return getDefaultClient()._httpClient;
+}
 var BlinkClientImpl = class {
   auth;
   db;
@@ -9224,32 +9243,33 @@ var BlinkClientImpl = class {
   functions;
   rag;
   sandbox;
-  httpClient;
+  /** @internal HTTP client for Agent auto-binding */
+  _httpClient;
   constructor(config) {
     if ((config.secretKey || config.serviceToken) && isBrowser) {
       throw new Error("secretKey/serviceToken is server-only. Do not provide it in browser/React Native clients.");
     }
     this.auth = new BlinkAuth(config);
-    this.httpClient = new HttpClient(
+    this._httpClient = new HttpClient(
       config,
       () => this.auth.getToken(),
       () => this.auth.getValidToken()
     );
-    this.db = new BlinkDatabase(this.httpClient);
-    this.storage = new BlinkStorageImpl(this.httpClient);
-    this.ai = new BlinkAIImpl(this.httpClient);
-    this.data = new BlinkDataImpl(this.httpClient, config.projectId);
-    this.realtime = new BlinkRealtimeImpl(this.httpClient, config.projectId);
-    this.notifications = new BlinkNotificationsImpl(this.httpClient);
-    this.analytics = new BlinkAnalyticsImpl(this.httpClient, config.projectId);
-    this.connectors = new BlinkConnectorsImpl(this.httpClient);
+    this.db = new BlinkDatabase(this._httpClient);
+    this.storage = new BlinkStorageImpl(this._httpClient);
+    this.ai = new BlinkAIImpl(this._httpClient);
+    this.data = new BlinkDataImpl(this._httpClient, config.projectId);
+    this.realtime = new BlinkRealtimeImpl(this._httpClient, config.projectId);
+    this.notifications = new BlinkNotificationsImpl(this._httpClient);
+    this.analytics = new BlinkAnalyticsImpl(this._httpClient, config.projectId);
+    this.connectors = new BlinkConnectorsImpl(this._httpClient);
     this.functions = new BlinkFunctionsImpl(
-      this.httpClient,
+      this._httpClient,
       config.projectId,
       () => this.auth.getValidToken()
     );
-    this.rag = new BlinkRAGImpl(this.httpClient);
-    this.sandbox = new BlinkSandboxImpl(this.httpClient);
+    this.rag = new BlinkRAGImpl(this._httpClient);
+    this.sandbox = new BlinkSandboxImpl(this._httpClient);
     this.auth.onAuthStateChanged((state) => {
       if (state.isAuthenticated && state.user) {
         this.analytics.setUserId(state.user.id);
@@ -9265,7 +9285,9 @@ function createClient(config) {
   if (!config.projectId) {
     throw new Error("projectId is required");
   }
-  return new BlinkClientImpl(config);
+  const client = new BlinkClientImpl(config);
+  defaultClient = client;
+  return client;
 }
 
 exports.Agent = Agent;
@@ -9297,6 +9319,7 @@ exports.editImage = editImage;
 exports.fetchUrl = fetchUrl;
 exports.generateImage = generateImage;
 exports.generateVideo = generateVideo;
+exports.getDefaultClient = getDefaultClient;
 exports.getDefaultStorageAdapter = getDefaultStorageAdapter;
 exports.getHost = getHost;
 exports.globFileSearch = globFileSearch;

package/dist/index.mjs

@@ -6452,7 +6452,9 @@ var Agent = class {
   httpClient = null;
   config;
   /**
-   * Create a new Agent instance
+   * Create a new Agent instance.
+   * Auto-binds to default client if createClient() was called.
+   * 
    * @param options - Agent configuration options
    */
   constructor(options) {
@@ -6460,6 +6462,10 @@ var Agent = class {
       throw new BlinkAIError("Agent model is required");
     }
     this.config = options;
+    try {
+      this.httpClient = _getDefaultHttpClient();
+    } catch {
+    }
   }
   /**
    * Internal: Set the HTTP client (called by BlinkClient)
@@ -6502,7 +6508,7 @@ var Agent = class {
   async generate(options) {
     if (!this.httpClient) {
       throw new BlinkAIError(
-        "Agent not initialized. Use blink.ai.createAgent() or pass the agent to useAgent()."
+        "Agent not initialized. Call createClient() first, or use useAgent() in React."
       );
     }
     if (!options.prompt && !options.messages) {
@@ -6559,7 +6565,7 @@ var Agent = class {
   async stream(options) {
     if (!this.httpClient) {
       throw new BlinkAIError(
-        "Agent not initialized. Use blink.ai.createAgent() or pass the agent to useAgent()."
+        "Agent not initialized. Call createClient() first, or use useAgent() in React."
       );
     }
     if (!options.prompt && !options.messages) {
@@ -9171,7 +9177,8 @@ var BlinkSandboxImpl = class {
     const body = {
       template: options.template,
       timeout_ms: options.timeoutMs,
-      metadata: options.metadata
+      metadata: options.metadata,
+      secrets: options.secrets
     };
     const response = await this.httpClient.post(this.url("/create"), body);
     const { id, template, host_pattern } = response.data;
@@ -9209,6 +9216,18 @@ var BlinkSandboxImpl = class {
 };
 
 // src/client.ts
+var defaultClient = null;
+function getDefaultClient() {
+  if (!defaultClient) {
+    throw new Error(
+      "No Blink client initialized. Call createClient() first before using Agent or other SDK features."
+    );
+  }
+  return defaultClient;
+}
+function _getDefaultHttpClient() {
+  return getDefaultClient()._httpClient;
+}
 var BlinkClientImpl = class {
   auth;
   db;
@@ -9222,32 +9241,33 @@ var BlinkClientImpl = class {
   functions;
   rag;
   sandbox;
-  httpClient;
+  /** @internal HTTP client for Agent auto-binding */
+  _httpClient;
   constructor(config) {
     if ((config.secretKey || config.serviceToken) && isBrowser) {
       throw new Error("secretKey/serviceToken is server-only. Do not provide it in browser/React Native clients.");
     }
     this.auth = new BlinkAuth(config);
-    this.httpClient = new HttpClient(
+    this._httpClient = new HttpClient(
       config,
       () => this.auth.getToken(),
       () => this.auth.getValidToken()
     );
-    this.db = new BlinkDatabase(this.httpClient);
-    this.storage = new BlinkStorageImpl(this.httpClient);
-    this.ai = new BlinkAIImpl(this.httpClient);
-    this.data = new BlinkDataImpl(this.httpClient, config.projectId);
-    this.realtime = new BlinkRealtimeImpl(this.httpClient, config.projectId);
-    this.notifications = new BlinkNotificationsImpl(this.httpClient);
-    this.analytics = new BlinkAnalyticsImpl(this.httpClient, config.projectId);
-    this.connectors = new BlinkConnectorsImpl(this.httpClient);
+    this.db = new BlinkDatabase(this._httpClient);
+    this.storage = new BlinkStorageImpl(this._httpClient);
+    this.ai = new BlinkAIImpl(this._httpClient);
+    this.data = new BlinkDataImpl(this._httpClient, config.projectId);
+    this.realtime = new BlinkRealtimeImpl(this._httpClient, config.projectId);
+    this.notifications = new BlinkNotificationsImpl(this._httpClient);
+    this.analytics = new BlinkAnalyticsImpl(this._httpClient, config.projectId);
+    this.connectors = new BlinkConnectorsImpl(this._httpClient);
     this.functions = new BlinkFunctionsImpl(
-      this.httpClient,
+      this._httpClient,
       config.projectId,
       () => this.auth.getValidToken()
     );
-    this.rag = new BlinkRAGImpl(this.httpClient);
-    this.sandbox = new BlinkSandboxImpl(this.httpClient);
+    this.rag = new BlinkRAGImpl(this._httpClient);
+    this.sandbox = new BlinkSandboxImpl(this._httpClient);
     this.auth.onAuthStateChanged((state) => {
       if (state.isAuthenticated && state.user) {
         this.analytics.setUserId(state.user.id);
@@ -9263,9 +9283,11 @@ function createClient(config) {
   if (!config.projectId) {
     throw new Error("projectId is required");
   }
-  return new BlinkClientImpl(config);
+  const client = new BlinkClientImpl(config);
+  defaultClient = client;
+  return client;
 }
 
-export { Agent, AsyncStorageAdapter, BlinkAIImpl, BlinkAnalyticsImpl, BlinkConnectorsImpl, BlinkDataImpl, BlinkDatabase, BlinkRAGImpl, BlinkRealtimeChannel, BlinkRealtimeImpl, BlinkSandboxImpl, BlinkStorageImpl, BlinkTable, NoOpStorageAdapter, SANDBOX_TEMPLATES, SandboxConnectionError, WebStorageAdapter, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };
+export { Agent, AsyncStorageAdapter, BlinkAIImpl, BlinkAnalyticsImpl, BlinkConnectorsImpl, BlinkDataImpl, BlinkDatabase, BlinkRAGImpl, BlinkRealtimeChannel, BlinkRealtimeImpl, BlinkSandboxImpl, BlinkStorageImpl, BlinkTable, NoOpStorageAdapter, SANDBOX_TEMPLATES, SandboxConnectionError, WebStorageAdapter, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultClient, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth + AI + analytics + notifications for modern SaaS/AI apps",
   "keywords": [
     "blink",
@@ -51,8 +51,10 @@
   },
   "dependencies": {},
   "devDependencies": {
+    "@blink/core": "0.4.1",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "@blinkdotnew/dev-sdk": "workspace:*"
   },
   "peerDependencies": {},
   "publishConfig": {