@tangle-network/tcloud 0.4.9 → 0.4.11

package/README.md

@@ -14,6 +14,7 @@ Zero framework dependencies. Pure `fetch` + SSE. Works in Node.js, Deno, Bun, an
   - [Full Chat Completion](#full-chat-completion)
   - [Private Inference](#private-inference)
   - [Embeddings](#embeddings)
+  - [Web Search](#web-search)
   - [Video & Avatar Generation](#video--avatar-generation)
   - [Async Jobs](#async-jobs)
   - [Operator Routing](#operator-routing)
@@ -177,6 +178,32 @@ const response = await client.embeddings({
 console.log(response.data[0].embedding.length) // 1536
 ```
 
+### Web Search
+
+```ts
+const results = await client.search({
+  query: 'latest Tangle docs',
+  provider: 'exa',
+  maxResults: 5,
+})
+
+console.log(results.data[0].title)
+console.log(results.citations)
+```
+
+Use search inside chat with either the typed gateway shorthand or OpenRouter-compatible plugins:
+
+```ts
+await client.ask('What changed in Tangle this week?', {
+  webSearch: { provider: 'exa', maxResults: 5, searchRecency: 'week' },
+})
+
+await client.chat({
+  messages: [{ role: 'user', content: 'Summarize recent AI video model releases.' }],
+  plugins: [{ id: 'web', engine: 'parallel', max_results: 5 }],
+})
+```
+
 ### Video & Avatar Generation
 
 ```ts
@@ -345,6 +372,7 @@ tcloud chat                                # Interactive mode
 ```bash
 tcloud models                  # List available models
 tcloud models -s llama         # Search models
+tcloud search "Tangle docs" --provider exa --max-results 5
 tcloud operators               # List active operators
 ```
 
@@ -437,6 +465,12 @@ See the [`examples/`](./examples/) directory — each is a self-contained script
 | 08 | [OpenAI SDK](./examples/08-openai-compat.ts) | Drop-in replacement via baseURL |
 | 09 | [Vercel AI SDK](./examples/09-vercel-ai-sdk.ts) | generateText + streamText with Tangle |
 | 10 | [Spending Limits](./examples/10-spending-limits.ts) | Budget caps, request limits, warning callbacks |
+| 11 | [Inference Strategies](./examples/11-inference-strategies.ts) | Min-exposure + operator rotation patterns |
+| 12 | [Bridge Sessions](./examples/12-bridge-sessions.ts) | Persistent bridge sessions for harness routing |
+| 13 | [Bridge Chat App](./examples/13-bridge-chat-app.ts) | Multi-turn bridge application |
+| 14 | [Direct cli-bridge](./examples/14-direct-cli-bridge.ts) | Local cli-bridge, no router |
+| 15 | [Sandbox Agents](./examples/15-sandbox-agents.ts) | Sandbox agents + inline AgentProfile |
+| 16 | [Tangle Intelligence Hook](./examples/16-tangle-intelligence-hook.ts) | Trace inference into hosted intelligence (one OTLP block) |
 
 Run any example:
 ```bash

package/dist/{chunk-27OTTDMZ.js → chunk-IWDE7ZPN.js}

@@ -4,10 +4,10 @@ import {
 import {
   createShieldedClient,
   generateWallet
-} from "./chunk-YWN4JOCW.js";
+} from "./chunk-THOMQXU5.js";
 import {
   TCloudClient
-} from "./chunk-CVWEKCQ3.js";
+} from "./chunk-U4VOGRVW.js";
 
 // src/index.ts
 import {

package/dist/{chunk-YWN4JOCW.js → chunk-THOMQXU5.js}

@@ -1,6 +1,6 @@
 import {
   TCloudClient
-} from "./chunk-CVWEKCQ3.js";
+} from "./chunk-U4VOGRVW.js";
 
 // src/shielded.ts
 import { privateKeyToAccount } from "viem/accounts";

package/dist/{chunk-CVWEKCQ3.js → chunk-U4VOGRVW.js}

@@ -289,6 +289,8 @@ var PROTECTED_PROVIDER_OPTION_KEYS = /* @__PURE__ */ new Set([
   "tools",
   "tool_choice",
   "toolChoice",
+  "plugins",
+  "webSearch",
   "gateway",
   "bridge",
   "agent_profile",
@@ -647,6 +649,10 @@ var TCloudClient = class _TCloudClient {
   /** Build the chat completions request body */
   _chatBody(options, stream) {
     const providerOptions = sanitizeProviderOptions(options.providerOptions);
+    const gateway = options.gateway || options.webSearch !== void 0 ? {
+      ...options.gateway,
+      ...options.webSearch !== void 0 && options.gateway?.webSearch === void 0 ? { webSearch: options.webSearch } : {}
+    } : void 0;
     const sandboxBody = {};
     if (options.sandbox?.agentProfile) sandboxBody.agent_profile = options.sandbox.agentProfile;
     if (options.sandbox?.sessionId) sandboxBody.session_id = options.sandbox.sessionId;
@@ -667,7 +673,8 @@ var TCloudClient = class _TCloudClient {
       response_format: options.responseFormat,
       tools: options.tools,
       tool_choice: options.toolChoice,
-      ...options.gateway ? { gateway: options.gateway } : {},
+      plugins: options.plugins,
+      ...gateway ? { gateway } : {},
       ...sandboxBody
     });
   }
@@ -976,6 +983,21 @@ var TCloudClient = class _TCloudClient {
       })
     });
   }
+  /** Search the web through Tangle Router billing and provider routing. */
+  async search(options) {
+    return this._request(`${this.baseURL}/search`, {
+      method: "POST",
+      body: JSON.stringify({
+        query: options.query,
+        provider: options.provider,
+        model: options.model,
+        maxResults: options.maxResults,
+        searchRecency: options.searchRecency,
+        includeDomains: options.includeDomains,
+        excludeDomains: options.excludeDomains
+      })
+    });
+  }
   /** Text-to-speech */
   async speech(options) {
     const res = await this._requestRaw(`${this.baseURL}/audio/speech`, {

package/dist/cli.cjs

@@ -317,6 +317,8 @@ var PROTECTED_PROVIDER_OPTION_KEYS = /* @__PURE__ */ new Set([
   "tools",
   "tool_choice",
   "toolChoice",
+  "plugins",
+  "webSearch",
   "gateway",
   "bridge",
   "agent_profile",
@@ -675,6 +677,10 @@ var TCloudClient = class _TCloudClient {
   /** Build the chat completions request body */
   _chatBody(options, stream) {
     const providerOptions = sanitizeProviderOptions(options.providerOptions);
+    const gateway = options.gateway || options.webSearch !== void 0 ? {
+      ...options.gateway,
+      ...options.webSearch !== void 0 && options.gateway?.webSearch === void 0 ? { webSearch: options.webSearch } : {}
+    } : void 0;
     const sandboxBody = {};
     if (options.sandbox?.agentProfile) sandboxBody.agent_profile = options.sandbox.agentProfile;
     if (options.sandbox?.sessionId) sandboxBody.session_id = options.sandbox.sessionId;
@@ -695,7 +701,8 @@ var TCloudClient = class _TCloudClient {
       response_format: options.responseFormat,
       tools: options.tools,
       tool_choice: options.toolChoice,
-      ...options.gateway ? { gateway: options.gateway } : {},
+      plugins: options.plugins,
+      ...gateway ? { gateway } : {},
       ...sandboxBody
     });
   }
@@ -1004,6 +1011,21 @@ var TCloudClient = class _TCloudClient {
       })
     });
   }
+  /** Search the web through Tangle Router billing and provider routing. */
+  async search(options) {
+    return this._request(`${this.baseURL}/search`, {
+      method: "POST",
+      body: JSON.stringify({
+        query: options.query,
+        provider: options.provider,
+        model: options.model,
+        maxResults: options.maxResults,
+        searchRecency: options.searchRecency,
+        includeDomains: options.includeDomains,
+        excludeDomains: options.excludeDomains
+      })
+    });
+  }
   /** Text-to-speech */
   async speech(options) {
     const res = await this._requestRaw(`${this.baseURL}/audio/speech`, {
@@ -2330,6 +2352,35 @@ program.command("models").description("List available models").option("-s, --sea
     console.error("Error:", e.message);
   }
 });
+program.command("search").description("Search the web").argument("<query>", "Search query").option("--provider <provider>", "Search provider: perplexity, exa, you, parallel, tavily, brave").option("-n, --max-results <n>", "Maximum results").option("--recency <period>", "day, week, month, or year").option("--include-domain <domain...>", "Restrict to domains").option("--exclude-domain <domain...>", "Exclude domains").option("--json", "Print raw JSON response").action(async (query, opts) => {
+  const client = getClient();
+  try {
+    const resp = await client.search({
+      query,
+      provider: opts.provider,
+      maxResults: optionalNumber(opts.maxResults),
+      searchRecency: opts.recency,
+      includeDomains: opts.includeDomain,
+      excludeDomains: opts.excludeDomain
+    });
+    if (opts.json) {
+      printJson(resp);
+      return;
+    }
+    console.log(`${resp.provider} results for "${resp.query}":`);
+    resp.data.forEach((hit, index) => {
+      console.log(`${index + 1}. ${hit.title}`);
+      console.log(`   ${hit.url}`);
+      if (hit.snippet) console.log(`   ${hit.snippet}`);
+    });
+    if (resp.usage?.billed_cost != null) {
+      console.log(`  \u21B3 $${resp.usage.billed_cost.toFixed(6)} billed`);
+    }
+  } catch (e) {
+    console.error("Error:", e.message);
+    process.exit(1);
+  }
+});
 program.command("image-generate").description("Generate an image").requiredOption("-p, --prompt <prompt>", "Prompt").option("-m, --model <model>", "Image model").option("--size <size>", "Output size").option("--quality <quality>", "Output quality").option("-n, --count <n>", "Number of images").option("--response-format <format>", "url or b64_json").option("--json", "Print raw JSON response").action(async (opts) => {
   const client = getClient();
   try {

package/dist/cli.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   TCloud
-} from "./chunk-27OTTDMZ.js";
+} from "./chunk-IWDE7ZPN.js";
 import {
   TCloudSandbox
 } from "./chunk-DRCOPW7D.js";
 import {
   generateWallet
-} from "./chunk-YWN4JOCW.js";
-import "./chunk-CVWEKCQ3.js";
+} from "./chunk-THOMQXU5.js";
+import "./chunk-U4VOGRVW.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -357,6 +357,35 @@ program.command("models").description("List available models").option("-s, --sea
     console.error("Error:", e.message);
   }
 });
+program.command("search").description("Search the web").argument("<query>", "Search query").option("--provider <provider>", "Search provider: perplexity, exa, you, parallel, tavily, brave").option("-n, --max-results <n>", "Maximum results").option("--recency <period>", "day, week, month, or year").option("--include-domain <domain...>", "Restrict to domains").option("--exclude-domain <domain...>", "Exclude domains").option("--json", "Print raw JSON response").action(async (query, opts) => {
+  const client = getClient();
+  try {
+    const resp = await client.search({
+      query,
+      provider: opts.provider,
+      maxResults: optionalNumber(opts.maxResults),
+      searchRecency: opts.recency,
+      includeDomains: opts.includeDomain,
+      excludeDomains: opts.excludeDomain
+    });
+    if (opts.json) {
+      printJson(resp);
+      return;
+    }
+    console.log(`${resp.provider} results for "${resp.query}":`);
+    resp.data.forEach((hit, index) => {
+      console.log(`${index + 1}. ${hit.title}`);
+      console.log(`   ${hit.url}`);
+      if (hit.snippet) console.log(`   ${hit.snippet}`);
+    });
+    if (resp.usage?.billed_cost != null) {
+      console.log(`  \u21B3 $${resp.usage.billed_cost.toFixed(6)} billed`);
+    }
+  } catch (e) {
+    console.error("Error:", e.message);
+    process.exit(1);
+  }
+});
 program.command("image-generate").description("Generate an image").requiredOption("-p, --prompt <prompt>", "Prompt").option("-m, --model <model>", "Image model").option("--size <size>", "Output size").option("--quality <quality>", "Output quality").option("-n, --count <n>", "Number of images").option("--response-format <format>", "url or b64_json").option("--json", "Print raw JSON response").action(async (opts) => {
   const client = getClient();
   try {

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

@@ -150,6 +150,60 @@ interface RerankResponse {
         relevance_score: number;
     }[];
 }
+type SearchProvider = 'perplexity' | 'exa' | 'you' | 'parallel' | 'tavily' | 'brave';
+type SearchRecency = 'day' | 'week' | 'month' | 'year';
+interface SearchOptions {
+    query: string;
+    provider?: SearchProvider;
+    /** Alias accepted by the Router for provider-compatible clients. */
+    model?: SearchProvider;
+    maxResults?: number;
+    searchRecency?: SearchRecency;
+    includeDomains?: string[];
+    excludeDomains?: string[];
+}
+interface SearchHit {
+    title: string;
+    url: string;
+    snippet?: string;
+    publishedAt?: string;
+    score?: number;
+    source?: string;
+}
+interface SearchResponse {
+    id: string;
+    object: 'search.result' | string;
+    provider: SearchProvider;
+    model: string;
+    query: string;
+    data: SearchHit[];
+    citations: string[];
+    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';
+    provider?: SearchProvider;
+    maxResults?: number;
+    max_results?: number;
+    searchPrompt?: string;
+    search_prompt?: string;
+    includeDomains?: string[];
+    include_domains?: string[];
+    excludeDomains?: string[];
+    exclude_domains?: string[];
+    searchRecency?: SearchRecency;
+    search_recency?: SearchRecency;
+}
+type ChatPlugin = WebSearchPlugin | ({
+    id: string;
+} & Record<string, unknown>);
 interface CompletionOptions {
     model?: string;
     prompt: string;
@@ -331,6 +385,16 @@ interface GatewayOptions {
     optimize?: 'cost' | 'latency' | 'quality';
     /** Disable response cache for this request. */
     cache?: boolean;
+    /** Enable or configure router-managed web search for chat completions. */
+    webSearch?: boolean | {
+        provider?: SearchProvider;
+        engine?: 'native' | 'exa' | 'parallel' | 'firecrawl';
+        maxResults?: number;
+        searchPrompt?: string;
+        includeDomains?: string[];
+        excludeDomains?: string[];
+        searchRecency?: SearchRecency;
+    };
     /**
      * RSA / MoA: population-based quality amplification.
      * Spawns N parallel calls, aggregates K at a time, refines over T rounds.
@@ -430,6 +494,10 @@ interface ChatOptions {
             name: string;
         };
     };
+    /** OpenRouter-compatible plugins, e.g. `[{ id: 'web', max_results: 5 }]`. */
+    plugins?: ChatPlugin[];
+    /** Shorthand for `gateway.webSearch`; explicit `gateway.webSearch` wins when both are set. */
+    webSearch?: GatewayOptions['webSearch'];
     /**
      * Gateway options: routing, compliance, inference strategies (RSA/MoA/Best-of-N).
      * Sent as `body.gateway` to the Router.
@@ -969,6 +1037,8 @@ declare class TCloudClient {
     imagesEdit(options: ImageEditOptions): Promise<ImageResponse>;
     /** Rerank documents by relevance to a query */
     rerank(options: RerankOptions): Promise<RerankResponse>;
+    /** Search the web through Tangle Router billing and provider routing. */
+    search(options: SearchOptions): Promise<SearchResponse>;
     /** Text-to-speech */
     speech(options: {
         model?: string;
@@ -1286,4 +1356,4 @@ declare class TCloudError extends Error {
     constructor(status: number, message: string);
 }
 
-export { type VideoGenerateOptions as $, type ApiKeyInfo as A, type BatchJobResponse as B, type ChatCompletion as C, type RerankResponse as D, type EmbeddingOptions as E, type FineTuningJob as F, type GatewayOptions as G, type RetryConfig as H, type ImageEditAttachment as I, type JobEvent as J, type RotatingRoutingConfig as K, type RotationStats as L, type Model as M, type RoutingConfig as N, type Operator as O, type PricingTier as P, type RoutingStrategy as Q, type RotatingClientConfig as R, type SandboxChatOptions as S, TCloudClient as T, type ShieldedConfig as U, type SpendAuth as V, type SpendingLimits as W, TCloudError as X, type TierConfig as Y, type TranscriptionResponse as Z, type UpdateKeyOptions as _, type TCloudConfig as a, type VideoResponse as a0, type WatchJobOptions as a1, 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 CompletionOptions as l, type CompletionResponse as m, type CreateKeyOptions as n, type CreatedKey as o, type CreditBalance as p, type EmbeddingResponse as q, type FineTuningJobOptions as r, type ImageEditOptions as s, type ImageGenerateOptions as t, type ImageResponse as u, type OperatorInfo as v, type PrivacyConfig as w, PrivateRouter as x, type PrivateRouterConfig as y, type RerankOptions as z };
+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 };

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

@@ -150,6 +150,60 @@ interface RerankResponse {
         relevance_score: number;
     }[];
 }
+type SearchProvider = 'perplexity' | 'exa' | 'you' | 'parallel' | 'tavily' | 'brave';
+type SearchRecency = 'day' | 'week' | 'month' | 'year';
+interface SearchOptions {
+    query: string;
+    provider?: SearchProvider;
+    /** Alias accepted by the Router for provider-compatible clients. */
+    model?: SearchProvider;
+    maxResults?: number;
+    searchRecency?: SearchRecency;
+    includeDomains?: string[];
+    excludeDomains?: string[];
+}
+interface SearchHit {
+    title: string;
+    url: string;
+    snippet?: string;
+    publishedAt?: string;
+    score?: number;
+    source?: string;
+}
+interface SearchResponse {
+    id: string;
+    object: 'search.result' | string;
+    provider: SearchProvider;
+    model: string;
+    query: string;
+    data: SearchHit[];
+    citations: string[];
+    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';
+    provider?: SearchProvider;
+    maxResults?: number;
+    max_results?: number;
+    searchPrompt?: string;
+    search_prompt?: string;
+    includeDomains?: string[];
+    include_domains?: string[];
+    excludeDomains?: string[];
+    exclude_domains?: string[];
+    searchRecency?: SearchRecency;
+    search_recency?: SearchRecency;
+}
+type ChatPlugin = WebSearchPlugin | ({
+    id: string;
+} & Record<string, unknown>);
 interface CompletionOptions {
     model?: string;
     prompt: string;
@@ -331,6 +385,16 @@ interface GatewayOptions {
     optimize?: 'cost' | 'latency' | 'quality';
     /** Disable response cache for this request. */
     cache?: boolean;
+    /** Enable or configure router-managed web search for chat completions. */
+    webSearch?: boolean | {
+        provider?: SearchProvider;
+        engine?: 'native' | 'exa' | 'parallel' | 'firecrawl';
+        maxResults?: number;
+        searchPrompt?: string;
+        includeDomains?: string[];
+        excludeDomains?: string[];
+        searchRecency?: SearchRecency;
+    };
     /**
      * RSA / MoA: population-based quality amplification.
      * Spawns N parallel calls, aggregates K at a time, refines over T rounds.
@@ -430,6 +494,10 @@ interface ChatOptions {
             name: string;
         };
     };
+    /** OpenRouter-compatible plugins, e.g. `[{ id: 'web', max_results: 5 }]`. */
+    plugins?: ChatPlugin[];
+    /** Shorthand for `gateway.webSearch`; explicit `gateway.webSearch` wins when both are set. */
+    webSearch?: GatewayOptions['webSearch'];
     /**
      * Gateway options: routing, compliance, inference strategies (RSA/MoA/Best-of-N).
      * Sent as `body.gateway` to the Router.
@@ -969,6 +1037,8 @@ declare class TCloudClient {
     imagesEdit(options: ImageEditOptions): Promise<ImageResponse>;
     /** Rerank documents by relevance to a query */
     rerank(options: RerankOptions): Promise<RerankResponse>;
+    /** Search the web through Tangle Router billing and provider routing. */
+    search(options: SearchOptions): Promise<SearchResponse>;
     /** Text-to-speech */
     speech(options: {
         model?: string;
@@ -1286,4 +1356,4 @@ declare class TCloudError extends Error {
     constructor(status: number, message: string);
 }
 
-export { type VideoGenerateOptions as $, type ApiKeyInfo as A, type BatchJobResponse as B, type ChatCompletion as C, type RerankResponse as D, type EmbeddingOptions as E, type FineTuningJob as F, type GatewayOptions as G, type RetryConfig as H, type ImageEditAttachment as I, type JobEvent as J, type RotatingRoutingConfig as K, type RotationStats as L, type Model as M, type RoutingConfig as N, type Operator as O, type PricingTier as P, type RoutingStrategy as Q, type RotatingClientConfig as R, type SandboxChatOptions as S, TCloudClient as T, type ShieldedConfig as U, type SpendAuth as V, type SpendingLimits as W, TCloudError as X, type TierConfig as Y, type TranscriptionResponse as Z, type UpdateKeyOptions as _, type TCloudConfig as a, type VideoResponse as a0, type WatchJobOptions as a1, 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 CompletionOptions as l, type CompletionResponse as m, type CreateKeyOptions as n, type CreatedKey as o, type CreditBalance as p, type EmbeddingResponse as q, type FineTuningJobOptions as r, type ImageEditOptions as s, type ImageGenerateOptions as t, type ImageResponse as u, type OperatorInfo as v, type PrivacyConfig as w, PrivateRouter as x, type PrivateRouterConfig as y, type RerankOptions as z };
+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 };

package/dist/index.cjs

@@ -348,6 +348,8 @@ var PROTECTED_PROVIDER_OPTION_KEYS = /* @__PURE__ */ new Set([
   "tools",
   "tool_choice",
   "toolChoice",
+  "plugins",
+  "webSearch",
   "gateway",
   "bridge",
   "agent_profile",
@@ -706,6 +708,10 @@ var TCloudClient = class _TCloudClient {
   /** Build the chat completions request body */
   _chatBody(options, stream) {
     const providerOptions = sanitizeProviderOptions(options.providerOptions);
+    const gateway = options.gateway || options.webSearch !== void 0 ? {
+      ...options.gateway,
+      ...options.webSearch !== void 0 && options.gateway?.webSearch === void 0 ? { webSearch: options.webSearch } : {}
+    } : void 0;
     const sandboxBody = {};
     if (options.sandbox?.agentProfile) sandboxBody.agent_profile = options.sandbox.agentProfile;
     if (options.sandbox?.sessionId) sandboxBody.session_id = options.sandbox.sessionId;
@@ -726,7 +732,8 @@ var TCloudClient = class _TCloudClient {
       response_format: options.responseFormat,
       tools: options.tools,
       tool_choice: options.toolChoice,
-      ...options.gateway ? { gateway: options.gateway } : {},
+      plugins: options.plugins,
+      ...gateway ? { gateway } : {},
       ...sandboxBody
     });
   }
@@ -1035,6 +1042,21 @@ var TCloudClient = class _TCloudClient {
       })
     });
   }
+  /** Search the web through Tangle Router billing and provider routing. */
+  async search(options) {
+    return this._request(`${this.baseURL}/search`, {
+      method: "POST",
+      body: JSON.stringify({
+        query: options.query,
+        provider: options.provider,
+        model: options.model,
+        maxResults: options.maxResults,
+        searchRecency: options.searchRecency,
+        includeDomains: options.includeDomains,
+        excludeDomains: options.excludeDomains
+      })
+    });
+  }
   /** 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-CF-tpVsi.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 CompletionOptions, m as CompletionResponse, n as CreateKeyOptions, o as CreatedKey, p as CreditBalance, E as EmbeddingOptions, q as EmbeddingResponse, F as FineTuningJob, r as FineTuningJobOptions, G as GatewayOptions, I as ImageEditAttachment, s as ImageEditOptions, t as ImageGenerateOptions, u as ImageResponse, J as JobEvent, M as Model, O as Operator, v as OperatorInfo, P as PricingTier, w as PrivacyConfig, x as PrivateRouter, y as PrivateRouterConfig, z as RerankOptions, D as RerankResponse, H as RetryConfig, K as RotatingRoutingConfig, L as RotationStats, N as RoutingConfig, Q as RoutingStrategy, S as SandboxChatOptions, U as ShieldedConfig, V as SpendAuth, W as SpendingLimits, X as TCloudError, Y as TierConfig, Z as TranscriptionResponse, _ as UpdateKeyOptions, $ as VideoGenerateOptions, a0 as VideoResponse, a1 as WatchJobOptions } from './client-CF-tpVsi.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 { 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-CF-tpVsi.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 CompletionOptions, m as CompletionResponse, n as CreateKeyOptions, o as CreatedKey, p as CreditBalance, E as EmbeddingOptions, q as EmbeddingResponse, F as FineTuningJob, r as FineTuningJobOptions, G as GatewayOptions, I as ImageEditAttachment, s as ImageEditOptions, t as ImageGenerateOptions, u as ImageResponse, J as JobEvent, M as Model, O as Operator, v as OperatorInfo, P as PricingTier, w as PrivacyConfig, x as PrivateRouter, y as PrivateRouterConfig, z as RerankOptions, D as RerankResponse, H as RetryConfig, K as RotatingRoutingConfig, L as RotationStats, N as RoutingConfig, Q as RoutingStrategy, S as SandboxChatOptions, U as ShieldedConfig, V as SpendAuth, W as SpendingLimits, X as TCloudError, Y as TierConfig, Z as TranscriptionResponse, _ as UpdateKeyOptions, $ as VideoGenerateOptions, a0 as VideoResponse, a1 as WatchJobOptions } from './client-CF-tpVsi.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 { 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-27OTTDMZ.js";
+} from "./chunk-IWDE7ZPN.js";
 import {
   TCloudSandbox,
   createTeeAttestationChallenge,
@@ -23,13 +23,13 @@ import {
   estimateCost,
   generateWallet,
   signSpendAuth
-} from "./chunk-YWN4JOCW.js";
+} from "./chunk-THOMQXU5.js";
 import {
   BridgeSession,
   PrivateRouter,
   TCloudClient,
   TCloudError
-} from "./chunk-CVWEKCQ3.js";
+} from "./chunk-U4VOGRVW.js";
 export {
   BridgeSession,
   PrivateRouter,

package/dist/instance.cjs

@@ -332,6 +332,8 @@ var PROTECTED_PROVIDER_OPTION_KEYS = /* @__PURE__ */ new Set([
   "tools",
   "tool_choice",
   "toolChoice",
+  "plugins",
+  "webSearch",
   "gateway",
   "bridge",
   "agent_profile",
@@ -690,6 +692,10 @@ var TCloudClient = class _TCloudClient {
   /** Build the chat completions request body */
   _chatBody(options, stream) {
     const providerOptions = sanitizeProviderOptions(options.providerOptions);
+    const gateway = options.gateway || options.webSearch !== void 0 ? {
+      ...options.gateway,
+      ...options.webSearch !== void 0 && options.gateway?.webSearch === void 0 ? { webSearch: options.webSearch } : {}
+    } : void 0;
     const sandboxBody = {};
     if (options.sandbox?.agentProfile) sandboxBody.agent_profile = options.sandbox.agentProfile;
     if (options.sandbox?.sessionId) sandboxBody.session_id = options.sandbox.sessionId;
@@ -710,7 +716,8 @@ var TCloudClient = class _TCloudClient {
       response_format: options.responseFormat,
       tools: options.tools,
       tool_choice: options.toolChoice,
-      ...options.gateway ? { gateway: options.gateway } : {},
+      plugins: options.plugins,
+      ...gateway ? { gateway } : {},
       ...sandboxBody
     });
   }
@@ -1019,6 +1026,21 @@ var TCloudClient = class _TCloudClient {
       })
     });
   }
+  /** Search the web through Tangle Router billing and provider routing. */
+  async search(options) {
+    return this._request(`${this.baseURL}/search`, {
+      method: "POST",
+      body: JSON.stringify({
+        query: options.query,
+        provider: options.provider,
+        model: options.model,
+        maxResults: options.maxResults,
+        searchRecency: options.searchRecency,
+        includeDomains: options.includeDomains,
+        excludeDomains: options.excludeDomains
+      })
+    });
+  }
   /** 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-CF-tpVsi.cjs';
+import { a as TCloudConfig, T as TCloudClient } from './client-CaD5Oal0.cjs';
 import '@tangle-network/sandbox';
 
 /**

package/dist/instance.d.ts

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

package/dist/instance.js

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

package/dist/shielded.cjs

@@ -330,6 +330,8 @@ var PROTECTED_PROVIDER_OPTION_KEYS = /* @__PURE__ */ new Set([
   "tools",
   "tool_choice",
   "toolChoice",
+  "plugins",
+  "webSearch",
   "gateway",
   "bridge",
   "agent_profile",
@@ -688,6 +690,10 @@ var TCloudClient = class _TCloudClient {
   /** Build the chat completions request body */
   _chatBody(options, stream) {
     const providerOptions = sanitizeProviderOptions(options.providerOptions);
+    const gateway = options.gateway || options.webSearch !== void 0 ? {
+      ...options.gateway,
+      ...options.webSearch !== void 0 && options.gateway?.webSearch === void 0 ? { webSearch: options.webSearch } : {}
+    } : void 0;
     const sandboxBody = {};
     if (options.sandbox?.agentProfile) sandboxBody.agent_profile = options.sandbox.agentProfile;
     if (options.sandbox?.sessionId) sandboxBody.session_id = options.sandbox.sessionId;
@@ -708,7 +714,8 @@ var TCloudClient = class _TCloudClient {
       response_format: options.responseFormat,
       tools: options.tools,
       tool_choice: options.toolChoice,
-      ...options.gateway ? { gateway: options.gateway } : {},
+      plugins: options.plugins,
+      ...gateway ? { gateway } : {},
       ...sandboxBody
     });
   }
@@ -1017,6 +1024,21 @@ var TCloudClient = class _TCloudClient {
       })
     });
   }
+  /** Search the web through Tangle Router billing and provider routing. */
+  async search(options) {
+    return this._request(`${this.baseURL}/search`, {
+      method: "POST",
+      body: JSON.stringify({
+        query: options.query,
+        provider: options.provider,
+        model: options.model,
+        maxResults: options.maxResults,
+        searchRecency: options.searchRecency,
+        includeDomains: options.includeDomains,
+        excludeDomains: options.excludeDomains
+      })
+    });
+  }
   /** Text-to-speech */
   async speech(options) {
     const res = await this._requestRaw(`${this.baseURL}/audio/speech`, {

package/dist/shielded.d.cts

@@ -1,5 +1,5 @@
 import { Hex } from 'viem';
-import { a as TCloudConfig, T as TCloudClient, V as SpendAuth } from './client-CF-tpVsi.cjs';
+import { a as TCloudConfig, T as TCloudClient, $ as SpendAuth } from './client-CaD5Oal0.cjs';
 import '@tangle-network/sandbox';
 
 /**

package/dist/shielded.d.ts

@@ -1,5 +1,5 @@
 import { Hex } from 'viem';
-import { a as TCloudConfig, T as TCloudClient, V as SpendAuth } from './client-CF-tpVsi.js';
+import { a as TCloudConfig, T as TCloudClient, $ as SpendAuth } from './client-CaD5Oal0.js';
 import '@tangle-network/sandbox';
 
 /**

package/dist/shielded.js

@@ -3,8 +3,8 @@ import {
   estimateCost,
   generateWallet,
   signSpendAuth
-} from "./chunk-YWN4JOCW.js";
-import "./chunk-CVWEKCQ3.js";
+} from "./chunk-THOMQXU5.js";
+import "./chunk-U4VOGRVW.js";
 export {
   createShieldedClient,
   estimateCost,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/tcloud",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "description": "TypeScript SDK and CLI for Tangle AI Cloud — decentralized LLM inference",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -71,7 +71,7 @@
   "dependencies": {
     "@scure/bip32": "^2.2.0",
     "@scure/bip39": "^2.2.0",
-    "@tangle-network/sandbox": "^0.1.2",
+    "@tangle-network/sandbox": "^0.3.0",
     "commander": "^14.0.3",
     "viem": "^2.48.4",
     "@tangle-network/tcloud-attestation": "^0.1.1"