@castari/cli 0.1.10 → 0.1.11

package/README.md

@@ -22,7 +22,7 @@ castari dev
 # Deploy to Castari Platform
 castari deploy
 
-# Start a cloud sandbox
+# Start a cloud sandbox and connect
 castari start
 ```
 
@@ -37,12 +37,17 @@ castari init          # Basic agent scaffold
 castari init --demo   # Full demo with agent + Next.js chat UI
 ```
 
-Creates:
+**Creates:**
 - `package.json` - Configured with dependencies
 - `tsconfig.json` - TypeScript configuration
 - `src/agent.ts` - Starter agent code
 - `.env.example` - Environment variable template
 
+The `--demo` option creates a complete working example with:
+- A sample agent with custom tools
+- A Next.js chat interface
+- Real-time streaming responses
+
 ### `castari dev`
 
 Runs the agent locally for development.
@@ -51,11 +56,11 @@ Runs the agent locally for development.
 castari dev
 ```
 
-Starts a local server at `http://localhost:3000` with hot reloading.
+Starts a local server at `http://localhost:3000`. Connect to it using the SDK's `CastariClient` with `connectionUrl: 'http://localhost:3000'`.
 
 ### `castari deploy`
 
-Uploads your agent to the Castari Platform.
+Uploads your agent to the Castari Platform and creates a snapshot.
 
 ```bash
 castari deploy
@@ -65,14 +70,17 @@ castari deploy --name my-custom-name
 **Options:**
 - `--name <name>` - Override the snapshot name (defaults to package.json name)
 
-**Requires:** `CASTARI_CLIENT_ID` environment variable
+**Requires:** `CASTARI_CLIENT_ID` and `CASTARI_API_KEY` environment variables
+
+After deploying, your snapshot is available to start via `castari start` or the SDK.
 
 ### `castari start`
 
-Starts a cloud sandbox and connects to your agent.
+Starts a cloud sandbox running your agent and connects interactively.
 
 ```bash
 castari start
+castari start --snapshot my-agent
 castari start --snapshot my-agent --volume my-data
 ```
 
@@ -80,7 +88,7 @@ castari start --snapshot my-agent --volume my-data
 - `--snapshot <name>` - Snapshot to use (defaults to package.json name)
 - `--volume <name>` - Volume to mount for persistent storage
 
-**Requires:** `CASTARI_CLIENT_ID` and `ANTHROPIC_API_KEY` environment variables
+**Requires:** `CASTARI_CLIENT_ID`, `CASTARI_API_KEY`, and `ANTHROPIC_API_KEY` environment variables
 
 Press `Ctrl+C` to gracefully shut down.
 
@@ -93,6 +101,7 @@ castari generate-secrets
 ```
 
 Outputs both values so you can copy them to your `.env` file:
+
 ```
 CASTARI_CLIENT_ID=your-client-id
 CASTARI_API_KEY=castari_your-api-key
@@ -112,6 +121,8 @@ CASTARI_API_KEY=castari_your-api-key
 
 ### package.json
 
+Configure Castari settings in your package.json:
+
 ```json
 {
   "name": "my-agent",
@@ -121,6 +132,15 @@ CASTARI_API_KEY=castari_your-api-key
 }
 ```
 
+## Workflow
+
+1. **Initialize** - `castari init` to scaffold a new project
+2. **Develop** - `castari dev` to run locally and test
+3. **Deploy** - `castari deploy` to upload to the platform
+4. **Run** - `castari start` to launch in a cloud sandbox
+
+For production applications, use the `@castari/sdk` client to connect programmatically.
+
 ## Prerequisites
 
 - [Bun](https://bun.sh) v1.0+

package/dist/commands/init.js

@@ -25,7 +25,7 @@ export async function init(options = {}) {
             start: 'castari start',
         },
         dependencies: {
-            '@castari/sdk': '^0.1.4',
+            '@castari/sdk': '^0.1.5',
             '@anthropic-ai/claude-agent-sdk': '^0.1.50',
         },
         castari: {
@@ -92,7 +92,7 @@ async function initDemo() {
             start: 'bun run src/agent.ts',
         },
         dependencies: {
-            '@castari/sdk': '^0.1.4',
+            '@castari/sdk': '^0.1.5',
             '@anthropic-ai/claude-agent-sdk': '^0.1.50',
         },
         castari: {
@@ -136,7 +136,7 @@ serve({
             start: 'next start',
         },
         dependencies: {
-            '@castari/sdk': '^0.1.4',
+            '@castari/sdk': '^0.1.5',
             next: '14.2.3',
             react: '18.3.1',
             'react-dom': '18.3.1',
@@ -640,6 +640,7 @@ const LABELS = { app: 'castari-demo', env: 'local' }
 const VOLUME = 'castari-demo-workspace'
 
 let clientPromise: Promise<CastariClient> | null = null
+let currentClient: CastariClient | null = null
 
 async function createClient() {
     const anthropicApiKey = process.env.ANTHROPIC_API_KEY
@@ -657,11 +658,26 @@ async function createClient() {
         debug: process.env.CASTARI_DEBUG === 'true',
     })
 
+    // Clear singleton when connection closes so we reconnect on next message
+    client.onClose((code, reason) => {
+        console.log(\`[Castari] Connection closed (code=\${code}), will reconnect on next message\`)
+        clientPromise = null
+        currentClient = null
+    })
+
     await client.start()
+    currentClient = client
     return client
 }
 
 async function getClient() {
+    // If we have a client but it's disconnected, clear and recreate
+    if (currentClient && !currentClient.isConnected()) {
+        console.log('[Castari] Client disconnected, reconnecting...')
+        clientPromise = null
+        currentClient = null
+    }
+
     if (!clientPromise) {
         clientPromise = createClient()
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@castari/cli",
-    "version": "0.1.10",
+    "version": "0.1.11",
     "type": "module",
     "bin": {
         "castari": "./dist/index.js"
@@ -18,7 +18,7 @@
     },
     "dependencies": {
         "@anthropic-ai/claude-agent-sdk": "^0.1.44",
-        "@castari/sdk": "^0.1.4",
+        "@castari/sdk": "^0.1.5",
         "adm-zip": "^0.5.16",
         "cac": "^6.7.14",
         "chalk": "^5.3.0",