@tangle-network/tcloud 0.4.0 → 0.4.1

package/README.md

@@ -62,6 +62,40 @@ const answer = await client.ask('What is Tangle Network?') // string
 console.log(answer)
 ```
 
+### Quick Start — direct cli-bridge (subscription-backed coding harness)
+
+When you have your own [cli-bridge](https://github.com/drewstone/cli-bridge) running (locally or on your own VPS), point the SDK straight at it. cli-bridge is OpenAI-compatible (`/v1/chat/completions`) so chat / ask / askStream work unchanged — and your CLI subscriptions on the bridge box pay for the LLM tokens directly (no router, no per-token billing).
+
+```bash
+# 1. clone + run cli-bridge (one terminal)
+gh repo clone drewstone/cli-bridge && cd cli-bridge
+echo "BRIDGE_BEARER=$(openssl rand -hex 32)" >> .env.local
+echo "BRIDGE_BACKENDS=claude,passthrough"     >> .env.local
+export $(grep -v '^#' .env.local | xargs) && pnpm exec tsx src/server.ts
+
+# 2. authenticate your harness CLI
+claude /login    # or: kimi login, codex login, opencode auth login
+```
+
+```ts
+import { TCloudClient } from '@tangle-network/tcloud'
+
+const client = TCloudClient.fromCliBridge({
+  url: 'http://127.0.0.1:3344',           // or any reachable URL
+  bearer: process.env.CLI_BRIDGE_BEARER!, // value of BRIDGE_BEARER from .env.local
+})
+
+// model id = `<harness>/<model>` — no `bridge/` prefix in direct mode
+const reply = await client.ask('reply with OK', 'claude-code/sonnet')
+
+// streaming + full chat work the same
+for await (const chunk of client.askStream('write a haiku', 'kimi-code/kimi-for-coding')) {
+  process.stdout.write(chunk)
+}
+```
+
+See [`examples/14-direct-cli-bridge.ts`](./examples/14-direct-cli-bridge.ts) for the full pattern. For session-resumable agentic dispatches (file edits, multi-turn coding), see [`examples/12-bridge-sessions.ts`](./examples/12-bridge-sessions.ts) which uses the router-mediated `tcloud.bridge({...})` API.
+
 ### Model Selection
 
 Model is set at client creation. Override per-request when needed:

package/dist/{chunk-QNIJ7KAA.js → chunk-577KIKFA.js}

@@ -1,10 +1,10 @@
 import {
   createShieldedClient,
   generateWallet
-} from "./chunk-MKLCBBHZ.js";
+} from "./chunk-A7AEPV2G.js";
 import {
   TCloudClient
-} from "./chunk-AKR7CS4P.js";
+} from "./chunk-B22AH4JH.js";
 
 // src/index.ts
 var TCloud = class _TCloud extends TCloudClient {

package/dist/{chunk-MKLCBBHZ.js → chunk-A7AEPV2G.js}

@@ -1,6 +1,6 @@
 import {
   TCloudClient
-} from "./chunk-AKR7CS4P.js";
+} from "./chunk-B22AH4JH.js";
 
 // src/shielded.ts
 import { privateKeyToAccount } from "viem/accounts";

package/dist/{chunk-AKR7CS4P.js → chunk-B22AH4JH.js}

@@ -278,6 +278,37 @@ var TCloudClient = class _TCloudClient {
   _cachedOperators = [];
   _operatorsCachedAt = 0;
   static OPERATORS_TTL_MS = 5 * 60 * 1e3;
+  /**
+   * Build a client pointed directly at a cli-bridge instance — skips the
+   * Tangle Router entirely. cli-bridge serves the OpenAI-compatible
+   * `/v1/chat/completions` endpoint natively, so chat() / ask() /
+   * chatStream() work as-is against any local or remote bridge.
+   *
+   * Use this when you have your own cli-bridge running (locally or on
+   * your own VPS) and don't need router-side gating, billing, or
+   * observability — your CLI subscriptions on the bridge box pay for
+   * the LLM tokens directly.
+   *
+   * Wire form: model id is `<harness>/<model>` (e.g. `claude-code/sonnet`,
+   * `kimi-code/kimi-for-coding`) — no `bridge/` prefix needed in direct
+   * mode; cli-bridge accepts the harness id as the first path segment.
+   *
+   * ```ts
+   * const client = TCloudClient.fromCliBridge({
+   *   url: 'http://127.0.0.1:3344',
+   *   bearer: process.env.CLI_BRIDGE_BEARER!,
+   * })
+   * const reply = await client.ask('explain X', 'claude-code/sonnet')
+   * ```
+   *
+   * For session-resumable agentic dispatches (file edits, multi-turn
+   * coding), use the router-mediated `tcloud.bridge({...})` API instead
+   * (or POST to cli-bridge directly with `session_id` in the body).
+   */
+  static fromCliBridge(opts) {
+    const baseURL = opts.url.replace(/\/+$/, "") + "/v1";
+    return new _TCloudClient({ ...opts.config ?? {}, apiKey: opts.bearer, baseURL });
+  }
   constructor(config = {}) {
     this.baseURL = (config.baseURL || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.platformURL = (config.platformURL || DEFAULT_PLATFORM_URL).replace(/\/$/, "");

package/dist/cli.cjs

@@ -306,6 +306,37 @@ var TCloudClient = class _TCloudClient {
   _cachedOperators = [];
   _operatorsCachedAt = 0;
   static OPERATORS_TTL_MS = 5 * 60 * 1e3;
+  /**
+   * Build a client pointed directly at a cli-bridge instance — skips the
+   * Tangle Router entirely. cli-bridge serves the OpenAI-compatible
+   * `/v1/chat/completions` endpoint natively, so chat() / ask() /
+   * chatStream() work as-is against any local or remote bridge.
+   *
+   * Use this when you have your own cli-bridge running (locally or on
+   * your own VPS) and don't need router-side gating, billing, or
+   * observability — your CLI subscriptions on the bridge box pay for
+   * the LLM tokens directly.
+   *
+   * Wire form: model id is `<harness>/<model>` (e.g. `claude-code/sonnet`,
+   * `kimi-code/kimi-for-coding`) — no `bridge/` prefix needed in direct
+   * mode; cli-bridge accepts the harness id as the first path segment.
+   *
+   * ```ts
+   * const client = TCloudClient.fromCliBridge({
+   *   url: 'http://127.0.0.1:3344',
+   *   bearer: process.env.CLI_BRIDGE_BEARER!,
+   * })
+   * const reply = await client.ask('explain X', 'claude-code/sonnet')
+   * ```
+   *
+   * For session-resumable agentic dispatches (file edits, multi-turn
+   * coding), use the router-mediated `tcloud.bridge({...})` API instead
+   * (or POST to cli-bridge directly with `session_id` in the body).
+   */
+  static fromCliBridge(opts) {
+    const baseURL = opts.url.replace(/\/+$/, "") + "/v1";
+    return new _TCloudClient({ ...opts.config ?? {}, apiKey: opts.bearer, baseURL });
+  }
   constructor(config = {}) {
     this.baseURL = (config.baseURL || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.platformURL = (config.platformURL || DEFAULT_PLATFORM_URL).replace(/\/$/, "");

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   TCloud
-} from "./chunk-QNIJ7KAA.js";
+} from "./chunk-577KIKFA.js";
 import {
   generateWallet
-} from "./chunk-MKLCBBHZ.js";
-import "./chunk-AKR7CS4P.js";
+} from "./chunk-A7AEPV2G.js";
+import "./chunk-B22AH4JH.js";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/{client-_ghO89WM.d.ts → client-C547pugt.d.cts}

@@ -640,6 +640,41 @@ declare class TCloudClient {
     private _cachedOperators;
     private _operatorsCachedAt;
     private static readonly OPERATORS_TTL_MS;
+    /**
+     * Build a client pointed directly at a cli-bridge instance — skips the
+     * Tangle Router entirely. cli-bridge serves the OpenAI-compatible
+     * `/v1/chat/completions` endpoint natively, so chat() / ask() /
+     * chatStream() work as-is against any local or remote bridge.
+     *
+     * Use this when you have your own cli-bridge running (locally or on
+     * your own VPS) and don't need router-side gating, billing, or
+     * observability — your CLI subscriptions on the bridge box pay for
+     * the LLM tokens directly.
+     *
+     * Wire form: model id is `<harness>/<model>` (e.g. `claude-code/sonnet`,
+     * `kimi-code/kimi-for-coding`) — no `bridge/` prefix needed in direct
+     * mode; cli-bridge accepts the harness id as the first path segment.
+     *
+     * ```ts
+     * const client = TCloudClient.fromCliBridge({
+     *   url: 'http://127.0.0.1:3344',
+     *   bearer: process.env.CLI_BRIDGE_BEARER!,
+     * })
+     * const reply = await client.ask('explain X', 'claude-code/sonnet')
+     * ```
+     *
+     * For session-resumable agentic dispatches (file edits, multi-turn
+     * coding), use the router-mediated `tcloud.bridge({...})` API instead
+     * (or POST to cli-bridge directly with `session_id` in the body).
+     */
+    static fromCliBridge(opts: {
+        /** cli-bridge base URL — `http://127.0.0.1:3344` for default local; can be any reachable URL. */
+        url: string;
+        /** BRIDGE_BEARER from the cli-bridge's `.env.local`. */
+        bearer: string;
+        /** Optional config passthrough (timeout, retry, etc). */
+        config?: Omit<TCloudConfig, 'apiKey' | 'baseURL'>;
+    }): TCloudClient;
     constructor(config?: TCloudConfig);
     /** Set the SpendAuth signer for private mode */
     setSpendAuthSigner(fn: () => Promise<SpendAuth>): void;

