@tangle-network/tcloud 0.4.13 → 0.5.0

package/dist/mcp.cjs

@@ -0,0 +1,248 @@
+"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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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/mcp.ts
+var mcp_exports = {};
+__export(mcp_exports, {
+  runMcpServer: () => runMcpServer
+});
+module.exports = __toCommonJS(mcp_exports);
+var readline = __toESM(require("readline"), 1);
+
+// package.json
+var version = "0.5.0";
+
+// src/version.ts
+function packageVersion() {
+  return version;
+}
+
+// src/mcp.ts
+var SEARCH_PROVIDERS = /* @__PURE__ */ new Set(["perplexity", "exa", "you", "parallel", "tavily", "brave"]);
+var RESEARCH_PROVIDERS = /* @__PURE__ */ new Set(["perplexity", "exa", "you", "parallel", "tavily"]);
+var RECENCY_WINDOWS = /* @__PURE__ */ new Set(["day", "week", "month", "year"]);
+var SUPPORTED_PROTOCOL_VERSIONS = /* @__PURE__ */ new Set(["2025-06-18", "2025-03-26"]);
+var DEFAULT_PROTOCOL_VERSION = "2025-06-18";
+var DOMAIN_FILTER_SCHEMA = {
+  type: "array",
+  items: { type: "string" }
+};
+var TOOLS = [
+  {
+    name: "web_search",
+    description: "Search the web via the Tangle router and return live results (title, url, snippet). Use it to find primary sources and to VERIFY that a citation (paper, PMID/DOI, patent, fact) actually exists before relying on it.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "The search query." },
+        provider: {
+          type: "string",
+          description: "Optional provider: exa | parallel | perplexity | tavily | brave | you."
+        },
+        maxResults: { type: "number", description: "Optional max number of results." },
+        recency: { type: "string", description: "Optional recency window: day | week | month | year." },
+        includeDomains: { ...DOMAIN_FILTER_SCHEMA, description: "Optional: restrict results to these domains." },
+        excludeDomains: { ...DOMAIN_FILTER_SCHEMA, description: "Optional: drop results from these domains." }
+      },
+      required: ["query"]
+    }
+  },
+  {
+    name: "deep_research",
+    description: 'Run a multi-step DEEP RESEARCH task via the Tangle router: the provider reads many sources and returns one synthesized answer with citations. Slower and costlier than web_search \u2014 use it for questions that need cross-source synthesis (current API/version landscapes, comparisons, "state of X"), not single-fact lookups.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "The research question." },
+        provider: {
+          type: "string",
+          description: "Optional provider: you | exa | perplexity | tavily | parallel."
+        },
+        effort: {
+          type: "string",
+          description: "Optional depth/cost dial (provider-specific): you lite|standard|deep|exhaustive \xB7 perplexity minimal|low|medium|high \xB7 exa deep-lite|deep|deep-reasoning \xB7 tavily mini|pro|auto \xB7 parallel lite|base|core|pro|ultra."
+        },
+        maxResults: { type: "number", description: "Optional max number of supporting sources." },
+        searchRecency: { type: "string", description: "Optional recency window: day | week | month | year." },
+        includeDomains: { ...DOMAIN_FILTER_SCHEMA, description: "Optional: restrict sources to these domains." },
+        excludeDomains: { ...DOMAIN_FILTER_SCHEMA, description: "Optional: drop sources from these domains." },
+        outputSchema: {
+          type: "object",
+          description: "Optional JSON schema requesting structured output from the provider."
+        }
+      },
+      required: ["query"]
+    }
+  }
+];
+var InvalidParams = class extends Error {
+};
+function optionalMaxResults(value) {
+  if (value == null) return void 0;
+  const n = Number(value);
+  return Number.isFinite(n) && n >= 0 ? n : void 0;
+}
+function requireEnum(value, allowed, label) {
+  if (value == null) return void 0;
+  if (typeof value !== "string" || !allowed.has(value)) {
+    throw new InvalidParams(`invalid ${label}: ${String(value)}`);
+  }
+  return value;
+}
+function optionalDomains(value) {
+  if (!Array.isArray(value)) return void 0;
+  const domains = value.filter((d) => typeof d === "string");
+  return domains.length ? domains : void 0;
+}
+async function runMcpServer(client, opts = {}) {
+  const input = opts.input ?? process.stdin;
+  const output = opts.output ?? process.stdout;
+  const rl = readline.createInterface({ input });
+  const send = (msg) => {
+    output.write(`${JSON.stringify(msg)}
+`);
+  };
+  const ok = (id, result) => send({ jsonrpc: "2.0", id, result });
+  const fail = (id, code, message) => send({ jsonrpc: "2.0", id, error: { code, message } });
+  const toolError = (id, message) => ok(id, { content: [{ type: "text", text: message }], isError: true });
+  process.stderr.write("tcloud mcp: web_search + deep_research server ready (stdio)\n");
+  async function handleRequest(req) {
+    const { id, method, params } = req;
+    try {
+      if (method === "initialize") {
+        const requested = params?.protocolVersion ?? DEFAULT_PROTOCOL_VERSION;
+        const protocolVersion = SUPPORTED_PROTOCOL_VERSIONS.has(requested) ? requested : DEFAULT_PROTOCOL_VERSION;
+        ok(id, {
+          protocolVersion,
+          capabilities: { tools: {} },
+          serverInfo: { name: "tangle-tcloud", version: packageVersion() }
+        });
+      } else if (method === "tools/list") {
+        ok(id, { tools: TOOLS });
+      } else if (method === "tools/call") {
+        const name = params?.name;
+        if (name === "web_search") {
+          await handleWebSearch(id, params?.arguments ?? {});
+        } else if (name === "deep_research") {
+          await handleDeepResearch(id, params?.arguments ?? {});
+        } else {
+          fail(id, -32602, `unknown tool: ${String(name)}`);
+        }
+      } else {
+        fail(id, -32601, `method not found: ${String(method)}`);
+      }
+    } catch (e) {
+      if (e instanceof InvalidParams) {
+        fail(id, -32602, e.message);
+      } else {
+        fail(id, -32603, e instanceof Error ? e.message : String(e));
+      }
+    }
+  }
+  async function handleWebSearch(id, args) {
+    const query = String(args.query ?? "").trim();
+    if (!query) {
+      fail(id, -32602, 'web_search requires a non-empty "query"');
+      return;
+    }
+    const provider = requireEnum(args.provider, SEARCH_PROVIDERS, "provider");
+    const searchRecency = requireEnum(args.recency, RECENCY_WINDOWS, "recency");
+    const maxResults = optionalMaxResults(args.maxResults);
+    const includeDomains = optionalDomains(args.includeDomains);
+    const excludeDomains = optionalDomains(args.excludeDomains);
+    try {
+      const resp = await client.search({
+        query,
+        ...provider ? { provider } : {},
+        ...maxResults != null ? { maxResults } : {},
+        ...searchRecency ? { searchRecency } : {},
+        ...includeDomains ? { includeDomains } : {},
+        ...excludeDomains ? { excludeDomains } : {}
+      });
+      const hits = resp.data ?? [];
+      const text = hits.length ? hits.map((h, i) => `${i + 1}. ${h.title}
+   ${h.url}${h.snippet ? `
+   ${h.snippet}` : ""}`).join("\n\n") : `No results for "${resp.query ?? query}".`;
+      ok(id, { content: [{ type: "text", text }] });
+    } catch (e) {
+      toolError(id, e instanceof Error ? e.message : String(e));
+    }
+  }
+  async function handleDeepResearch(id, args) {
+    const query = String(args.query ?? "").trim();
+    if (!query) {
+      fail(id, -32602, 'deep_research requires a non-empty "query"');
+      return;
+    }
+    const provider = requireEnum(args.provider, RESEARCH_PROVIDERS, "provider");
+    const searchRecency = requireEnum(args.searchRecency, RECENCY_WINDOWS, "searchRecency");
+    const maxResults = optionalMaxResults(args.maxResults);
+    const includeDomains = optionalDomains(args.includeDomains);
+    const excludeDomains = optionalDomains(args.excludeDomains);
+    try {
+      const resp = await client.research({
+        query,
+        ...provider ? { provider } : {},
+        ...typeof args.effort === "string" ? { effort: args.effort } : {},
+        ...maxResults != null ? { maxResults } : {},
+        ...searchRecency ? { searchRecency } : {},
+        ...includeDomains ? { includeDomains } : {},
+        ...excludeDomains ? { excludeDomains } : {},
+        ...args.outputSchema !== void 0 ? { outputSchema: args.outputSchema } : {}
+      });
+      const sources = resp.results ?? [];
+      const sourceList = sources.length ? `
+
+Sources:
+${sources.map((h, i) => `${i + 1}. ${h.title}
+   ${h.url}`).join("\n")}` : "";
+      const text = `${resp.answer ?? ""}${sourceList}`.trim() || `No research result for "${resp.query ?? query}".`;
+      ok(id, { content: [{ type: "text", text }] });
+    } catch (e) {
+      toolError(id, e instanceof Error ? e.message : String(e));
+    }
+  }
+  for await (const line of rl) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    let req;
+    try {
+      req = JSON.parse(trimmed);
+    } catch {
+      send({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } });
+      continue;
+    }
+    if (req.id === void 0 || req.id === null) continue;
+    void handleRequest(req);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runMcpServer
+});

