@chucky.cloud/sdk 0.1.0

package/dist/client/ChuckyClient.js

@@ -0,0 +1,232 @@
+/**
+ * Chucky Client
+ *
+ * Main entry point for the Chucky SDK.
+ * Provides methods to create sessions and execute prompts.
+ */
+import { WebSocketTransport } from '../transport/WebSocketTransport.js';
+import { Session } from './Session.js';
+/**
+ * Default base URL for the Chucky service
+ */
+const DEFAULT_BASE_URL = 'wss://box.chucky.cloud/ws';
+/**
+ * Chucky client for interacting with the sandbox service
+ *
+ * @example
+ * ```typescript
+ * import { ChuckyClient } from '@chucky.cloud/sdk';
+ *
+ * const client = new ChuckyClient({
+ *   token: 'your-jwt-token',
+ * });
+ *
+ * // Create a session
+ * const session = await client.createSession({
+ *   model: 'claude-sonnet-4-5-20250929',
+ *   systemPrompt: 'You are a helpful assistant.',
+ * });
+ *
+ * // Send messages
+ * const result = await session.send('Hello, world!');
+ * console.log(result.text);
+ *
+ * // Or use one-shot prompts
+ * const response = await client.prompt({
+ *   message: 'What is 2 + 2?',
+ *   model: 'claude-sonnet-4-5-20250929',
+ * });
+ * console.log(response.text);
+ * ```
+ */
+export class ChuckyClient {
+    options;
+    transport = null;
+    eventHandlers = {};
+    activeSessions = new Map();
+    /**
+     * Create a new Chucky client
+     */
+    constructor(options) {
+        this.options = {
+            baseUrl: DEFAULT_BASE_URL,
+            debug: false,
+            ...options,
+        };
+    }
+    /**
+     * Get the current connection status
+     */
+    get status() {
+        return this.transport?.status ?? 'disconnected';
+    }
+    /**
+     * Set event handlers
+     */
+    on(handlers) {
+        this.eventHandlers = { ...this.eventHandlers, ...handlers };
+        return this;
+    }
+    /**
+     * Create a new session
+     *
+     * @param options - Session configuration options
+     * @returns A new session instance
+     *
+     * @example
+     * ```typescript
+     * const session = await client.createSession({
+     *   model: 'claude-sonnet-4-5-20250929',
+     *   systemPrompt: 'You are a helpful coding assistant.',
+     *   tools: [
+     *     {
+     *       name: 'get_weather',
+     *       description: 'Get the current weather',
+     *       inputSchema: {
+     *         type: 'object',
+     *         properties: {
+     *           city: { type: 'string', description: 'City name' },
+     *         },
+     *         required: ['city'],
+     *       },
+     *       handler: async ({ city }) => ({
+     *         content: [{ type: 'text', text: `Weather in ${city}: Sunny, 72°F` }],
+     *       }),
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    async createSession(options = {}) {
+        const transport = this.createTransport();
+        const session = new Session(transport, options, {
+            debug: this.options.debug,
+        });
+        // Track the session
+        session.on({
+            onSessionInfo: (info) => {
+                this.activeSessions.set(info.sessionId, session);
+            },
+        });
+        await session.connect();
+        return session;
+    }
+    /**
+     * Resume an existing session
+     *
+     * @param sessionId - The session ID to resume
+     * @param options - Additional session options
+     * @returns The resumed session
+     *
+     * @example
+     * ```typescript
+     * const session = await client.resumeSession('session-123', {
+     *   continue: true,
+     * });
+     * ```
+     */
+    async resumeSession(sessionId, options = {}) {
+        return this.createSession({
+            ...options,
+            sessionId,
+        });
+    }
+    /**
+     * Execute a one-shot prompt (stateless)
+     *
+     * @param options - Prompt configuration
+     * @returns The prompt result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.prompt({
+     *   message: 'Explain quantum computing in simple terms',
+     *   model: 'claude-sonnet-4-5-20250929',
+     * });
+     * console.log(result.text);
+     * ```
+     */
+    async prompt(options) {
+        const transport = this.createTransport();
+        const session = new Session(transport, options, {
+            debug: this.options.debug,
+            oneShot: true,
+        });
+        await session.connect();
+        return session.prompt(options.message);
+    }
+    /**
+     * Execute a prompt with streaming
+     *
+     * @param options - Prompt configuration
+     * @yields Stream events and final result
+     *
+     * @example
+     * ```typescript
+     * for await (const event of client.promptStream({ message: 'Tell me a story' })) {
+     *   if (event.type === 'text') {
+     *     process.stdout.write(event.text);
+     *   }
+     * }
+     * ```
+     */
+    async *promptStream(options) {
+        const transport = this.createTransport();
+        const session = new Session(transport, options, {
+            debug: this.options.debug,
+            oneShot: true,
+        });
+        await session.connect();
+        for await (const event of session.sendStream(options.message)) {
+            yield event;
+        }
+        // Return final result
+        return session.getResult();
+    }
+    /**
+     * Close all active sessions and disconnect
+     */
+    async close() {
+        for (const session of this.activeSessions.values()) {
+            await session.close();
+        }
+        this.activeSessions.clear();
+        if (this.transport) {
+            await this.transport.disconnect();
+            this.transport = null;
+        }
+    }
+    /**
+     * Create a new transport instance
+     */
+    createTransport() {
+        return new WebSocketTransport({
+            url: this.options.baseUrl,
+            token: this.options.token,
+            timeout: this.options.timeout,
+            keepAliveInterval: this.options.keepAliveInterval,
+            autoReconnect: this.options.autoReconnect,
+            maxReconnectAttempts: this.options.maxReconnectAttempts,
+            debug: this.options.debug,
+        });
+    }
+}
+/**
+ * Create a Chucky client
+ *
+ * @param options - Client configuration
+ * @returns A new ChuckyClient instance
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@chucky.cloud/sdk';
+ *
+ * const client = createClient({
+ *   token: 'your-jwt-token',
+ * });
+ * ```
+ */
+export function createClient(options) {
+    return new ChuckyClient(options);
+}
+//# sourceMappingURL=ChuckyClient.js.map

