quantum-ai-sdk 0.2.1 → 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, 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. */
@@ -177,6 +183,19 @@ export declare class QuantumClient {
     pollJob(jobId: string, intervalMs?: number, maxAttempts?: number): Promise<JobStatusResponse>;
     /** List all jobs for the authenticated user. */
     listJobs(): Promise<JobListResponse>;
+    /**
+     * Submit a chat completion as an async job.
+     * Use for long-running models (e.g. Opus) where sync chat may time out.
+     * Params are the same shape as ChatRequest (model, messages, tools, etc.)
+     */
+    chatJob(req: Omit<ChatRequest, "stream">): Promise<JobCreateResponse>;
+    /**
+     * Stream job progress via SSE. Yields events as the job runs.
+     * Events: progress (status update), complete (with result), error.
+     */
+    streamJob(jobId: string, signal?: AbortSignal): AsyncIterableIterator<JobStreamEvent>;
+    /** Generate a 3D model via the async jobs system. */
+    generate3D(model: string, prompt?: string, imageUrl?: string): Promise<JobCreateResponse>;
     /** Create a scoped API key. */
     createKey(req: CreateKeyRequest): Promise<CreateKeyResponse>;
     /** List all API keys for the authenticated user. */

package/dist/client.js

@@ -10,7 +10,8 @@ import { extractDocument, chunkDocument, processDocument } from "./documents.js"
 import { ragSearch, ragCorpora, surrealRagSearch, surrealRagProviders } from "./rag.js";
 import { listModels, getPricing } from "./models.js";
 import { accountBalance, accountUsage, accountUsageSummary, accountPricing, } from "./account.js";
-import { createJob, getJob, pollJob, listJobs } from "./jobs.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() {
@@ -305,6 +319,25 @@ export class QuantumClient {
     async listJobs() {
         return listJobs(this);
     }
+    /**
+     * Submit a chat completion as an async job.
+     * Use for long-running models (e.g. Opus) where sync chat may time out.
+     * Params are the same shape as ChatRequest (model, messages, tools, etc.)
+     */
+    async chatJob(req) {
+        return chatJob(this, req);
+    }
+    /**
+     * Stream job progress via SSE. Yields events as the job runs.
+     * Events: progress (status update), complete (with result), error.
+     */
+    streamJob(jobId, signal) {
+        return streamJob(this, jobId, signal);
+    }
+    /** Generate a 3D model via the async jobs system. */
+    async generate3D(model, prompt, imageUrl) {
+        return generate3D(this, model, prompt, imageUrl);
+    }
     // ── API Keys ──────────────────────────────────────────────────────
     /** Create a scoped API key. */
     async createKey(req) {

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, 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/jobs.d.ts

@@ -1,5 +1,5 @@
 import type { QuantumClient } from "./client.js";
-import type { JobCreateRequest, JobCreateResponse, JobListResponse, JobStatusResponse } from "./types.js";
+import type { ChatRequest, JobCreateRequest, JobCreateResponse, JobListResponse, JobStatusResponse, JobStreamEvent } from "./types.js";
 /**
  * Create an async job. Returns the job ID for polling.
  * @internal
@@ -26,3 +26,21 @@ export declare function listJobs(client: QuantumClient): Promise<JobListResponse
  * @internal
  */
 export declare function generate3D(client: QuantumClient, model: string, prompt?: string, imageUrl?: string): Promise<JobCreateResponse>;
+/**
+ * Submit a chat completion as an async job. Useful for long-running
+ * models (e.g. Opus) where synchronous /qai/v1/chat may time out.
+ *
+ * Params are the same shape as ChatRequest (model, messages, tools, etc.)
+ * Use streamJob() or pollJob() to get the result.
+ * @internal
+ */
+export declare function chatJob(client: QuantumClient, req: Omit<ChatRequest, "stream">): Promise<JobCreateResponse>;
+/**
+ * Stream job progress via SSE. Yields events as the job runs.
+ *
+ * Events: { type: "progress", status } | { type: "complete", result, cost_ticks } | { type: "error", error }
+ *
+ * If the job is already terminal, yields one event and returns.
+ * @internal
+ */
+export declare function streamJob(client: QuantumClient, jobId: string, signal?: AbortSignal): AsyncIterableIterator<JobStreamEvent>;

package/dist/jobs.js

@@ -54,3 +54,75 @@ export async function generate3D(client, model, prompt, imageUrl) {
         params.image_url = imageUrl;
     return createJob(client, { type: "3d/generate", params });
 }
+/**
+ * Submit a chat completion as an async job. Useful for long-running
+ * models (e.g. Opus) where synchronous /qai/v1/chat may time out.
+ *
+ * Params are the same shape as ChatRequest (model, messages, tools, etc.)
+ * Use streamJob() or pollJob() to get the result.
+ * @internal
+ */
+export async function chatJob(client, req) {
+    return createJob(client, {
+        type: "chat",
+        params: req,
+    });
+}
+/**
+ * Stream job progress via SSE. Yields events as the job runs.
+ *
+ * Events: { type: "progress", status } | { type: "complete", result, cost_ticks } | { type: "error", error }
+ *
+ * If the job is already terminal, yields one event and returns.
+ * @internal
+ */
+export async function* streamJob(client, jobId, signal) {
+    // Job stream is GET, not POST — use _doJSON's fetch directly.
+    const headers = {
+        Authorization: `Bearer ${client._apiKey}`,
+        Accept: "text/event-stream",
+    };
+    const response = await client._fetch(`${client._baseUrl}/qai/v1/jobs/${jobId}/stream`, { method: "GET", headers, signal });
+    if (!response.ok) {
+        throw new Error(`Job stream error (${response.status})`);
+    }
+    const reader = response.body;
+    if (!reader) {
+        throw new Error("qai: response body is null");
+    }
+    const decoder = new TextDecoder();
+    const streamReader = reader.getReader();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await streamReader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (!line.startsWith("data: "))
+                    continue;
+                const payload = line.slice(6);
+                if (payload === "[DONE]")
+                    return;
+                let event;
+                try {
+                    event = JSON.parse(payload);
+                }
+                catch {
+                    yield { type: "error", error: "parse SSE: invalid JSON" };
+                    return;
+                }
+                yield event;
+                if (event.type === "complete" || event.type === "error") {
+                    return;
+                }
+            }
+        }
+    }
+    finally {
+        streamReader.releaseLock();
+    }
+}

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

@@ -725,6 +725,144 @@ export interface JobListItem {
 export interface JobListResponse {
     jobs: JobListItem[];
 }
+/** SSE event from GET /qai/v1/jobs/{id}/stream */
+export interface JobStreamEvent {
+    type: "progress" | "complete" | "error";
+    job_id?: string;
+    status?: string;
+    result?: unknown;
+    error?: string;
+    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.1",
+  "version": "0.3.0",
   "description": "Cosmic Duck SDK — 100+ AI endpoints across 10 providers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",