@tangle-network/tcloud 0.4.10 → 0.4.12

package/README.md

@@ -465,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-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

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";

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,6 +1,6 @@
 {
   "name": "@tangle-network/tcloud",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "TypeScript SDK and CLI for Tangle AI Cloud — decentralized LLM inference",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -68,21 +68,13 @@
       }
     }
   },
-  "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",
-    "docs": "typedoc src/index.ts --out docs --name tcloud --readme README.md",
-    "test": "vitest run",
-    "test:e2e": "vitest run --config vitest.e2e.config.ts",
-    "dev": "tsx src/cli.ts",
-    "prepublishOnly": "npm run build"
-  },
   "dependencies": {
     "@scure/bip32": "^2.2.0",
     "@scure/bip39": "^2.2.0",
     "@tangle-network/sandbox": "^0.3.0",
-    "@tangle-network/tcloud-attestation": "workspace:^",
     "commander": "^14.0.3",
-    "viem": "^2.48.4"
+    "viem": "^2.48.4",
+    "@tangle-network/tcloud-attestation": "^0.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -118,5 +110,12 @@
   ],
   "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",
+    "docs": "typedoc src/index.ts --out docs --name tcloud --readme README.md",
+    "test": "vitest run",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "dev": "tsx src/cli.ts"
   }
-}
+}