General - Sidenet API

Lifecycle

Function	Description
`initSidenet(options)`	Initialize the sidebar (async, call once)
`destroySidenet()`	Remove sidebar completely (async, returns Promise)

Visibility

Function	Description
`toggleSidenet()`	Toggle sidebar visibility
`openSidenet()`	Open the sidebar
`closeSidenet()`	Close the sidebar
`getSidenetState()`	Returns `{ isOpen: boolean, isInitialized: boolean }`
`triggerKeyboardShortcut()`	Programmatically trigger the shortcut action

Send Message Programmatically

Function	Description
`sendMessage(text, options?)`	Send a message programmatically (async)

await sendMessage('Analyze this code', {
  agentId: 'agent-123',                 // Optional: use specific agent
  openSidebar: true,                    // Optional: auto-open sidebar (default: true)
  prompt: 'Respond as a senior staff engineer.', // Optional: one-shot system prompt for this send only
});

Options

Field	Type	Description
`agentId`	`string`	Route this message to a specific agent.
`openSidebar`	`boolean`	Auto-open the sidebar before sending. Defaults to `true`.
`prompt`	`string`	One-shot system prompt prepended to this single request only — same semantics as `text.suggestions[].prompt`. Cleared automatically after the message is sent, so follow-up messages revert to the agent’s normal behaviour.

sendMessage() always starts a new thread for the programmatic message — the active thread is reset before sending. Thread titles are auto-generated by the backend after streaming completes.

Get Agents

Function	Description
`getAgents(copilotId)`	Fetch available agents (async). Uses the live session credential.

import { getAgents } from 'sidenetai-sdk';

// Handy for building a custom picker.
const agents = await getAgents('copilot-456');

To call this before initSidenet() — when there is no live session yet — pass an access token as the second argument.