@chucky.cloud/sdk 0.1.0

package/dist/types/messages.d.ts

@@ -0,0 +1,195 @@
+/**
+ * WebSocket Message Types
+ *
+ * Defines the envelope format and message types for communication
+ * between the SDK client and the Chucky server.
+ */
+import type { ToolCall, ToolResult } from './tools.js';
+import type { SessionOptions, PromptOptions } from './options.js';
+/**
+ * WebSocket envelope types
+ */
+export type WsEnvelopeType = 'init' | 'prompt' | 'sdk_message' | 'control' | 'error' | 'ping' | 'pong' | 'tool_call' | 'tool_result' | 'result';
+/**
+ * Base envelope structure
+ */
+export interface WsEnvelope<T = unknown> {
+    /** Message type */
+    type: WsEnvelopeType;
+    /** Message payload */
+    payload: T;
+}
+/**
+ * Init message payload (session initialization)
+ */
+export interface InitPayload extends Omit<SessionOptions, 'tools' | 'mcpServers'> {
+    /** Serialized tool definitions */
+    tools?: unknown[];
+    /** Serialized MCP server definitions */
+    mcpServers?: unknown[];
+}
+/**
+ * Prompt message payload (one-shot prompt)
+ */
+export interface PromptPayload extends Omit<PromptOptions, 'tools' | 'mcpServers'> {
+    /** Serialized tool definitions */
+    tools?: unknown[];
+    /** Serialized MCP server definitions */
+    mcpServers?: unknown[];
+}
+/**
+ * Control message actions
+ */
+export type ControlAction = 'ready' | 'session_info' | 'end_input' | 'close';
+/**
+ * Control message payload
+ */
+export interface ControlPayload {
+    /** Control action */
+    action: ControlAction;
+    /** Additional data */
+    data?: Record<string, unknown>;
+}
+/**
+ * Error message payload
+ */
+export interface ErrorPayload {
+    /** Error message */
+    message: string;
+    /** Error code */
+    code?: string;
+    /** Additional error details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Ping/Pong message payload
+ */
+export interface PingPongPayload {
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Tool call message payload
+ */
+export interface ToolCallPayload extends ToolCall {
+}
+/**
+ * Tool result message payload
+ */
+export interface ToolResultPayload {
+    /** Call ID */
+    callId: string;
+    /** Tool result */
+    result: ToolResult;
+}
+/**
+ * Result message payload (final response)
+ */
+export interface ResultPayload {
+    /** Result type */
+    type: 'result';
+    /** Result subtype */
+    subtype?: string;
+    /** Response text */
+    text?: string;
+    /** Total cost in USD */
+    total_cost_usd?: number;
+    /** Duration in seconds */
+    duration_secs?: number;
+    /** Number of turns */
+    turn_count?: number;
+    /** Additional result data */
+    [key: string]: unknown;
+}
+/**
+ * SDK message payload (native Claude Agent SDK messages)
+ */
+export interface SdkMessagePayload {
+    /** Message type from SDK */
+    type: string;
+    /** Message data */
+    [key: string]: unknown;
+}
+export interface InitEnvelope extends WsEnvelope<InitPayload> {
+    type: 'init';
+}
+export interface PromptEnvelope extends WsEnvelope<PromptPayload> {
+    type: 'prompt';
+}
+export interface SdkMessageEnvelope extends WsEnvelope<SdkMessagePayload> {
+    type: 'sdk_message';
+}
+export interface ControlEnvelope extends WsEnvelope<ControlPayload> {
+    type: 'control';
+}
+export interface ErrorEnvelope extends WsEnvelope<ErrorPayload> {
+    type: 'error';
+}
+export interface PingEnvelope extends WsEnvelope<PingPongPayload> {
+    type: 'ping';
+}
+export interface PongEnvelope extends WsEnvelope<PingPongPayload> {
+    type: 'pong';
+}
+export interface ToolCallEnvelope extends WsEnvelope<ToolCallPayload> {
+    type: 'tool_call';
+}
+export interface ToolResultEnvelope extends WsEnvelope<ToolResultPayload> {
+    type: 'tool_result';
+}
+export interface ResultEnvelope extends WsEnvelope<ResultPayload> {
+    type: 'result';
+}
+/**
+ * Union type for all outgoing messages (client -> server)
+ */
+export type OutgoingMessage = InitEnvelope | PromptEnvelope | SdkMessageEnvelope | ControlEnvelope | PingEnvelope | ToolResultEnvelope;
+/**
+ * Union type for all incoming messages (server -> client)
+ */
+export type IncomingMessage = SdkMessageEnvelope | ControlEnvelope | ErrorEnvelope | PongEnvelope | ToolCallEnvelope | ResultEnvelope;
+/**
+ * Union type for all messages
+ */
+export type AnyMessage = OutgoingMessage | IncomingMessage;
+/**
+ * Create an init message
+ */
+export declare function createInitMessage(payload: InitPayload): InitEnvelope;
+/**
+ * Create a prompt message
+ */
+export declare function createPromptMessage(payload: PromptPayload): PromptEnvelope;
+/**
+ * Create an SDK message
+ */
+export declare function createSdkMessage(payload: SdkMessagePayload): SdkMessageEnvelope;
+/**
+ * Create a control message
+ */
+export declare function createControlMessage(action: ControlAction, data?: Record<string, unknown>): ControlEnvelope;
+/**
+ * Create a ping message
+ */
+export declare function createPingMessage(): PingEnvelope;
+/**
+ * Create a tool result message
+ */
+export declare function createToolResultMessage(callId: string, result: ToolResult): ToolResultEnvelope;
+/**
+ * Check if a message is a result message
+ */
+export declare function isResultMessage(message: AnyMessage): message is ResultEnvelope;
+/**
+ * Check if a message is a tool call message
+ */
+export declare function isToolCallMessage(message: AnyMessage): message is ToolCallEnvelope;
+/**
+ * Check if a message is a control message
+ */
+export declare function isControlMessage(message: AnyMessage): message is ControlEnvelope;
+/**
+ * Check if a message is an error message
+ */
+export declare function isErrorMessage(message: AnyMessage): message is ErrorEnvelope;
+//# sourceMappingURL=messages.d.ts.map

package/dist/types/messages.d.ts.map

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

package/dist/types/messages.js

@@ -0,0 +1,70 @@
+/**
+ * WebSocket Message Types
+ *
+ * Defines the envelope format and message types for communication
+ * between the SDK client and the Chucky server.
+ */
+// ============================================================================
+// Message Helpers
+// ============================================================================
+/**
+ * Create an init message
+ */
+export function createInitMessage(payload) {
+    return { type: 'init', payload };
+}
+/**
+ * Create a prompt message
+ */
+export function createPromptMessage(payload) {
+    return { type: 'prompt', payload };
+}
+/**
+ * Create an SDK message
+ */
+export function createSdkMessage(payload) {
+    return { type: 'sdk_message', payload };
+}
+/**
+ * Create a control message
+ */
+export function createControlMessage(action, data) {
+    return { type: 'control', payload: { action, data } };
+}
+/**
+ * Create a ping message
+ */
+export function createPingMessage() {
+    return { type: 'ping', payload: { timestamp: Date.now() } };
+}
+/**
+ * Create a tool result message
+ */
+export function createToolResultMessage(callId, result) {
+    return { type: 'tool_result', payload: { callId, result } };
+}
+/**
+ * Check if a message is a result message
+ */
+export function isResultMessage(message) {
+    return message.type === 'result';
+}
+/**
+ * Check if a message is a tool call message
+ */
+export function isToolCallMessage(message) {
+    return message.type === 'tool_call';
+}
+/**
+ * Check if a message is a control message
+ */
+export function isControlMessage(message) {
+    return message.type === 'control';
+}
+/**
+ * Check if a message is an error message
+ */
+export function isErrorMessage(message) {
+    return message.type === 'error';
+}
+//# sourceMappingURL=messages.js.map

package/dist/types/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/types/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6MH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAoB;IACpD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAqB,EACrB,IAA8B;IAE9B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAc,EACd,MAAkB;IAElB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAmB;IACjD,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACnD,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,OAAO,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAmB;IAChD,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC;AAClC,CAAC"}

package/dist/types/options.d.ts

@@ -0,0 +1,210 @@
+/**
+ * SDK Options Types
+ *
+ * These types define all configuration options for sessions and prompts.
+ * Designed for both browser and Node.js environments.
+ */
+import type { ToolDefinition, McpServerDefinition } from './tools.js';
+/**
+ * Available Claude models
+ */
+export type Model = 'claude-sonnet-4-5-20250929' | 'claude-opus-4-5-20251101' | 'claude-3-5-sonnet-20241022' | 'claude-3-5-haiku-20241022' | 'claude-3-opus-20240229' | (string & {});
+/**
+ * System prompt configuration
+ */
+export type SystemPrompt = string | {
+    /** Use a preset system prompt */
+    type: 'preset';
+    /** The preset name */
+    preset: 'claude_code';
+    /** Additional text to append to the preset */
+    append?: string;
+};
+/**
+ * Output format configuration for structured outputs
+ */
+export interface OutputFormat {
+    /** Output format type */
+    type: 'json_schema';
+    /** JSON Schema definition for the expected output */
+    schema: Record<string, unknown>;
+}
+/**
+ * Agent definition for sub-agents
+ */
+export interface AgentDefinition {
+    /** Agent name */
+    name: string;
+    /** Agent description */
+    description?: string;
+    /** Model to use for this agent */
+    model?: Model;
+    /** System prompt for this agent */
+    systemPrompt?: SystemPrompt;
+    /** Tools available to this agent */
+    tools?: string[];
+    /** Maximum turns for this agent */
+    maxTurns?: number;
+}
+/**
+ * Base options shared between sessions and prompts
+ */
+export interface BaseOptions {
+    /**
+     * The model to use for generation
+     * @default 'claude-sonnet-4-5-20250929'
+     */
+    model?: Model;
+    /**
+     * Fallback model if primary model is unavailable
+     */
+    fallbackModel?: Model;
+    /**
+     * Maximum number of conversation turns
+     */
+    maxTurns?: number;
+    /**
+     * Maximum budget in USD for this session/prompt
+     */
+    maxBudgetUsd?: number;
+    /**
+     * Maximum thinking tokens (for extended thinking)
+     */
+    maxThinkingTokens?: number;
+    /**
+     * System prompt or preset configuration
+     */
+    systemPrompt?: SystemPrompt;
+    /**
+     * Tool definitions for this session/prompt
+     */
+    tools?: ToolDefinition[];
+    /**
+     * List of tool names that are allowed
+     */
+    allowedTools?: string[];
+    /**
+     * List of tool names that are blocked
+     */
+    disallowedTools?: string[];
+    /**
+     * MCP server definitions
+     */
+    mcpServers?: McpServerDefinition[];
+    /**
+     * Sub-agent definitions
+     */
+    agents?: Record<string, AgentDefinition>;
+    /**
+     * Beta features to enable
+     */
+    betas?: string[];
+    /**
+     * Permission mode for sandbox operations
+     */
+    permissionMode?: 'default' | 'plan' | 'bypassPermissions';
+    /**
+     * Allow dangerous operations (use with caution)
+     */
+    allowDangerouslySkipPermissions?: boolean;
+    /**
+     * Custom environment variables
+     */
+    env?: Record<string, string>;
+    /**
+     * Output format for structured responses
+     */
+    outputFormat?: OutputFormat;
+    /**
+     * Include partial messages in the stream
+     */
+    includePartialMessages?: boolean;
+}
+/**
+ * Session-specific options
+ */
+export interface SessionOptions extends BaseOptions {
+    /**
+     * Session ID for resuming an existing session
+     */
+    sessionId?: string;
+    /**
+     * Fork from an existing session instead of resuming
+     */
+    forkSession?: boolean;
+    /**
+     * Resume session at a specific conversation ID
+     */
+    resumeSessionAt?: string;
+    /**
+     * Continue from where the session left off
+     */
+    continue?: boolean;
+    /**
+     * Settings sources for configuration
+     */
+    settingSources?: Array<'user' | 'project' | 'local'>;
+}
+/**
+ * Prompt-specific options (stateless, one-shot)
+ */
+export interface PromptOptions extends BaseOptions {
+    /**
+     * The prompt message to send
+     */
+    message: string;
+}
+/**
+ * Client configuration options
+ */
+export interface ClientOptions {
+    /**
+     * Base URL for the Chucky service
+     * @default 'wss://box.chucky.cloud'
+     */
+    baseUrl?: string;
+    /**
+     * Authentication token (JWT)
+     */
+    token: string;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+    /**
+     * Connection timeout in milliseconds
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Keep-alive interval in milliseconds
+     * @default 300000 (5 minutes)
+     */
+    keepAliveInterval?: number;
+    /**
+     * Auto-reconnect on disconnect
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Maximum reconnect attempts
+     * @default 5
+     */
+    maxReconnectAttempts?: number;
+}
+/**
+ * Connection status
+ */
+export type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'error';
+/**
+ * Event handlers for client events
+ */
+export interface ClientEventHandlers {
+    /** Called when connection status changes */
+    onStatusChange?: (status: ConnectionStatus) => void;
+    /** Called when a raw message is sent or received (for debugging) */
+    onRawMessage?: (direction: 'in' | 'out', message: unknown) => void;
+    /** Called when an error occurs */
+    onError?: (error: Error) => void;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/types/options.d.ts.map

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

package/dist/types/options.js

@@ -0,0 +1,8 @@
+/**
+ * SDK Options Types
+ *
+ * These types define all configuration options for sessions and prompts.
+ * Designed for both browser and Node.js environments.
+ */
+export {};
+//# sourceMappingURL=options.js.map

package/dist/types/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/results.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Result Types
+ *
+ * Types for responses from sessions and prompts.
+ */
+/**
+ * Message role
+ */
+export type MessageRole = 'user' | 'assistant' | 'system';
+/**
+ * Content block types
+ */
+export type ContentBlockType = 'text' | 'tool_use' | 'tool_result' | 'thinking' | 'image';
+/**
+ * Text content block
+ */
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+/**
+ * Tool use content block
+ */
+export interface ToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Tool result content block
+ */
+export interface ToolResultBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string | Array<{
+        type: 'text';
+        text: string;
+    }>;
+    is_error?: boolean;
+}
+/**
+ * Thinking content block (extended thinking)
+ */
+export interface ThinkingBlock {
+    type: 'thinking';
+    thinking: string;
+}
+/**
+ * Image content block
+ */
+export interface ImageBlock {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    };
+}
+/**
+ * Union type for all content blocks
+ */
+export type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock | ThinkingBlock | ImageBlock;
+/**
+ * A message in the conversation
+ */
+export interface Message {
+    /** Message role */
+    role: MessageRole;
+    /** Message content */
+    content: ContentBlock[] | string;
+}
+/**
+ * Usage statistics
+ */
+export interface Usage {
+    /** Input tokens used */
+    input_tokens: number;
+    /** Output tokens generated */
+    output_tokens: number;
+    /** Cache creation input tokens */
+    cache_creation_input_tokens?: number;
+    /** Cache read input tokens */
+    cache_read_input_tokens?: number;
+}
+/**
+ * Cost breakdown
+ */
+export interface CostBreakdown {
+    /** Input cost in USD */
+    input_cost_usd: number;
+    /** Output cost in USD */
+    output_cost_usd: number;
+    /** Total cost in USD */
+    total_cost_usd: number;
+}
+/**
+ * Session result (returned when session completes)
+ */
+export interface SessionResult {
+    /** Result type */
+    type: 'result';
+    /** Result subtype */
+    subtype?: 'success' | 'error' | 'interrupted';
+    /** Final response text */
+    text?: string;
+    /** Conversation messages */
+    messages?: Message[];
+    /** Total cost in USD */
+    total_cost_usd?: number;
+    /** Session duration in seconds */
+    duration_secs?: number;
+    /** Number of conversation turns */
+    turn_count?: number;
+    /** Usage statistics */
+    usage?: Usage;
+    /** Session ID (for resuming) */
+    session_id?: string;
+    /** Error message (if subtype is 'error') */
+    error?: string;
+}
+/**
+ * Prompt result (returned from one-shot prompts)
+ */
+export interface PromptResult {
+    /** Result type */
+    type: 'result';
+    /** Result subtype */
+    subtype?: 'success' | 'error';
+    /** Response text */
+    text?: string;
+    /** Structured output (if outputFormat was specified) */
+    output?: unknown;
+    /** Total cost in USD */
+    total_cost_usd?: number;
+    /** Duration in seconds */
+    duration_secs?: number;
+    /** Usage statistics */
+    usage?: Usage;
+    /** Error message (if subtype is 'error') */
+    error?: string;
+}
+/**
+ * Streaming message event
+ */
+export interface StreamEvent {
+    /** Event type */
+    type: 'message_start' | 'content_block_start' | 'content_block_delta' | 'content_block_stop' | 'message_delta' | 'message_stop' | 'tool_use' | 'tool_result' | 'error';
+    /** Event data */
+    data: unknown;
+}
+/**
+ * Partial message (during streaming)
+ */
+export interface PartialMessage {
+    /** Message role */
+    role: MessageRole;
+    /** Partial content accumulated so far */
+    content: ContentBlock[];
+    /** Whether the message is complete */
+    complete: boolean;
+}
+/**
+ * Session state
+ */
+export type SessionState = 'idle' | 'initializing' | 'ready' | 'processing' | 'waiting_tool' | 'completed' | 'error';
+/**
+ * Session info (returned when connecting/resuming)
+ */
+export interface SessionInfo {
+    /** Session ID */
+    sessionId: string;
+    /** Current state */
+    state: SessionState;
+    /** Number of messages in conversation */
+    messageCount?: number;
+    /** Session creation time (ISO 8601) */
+    createdAt?: string;
+    /** Last activity time (ISO 8601) */
+    lastActivityAt?: string;
+}
+//# sourceMappingURL=results.d.ts.map