@tangle-network/tcloud 0.1.2 → 0.1.4

package/dist/{shielded-6uJexMiT.d.ts → shielded-BTi_OftW.d.ts}

@@ -38,8 +38,14 @@ interface SpendingLimits {
     }) => void;
 }
 interface RoutingConfig {
-    /** Preferred operator slug */
+    /** Routing mode: 'operator' (Tangle operators only), 'provider' (direct APIs only), 'auto' (try operators, fall back to providers) */
+    mode?: 'operator' | 'provider' | 'auto';
+    /** Preferred operator slug or address */
     prefer?: string;
+    /** Blueprint ID — route to operators under this Blueprint */
+    blueprintId?: string;
+    /** Service instance ID — route to a specific service instance */
+    serviceId?: string;
     /** Routing strategy */
     strategy?: 'lowest-latency' | 'lowest-price' | 'highest-reputation' | 'round-robin';
     /** Region filter */
@@ -47,6 +53,136 @@ interface RoutingConfig {
     /** Fallback operator slugs (tried in order) */
     fallback?: string[];
 }
+interface EmbeddingOptions {
+    model?: string;
+    input: string | string[];
+}
+interface EmbeddingResponse {
+    object: string;
+    data: {
+        object: string;
+        embedding: number[];
+        index: number;
+    }[];
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+interface ImageGenerateOptions {
+    model?: string;
+    prompt: string;
+    n?: number;
+    size?: string;
+    quality?: string;
+    response_format?: 'url' | 'b64_json';
+}
+interface ImageResponse {
+    created: number;
+    data: {
+        url?: string;
+        b64_json?: string;
+        revised_prompt?: string;
+    }[];
+}
+interface RerankOptions {
+    model?: string;
+    query: string;
+    documents: string[];
+    top_n?: number;
+}
+interface RerankResponse {
+    results: {
+        index: number;
+        relevance_score: number;
+    }[];
+}
+interface CompletionOptions {
+    model?: string;
+    prompt: string;
+    temperature?: number;
+    maxTokens?: number;
+    stop?: string | string[];
+    topP?: number;
+}
+interface CompletionResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: {
+        text: string;
+        index: number;
+        finish_reason: string;
+    }[];
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+interface TranscriptionResponse {
+    text: string;
+}
+interface FineTuningJobOptions {
+    model: string;
+    training_file: string;
+    hyperparameters?: {
+        n_epochs?: number | 'auto';
+        batch_size?: number | 'auto';
+        learning_rate_multiplier?: number | 'auto';
+    };
+    suffix?: string;
+}
+interface FineTuningJob {
+    id: string;
+    object: string;
+    model: string;
+    status: string;
+    created_at: number;
+    finished_at: number | null;
+    fine_tuned_model: string | null;
+    error: {
+        code: string;
+        message: string;
+    } | null;
+}
+interface BatchRequest {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    max_tokens?: number;
+}
+interface BatchJobResponse {
+    id: string;
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    total_items: number;
+    completed: number;
+    failed: number;
+    results: ({
+        status: 'fulfilled';
+        data: ChatCompletion;
+    } | {
+        status: 'rejected';
+        error: string;
+    })[] | null;
+    error: string | null;
+    created_at: string;
+    completed_at: string | null;
+}
+interface VideoGenerateOptions {
+    model?: string;
+    prompt: string;
+    duration?: number;
+    resolution?: string;
+}
+interface VideoResponse {
+    id: string;
+    status: string;
+    url?: string;
+    error?: string;
+}
 interface PrivacyConfig {
     /** 'direct' — no proxy (default). 'relayer' — route through tcloud-relayer. 'socks5' — route through SOCKS5 proxy (e.g. Tor). */
     mode: 'direct' | 'relayer' | 'socks5';
@@ -225,7 +361,7 @@ declare class TCloudClient {
     };
     /** Check spending limits before a request. Throws TCloudError if blocked. */
     private checkLimits;
-    /** Track cost after a response */
+    /** Track cost after a response, using actual pricing from response headers when available */
     private trackCost;
     /** Chat completion (non-streaming) */
     chat(options: ChatOptions): Promise<ChatCompletion>;
@@ -265,6 +401,40 @@ declare class TCloudClient {
     }[]>;
     /** Revoke an API key */
     revokeKey(id: string): Promise<void>;
+    /** Generate embeddings */
+    embeddings(options: EmbeddingOptions): Promise<EmbeddingResponse>;
+    /** Generate images */
+    imageGenerate(options: ImageGenerateOptions): Promise<ImageResponse>;
+    /** Rerank documents by relevance to a query */
+    rerank(options: RerankOptions): Promise<RerankResponse>;
+    /** Text-to-speech */
+    speech(options: {
+        model?: string;
+        input: string;
+        voice?: string;
+    }): Promise<ArrayBuffer>;
+    /** Legacy completions endpoint */
+    completions(options: CompletionOptions): Promise<CompletionResponse>;
+    /** Audio transcription (speech-to-text) */
+    transcribe(file: Blob, options?: {
+        model?: string;
+        language?: string;
+        prompt?: string;
+    }): Promise<TranscriptionResponse>;
+    /** Create a fine-tuning job */
+    fineTuneCreate(options: FineTuningJobOptions): Promise<FineTuningJob>;
+    /** List fine-tuning jobs */
+    fineTuneList(): Promise<{
+        data: FineTuningJob[];
+    }>;
+    /** Submit a batch of chat requests */
+    batch(requests: BatchRequest[]): Promise<BatchJobResponse>;
+    /** Get batch job status */
+    batchStatus(jobId: string): Promise<BatchJobResponse>;
+    /** Generate video */
+    videoGenerate(options: VideoGenerateOptions): Promise<VideoResponse>;
+    /** Get video generation status */
+    videoStatus(id: string): Promise<VideoResponse>;
     /** Search models by name, provider, or capability */
     searchModels(query: string): Promise<Model[]>;
     /** Estimate cost for a request (without sending it) */
@@ -340,4 +510,4 @@ declare function createShieldedClient(config?: TCloudConfig & {
     stopAutoReplenish: () => void;
 };
 
-export { type AutoReplenishOptions as A, type ChatCompletion as C, type Model as M, type Operator as O, type PrivacyConfig as P, type RoutingConfig as R, type ShieldedWallet as S, TCloudClient as T, type TCloudConfig as a, type ChatCompletionChunk as b, type ChatMessage as c, type ChatOptions as d, type CreditBalance as e, type ShieldedConfig as f, generateWallet as g, type SpendAuth as h, type SpendingLimits as i, TCloudError as j, createShieldedClient as k, estimateCost as l, signSpendAuth as s };
+export { type AutoReplenishOptions as A, type BatchJobResponse as B, type ChatCompletion as C, type EmbeddingOptions as E, type FineTuningJob as F, type ImageGenerateOptions as I, type Model as M, type Operator as O, type PrivacyConfig as P, type RerankOptions as R, type ShieldedWallet as S, TCloudClient as T, type VideoGenerateOptions as V, type TCloudConfig as a, type BatchRequest as b, type ChatCompletionChunk as c, type ChatMessage as d, type ChatOptions as e, type CompletionOptions as f, generateWallet as g, type CompletionResponse as h, type CreditBalance as i, type EmbeddingResponse as j, type FineTuningJobOptions as k, type ImageResponse as l, type RerankResponse as m, type RoutingConfig as n, type ShieldedConfig as o, type SpendAuth as p, type SpendingLimits as q, TCloudError as r, type TranscriptionResponse as s, type VideoResponse as t, createShieldedClient as u, estimateCost as v, signSpendAuth as w };

package/dist/shielded.cjs

@@ -97,14 +97,23 @@ var TCloudClient = class {
     this.limits = config.limits;
     this.headers = {
       "Content-Type": "application/json",
-      "X-Tangle-Client": "tcloud-sdk/0.1.0"
+      "X-Tangle-Client": "tcloud-sdk/0.1.4"
     };
     if (this.apiKey) {
       this.headers["Authorization"] = `Bearer ${this.apiKey}`;
     }
+    if (config.routing?.mode) {
+      this.headers["X-Tangle-Routing"] = config.routing.mode;
+    }
     if (config.routing?.prefer) {
       this.headers["X-Tangle-Operator"] = config.routing.prefer;
     }
+    if (config.routing?.blueprintId) {
+      this.headers["X-Tangle-Blueprint"] = config.routing.blueprintId;
+    }
+    if (config.routing?.serviceId) {
+      this.headers["X-Tangle-Service"] = config.routing.serviceId;
+    }
     if (config.routing?.region) {
       this.headers["X-Tangle-Region"] = config.routing.region;
     }
@@ -141,12 +150,19 @@ var TCloudClient = class {
       if (pct >= 0.8) this.limits.onLimitWarning({ type: "total", current: this._totalSpent, limit: this.limits.maxTotalSpend });
     }
   }
-  /** Track cost after a response */
-  trackCost(completion) {
+  /** Track cost after a response, using actual pricing from response headers when available */
+  trackCost(completion, res) {
     this._requestCount++;
     if (completion.usage) {
-      const tokens = completion.usage.total_tokens || 0;
-      const estimatedCost = tokens * 1e-6;
+      let estimatedCost;
+      const inputPrice = res ? parseFloat(res.headers.get("x-tangle-price-input") || "0") : 0;
+      const outputPrice = res ? parseFloat(res.headers.get("x-tangle-price-output") || "0") : 0;
+      if (inputPrice > 0 || outputPrice > 0) {
+        estimatedCost = (completion.usage.prompt_tokens || 0) * inputPrice + (completion.usage.completion_tokens || 0) * outputPrice;
+      } else {
+        const tokens = completion.usage.total_tokens || 0;
+        estimatedCost = tokens * 1e-6;
+      }
       this._totalSpent += estimatedCost;
       if (this.limits?.maxCostPerRequest && estimatedCost > this.limits.maxCostPerRequest) {
         this.limits.onLimitReached?.({ type: "cost", current: estimatedCost, limit: this.limits.maxCostPerRequest });
@@ -184,7 +200,7 @@ var TCloudClient = class {
       throw new TCloudError(res.status, err.error?.message || err.error || err.message || res.statusText);
     }
     const completion = await res.json();
-    this.trackCost(completion);
+    this.trackCost(completion, res);
     return completion;
   }
   /** Chat completion (streaming) — returns an async iterator of chunks */
@@ -323,6 +339,188 @@ var TCloudClient = class {
     }, false);
     if (!res.ok) throw new TCloudError(res.status, "Failed to revoke key");
   }
+  /** Generate embeddings */
+  async embeddings(options) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/embeddings`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({
+        model: options.model || "text-embedding-3-small",
+        input: options.input
+      })
+    }, false);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new TCloudError(res.status, err.error?.message || err.error || res.statusText);
+    }
+    this._requestCount++;
+    return res.json();
+  }
+  /** Generate images */
+  async imageGenerate(options) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/images/generations`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({
+        model: options.model || "dall-e-3",
+        prompt: options.prompt,
+        n: options.n,
+        size: options.size,
+        quality: options.quality,
+        response_format: options.response_format
+      })
+    }, false);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new TCloudError(res.status, err.error?.message || err.error || res.statusText);
+    }
+    this._requestCount++;
+    return res.json();
+  }
+  /** Rerank documents by relevance to a query */
+  async rerank(options) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/rerank`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({
+        model: options.model || "rerank-english-v3.0",
+        query: options.query,
+        documents: options.documents,
+        top_n: options.top_n
+      })
+    }, false);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new TCloudError(res.status, err.error?.message || err.error || res.statusText);
+    }
+    this._requestCount++;
+    return res.json();
+  }
+  /** Text-to-speech */
+  async speech(options) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/audio/speech`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({
+        model: options.model || "tts-1",
+        input: options.input,
+        voice: options.voice || "alloy"
+      })
+    }, false);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new TCloudError(res.status, err.error?.message || err.error || res.statusText);
+    }
+    this._requestCount++;
+    return res.arrayBuffer();
+  }
+  /** Legacy completions endpoint */
+  async completions(options) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/completions`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({
+        model: options.model || this.model,
+        prompt: options.prompt,
+        temperature: options.temperature,
+        max_tokens: options.maxTokens,
+        stop: options.stop,
+        top_p: options.topP
+      })
+    }, false);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new TCloudError(res.status, err.error?.message || err.error || res.statusText);
+    }
+    this._requestCount++;
+    return res.json();
+  }
+  /** Audio transcription (speech-to-text) */
+  async transcribe(file, options) {
+    const formData = new FormData();
+    formData.append("file", file, "audio.webm");
+    formData.append("model", options?.model || "whisper-1");
+    if (options?.language) formData.append("language", options.language);
+    if (options?.prompt) formData.append("prompt", options.prompt);
+    const headers = { ...this.headers };
+    delete headers["Content-Type"];
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/audio/transcriptions`, {
+      method: "POST",
+      headers,
+      body: formData
+    }, false);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new TCloudError(res.status, err.error?.message || err.error || res.statusText);
+    }
+    this._requestCount++;
+    return res.json();
+  }
+  /** Create a fine-tuning job */
+  async fineTuneCreate(options) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/fine_tuning/jobs`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(options)
+    }, false);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new TCloudError(res.status, err.error?.message || err.error || res.statusText);
+    }
+    this._requestCount++;
+    return res.json();
+  }
+  /** List fine-tuning jobs */
+  async fineTuneList() {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/fine_tuning/jobs`, {
+      headers: this.headers
+    }, false);
+    if (!res.ok) throw new TCloudError(res.status, "Failed to fetch fine-tuning jobs");
+    return res.json();
+  }
+  /** Submit a batch of chat requests */
+  async batch(requests) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/batch`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({ requests })
+    }, false);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new TCloudError(res.status, err.error?.message || err.error || res.statusText);
+    }
+    return res.json();
+  }
+  /** Get batch job status */
+  async batchStatus(jobId) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/batch?id=${jobId}`, {
+      headers: this.headers
+    }, false);
+    if (!res.ok) throw new TCloudError(res.status, "Failed to fetch batch status");
+    return res.json();
+  }
+  /** Generate video */
+  async videoGenerate(options) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/video/generate`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(options)
+    }, false);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new TCloudError(res.status, err.error?.message || err.error || res.statusText);
+    }
+    this._requestCount++;
+    return res.json();
+  }
+  /** Get video generation status */
+  async videoStatus(id) {
+    const res = await proxiedFetch(this.privacy, `${this.baseURL}/video?id=${id}`, {
+      headers: this.headers
+    }, false);
+    if (!res.ok) throw new TCloudError(res.status, "Failed to fetch video status");
+    return res.json();
+  }
   /** Search models by name, provider, or capability */
   async searchModels(query) {
     const all = await this.models();

package/dist/shielded.d.cts

@@ -1,2 +1,2 @@
 import 'viem';
-export { A as AutoReplenishOptions, S as ShieldedWallet, h as SpendAuth, k as createShieldedClient, l as estimateCost, g as generateWallet, s as signSpendAuth } from './shielded-6uJexMiT.cjs';
+export { A as AutoReplenishOptions, S as ShieldedWallet, p as SpendAuth, u as createShieldedClient, v as estimateCost, g as generateWallet, w as signSpendAuth } from './shielded-BTi_OftW.cjs';

package/dist/shielded.d.ts

@@ -1,2 +1,2 @@
 import 'viem';
-export { A as AutoReplenishOptions, S as ShieldedWallet, h as SpendAuth, k as createShieldedClient, l as estimateCost, g as generateWallet, s as signSpendAuth } from './shielded-6uJexMiT.js';
+export { A as AutoReplenishOptions, S as ShieldedWallet, p as SpendAuth, u as createShieldedClient, v as estimateCost, g as generateWallet, w as signSpendAuth } from './shielded-BTi_OftW.js';

package/dist/shielded.js

@@ -3,7 +3,7 @@ import {
   estimateCost,
   generateWallet,
   signSpendAuth
-} from "./chunk-FL352XGA.js";
+} from "./chunk-KVXWEAK3.js";
 export {
   createShieldedClient,
   estimateCost,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/tcloud",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "TypeScript SDK and CLI for Tangle AI Cloud — decentralized LLM inference",
   "type": "module",
   "main": "./dist/index.cjs",