@castari/sdk 0.1.4 → 0.2.0

package/README.md

@@ -1,151 +1,139 @@
 # @castari/sdk
 
-The SDK for building and connecting to Castari agents.
+Official Castari SDK for TypeScript and Node.js.
 
 ## Installation
 
 ```bash
 npm install @castari/sdk
-# or
-bun add @castari/sdk
 ```
 
-## Building Agents
-
-### `serve(options)`
-
-Starts the agent server. This should be the entrypoint of your agent.
+## Quick Start
 
 ```typescript
-import { serve, tool } from '@castari/sdk'
+import { CastariClient } from '@castari/sdk';
 
-serve({
-  tools: [myTool],
-  systemPrompt: 'You are a helpful assistant.'
-})
-```
+// Using API key
+const client = new CastariClient({
+  apiKey: process.env.CASTARI_API_KEY,
+});
 
-#### Options
+// Or let it load from ~/.castari/credentials.yaml
+const client = new CastariClient();
+await client.ensureAuthenticated();
 
-| Property | Type | Description |
-|----------|------|-------------|
-| `tools` | `Tool[]` | Array of tools exposed by the agent |
-| `systemPrompt` | `string` | The system prompt defining the agent's behavior |
-| `allowedTools` | `string[]` | (Optional) Restrict which tools the agent can use |
-| `port` | `number` | (Optional) Port to listen on. Defaults to `3000` |
+// List agents
+const agents = await client.agents.list();
 
-By default, agents have access to all system tools (Bash, File Editing, etc.) plus any custom tools you define. Use `allowedTools` to restrict access:
+// Deploy an agent
+await client.agents.deploy('my-agent');
 
-```typescript
-serve({
-  tools: [myCustomTool],
-  allowedTools: ['my_custom_tool', 'Bash'] // Only these tools available
-})
+// Invoke an agent
+const result = await client.agents.invoke('my-agent', {
+  prompt: 'Hello, world!',
+});
+
+console.log(result.response_content);
 ```
 
-### `tool(definition)`
+## API Reference
 
-Defines a custom tool for the agent.
+### CastariClient
 
 ```typescript
-import { tool } from '@castari/sdk'
-
-const weatherTool = tool({
-  name: 'get_weather',
-  description: 'Get the weather for a location',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      location: { type: 'string' }
-    },
-    required: ['location']
-  },
-  handler: async ({ location }) => {
-    return `The weather in ${location} is sunny.`
-  }
-})
+const client = new CastariClient({
+  apiKey?: string,    // API key (cast_...)
+  token?: string,     // OAuth token
+  baseUrl?: string,   // API base URL
+});
 ```
 
-## Connecting to Agents
-
-### `CastariClient`
-
-A client for connecting to Castari agents.
+### Agents
 
 ```typescript
-import { CastariClient } from '@castari/sdk/client'
+// List all agents
+const agents = await client.agents.list();
 
-const client = new CastariClient({
-  snapshot: 'my-agent',
-  clientId: process.env.CASTARI_CLIENT_ID,
-  platformApiKey: process.env.CASTARI_API_KEY,
-  anthropicApiKey: process.env.ANTHROPIC_API_KEY,
-})
+// Create an agent
+const agent = await client.agents.create({
+  name: 'My Agent',
+  gitRepoUrl: 'https://github.com/user/repo',
+  slug: 'my-agent',
+});
 
-await client.start()
+// Get agent by slug
+const agent = await client.agents.get('my-agent');
 
-client.onMessage((msg) => {
-  console.log('Agent:', msg)
-})
+// Delete an agent
+await client.agents.delete('my-agent');
 
-client.send({
-  type: 'user_message',
-  data: { message: 'Hello!' }
-})
+// Deploy an agent
+const agent = await client.agents.deploy('my-agent');
 
-// When done
-await client.stop()
+// Invoke an agent
+const result = await client.agents.invoke('my-agent', {
+  prompt: 'Your prompt here',
+});
 ```
 
