@pathmx/agents

Authored agents for PathMX Plugins. An agent is an .agent.md Actor whose frontmatter names a model and whose Markdown body is its instructions. Requests made as an agent go through @pathmx/ai with the agent's own permissions, and .thread Sources hold conversations whose turns resume after a restart.

bun add @pathmx/agents @pathmx/ai ai

import { createGateway } from "ai"
import { AI } from "@pathmx/ai"
import { Agents } from "@pathmx/agents"

const gateway = createGateway({ apiKey: process.env.AI_GATEWAY_API_KEY })
export const ai = AI({ models: { reviewer: gateway("provider/model-name") } })
export const agents = Agents({ ai })

Install agents.plugin beside the Plugins that use agents. Register agents.turn for thread conversations that resume after a restart: questions can carry stored files, tools can return pictures or run at the provider, and each reply saves its steps as it goes. Core owns execution, Stop and recovery. Keep both packages on the same version as your other PathMX packages. See the Agents reference for authoring agents, threads, turns and durable jobs.