@tangle-network/tcloud 0.4.11 → 0.4.13

package/README.md

@@ -1,6 +1,6 @@
 # tcloud
 
-TypeScript SDK and CLI for [Tangle AI Cloud](https://router.tangle.tools) — decentralized LLM inference with operator routing, reputation-based selection, and anonymous payments via ShieldedCredits.
+TypeScript SDK and CLI for [Tangle Router](https://router.tangle.tools): model routing, sandbox-backed agent calls, operator routing, and anonymous payments via ShieldedCredits.
 
 Zero framework dependencies. Pure `fetch` + SSE. Works in Node.js, Deno, Bun, and edge runtimes.
 
@@ -37,21 +37,23 @@ Zero framework dependencies. Pure `fetch` + SSE. Works in Node.js, Deno, Bun, an
 ## Installation
 
 ```bash
-npm install tcloud
+npm install @tangle-network/tcloud
 ```
 
 Or run the CLI directly:
 
 ```bash
-npx tcloud chat "What is Tangle?"
+npx @tangle-network/tcloud chat "What is Tangle?"
 ```
 
+Do not install unscoped `tcloud`. It is unrelated to Tangle.
+
 ## SDK
 
 ### Quick Start
 
 ```ts
-import { TCloud } from 'tcloud'
+import { TCloud } from '@tangle-network/tcloud'
 
 // Set model at client creation — explicit and consistent.
 const client = new TCloud({
@@ -159,7 +161,7 @@ console.log(completion.choices[0].message.content)
 Anonymous inference with no API key. Uses EIP-712 SpendAuth signatures — the operator verifies payment without learning your identity.
 
 ```ts
-import { TCloud } from 'tcloud'
+import { TCloud } from '@tangle-network/tcloud'
 
 const client = TCloud.shielded()
 const answer = await client.ask('Hello from the shadows')
@@ -361,10 +363,10 @@ tcloud auth status             # Check current auth
 ### Chat
 
 ```bash
-tcloud chat "Explain zero-knowledge proofs"
-tcloud chat -m meta-llama/llama-4-maverick "Hello"
-tcloud chat --private "Anonymous request"  # ShieldedCredits mode
-tcloud chat                                # Interactive mode
+npx @tangle-network/tcloud chat "Explain zero-knowledge proofs"
+npx @tangle-network/tcloud chat -m meta-llama/llama-4-maverick "Hello"
+npx @tangle-network/tcloud chat --private "Anonymous request"  # ShieldedCredits mode
+npx @tangle-network/tcloud chat                                # Interactive mode
 ```
 
 ### Browse
@@ -409,8 +411,8 @@ tcloud config --model gpt-4o-mini
 Environment variables:
 - `TANGLE_API_KEY` — API key (primary). One key for router + sandbox + all Tangle products.
 - `TCLOUD_API_KEY` — Deprecated alias, still honored for backwards compatibility.
-- `OPENAI_API_KEY` — Fallback API key (works because the API is OpenAI-compatible).
-- `TCLOUD_BASE_URL` — Override API base URL.
+- `TANGLE_ROUTER_URL` — Override CLI router URL.
+- `TCLOUD_API_URL` — Deprecated CLI router URL alias.
 
 ## OpenAI SDK Compatibility
 

package/dist/{chunk-DRCOPW7D.js → chunk-GNACB23W.js}

@@ -245,10 +245,11 @@ function buildSandboxCreateOptions(options) {
       url: options.gitUrl,
       ref: options.gitRef
     } : void 0,
-    resources: options.cpu || options.memoryMb || options.diskGb ? {
+    resources: options.cpu || options.memoryMb || options.diskGb || options.accelerator ? {
       cpuCores: options.cpu,
       memoryMB: options.memoryMb,
-      diskGB: options.diskGb
+      diskGB: options.diskGb,
+      accelerator: options.accelerator
     } : void 0,
     // backend: merge `backend` (type string) with `agentProfile` (carried
     // as `backend.profile` on the underlying SDK). Either may be set

package/dist/{chunk-IWDE7ZPN.js → chunk-UBUCUSCF.js}

@@ -1,6 +1,6 @@
 import {
   TCloudSandbox
-} from "./chunk-DRCOPW7D.js";
+} from "./chunk-GNACB23W.js";
 import {
   createShieldedClient,
   generateWallet

package/dist/cli.cjs

@@ -1856,10 +1856,11 @@ function buildSandboxCreateOptions(options) {
       url: options.gitUrl,
       ref: options.gitRef
     } : void 0,
-    resources: options.cpu || options.memoryMb || options.diskGb ? {
+    resources: options.cpu || options.memoryMb || options.diskGb || options.accelerator ? {
       cpuCores: options.cpu,
       memoryMB: options.memoryMb,
-      diskGB: options.diskGb
+      diskGB: options.diskGb,
+      accelerator: options.accelerator
     } : void 0,
     // backend: merge `backend` (type string) with `agentProfile` (carried
     // as `backend.profile` on the underlying SDK). Either may be set
@@ -2024,8 +2025,8 @@ function loadConfig() {
     ...fileConfig,
     ...process.env.TANGLE_ROUTER_URL ? { apiUrl: process.env.TANGLE_ROUTER_URL.replace(/\/v1\/?$/, "") } : {},
     ...process.env.TCLOUD_API_URL ? { apiUrl: process.env.TCLOUD_API_URL.replace(/\/v1\/?$/, "") } : {},
-    ...process.env.TANGLE_API_KEY ? { apiKey: process.env.TANGLE_API_KEY } : {},
-    ...process.env.TCLOUD_API_KEY ? { apiKey: process.env.TCLOUD_API_KEY } : {}
+    ...process.env.TCLOUD_API_KEY ? { apiKey: process.env.TCLOUD_API_KEY } : {},
+    ...process.env.TANGLE_API_KEY ? { apiKey: process.env.TANGLE_API_KEY } : {}
   };
 }
 function saveConfig(c) {

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   TCloud
-} from "./chunk-IWDE7ZPN.js";
+} from "./chunk-UBUCUSCF.js";
 import {
   TCloudSandbox
-} from "./chunk-DRCOPW7D.js";
+} from "./chunk-GNACB23W.js";
 import {
   generateWallet
 } from "./chunk-THOMQXU5.js";
@@ -29,8 +29,8 @@ function loadConfig() {
     ...fileConfig,
     ...process.env.TANGLE_ROUTER_URL ? { apiUrl: process.env.TANGLE_ROUTER_URL.replace(/\/v1\/?$/, "") } : {},
     ...process.env.TCLOUD_API_URL ? { apiUrl: process.env.TCLOUD_API_URL.replace(/\/v1\/?$/, "") } : {},
-    ...process.env.TANGLE_API_KEY ? { apiKey: process.env.TANGLE_API_KEY } : {},
-    ...process.env.TCLOUD_API_KEY ? { apiKey: process.env.TCLOUD_API_KEY } : {}
+    ...process.env.TCLOUD_API_KEY ? { apiKey: process.env.TCLOUD_API_KEY } : {},
+    ...process.env.TANGLE_API_KEY ? { apiKey: process.env.TANGLE_API_KEY } : {}
   };
 }
 function saveConfig(c) {

package/dist/index.cjs

@@ -2000,10 +2000,11 @@ function buildSandboxCreateOptions(options) {
       url: options.gitUrl,
       ref: options.gitRef
     } : void 0,
-    resources: options.cpu || options.memoryMb || options.diskGb ? {
+    resources: options.cpu || options.memoryMb || options.diskGb || options.accelerator ? {
       cpuCores: options.cpu,
       memoryMB: options.memoryMb,
-      diskGB: options.diskGb
+      diskGB: options.diskGb,
+      accelerator: options.accelerator
     } : void 0,
     // backend: merge `backend` (type string) with `agentProfile` (carried
     // as `backend.profile` on the underlying SDK). Either may be set

package/dist/index.js

@@ -11,13 +11,13 @@ import {
   toHex,
   verifyAttestation,
   verifyAttestationAsync
-} from "./chunk-IWDE7ZPN.js";
+} from "./chunk-UBUCUSCF.js";
 import {
   TCloudSandbox,
   createTeeAttestationChallenge,
   generateAttestationNonce,
   startTeeAttestationHeartbeat
-} from "./chunk-DRCOPW7D.js";
+} from "./chunk-GNACB23W.js";
 import {
   createShieldedClient,
   estimateCost,

package/dist/sandbox.cjs

@@ -271,10 +271,11 @@ function buildSandboxCreateOptions(options) {
       url: options.gitUrl,
       ref: options.gitRef
     } : void 0,
-    resources: options.cpu || options.memoryMb || options.diskGb ? {
+    resources: options.cpu || options.memoryMb || options.diskGb || options.accelerator ? {
       cpuCores: options.cpu,
       memoryMB: options.memoryMb,
-      diskGB: options.diskGb
+      diskGB: options.diskGb,
+      accelerator: options.accelerator
     } : void 0,
     // backend: merge `backend` (type string) with `agentProfile` (carried
     // as `backend.profile` on the underlying SDK). Either may be set

package/dist/sandbox.d.cts

@@ -1,6 +1,20 @@
 import { AgentProfile } from '@tangle-network/sandbox';
 import { AsyncAttestationPolicy, AttestationVerificationResult } from '@tangle-network/tcloud-attestation';
 
+/**
+ * GPU / accelerator request, mirroring `@tangle-network/sandbox`'s
+ * `SandboxResources.accelerator` shape (that type is not re-exported from the
+ * SDK's public entry, so we declare the structural shape here and forward it
+ * verbatim). `kind` is the accelerator class (e.g. 'nvidia-a100'); `count`
+ * defaults to 1; `memoryMB` is a minimum device-memory floor when the exact
+ * class is flexible.
+ */
+interface SandboxAccelerator {
+    kind: string;
+    count?: number;
+    memoryMB?: number;
+}
+
 type TCloudSandboxTee = 'any' | 'tdx' | 'nitro' | 'sev-snp' | 'phala-dstack' | 'gcp' | 'azure' | (string & {});
 interface TCloudSandboxCreateOptions {
     name?: string;
@@ -10,6 +24,14 @@ interface TCloudSandboxCreateOptions {
     cpu?: number;
     memoryMb?: number;
     diskGb?: number;
+    /**
+     * GPU / accelerator request for heavy compute workloads (CFD, FEA, PDE,
+     * MD, training). Forwarded verbatim to the underlying `@tangle-network/
+     * sandbox` `CreateSandboxOptions.resources.accelerator`, which the fleet
+     * autoscaler uses to provision a GPU-class host. `{ kind, count?, memoryMB? }`
+     * — e.g. `{ kind: 'nvidia-a100', count: 1 }`. Omit for CPU-only sandboxes.
+     */
+    accelerator?: SandboxAccelerator;
     gitUrl?: string;
     gitRef?: string;
     backend?: 'opencode' | 'claude-code' | 'codex' | 'amp' | (string & {});
@@ -107,4 +129,4 @@ declare function buildSandboxCreateOptions(options: TCloudSandboxCreateOptions):
 declare function shouldVerifyAttestation(options: Pick<TCloudSandboxCreateOptions, 'tee' | 'verify'>): boolean;
 declare function generateAttestationNonce(bytes?: number): string;
 
-export { TCloudSandbox, type TCloudSandboxAttestationStatus, type TCloudSandboxConfig, type TCloudSandboxCreateOptions, type TCloudSandboxCreateResult, type TCloudSandboxTee, type TCloudTeeAttestationChallenge, type TCloudTeeAttestationHeartbeat, type TCloudTeeAttestationHeartbeatOptions, type TCloudTeeAttestationHeartbeatSample, buildSandboxCreateOptions, createTeeAttestationChallenge, generateAttestationNonce, shouldVerifyAttestation, startTeeAttestationHeartbeat };
+export { type SandboxAccelerator, TCloudSandbox, type TCloudSandboxAttestationStatus, type TCloudSandboxConfig, type TCloudSandboxCreateOptions, type TCloudSandboxCreateResult, type TCloudSandboxTee, type TCloudTeeAttestationChallenge, type TCloudTeeAttestationHeartbeat, type TCloudTeeAttestationHeartbeatOptions, type TCloudTeeAttestationHeartbeatSample, buildSandboxCreateOptions, createTeeAttestationChallenge, generateAttestationNonce, shouldVerifyAttestation, startTeeAttestationHeartbeat };

package/dist/sandbox.d.ts

@@ -1,6 +1,20 @@
 import { AgentProfile } from '@tangle-network/sandbox';
 import { AsyncAttestationPolicy, AttestationVerificationResult } from '@tangle-network/tcloud-attestation';
 
+/**
+ * GPU / accelerator request, mirroring `@tangle-network/sandbox`'s
+ * `SandboxResources.accelerator` shape (that type is not re-exported from the
+ * SDK's public entry, so we declare the structural shape here and forward it
+ * verbatim). `kind` is the accelerator class (e.g. 'nvidia-a100'); `count`
+ * defaults to 1; `memoryMB` is a minimum device-memory floor when the exact
+ * class is flexible.
+ */
+interface SandboxAccelerator {
+    kind: string;
+    count?: number;
+    memoryMB?: number;
+}
+
 type TCloudSandboxTee = 'any' | 'tdx' | 'nitro' | 'sev-snp' | 'phala-dstack' | 'gcp' | 'azure' | (string & {});
 interface TCloudSandboxCreateOptions {
     name?: string;
@@ -10,6 +24,14 @@ interface TCloudSandboxCreateOptions {
     cpu?: number;
     memoryMb?: number;
     diskGb?: number;
+    /**
+     * GPU / accelerator request for heavy compute workloads (CFD, FEA, PDE,
+     * MD, training). Forwarded verbatim to the underlying `@tangle-network/
+     * sandbox` `CreateSandboxOptions.resources.accelerator`, which the fleet
+     * autoscaler uses to provision a GPU-class host. `{ kind, count?, memoryMB? }`
+     * — e.g. `{ kind: 'nvidia-a100', count: 1 }`. Omit for CPU-only sandboxes.
+     */
+    accelerator?: SandboxAccelerator;
     gitUrl?: string;
     gitRef?: string;
     backend?: 'opencode' | 'claude-code' | 'codex' | 'amp' | (string & {});
@@ -107,4 +129,4 @@ declare function buildSandboxCreateOptions(options: TCloudSandboxCreateOptions):
 declare function shouldVerifyAttestation(options: Pick<TCloudSandboxCreateOptions, 'tee' | 'verify'>): boolean;
 declare function generateAttestationNonce(bytes?: number): string;
 
-export { TCloudSandbox, type TCloudSandboxAttestationStatus, type TCloudSandboxConfig, type TCloudSandboxCreateOptions, type TCloudSandboxCreateResult, type TCloudSandboxTee, type TCloudTeeAttestationChallenge, type TCloudTeeAttestationHeartbeat, type TCloudTeeAttestationHeartbeatOptions, type TCloudTeeAttestationHeartbeatSample, buildSandboxCreateOptions, createTeeAttestationChallenge, generateAttestationNonce, shouldVerifyAttestation, startTeeAttestationHeartbeat };
+export { type SandboxAccelerator, TCloudSandbox, type TCloudSandboxAttestationStatus, type TCloudSandboxConfig, type TCloudSandboxCreateOptions, type TCloudSandboxCreateResult, type TCloudSandboxTee, type TCloudTeeAttestationChallenge, type TCloudTeeAttestationHeartbeat, type TCloudTeeAttestationHeartbeatOptions, type TCloudTeeAttestationHeartbeatSample, buildSandboxCreateOptions, createTeeAttestationChallenge, generateAttestationNonce, shouldVerifyAttestation, startTeeAttestationHeartbeat };

package/dist/sandbox.js

@@ -5,7 +5,7 @@ import {
   generateAttestationNonce,
   shouldVerifyAttestation,
   startTeeAttestationHeartbeat
-} from "./chunk-DRCOPW7D.js";
+} from "./chunk-GNACB23W.js";
 export {
   TCloudSandbox,
   buildSandboxCreateOptions,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tangle-network/tcloud",
-  "version": "0.4.11",
-  "description": "TypeScript SDK and CLI for Tangle AI Cloud — decentralized LLM inference",
+  "version": "0.4.13",
+  "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",
@@ -95,18 +95,23 @@
     "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"