Skip to content

phuryn/product-engineering / app-stack/skills/embedded-agents-messages-api

embedded-agents-messages-api

Verified

Building, adding or wiring up an agent or an agent chat inside a Next.js app: embed Claude agents on the Messages API, the default way.

templates/route.ts

View on GitHub
import { z } from 'zod';
import { askAgent, listAgents } from '@/lib/agent';

// GET lists the agents (their directory names); POST streams one agent's answer as
// server-sent events. The agent is chosen per request: nothing here names one.

// The file tools read the disk and a stdio MCP server is a child process: never the edge runtime.
export const runtime = 'nodejs';
export const dynamic = 'force-dynamic';

const Body = z.object({
  agent: z.string().regex(/^[a-z0-9][a-z0-9-]*$/),
  prompt: z.string().trim().min(1).max(4000),
  history: z.array(z.object({ role: z.enum(['user', 'assistant']), content: z.string().max(8000) })).max(20).default([]),
});

export function GET() {
  return Response.json({ agents: listAgents() });
}

export async function POST(req: Request) {
  // A mutation from another origin is refused: a cross-site form or script must not spend the caller's budget.
  const origin = req.headers.get('origin');
  if (origin && new URL(origin).host !== req.headers.get('host')) return new Response('Forbidden', { status: 403 });
  // Every call spends money. Before anyone but the developer can reach
  // this route, resolve the caller here and apply a per-actor limit and a maxBudgetUsd.
  const parsed = Body.safeParse(await req.json().catch(() => null));
  if (!parsed.success || !listAgents().includes(parsed.data.agent)) {
    return Response.json({ error: 'invalid request' }, { status: 400 });
  }
  const { agent, prompt, history } = parsed.data;

  const enc = new TextEncoder();
  const stream = new ReadableStream<Uint8Array>({
    async start(controller) {
      const send = (data: unknown) => controller.enqueue(enc.encode(`data: ${JSON.stringify(data)}\n\n`));
      try {
        for await (const ev of askAgent({ agent, prompt, history })) {
          if (ev.type === 'text') send({ text: ev.text });
          if (ev.type === 'done') send({ done: true, agent, metadata: ev.metadata });
          if (ev.type === 'error') send({ error: ev.subtype, agent });
        }
      } catch (err) {
        // Log ids, never bodies: the prompt is the caller's text and stays out of the log.
        console.error('agent run failed', { agent, message: err instanceof Error ? err.message : String(err) });
        send({ error: 'failed', agent });
      } finally {
        controller.close();
      }
    },
  });

  return new Response(stream, {
    headers: { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache, no-transform' },
  });
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall