Client command API

diosc() is the global command function the widget installs. Call it with a command name and its arguments. Calls made before the widget finishes loading are queued and replayed in order.

import { loadDiosc } from '@dioschub/client';
const { diosc } = loadDiosc({ backendUrl: 'https://your-hub.example.com', apiKey: 'YOUR_EMBED_KEY' });
diosc('open');

Types referenced below are exported from @dioschub/client.

Configuration

Command	Description
`diosc('config', config: DioscConfig)`	Apply configuration. See `DioscConfig`.
`diosc('bindHeaders', factory \| null)`	Provide extra headers for the host bind endpoint. The factory runs on every bind cycle (sync or async). `null` clears it.

Tools & host surfaces

Command	Description
`diosc('tool', name: string, handler)`	Register a browser tool the assistant may call.
`diosc('browserAdapter', adapter \| null)`	Declare the host’s browser-intent surface. `null` clears it.
`diosc('mentionProvider', query \| null)`	Register an `@`-mention resolver. `null` clears it. See Composer mentions.
`diosc('consensusView', pattern: string \| RegExp, descriptor \| null)`	Render the consensus dialog’s detail body for matching tools. Returns an unregister function. See Consensus views.

Context & messaging

Command	Description
`diosc('observe', 'navigation', observer)`	Feed the assistant page context on every route change.
`diosc('invoke', input: string, pageContext?): Promise<void>`	Send a message programmatically, with optional page context.

Events

Command	Description
`diosc('on', event, handler): Unsubscribe`	Subscribe to one event. See Web component API → Events.
`diosc('onAny', handler): Unsubscribe`	Subscribe to every event; the handler receives `(event, payload)`.

Connection

Command	Description
`diosc('connect'): Promise<void>`	Open the connection.
`diosc('disconnect')`	Close the connection.
`diosc('reauth')`	Re-run the host bind flow on the live connection; call after host auth state changes, e.g. an anonymous visitor signs in. No-op when not connected.
`diosc('fetchAssistantConfig'): Promise<void>`	Refetch the assistant’s configuration.

Command	Description
`diosc('open')`	Expand the panel.
`diosc('close')`	Collapse to the launcher.
`diosc('toggle')`	Flip between open and closed.
`diosc('setPosition', 'bottom-left' \| 'bottom-right')`	Anchor the launcher to a corner. See Widget placement.

Approvals

Approval decisions are not global commands: there is no diosc('approve'). A global approve would let any script on the host page auto-approve the assistant’s actions, which the consensus model exists to prevent. The built-in consensus dialog resolves every approval, and there is no host-rendered alternative at any tier. You can restyle the dialog’s detail body per tool with diosc('consensusView', …) — that surface reports field edits but carries no verdict channel.

Stream control

Command	Description
`diosc('cancelStream')`	Stop the in-progress response.

Sessions

Command	Description
`diosc('fetchSessionList', options?: { limit?, cursor? })`	Load the session list over the socket.
`diosc('fetchSessionListViaREST', options?: { limit?, cursor?, status? }): Promise<void>`	Load the session list over REST.
`diosc('searchSessions', options: { query, limit?, status? }): Promise<void>`	Search sessions.
`diosc('clearSessionSearch'): Promise<void>`	Clear an active session search.
`diosc('loadSession', sessionId: string)`	Open a session by id.
`diosc('startNewSession')`	Start a new session.
`diosc('renameSession', sessionId: string, name: string)`	Rename a session.
`diosc('pinSession', sessionId: string, isPinned: boolean)`	Pin or unpin a session.

DioscConfig

The object passed to diosc('config', …). All fields are optional.

Field	Type	Description
`backendUrl`	`string`	Backend URL for the WebSocket/REST connection.
`apiKey`	`string`	Embed key.
`assistantId`	`string`	Assistant ID. Auto-detected from the config fetch if omitted.
`bindEndpoint`	`string`	Your host endpoint that authenticates the user and forwards identity to DioscHub’s `/auth/bind`. The widget POSTs `{ wsId }` to it with credentials. See Identity & auth.
`verbose`	`boolean`	Verbose logging.
`autoConnect`	`boolean`	Connect automatically on initialization.
`reconnectAttempts`	`number`	Number of reconnection attempts.
`reconnectDelay`	`number`	Reconnection delay (ms).
`reconnectDelayMax`	`number`	Maximum reconnection delay (ms).
`connectionTimeout`	`number`	Connection timeout (ms).