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 record may carry a title (#396)
github-actions[bot]ea43fc05ca78
diff --git a/protocol/CHANGELOG.md b/protocol/CHANGELOG.mdindex cbb61ce2..163af8ad 100644--- a/protocol/CHANGELOG.md+++ b/protocol/CHANGELOG.md@@ -73,6 +73,13 @@ its own, which is not equal standing where every new person joins one). Schema:The chapter's opening, §1, the list of an agent's tools (`memory_graph`) and §14 were then broughtin line with the six patches above; no rule changed.+**Seventh patch of 2026-10-04, same version.** A record MAY carry a `title`: one line that names+it, apart from what it says (a document's heading, an entity's name, a fact's statement). It is+optional, at most 300 characters, matched by a search together with the content, and revised like+any other field. A record with a title MAY have empty content. An `entity`'s name is its title.+Schema: `MemoryRecord.title`. Suite `2026.10.4.post7`: ME-02 checks that a title reads back apart+from the content and may stand alone.+- **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 9fa06f96..3df95a0d 100644--- a/protocol/conformance/pyproject.toml+++ b/protocol/conformance/pyproject.toml@@ -1,6 +1,6 @@[project]name = "uhp-conformance"-version = "2026.10.4.post6"+version = "2026.10.4.post7"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 0b95b2c5..8c89eece 100644--- a/protocol/conformance/uhp_conformance/checks.py+++ b/protocol/conformance/uhp_conformance/checks.py@@ -2057,6 +2057,16 @@ def me02(ctx):assert (rec.get("attributes") or {}).get("account") == "quillon", f"attributes did not round-trip: {rec.get('attributes')!r}"got = ctx.client.get(f"/v1/memories/{rec['memory_id']}/records/{rec['id']}").json or {}assert got.get("id") == rec["id"] and got.get("content") == rec["content"], "the record does not read back by its id"+ # a title names a record, apart from what it says, and may stand alone+ body = "Either side can end the order form with 90 days written notice."+ t = ctx.client.post(f"/v1/memories/{rec['memory_id']}/records", body={"type": "note", "title": "Quillon master agreement", "content": body})+ assert t.status == 200, f"POST a record with a title returned HTTP {t.status}: {t.text[:200]}"+ back = ctx.client.get(f"/v1/memories/{rec['memory_id']}/records/{t.json['id']}").json or {}+ assert back.get("title") == "Quillon master agreement", f"the title did not read back: {back.get('title')!r}"+ assert back.get("content") == [{"type": "text", "text": body}], f"the title must not be folded into the content: {back.get('content')!r}"+ alone = ctx.client.post(f"/v1/memories/{rec['memory_id']}/records", body={"type": "fact", "title": "The Quillon fiscal year starts on February 1"})+ assert alone.status == 200 and (alone.json or {}).get("content") == [], (+ f"a record with a title and no content is a record; got HTTP {alone.status} {str(alone.json)[:160]}")w = rec.get("written_by") or {}assert w.get("kind") == "member" or str(w.get("kind") or "").startswith("x."), (f"a stated record's writer is a member (a person or an agent) or an x.-prefixed kind of the server's own; got {w.get('kind')!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 96092ba6..af48ee15 100644--- a/protocol/conformance/uhp_conformance/uhp-2026-10-04.schema.json+++ b/protocol/conformance/uhp_conformance/uhp-2026-10-04.schema.json@@ -2269,7 +2269,12 @@},"type": {"type": "string",- "description": "episode, fact, note, procedure, link, or an extension type."+ "description": "episode, fact, note, procedure, link, entity, or an extension type."+ },+ "title": {+ "type": "string",+ "maxLength": 300,+ "description": "One line that names the record. Optional; a search matches it with the content."},"content": {"type": "array",diff --git a/protocol/schema/uhp-2026-10-04.openapi.yaml b/protocol/schema/uhp-2026-10-04.openapi.yamlindex acb61e4f..b659908c 100644--- a/protocol/schema/uhp-2026-10-04.openapi.yaml+++ b/protocol/schema/uhp-2026-10-04.openapi.yaml@@ -2743,7 +2743,8 @@ components:id: { type: string, description: Assigned by the provider and opaque to a client. }object: { type: string, const: memory.record }memory_id: { type: string }- type: { type: string, description: 'episode, fact, note, procedure, link, or an extension type.' }+ type: { type: string, description: 'episode, fact, note, procedure, link, entity, or an extension type.' }+ title: { type: string, maxLength: 300, description: 'One line that names the record. Optional; a search matches it with the content.' }content: { type: array, items: { $ref: '#/components/schemas/MemoryContentPart' }, description: An ordered list of parts. Always a list on a read. }attributes: { type: object, additionalProperties: true }version: { type: integer }diff --git a/protocol/schema/uhp-2026-10-04.schema.json b/protocol/schema/uhp-2026-10-04.schema.jsonindex 96092ba6..af48ee15 100644--- a/protocol/schema/uhp-2026-10-04.schema.json+++ b/protocol/schema/uhp-2026-10-04.schema.json@@ -2269,7 +2269,12 @@},"type": {"type": "string",- "description": "episode, fact, note, procedure, link, or an extension type."+ "description": "episode, fact, note, procedure, link, entity, or an extension type."+ },+ "title": {+ "type": "string",+ "maxLength": 300,+ "description": "One line that names the record. Optional; a search matches it with the content."},"content": {"type": "array",diff --git a/protocol/versions/2026-10-04/memories.md b/protocol/versions/2026-10-04/memories.mdindex 9873f634..533e9223 100644--- a/protocol/versions/2026-10-04/memories.md+++ b/protocol/versions/2026-10-04/memories.md@@ -175,6 +175,7 @@ A record is one thing a memory holds. Its `id` is the provider's and opaque to a"object": "memory.record","memory_id": "hmem_7c1e4b9a2d3f4e5a8b6c7d8e9f0a1b2c","type": "fact",+ "title": "Acme renews in March and wants its discount kept","content": [{ "type": "text", "text": "Acme renews in March and wants its discount kept." }],@@ -197,7 +198,8 @@ A record is one thing a memory holds. Its `id` is the provider's and opaque to a| Field | Meaning ||---|---|| `type` | What kind of record ([§4.1](#41-types)) |-| `content` | What the record says: an ordered list of parts, text and files ([§4.3](#43-content)) |+| `title` | One line that names the record: a document's heading, an entity's name, a fact's statement. Optional, at most 300 characters. A search matches it with the content. A record without one is named by how its content begins |+| `content` | What the record says: an ordered list of parts, text and files ([§4.3](#43-content)). MAY be empty when the record has a title: a fact is often one sentence || `attributes` | Structured fields. Free-form for core types; the type's schema for extension types ([§8](#8-types)) || `version`, `status`, `supersedes` | A change appends a version and closes the one before it ([§5.3](#53-nothing-is-overwritten)). `status` is `active`, `superseded` or `forgotten` || `time` | When it was true in the world (`valid_*`) and when the memory held it (`written_at`, `invalidated_at`). A provider without validity leaves `valid_*` null |@@ -216,7 +218,7 @@ The core types every server understands:| `note` | A document an agent or a person wrote and maintains || `procedure` | A how-to with the situation it applies to || `link` | A pointer to something kept elsewhere: an address and a description, no content of its own |-| `entity` | Something records are about: a person, a company, a product, a place. Its content is its name and what is known of it in a line or two |+| `entity` | Something records are about: a person, a company, a product, a place. Its `title` is its name; its content is what is known of it |Any other type is an extension ([§8](#8-types)). A server MUST carry a record of a type it does notunderstand unchanged, and MUST NOT refuse a read because of it.