quantum-ai-sdk 0.2.2 → 0.3.0

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { RealtimeSender, RealtimeReceiver } from "./realtime.js";
 import type { RealtimeConfig, RealtimeSession } from "./realtime.js";
-import type { AccountPricingResponse, AgentEvent, AgentRequest, AlignRequest, AlignResponse, AsyncJobResponse, AuthAppleRequest, AuthResponse, AvatarsResponse, BalanceResponse, BatchJobInfo, BatchJobsResponse, BatchJsonlResponse, BatchSubmitRequest, BatchSubmitResponse, ChatRequest, ChatResponse, ChunkDocumentRequest, ChunkDocumentResponse, ClientOptions, CloneVoiceRequest, CloneVoiceResponse, CreateKeyRequest, CreateKeyResponse, CreditBalanceResponse, CreditPacksResponse, CreditPurchaseRequest, CreditPurchaseResponse, CreditTiersResponse, DeleteResponse, DevProgramApplyRequest, DevProgramApplyResponse, DialogueRequest, DialogueResponse, DigitalTwinRequest, DocumentRequest, DocumentResponse, DubRequest, DubResponse, EmbedRequest, EmbedResponse, HeyGenTemplatesResponse, HeyGenVoicesResponse, ImageEditRequest, ImageEditResponse, ImageRequest, ImageResponse, InstanceResponse, InstancesResponse, IsolateVoiceRequest, IsolateVoiceResponse, JobCreateRequest, JobCreateResponse, JobListResponse, JobStreamEvent, JobStatusResponse, ListKeysResponse, MissionEvent, MissionRequest, ModelInfo, MusicRequest, MusicResponse, PhotoAvatarRequest, PricingInfo, ProcessDocumentRequest, ProcessDocumentResponse, ProvisionRequest, ProvisionResponse, RAGCorpus, RAGSearchRequest, RAGSearchResponse, RemixVoiceRequest, RemixVoiceResponse, ResponseMeta, SessionChatRequest, SessionChatResponse, SoundEffectRequest, SoundEffectResponse, SpeechToSpeechRequest, SpeechToSpeechResponse, SSHKeyRequest, StarfishTTSRequest, StarfishTTSResponse, StatusResponse, STTRequest, STTResponse, StreamEvent, SurrealRAGProvidersResponse, SurrealRAGSearchRequest, SurrealRAGSearchResponse, TemplatesResponse, TTSRequest, TTSResponse, UsageQuery, UsageResponse, UsageSummaryResponse, VideoRequest, VideoResponse, VideoStudioRequest, VideoTranslateRequest, VoiceDesignRequest, VoiceDesignResponse, VoicesResponse } from "./types.js";
+import type { AccountPricingResponse, AgentEvent, AgentRequest, AlignRequest, AlignResponse, AsyncJobResponse, AuthAppleRequest, AuthResponse, AvatarsResponse, BalanceResponse, BatchJobInfo, BatchJobsResponse, BatchJsonlResponse, BatchSubmitRequest, BatchSubmitResponse, ChatRequest, ChatResponse, ChunkDocumentRequest, ChunkDocumentResponse, ClientOptions, CloneVoiceRequest, CloneVoiceResponse, CreateKeyRequest, CreateKeyResponse, CreditBalanceResponse, CreditPacksResponse, CreditPurchaseRequest, CreditPurchaseResponse, CreditTiersResponse, DeleteResponse, DevProgramApplyRequest, DevProgramApplyResponse, DialogueRequest, DialogueResponse, DigitalTwinRequest, DocumentRequest, DocumentResponse, DubRequest, DubResponse, EmbedRequest, EmbedResponse, HeyGenTemplatesResponse, HeyGenVoicesResponse, ImageEditRequest, ImageEditResponse, ImageRequest, ImageResponse, InstanceResponse, InstancesResponse, IsolateVoiceRequest, IsolateVoiceResponse, JobCreateRequest, JobCreateResponse, JobListResponse, JobStreamEvent, WebSearchRequest, WebSearchResponse, LLMContextRequest, LLMContextResponse, SearchAnswerRequest, SearchAnswerResponse, JobStatusResponse, ListKeysResponse, MissionEvent, MissionRequest, ModelInfo, MusicRequest, MusicResponse, PhotoAvatarRequest, PricingInfo, ProcessDocumentRequest, ProcessDocumentResponse, ProvisionRequest, ProvisionResponse, RAGCorpus, RAGSearchRequest, RAGSearchResponse, RemixVoiceRequest, RemixVoiceResponse, ResponseMeta, SessionChatRequest, SessionChatResponse, SoundEffectRequest, SoundEffectResponse, SpeechToSpeechRequest, SpeechToSpeechResponse, SSHKeyRequest, StarfishTTSRequest, StarfishTTSResponse, StatusResponse, STTRequest, STTResponse, StreamEvent, SurrealRAGProvidersResponse, SurrealRAGSearchRequest, SurrealRAGSearchResponse, TemplatesResponse, TTSRequest, TTSResponse, UsageQuery, UsageResponse, UsageSummaryResponse, VideoRequest, VideoResponse, VideoStudioRequest, VideoTranslateRequest, VoiceDesignRequest, VoiceDesignResponse, VoicesResponse } from "./types.js";
 /**
  * QuantumClient is the Quantum AI API client.
  *
@@ -151,6 +151,12 @@ export declare class QuantumClient {
     surrealRagSearch(req: SurrealRAGSearchRequest): Promise<SurrealRAGSearchResponse>;
     /** List available documentation providers in SurrealDB RAG. */
     surrealRagProviders(): Promise<SurrealRAGProvidersResponse>;