-#### Constructor Options
+### Secrets
 
-| Property | Type | Description |
-|----------|------|-------------|
-| `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 |
-| `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) |
+```typescript
+// List secrets (keys only, values are never returned)
+const secrets = await client.agents.listSecrets('my-agent');
+
+// Set a secret
+await client.agents.setSecret('my-agent', 'API_KEY', 'secret-value');
+
+// Delete a secret
+await client.agents.deleteSecret('my-agent', 'API_KEY');
+```
 
-#### Methods
+### Usage
 
-- `start()` - Creates a sandbox and connects to the agent
-- `stop(options?)` - Disconnects and cleans up
-  - `{ delete: false }` - Stop but preserve sandbox for reuse
-- `send(message)` - Send a message to the agent
-- `onMessage(callback)` - Register a callback for incoming messages
+```typescript
+// Get usage summary
+const summary = await client.usage.summary({ days: 30 });
 
-### Sandbox Reuse
+// Get daily breakdown
+const daily = await client.usage.daily({ days: 7 });
+```
 
-Use labels to reuse sandboxes across sessions:
+### Auth
 
 ```typescript
-const client = new CastariClient({
-  snapshot: 'my-agent',
-  volume: `user-${userId}`,
-  labels: {
-    userId,
-    app: 'my-app'
-  }
-})
+// Get current user
+const user = await client.auth.me();
 
-// First call creates, subsequent calls reuse
-await client.start()
+// Create API key
+const { api_key, prefix } = await client.auth.createApiKey();
 
-// Stop but preserve for later
-await client.stop({ delete: false })
+// Revoke API key
+await client.auth.revokeApiKey();
 ```
 
-## Environment Variables
+## Error Handling
 
-| Variable | Description |
-|----------|-------------|
-| `ANTHROPIC_API_KEY` | Your Anthropic API key |
-| `CASTARI_CLIENT_ID` | Your Castari client ID |
-| `CASTARI_API_KEY` | Your Castari API key |
+```typescript
+import {
+  CastariError,
+  AuthenticationError,
+  NotFoundError,
+  RateLimitError,
+} from '@castari/sdk';
+
+try {
+  await client.agents.get('non-existent');
+} catch (error) {
+  if (error instanceof NotFoundError) {
+    console.log('Agent not found');
+  } else if (error instanceof AuthenticationError) {
+    console.log('Not authenticated');
+  } else if (error instanceof RateLimitError) {
+    console.log(`Rate limited, retry in ${error.retryAfter}s`);
+  }
+}
+```
 
 ## License
 

package/dist/agents.d.ts

