@castari/sdk 0.0.1 → 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/dist/server.d.ts

@@ -1,5 +1,6 @@
-import { type Options } from '@anthropic-ai/claude-agent-sdk';
+import { tool, type Options } from '@anthropic-ai/claude-agent-sdk';
 export type CastariServerOptions = Partial<Options> & {
     port?: number;
+    tools?: ReturnType<typeof tool>[];
 };
 export declare function serve(options?: CastariServerOptions): Promise<void>;

package/dist/server.js

@@ -2,7 +2,7 @@ import { randomBytes } from 'crypto';
 import { mkdir } from 'fs/promises';
 import { homedir } from 'os';
 import { join } from 'path';
-import { query, } from '@anthropic-ai/claude-agent-sdk';
+import { query, createSdkMcpServer, } from '@anthropic-ai/claude-agent-sdk';
 import { CONNECTION_TOKEN_TTL_MS, SERVER_PORT, WORKSPACE_DIR_NAME, } from './const';
 import { handleMessage } from './message-handler';
 const workspaceDirectory = process.env.CASTARI_WORKSPACE || join(homedir(), WORKSPACE_DIR_NAME);
@@ -68,6 +68,19 @@ async function* generateMessages() {
 // Process messages from the SDK and send to WebSocket client
 async function processMessages(initialOptions) {
     try {
+        // Handle custom tools by creating an SDK MCP server
+        let mcpServers = initialOptions.mcpServers || {};
+        if (initialOptions.tools && initialOptions.tools.length > 0) {
+            const sdkServer = createSdkMcpServer({
+                name: 'castari-agent',
+                version: '1.0.0',
+                tools: initialOptions.tools,
+            });
+            mcpServers = {
+                ...mcpServers,
+                'castari-agent': sdkServer,
+            };
+        }
         const options = {
             settingSources: ['local'],
             cwd: workspaceDirectory,
@@ -87,6 +100,7 @@ async function processMessages(initialOptions) {
                 }
             },
             ...initialOptions, // Merge initial options (tools, systemPrompt, etc.)
+            mcpServers, // Override mcpServers with our injected one
             ...queryConfig, // Merge dynamic config from /config endpoint (overrides initial)
             ...(queryConfig.anthropicApiKey || process.env.ANTHROPIC_API_KEY
                 ? {

package/package.json

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