package/dist/mcp.d.cts

@@ -0,0 +1,27 @@
+import { Readable, Writable } from 'node:stream';
+import { TCloud } from './index.cjs';
+import './shielded.cjs';
+import 'viem';
+import './client-CAedbgfN.cjs';
+import '@tangle-network/sandbox';
+import './sandbox.cjs';
+import '@tangle-network/tcloud-attestation';
+
+/** Transport streams the server reads/writes. Defaults bind to the process
+ *  stdio; tests inject in-memory streams. */
+interface McpServerOptions {
+    input?: Readable;
+    output?: Writable;
+}
+/**
+ * Run the MCP stdio server against an authenticated TCloud client. Resolves when input closes.
+ * Handles `initialize`, `tools/list`, `tools/call` (+ ignores notifications, which carry no id).
+ *
+ * Requests are dispatched without blocking the read loop, so a slow `deep_research`
+ * call cannot stall concurrent `web_search` requests — each response carries its
+ * own id. Pass `{ input, output }` to drive the transport over arbitrary streams
+ * (tests inject in-memory streams); both default to the process stdio.
+ */
+declare function runMcpServer(client: TCloud, opts?: McpServerOptions): Promise<void>;
+
+export { type McpServerOptions, runMcpServer };

package/dist/mcp.d.ts

