@castari/cli 0.0.5 → 0.0.7

package/dist/commands/client-id.d.ts

@@ -0,0 +1 @@
+export declare function resolveClientId(): Promise<string>;

package/dist/commands/client-id.js

@@ -0,0 +1,25 @@
+import { readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import chalk from 'chalk';
+const CONFIG_PATH = join(homedir(), '.castari', 'client.json');
+export async function resolveClientId() {
+    const envId = process.env.CASTARI_CLIENT_ID;
+    if (envId)
+        return envId.trim();
+    if (existsSync(CONFIG_PATH)) {
+        try {
+            const raw = await readFile(CONFIG_PATH, 'utf-8');
+            const data = JSON.parse(raw);
+            if (data.clientId)
+                return data.clientId.trim();
+        }
+        catch {
+            // ignore and fall through
+        }
+    }
+    console.error(chalk.red('❌ CASTARI_CLIENT_ID is required.'));
+    console.error(chalk.white('Run `castari generate-client-id` to create one (stored in ~/.castari/client.json), or set CASTARI_CLIENT_ID in your environment.'));
+    throw new Error('Missing CASTARI_CLIENT_ID');
+}

package/dist/commands/deploy.js

@@ -1,7 +1,9 @@
 import { readFile } from 'fs/promises';
 import chalk from 'chalk';
 import AdmZip from 'adm-zip';
+import { getClientAuthOrExit } from '../utils/client-auth';
 export async function deploy(options) {
+    const { clientId, apiKey } = await getClientAuthOrExit();
     // Read package.json to get default snapshot name
     let snapshotName = options.snapshot;
     if (!snapshotName) {
@@ -43,17 +45,22 @@ export async function deploy(options) {
     const formData = new FormData();
     formData.append('file', new Blob([zipBuffer]), 'source.zip');
     formData.append('snapshot', snapshotName);
+    formData.append('clientId', clientId);
     try {
+        const headers = {};
+        if (apiKey)
+            headers['Authorization'] = `Bearer ${apiKey}`;
         const response = await fetch(`${platformUrl}/deploy`, {
             method: 'POST',
             body: formData,
+            headers,
         });
         if (!response.ok) {
             const errorText = await response.text();
             throw new Error(`Platform error (${response.status}): ${errorText}`);
         }
         const result = await response.json();
-        console.log(chalk.green(`✅ Snapshot "${result.snapshot}" created successfully!`));
+        console.log(chalk.green(`✅ Snapshot "${result.snapshot}" created successfully for client ${clientId}`));
     }
     catch (err) {
         console.error(chalk.red('Deploy failed:'), err.message || err);

package/dist/commands/generate-client-id.d.ts

@@ -0,0 +1 @@
+export declare function generateClientId(): Promise<void>;

package/dist/commands/generate-client-id.js

@@ -0,0 +1,57 @@
+import { randomUUID } from 'crypto';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { saveClientAuth } from '../utils/client-auth';
+export async function generateClientId() {
+    const platformUrl = process.env.CASTARI_PLATFORM_URL || 'http://localhost:3000';
+    const mintOnline = async () => {
+        try {
+            const res = await fetch(`${platformUrl}/client-ids`, { method: 'POST' });
+            if (!res.ok) {
+                const text = await res.text();
+                throw new Error(text || `status ${res.status}`);
+            }
+            const data = (await res.json());
+            if (!data.clientId)
+                throw new Error('No clientId returned');
+            await saveClientAuth({
+                clientId: data.clientId,
+                apiKey: data.apiKey,
+                source: 'online',
+                platformUrl,
+            });
+            console.log(chalk.green(`✅ Client ID minted: ${data.clientId}`));
+            if (data.apiKey) {
+                console.log(chalk.green(`✅ API Key issued`));
+            }
+            console.log(chalk.white(`Saved to ~/.castari/client.json`));
+            return data.clientId;
+        }
+        catch (err) {
+            console.error(chalk.yellow(`⚠️  Failed to mint via platform: ${err?.message || err}`));
+            return null;
+        }
+    };
+    const onlineId = await mintOnline();
+    if (onlineId)
+        return;
+    const { confirmOffline } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'confirmOffline',
+            message: 'Generate an offline client ID instead?',
+            default: false,
+        },
+    ]);
+    if (!confirmOffline) {
+        console.error(chalk.red('Aborted. No client ID generated.'));
+        process.exit(1);
+    }
+    const offlineId = randomUUID();
+    await saveClientAuth({
+        clientId: offlineId,
+        source: 'offline',
+    });
+    console.log(chalk.green(`✅ Offline client ID generated: ${offlineId}`));
+    console.log(chalk.white(`Saved to ~/.castari/client.json`));
+}

package/dist/commands/init.js

@@ -25,7 +25,7 @@ export async function init(options = {}) {
             start: 'castari start',
         },
         dependencies: {
-            '@castari/sdk': '^0.0.4',
+            '@castari/sdk': '^0.0.6',
             '@anthropic-ai/claude-agent-sdk': '^0.1.44',
         },
         castari: {
@@ -65,7 +65,7 @@ serve({
   systemPrompt: 'You are a helpful Castari agent.',
 })
 `;
-    const envExample = `ANTHROPIC_API_KEY=sk-ant-...\n# CASTARI_PLATFORM_URL=https://api.castari.com\n`;
+    const envExample = `ANTHROPIC_API_KEY=sk-ant-...\nCASTARI_CLIENT_ID=your-client-id\n# CASTARI_PLATFORM_URL=https://api.castari.com\n`;
     await writeFile('package.json', JSON.stringify(packageJson, null, 2));
     await writeFile('tsconfig.json', JSON.stringify(tsConfig, null, 2));
     await writeFile('.env.example', envExample);
@@ -93,7 +93,7 @@ async function initDemo() {
             start: 'bun run src/agent.ts',
         },
         dependencies: {
-            '@castari/sdk': '^0.0.4',
+            '@castari/sdk': '^0.0.6',
             '@anthropic-ai/claude-agent-sdk': '^0.1.50',
         },
         castari: {
@@ -111,7 +111,7 @@ async function initDemo() {
         },
         include: ['src'],
     });
-    await writeFile(join(agentDir, '.env.example'), 'ANTHROPIC_API_KEY=sk-ant-...\n# CASTARI_PLATFORM_URL=http://localhost:3000\n');
+    await writeFile(join(agentDir, '.env.example'), 'ANTHROPIC_API_KEY=sk-ant-...\nCASTARI_CLIENT_ID=your-client-id\n# CASTARI_PLATFORM_URL=http://localhost:3000\n');
     await writeFile(join(agentDir, 'src', 'agent.ts'), `import { serve } from '@castari/sdk'
 
 serve({
@@ -125,6 +125,7 @@ serve({
 `);
     // Web scaffold
     await mkdir(join(webDir, 'app', 'api', 'chat'), { recursive: true });
+    await mkdir(join(webDir, 'lib'), { recursive: true });
     await writeJson(join(webDir, 'package.json'), {
         name: 'castari-demo-web',
         version: '0.1.0',
@@ -135,7 +136,7 @@ serve({
             start: 'next start',
         },
         dependencies: {
-            '@castari/sdk': '^0.0.4',
+            '@castari/sdk': '^0.0.6',
             next: '14.2.3',
             react: '18.3.1',
             'react-dom': '18.3.1',
@@ -186,7 +187,7 @@ const nextConfig = {
 
 export default nextConfig
 `);
-    await writeFile(join(webDir, '.env.example'), 'ANTHROPIC_API_KEY=sk-ant-...\n# CASTARI_PLATFORM_URL=http://localhost:3000\n# CASTARI_DEBUG=false\n');
+    await writeFile(join(webDir, '.env.example'), 'ANTHROPIC_API_KEY=sk-ant-...\nCASTARI_CLIENT_ID=your-client-id\n# CASTARI_PLATFORM_URL=http://localhost:3000\n# CASTARI_DEBUG=false\n');
     await writeFile(join(webDir, 'app', 'globals.css'), `:root {
   color-scheme: light;
   background: #f5f5f5;
@@ -497,6 +498,7 @@ async function createClient() {
         volume: VOLUME,
         labels: LABELS,
         platformUrl: process.env.CASTARI_PLATFORM_URL,
+        clientId: process.env.CASTARI_CLIENT_ID,
         anthropicApiKey,
         debug: process.env.CASTARI_DEBUG === 'true',
     })

package/dist/commands/start.js

@@ -2,6 +2,7 @@ import { CastariClient } from '@castari/sdk/client';
 import { readFile } from 'fs/promises';
 import chalk from 'chalk';
 import dotenv from 'dotenv';
+import { getClientAuthOrExit } from '../utils/client-auth';
 export async function start(options) {
     // Load .env from current directory
     dotenv.config();
@@ -18,6 +19,7 @@ export async function start(options) {
     catch (e) {
         // Ignore if package.json missing
     }
+    const { clientId, apiKey } = await getClientAuthOrExit();
     if (!snapshotName) {
         console.error(chalk.red('Error: Snapshot name is required.'));
         process.exit(1);
@@ -27,13 +29,17 @@ export async function start(options) {
         console.log(chalk.blue(`📦 Using volume: ${volumeName}`));
     }
     const platformUrl = process.env.CASTARI_PLATFORM_URL;
-    const client = new CastariClient({
+    const clientOptions = {
         snapshot: snapshotName,
         volume: volumeName,
         platformUrl,
         debug: true, // Enable debug logs for CLI
-        anthropicApiKey: process.env.ANTHROPIC_API_KEY
-    });
+        anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+        clientId,
+    };
+    if (apiKey)
+        clientOptions.platformApiKey = apiKey;
+    const client = new CastariClient(clientOptions);
     try {
         await client.start();
         console.log(chalk.green('✅ Agent started!'));

package/dist/index.js

@@ -4,6 +4,7 @@ import { init } from './commands/init';
 import { deploy } from './commands/deploy';
 import { start } from './commands/start';
 import { dev } from './commands/dev';
+import { generateClientId } from './commands/generate-client-id';
 const cli = cac('castari');
 cli
     .command('init', 'Initialize a new Castari agent project')
@@ -22,6 +23,9 @@ cli
 cli
     .command('dev', 'Run the agent locally for development')
     .action(dev);
+cli
+    .command('generate-client-id', 'Generate a new Castari Client ID and save it locally')
+    .action(generateClientId);
 cli.help();
-cli.version('0.0.4');
+cli.version('0.0.7');
 cli.parse();

package/dist/utils/client-auth.d.ts

@@ -0,0 +1,11 @@
+export type ClientAuth = {
+    clientId: string;
+    apiKey?: string;
+};
+export declare function getClientAuthOrExit(): Promise<ClientAuth>;
+export declare function saveClientAuth(data: {
+    clientId: string;
+    apiKey?: string;
+    source?: 'online' | 'offline';
+    platformUrl?: string;
+}): Promise<void>;

package/dist/utils/client-auth.js

@@ -0,0 +1,21 @@
+import { getClientIdOrExit, loadClientId, saveClientId } from './client-id';
+export async function getClientAuthOrExit() {
+    const clientId = await getClientIdOrExit();
+    const stored = await loadClientId();
+    const apiKey = process.env.CASTARI_API_KEY ||
+        stored?.apiKey;
+    if (!apiKey) {
+        // We allow missing apiKey for now (platform may allow unauthenticated in dev)
+        return { clientId };
+    }
+    return { clientId, apiKey };
+}
+export async function saveClientAuth(data) {
+    await saveClientId({
+        clientId: data.clientId,
+        apiKey: data.apiKey,
+        source: data.source,
+        createdAt: new Date().toISOString(),
+        platformUrl: data.platformUrl,
+    });
+}

package/dist/utils/client-id.d.ts

@@ -0,0 +1,10 @@
+export type StoredClientId = {
+    clientId: string;
+    source?: 'online' | 'offline';
+    createdAt?: string;
+    platformUrl?: string;
+    apiKey?: string;
+};
+export declare function loadClientId(): Promise<StoredClientId | null>;
+export declare function saveClientId(data: StoredClientId): Promise<void>;
+export declare function getClientIdOrExit(explicit?: string): Promise<string>;

package/dist/utils/client-id.js

@@ -0,0 +1,36 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { mkdir, readFile, writeFile } from 'fs/promises';
+import chalk from 'chalk';
+const CONFIG_DIR = join(homedir(), '.castari');
+const CONFIG_PATH = join(CONFIG_DIR, 'client.json');
+export async function loadClientId() {
+    try {
+        const raw = await readFile(CONFIG_PATH, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed.clientId && typeof parsed.clientId === 'string') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveClientId(data) {
+    await mkdir(CONFIG_DIR, { recursive: true });
+    await writeFile(CONFIG_PATH, JSON.stringify(data, null, 2));
+}
+export async function getClientIdOrExit(explicit) {
+    const envId = process.env.CASTARI_CLIENT_ID;
+    if (explicit)
+        return explicit;
+    if (envId)
+        return envId;
+    const stored = await loadClientId();
+    if (stored?.clientId)
+        return stored.clientId;
+    console.error(chalk.red('CASTARI_CLIENT_ID is required.'));
+    console.error(chalk.white('Run `castari generate-client-id` to create one, or set CASTARI_CLIENT_ID in your environment.'));
+    process.exit(1);
+}

package/package.json

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