Local

Webhook
Deployment

The local adapter is an in-process transport for tests, embedding, and development tools. It does not open a network listener.

import { local, runHeypi } from "@hunvreus/heypi";

const chat = local();
const app = await runHeypi(agent, [chat]);

await chat.receive({
	id: "message-1",
	user: { id: "developer", name: "Developer" },
	text: "Inspect the workspace.",
});

console.log(chat.sent);
await app.stop();

Local messages default to conversation local, dm: true, and mentioned: true. Supply stable conversation, session, thread, or reply IDs to test routing behavior.

The adapter stores outbound messages in sent and supports updates for todo rendering. It uses shared busy and todo event defaults but has no native typing, status, attachment download, or interactive approval UI.

Use the local adapter only within a trusted process. It does not authenticate callers or create a sandbox; execution safety comes from the agent runtime.