# description
Object definitions for UHP 2026-08-11. Generated from uhp-2026-08-11.openapi.yaml by build.py — do not edit by hand.

# $defs.Capabilities.description
Named booleans. A server reports `false` for a capability it does not implement rather than
omitting it, so a client can distinguish "not supported" from "server predates this field".
A client treats an absent key as `false`.

# $defs.Harness.properties.base.description
Opaque. Not enumerated by this specification — a client must treat it as a string, or the
protocol would need revising every time a harness is released.

# $defs.McpServer.description
A remote MCP server attached to a harness. Only enabled entries are connected for a turn; a
disabled entry must not be contacted at all. An unreachable server must not fail the task.

# $defs.McpServer.properties.name.description
Sanitised to a CLI-safe identifier by the server.

# $defs.McpServer.properties.auth.description
Bearer token, or a server-side reference the server resolves. A server must never return
a resolved credential to a client.

# $defs.Skill.description
A skill is a FOLDER, not a file. A server must materialise the whole folder where the agent
can read it — materialising only SKILL.md breaks every skill carrying references, scripts or
data. Round-tripping a harness through GET and PUT must not lose skill contents.

# $defs.Skill.properties.enabled.description
false suppresses the skill, including one inherited from the base.

# $defs.Skill.properties.content.description
Shorthand for a single-file bundle whose only member is SKILL.md.

# $defs.Skill.properties.blob.description
Server-assigned handle for a bundle stored out of line. A client receives it, passes it
back unchanged, and reads the files from the skill files endpoint.

# $defs.SkillFile.properties.path.description
Relative to the skill's own folder; nested directories are supported. A server must
reject a path that escapes the folder.

# $defs.SkillFile.properties.content_b64.description
Base64 for binary content; preserved byte-for-byte.

# $defs.Model.properties.available.description
Computed, not asserted: true means the server can serve this model for this harness right
now. Listing a model as available and then failing the task is the worst outcome for a
client, because a user has already chosen it.

# $defs.CreateResponseRequest.properties.input.description
A bare string is shorthand for one user message.

# $defs.CreateResponseRequest.properties.model.description
Canonical model id. Omitted means the harness default.

# $defs.CreateResponseRequest.properties.metadata.description
Client metadata. `harness_id` selects the configured harness.

# $defs.Response.properties.usage.description
null when the server cannot account for usage. A fabricated zero would be worse than an
honest absence, because a client cannot tell it from a free task.

# $defs.Response.properties.metadata.properties.requested_model.description
Present when the server ran a different model than was requested.

# $defs.ResponseStatus.description
`incomplete` means a budget stopped the work and is usually worth continuing.
`failed` means it could not be done. `cancelled` means the client asked for a stop, and must
never be reported as `failed`.

# $defs.OutputItem.description
A client must tolerate item types it does not recognise. A client that renders only `message`
items and ignores the rest is a valid client.

# $defs.SessionList.properties.next_cursor.description
null on the last page. A client must not be required to detect the end by receiving fewer
items than requested — that heuristic is wrong whenever a page is exactly full.

# $defs.ErrorEnvelope.properties.detail.description
A human-readable alias of `error.message`, retained for clients written against
implementations that predate this envelope. Carries no information not in `error`.

# $defs.Error.properties.code.description
Specific and machine-readable. Servers may define additional codes for conditions this
specification does not cover, and must namespace them with a vendor prefix so a future
version cannot collide with them.

# $defs.Error.properties.message.description
One sentence, safe to show a user. Must not contain credentials, internal hostnames, file
paths, or stack traces.

# $defs.Event.description
One streamed event. `sequence_number` starts at 0 and increases by exactly 1 per event, so a
client can detect a dropped event rather than silently rendering a gap.