@tangle-network/tcloud 0.4.13 → 0.5.0

package/dist/{client-CaD5Oal0.d.ts → client-CAedbgfN.d.cts}

@@ -186,6 +186,54 @@ interface SearchResponse {
         billing_units?: Record<string, unknown>;
     };
 }
+/** Providers served by the router's research API (POST /v1/research). Mirrors
+ *  SearchProvider minus `brave` (no research API). Each has its own `effort`
+ *  vocabulary — see ResearchOptions.effort. */
+type ResearchProvider = 'perplexity' | 'exa' | 'you' | 'parallel' | 'tavily';
+interface ResearchOptions {
+    query: string;
+    provider?: ResearchProvider;
+    /** Alias accepted by the Router for provider-compatible clients. */
+    model?: ResearchProvider;
+    /** Depth/cost dial, provider-specific:
+     *  perplexity minimal|low|medium|high · you lite|standard|deep|exhaustive ·
+     *  exa deep-lite|deep|deep-reasoning · tavily mini|pro|auto ·
+     *  parallel lite|base|core|pro|ultra. Omit for the provider default. */
+    effort?: string;
+    maxResults?: number;
+    searchRecency?: SearchRecency;
+    includeDomains?: string[];
+    excludeDomains?: string[];
+    /** Optional JSON schema requesting structured output from the provider. */
+    outputSchema?: unknown;
+}
+interface ResearchHit {
+    title: string;
+    url: string;
+    snippet?: string;
+    publishedAt?: string;
+    source?: string;
+}
+interface ResearchResponse {
+    id: string;
+    object: 'research.result' | string;
+    provider: ResearchProvider;
+    query: string;
+    /** The synthesized multi-step research answer. */
+    answer: string;
+    /** Supporting sources behind the answer. */
+    results: ResearchHit[];
+    citations: string[];
+    /** Present when an outputSchema was requested and the provider honored it. */
+    structured?: unknown;
+    usage?: {
+        upstream_cost?: number;
+        billed_cost?: number;
+        gross_margin?: number;
+        markup?: number;
+        billing_units?: Record<string, unknown>;
+    };
+}
 interface WebSearchPlugin {
     id: 'web';
     engine?: 'native' | 'exa' | 'parallel' | 'firecrawl';
@@ -332,15 +380,10 @@ interface AvatarJobStatus {
     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';
+    /** 'direct' — no proxy (default). 'relayer' — route through tcloud-relayer. */
+    mode: 'direct' | 'relayer';
     /** Relayer URL for 'relayer' mode (e.g. 'http://localhost:3030') */
     relayerUrl?: string;
-    /**
-     * SOCKS5 proxy URL for 'socks5' mode (e.g. 'socks5://127.0.0.1:9050' for Tor).
-     * Requires `socks-proxy-agent` as an optional peer dependency.
-     */
-    socksProxy?: string;
 }
 interface ShieldedConfig {
     /** Pre-existing spending private key (hex). If not set, generates ephemeral. */
@@ -1039,6 +1082,11 @@ declare class TCloudClient {
     rerank(options: RerankOptions): Promise<RerankResponse>;
     /** Search the web through Tangle Router billing and provider routing. */
     search(options: SearchOptions): Promise<SearchResponse>;
+    /** Run a multi-step deep-research task through Tangle Router billing and
+     *  provider routing (POST /v1/research). Slower and costlier than `search` —
+     *  the provider synthesizes an answer over many fetches. Pick depth with
+     *  `effort` (provider-specific vocabulary; see {@link ResearchOptions.effort}). */
+    research(options: ResearchOptions): Promise<ResearchResponse>;
     /** Text-to-speech */
     speech(options: {
         model?: string;
@@ -1356,4 +1404,4 @@ declare class TCloudError extends Error {
     constructor(status: number, message: string);
 }
 
-export { type SpendAuth as $, type ApiKeyInfo as A, type BatchJobResponse as B, type ChatCompletion as C, type RerankOptions as D, type EmbeddingOptions as E, type FineTuningJob as F, type GatewayOptions as G, type RerankResponse as H, type ImageEditAttachment as I, type JobEvent as J, type RetryConfig as K, type RotatingRoutingConfig as L, type Model as M, type RotationStats as N, type Operator as O, type PricingTier as P, type RoutingConfig as Q, type RotatingClientConfig as R, type RoutingStrategy as S, TCloudClient as T, type SandboxChatOptions as U, type SearchHit as V, type SearchOptions as W, type SearchProvider as X, type SearchRecency as Y, type SearchResponse as Z, type ShieldedConfig as _, type TCloudConfig as a, type SpendingLimits as a0, TCloudError as a1, type TierConfig as a2, type TranscriptionResponse as a3, type UpdateKeyOptions as a4, type VideoGenerateOptions as a5, type VideoResponse as a6, type WatchJobOptions as a7, type WebSearchPlugin as a8, type AvatarGenerateRequest as b, type AvatarGenerateResponse as c, type AvatarJobStatus as d, type AvatarResult as e, type BatchRequest as f, type BridgeOptions as g, BridgeSession as h, type ChatCompletionChunk as i, type ChatMessage as j, type ChatOptions as k, type ChatPlugin as l, type CompletionOptions as m, type CompletionResponse as n, type CreateKeyOptions as o, type CreatedKey as p, type CreditBalance as q, type EmbeddingResponse as r, type FineTuningJobOptions as s, type ImageEditOptions as t, type ImageGenerateOptions as u, type ImageResponse as v, type OperatorInfo as w, type PrivacyConfig as x, PrivateRouter as y, type PrivateRouterConfig as z };
+export { type SearchProvider as $, type ApiKeyInfo as A, type BatchJobResponse as B, type ChatCompletion as C, type RerankOptions as D, type EmbeddingOptions as E, type FineTuningJob as F, type GatewayOptions as G, type RerankResponse as H, type ImageEditAttachment as I, type JobEvent as J, type ResearchHit as K, type ResearchOptions as L, type Model as M, type ResearchProvider as N, type Operator as O, type PricingTier as P, type ResearchResponse as Q, type RotatingClientConfig as R, type RetryConfig as S, type TCloudConfig as T, type RotatingRoutingConfig as U, type RotationStats as V, type RoutingConfig as W, type RoutingStrategy as X, type SandboxChatOptions as Y, type SearchHit as Z, type SearchOptions as _, TCloudClient as a, type SearchRecency as a0, type SearchResponse as a1, type ShieldedConfig as a2, type SpendAuth as a3, type SpendingLimits as a4, TCloudError as a5, type TierConfig as a6, type TranscriptionResponse as a7, type UpdateKeyOptions as a8, type VideoGenerateOptions as a9, type VideoResponse as aa, type WatchJobOptions as ab, type WebSearchPlugin as ac, type AvatarGenerateRequest as b, type AvatarGenerateResponse as c, type AvatarJobStatus as d, type AvatarResult as e, type BatchRequest as f, type BridgeOptions as g, BridgeSession as h, type ChatCompletionChunk as i, type ChatMessage as j, type ChatOptions as k, type ChatPlugin as l, type CompletionOptions as m, type CompletionResponse as n, type CreateKeyOptions as o, type CreatedKey as p, type CreditBalance as q, type EmbeddingResponse as r, type FineTuningJobOptions as s, type ImageEditOptions as t, type ImageGenerateOptions as u, type ImageResponse as v, type OperatorInfo as w, type PrivacyConfig as x, PrivateRouter as y, type PrivateRouterConfig as z };

package/dist/{client-CaD5Oal0.d.cts → client-CAedbgfN.d.ts}

@@ -186,6 +186,54 @@ interface SearchResponse {
         billing_units?: Record<string, unknown>;
     };
 }
+/** Providers served by the router's research API (POST /v1/research). Mirrors
+ *  SearchProvider minus `brave` (no research API). Each has its own `effort`
+ *  vocabulary — see ResearchOptions.effort. */
+type ResearchProvider = 'perplexity' | 'exa' | 'you' | 'parallel' | 'tavily';
+interface ResearchOptions {
+    query: string;
+    provider?: ResearchProvider;
+    /** Alias accepted by the Router for provider-compatible clients. */
+    model?: ResearchProvider;
+    /** Depth/cost dial, provider-specific:
+     *  perplexity minimal|low|medium|high · you lite|standard|deep|exhaustive ·
+     *  exa deep-lite|deep|deep-reasoning · tavily mini|pro|auto ·
+     *  parallel lite|base|core|pro|ultra. Omit for the provider default. */
+    effort?: string;
+    maxResults?: number;
+    searchRecency?: SearchRecency;
+    includeDomains?: string[];
+    excludeDomains?: string[];
+    /** Optional JSON schema requesting structured output from the provider. */
+    outputSchema?: unknown;
+}
+interface ResearchHit {
+    title: string;
+    url: string;
+    snippet?: string;
+    publishedAt?: string;
+    source?: string;
+}
+interface ResearchResponse {
+    id: string;
+    object: 'research.result' | string;
+    provider: ResearchProvider;
+    query: string;
+    /** The synthesized multi-step research answer. */
+    answer: string;
+    /** Supporting sources behind the answer. */
+    results: ResearchHit[];
+    citations: string[];
+    /** Present when an outputSchema was requested and the provider honored it. */
+    structured?: unknown;
+    usage?: {
+        upstream_cost?: number;
+        billed_cost?: number;
+        gross_margin?: number;
+        markup?: number;
+        billing_units?: Record<string, unknown>;
+    };
+}
 interface WebSearchPlugin {
     id: 'web';
     engine?: 'native' | 'exa' | 'parallel' | 'firecrawl';
@@ -332,15 +380,10 @@ interface AvatarJobStatus {
     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';
+    /** 'direct' — no proxy (default). 'relayer' — route through tcloud-relayer. */
+    mode: 'direct' | 'relayer';
     /** Relayer URL for 'relayer' mode (e.g. 'http://localhost:3030') */
     relayerUrl?: string;
-    /**
-     * SOCKS5 proxy URL for 'socks5' mode (e.g. 'socks5://127.0.0.1:9050' for Tor).
-     * Requires `socks-proxy-agent` as an optional peer dependency.
-     */
-    socksProxy?: string;
 }
 interface ShieldedConfig {
     /** Pre-existing spending private key (hex). If not set, generates ephemeral. */
@@ -1039,6 +1082,11 @@ declare class TCloudClient {
     rerank(options: RerankOptions): Promise<RerankResponse>;
     /** Search the web through Tangle Router billing and provider routing. */
     search(options: SearchOptions): Promise<SearchResponse>;
+    /** Run a multi-step deep-research task through Tangle Router billing and
+     *  provider routing (POST /v1/research). Slower and costlier than `search` —
+     *  the provider synthesizes an answer over many fetches. Pick depth with
+     *  `effort` (provider-specific vocabulary; see {@link ResearchOptions.effort}). */
+    research(options: ResearchOptions): Promise<ResearchResponse>;
     /** Text-to-speech */
     speech(options: {
         model?: string;
@@ -1356,4 +1404,4 @@ declare class TCloudError extends Error {
     constructor(status: number, message: string);
 }
 
-export { type SpendAuth as $, type ApiKeyInfo as A, type BatchJobResponse as B, type ChatCompletion as C, type RerankOptions as D, type EmbeddingOptions as E, type FineTuningJob as F, type GatewayOptions as G, type RerankResponse as H, type ImageEditAttachment as I, type JobEvent as J, type RetryConfig as K, type RotatingRoutingConfig as L, type Model as M, type RotationStats as N, type Operator as O, type PricingTier as P, type RoutingConfig as Q, type RotatingClientConfig as R, type RoutingStrategy as S, TCloudClient as T, type SandboxChatOptions as U, type SearchHit as V, type SearchOptions as W, type SearchProvider as X, type SearchRecency as Y, type SearchResponse as Z, type ShieldedConfig as _, type TCloudConfig as a, type SpendingLimits as a0, TCloudError as a1, type TierConfig as a2, type TranscriptionResponse as a3, type UpdateKeyOptions as a4, type VideoGenerateOptions as a5, type VideoResponse as a6, type WatchJobOptions as a7, type WebSearchPlugin as a8, type AvatarGenerateRequest as b, type AvatarGenerateResponse as c, type AvatarJobStatus as d, type AvatarResult as e, type BatchRequest as f, type BridgeOptions as g, BridgeSession as h, type ChatCompletionChunk as i, type ChatMessage as j, type ChatOptions as k, type ChatPlugin as l, type CompletionOptions as m, type CompletionResponse as n, type CreateKeyOptions as o, type CreatedKey as p, type CreditBalance as q, type EmbeddingResponse as r, type FineTuningJobOptions as s, type ImageEditOptions as t, type ImageGenerateOptions as u, type ImageResponse as v, type OperatorInfo as w, type PrivacyConfig as x, PrivateRouter as y, type PrivateRouterConfig as z };
+export { type SearchProvider as $, type ApiKeyInfo as A, type BatchJobResponse as B, type ChatCompletion as C, type RerankOptions as D, type EmbeddingOptions as E, type FineTuningJob as F, type GatewayOptions as G, type RerankResponse as H, type ImageEditAttachment as I, type JobEvent as J, type ResearchHit as K, type ResearchOptions as L, type Model as M, type ResearchProvider as N, type Operator as O, type PricingTier as P, type ResearchResponse as Q, type RotatingClientConfig as R, type RetryConfig as S, type TCloudConfig as T, type RotatingRoutingConfig as U, type RotationStats as V, type RoutingConfig as W, type RoutingStrategy as X, type SandboxChatOptions as Y, type SearchHit as Z, type SearchOptions as _, TCloudClient as a, type SearchRecency as a0, type SearchResponse as a1, type ShieldedConfig as a2, type SpendAuth as a3, type SpendingLimits as a4, TCloudError as a5, type TierConfig as a6, type TranscriptionResponse as a7, type UpdateKeyOptions as a8, type VideoGenerateOptions as a9, type VideoResponse as aa, type WatchJobOptions as ab, type WebSearchPlugin as ac, type AvatarGenerateRequest as b, type AvatarGenerateResponse as c, type AvatarJobStatus as d, type AvatarResult as e, type BatchRequest as f, type BridgeOptions as g, BridgeSession as h, type ChatCompletionChunk as i, type ChatMessage as j, type ChatOptions as k, type ChatPlugin as l, type CompletionOptions as m, type CompletionResponse as n, type CreateKeyOptions as o, type CreatedKey as p, type CreditBalance as q, type EmbeddingResponse as r, type FineTuningJobOptions as s, type ImageEditOptions as t, type ImageGenerateOptions as u, type ImageResponse as v, type OperatorInfo as w, type PrivacyConfig as x, PrivateRouter as y, type PrivateRouterConfig as z };

package/dist/index.cjs

@@ -277,48 +277,43 @@ var PrivateRouter = class {
   }
 };
 
+// package.json
+var version = "0.5.0";
+
+// src/version.ts
+function packageVersion() {
+  return version;
+}
+
 // src/client.ts
 var ROTATING_MARKER = "__tcloudRotating";
 var DIRECT_CLI_BRIDGE_MARKER = "__tcloudDirectCliBridge";
 var DEFAULT_BASE_URL = "https://router.tangle.tools/v1";
-var SDK_VERSION = "0.4.0";
 async function proxiedFetch(privacy, url, init, streaming) {
   if (!privacy || privacy.mode === "direct") {
     return fetch(url, init);
   }
-  if (privacy.mode === "relayer") {
-    if (!privacy.relayerUrl) {
-      throw new Error('relayerUrl is required when privacy mode is "relayer"');
-    }
-    const proxyPath = streaming ? "/relay/proxy-stream" : "/relay/proxy";
-    const hdrs = {};
-    if (init.headers) {
-      const entries = init.headers instanceof Headers ? Array.from(init.headers.entries()) : Object.entries(init.headers);
-      for (const [k, v] of entries) hdrs[k] = v;
-    }
-    return fetch(`${privacy.relayerUrl}${proxyPath}`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        target: url,
-        body: typeof init.body === "string" ? JSON.parse(init.body) : init.body,
-        headers: hdrs
-      })
-    });
+  if (privacy.mode !== "relayer") {
+    throw new Error(`Unsupported privacy mode: ${String(privacy.mode)}`);
   }
-  if (privacy.mode === "socks5") {
-    if (!privacy.socksProxy) {
-      throw new Error('socksProxy is required when privacy mode is "socks5"');
-    }
-    const { SocksProxyAgent } = await import("socks-proxy-agent");
-    const agent = new SocksProxyAgent(privacy.socksProxy);
-    return fetch(url, {
-      ...init,
-      // @ts-expect-error agent is supported by Node's undici but not in the standard RequestInit type
-      agent
-    });
+  if (!privacy.relayerUrl) {
+    throw new Error('relayerUrl is required when privacy mode is "relayer"');
   }
-  return fetch(url, init);
+  const proxyPath = streaming ? "/relay/proxy-stream" : "/relay/proxy";
+  const headers = {};
+  if (init.headers) {
+    const entries = init.headers instanceof Headers ? Array.from(init.headers.entries()) : Object.entries(init.headers);
+    for (const [key, value] of entries) headers[key] = value;
+  }
+  return fetch(`${privacy.relayerUrl}${proxyPath}`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      target: url,
+      body: typeof init.body === "string" ? JSON.parse(init.body) : init.body,
+      headers
+    })
+  });
 }
 var DEFAULT_RETRY = {
   maxRetries: 3,
@@ -483,7 +478,7 @@ var TCloudClient = class _TCloudClient {
     this.timeoutMs = config.timeout ?? DEFAULT_TIMEOUT_MS;
     this.headers = {
       "Content-Type": "application/json",
-      "X-Tangle-Client": `tcloud-sdk/${SDK_VERSION}`
+      "X-Tangle-Client": `tcloud-sdk/${packageVersion()}`
     };
     if (this.apiKey) {
       this.headers["Authorization"] = `Bearer ${this.apiKey}`;
@@ -1057,6 +1052,26 @@ var TCloudClient = class _TCloudClient {
       })
     });
   }
+  /** Run a multi-step deep-research task through Tangle Router billing and
+   *  provider routing (POST /v1/research). Slower and costlier than `search` —
+   *  the provider synthesizes an answer over many fetches. Pick depth with
+   *  `effort` (provider-specific vocabulary; see {@link ResearchOptions.effort}). */
+  async research(options) {
+    return this._request(`${this.baseURL}/research`, {
+      method: "POST",
+      body: JSON.stringify({
+        query: options.query,
+        provider: options.provider,
+        model: options.model,
+        effort: options.effort,
+        maxResults: options.maxResults,
+        searchRecency: options.searchRecency,
+        includeDomains: options.includeDomains,
+        excludeDomains: options.excludeDomains,
+        outputSchema: options.outputSchema
+      })
+    });
+  }
   /** Text-to-speech */
   async speech(options) {
     const res = await this._requestRaw(`${this.baseURL}/audio/speech`, {

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { ShieldedWallet, generateWallet } from './shielded.cjs';
 export { createShieldedClient, estimateCost, signSpendAuth } from './shielded.cjs';
-import { T as TCloudClient, a as TCloudConfig, R as RotatingClientConfig } from './client-CaD5Oal0.cjs';
-export { A as ApiKeyInfo, b as AvatarGenerateRequest, c as AvatarGenerateResponse, d as AvatarJobStatus, e as AvatarResult, B as BatchJobResponse, f as BatchRequest, g as BridgeOptions, h as BridgeSession, C as ChatCompletion, i as ChatCompletionChunk, j as ChatMessage, k as ChatOptions, l as ChatPlugin, m as CompletionOptions, n as CompletionResponse, o as CreateKeyOptions, p as CreatedKey, q as CreditBalance, E as EmbeddingOptions, r as EmbeddingResponse, F as FineTuningJob, s as FineTuningJobOptions, G as GatewayOptions, I as ImageEditAttachment, t as ImageEditOptions, u as ImageGenerateOptions, v as ImageResponse, J as JobEvent, M as Model, O as Operator, w as OperatorInfo, P as PricingTier, x as PrivacyConfig, y as PrivateRouter, z as PrivateRouterConfig, D as RerankOptions, H as RerankResponse, K as RetryConfig, L as RotatingRoutingConfig, N as RotationStats, Q as RoutingConfig, S as RoutingStrategy, U as SandboxChatOptions, V as SearchHit, W as SearchOptions, X as SearchProvider, Y as SearchRecency, Z as SearchResponse, _ as ShieldedConfig, $ as SpendAuth, a0 as SpendingLimits, a1 as TCloudError, a2 as TierConfig, a3 as TranscriptionResponse, a4 as UpdateKeyOptions, a5 as VideoGenerateOptions, a6 as VideoResponse, a7 as WatchJobOptions, a8 as WebSearchPlugin } from './client-CaD5Oal0.cjs';
+import { a as TCloudClient, T as TCloudConfig, R as RotatingClientConfig } from './client-CAedbgfN.cjs';
+export { A as ApiKeyInfo, b as AvatarGenerateRequest, c as AvatarGenerateResponse, d as AvatarJobStatus, e as AvatarResult, B as BatchJobResponse, f as BatchRequest, g as BridgeOptions, h as BridgeSession, C as ChatCompletion, i as ChatCompletionChunk, j as ChatMessage, k as ChatOptions, l as ChatPlugin, m as CompletionOptions, n as CompletionResponse, o as CreateKeyOptions, p as CreatedKey, q as CreditBalance, E as EmbeddingOptions, r as EmbeddingResponse, F as FineTuningJob, s as FineTuningJobOptions, G as GatewayOptions, I as ImageEditAttachment, t as ImageEditOptions, u as ImageGenerateOptions, v as ImageResponse, J as JobEvent, M as Model, O as Operator, w as OperatorInfo, P as PricingTier, x as PrivacyConfig, y as PrivateRouter, z as PrivateRouterConfig, D as RerankOptions, H as RerankResponse, K as ResearchHit, L as ResearchOptions, N as ResearchProvider, Q as ResearchResponse, S as RetryConfig, U as RotatingRoutingConfig, V as RotationStats, W as RoutingConfig, X as RoutingStrategy, Y as SandboxChatOptions, Z as SearchHit, _ as SearchOptions, $ as SearchProvider, a0 as SearchRecency, a1 as SearchResponse, a2 as ShieldedConfig, a3 as SpendAuth, a4 as SpendingLimits, a5 as TCloudError, a6 as TierConfig, a7 as TranscriptionResponse, a8 as UpdateKeyOptions, a9 as VideoGenerateOptions, aa as VideoResponse, ab as WatchJobOptions, ac as WebSearchPlugin } from './client-CAedbgfN.cjs';
 import { TCloudSandboxConfig, TCloudSandbox } from './sandbox.cjs';
 export { TCloudSandboxAttestationStatus, TCloudSandboxCreateOptions, TCloudSandboxCreateResult, TCloudSandboxTee, TCloudTeeAttestationChallenge, TCloudTeeAttestationHeartbeat, TCloudTeeAttestationHeartbeatOptions, TCloudTeeAttestationHeartbeatSample, createTeeAttestationChallenge, generateAttestationNonce, startTeeAttestationHeartbeat } from './sandbox.cjs';
 export { AsyncAttestationPolicy, AsyncHardwareVerifier, AttestationPolicy, AttestationVerificationResult, HardwareVerifier, HardwareVerifierResult, NitroAttestationDocument, NitroVerifierOptions, ParsedAttestation, SevSnpReport, SevSnpVerifierOptions, TeeType, assertAttestation, createNitroHardwareVerifier, createSevSnpHardwareVerifier, createTdxHardwareVerifier, normalizeTeeType, parseAttestation, parseNitroAttestationDocument, parseSevSnpReport, toHex, verifyAttestation, verifyAttestationAsync } from '@tangle-network/tcloud-attestation';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ShieldedWallet, generateWallet } from './shielded.js';
 export { createShieldedClient, estimateCost, signSpendAuth } from './shielded.js';
-import { T as TCloudClient, a as TCloudConfig, R as RotatingClientConfig } from './client-CaD5Oal0.js';
-export { A as ApiKeyInfo, b as AvatarGenerateRequest, c as AvatarGenerateResponse, d as AvatarJobStatus, e as AvatarResult, B as BatchJobResponse, f as BatchRequest, g as BridgeOptions, h as BridgeSession, C as ChatCompletion, i as ChatCompletionChunk, j as ChatMessage, k as ChatOptions, l as ChatPlugin, m as CompletionOptions, n as CompletionResponse, o as CreateKeyOptions, p as CreatedKey, q as CreditBalance, E as EmbeddingOptions, r as EmbeddingResponse, F as FineTuningJob, s as FineTuningJobOptions, G as GatewayOptions, I as ImageEditAttachment, t as ImageEditOptions, u as ImageGenerateOptions, v as ImageResponse, J as JobEvent, M as Model, O as Operator, w as OperatorInfo, P as PricingTier, x as PrivacyConfig, y as PrivateRouter, z as PrivateRouterConfig, D as RerankOptions, H as RerankResponse, K as RetryConfig, L as RotatingRoutingConfig, N as RotationStats, Q as RoutingConfig, S as RoutingStrategy, U as SandboxChatOptions, V as SearchHit, W as SearchOptions, X as SearchProvider, Y as SearchRecency, Z as SearchResponse, _ as ShieldedConfig, $ as SpendAuth, a0 as SpendingLimits, a1 as TCloudError, a2 as TierConfig, a3 as TranscriptionResponse, a4 as UpdateKeyOptions, a5 as VideoGenerateOptions, a6 as VideoResponse, a7 as WatchJobOptions, a8 as WebSearchPlugin } from './client-CaD5Oal0.js';
+import { a as TCloudClient, T as TCloudConfig, R as RotatingClientConfig } from './client-CAedbgfN.js';
+export { A as ApiKeyInfo, b as AvatarGenerateRequest, c as AvatarGenerateResponse, d as AvatarJobStatus, e as AvatarResult, B as BatchJobResponse, f as BatchRequest, g as BridgeOptions, h as BridgeSession, C as ChatCompletion, i as ChatCompletionChunk, j as ChatMessage, k as ChatOptions, l as ChatPlugin, m as CompletionOptions, n as CompletionResponse, o as CreateKeyOptions, p as CreatedKey, q as CreditBalance, E as EmbeddingOptions, r as EmbeddingResponse, F as FineTuningJob, s as FineTuningJobOptions, G as GatewayOptions, I as ImageEditAttachment, t as ImageEditOptions, u as ImageGenerateOptions, v as ImageResponse, J as JobEvent, M as Model, O as Operator, w as OperatorInfo, P as PricingTier, x as PrivacyConfig, y as PrivateRouter, z as PrivateRouterConfig, D as RerankOptions, H as RerankResponse, K as ResearchHit, L as ResearchOptions, N as ResearchProvider, Q as ResearchResponse, S as RetryConfig, U as RotatingRoutingConfig, V as RotationStats, W as RoutingConfig, X as RoutingStrategy, Y as SandboxChatOptions, Z as SearchHit, _ as SearchOptions, $ as SearchProvider, a0 as SearchRecency, a1 as SearchResponse, a2 as ShieldedConfig, a3 as SpendAuth, a4 as SpendingLimits, a5 as TCloudError, a6 as TierConfig, a7 as TranscriptionResponse, a8 as UpdateKeyOptions, a9 as VideoGenerateOptions, aa as VideoResponse, ab as WatchJobOptions, ac as WebSearchPlugin } from './client-CAedbgfN.js';
 import { TCloudSandboxConfig, TCloudSandbox } from './sandbox.js';
 export { TCloudSandboxAttestationStatus, TCloudSandboxCreateOptions, TCloudSandboxCreateResult, TCloudSandboxTee, TCloudTeeAttestationChallenge, TCloudTeeAttestationHeartbeat, TCloudTeeAttestationHeartbeatOptions, TCloudTeeAttestationHeartbeatSample, createTeeAttestationChallenge, generateAttestationNonce, startTeeAttestationHeartbeat } from './sandbox.js';
 export { AsyncAttestationPolicy, AsyncHardwareVerifier, AttestationPolicy, AttestationVerificationResult, HardwareVerifier, HardwareVerifierResult, NitroAttestationDocument, NitroVerifierOptions, ParsedAttestation, SevSnpReport, SevSnpVerifierOptions, TeeType, assertAttestation, createNitroHardwareVerifier, createSevSnpHardwareVerifier, createTdxHardwareVerifier, normalizeTeeType, parseAttestation, parseNitroAttestationDocument, parseSevSnpReport, toHex, verifyAttestation, verifyAttestationAsync } from '@tangle-network/tcloud-attestation';

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   toHex,
   verifyAttestation,
   verifyAttestationAsync
-} from "./chunk-UBUCUSCF.js";
+} from "./chunk-O33Y34UQ.js";
 import {
   TCloudSandbox,
   createTeeAttestationChallenge,
@@ -23,13 +23,14 @@ import {
   estimateCost,
   generateWallet,
   signSpendAuth
-} from "./chunk-THOMQXU5.js";
+} from "./chunk-GDGQQRE3.js";
 import {
   BridgeSession,
   PrivateRouter,
   TCloudClient,
   TCloudError
-} from "./chunk-U4VOGRVW.js";
+} from "./chunk-H3K3A3EI.js";
+import "./chunk-YK2SGW76.js";
 export {
   BridgeSession,
   PrivateRouter,

package/dist/instance.cjs

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/instance.ts
@@ -261,48 +251,43 @@ var PrivateRouter = class {
   }
 };
 
+// package.json
+var version = "0.5.0";
+
+// src/version.ts
+function packageVersion() {
+  return version;
+}
+
 // src/client.ts
 var ROTATING_MARKER = "__tcloudRotating";
 var DIRECT_CLI_BRIDGE_MARKER = "__tcloudDirectCliBridge";
 var DEFAULT_BASE_URL = "https://router.tangle.tools/v1";
-var SDK_VERSION = "0.4.0";
 async function proxiedFetch(privacy, url, init, streaming) {
   if (!privacy || privacy.mode === "direct") {
     return fetch(url, init);
   }
-  if (privacy.mode === "relayer") {
-    if (!privacy.relayerUrl) {
-      throw new Error('relayerUrl is required when privacy mode is "relayer"');
-    }
-    const proxyPath = streaming ? "/relay/proxy-stream" : "/relay/proxy";
-    const hdrs = {};
-    if (init.headers) {
-      const entries = init.headers instanceof Headers ? Array.from(init.headers.entries()) : Object.entries(init.headers);
-      for (const [k, v] of entries) hdrs[k] = v;
-    }
-    return fetch(`${privacy.relayerUrl}${proxyPath}`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        target: url,
-        body: typeof init.body === "string" ? JSON.parse(init.body) : init.body,
-        headers: hdrs
-      })
-    });
-  }
-  if (privacy.mode === "socks5") {
-    if (!privacy.socksProxy) {
-      throw new Error('socksProxy is required when privacy mode is "socks5"');
-    }
-    const { SocksProxyAgent } = await import("socks-proxy-agent");
-    const agent = new SocksProxyAgent(privacy.socksProxy);
-    return fetch(url, {
-      ...init,
-      // @ts-expect-error agent is supported by Node's undici but not in the standard RequestInit type
-      agent
-    });
-  }
-  return fetch(url, init);
+  if (privacy.mode !== "relayer") {
+    throw new Error(`Unsupported privacy mode: ${String(privacy.mode)}`);
+  }
+  if (!privacy.relayerUrl) {
+    throw new Error('relayerUrl is required when privacy mode is "relayer"');
+  }
+  const proxyPath = streaming ? "/relay/proxy-stream" : "/relay/proxy";
+  const headers = {};
+  if (init.headers) {
+    const entries = init.headers instanceof Headers ? Array.from(init.headers.entries()) : Object.entries(init.headers);
+    for (const [key, value] of entries) headers[key] = value;
+  }
+  return fetch(`${privacy.relayerUrl}${proxyPath}`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      target: url,
+      body: typeof init.body === "string" ? JSON.parse(init.body) : init.body,
+      headers
+    })
+  });
 }
 var DEFAULT_RETRY = {
   maxRetries: 3,
@@ -467,7 +452,7 @@ var TCloudClient = class _TCloudClient {
     this.timeoutMs = config.timeout ?? DEFAULT_TIMEOUT_MS;
     this.headers = {
       "Content-Type": "application/json",
-      "X-Tangle-Client": `tcloud-sdk/${SDK_VERSION}`
+      "X-Tangle-Client": `tcloud-sdk/${packageVersion()}`
     };
     if (this.apiKey) {
       this.headers["Authorization"] = `Bearer ${this.apiKey}`;
@@ -1041,6 +1026,26 @@ var TCloudClient = class _TCloudClient {
       })
     });
   }