package/dist/client/ChuckyClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChuckyClient.js","sourceRoot":"","sources":["../../src/client/ChuckyClient.ts"],"names":[],"mappings":"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"}

package/dist/client/Session.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Session
+ *
+ * Represents a conversation session with the Chucky sandbox.
+ * Supports multi-turn conversations, tool execution, and streaming.
+ */
+import type { SessionOptions } from '../types/options.js';
+import type { SessionResult, SessionInfo, SessionState, Message } from '../types/results.js';
+import type { ToolResult, ToolCall } from '../types/tools.js';
+import type { Transport } from '../transport/Transport.js';
+import type { StreamingEvent } from './ChuckyClient.js';
+/**
+ * Session event handlers
+ */
+export interface SessionEventHandlers {
+    /** Called when session info is received */
+    onSessionInfo?: (info: SessionInfo) => void;
+    /** Called when a message is received */
+    onMessage?: (message: Message) => void;
+    /** Called when streaming text is received */
+    onText?: (text: string) => void;
+    /** Called when a tool is being used */
+    onToolUse?: (toolCall: ToolCall) => void;
+    /** Called when a tool result is returned */
+    onToolResult?: (callId: string, result: ToolResult) => void;
+    /** Called when thinking is received */
+    onThinking?: (thinking: string) => void;
+    /** Called when session completes */
+    onComplete?: (result: SessionResult) => void;
+    /** Called when an error occurs */
+    onError?: (error: Error) => void;
+}
+/**
+ * Internal session configuration
+ */
+interface SessionConfig {
+    debug?: boolean;
+    oneShot?: boolean;
+}
+/**
+ * Session class for managing conversations
+ *
+ * @example
+ * ```typescript
+ * const session = await client.createSession({
+ *   model: 'claude-sonnet-4-5-20250929',
+ * });
+ *
+ * // Simple send
+ * const result = await session.send('Hello!');
+ *
+ * // Streaming
+ * for await (const event of session.sendStream('Tell me a story')) {
+ *   if (event.type === 'text') {
+ *     process.stdout.write(event.text);
+ *   }
+ * }
+ *
+ * // Multi-turn
+ * await session.send('What is the capital of France?');
+ * await session.send('What about Germany?');
+ * ```
+ */
+export declare class Session {
+    private transport;
+    private options;
+    private config;
+    private eventHandlers;
+    private toolHandlers;
+    private messageBuffer;
+    private currentResult;
+    private _state;
+    private _sessionId;
+    private messageResolvers;
+    constructor(transport: Transport, options: SessionOptions, config?: SessionConfig);
+    /**
+     * Get the current session state
+     */
+    get state(): SessionState;
+    /**
+     * Get the session ID
+     */
+    get sessionId(): string | null;
+    /**
+     * Set event handlers
+     */
+    on(handlers: SessionEventHandlers): this;
+    /**
+     * Connect and initialize the session
+     */
+    connect(): Promise<void>;
+    /**
+     * Send a message and wait for complete response
+     */
+    send(message: string): Promise<SessionResult>;
+    /**
+     * Send a message with streaming
+     */
+    sendStream(message: string): AsyncGenerator<StreamingEvent, void, unknown>;
+    /**
+     * Execute a one-shot prompt
+     */
+    prompt(message: string): Promise<SessionResult>;
+    /**
+     * Get the current/last result
+     */
+    getResult(): SessionResult | null;
+    /**
+     * Close the session
+     */
+    close(): Promise<void>;
+    /**
+     * Build init payload from options
+     */
+    private buildInitPayload;
+    /**
+     * Handle incoming message
+     */
+    private handleMessage;
+    /**
+     * Wait for session to be ready
+     */
+    private waitForReady;
+    /**
+     * Wait for result
+     */
+    private waitForResult;
+    /**
+     * Wait for next message
+     */
+    private waitForNextMessage;
+    /**
+     * Handle a tool call
+     */
+    private handleToolCall;
+    /**
+     * Convert message to streaming events
+     */
+    private messageToStreamingEvents;
+    /**
+     * Log debug messages
+     */
+    private log;
+}
+export {};
+//# sourceMappingURL=Session.d.ts.map

package/dist/client/Session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../src/client/Session.ts"],"names":[],"mappings":"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"}