{"id":50776353,"url":"https://github.com/wtthornton/agentforge-echo-plugin","last_synced_at":"2026-06-12T00:01:46.064Z","repository":{"id":363853578,"uuid":"1221125020","full_name":"wtthornton/agentforge-echo-plugin","owner":"wtthornton","description":"Canonical test rig for AgentForge's plugin system. Deterministic, zero-dep — the pre-release smoke gate.","archived":false,"fork":false,"pushed_at":"2026-06-10T15:54:47.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T17:22:23.975Z","etag":null,"topics":["agentforge","plugin","testing"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wtthornton.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-25T19:35:27.000Z","updated_at":"2026-06-10T16:00:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/wtthornton/agentforge-echo-plugin","commit_stats":null,"previous_names":["wtthornton/agentforge-echo-plugin"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/wtthornton/agentforge-echo-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtthornton%2Fagentforge-echo-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtthornton%2Fagentforge-echo-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtthornton%2Fagentforge-echo-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtthornton%2Fagentforge-echo-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wtthornton","download_url":"https://codeload.github.com/wtthornton/agentforge-echo-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtthornton%2Fagentforge-echo-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34222709,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentforge","plugin","testing"],"created_at":"2026-06-12T00:01:45.390Z","updated_at":"2026-06-12T00:01:46.057Z","avatar_url":"https://github.com/wtthornton.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# agentforge-echo-plugin\n\nThe canonical **test rig** for AgentForge's plugin system. Filed as [TAP-753](https://linear.app/tappscodingagents/issue/TAP-753); published to GitHub and wired into AgentForge CI under [TAP-754](https://linear.app/tappscodingagents/issue/TAP-754).\n\nThis plugin does nothing useful in production. Its only job is to exercise every plugin-system hook point — entry-point discovery, `register(app)` callback, route mounting, agent discovery, event bus — **deterministically, with zero external dependencies**. When this plugin's smoke test breaks, the plugin system broke.\n\n## What it proves works\n\n| Hook | How |\n|------|-----|\n| `[project.entry-points.\"agentforge.plugins\"]` discovery | `pyproject.toml` declares `echo = \"agentforge_echo\"` |\n| `register(app)` entry-point | `agentforge_echo.plugin:register` mounts the router |\n| Route mounting | `GET /api/echo/status`, `POST /api/echo/echo` |\n| `plugin.json` manifest | served back via `GET /api/plugins` on the host |\n| Agent discovery via `AgentLoader.load_external()` | `echo-agent` under `project.echo` namespace |\n| Namespace enforcement | agent namespace `project.echo.echo-agent` validated on load |\n| TopicBus event publish | `POST /api/echo/echo` emits `EchoEvent` on `project.echo.echoed` |\n| Deterministic runner | `EchoRunner.run(s) == s[::-1]` — no LLM, no network |\n\n## Install\n\n```bash\nuv pip install -e /path/to/agentforge-echo-plugin\n```\n\nThen, against a running AgentForge:\n\n```bash\ncurl -XPOST http://127.0.0.1:8001/api/plugins/register \\\n  -H 'content-type: application/json' \\\n  -d '{\"package_name\":\"agentforge-echo-plugin\"}'\n```\n\n## Verify\n\n```bash\ncurl http://127.0.0.1:8001/api/echo/status\n# → {\"status\":\"ok\",\"plugin\":\"echo\",\"version\":\"1.0.0\"}\n\ncurl -XPOST http://127.0.0.1:8001/api/echo/echo \\\n  -H 'content-type: application/json' \\\n  -d '{\"msg\":\"hello\"}'\n# → {\"echoed\":\"hello\",\"reversed\":\"olleh\"}\n\ncurl http://127.0.0.1:8001/api/plugins/echo/agents\n# → { \"plugin_id\":\"echo\", \"agents\":[{\"name\":\"echo-agent\", ...}] }\n```\n\n## Run plugin-side tests\n\n```bash\ncd /path/to/agentforge-echo-plugin\nuv sync\nuv run pytest\n```\n\n## Guarantee\n\n**This plugin will pass in any dev environment with no network access.** If it doesn't, the plugin system regressed — not your environment.\n\n## Not covered (intentionally)\n\n- Frontend module federation (`remote_url` is empty — manifest is served, but no JS bundle exists to load)\n- Credential-vault integration (echo has no credentials)\n- LLM-in-loop behaviours (would break determinism)\n\nThese belong in dedicated rigs when their smoke becomes worth writing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtthornton%2Fagentforge-echo-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwtthornton%2Fagentforge-echo-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtthornton%2Fagentforge-echo-plugin/lists"}