quantum-ai-sdk 0.2.1 → 0.2.2

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, 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.
  *
@@ -177,6 +177,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,7 @@ 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 { createKey, listKeys, revokeKey } from "./keys.js";
 import { computeTemplates, computeProvision, computeInstances, computeInstance, computeDelete, computeSSHKey, computeKeepalive, } from "./compute.js";
 import { listVoices, cloneVoice, deleteVoice } from "./voices.js";
@@ -305,6 +305,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, 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/types.d.ts

@@ -725,6 +725,16 @@ 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 CreateKeyRequest {
     name: string;
     scopes?: string[];

package/package.json

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