TASKS.md

MiniAgentHarness Roadmap

Starter kit for building test-first, easily deployable AI agents.

---

Completed Tasks

• Scaffolded Poetry project with CLI and stub agent
• Added Pytest plugin, fixtures, and green sample test
• Configured GitHub Actions ci.yml to run test suite
• Reserved package names by publishing mini-agent-harness==0.0.0 to PyPI and NPM
• Flesh out README.md with badges, quick-start guide, and differentiators
• Add GitHub Actions release workflow to publish to PyPI & NPM on version tags
• Bump working version to 0.1.0.dev0 (Python) and 0.1.0-dev (NPM)
• YAML tool registry with auto-import & CLI stub generation
• Implement core ReAct-style agent loop (mini_agent_harness.core.loop)

In Progress Tasks

(nothing at the moment)

Future Tasks

Planned for v0.2.x – Local Serve & Streaming

• mini-agent serve FastAPI server with streaming SSE endpoint
• Streaming LLM responses (chunked) for realtime UI
• Prompt templating with Jinja2 and basic conversation memory

Planned for v0.3.x – Web UI & Testing Harness Upgrades

• React webapp (webapp/) with shadcn/ui chat + playground
• Testing harness Phase 1: DeepEval metrics and Guardrails schema checks
• Robust parsing / error handling for ACTION/ARG/FINAL blocks

Planned for v0.4.x – Cloud Deploy Targets

• One-click Vercel deploy (deploy/vercel.json) and README badge
• Cloudflare Workers edge target via wrangler deploy

Planned for v1.0.0 – Launch Readiness

• Testing harness Phase 2: LangSmith golden conversation replay
• Docs site and launch assets (logo, screenshots, blog post)

Implementation Plan

Phased approach (adapted from 6-week outline):

1. Core agent loop & expanded CLI
2. Testing harness Phase 1 (unit metrics)
3. Web UI skeleton
4. One-click deploy targets (Vercel → CF Workers)
5. Documentation polish & examples

Relevant Files

• mini_agent_harness/cli.py – entry-point for mini-agent CLI ✅
• mini_agent_harness/core/__init__.py – stub Agent + AgentResult ✅
• mini_agent_harness/testing/ – pytest plugin & fixtures ✅
• .github/workflows/ci.yml – CI running test suite ✅
• README.md – currently being updated