Documentation / @agentick/client / createClient

Function: createClient()

createClient(config): AgentickClient

Defined in: client/src/client.ts:1816

Create a new AgentickClient.

Transport is auto-detected from the URL scheme:

• http:// or https:// -> SSE transport
• ws:// or wss:// -> WebSocket transport

You can also explicitly set the transport in the config, or provide a custom ClientTransport instance (e.g., SharedTransport for multi-tab).

Parameters

config

AgentickClientConfig

Returns

AgentickClient

Example

// Auto-detect transport (SSE for http://)
const client = createClient({
  baseUrl: 'https://api.example.com',
});

// Auto-detect transport (WebSocket for ws://)
const wsClient = createClient({
  baseUrl: 'ws://localhost:18789',
});

// Force WebSocket transport
const wsClient2 = createClient({
  baseUrl: 'http://localhost:3000',
  transport: 'websocket',
});

// Custom transport (e.g., SharedTransport for multi-tab)
import { createSharedTransport } from '@agentick/client-multiplexer';
const sharedClient = createClient({
  baseUrl: 'https://api.example.com',
  transport: createSharedTransport({ baseUrl: 'https://api.example.com' }),
});

// Subscribe to a session
const session = client.subscribe('conv-123');

// Send a message
const handle = session.send({ messages: [{ role: 'user', content: [...] }] });
await handle.result;