The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
Make this the home for Autonomous Harness, with provider as its first section
0xken15b3002d2be2d7
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.ymlindex 4036e381a..007244717 100644--- a/.github/workflows/ci.yml+++ b/.github/workflows/ci.yml@@ -18,14 +18,14 @@ jobs:package: [reference-provider, example-provider]defaults:run:- working-directory: ${{ matrix.package }}+ working-directory: provider/${{ matrix.package }}steps:- uses: actions/checkout@v4- uses: actions/setup-node@v4with:node-version: 20cache: npm- cache-dependency-path: ${{ matrix.package }}/package-lock.json+ cache-dependency-path: provider/${{ matrix.package }}/package-lock.json- run: npm ci- run: npm run typecheck- run: npm test@@ -42,13 +42,13 @@ jobs:with:node-version: 20cache: npm- cache-dependency-path: reference-provider/package-lock.json+ cache-dependency-path: provider/reference-provider/package-lock.json- run: npm ci- working-directory: reference-provider+ working-directory: provider/reference-provider- name: Start the reference provider- working-directory: reference-provider+ working-directory: provider/reference-providerrun: |STEP_DELAY_MS=0 npx tsx src/server.ts &for _ in $(seq 1 60); do@@ -58,7 +58,7 @@ jobs:echo "reference provider did not come up"; exit 1- name: Run the conformance suite- working-directory: reference-provider+ working-directory: provider/reference-provider# The runner exits non-zero on any failure. The two flags unlock the three clauses that need# provider-specific knowledge; without them those report SKIP with a reason, which is correct# but weaker cover than we want on our own reference.diff --git a/.gitignore b/.gitignoreindex 595db8798..b06b66722 100644--- a/.gitignore+++ b/.gitignore@@ -6,5 +6,5 @@ dist/# Per-deployment state, never source:# agents.json names real directories on the machine it runs on# sessions.json maps A2A contextIds to Claude session ids-example-provider/agents.json-example-provider/sessions.json+provider/example-provider/agents.json+provider/example-provider/sessions.jsondiff --git a/README.md b/README.mdindex 4ff8952ad..8921988e8 100644--- a/README.md+++ b/README.md@@ -1,79 +1,40 @@-# Autonomous Harness — Provider Protocol+# Autonomous Harness-Make your agent platform available on the [Autonomous Harness](https://www.autonomous.ai/harness).-A user connects it with a **URL and a credential**, then drives it from the web app or from the-hardware device on their desk.+The [Autonomous Harness](https://www.autonomous.ai/harness) is a device and a service for running+coding agents: one sentence, spoken to a disc on your desk, dispatched to the agents already running+on your laptop, your server, and in the cloud.-**This is a profile of [A2A](https://github.com/a2aproject/A2A) v1.0.1, not a new protocol.** If you-already run a conformant A2A agent, most of it is done. Everything specific to Autonomous is either-standard A2A used as intended, or a declared A2A extension — nothing here forks the standard.+This repository is where the parts other people need to build against are published — specs,+reference implementations, and the tools to check your own work against them.| | ||---|---|-| [`spec/`](spec/README.md) | The contract. 40 numbered clauses (`HP-xxx`) |-| [`spec/onboarding.md`](spec/onboarding.md) | What to do once you conform, and what to expect from us |-| [`reference-provider/`](reference-provider/) | Scripted and deterministic — **and it ships the conformance runner** |-| [`example-provider/`](example-provider/) | A real one, backed by the Claude Code CLI |+| [`provider/`](provider/README.md) | **Provider protocol** — make your own agent platform available on the Harness. Users connect it with a URL and a credential, then drive it from the web app or the device. A profile of [A2A](https://github.com/a2aproject/A2A) v1.0.1, with a reference implementation and a conformance runner |-## Quick start+More will be published here as it stabilises. Each section is self-contained: its own README, its own+packages, its own tests.-See it work before reading the spec:+## Getting started-```bash-cd reference-provider && npm install && npm run dev # http://127.0.0.1:4501-curl localhost:4501/.well-known/agent-card.json-```--Then point the runner at your own endpoint. **Zero failures is the bar:**+Every section stands on its own — start with its README. For the provider protocol:```bash+cd provider/reference-provider && npm install && npm run devnpm run conformance -- --url https://your-endpoint --key <credential>```-It names the clause on every line, so a red result points at a section of the spec rather than at a-symptom:--```-✔ HP-021 capabilities.streaming is true-✖ HP-200 ListTasks filters by contextId- 3 task(s) from another context leaked into the filter-```--## What you actually have to implement--**Tier 0 is all A2A core.** There is no Autonomous-specific work in it at all:--| | Backs |-|---|---|-| Agent Card at `/.well-known/agent-card.json` | capability discovery, and your project list |-| `SendStreamingMessage` → SSE | a turn |-| `CancelTask` | stopping one |-| `ListTasks` · `GetTask` | history |--History is required, not optional: **Autonomous stores no transcript for a provider harness.** Without-those two, a page refresh loses the conversation.--**Everything else is an optional, declared extension** — file browsing, workspace writes, per-turn-recaps, voice routing. An extension you do not declare is simply absent, and the product hides the-feature rather than offering a control that fails.--Two things are deliberately **not** in the profile: model selection (you own your model configuration)-and end-to-end encryption (the plaintext originates on your side; users are told this in our UI).--## Repository--```-spec/ the contract + JSON Schemas-reference-provider/ zero runtime dependencies — readable end to end-example-provider/ a real agent; runs Claude with permissions skipped ⚠ read its README first-```+## Conventions across this repository-Both packages are plain TypeScript on Node ≥ 20 with **no runtime dependencies**. That is on purpose:-you should be able to read `reference-provider/src/server.ts` and know exactly what your own endpoint-has to do.+- **Specs are numbered.** Every normative statement has a stable id, so a failure can point at a+ clause rather than a symptom, and a conformance runner can assert one check per id.+- **Specs are compatibility contracts.** Optional fields may be added; nothing published is renamed,+ removed, retyped or reinterpreted without a new revision served alongside the old one.+- **Reference implementations carry no runtime dependencies.** You should be able to read one end to+ end and know what your own implementation has to do, without installing anything to understand it.## Contributing, security, licence-- Found a gap in the spec, or a clause the runner cannot actually check? [Open an issue](https://github.com/autonomous-ai/harness-provider/issues) — see [CONTRIBUTING.md](CONTRIBUTING.md).+- Gaps in a spec, or a clause its runner cannot actually verify, are the most useful thing to report —+ see [CONTRIBUTING.md](CONTRIBUTING.md).- Security reports: **not the issue tracker** — see [SECURITY.md](SECURITY.md).- Licensed under [Apache-2.0](LICENSE).diff --git a/provider/README.md b/provider/README.mdnew file mode 100644index 000000000..00b4c94c6--- /dev/null+++ b/provider/README.md@@ -0,0 +1,79 @@+# Provider Protocol++Make your agent platform available on the [Autonomous Harness](https://www.autonomous.ai/harness).+A user connects it with a **URL and a credential**, then drives it from the web app or from the+hardware device on their desk.++**This is a profile of [A2A](https://github.com/a2aproject/A2A) v1.0.1, not a new protocol.** If you+already run a conformant A2A agent, most of it is done. Everything specific to Autonomous is either+standard A2A used as intended, or a declared A2A extension — nothing here forks the standard.++| | |+|---|---|+| [`spec/`](spec/README.md) | The contract. 40 numbered clauses (`HP-xxx`) |+| [`spec/onboarding.md`](spec/onboarding.md) | What to do once you conform, and what to expect from us |+| [`reference-provider/`](reference-provider/) | Scripted and deterministic — **and it ships the conformance runner** |+| [`example-provider/`](example-provider/) | A real one, backed by the Claude Code CLI |++## Quick start++See it work before reading the spec:++```bash+cd reference-provider && npm install && npm run dev # http://127.0.0.1:4501+curl localhost:4501/.well-known/agent-card.json+```++Then point the runner at your own endpoint. **Zero failures is the bar:**++```bash+npm run conformance -- --url https://your-endpoint --key <credential>+```++It names the clause on every line, so a red result points at a section of the spec rather than at a+symptom:++```+✔ HP-021 capabilities.streaming is true+✖ HP-200 ListTasks filters by contextId+ 3 task(s) from another context leaked into the filter+```++## What you actually have to implement++**Tier 0 is all A2A core.** There is no Autonomous-specific work in it at all:++| | Backs |+|---|---|+| Agent Card at `/.well-known/agent-card.json` | capability discovery, and your project list |+| `SendStreamingMessage` → SSE | a turn |+| `CancelTask` | stopping one |+| `ListTasks` · `GetTask` | history |++History is required, not optional: **Autonomous stores no transcript for a provider harness.** Without+those two, a page refresh loses the conversation.++**Everything else is an optional, declared extension** — file browsing, workspace writes, per-turn+recaps, voice routing. An extension you do not declare is simply absent, and the product hides the+feature rather than offering a control that fails.++Two things are deliberately **not** in the profile: model selection (you own your model configuration)+and end-to-end encryption (the plaintext originates on your side; users are told this in our UI).++## What is in this section++```+spec/ the contract + JSON Schemas+reference-provider/ zero runtime dependencies — readable end to end+example-provider/ a real agent; runs Claude with permissions skipped ⚠ read its README first+```++Both packages are plain TypeScript on Node ≥ 20 with **no runtime dependencies**. That is on purpose:+you should be able to read `reference-provider/src/server.ts` and know exactly what your own endpoint+has to do.++## Contributing, security, licence++- Found a gap in the spec, or a clause the runner cannot actually check? [Open an issue](https://github.com/autonomous-ai/autonomous-harness/issues) — see [CONTRIBUTING.md](../CONTRIBUTING.md).+- Security reports: **not the issue tracker** — see [SECURITY.md](../SECURITY.md).+- Licensed under [Apache-2.0](../LICENSE).diff --git a/example-provider/.gitignore b/provider/example-provider/.gitignoresimilarity index 100%rename from example-provider/.gitignorerename to provider/example-provider/.gitignorediff --git a/example-provider/README.md b/provider/example-provider/README.mdsimilarity index 100%rename from example-provider/README.mdrename to provider/example-provider/README.mddiff --git a/example-provider/agents.example.json b/provider/example-provider/agents.example.jsonsimilarity index 100%rename from example-provider/agents.example.jsonrename to provider/example-provider/agents.example.jsondiff --git a/example-provider/package-lock.json b/provider/example-provider/package-lock.jsonsimilarity index 100%rename from example-provider/package-lock.jsonrename to provider/example-provider/package-lock.jsondiff --git a/example-provider/package.json b/provider/example-provider/package.jsonsimilarity index 73%rename from example-provider/package.jsonrename to provider/example-provider/package.jsonindex 6a9ef8959..93abc97b3 100644--- a/example-provider/package.json+++ b/provider/example-provider/package.json@@ -5,11 +5,11 @@"license": "Apache-2.0","repository": {"type": "git",- "url": "git+https://github.com/autonomous-ai/harness-provider.git",+ "url": "git+https://github.com/autonomous-ai/autonomous-harness.git","directory": "example-provider"},- "homepage": "https://github.com/autonomous-ai/harness-provider#readme",- "bugs": "https://github.com/autonomous-ai/harness-provider/issues",+ "homepage": "https://github.com/autonomous-ai/autonomous-harness#readme",+ "bugs": "https://github.com/autonomous-ai/autonomous-harness/issues","type": "module","scripts": {"dev": "tsx src/server.ts",diff --git a/example-provider/src/__fixtures__/real-turn.jsonl b/provider/example-provider/src/__fixtures__/real-turn.jsonlsimilarity index 100%rename from example-provider/src/__fixtures__/real-turn.jsonlrename to provider/example-provider/src/__fixtures__/real-turn.jsonldiff --git a/example-provider/src/agentCard.ts b/provider/example-provider/src/agentCard.tssimilarity index 100%rename from example-provider/src/agentCard.tsrename to provider/example-provider/src/agentCard.tsdiff --git a/example-provider/src/claude.ts b/provider/example-provider/src/claude.tssimilarity index 100%rename from example-provider/src/claude.tsrename to provider/example-provider/src/claude.tsdiff --git a/example-provider/src/config.ts b/provider/example-provider/src/config.tssimilarity index 100%rename from example-provider/src/config.tsrename to provider/example-provider/src/config.tsdiff --git a/example-provider/src/jsonl.spec.ts b/provider/example-provider/src/jsonl.spec.tssimilarity index 100%rename from example-provider/src/jsonl.spec.tsrename to provider/example-provider/src/jsonl.spec.tsdiff --git a/example-provider/src/jsonl.ts b/provider/example-provider/src/jsonl.tssimilarity index 100%rename from example-provider/src/jsonl.tsrename to provider/example-provider/src/jsonl.tsdiff --git a/example-provider/src/mapper.spec.ts b/provider/example-provider/src/mapper.spec.tssimilarity index 100%rename from example-provider/src/mapper.spec.tsrename to provider/example-provider/src/mapper.spec.tsdiff --git a/example-provider/src/mapper.ts b/provider/example-provider/src/mapper.tssimilarity index 100%rename from example-provider/src/mapper.tsrename to provider/example-provider/src/mapper.tsdiff --git a/example-provider/src/server.ts b/provider/example-provider/src/server.tssimilarity index 100%rename from example-provider/src/server.tsrename to provider/example-provider/src/server.tsdiff --git a/example-provider/src/sessions.ts b/provider/example-provider/src/sessions.tssimilarity index 100%rename from example-provider/src/sessions.tsrename to provider/example-provider/src/sessions.tsdiff --git a/example-provider/src/types.ts b/provider/example-provider/src/types.tssimilarity index 100%rename from example-provider/src/types.tsrename to provider/example-provider/src/types.tsdiff --git a/example-provider/src/workspace.ts b/provider/example-provider/src/workspace.tssimilarity index 100%rename from example-provider/src/workspace.tsrename to provider/example-provider/src/workspace.tsdiff --git a/example-provider/tsconfig.json b/provider/example-provider/tsconfig.jsonsimilarity index 100%rename from example-provider/tsconfig.jsonrename to provider/example-provider/tsconfig.jsondiff --git a/reference-provider/README.md b/provider/reference-provider/README.mdsimilarity index 100%rename from reference-provider/README.mdrename to provider/reference-provider/README.mddiff --git a/reference-provider/package-lock.json b/provider/reference-provider/package-lock.jsonsimilarity index 100%rename from reference-provider/package-lock.jsonrename to provider/reference-provider/package-lock.jsondiff --git a/reference-provider/package.json b/provider/reference-provider/package.jsonsimilarity index 76%rename from reference-provider/package.jsonrename to provider/reference-provider/package.jsonindex 771909ee1..3fab2624d 100644--- a/reference-provider/package.json+++ b/provider/reference-provider/package.json@@ -5,11 +5,11 @@"license": "Apache-2.0","repository": {"type": "git",- "url": "git+https://github.com/autonomous-ai/harness-provider.git",+ "url": "git+https://github.com/autonomous-ai/autonomous-harness.git","directory": "reference-provider"},- "homepage": "https://github.com/autonomous-ai/harness-provider#readme",- "bugs": "https://github.com/autonomous-ai/harness-provider/issues",+ "homepage": "https://github.com/autonomous-ai/autonomous-harness#readme",+ "bugs": "https://github.com/autonomous-ai/autonomous-harness/issues","type": "module","scripts": {"dev": "tsx src/server.ts",diff --git a/reference-provider/src/agentCard.ts b/provider/reference-provider/src/agentCard.tssimilarity index 100%rename from reference-provider/src/agentCard.tsrename to provider/reference-provider/src/agentCard.tsdiff --git a/reference-provider/src/conformance.spec.ts b/provider/reference-provider/src/conformance.spec.tssimilarity index 100%rename from reference-provider/src/conformance.spec.tsrename to provider/reference-provider/src/conformance.spec.tsdiff --git a/reference-provider/src/conformance.ts b/provider/reference-provider/src/conformance.tssimilarity index 100%rename from reference-provider/src/conformance.tsrename to provider/reference-provider/src/conformance.tsdiff --git a/reference-provider/src/scenarios.ts b/provider/reference-provider/src/scenarios.tssimilarity index 100%rename from reference-provider/src/scenarios.tsrename to provider/reference-provider/src/scenarios.tsdiff --git a/reference-provider/src/server.spec.ts b/provider/reference-provider/src/server.spec.tssimilarity index 100%rename from reference-provider/src/server.spec.tsrename to provider/reference-provider/src/server.spec.tsdiff --git a/reference-provider/src/server.ts b/provider/reference-provider/src/server.tssimilarity index 100%rename from reference-provider/src/server.tsrename to provider/reference-provider/src/server.tsdiff --git a/reference-provider/src/store.ts b/provider/reference-provider/src/store.tssimilarity index 100%rename from reference-provider/src/store.tsrename to provider/reference-provider/src/store.tsdiff --git a/reference-provider/src/types.ts b/provider/reference-provider/src/types.tssimilarity index 100%rename from reference-provider/src/types.tsrename to provider/reference-provider/src/types.tsdiff --git a/reference-provider/tsconfig.json b/provider/reference-provider/tsconfig.jsonsimilarity index 100%rename from reference-provider/tsconfig.jsonrename to provider/reference-provider/tsconfig.jsondiff --git a/spec/README.md b/provider/spec/README.mdsimilarity index 100%rename from spec/README.mdrename to provider/spec/README.mddiff --git a/spec/onboarding.md b/provider/spec/onboarding.mdsimilarity index 97%rename from spec/onboarding.mdrename to provider/spec/onboarding.mdindex 5009d08e7..5600fb94a 100644--- a/spec/onboarding.md+++ b/provider/spec/onboarding.md@@ -88,6 +88,6 @@ harnesses are then marked with a specific reason — never a generic failure.## Questions-Open an issue at <https://github.com/autonomous-ai/harness-provider/issues>. Anything touching+Open an issue at <https://github.com/autonomous-ai/autonomous-harness/issues>. Anything touchingcredentials or a vulnerability goes to the address in `SECURITY.md` instead — not to the issuetracker.diff --git a/spec/schema/agent-card.ext.json b/provider/spec/schema/agent-card.ext.jsonsimilarity index 96%rename from spec/schema/agent-card.ext.jsonrename to provider/spec/schema/agent-card.ext.jsonindex 9aa7b9e38..b7fc17ffd 100644--- a/spec/schema/agent-card.ext.json+++ b/provider/spec/schema/agent-card.ext.json@@ -2,7 +2,7 @@"$schema": "https://json-schema.org/draft/2020-12/schema","$id": "https://harness.autonomous.ai/api/a2a/schema/agent-card.ext.json","title": "Autonomous extension entries in an A2A Agent Card",- "description": "Constrains the `extensions` array of a standard A2A AgentCard to the URIs this profile recognises. Entries with other URIs are permitted and ignored. See HP-022 in harness-provider-a2a.md.",+ "description": "Constrains the `extensions` array of a standard A2A AgentCard to the URIs this profile recognises. Entries with other URIs are permitted and ignored. See HP-022 in the spec (spec/README.md).","type": "object","properties": {"extensions": {diff --git a/spec/schema/ext-session-recap.json b/provider/spec/schema/ext-session-recap.jsonsimilarity index 100%rename from spec/schema/ext-session-recap.jsonrename to provider/spec/schema/ext-session-recap.jsondiff --git a/spec/schema/ext-voice.json b/provider/spec/schema/ext-voice.jsonsimilarity index 100%rename from spec/schema/ext-voice.jsonrename to provider/spec/schema/ext-voice.jsondiff --git a/spec/schema/ext-workspace-files.json b/provider/spec/schema/ext-workspace-files.jsonsimilarity index 100%rename from spec/schema/ext-workspace-files.jsonrename to provider/spec/schema/ext-workspace-files.jsondiff --git a/spec/schema/ext-workspace-write.json b/provider/spec/schema/ext-workspace-write.jsonsimilarity index 100%rename from spec/schema/ext-workspace-write.jsonrename to provider/spec/schema/ext-workspace-write.jsondiff --git a/spec/schema/part-metadata.json b/provider/spec/schema/part-metadata.jsonsimilarity index 100%rename from spec/schema/part-metadata.jsonrename to provider/spec/schema/part-metadata.json