npm install @chucky.cloud/sdk

import { ChuckyClient, createClient, getAssistantText } from '@chucky.cloud/sdk';

const client = new ChuckyClient(options: ClientOptions);

const client = new ChuckyClient({
  token: 'your-jwt-token',
  debug: true,
});

async prompt(message: string, options?: SessionOptions): Promise<SDKResultMessage>

const result = await client.prompt(
  'What is 2 + 2?',
  { model: 'claude-sonnet-4-5-20250929' }
);

if (result.subtype === 'success') {
  console.log(result.result); // "4"
  console.log(result.total_cost_usd); // 0.0001
}

createSession(options?: SessionOptions): Session

const session = client.createSession({
  model: 'claude-sonnet-4-5-20250929',
  systemPrompt: 'You are a helpful assistant.',
});

await session.send('Hello!');
for await (const msg of session.stream()) {
  if (msg.type === 'assistant') {
    console.log(getAssistantText(msg));
  }
}

session.close();

resumeSession(
  sessionId: string,
  options?: Omit<SessionOptions, 'sessionId'>
): Session

const session = client.resumeSession('session-123');

await session.send('What did we discuss before?');
for await (const msg of session.stream()) {
  // handle messages
}

close(): void

// Clean up when done
client.close();

on(handlers: ClientEventHandlers): this

function createClient(options: ClientOptions): ChuckyClient

const client = createClient({ token: 'your-token' });

import { getAssistantText } from '@chucky.cloud/sdk';

const text = getAssistantText(msg);

import { getResultText } from '@chucky.cloud/sdk';

const text = getResultText(msg);

import { ChuckyClient, tool, getAssistantText } from '@chucky.cloud/sdk';

// Create client
const client = new ChuckyClient({
  token: process.env.CHUCKY_TOKEN,
  debug: true,
});

// Define a tool
const calculatorTool = tool(
  'calculate',
  'Perform math calculations',
  {
    type: 'object',
    properties: {
      expression: { type: 'string' },
    },
    required: ['expression'],
  },
  async ({ expression }) => {
    const result = eval(expression); // Use a proper math lib in production
    return { content: [{ type: 'text', text: String(result) }] };
  }
);

// Create a session with tools
const session = client.createSession({
  model: 'claude-sonnet-4-5-20250929',
  systemPrompt: 'You are a math tutor.',
  tools: [calculatorTool],
});

// Send message and stream response
await session.send('What is 15% of 230?');
for await (const msg of session.stream()) {
  if (msg.type === 'assistant') {
    const text = getAssistantText(msg);
    if (text) process.stdout.write(text);
  }
  if (msg.type === 'result' && msg.subtype === 'success') {
    console.log('\nCost:', msg.total_cost_usd);
  }
}

// Multi-turn conversation
await session.send('Explain how you calculated that');
for await (const msg of session.stream()) {
  if (msg.type === 'assistant') {
    console.log(getAssistantText(msg));
  }
}

// Clean up
session.close();
client.close();