package/dist/{client-_ghO89WM.d.cts → client-C547pugt.d.ts}

@@ -640,6 +640,41 @@ declare class TCloudClient {
     private _cachedOperators;
     private _operatorsCachedAt;
     private static readonly OPERATORS_TTL_MS;
+    /**
+     * Build a client pointed directly at a cli-bridge instance — skips the
+     * Tangle Router entirely. cli-bridge serves the OpenAI-compatible
+     * `/v1/chat/completions` endpoint natively, so chat() / ask() /
+     * chatStream() work as-is against any local or remote bridge.
+     *
+     * Use this when you have your own cli-bridge running (locally or on
+     * your own VPS) and don't need router-side gating, billing, or
+     * observability — your CLI subscriptions on the bridge box pay for
+     * the LLM tokens directly.
+     *
+     * Wire form: model id is `<harness>/<model>` (e.g. `claude-code/sonnet`,
+     * `kimi-code/kimi-for-coding`) — no `bridge/` prefix needed in direct
+     * mode; cli-bridge accepts the harness id as the first path segment.
+     *
+     * ```ts
+     * const client = TCloudClient.fromCliBridge({
+     *   url: 'http://127.0.0.1:3344',
+     *   bearer: process.env.CLI_BRIDGE_BEARER!,
+     * })
+     * const reply = await client.ask('explain X', 'claude-code/sonnet')
+     * ```
+     *
+     * For session-resumable agentic dispatches (file edits, multi-turn
+     * coding), use the router-mediated `tcloud.bridge({...})` API instead
+     * (or POST to cli-bridge directly with `session_id` in the body).
+     */
+    static fromCliBridge(opts: {
+        /** cli-bridge base URL — `http://127.0.0.1:3344` for default local; can be any reachable URL. */
+        url: string;
+        /** BRIDGE_BEARER from the cli-bridge's `.env.local`. */
+        bearer: string;
+        /** Optional config passthrough (timeout, retry, etc). */
+        config?: Omit<TCloudConfig, 'apiKey' | 'baseURL'>;
+    }): TCloudClient;
     constructor(config?: TCloudConfig);
     /** Set the SpendAuth signer for private mode */
     setSpendAuthSigner(fn: () => Promise<SpendAuth>): void;

package/dist/index.cjs

@@ -322,6 +322,37 @@ var TCloudClient = class _TCloudClient {
   _cachedOperators = [];
   _operatorsCachedAt = 0;
   static OPERATORS_TTL_MS = 5 * 60 * 1e3;
+  /**
+   * Build a client pointed directly at a cli-bridge instance — skips the
+   * Tangle Router entirely. cli-bridge serves the OpenAI-compatible
+   * `/v1/chat/completions` endpoint natively, so chat() / ask() /
+   * chatStream() work as-is against any local or remote bridge.
+   *
+   * Use this when you have your own cli-bridge running (locally or on
+   * your own VPS) and don't need router-side gating, billing, or
+   * observability — your CLI subscriptions on the bridge box pay for
+   * the LLM tokens directly.
+   *
+   * Wire form: model id is `<harness>/<model>` (e.g. `claude-code/sonnet`,
+   * `kimi-code/kimi-for-coding`) — no `bridge/` prefix needed in direct
+   * mode; cli-bridge accepts the harness id as the first path segment.
+   *
+   * ```ts
+   * const client = TCloudClient.fromCliBridge({
+   *   url: 'http://127.0.0.1:3344',
+   *   bearer: process.env.CLI_BRIDGE_BEARER!,
+   * })
+   * const reply = await client.ask('explain X', 'claude-code/sonnet')
+   * ```
+   *
+   * For session-resumable agentic dispatches (file edits, multi-turn
+   * coding), use the router-mediated `tcloud.bridge({...})` API instead
+   * (or POST to cli-bridge directly with `session_id` in the body).
+   */
+  static fromCliBridge(opts) {
+    const baseURL = opts.url.replace(/\/+$/, "") + "/v1";
+    return new _TCloudClient({ ...opts.config ?? {}, apiKey: opts.bearer, baseURL });
+  }
   constructor(config = {}) {
     this.baseURL = (config.baseURL || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.platformURL = (config.platformURL || DEFAULT_PLATFORM_URL).replace(/\/$/, "");

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 } from './client-_ghO89WM.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 CompletionOptions, m as CompletionResponse, n as CreateKeyOptions, o as CreatedKey, p as CreditBalance, E as EmbeddingOptions, q as EmbeddingResponse, F as FineTuningJob, r as FineTuningJobOptions, G as GatewayOptions, I as ImageGenerateOptions, s as ImageResponse, J as JobEvent, M as Model, O as Operator, t as OperatorInfo, P as PricingTier, u as PrivacyConfig, v as PrivateRouter, w as PrivateRouterConfig, R as RerankOptions, x as RerankResponse, y as RetryConfig, z as RoutingConfig, D as RoutingStrategy, S as ShieldedConfig, H as SpendAuth, K as SpendingLimits, L as TCloudError, N as TierConfig, Q as TranscriptionResponse, U as UpdateKeyOptions, V as VideoGenerateOptions, W as VideoResponse, X as WatchJobOptions } from './client-_ghO89WM.cjs';
+import { T as TCloudClient, a as TCloudConfig } from './client-C547pugt.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 CompletionOptions, m as CompletionResponse, n as CreateKeyOptions, o as CreatedKey, p as CreditBalance, E as EmbeddingOptions, q as EmbeddingResponse, F as FineTuningJob, r as FineTuningJobOptions, G as GatewayOptions, I as ImageGenerateOptions, s as ImageResponse, J as JobEvent, M as Model, O as Operator, t as OperatorInfo, P as PricingTier, u as PrivacyConfig, v as PrivateRouter, w as PrivateRouterConfig, R as RerankOptions, x as RerankResponse, y as RetryConfig, z as RoutingConfig, D as RoutingStrategy, S as ShieldedConfig, H as SpendAuth, K as SpendingLimits, L as TCloudError, N as TierConfig, Q as TranscriptionResponse, U as UpdateKeyOptions, V as VideoGenerateOptions, W as VideoResponse, X as WatchJobOptions } from './client-C547pugt.cjs';
 export { AgentProfile, AgentProfileCapabilities, AgentProfileMcpServer, AgentProfileModelHints, AgentProfilePermissionValue, AgentProfilePrompt, AgentProfileResources } from '@tangle-network/sandbox';
 import 'viem';
 

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 } from './client-_ghO89WM.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 CompletionOptions, m as CompletionResponse, n as CreateKeyOptions, o as CreatedKey, p as CreditBalance, E as EmbeddingOptions, q as EmbeddingResponse, F as FineTuningJob, r as FineTuningJobOptions, G as GatewayOptions, I as ImageGenerateOptions, s as ImageResponse, J as JobEvent, M as Model, O as Operator, t as OperatorInfo, P as PricingTier, u as PrivacyConfig, v as PrivateRouter, w as PrivateRouterConfig, R as RerankOptions, x as RerankResponse, y as RetryConfig, z as RoutingConfig, D as RoutingStrategy, S as ShieldedConfig, H as SpendAuth, K as SpendingLimits, L as TCloudError, N as TierConfig, Q as TranscriptionResponse, U as UpdateKeyOptions, V as VideoGenerateOptions, W as VideoResponse, X as WatchJobOptions } from './client-_ghO89WM.js';
+import { T as TCloudClient, a as TCloudConfig } from './client-C547pugt.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 CompletionOptions, m as CompletionResponse, n as CreateKeyOptions, o as CreatedKey, p as CreditBalance, E as EmbeddingOptions, q as EmbeddingResponse, F as FineTuningJob, r as FineTuningJobOptions, G as GatewayOptions, I as ImageGenerateOptions, s as ImageResponse, J as JobEvent, M as Model, O as Operator, t as OperatorInfo, P as PricingTier, u as PrivacyConfig, v as PrivateRouter, w as PrivateRouterConfig, R as RerankOptions, x as RerankResponse, y as RetryConfig, z as RoutingConfig, D as RoutingStrategy, S as ShieldedConfig, H as SpendAuth, K as SpendingLimits, L as TCloudError, N as TierConfig, Q as TranscriptionResponse, U as UpdateKeyOptions, V as VideoGenerateOptions, W as VideoResponse, X as WatchJobOptions } from './client-C547pugt.js';
 export { AgentProfile, AgentProfileCapabilities, AgentProfileMcpServer, AgentProfileModelHints, AgentProfilePermissionValue, AgentProfilePrompt, AgentProfileResources } from '@tangle-network/sandbox';
 import 'viem';
 

package/dist/index.js

@@ -1,18 +1,18 @@
 import {
   TCloud
-} from "./chunk-QNIJ7KAA.js";
+} from "./chunk-577KIKFA.js";
 import {
   createShieldedClient,
   estimateCost,
   generateWallet,
   signSpendAuth
-} from "./chunk-MKLCBBHZ.js";
+} from "./chunk-A7AEPV2G.js";
 import {
   BridgeSession,
   PrivateRouter,
   TCloudClient,
   TCloudError
-} from "./chunk-AKR7CS4P.js";
+} from "./chunk-B22AH4JH.js";
 export {
   BridgeSession,
   PrivateRouter,

package/dist/instance.cjs

@@ -321,6 +321,37 @@ var TCloudClient = class _TCloudClient {
   _cachedOperators = [];
   _operatorsCachedAt = 0;
   static OPERATORS_TTL_MS = 5 * 60 * 1e3;
+  /**
+   * Build a client pointed directly at a cli-bridge instance — skips the
+   * Tangle Router entirely. cli-bridge serves the OpenAI-compatible
+   * `/v1/chat/completions` endpoint natively, so chat() / ask() /
+   * chatStream() work as-is against any local or remote bridge.
+   *
+   * Use this when you have your own cli-bridge running (locally or on
+   * your own VPS) and don't need router-side gating, billing, or
+   * observability — your CLI subscriptions on the bridge box pay for
+   * the LLM tokens directly.
+   *
+   * Wire form: model id is `<harness>/<model>` (e.g. `claude-code/sonnet`,
+   * `kimi-code/kimi-for-coding`) — no `bridge/` prefix needed in direct
+   * mode; cli-bridge accepts the harness id as the first path segment.
+   *
+   * ```ts
+   * const client = TCloudClient.fromCliBridge({
+   *   url: 'http://127.0.0.1:3344',
+   *   bearer: process.env.CLI_BRIDGE_BEARER!,
+   * })
+   * const reply = await client.ask('explain X', 'claude-code/sonnet')
+   * ```
+   *
+   * For session-resumable agentic dispatches (file edits, multi-turn
+   * coding), use the router-mediated `tcloud.bridge({...})` API instead
+   * (or POST to cli-bridge directly with `session_id` in the body).
+   */
+  static fromCliBridge(opts) {
+    const baseURL = opts.url.replace(/\/+$/, "") + "/v1";
+    return new _TCloudClient({ ...opts.config ?? {}, apiKey: opts.bearer, baseURL });
+  }
   constructor(config = {}) {
     this.baseURL = (config.baseURL || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.platformURL = (config.platformURL || DEFAULT_PLATFORM_URL).replace(/\/$/, "");

package/dist/instance.d.cts

@@ -1,4 +1,4 @@
-import { a as TCloudConfig, T as TCloudClient } from './client-_ghO89WM.cjs';
+import { a as TCloudConfig, T as TCloudClient } from './client-C547pugt.cjs';
 
 /**
  * Instance — programmatic harness for spinning up a local Tangle dev environment.

package/dist/instance.d.ts

@@ -1,4 +1,4 @@
-import { a as TCloudConfig, T as TCloudClient } from './client-_ghO89WM.js';
+import { a as TCloudConfig, T as TCloudClient } from './client-C547pugt.js';
 
 /**
  * Instance — programmatic harness for spinning up a local Tangle dev environment.

package/dist/instance.js

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

package/dist/shielded.cjs

@@ -319,6 +319,37 @@ var TCloudClient = class _TCloudClient {
   _cachedOperators = [];
   _operatorsCachedAt = 0;
   static OPERATORS_TTL_MS = 5 * 60 * 1e3;
+  /**
+   * Build a client pointed directly at a cli-bridge instance — skips the
+   * Tangle Router entirely. cli-bridge serves the OpenAI-compatible
+   * `/v1/chat/completions` endpoint natively, so chat() / ask() /
+   * chatStream() work as-is against any local or remote bridge.
+   *
+   * Use this when you have your own cli-bridge running (locally or on
+   * your own VPS) and don't need router-side gating, billing, or
+   * observability — your CLI subscriptions on the bridge box pay for
+   * the LLM tokens directly.
+   *
+   * Wire form: model id is `<harness>/<model>` (e.g. `claude-code/sonnet`,
+   * `kimi-code/kimi-for-coding`) — no `bridge/` prefix needed in direct
+   * mode; cli-bridge accepts the harness id as the first path segment.
+   *
+   * ```ts
+   * const client = TCloudClient.fromCliBridge({
+   *   url: 'http://127.0.0.1:3344',
+   *   bearer: process.env.CLI_BRIDGE_BEARER!,
+   * })
+   * const reply = await client.ask('explain X', 'claude-code/sonnet')
+   * ```
+   *
+   * For session-resumable agentic dispatches (file edits, multi-turn
+   * coding), use the router-mediated `tcloud.bridge({...})` API instead
+   * (or POST to cli-bridge directly with `session_id` in the body).
+   */
+  static fromCliBridge(opts) {
+    const baseURL = opts.url.replace(/\/+$/, "") + "/v1";
+    return new _TCloudClient({ ...opts.config ?? {}, apiKey: opts.bearer, baseURL });
+  }
   constructor(config = {}) {
     this.baseURL = (config.baseURL || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.platformURL = (config.platformURL || DEFAULT_PLATFORM_URL).replace(/\/$/, "");

package/dist/shielded.d.cts

@@ -1,5 +1,5 @@
 import { Hex } from 'viem';
-import { a as TCloudConfig, T as TCloudClient, H as SpendAuth } from './client-_ghO89WM.cjs';
+import { a as TCloudConfig, T as TCloudClient, H as SpendAuth } from './client-C547pugt.cjs';
 
 /**
  * tcloud/shielded — Ephemeral wallet generation, SpendAuth signing, private inference.

package/dist/shielded.d.ts

@@ -1,5 +1,5 @@
 import { Hex } from 'viem';
-import { a as TCloudConfig, T as TCloudClient, H as SpendAuth } from './client-_ghO89WM.js';
+import { a as TCloudConfig, T as TCloudClient, H as SpendAuth } from './client-C547pugt.js';
 
 /**
  * tcloud/shielded — Ephemeral wallet generation, SpendAuth signing, private inference.

package/dist/shielded.js

@@ -3,8 +3,8 @@ import {
   estimateCost,
   generateWallet,
   signSpendAuth
-} from "./chunk-MKLCBBHZ.js";
-import "./chunk-AKR7CS4P.js";
+} from "./chunk-A7AEPV2G.js";
+import "./chunk-B22AH4JH.js";
 export {
   createShieldedClient,
   estimateCost,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/tcloud",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "TypeScript SDK and CLI for Tangle AI Cloud — decentralized LLM inference",
   "type": "module",
   "main": "./dist/index.cjs",