Your always-on AI coworkers that move between text, calls, and Slack.
TypeScript
import { IntelligenceAgent } from '@copilotkit/core';
import type { Message } from '@ag-ui/core';
import { randomUUID } from 'node:crypto';
import { z } from 'zod';
import { voiceReceiptMessagePrefix } from '../shared/voice-receipt.js';
import { scheduledTaskMessagePrefix } from '../shared/scheduled-message.js';
export function currentTurnText(messages: Message[], error?: Error): string {
if (error) throw error;
const content = messages
.filter((message) => message.role === 'assistant')
.at(-1)?.content;
if (typeof content !== 'string' || !content.trim())
throw new Error('The current compute turn returned no assistant response.');
return content;
}
const runtimeInfoSchema = z.object({
mode: z.literal('intelligence'),
intelligence: z.object({ wsUrl: z.url() }),
agents: z.record(z.string(), z.unknown()),
});
export async function runThreadTurn(
runtimeUrl: string,
headers: Record<string, string>,
dotId: string,
threadId: string,
prompt: string,
signal: AbortSignal,
metadata?: Record<string, unknown>,
): Promise<string> {
signal.throwIfAborted();
const response = await fetch(`${runtimeUrl}/info`, { headers, signal });
if (!response.ok)
throw new Error(`Intelligence runtime returned HTTP ${response.status}.`);
const info = runtimeInfoSchema.parse(await response.json());
if (!Object.hasOwn(info.agents, dotId))
throw new Error('The selected Dot is unavailable in the runtime.');
// Core's runtime discovery is browser-only. Use the SDK's Node-compatible
// Intelligence agent for voice compute and scheduled server turns.
const agent = new IntelligenceAgent({
url: info.intelligence.wsUrl,
runtimeUrl,
agentId: dotId,
headers,
fetch: (input, init) =>
fetch(input, {
...init,
signal: init?.signal ? AbortSignal.any([signal, init.signal]) : signal,
}),
});
agent.threadId = threadId;
let runError: Error | undefined;
const subscription = agent.subscribe({
onRunErrorEvent: ({ event }) => {
runError = new Error(event.message);
},
});
const stop = () => agent.abortRun();
signal.addEventListener('abort', stop, { once: true });
try {
signal.throwIfAborted();
const idPrefix =
metadata?.opendotsSource === 'voice_receipt'
? voiceReceiptMessagePrefix
: metadata?.opendotsSource === 'scheduled_task'
? scheduledTaskMessagePrefix
: '';
agent.addMessage({
id: `${idPrefix}${randomUUID()}`,
role: 'user',
content: prompt,
...(metadata ? { metadata } : {}),
});
const result = await agent.runAgent();
signal.throwIfAborted();
return currentTurnText(result.newMessages, runError);
} finally {
signal.removeEventListener('abort', stop);
subscription.unsubscribe();
await agent.detachActiveRun();
}
}