anvia-agent

Files (6)

• SKILL.md
• agent-options.md · references/
• providers.md · references/
• teams.md · references/
• tools.md · references/
• check-agent.sh · scripts/

SKILL.md (first lines)

# Anvia Agent Skill

Use this skill when the user wants to build or change an Anvia agent: defining
tools, configuring the `Agent`, handling approvals and streaming, adding memory,
composing specialists, or wiring a provider model.

For work that must survive process restarts, use the `anvia-durable` skill for runtime
submission, owned subagents, and recovery policies. Ordinary streaming, teams, and memory
do not provide durable execution checkpoints.

## Process

1. Define tools first (`references/tools.md`) — zod schemas, approvals.
2. Create the `Agent` (`references/agent-options.md`) — smallest option set that works.
3. Wire the provider model (`references/providers.md`) — keep vendor SDKs in provider packages.
4. Compose specialists when needed (`references/teams.md`) — subagents as tools, or `AgentTeam`.
5. Run `scripts/check-agent.sh` from the app root before claiming done.

## Minimal slice

```ts
import { Agent } from "@anvia/core/agent";
import { createTool } from "@anvia/core/tool";
import { OpenAIClient } from "@anvia/openai";
import { z } from "zod";

const addTool = createTool({
  name: "add",
  description: "Add two numbers together.",
  inputSchema: z.object({
    x: z.number().describe("The first number."),
    y: z.number().describe("The second number."),
  }),
  outputSchema: z.number(),
  execute: (args) => args.x + args.y,
});

const client = new OpenAIClient({
  baseUrl: process.env.OPENAI_BASEURL,
  apiKey: process.env.OPENAI_API_KEY ?? "",
});
const agent = new Agent({
  id: "agent",
  model: client.completionModel({ modelId: "gpt-6-astra", api: "responses" }),
  instructions: "You are a concise assistant. Use tools when useful.",
  maxTurns: 2,
  tools: [addTool],
});

const response = await agent.generate({ prompt: "What is 12 + 30? Use the add tool." });
if (response.type !== "response") throw new Error("Unexpected tool approval request.");
console.log(response.output);
```

## Output

Prefer one agent, few tools, explicit zod schemas. Point to the relevant
reference file instead of pasting its contents into chat.

From anvia-hq/anvia, MIT.

More from anvia-hq/anvia