@@ -0,0 +1,76 @@
+import type { HttpClient } from './http.js';
+import type { Agent, CreateAgentOptions, InvocationResponse, InvokeOptions, Secret } from './types.js';
+/**
+ * API for managing agents
+ */
+export declare class AgentsAPI {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List all agents for the authenticated user
+     * @returns Array of agents
+     */
+    list(): Promise<Agent[]>;
+    /**
+     * Create a new agent
+     * @param options - Agent creation options
+     * @returns The created agent
+     */
+    create(options: CreateAgentOptions): Promise<Agent>;
+    /**
+     * Get an agent by slug
+     * @param slug - The agent's unique slug
+     * @returns The agent
+     * @throws NotFoundError if agent doesn't exist
+     */
+    get(slug: string): Promise<Agent>;
+    /**
+     * Delete an agent
+     * @param slug - The agent's unique slug
+     * @throws NotFoundError if agent doesn't exist
+     */
+    delete(slug: string): Promise<void>;
+    /**
+     * Deploy an agent (create sandbox, clone repo, install deps)
+     * @param slug - The agent's unique slug
+     * @returns The updated agent with status 'active'
+     * @throws NotFoundError if agent doesn't exist
+     */
+    deploy(slug: string): Promise<Agent>;
+    /**
+     * Stop a running agent
+     * @param slug - The agent's unique slug
+     * @returns The updated agent with status 'stopped'
+     * @throws NotFoundError if agent doesn't exist
+     */
+    stop(slug: string): Promise<Agent>;
+    /**
+     * Invoke an agent with a prompt
+     * @param slug - The agent's unique slug
+     * @param options - Invocation options including prompt
+     * @returns The invocation response with result and usage stats
+     * @throws NotFoundError if agent doesn't exist
+     * @throws BadRequestError if agent is not deployed
+     */
+    invoke(slug: string, options: InvokeOptions): Promise<InvocationResponse>;
+    /**
+     * List secret keys for an agent (values are never returned)
+     * @param slug - The agent's unique slug
+     * @returns Array of secret key names
+     */
+    listSecrets(slug: string): Promise<Secret[]>;
+    /**
+     * Set a secret for an agent
+     * @param slug - The agent's unique slug
+     * @param key - The secret key
+     * @param value - The secret value
+     */
+    setSecret(slug: string, key: string, value: string): Promise<void>;
+    /**
+     * Delete a secret from an agent
+     * @param slug - The agent's unique slug
+     * @param key - The secret key to delete
+     */
+    deleteSecret(slug: string, key: string): Promise<void>;
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EACV,KAAK,EAEL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,MAAM,EACP,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAK9B;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAUzD;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIvC;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAM1C;;;;;OAKG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIxC;;;;;;;OAOG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAW/E;;;;OAIG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKlD;;;;;OAKG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE;;;;OAIG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM7D"}

package/dist/agents.js

@@ -0,0 +1,111 @@
+/**
+ * API for managing agents
+ */
+export class AgentsAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List all agents for the authenticated user
+     * @returns Array of agents
+     */
+    async list() {
+        const response = await this.client.request('GET', '/agents');
+        return response.agents;
+    }
+    /**
+     * Create a new agent
+     * @param options - Agent creation options
+     * @returns The created agent
+     */
+    async create(options) {
+        return this.client.request('POST', '/agents', {
+            body: {
+                name: options.name,
+                git_repo_url: options.gitRepoUrl,
+                slug: options.slug,
+            },
+        });
+    }
+    /**
+     * Get an agent by slug
+     * @param slug - The agent's unique slug
+     * @returns The agent
+     * @throws NotFoundError if agent doesn't exist
+     */
+    async get(slug) {
+        return this.client.request('GET', `/agents/${encodeURIComponent(slug)}`);
+    }
+    /**
+     * Delete an agent
+     * @param slug - The agent's unique slug
+     * @throws NotFoundError if agent doesn't exist
+     */
+    async delete(slug) {
+        return this.client.request('DELETE', `/agents/${encodeURIComponent(slug)}`);
+    }
+    /**
+     * Deploy an agent (create sandbox, clone repo, install deps)
+     * @param slug - The agent's unique slug
+     * @returns The updated agent with status 'active'
+     * @throws NotFoundError if agent doesn't exist
+     */
+    async deploy(slug) {
+        return this.client.request('POST', `/agents/${encodeURIComponent(slug)}/deploy`, {
+            timeout: 120000, // 2 minutes for deployment
+        });
+    }
+    /**
+     * Stop a running agent
+     * @param slug - The agent's unique slug
+     * @returns The updated agent with status 'stopped'
+     * @throws NotFoundError if agent doesn't exist
+     */
+    async stop(slug) {
+        return this.client.request('POST', `/agents/${encodeURIComponent(slug)}/stop`);
+    }
+    /**
+     * Invoke an agent with a prompt
+     * @param slug - The agent's unique slug
+     * @param options - Invocation options including prompt
+     * @returns The invocation response with result and usage stats
+     * @throws NotFoundError if agent doesn't exist
+     * @throws BadRequestError if agent is not deployed
+     */
+    async invoke(slug, options) {
+        return this.client.request('POST', `/agents/${encodeURIComponent(slug)}/invoke`, {
+            body: { prompt: options.prompt },
+            timeout: 180000, // 3 minutes for invocation
+        });
+    }
+    /**
+     * List secret keys for an agent (values are never returned)
+     * @param slug - The agent's unique slug
+     * @returns Array of secret key names
+     */
+    async listSecrets(slug) {
+        const response = await this.client.request('GET', `/agents/${encodeURIComponent(slug)}/secrets`);
+        return response.secrets;
+    }
+    /**
+     * Set a secret for an agent
+     * @param slug - The agent's unique slug
+     * @param key - The secret key
+     * @param value - The secret value
+     */
+    async setSecret(slug, key, value) {
+        return this.client.request('POST', `/agents/${encodeURIComponent(slug)}/secrets`, {
+            body: { key, value },
+        });
+    }
+    /**
+     * Delete a secret from an agent
+     * @param slug - The agent's unique slug
+     * @param key - The secret key to delete
+     */
+    async deleteSecret(slug, key) {
+        return this.client.request('DELETE', `/agents/${encodeURIComponent(slug)}/secrets/${encodeURIComponent(key)}`);
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,OAAO,SAAS;IACA;IAApB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE1C;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAqB,KAAK,EAAE,SAAS,CAAC,CAAC;QACjF,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,OAA2B;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAQ,MAAM,EAAE,SAAS,EAAE;YACnD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY,EAAE,OAAO,CAAC,UAAU;gBAChC,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAQ,KAAK,EAAE,WAAW,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAO,QAAQ,EAAE,WAAW,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAQ,MAAM,EAAE,WAAW,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE;YACtF,OAAO,EAAE,MAAM,EAAE,2BAA2B;SAC7C,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAQ,MAAM,EAAE,WAAW,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAAsB;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,WAAW,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAC5C;YACE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YAChC,OAAO,EAAE,MAAM,EAAE,2BAA2B;SAC7C,CACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB,KAAK,EAAE,WAAW,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxH,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,GAAW,EAAE,KAAa;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAO,MAAM,EAAE,WAAW,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE;YACtF,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,GAAW;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,QAAQ,EACR,WAAW,kBAAkB,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,GAAG,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;CACF"}

package/dist/auth.d.ts

@@ -0,0 +1,27 @@
+import type { HttpClient } from './http.js';
+import type { User, ApiKeyResponse } from './types.js';
+/**
+ * API for authentication operations
+ */
+export declare class AuthAPI {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Get the currently authenticated user
+     * @returns The authenticated user
+     * @throws AuthenticationError if not authenticated
+     */
+    me(): Promise<User>;
+    /**
+     * Create a new API key for the authenticated user
+     * @returns The new API key (only shown once)
+     * @throws BadRequestError if user already has an API key
+     */
+    createApiKey(): Promise<ApiKeyResponse>;
+    /**
+     * Revoke the user's API key
+     * @throws BadRequestError if user has no API key
+     */
+    revokeApiKey(): Promise<void>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;;OAIG;IACG,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAI7C;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}

package/dist/auth.js

@@ -0,0 +1,33 @@
+/**
+ * API for authentication operations
+ */
+export class AuthAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get the currently authenticated user
+     * @returns The authenticated user
+     * @throws AuthenticationError if not authenticated
+     */
+    async me() {
+        return this.client.request('GET', '/auth/me');
+    }
+    /**
+     * Create a new API key for the authenticated user
+     * @returns The new API key (only shown once)
+     * @throws BadRequestError if user already has an API key
+     */
+    async createApiKey() {
+        return this.client.request('POST', '/auth/api-key');
+    }
+    /**
+     * Revoke the user's API key
+     * @throws BadRequestError if user has no API key
+     */
+    async revokeApiKey() {
+        return this.client.request('DELETE', '/auth/api-key');
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,OAAO;IACE;IAApB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE1C;;;;OAIG;IACH,KAAK,CAAC,EAAE;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAO,KAAK,EAAE,UAAU,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAiB,MAAM,EAAE,eAAe,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAO,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/client.d.ts

@@ -1,50 +1,56 @@
-import type { QueryConfig, WSInputMessage, WSOutputMessage } from './types';
-export * from './types';
+import { AgentsAPI } from './agents.js';
+import { UsageAPI } from './usage.js';
+import { AuthAPI } from './auth.js';
+import type { CastariClientOptions } from './types.js';
 /**
- * Configuration options for the Castari Client.
+ * Main client for interacting with the Castari API
+ *
+ * @example
+ * ```typescript
+ * import { CastariClient } from '@castari/sdk';
+ *
+ * // Uses credentials from ~/.castari or CASTARI_API_KEY env var
+ * const client = new CastariClient();
+ *
+ * // Or provide credentials explicitly
+ * const client = new CastariClient({ apiKey: 'cap_xxxxx' });
+ *
+ * // List agents
+ * const agents = await client.agents.list();
+ *
+ * // Deploy an agent
+ * await client.agents.deploy('my-agent');
+ *
+ * // Invoke an agent
+ * const result = await client.agents.invoke('my-agent', { prompt: 'Hello!' });
+ * ```
  */
-export interface ClientOptions extends Partial<QueryConfig> {
-    /** Local/custom connection URL (e.g., 'http://localhost:3000'). If omitted, Platform mode is used. */
-    connectionUrl?: string;
-    /** Anthropic API key (required unless present in process.env.ANTHROPIC_API_KEY) */
-    anthropicApiKey?: string;
-    /** Castari client ID (required for platform mode; otherwise read from env) */
-    clientId?: string;
-    /** Castari platform API key (used for auth when contacting the platform) */
-    platformApiKey?: string;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Snapshot name to deploy/start */
-    snapshot?: string;
-    /** Optional labels to apply to the sandbox (and filter by for reuse) */
-    labels?: Record<string, string>;
-    /** Optional volume name to mount at /home/castari/agent-workspace */
-    volume?: string;
-    /** Castari Platform API URL. Defaults to https://api.castari.com (or localhost in dev) */
-    platformUrl?: string;
-    /** Optional sessionId to resume */
-    resume?: string;
-    /**
-     * Use the platform API as a WebSocket proxy instead of connecting directly to the sandbox.
-     * Defaults to true for reliability. Set to false to connect directly to the sandbox.
-     */
-    useProxy?: boolean;
-}
 export declare class CastariClient {
-    private ws?;
     private options;
-    private messageHandlers;
-    private sandboxId?;
-    private resolvedClientId?;
-    private resolvedPlatformApiKey?;
-    constructor(options?: ClientOptions);
-    start(): Promise<void>;
-    private setupLocalConnection;
-    private setupPlatformConnection;
-    private handleMessage;
-    onMessage(handler: (message: WSOutputMessage) => void): () => void;
-    send(message: WSInputMessage): void;
-    stop(options?: {
-        delete?: boolean;
-    }): Promise<void>;
+    private httpClient;
+    private initialized;
+    private initPromise;
+    /** API for managing agents */
+    readonly agents: AgentsAPI;
+    /** API for accessing usage statistics */
+    readonly usage: UsageAPI;
+    /** API for authentication operations */
+    readonly auth: AuthAPI;
+    /**
+     * Create a new Castari client
+     * @param options - Client configuration options
+     */
+    constructor(options?: CastariClientOptions);
+    /**
+     * Initialize the client by loading credentials from config
+     * This is called automatically before the first API request
+     */
+    private initialize;
+    private doInitialize;
+    /**
+     * Ensure the client is initialized before making requests
+     * @throws AuthenticationError if no credentials are available
+     */
+    ensureAuthenticated(): Promise<void>;
 }
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,aAAa;IAkBZ,OAAO,CAAC,OAAO;IAjB3B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA8B;IAEjD,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAE3B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB;;;OAGG;gBACiB,OAAO,GAAE,oBAAyB;IAqBtD;;;OAGG;YACW,UAAU;YAaV,YAAY;IAY1B;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ3C"}