Signals

1
import { tool, StopResponse } from '@signalwire/sdk/livewire';
2
3
const endCall = tool({
4
  description: 'End the current call.',
5
  parameters: { reason: { type: 'string' } },
6
  execute: (params) => {
7
    // Perform cleanup...
8
    throw new StopResponse(`Call ended: ${params.reason}`);
9
  },
10
});

1
new StopResponse(message?: string)

1
import { tool, ToolError } from '@signalwire/sdk/livewire';
2
3
const transferFunds = tool<{ amount: number; toAccount: string }>({
4
  description: 'Transfer funds to another account.',
5
  parameters: {
6
    amount: { type: 'number' },
7
    toAccount: { type: 'string' },
8
  },
9
  execute: (params) => {
10
    if (params.amount <= 0) {
11
      throw new ToolError('Amount must be positive.');
12
    }
13
    return `Transferred $${params.amount} to ${params.toAccount}.`;
14
  },
15
});

1
new ToolError(message: string)

1
import { Agent, handoff, tool } from '@signalwire/sdk/livewire';
2
3
const billingAgent = new Agent({
4
  instructions: 'You handle billing questions.',
5
});
6
7
const transferToBilling = handoff({
8
  agent: billingAgent,
9
  returns: 'Transferred to billing department.',
10
});

1
function handoff(options: { agent: Agent; returns?: string }): AgentHandoff

1
import { llm } from '@signalwire/sdk/livewire';
2
3
const chat = new llm.ChatContext();
4
chat.append({ role: 'system', text: 'You are a helpful agent.' });

1
append(options: { role?: string; text?: string }): this