+    /** Perform a web search. Returns web results, news, videos, infobox, discussions. */
+    webSearch(req: WebSearchRequest): Promise<WebSearchResponse>;
+    /** Get LLM-optimized content chunks for grounding. */
+    searchContext(req: LLMContextRequest): Promise<LLMContextResponse>;
+    /** Get a grounded AI answer with citations. */
+    searchAnswer(req: SearchAnswerRequest): Promise<SearchAnswerResponse>;
     /** List all available models with provider and pricing information. */
     listModels(): Promise<ModelInfo[]>;
     /** Get the complete pricing table for all models. */

package/dist/client.js

@@ -11,6 +11,7 @@ import { ragSearch, ragCorpora, surrealRagSearch, surrealRagProviders } from "./
 import { listModels, getPricing } from "./models.js";
 import { accountBalance, accountUsage, accountUsageSummary, accountPricing, } from "./account.js";
 import { createJob, getJob, pollJob, listJobs, chatJob, streamJob, generate3D } from "./jobs.js";
+import { webSearch, searchContext, searchAnswer } from "./search.js";
 import { createKey, listKeys, revokeKey } from "./keys.js";
 import { computeTemplates, computeProvision, computeInstances, computeInstance, computeDelete, computeSSHKey, computeKeepalive, } from "./compute.js";
 import { listVoices, cloneVoice, deleteVoice } from "./voices.js";