@@ -0,0 +1,27 @@
+import { Readable, Writable } from 'node:stream';
+import { TCloud } from './index.js';
+import './shielded.js';
+import 'viem';
+import './client-CAedbgfN.js';
+import '@tangle-network/sandbox';
+import './sandbox.js';
+import '@tangle-network/tcloud-attestation';
+
+/** Transport streams the server reads/writes. Defaults bind to the process
+ *  stdio; tests inject in-memory streams. */
+interface McpServerOptions {
+    input?: Readable;
+    output?: Writable;
+}
+/**
+ * Run the MCP stdio server against an authenticated TCloud client. Resolves when input closes.
+ * Handles `initialize`, `tools/list`, `tools/call` (+ ignores notifications, which carry no id).
+ *
+ * Requests are dispatched without blocking the read loop, so a slow `deep_research`
+ * call cannot stall concurrent `web_search` requests — each response carries its
+ * own id. Pass `{ input, output }` to drive the transport over arbitrary streams
+ * (tests inject in-memory streams); both default to the process stdio.
+ */
+declare function runMcpServer(client: TCloud, opts?: McpServerOptions): Promise<void>;
+
+export { type McpServerOptions, runMcpServer };

package/dist/mcp.js

@@ -0,0 +1,207 @@
+import {
+  packageVersion
+} from "./chunk-YK2SGW76.js";
+
+// src/mcp.ts
+import * as readline from "readline";
+var SEARCH_PROVIDERS = /* @__PURE__ */ new Set(["perplexity", "exa", "you", "parallel", "tavily", "brave"]);
+var RESEARCH_PROVIDERS = /* @__PURE__ */ new Set(["perplexity", "exa", "you", "parallel", "tavily"]);
+var RECENCY_WINDOWS = /* @__PURE__ */ new Set(["day", "week", "month", "year"]);
+var SUPPORTED_PROTOCOL_VERSIONS = /* @__PURE__ */ new Set(["2025-06-18", "2025-03-26"]);
+var DEFAULT_PROTOCOL_VERSION = "2025-06-18";
+var DOMAIN_FILTER_SCHEMA = {
+  type: "array",
+  items: { type: "string" }
+};
+var TOOLS = [
+  {
+    name: "web_search",
+    description: "Search the web via the Tangle router and return live results (title, url, snippet). Use it to find primary sources and to VERIFY that a citation (paper, PMID/DOI, patent, fact) actually exists before relying on it.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "The search query." },
+        provider: {
+          type: "string",
+          description: "Optional provider: exa | parallel | perplexity | tavily | brave | you."
+        },
+        maxResults: { type: "number", description: "Optional max number of results." },
+        recency: { type: "string", description: "Optional recency window: day | week | month | year." },
+        includeDomains: { ...DOMAIN_FILTER_SCHEMA, description: "Optional: restrict results to these domains." },
+        excludeDomains: { ...DOMAIN_FILTER_SCHEMA, description: "Optional: drop results from these domains." }
+      },
+      required: ["query"]
+    }
+  },
+  {
+    name: "deep_research",
+    description: 'Run a multi-step DEEP RESEARCH task via the Tangle router: the provider reads many sources and returns one synthesized answer with citations. Slower and costlier than web_search \u2014 use it for questions that need cross-source synthesis (current API/version landscapes, comparisons, "state of X"), not single-fact lookups.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "The research question." },
+        provider: {
+          type: "string",
+          description: "Optional provider: you | exa | perplexity | tavily | parallel."
+        },
+        effort: {
+          type: "string",
+          description: "Optional depth/cost dial (provider-specific): you lite|standard|deep|exhaustive \xB7 perplexity minimal|low|medium|high \xB7 exa deep-lite|deep|deep-reasoning \xB7 tavily mini|pro|auto \xB7 parallel lite|base|core|pro|ultra."
+        },
+        maxResults: { type: "number", description: "Optional max number of supporting sources." },
+        searchRecency: { type: "string", description: "Optional recency window: day | week | month | year." },
+        includeDomains: { ...DOMAIN_FILTER_SCHEMA, description: "Optional: restrict sources to these domains." },
+        excludeDomains: { ...DOMAIN_FILTER_SCHEMA, description: "Optional: drop sources from these domains." },
+        outputSchema: {
+          type: "object",
+          description: "Optional JSON schema requesting structured output from the provider."
+        }
+      },
+      required: ["query"]
+    }
+  }
+];
+var InvalidParams = class extends Error {
+};
+function optionalMaxResults(value) {
+  if (value == null) return void 0;
+  const n = Number(value);
+  return Number.isFinite(n) && n >= 0 ? n : void 0;
+}
+function requireEnum(value, allowed, label) {
+  if (value == null) return void 0;
+  if (typeof value !== "string" || !allowed.has(value)) {
+    throw new InvalidParams(`invalid ${label}: ${String(value)}`);
+  }
+  return value;
+}
+function optionalDomains(value) {
+  if (!Array.isArray(value)) return void 0;
+  const domains = value.filter((d) => typeof d === "string");
+  return domains.length ? domains : void 0;
+}
+async function runMcpServer(client, opts = {}) {
+  const input = opts.input ?? process.stdin;
+  const output = opts.output ?? process.stdout;
+  const rl = readline.createInterface({ input });
+  const send = (msg) => {
+    output.write(`${JSON.stringify(msg)}
+`);
+  };
+  const ok = (id, result) => send({ jsonrpc: "2.0", id, result });
+  const fail = (id, code, message) => send({ jsonrpc: "2.0", id, error: { code, message } });
+  const toolError = (id, message) => ok(id, { content: [{ type: "text", text: message }], isError: true });
+  process.stderr.write("tcloud mcp: web_search + deep_research server ready (stdio)\n");
+  async function handleRequest(req) {
+    const { id, method, params } = req;
+    try {
+      if (method === "initialize") {
+        const requested = params?.protocolVersion ?? DEFAULT_PROTOCOL_VERSION;
+        const protocolVersion = SUPPORTED_PROTOCOL_VERSIONS.has(requested) ? requested : DEFAULT_PROTOCOL_VERSION;
+        ok(id, {
+          protocolVersion,
+          capabilities: { tools: {} },
+          serverInfo: { name: "tangle-tcloud", version: packageVersion() }
+        });
+      } else if (method === "tools/list") {
+        ok(id, { tools: TOOLS });
+      } else if (method === "tools/call") {
+        const name = params?.name;
+        if (name === "web_search") {
+          await handleWebSearch(id, params?.arguments ?? {});
+        } else if (name === "deep_research") {
+          await handleDeepResearch(id, params?.arguments ?? {});
+        } else {
+          fail(id, -32602, `unknown tool: ${String(name)}`);
+        }
+      } else {
+        fail(id, -32601, `method not found: ${String(method)}`);
+      }
+    } catch (e) {
+      if (e instanceof InvalidParams) {
+        fail(id, -32602, e.message);
+      } else {
+        fail(id, -32603, e instanceof Error ? e.message : String(e));
+      }
+    }
+  }
+  async function handleWebSearch(id, args) {
+    const query = String(args.query ?? "").trim();
+    if (!query) {
+      fail(id, -32602, 'web_search requires a non-empty "query"');
+      return;
+    }
+    const provider = requireEnum(args.provider, SEARCH_PROVIDERS, "provider");
+    const searchRecency = requireEnum(args.recency, RECENCY_WINDOWS, "recency");
+    const maxResults = optionalMaxResults(args.maxResults);
+    const includeDomains = optionalDomains(args.includeDomains);
+    const excludeDomains = optionalDomains(args.excludeDomains);
+    try {
+      const resp = await client.search({
+        query,
+        ...provider ? { provider } : {},
+        ...maxResults != null ? { maxResults } : {},
+        ...searchRecency ? { searchRecency } : {},
+        ...includeDomains ? { includeDomains } : {},
+        ...excludeDomains ? { excludeDomains } : {}
+      });
+      const hits = resp.data ?? [];
+      const text = hits.length ? hits.map((h, i) => `${i + 1}. ${h.title}
+   ${h.url}${h.snippet ? `
+   ${h.snippet}` : ""}`).join("\n\n") : `No results for "${resp.query ?? query}".`;
+      ok(id, { content: [{ type: "text", text }] });
+    } catch (e) {
+      toolError(id, e instanceof Error ? e.message : String(e));
+    }
+  }
+  async function handleDeepResearch(id, args) {
+    const query = String(args.query ?? "").trim();
+    if (!query) {
+      fail(id, -32602, 'deep_research requires a non-empty "query"');
+      return;
+    }
+    const provider = requireEnum(args.provider, RESEARCH_PROVIDERS, "provider");
+    const searchRecency = requireEnum(args.searchRecency, RECENCY_WINDOWS, "searchRecency");
+    const maxResults = optionalMaxResults(args.maxResults);
+    const includeDomains = optionalDomains(args.includeDomains);
+    const excludeDomains = optionalDomains(args.excludeDomains);
+    try {
+      const resp = await client.research({
+        query,
+        ...provider ? { provider } : {},
+        ...typeof args.effort === "string" ? { effort: args.effort } : {},
+        ...maxResults != null ? { maxResults } : {},
+        ...searchRecency ? { searchRecency } : {},
+        ...includeDomains ? { includeDomains } : {},
+        ...excludeDomains ? { excludeDomains } : {},
+        ...args.outputSchema !== void 0 ? { outputSchema: args.outputSchema } : {}
+      });
+      const sources = resp.results ?? [];
+      const sourceList = sources.length ? `
+
+Sources:
+${sources.map((h, i) => `${i + 1}. ${h.title}
+   ${h.url}`).join("\n")}` : "";
+      const text = `${resp.answer ?? ""}${sourceList}`.trim() || `No research result for "${resp.query ?? query}".`;
+      ok(id, { content: [{ type: "text", text }] });
+    } catch (e) {
+      toolError(id, e instanceof Error ? e.message : String(e));
+    }
+  }
+  for await (const line of rl) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    let req;
+    try {
+      req = JSON.parse(trimmed);
+    } catch {
+      send({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } });
+      continue;
+    }
+    if (req.id === void 0 || req.id === null) continue;
+    void handleRequest(req);
+  }
+}
+export {
+  runMcpServer
+};

package/dist/shielded.cjs

@@ -259,48 +259,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,
@@ -465,7 +460,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}`;
@@ -1039,6 +1034,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/shielded.d.cts

@@ -1,5 +1,5 @@
 import { Hex } from 'viem';
-import { a as TCloudConfig, T as TCloudClient, $ as SpendAuth } from './client-CaD5Oal0.cjs';
+import { T as TCloudConfig, a as TCloudClient, a3 as SpendAuth } from './client-CAedbgfN.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, $ as SpendAuth } from './client-CaD5Oal0.js';
+import { T as TCloudConfig, a as TCloudClient, a3 as SpendAuth } from './client-CAedbgfN.js';
 import '@tangle-network/sandbox';
 
 /**

package/dist/shielded.js

@@ -3,8 +3,9 @@ import {
   estimateCost,
   generateWallet,
   signSpendAuth
-} from "./chunk-THOMQXU5.js";
-import "./chunk-U4VOGRVW.js";
+} from "./chunk-GDGQQRE3.js";
+import "./chunk-H3K3A3EI.js";
+import "./chunk-YK2SGW76.js";
 export {
   createShieldedClient,
   estimateCost,