HarnessRouter Community Edition: the self-hosted, Apache-2.0 edition of the unified interface for agent harnesses. Run Codex, Claude Code, Hermes, PI, DSH, and more through one API, with sessions, streaming, files, cancellation, and failure handling. Implements the Unified Harness Protocol (UHP), an open standard. Your keys, your infrastructure.
Python agent-apiagent-frameworkagent-harnessai-agentsai-infrastructurecoding-agentconformance-testingdeepseek-harnessharness-engineeringhermesllmopen-protocolopen-sourceopen-standardpi-coding-agentself-hosteduhpunified-apiunified-harness-protocolunified-interface
UHP 2026-10-04: a memory's id is opaque (#387)
github-actions[bot]aa545751ba52
diff --git a/protocol/CHANGELOG.md b/protocol/CHANGELOG.mdindex 84726f39..53c3a270 100644--- a/protocol/CHANGELOG.md+++ b/protocol/CHANGELOG.md@@ -23,6 +23,12 @@ Suite `2026.10.4.post1`: ME-02 expects the list, ME-09 exercises parts, order, rpart kept with its description and read back byte for byte, or refused, as the provider declares.No implementation had shipped against the morning's text.+**Second patch of 2026-10-04, same version.** A memory's `id` is opaque. The schema had required+the `hmem_` prefix, which a server whose memories are a tree it already keeps (its own workspaces,+its own folders) could meet only with a second id space and a lookup between the two. `hmem_`+remains the prefix of a server that mints its own ids. Schema: the pattern is gone from `Memory.id`,+the path parameter and a harness's entry. Suite `2026.10.4.post2`: ME-01 no longer asserts the prefix.+- **Memories** ([Memories](versions/2026-10-04/memories.md)), the Harness Memories sub-protocol,optional at every class behind the `memories` capability. A memory is a named node in a tree:it holds records and may have child memories. A grant gives a principal privileges (`read`,diff --git a/protocol/conformance/pyproject.toml b/protocol/conformance/pyproject.tomlindex f9f5624e..b52f9830 100644--- a/protocol/conformance/pyproject.toml+++ b/protocol/conformance/pyproject.toml@@ -1,6 +1,6 @@[project]name = "uhp-conformance"-version = "2026.10.4.post1"+version = "2026.10.4.post2"description = "Conformance suite for the Unified Harness Protocol (UHP)"readme = "README.md"requires-python = ">=3.10"diff --git a/protocol/conformance/uhp_conformance/checks.py b/protocol/conformance/uhp_conformance/checks.pyindex 64c9199e..5c93d1c5 100644--- a/protocol/conformance/uhp_conformance/checks.py+++ b/protocol/conformance/uhp_conformance/checks.py@@ -2028,7 +2028,7 @@ def me01(ctx):root, child = ctx.state["memory_root"], _memory_child(ctx)ctx.validate(root, "Memory")ctx.validate(child, "Memory")- assert str(root.get("id") or "").startswith("hmem_"), f"id {root.get('id')!r} does not carry the hmem_ prefix"+ assert str(root.get("id") or "").strip(), "a memory must carry an id"assert child.get("parent_id") == root["id"] and child.get("ancestors") == [root["id"]], (f"the child must name its parent and its ancestors root first; got parent_id={child.get('parent_id')!r} ancestors={child.get('ancestors')!r}")assert child.get("provider") == root.get("provider"), "a child created without a provider must take its parent's"@@ -2036,7 +2036,7 @@ def me01(ctx):f"whoever creates a memory holds all four privileges on it; got {root.get('privileges')!r}")kids = (ctx.client.get(f"/v1/memories?parent={root['id']}").json or {}).get("data") or []assert [k.get("id") for k in kids] == [child["id"]], f"the listing of a parent is its direct children; got {[k.get('id') for k in kids]}"- r = ctx.client.get("/v1/memories/hmem_" + "0" * 32)+ r = ctx.client.get("/v1/memories/" + "uhp-conformance-no-such-memory-" + uuid.uuid4().hex)assert r.status == 404 and ((r.json or {}).get("error") or {}).get("code") == "memory_not_found", (f"an unknown memory must answer 404 memory_not_found; got HTTP {r.status}")return f"{root['id']} > {child['id']} on provider {root.get('provider')!r}"diff --git a/protocol/conformance/uhp_conformance/uhp-2026-10-04.schema.json b/protocol/conformance/uhp_conformance/uhp-2026-10-04.schema.jsonindex d26782e3..3d38dc9e 100644--- a/protocol/conformance/uhp_conformance/uhp-2026-10-04.schema.json+++ b/protocol/conformance/uhp_conformance/uhp-2026-10-04.schema.json@@ -1962,7 +1962,7 @@"properties": {"id": {"type": "string",- "pattern": "^hmem_"+ "description": "Opaque to a client. A server that maps a tree it already has keeps that tree's own ids."},"object": {"type": "string",@@ -3098,8 +3098,7 @@],"properties": {"memory_id": {- "type": "string",- "pattern": "^hmem_"+ "type": "string"},"access": {"type": "string",diff --git a/protocol/schema/uhp-2026-10-04.openapi.yaml b/protocol/schema/uhp-2026-10-04.openapi.yamlindex f390a9ea..fa4b0e27 100644--- a/protocol/schema/uhp-2026-10-04.openapi.yaml+++ b/protocol/schema/uhp-2026-10-04.openapi.yaml@@ -1584,7 +1584,7 @@ components:name: memory_idin: pathrequired: true- schema: { type: string, pattern: '^hmem_' }+ schema: { type: string }MemoryRecordId:name: record_idin: path@@ -2629,7 +2629,7 @@ components:type: objectrequired: [id, name, privileges]properties:- id: { type: string, pattern: '^hmem_' }+ id: { type: string, description: 'Opaque to a client. A server that maps a tree it already has keeps that tree''s own ids.' }object: { type: string, const: memory }name: { type: string }description: { type: string, description: What this memory holds; an agent reads it to decide whether to look inside. }@@ -2978,7 +2978,7 @@ components:type: objectrequired: [memory_id]properties:- memory_id: { type: string, pattern: '^hmem_' }+ memory_id: { type: string }access: { type: string, enum: [read, write] }default: { type: boolean, description: 'Where observe and an unaddressed remember go: one entry at most, and one the agent writes.' }HarnessMemories:diff --git a/protocol/schema/uhp-2026-10-04.schema.json b/protocol/schema/uhp-2026-10-04.schema.jsonindex d26782e3..3d38dc9e 100644--- a/protocol/schema/uhp-2026-10-04.schema.json+++ b/protocol/schema/uhp-2026-10-04.schema.json@@ -1962,7 +1962,7 @@"properties": {"id": {"type": "string",- "pattern": "^hmem_"+ "description": "Opaque to a client. A server that maps a tree it already has keeps that tree's own ids."},"object": {"type": "string",@@ -3098,8 +3098,7 @@],"properties": {"memory_id": {- "type": "string",- "pattern": "^hmem_"+ "type": "string"},"access": {"type": "string",diff --git a/protocol/versions/2026-10-04/architecture.md b/protocol/versions/2026-10-04/architecture.mdindex e1534959..50fdda0f 100644--- a/protocol/versions/2026-10-04/architecture.md+++ b/protocol/versions/2026-10-04/architecture.md@@ -74,7 +74,7 @@ type-distinguishing prefix so an identifier is never ambiguous about what it poi| File | `file` | `file_` | With its container || Container | `container` | `cntr_` | With its session || Environment | `environment` | `henv_` | Until deleted; optional, see [Environments](environments.md) |-| Memory | `memory` | `hmem_` | Until deleted; optional, see [Memories](memories.md) |+| Memory | `memory` | `hmem_`, or the id of the tree a server maps | Until deleted; optional, see [Memories](memories.md) || Event | *(none — events carry `type`)* | — | Streamed, and replayable |Their relationships:diff --git a/protocol/versions/2026-10-04/memories.md b/protocol/versions/2026-10-04/memories.mdindex 160ab5dd..dca40e58 100644--- a/protocol/versions/2026-10-04/memories.md+++ b/protocol/versions/2026-10-04/memories.md@@ -72,7 +72,7 @@ MCP the tools an agent holds how an agent calls it in a turn| Field | Type | Written by | Meaning ||---|---|---|---|-| `id` | string | server | `hmem_`-prefixed |+| `id` | string | server | Opaque to a client. A server that mints its own uses the `hmem_` prefix ([Architecture §3](architecture.md#3-object-model)); a server whose memories are a tree it already has keeps that tree's ids || `name` | string | client | Human-readable || `description` | string | client | What this memory holds, in a sentence or two. An agent reads it to decide whether to look inside ([§6.1](#61-reading-is-a-walk)), so it is content, not decoration || `parent_id` | string or null | client | The containing memory; `null` on a root |