@@ -256,6 +257,19 @@ export class QuantumClient {
     async surrealRagProviders() {
         return surrealRagProviders(this);
     }
+    // ── Search (Brave) ──────────────────────────────────────────────
+    /** Perform a web search. Returns web results, news, videos, infobox, discussions. */
+    async webSearch(req) {
+        return webSearch(this, req);
+    }
+    /** Get LLM-optimized content chunks for grounding. */
+    async searchContext(req) {
+        return searchContext(this, req);
+    }
+    /** Get a grounded AI answer with citations. */
+    async searchAnswer(req) {
+        return searchAnswer(this, req);
+    }
     // ── Models ────────────────────────────────────────────────────────
     /** List all available models with provider and pricing information. */
     async listModels() {

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { responseText, responseThinking, responseToolCalls } from "./chat.js";
 export { realtimeConnect, realtimeConnectDirect, realtimeSession, realtimeEnd, realtimeRefresh, RealtimeSender, RealtimeReceiver } from "./realtime.js";
 export type { RealtimeConfig, RealtimeEvent, RealtimeSession } from "./realtime.js";
 export { contact } from "./contact.js";
-export type { ClientOptions, ResponseMeta, ChatRequest, ChatMessage, ChatTool, ContentBlock, ChatUsage, ChatResponse, StreamEvent, StreamDelta, StreamToolUse, SessionChatRequest, SessionChatResponse, SessionToolResult, ContextConfig, ContextMetadata, AgentRequest, AgentWorkerConfig, AgentEvent, MissionRequest, MissionWorkerConfig, MissionEvent, ImageRequest, ImageResponse, GeneratedImage, ImageEditRequest, ImageEditResponse, TTSRequest, TTSResponse, STTRequest, STTResponse, MusicRequest, MusicClip, MusicResponse, SoundEffectRequest, SoundEffectResponse, DialogueRequest, DialogueResponse, DialogueVoice, SpeechToSpeechRequest, SpeechToSpeechResponse, IsolateVoiceRequest, IsolateVoiceResponse, RemixVoiceRequest, RemixVoiceResponse, DubRequest, DubResponse, AlignRequest, AlignResponse, AlignedWord, VoiceDesignRequest, VoiceDesignResponse, VoicePreview, StarfishTTSRequest, StarfishTTSResponse, VideoRequest, VideoResponse, GeneratedVideo, VideoStudioRequest, VideoTranslateRequest, PhotoAvatarRequest, DigitalTwinRequest, AsyncJobResponse, AvatarsResponse, HeyGenAvatar, HeyGenTemplatesResponse, HeyGenTemplate, HeyGenVoicesResponse, HeyGenVoice, EmbedRequest, EmbedResponse, DocumentRequest, DocumentResponse, ChunkDocumentRequest, ChunkDocumentResponse, DocumentChunk, ProcessDocumentRequest, ProcessDocumentResponse, RAGSearchRequest, RAGSearchResponse, RAGResult, RAGCorpus, SurrealRAGSearchRequest, SurrealRAGSearchResponse, SurrealRAGResult, SurrealRAGProvidersResponse, SurrealRAGProviderInfo, ModelInfo, PricingInfo, BalanceResponse, UsageEntry, UsageResponse, UsageQuery, UsageSummaryMonth, UsageSummaryResponse, PricingEntry, AccountPricingResponse, JobCreateRequest, JobCreateResponse, JobStatusResponse, JobListResponse, JobStreamEvent, JobListItem, CreateKeyRequest, CreateKeyResponse, KeyDetails, ListKeysResponse, ComputeTemplate, TemplatesResponse, ProvisionRequest, ProvisionResponse, ComputeInstanceInfo, InstancesResponse, InstanceDetailInfo, InstanceResponse, SSHKeyRequest, DeleteResponse, VoiceInfo, VoicesResponse, CloneVoiceRequest, CloneVoiceResponse, ContactRequest, BatchJobInput, BatchSubmitRequest, BatchSubmitResponse, BatchJsonlResponse, BatchJobInfo, BatchJobsResponse, CreditPack, CreditPacksResponse, CreditPurchaseRequest, CreditPurchaseResponse, CreditBalanceResponse, CreditTier, CreditTiersResponse, DevProgramApplyRequest, DevProgramApplyResponse, AuthUser, AuthResponse, AuthAppleRequest, StatusResponse, } from "./types.js";
+export type { ClientOptions, ResponseMeta, ChatRequest, ChatMessage, ChatTool, ContentBlock, ChatUsage, ChatResponse, StreamEvent, StreamDelta, StreamToolUse, SessionChatRequest, SessionChatResponse, SessionToolResult, ContextConfig, ContextMetadata, AgentRequest, AgentWorkerConfig, AgentEvent, MissionRequest, MissionWorkerConfig, MissionEvent, ImageRequest, ImageResponse, GeneratedImage, ImageEditRequest, ImageEditResponse, TTSRequest, TTSResponse, STTRequest, STTResponse, MusicRequest, MusicClip, MusicResponse, SoundEffectRequest, SoundEffectResponse, DialogueRequest, DialogueResponse, DialogueVoice, SpeechToSpeechRequest, SpeechToSpeechResponse, IsolateVoiceRequest, IsolateVoiceResponse, RemixVoiceRequest, RemixVoiceResponse, DubRequest, DubResponse, AlignRequest, AlignResponse, AlignedWord, VoiceDesignRequest, VoiceDesignResponse, VoicePreview, StarfishTTSRequest, StarfishTTSResponse, VideoRequest, VideoResponse, GeneratedVideo, VideoStudioRequest, VideoTranslateRequest, PhotoAvatarRequest, DigitalTwinRequest, AsyncJobResponse, AvatarsResponse, HeyGenAvatar, HeyGenTemplatesResponse, HeyGenTemplate, HeyGenVoicesResponse, HeyGenVoice, EmbedRequest, EmbedResponse, DocumentRequest, DocumentResponse, ChunkDocumentRequest, ChunkDocumentResponse, DocumentChunk, ProcessDocumentRequest, ProcessDocumentResponse, RAGSearchRequest, RAGSearchResponse, RAGResult, RAGCorpus, SurrealRAGSearchRequest, SurrealRAGSearchResponse, SurrealRAGResult, SurrealRAGProvidersResponse, SurrealRAGProviderInfo, ModelInfo, PricingInfo, BalanceResponse, UsageEntry, UsageResponse, UsageQuery, UsageSummaryMonth, UsageSummaryResponse, PricingEntry, AccountPricingResponse, JobCreateRequest, JobCreateResponse, JobStatusResponse, JobListResponse, JobStreamEvent, JobListItem, CreateKeyRequest, CreateKeyResponse, KeyDetails, ListKeysResponse, ComputeTemplate, TemplatesResponse, ProvisionRequest, ProvisionResponse, ComputeInstanceInfo, InstancesResponse, InstanceDetailInfo, InstanceResponse, SSHKeyRequest, DeleteResponse, VoiceInfo, VoicesResponse, CloneVoiceRequest, CloneVoiceResponse, ContactRequest, BatchJobInput, BatchSubmitRequest, BatchSubmitResponse, BatchJsonlResponse, BatchJobInfo, BatchJobsResponse, CreditPack, CreditPacksResponse, CreditPurchaseRequest, CreditPurchaseResponse, CreditBalanceResponse, CreditTier, CreditTiersResponse, DevProgramApplyRequest, DevProgramApplyResponse, AuthUser, AuthResponse, AuthAppleRequest, WebSearchRequest, WebSearchResponse, WebSearchResult, NewsResult, VideoSearchResult, LLMContextRequest, LLMContextResponse, ContentChunk, ContextSource, SearchAnswerRequest, SearchAnswerResponse, SearchAnswerChoice, SearchCitation, StatusResponse, } from "./types.js";
 export { DEFAULT_BASE_URL, TICKS_PER_USD } from "./types.js";
 import type { ChatMessage } from "./types.js";
 /** Create a user message. */

package/dist/search.d.ts

@@ -0,0 +1,17 @@
+import type { QuantumClient } from "./client.js";
+import type { WebSearchRequest, WebSearchResponse, LLMContextRequest, LLMContextResponse, SearchAnswerRequest, SearchAnswerResponse } from "./types.js";
+/**
+ * Perform a Brave web search.
+ * @internal
+ */
+export declare function webSearch(client: QuantumClient, req: WebSearchRequest): Promise<WebSearchResponse>;
+/**
+ * Get LLM-optimized content chunks for a query.
+ * @internal
+ */
+export declare function searchContext(client: QuantumClient, req: LLMContextRequest): Promise<LLMContextResponse>;
+/**
+ * Get a grounded AI answer with citations.
+ * @internal
+ */
+export declare function searchAnswer(client: QuantumClient, req: SearchAnswerRequest): Promise<SearchAnswerResponse>;

package/dist/search.js

@@ -0,0 +1,24 @@
+/**
+ * Perform a Brave web search.
+ * @internal
+ */
+export async function webSearch(client, req) {
+    const { data } = await client._doJSON("POST", "/qai/v1/search/web", req);
+    return data;
+}
+/**
+ * Get LLM-optimized content chunks for a query.
+ * @internal
+ */
+export async function searchContext(client, req) {
+    const { data } = await client._doJSON("POST", "/qai/v1/search/context", req);
+    return data;
+}
+/**
+ * Get a grounded AI answer with citations.
+ * @internal
+ */
+export async function searchAnswer(client, req) {
+    const { data } = await client._doJSON("POST", "/qai/v1/search/answer", req);
+    return data;
+}

package/dist/types.d.ts

@@ -735,6 +735,134 @@ export interface JobStreamEvent {
     cost_ticks?: number;
     completed_at?: string;
 }
+export interface WebSearchRequest {
+    query: string;
+    count?: number;
+    offset?: number;
+    country?: string;
+    language?: string;
+    freshness?: "pd" | "pw" | "pm";
+    safesearch?: string;
+}
+export interface WebSearchResult {
+    title?: string;
+    url?: string;
+    description?: string;
+    extra_snippets?: string[];
+    age?: string;
+    language?: string;
+    thumbnail?: {
+        src?: string;
+        height?: number;
+        width?: number;
+    };
+}
+export interface NewsResult {
+    title?: string;
+    url?: string;
+    description?: string;
+    age?: string;
+    source?: string;
+    thumbnail?: {
+        src?: string;
+        height?: number;
+        width?: number;
+    };
+}
+export interface VideoSearchResult {
+    title?: string;
+    url?: string;
+    description?: string;
+    age?: string;
+    thumbnail?: {
+        src?: string;
+        height?: number;
+        width?: number;
+    };
+}
+export interface WebSearchResponse {
+    query?: {
+        original?: string;
+        altered?: string;
+        language?: string;
+    };
+    web?: {
+        results: WebSearchResult[];
+        family_friendly?: boolean;
+    };
+    news?: {
+        results: NewsResult[];
+    };
+    videos?: {
+        results: VideoSearchResult[];
+    };
+    infobox?: {
+        title?: string;
+        url?: string;
+        description?: string;
+        long_desc?: string;
+    };
+    discussions?: {
+        results: {
+            title?: string;
+            url?: string;
+            description?: string;
+            age?: string;
+        }[];
+    };
+}
+export interface LLMContextRequest {
+    query: string;
+    count?: number;
+    country?: string;
+    language?: string;
+    freshness?: "pd" | "pw" | "pm";
+}
+export interface ContentChunk {
+    content?: string;
+    url?: string;
+    title?: string;
+    score?: number;
+    content_type?: string;
+    index?: number;
+}
+export interface ContextSource {
+    url?: string;
+    title?: string;
+    description?: string;
+    snippet?: string;
+}
+export interface LLMContextResponse {
+    chunks: ContentChunk[];
+    sources?: ContextSource[];
+    query?: string;
+}
+export interface SearchAnswerRequest {
+    messages: {
+        role: string;
+        content: string;
+    }[];
+    model?: string;
+}
+export interface SearchAnswerChoice {
+    index?: number;
+    message?: {
+        role: string;
+        content: string;
+    };
+    finish_reason?: string;
+}
+export interface SearchCitation {
+    url?: string;
+    title?: string;
+    snippet?: string;
+}
+export interface SearchAnswerResponse {
+    choices: SearchAnswerChoice[];
+    model?: string;
+    id?: string;
+    citations?: SearchCitation[];
+}
 export interface CreateKeyRequest {
     name: string;
     scopes?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quantum-ai-sdk",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Cosmic Duck SDK — 100+ AI endpoints across 10 providers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",