@mcoda/agents

@mcoda/agents

Agent registry, adapter wiring, and invocation helpers for mcoda.

Install

• Requires Node.js >= 20.
• Install: npm i @mcoda/agents

What it provides

• AgentService for resolving agents, prompts, capabilities, and secrets.
• Adapter interfaces (AgentAdapter, InvocationRequest/InvocationResult).
• Built-in adapters for OpenAI, Claude, Codex, Gemini, Ollama, Zhipu, local models, and QA.

Example

import { AgentService } from "@mcoda/agents";

const service = await AgentService.create();
const agent = await service.resolveAgent("codex");
const adapter = await service.getAdapter(agent);
const result = await adapter.invoke?.({ input: "Summarize this repo." });

if (result) {
  console.log(result.output);
}

await service.close();

Notes

• Primarily used by the mcoda CLI; APIs may evolve.
• Set MCODA_STREAM_IO=1 to emit adapter I/O lines to stderr.
• If ~/.docdex/agents.md exists, AgentService prepends it to every agent invocation.

License

MIT - see LICENSE.