@castari/sdk 0.0.2 → 0.0.3

package/dist/client.d.ts

@@ -44,6 +44,8 @@ export interface ClientOptions extends Partial<QueryConfig> {
     ephemeral?: boolean;
     /** Optional Daytona volume name to mount at /home/daytona/agent-workspace. Defaults to undefined (no volume). */
     volume?: string;
+    /** Optional labels to apply to the sandbox (and filter by for reuse) */
+    labels?: Record<string, string>;
     /** @deprecated Use `volume` instead */
     workspaceVolumeName?: string;
 }
@@ -60,5 +62,7 @@ export declare class CastariClient {
     private handleMessage;
     onMessage(handler: (message: WSOutputMessage) => void): () => void;
     send(message: WSInputMessage): void;
-    stop(): Promise<void>;
+    stop(options?: {
+        delete?: boolean;
+    }): Promise<void>;
 }

package/dist/client.js

@@ -174,9 +174,35 @@ export class CastariClient {
             public: true,
             volumes: volumeMounts,
         };
-        this.sandbox = await this.daytona.create(createParams);
-        if (this.options.debug) {
-            console.log(`✅ Sandbox created: ${this.sandbox.id}`);
+        // Check for existing sandbox if labels are provided
+        if (this.options.labels) {
+            const existing = await this.daytona.list(this.options.labels);
+            if (existing.items.length > 0) {
+                // Use the first matching sandbox
+                this.sandbox = existing.items[0];
+                if (this.options.debug) {
+                    console.log(`♻️  Found existing sandbox: ${this.sandbox.id} (${this.sandbox.state})`);
+                }
+                // Ensure it's started
+                if (this.sandbox.state !== 'started') {
+                    if (this.options.debug) {
+                        console.log('▶️ Starting existing sandbox...');
+                    }
+                    await this.sandbox.start();
+                }
+            }
+        }
+        // Create new if not found
+        if (!this.sandbox) {
+            // Add labels to create params
+            const paramsWithLabels = {
+                ...createParams,
+                labels: this.options.labels,
+            };
+            this.sandbox = await this.daytona.create(paramsWithLabels);
+            if (this.options.debug) {
+                console.log(`✅ Sandbox created: ${this.sandbox.id}`);
+            }
         }
         // Wait for sandbox to reach STARTED state before interacting with it
         const sandboxAny = this.sandbox;
@@ -313,25 +339,32 @@ export class CastariClient {
         }
         this.ws.send(JSON.stringify(message));
     }
-    async stop() {
+    async stop(options = { delete: true }) {
         if (this.ws) {
             this.ws.close();
         }
         if (this.sandbox) {
             try {
-                await this.sandbox.delete();
-                if (this.options.debug)
-                    console.log('🧹 Sandbox deleted');
+                if (options.delete) {
+                    await this.sandbox.delete();
+                    if (this.options.debug)
+                        console.log('🧹 Sandbox deleted');
+                }
+                else {
+                    await this.sandbox.stop();
+                    if (this.options.debug)
+                        console.log('🛑 Sandbox stopped (preserved)');
+                }
             }
             catch (err) {
                 const msg = err?.response?.data?.message || err?.message || String(err);
                 if (msg.includes('state change in progress')) {
                     if (this.options.debug) {
-                        console.warn('⚠️ Sandbox deletion skipped (state change in progress)');
+                        console.warn(`⚠️ Sandbox ${options.delete ? 'deletion' : 'stop'} skipped (state change in progress)`);
                     }
                 }
                 else {
-                    console.error('Failed to delete sandbox:', err);
+                    console.error(`Failed to ${options.delete ? 'delete' : 'stop'} sandbox:`, err);
                 }
             }
         }

package/package.json

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