@tangle-network/tcloud 0.4.13 → 0.4.14

package/dist/index.cjs

@@ -1057,6 +1057,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-CaPP4njg.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-CaPP4njg.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-CaPP4njg.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-CaPP4njg.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-ZJCWJGPM.js";
 import {
   TCloudSandbox,
   createTeeAttestationChallenge,
@@ -23,13 +23,13 @@ import {
   estimateCost,
   generateWallet,
   signSpendAuth
-} from "./chunk-THOMQXU5.js";
+} from "./chunk-26M4HGWE.js";
 import {
   BridgeSession,
   PrivateRouter,
   TCloudClient,
   TCloudError
-} from "./chunk-U4VOGRVW.js";
+} from "./chunk-LUJXMUH5.js";
 export {
   BridgeSession,
   PrivateRouter,

package/dist/instance.cjs

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

package/dist/instance.js

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

package/dist/mcp.cjs

@@ -0,0 +1,254 @@
+"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);
+
+// src/version.ts
+var fs = __toESM(require("fs"), 1);
+var import_meta = {};
+function packageVersion() {
+  try {
+    const packageJson = JSON.parse(
+      fs.readFileSync(new URL("../package.json", import_meta.url), "utf-8")
+    );
+    if (typeof packageJson.version === "string") return packageJson.version;
+  } catch {
+  }
+  return "0.0.0";
+}
+
+// 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-CaPP4njg.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-CaPP4njg.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-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
+};