@tangle-network/tcloud 0.4.12 → 0.4.14

package/dist/mcp.js

@@ -0,0 +1,207 @@
+import {
+  packageVersion
+} from "./chunk-GHMW4RWJ.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

@@ -1039,6 +1039,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-CaPP4njg.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-CaPP4njg.js';
 import '@tangle-network/sandbox';
 
 /**

package/dist/shielded.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tangle-network/tcloud",
-  "version": "0.4.12",
-  "description": "TypeScript SDK and CLI for Tangle AI Cloud — decentralized LLM inference",
+  "version": "0.4.14",
+  "description": "TypeScript SDK and CLI for Tangle Router, Sandbox, model routing, and agent service calls",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -71,7 +71,7 @@
   "dependencies": {
     "@scure/bip32": "^2.2.0",
     "@scure/bip39": "^2.2.0",
-    "@tangle-network/sandbox": "^0.3.0",
+    "@tangle-network/sandbox": "^0.9.5",
     "commander": "^14.0.3",
     "viem": "^2.48.4",
     "@tangle-network/tcloud-attestation": "^0.1.1"
@@ -95,24 +95,29 @@
     "url": "git+https://github.com/tangle-network/tcloud.git",
     "directory": "packages/tcloud"
   },
-  "homepage": "https://docs.tangleai.cloud",
+  "homepage": "https://router.tangle.tools/docs",
   "keywords": [
     "tangle",
     "ai",
     "llm",
     "inference",
     "decentralized",
+    "agent-runtime",
+    "sandbox",
+    "browser-agent",
+    "x402",
     "openai",
     "sdk",
     "cli",
     "privacy",
-    "shielded-credits"
+    "shielded-credits",
+    "tangle-router"
   ],
   "engines": {
     "node": ">=18"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/cli.ts src/shielded.ts src/instance.ts src/attestation.ts src/sandbox.ts --format esm,cjs --dts --clean --external socks-proxy-agent",
+    "build": "tsup src/index.ts src/cli.ts src/mcp.ts src/shielded.ts src/instance.ts src/attestation.ts src/sandbox.ts --format esm,cjs --dts --clean --external socks-proxy-agent",
     "docs": "typedoc src/index.ts --out docs --name tcloud --readme README.md",
     "test": "vitest run",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",