@castari/sdk 0.1.1 → 0.1.3

package/README.md

@@ -77,7 +77,9 @@ import { CastariClient } from '@castari/sdk/client'
 
 const client = new CastariClient({
   snapshot: 'my-agent',
-  platformUrl: process.env.CASTARI_PLATFORM_URL
+  clientId: process.env.CASTARI_CLIENT_ID,
+  platformApiKey: process.env.CASTARI_API_KEY,
+  anthropicApiKey: process.env.ANTHROPIC_API_KEY,
 })
 
 await client.start()
@@ -99,11 +101,14 @@ await client.stop()
 
 | Property | Type | Description |
 |----------|------|-------------|
-| `platformUrl` | `string` | URL of the Castari Platform |
 | `snapshot` | `string` | Name of the snapshot to use |
+| `clientId` | `string` | Your Castari client ID |
+| `platformApiKey` | `string` | Your Castari API key |
+| `anthropicApiKey` | `string` | Your Anthropic API key |
 | `volume` | `string` | (Optional) Volume name for persistent storage |
-| `connectionUrl` | `string` | (Optional) Direct URL for local development |
 | `labels` | `Record<string, string>` | (Optional) Labels for sandbox reuse |
+| `connectionUrl` | `string` | (Optional) Direct URL for local development |
+| `platformUrl` | `string` | (Optional) Override the platform URL (advanced) |
 
 #### Methods
 
@@ -139,8 +144,8 @@ await client.stop({ delete: false })
 | Variable | Description |
 |----------|-------------|
 | `ANTHROPIC_API_KEY` | Your Anthropic API key |
-| `CASTARI_PLATFORM_URL` | URL of the Castari Platform |
 | `CASTARI_CLIENT_ID` | Your Castari client ID |
+| `CASTARI_API_KEY` | Your Castari API key |
 
 ## License
 

package/dist/client.d.ts

@@ -24,6 +24,12 @@ export interface ClientOptions extends Partial<QueryConfig> {
     platformUrl?: string;
     /** Optional sessionId to resume */
     resume?: string;
+    /**
+     * Use the platform API as a WebSocket proxy instead of connecting directly to the sandbox.
+     * Useful when your network blocks the sandbox preview domains.
+     * Defaults to false.
+     */
+    useProxy?: boolean;
 }
 export declare class CastariClient {
     private ws?;

package/dist/client.js

@@ -127,7 +127,7 @@ export class CastariClient {
         if (!this.resolvedClientId) {
             throw new Error('CASTARI_CLIENT_ID is required when connecting via the Castari Platform');
         }
-        const platformUrl = this.options.platformUrl || process.env.CASTARI_PLATFORM_URL || DEFAULT_PLATFORM_URL;
+        const platformUrl = (this.options.platformUrl || process.env.CASTARI_PLATFORM_URL || DEFAULT_PLATFORM_URL).replace(/\/$/, '');
         if (this.options.debug) {
             console.log(`🚀 Requesting sandbox from ${platformUrl}...`);
         }
@@ -150,11 +150,30 @@ export class CastariClient {
             const errorText = await response.text();
             throw new Error(`Failed to start sandbox: ${errorText}`);
         }
-        const { id, url, authHeaders, authParams } = await response.json();
+        const { id, url, proxyUrl, authHeaders, authParams } = await response.json();
         this.sandboxId = id;
+        const useProxy = this.options.useProxy ?? (process.env.CASTARI_USE_PROXY === 'true');
         if (this.options.debug) {
             console.log(`✅ Sandbox started: ${id} at ${url}`);
+            if (useProxy && proxyUrl) {
+                console.log(`🔀 Using proxy mode via ${proxyUrl}`);
+            }
+        }
+        // If proxy mode is enabled and we have a proxy URL, use it
+        if (useProxy && proxyUrl) {
+            // Proxy mode: connect through platform API
+            const proxyConfigUrl = `${platformUrl}/proxy/${id}/config`;
+            const proxyWsUrl = proxyUrl;
+            return {
+                configUrl: proxyConfigUrl,
+                wsUrl: proxyWsUrl,
+                // No auth headers/params needed - proxy handles sandbox auth
+                cleanup: async () => {
+                    await this.stop({ delete: true });
+                }
+            };
         }
+        // Direct mode: connect to sandbox directly
         const baseUrl = url.replace(/\/$/, '');
         const configUrl = `${baseUrl.replace('ws://', 'http://').replace('wss://', 'https://')}/config`;
         const wsUrlBase = `${baseUrl.replace('https://', 'wss://').replace('http://', 'ws://')}/ws`;
@@ -191,7 +210,7 @@ export class CastariClient {
             this.ws.close();
         }
         if (this.sandboxId) {
-            const platformUrl = this.options.platformUrl || process.env.CASTARI_PLATFORM_URL || DEFAULT_PLATFORM_URL;
+            const platformUrl = (this.options.platformUrl || process.env.CASTARI_PLATFORM_URL || DEFAULT_PLATFORM_URL).replace(/\/$/, '');
             try {
                 const clientId = this.resolvedClientId || this.options.clientId || process.env.CASTARI_CLIENT_ID;
                 const apiKey = this.resolvedPlatformApiKey || this.options.platformApiKey || process.env.CASTARI_API_KEY;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@castari/sdk",
-    "version": "0.1.1",
+    "version": "0.1.3",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",