AI & agents

Definitions

Patties exposes:

• agent and tool config types
• job config types
• defineAgent()
• defineTool()
• defineJob()
• generateAgentsMd
• AI runtime helpers under patties/ai

App layout

The current repository fixtures show the intended layout:

• app/agents/ for agent definitions
• app/tools/ for callable tools
• app/jobs/ for scheduled jobs

Core types

• AgentConfig defines the model, tools, triggers, and token settings
• ToolConfig defines description, Zod input schema, and handler
• JobConfig defines the cron schedule, timezone, and handler
• AiContext provides request identity, optional user state, variables, and an Anthropic-like client

Discovery

Build-time scanning collects modules from agents, tools, and jobs directories. Missing directories are allowed, and test files are ignored.

During patties build and patties dev, Patties attempts to regenerate the root AGENTS.md file from the app definition so downstream tools can inspect routes, agents, tools, jobs, and middleware.