Vibe first.
Then FastAgent.

// a job, a queue consumer, or a test
import { collect, createPiAgentFromDir } from "@fastagent-sh/fastagent";

const { agent } = await createPiAgentFromDir(".");
const { text } = await collect(
  agent.invoke({ session: "job-42" }, { text: "summarize today's failures" })
);

// app/api/invoke/route.ts
import { createInvokeHandler, createPiAgentFromDir } from "@fastagent-sh/fastagent";

const { agent } = await createPiAgentFromDir(".");

export const POST = createInvokeHandler(agent);
export const runtime = "nodejs";

// app.ts
import { Hono } from "hono";
import { createInvokeHandler, createPiAgentFromDir } from "@fastagent-sh/fastagent";

const { agent } = await createPiAgentFromDir(".");
const invoke = createInvokeHandler(agent);

const app = new Hono();
app.post("/invoke", (c) => invoke(c.req.raw));

export default app;

// app.ts
import express from "express";
import { createInvokeHandler, createPiAgentFromDir, nodeListener } from "@fastagent-sh/fastagent";

const { agent } = await createPiAgentFromDir(".");

const app = express();
app.post("/invoke", nodeListener(createInvokeHandler(agent))); // before any body parser
app.listen(8787);

// src/pages/api/invoke.ts (Node adapter)
import type { APIRoute } from "astro";
import { createInvokeHandler, createPiAgentFromDir } from "@fastagent-sh/fastagent";

export const prerender = false;
const { agent } = await createPiAgentFromDir(".");
const invoke = createInvokeHandler(agent);

export const POST: APIRoute = ({ request }) => invoke(request);

// server/api/invoke.post.ts (Node server)
import { defineEventHandler, toWebRequest } from "h3";
import { createInvokeHandler, createPiAgentFromDir } from "@fastagent-sh/fastagent";

const { agent } = await createPiAgentFromDir(".");
const invoke = createInvokeHandler(agent);

export default defineEventHandler((event) => invoke(toWebRequest(event)));

// src/routes/invoke/+server.ts (adapter-node)
import type { RequestHandler } from "./$types";
import { createInvokeHandler, createPiAgentFromDir } from "@fastagent-sh/fastagent";

const { agent } = await createPiAgentFromDir(".");
const invoke = createInvokeHandler(agent);

export const POST: RequestHandler = ({ request }) => invoke(request);

// server.ts
import Fastify from "fastify";
import { createInvokeHandler, createPiAgentFromDir, nodeListener } from "@fastagent-sh/fastagent";

const { agent } = await createPiAgentFromDir(".");
const listener = nodeListener(createInvokeHandler(agent));
const app = Fastify();

app.register(async (scope) => {
  scope.removeAllContentTypeParsers();
  scope.addContentTypeParser("*", (_req, payload, done) => done(null, payload));
  scope.post("/invoke", (req, reply) => { reply.hijack(); listener(req.raw, reply.raw); });
});
await app.listen({ port: 8787 });

// server.ts
import { createInvokeHandler, createPiAgentFromDir } from "@fastagent-sh/fastagent";

const { agent } = await createPiAgentFromDir(".");
const invoke = createInvokeHandler(agent);

Bun.serve({
  port: 8787,
  fetch(req) {
    const url = new URL(req.url);
    return url.pathname === "/invoke" ? invoke(req) : new Response("not found", { status: 404 });
  },
});

// server.ts — the whole service, including channels and schedules
import { createAgentService, serveNode } from "@fastagent-sh/fastagent";

const service = await createAgentService(".");
const server = serveNode(service.handler, { port: 8787 });
await Promise.all([service.ready, server.listening]);

// On application shutdown, await service.close() and server.close().