@chucky.cloud/sdk 0.2.0 → 0.2.1

package/dist/client/Session.d.ts

@@ -2,32 +2,29 @@
  * Session
  *
  * Represents a conversation session with the Chucky sandbox.
- * Supports multi-turn conversations, tool execution, and streaming.
+ * 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 { SessionResult, SessionInfo, SessionState, Message } from '../types/results.js';
-import type { ToolResult, ToolCall } from '../types/tools.js';
+import type { SessionInfo } from '../types/results.js';
+import type { SDKMessage } from '../types/messages.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;
 }
 /**
@@ -35,30 +32,26 @@ export interface SessionEventHandlers {
  */
 interface SessionConfig {
     debug?: boolean;
-    oneShot?: boolean;
 }
 /**
- * Session class for managing conversations
+ * Session class - matches official V2 SDK interface
  *
- * @example
+ * Usage:
  * ```typescript
- * const session = await client.createSession({
- *   model: 'claude-sonnet-4-5-20250929',
- * });
+ * const session = createSession({ token, model: 'claude-sonnet-4-5-20250929' });
  *
- * // Simple send
- * const result = await session.send('Hello!');
+ * // 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);
+ * }
  *
- * // Streaming
- * for await (const event of session.sendStream('Tell me a story')) {
- *   if (event.type === 'text') {
- *     process.stdout.write(event.text);
- *   }
+ * await session.send('Multiply that by 2');
+ * for await (const msg of session.stream()) {
+ *   if (msg.type === 'result') console.log(msg.result);
  * }
  *
- * // Multi-turn
- * await session.send('What is the capital of France?');
- * await session.send('What about Germany?');
+ * session.close();
  * ```
  */
 export declare class Session {
@@ -68,47 +61,75 @@ export declare class Session {
     private eventHandlers;
     private toolHandlers;
     private messageBuffer;
-    private currentResult;
     private _state;
     private _sessionId;
     private messageResolvers;
+    private connected;
+    private connectPromise;
     constructor(transport: Transport, options: SessionOptions, config?: SessionConfig);
-    /**
-     * Get the current session state
-     */
-    get state(): SessionState;
     /**
      * Get the session ID
      */
-    get sessionId(): string | null;
+    get sessionId(): string;
     /**
      * 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>;
+     * 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>;
     /**
-     * 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
+     * Close the session
      */
-    getResult(): SessionResult | null;
+    close(): void;
     /**
-     * Close the session
+     * Support for `await using` (TypeScript 5.2+)
      */
-    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
     /**
      * Build init payload from options
      */
@@ -121,10 +142,6 @@ export declare class Session {
      * Wait for session to be ready
      */
     private waitForReady;
-    /**
-     * Wait for result
-     */
-    private waitForResult;
     /**
      * Wait for next message
      */
@@ -133,14 +150,18 @@ export declare class Session {
      * Handle a tool call
      */
     private handleToolCall;
-    /**
-     * Convert message to streaming events
-     */
-    private messageToStreamingEvents;
     /**
      * 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 +1 @@
-{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../src/client/Session.ts"],"names":[],"mappings":"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"}
+{"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;IA2BrF;;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;IA8BxB;;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"}