@chucky.cloud/sdk 0.2.5 → 0.3.0

package/dist/client/ChuckyClient.js

@@ -1,209 +0,0 @@
-/**
- * Chucky Client
- *
- * Main entry point for the Chucky SDK.
- * Provides methods to create sessions and execute prompts.
- * Matches the official Claude Agent SDK V2 interface.
- */
-import { WebSocketTransport } from '../transport/WebSocketTransport.js';
-import { Session, getAssistantText, getResultText } from './Session.js';
-/**
- * Default base URL for the Chucky service
- */
-const DEFAULT_BASE_URL = 'wss://conjure.chucky.cloud/ws';
-/**
- * Chucky client for interacting with the sandbox service
- *
- * Matches the official Claude Agent SDK V2 interface.
- *
- * @example
- * ```typescript
- * import { ChuckyClient } from '@chucky.cloud/sdk';
- *
- * const client = new ChuckyClient({
- *   token: 'your-jwt-token',
- * });
- *
- * // Create a session (V2 style)
- * const session = client.createSession({
- *   model: 'claude-sonnet-4-5-20250929',
- *   systemPrompt: 'You are a helpful assistant.',
- * });
- *
- * // Send messages and stream responses
- * await session.send('Hello, world!');
- * for await (const msg of session.stream()) {
- *   if (msg.type === 'assistant') {
- *     const text = getAssistantText(msg);
- *     console.log(text);
- *   }
- *   if (msg.type === 'result') {
- *     console.log('Done:', msg);
- *   }
- * }
- *
- * session.close();
- * ```
- */
-export class ChuckyClient {
-    options;
-    eventHandlers = {};
-    activeSessions = new Map();
-    /**
-     * Create a new Chucky client
-     */
-    constructor(options) {
-        this.options = {
-            baseUrl: DEFAULT_BASE_URL,
-            debug: false,
-            ...options,
-        };
-    }
-    /**
-     * Set event handlers
-     */
-    on(handlers) {
-        this.eventHandlers = { ...this.eventHandlers, ...handlers };
-        return this;
-    }
-    /**
-     * Create a new session
-     *
-     * Matches V2 SDK: createSession() returns a Session immediately.
-     * Connection happens automatically on first send().
-     *
-     * @param options - Session configuration options
-     * @returns A new session instance
-     *
-     * @example
-     * ```typescript
-     * const session = client.createSession({
-     *   model: 'claude-sonnet-4-5-20250929',
-     *   systemPrompt: 'You are a helpful coding assistant.',
-     * });
-     *
-     * await session.send('Hello!');
-     * for await (const msg of session.stream()) {
-     *   // Handle messages
-     * }
-     * ```
-     */
-    createSession(options = {}) {
-        const transport = this.createTransport();
-        const session = new Session(transport, options, {
-            debug: this.options.debug,
-        });
-        // Track the session
-        session.on({
-            onSessionInfo: (info) => {
-                if (info.sessionId) {
-                    this.activeSessions.set(info.sessionId, session);
-                }
-            },
-        });
-        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 = client.resumeSession('session-123');
-     * await session.send('Continue our conversation');
-     * ```
-     */
-    resumeSession(sessionId, options = {}) {
-        return this.createSession({
-            ...options,
-            sessionId,
-        });
-    }
-    /**
-     * Execute a one-shot prompt (stateless)
-     *
-     * Matches V2 SDK: prompt() for simple one-off queries.
-     *
-     * @param message - The message to send
-     * @param options - Prompt configuration
-     * @returns The result message
-     *
-     * @example
-     * ```typescript
-     * const result = await client.prompt(
-     *   'Explain quantum computing in simple terms',
-     *   { model: 'claude-sonnet-4-5-20250929' }
-     * );
-     * if (result.subtype === 'success') {
-     *   console.log(result.result);
-     * }
-     * ```
-     */
-    async prompt(message, options = {}) {
-        const session = this.createSession(options);
-        try {
-            await session.send(message);
-            let result = null;
-            for await (const msg of session.stream()) {
-                if (msg.type === 'result') {
-                    result = msg;
-                    break;
-                }
-            }
-            if (!result) {
-                throw new Error('No result message received');
-            }
-            return result;
-        }
-        finally {
-            session.close();
-        }
-    }
-    /**
-     * Close all active sessions and disconnect
-     */
-    close() {
-        for (const session of this.activeSessions.values()) {
-            session.close();
-        }
-        this.activeSessions.clear();
-    }
-    /**
-     * 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);
-}
-// Re-export helpers for convenience
-export { getAssistantText, getResultText };
-//# sourceMappingURL=ChuckyClient.js.map

package/dist/client/ChuckyClient.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ChuckyClient.js","sourceRoot":"","sources":["../../src/client/ChuckyClient.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAExE;;GAEG;AACH,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAO,YAAY;IACN,OAAO,CAC6B;IAC7C,aAAa,GAAwB,EAAE,CAAC;IACxC,cAAc,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEzD;;OAEG;IACH,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG;YACb,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,KAAK;YACZ,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,EAAE,CAAC,QAA6B;QAC9B,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,aAAa,CAAC,UAA0B,EAAE;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE;YAC9C,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;SAC1B,CAAC,CAAC;QAEH,oBAAoB;QACpB,OAAO,CAAC,EAAE,CAAC;YACT,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE;gBACtB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,SAAiB,EAAE,UAA6C,EAAE;QAC9E,OAAO,IAAI,CAAC,aAAa,CAAC;YACxB,GAAG,OAAO;YACV,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,UAA0B,EAAE;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE5B,IAAI,MAAM,GAA4B,IAAI,CAAC;YAC3C,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACzC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC1B,MAAM,GAAG,GAAuB,CAAC;oBACjC,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAChD,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,OAAO,IAAI,kBAAkB,CAAC;YAC5B,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YACzB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC7B,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB;YACjD,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;YACzC,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,oBAAoB;YACvD,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;SAC1B,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,oCAAoC;AACpC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/dist/client/Session.d.ts

@@ -1,167 +0,0 @@
-/**
- * Session
- *
- * Represents a conversation session with the Chucky sandbox.
- * Matches the official Claude Agent SDK V2 interface.
- *
- * @example
- * ```typescript
- * const session = createSession({ token, model: 'claude-sonnet-4-5-20250929' });
- *
- * await session.send('Hello!');
- * for await (const msg of session.stream()) {
- *   if (msg.type === 'assistant') {
- *     console.log(getAssistantText(msg));
- *   }
- * }
- * ```
- */
-import type { SessionOptions } from '../types/options.js';
-import type { SessionInfo } from '../types/results.js';
-import type { SDKMessage } from '../types/messages.js';
-import type { Transport } from '../transport/Transport.js';
-/**
- * Session event handlers
- */
-export interface SessionEventHandlers {
-    onSessionInfo?: (info: SessionInfo) => void;
-    onError?: (error: Error) => void;
-}
-/**
- * Internal session configuration
- */
-interface SessionConfig {
-    debug?: boolean;
-}
-/**
- * Session class - matches official V2 SDK interface
- *
- * Usage:
- * ```typescript
- * const session = createSession({ token, model: 'claude-sonnet-4-5-20250929' });
- *
- * // Multi-turn conversation
- * await session.send('What is 5 + 3?');
- * for await (const msg of session.stream()) {
- *   if (msg.type === 'result') console.log(msg.result);
- * }
- *
- * await session.send('Multiply that by 2');
- * for await (const msg of session.stream()) {
- *   if (msg.type === 'result') console.log(msg.result);
- * }
- *
- * session.close();
- * ```
- */
-export declare class Session {
-    private transport;
-    private options;
-    private config;
-    private eventHandlers;
-    private toolHandlers;
-    private messageBuffer;
-    private _state;
-    private _sessionId;
-    private messageResolvers;
-    private connected;
-    private connectPromise;
-    constructor(transport: Transport, options: SessionOptions, config?: SessionConfig);
-    /**
-     * Get the session ID
-     */
-    get sessionId(): string;
-    /**
-     * Set event handlers
-     */
-    on(handlers: SessionEventHandlers): this;
-    /**
-     * Connect and initialize the session (called automatically on first send)
-     */
-    private ensureConnected;
-    private connect;
-    /**
-     * Send a message to the session
-     *
-     * Matches V2 SDK: send() returns Promise<void>
-     * Use stream() to get the response.
-     *
-     * @example
-     * ```typescript
-     * await session.send('Hello!');
-     * for await (const msg of session.stream()) {
-     *   // Handle messages
-     * }
-     * ```
-     */
-    send(message: string): Promise<void>;
-    /**
-     * Stream the response after sending a message
-     *
-     * Matches V2 SDK: Returns AsyncGenerator<SDKMessage>
-     *
-     * @example
-     * ```typescript
-     * await session.send('Hello!');
-     * for await (const msg of session.stream()) {
-     *   if (msg.type === 'assistant') {
-     *     const text = msg.message.content
-     *       .filter(b => b.type === 'text')
-     *       .map(b => b.text)
-     *       .join('');
-     *     console.log(text);
-     *   }
-     *   if (msg.type === 'result') {
-     *     console.log('Done:', msg.result);
-     *   }
-     * }
-     * ```
-     */
-    stream(): AsyncGenerator<SDKMessage, void, unknown>;
-    /**
-     * Receive messages (alias for stream for V2 compatibility)
-     */
-    receive(): AsyncGenerator<SDKMessage, void, unknown>;
-    /**
-     * Close the session
-     */
-    close(): void;
-    /**
-     * Support for `await using` (TypeScript 5.2+)
-     */
-    [Symbol.asyncDispose](): Promise<void>;
-    /**
-     * Build init payload from options
-     */
-    private buildInitPayload;
-    /**
-     * Handle incoming message
-     */
-    private handleMessage;
-    /**
-     * Wait for session to be ready
-     */
-    private waitForReady;
-    /**
-     * Wait for next message
-     */
-    private waitForNextMessage;
-    /**
-     * Handle a tool call
-     */
-    private handleToolCall;
-    /**
-     * Log debug messages
-     */
-    private log;
-}
-/**
- * Extract text from an assistant message
- */
-export declare function getAssistantText(msg: SDKMessage): string | null;
-/**
- * Extract result from a result message
- */
-export declare function getResultText(msg: SDKMessage): string | null;
-export {};
-//# sourceMappingURL=Session.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../src/client/Session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAGV,UAAU,EAIX,MAAM,sBAAsB,CAAC;AAc9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAaD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,YAAY,CAAqD;IACzE,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,gBAAgB,CAAiD;IACzE,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAA8B;gBAExC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAE,aAAkB;IAgCrF;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAKxC;;OAEG;YACW,eAAe;YAWf,OAAO;IAcrB;;;;;;;;;;;;;OAaG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,MAAM,IAAI,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC;IA+B1D;;OAEG;IACH,OAAO,IAAI,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC;IAIpD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqCrB;;OAEG;YACW,YAAY;IA0C1B;;OAEG;YACW,kBAAkB;IAUhC;;OAEG;YACW,cAAc;IAsB5B;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAM/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAO5D"}