+  /** Run a multi-step deep-research task through Tangle Router billing and
+   *  provider routing (POST /v1/research). Slower and costlier than `search` —
+   *  the provider synthesizes an answer over many fetches. Pick depth with
+   *  `effort` (provider-specific vocabulary; see {@link ResearchOptions.effort}). */
+  async research(options) {
+    return this._request(`${this.baseURL}/research`, {
+      method: "POST",
+      body: JSON.stringify({
+        query: options.query,
+        provider: options.provider,
+        model: options.model,
+        effort: options.effort,
+        maxResults: options.maxResults,
+        searchRecency: options.searchRecency,
+        includeDomains: options.includeDomains,
+        excludeDomains: options.excludeDomains,
+        outputSchema: options.outputSchema
+      })
+    });
+  }
   /** Text-to-speech */
   async speech(options) {
     const res = await this._requestRaw(`${this.baseURL}/audio/speech`, {

package/dist/instance.d.cts

@@ -1,4 +1,4 @@
-import { a as TCloudConfig, T as TCloudClient } from './client-CaD5Oal0.cjs';
+import { T as TCloudConfig, a as TCloudClient } from './client-CAedbgfN.cjs';
 import '@tangle-network/sandbox';
 
 /**

package/dist/instance.d.ts

@@ -1,4 +1,4 @@
-import { a as TCloudConfig, T as TCloudClient } from './client-CaD5Oal0.js';
+import { T as TCloudConfig, a as TCloudClient } from './client-CAedbgfN.js';
 import '@tangle-network/sandbox';
 
 /**

package/dist/instance.js

@@ -1,6 +1,7 @@
 import {
   TCloudClient
-} from "./chunk-U4VOGRVW.js";
+} from "./chunk-H3K3A3EI.js";
+import "./chunk-YK2SGW76.js";
 
 // src/instance.ts
 import { spawn } from "child_process";