Skip to content

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.

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.yml
index 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@v4
with:
node-version: 20
cache: 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: 20
cache: 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-provider
run: |
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/.gitignore
index 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.json
diff --git a/README.md b/README.md
index 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 dev
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).
-
-## 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.md
new file mode 100644
index 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/.gitignore
similarity index 100%
rename from example-provider/.gitignore
rename to provider/example-provider/.gitignore
diff --git a/example-provider/README.md b/provider/example-provider/README.md
similarity index 100%
rename from example-provider/README.md
rename to provider/example-provider/README.md
diff --git a/example-provider/agents.example.json b/provider/example-provider/agents.example.json
similarity index 100%
rename from example-provider/agents.example.json
rename to provider/example-provider/agents.example.json
diff --git a/example-provider/package-lock.json b/provider/example-provider/package-lock.json
similarity index 100%
rename from example-provider/package-lock.json
rename to provider/example-provider/package-lock.json
diff --git a/example-provider/package.json b/provider/example-provider/package.json
similarity index 73%
rename from example-provider/package.json
rename to provider/example-provider/package.json
index 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.jsonl
similarity index 100%
rename from example-provider/src/__fixtures__/real-turn.jsonl
rename to provider/example-provider/src/__fixtures__/real-turn.jsonl
diff --git a/example-provider/src/agentCard.ts b/provider/example-provider/src/agentCard.ts
similarity index 100%
rename from example-provider/src/agentCard.ts
rename to provider/example-provider/src/agentCard.ts
diff --git a/example-provider/src/claude.ts b/provider/example-provider/src/claude.ts
similarity index 100%
rename from example-provider/src/claude.ts
rename to provider/example-provider/src/claude.ts
diff --git a/example-provider/src/config.ts b/provider/example-provider/src/config.ts
similarity index 100%
rename from example-provider/src/config.ts
rename to provider/example-provider/src/config.ts
diff --git a/example-provider/src/jsonl.spec.ts b/provider/example-provider/src/jsonl.spec.ts
similarity index 100%
rename from example-provider/src/jsonl.spec.ts
rename to provider/example-provider/src/jsonl.spec.ts
diff --git a/example-provider/src/jsonl.ts b/provider/example-provider/src/jsonl.ts
similarity index 100%
rename from example-provider/src/jsonl.ts
rename to provider/example-provider/src/jsonl.ts
diff --git a/example-provider/src/mapper.spec.ts b/provider/example-provider/src/mapper.spec.ts
similarity index 100%
rename from example-provider/src/mapper.spec.ts
rename to provider/example-provider/src/mapper.spec.ts
diff --git a/example-provider/src/mapper.ts b/provider/example-provider/src/mapper.ts
similarity index 100%
rename from example-provider/src/mapper.ts
rename to provider/example-provider/src/mapper.ts
diff --git a/example-provider/src/server.ts b/provider/example-provider/src/server.ts
similarity index 100%
rename from example-provider/src/server.ts
rename to provider/example-provider/src/server.ts
diff --git a/example-provider/src/sessions.ts b/provider/example-provider/src/sessions.ts
similarity index 100%
rename from example-provider/src/sessions.ts
rename to provider/example-provider/src/sessions.ts
diff --git a/example-provider/src/types.ts b/provider/example-provider/src/types.ts
similarity index 100%
rename from example-provider/src/types.ts
rename to provider/example-provider/src/types.ts
diff --git a/example-provider/src/workspace.ts b/provider/example-provider/src/workspace.ts
similarity index 100%
rename from example-provider/src/workspace.ts
rename to provider/example-provider/src/workspace.ts
diff --git a/example-provider/tsconfig.json b/provider/example-provider/tsconfig.json
similarity index 100%
rename from example-provider/tsconfig.json
rename to provider/example-provider/tsconfig.json
diff --git a/reference-provider/README.md b/provider/reference-provider/README.md
similarity index 100%
rename from reference-provider/README.md
rename to provider/reference-provider/README.md
diff --git a/reference-provider/package-lock.json b/provider/reference-provider/package-lock.json
similarity index 100%
rename from reference-provider/package-lock.json
rename to provider/reference-provider/package-lock.json
diff --git a/reference-provider/package.json b/provider/reference-provider/package.json
similarity index 76%
rename from reference-provider/package.json
rename to provider/reference-provider/package.json
index 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.ts
similarity index 100%
rename from reference-provider/src/agentCard.ts
rename to provider/reference-provider/src/agentCard.ts
diff --git a/reference-provider/src/conformance.spec.ts b/provider/reference-provider/src/conformance.spec.ts
similarity index 100%
rename from reference-provider/src/conformance.spec.ts
rename to provider/reference-provider/src/conformance.spec.ts
diff --git a/reference-provider/src/conformance.ts b/provider/reference-provider/src/conformance.ts
similarity index 100%
rename from reference-provider/src/conformance.ts
rename to provider/reference-provider/src/conformance.ts
diff --git a/reference-provider/src/scenarios.ts b/provider/reference-provider/src/scenarios.ts
similarity index 100%
rename from reference-provider/src/scenarios.ts
rename to provider/reference-provider/src/scenarios.ts
diff --git a/reference-provider/src/server.spec.ts b/provider/reference-provider/src/server.spec.ts
similarity index 100%
rename from reference-provider/src/server.spec.ts
rename to provider/reference-provider/src/server.spec.ts
diff --git a/reference-provider/src/server.ts b/provider/reference-provider/src/server.ts
similarity index 100%
rename from reference-provider/src/server.ts
rename to provider/reference-provider/src/server.ts
diff --git a/reference-provider/src/store.ts b/provider/reference-provider/src/store.ts
similarity index 100%
rename from reference-provider/src/store.ts
rename to provider/reference-provider/src/store.ts
diff --git a/reference-provider/src/types.ts b/provider/reference-provider/src/types.ts
similarity index 100%
rename from reference-provider/src/types.ts
rename to provider/reference-provider/src/types.ts
diff --git a/reference-provider/tsconfig.json b/provider/reference-provider/tsconfig.json
similarity index 100%
rename from reference-provider/tsconfig.json
rename to provider/reference-provider/tsconfig.json
diff --git a/spec/README.md b/provider/spec/README.md
similarity index 100%
rename from spec/README.md
rename to provider/spec/README.md
diff --git a/spec/onboarding.md b/provider/spec/onboarding.md
similarity index 97%
rename from spec/onboarding.md
rename to provider/spec/onboarding.md
index 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 touching
credentials or a vulnerability goes to the address in `SECURITY.md` instead — not to the issue
tracker.
diff --git a/spec/schema/agent-card.ext.json b/provider/spec/schema/agent-card.ext.json
similarity index 96%
rename from spec/schema/agent-card.ext.json
rename to provider/spec/schema/agent-card.ext.json
index 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.json
similarity index 100%
rename from spec/schema/ext-session-recap.json
rename to provider/spec/schema/ext-session-recap.json
diff --git a/spec/schema/ext-voice.json b/provider/spec/schema/ext-voice.json
similarity index 100%
rename from spec/schema/ext-voice.json
rename to provider/spec/schema/ext-voice.json
diff --git a/spec/schema/ext-workspace-files.json b/provider/spec/schema/ext-workspace-files.json
similarity index 100%
rename from spec/schema/ext-workspace-files.json
rename to provider/spec/schema/ext-workspace-files.json
diff --git a/spec/schema/ext-workspace-write.json b/provider/spec/schema/ext-workspace-write.json
similarity index 100%
rename from spec/schema/ext-workspace-write.json
rename to provider/spec/schema/ext-workspace-write.json
diff --git a/spec/schema/part-metadata.json b/provider/spec/schema/part-metadata.json
similarity index 100%
rename from spec/schema/part-metadata.json
rename to provider/spec/schema/part-metadata.json