AgentRPC

AgentRPC is the RPC transport for a locally running Agent. It lets other processes or services access the agent's sessions over a Unix socket or TCP port without going through HTTP.

Only available when you install @downcity/server:

pnpm add @downcity/server

Minimal usage

import { AgentRPC } from "@downcity/server";
import { Agent } from "@downcity/agent";

const agent = new Agent({ id: "demo", path: process.cwd() });
const rpc = new AgentRPC(agent);

const binding = await rpc.listen();
// listening on a random Unix socket or TCP address

Constructor

new AgentRPC(agent: Agent)

Methods

listen(options?)

Start listening for RPC connections.

const binding = await rpc.listen({
  // optional: specify port or socket path
});

Returns AgentRpcBinding containing the connection endpoint info.

close()

Stop the RPC server and release resources.

await rpc.close();

When to use it

• You want another local process to access the same agent sessions
• You are building a local multi-process architecture
• You want a lightweight RPC transport without HTTP overhead

See also: AgentHTTP for the HTTP transport layer.