opencode

Identity

Names: opencode / ai.opencode.
Native format: opencode-sqlite. Read session/message/part tables and available sequenced session_message or session_entry tables in one transaction, including WAL. Keep alternate migration representations as vendor records. Only layouts verified at this entry’s pin are covered.
Session ID: Native session.id or session_v2.id, with no namespace for the pinned CLI format. A table name or path is not part of identity.
Entity keys: Message id and tool callID, verbatim. Keep part-row IDs separately. A uniquely owned tool part’s current state supplies its call and completed/error result. Reused call IDs are ambiguous. Step/message usage supports an inference derived from its native message or step-part ID.
Notes: Fold text, reasoning and files under the native message. Keep ignored parts outside model context. Native input excludes cache reads/writes; output excludes reasoning, so add output and reasoning only when both exist. Cost is harness-estimated USD. Model selection is requested, not served. Keep revert metadata when its part boundary falls inside a folded message. Summary/prune/checkpoint/patch fields without exact target or endpoint contracts remain metadata. A todo snapshot must contain the complete item list.

Position basis

Order and captures: Use native sequence order; legacy order is message time_created then message ID, with part-ID order. Rewritten tool and text rows keep their transcript positions as defined by the source and their contents as observed. These rows do not establish the history of earlier state changes. ASR-015 requires deterministic native-key record IDs across independent captures. A destination’s first-observation position ledger cannot replace that rule or reorder the current source.

Record family	Position basis	Commit boundary
messages	native-sequence-or-writer-order	transaction
parts	native-part-order	transaction

Use only positions established by the stated format and mapping evidence. Current-state rows without transcript positions form the snapshot tail. A protocol commit boundary takes precedence over physical EOF; uncommitted bytes are not a gap.

Destinations

opencode: native facts without a standard field

Fact	Native name	Destination
Session state and revert	Complete `session` or `session_v2` row	`native.record` on the record for this source value, or `native.blob` for a blob containing the entire value. Preserve native JSON text columns as strings. Use a separate vendor record when several source rows map to one ASR record. ASR-035 applies to unsafe numbers.
Projected source	Message, tool, configuration or other source row and decoded `data`	`native.record` on the record for this source value, or `native.blob` for a blob containing the entire value. Preserve native JSON text columns as strings. Use a separate vendor record when several source rows map to one ASR record. ASR-035 applies to unsafe numbers.
Part extras	Unprojected text/reasoning/file members	content part `_meta` `ai.opencode/part`, object of those native members
Part row identity and times	Part row columns	`native.record` on the record for this source value, or `native.blob` for a blob containing the entire value. Preserve native JSON text columns as strings. Use a separate vendor record when several source rows map to one ASR record. ASR-035 applies to unsafe numbers.
Accounting	Step or message `data`	`inference` `_meta` `ai.opencode/step`
Alternate or unprojected rows	Legacy session/message/part, ignored part, todo or other session-owned row	vendor records `ai.opencode/legacy_session_state`, `ai.opencode/legacy_representation`, `ai.opencode/ignored_part`, `ai.opencode/unmapped_part`, `ai.opencode/todo` or `ai.opencode/<native kind>`; `native.record` holds the row

Links

Lineage: session.parent_id supplies only relatedUnknown; fork_session_id supplies forkedFrom where that exact field exists at the pinned revision. A task tool’s metadata.sessionId names its child. It does not identify the inverse delegating call in a child header. No copies, root or copied-prefix length follow from matching IDs.

A revert state that refers to a message part does not represent a rewind of the whole message or establish that a rewind occurred in the past. Preserve it and declare branches when its boundary cannot be represented. Part-level revert and splice models remain deferred.

Usage

Select one uniquely owned step report when the source establishes its accounting identity. Use a message report only when it does not overlap a selected step report. Keep reports that cannot be linked as native evidence and declare incomplete usage. Native input excludes cache reads and writes; output excludes reasoning. Cost is harness-estimated USD. These rules for what usage counts include depend on the pinned backend contract. Select one report per native accounting identity only when this entry establishes that identity. Keep unjoinable or overlapping reports as native evidence. Declare incomplete semantic coverage. Schema defaults and placeholder zeros are not reported usage. Rules for what the backend includes in usage counts require evidence; do not infer them from a model name.

Lane and unassigned facts

Facts without established session ownership use manifest _meta["ai.opencode/unassigned"] with the common shape. A selection may retain these facts alongside any subset of sessions, including an empty subset, but must not imply that any session owns them. State the selection policy in the export report.

Losses

Declare every applicable loss under ASR-157. Missing model rendering, accounting joins, lineage or exact context boundaries remain losses when this entry does not qualify them. Unknown ownership is not itself lost data. Report omitted unassigned facts using a documented vendor loss category or report rather than a new core category.

Evidence

Basis: source-verified: OpenCode 1.18.18, commit 65c35977bd564e23c0e9cf124b3e3e3b9308e9e8. Sanitized official 1.18.34 to 2.0.21 migration fixtures cover user messages and migration; assistant semantics have authored tests. The pin does not qualify every later layout. Evidence applies only to the named formats and explicit mappings above. A real capture covers only exercised behavior. A no-model writer probe covers persistence, not model or tool execution. Authored tests do not qualify an agent version. Unlisted formats and link mappings remain unqualified.

Observations from 2026-10-27

observed, version 1.19.4: OpenCode 1.19.4 retained edit, shell-test, resume, fork and child sessions. These findings cover only the exercised SQLite layout. Folding text into a message must preserve every native part row separately in native.record or native.blob; a fold does not authorize dropping part identity or extra fields. The ctx conversion produced 3 streams and 116 records, with 0 errors, 3 notices, 0 gaps and 0 unidentified inputs under validator-v0.1.2. These counts describe the selected output; an empty bundle qualifies no source format. No sanitized native fixture was retained for this observation. Whole native records use native.record or native.blob, with JSON text columns preserved as strings. The exporter’s own bookkeeping for serialization, partitioning and message keys belongs in the exporter namespace (rs.ctx for ctx), not to a provider metadata destination. These runs add no evidence for approvals, lineage links, compaction boundaries or exact request context that they did not exercise.

{
  "name": "ai.opencode",
  "aliases": [
    "opencode"
  ],
  "namespace": {
    "rule": "none"
  },
  "positions": [
    {
      "family": "messages",
      "basis": "native-sequence-or-writer-order",
      "boundary": "transaction"
    },
    {
      "family": "parts",
      "basis": "native-part-order",
      "boundary": "transaction"
    }
  ],
  "formats": [
    {
      "id": "opencode-sqlite",
      "evidence": [
        0,
        2,
        3
      ]
    }
  ],
  "evidence": [
    {
      "label": "source",
      "revision": "65c35977bd564e23c0e9cf124b3e3e3b9308e9e8",
      "scope": "format-and-explicit-mappings"
    },
    {
      "label": "authored",
      "scope": "converter-tests-only"
    },
    {
      "label": "capture",
      "version": "1.18.34 to 2.0.21",
      "scope": "user message persistence and migration; assistant semantics authored"
    },
    {
      "label": "observed",
      "version": "1.19.4",
      "date": "2026-10-27",
      "scope": "SQLite session/message/part rows in .local/share/opencode/opencode.db; Edit, shell test, resume, fork and child; 3 streams.",
      "limitations": "OpenCode 1.19.4 retained edit, shell-test, resume, fork and child sessions. These findings cover only the exercised SQLite layout. Folding text into a message must preserve every native part row separately in native.record or native.blob; a fold does not authorize dropping part identity or extra fields.",
      "validation": {
        "streams": 3,
        "records": 116,
        "errors": 0,
        "notices": 3,
        "gaps": 0,
        "unidentifiedSources": 0
      },
      "validator": "validator-v0.1.2",
      "converter": "ctx-asr-authentic-captures-4"
    }
  ],
  "destinations": {
    "part": {
      "schema": {
        "type": "object"
      },
      "evidence": [
        0
      ]
    },
    "step": {
      "schema": {},
      "evidence": [
        0
      ]
    }
  },
  "mappings": [
    {
      "native": "complete native row or event",
      "destination": "native.record or native.blob",
      "scope": "SQLite session/message/part rows in .local/share/opencode/opencode.db",
      "evidence": [
        3
      ]
    }
  ]
}

Introduction

Format

Records

Trust

Extending and conforming

Agent registry

opencode

opencode

Identity

Position basis

Destinations

opencode: native facts without a standard field

Links

Usage

Lane and unassigned facts

Losses

Evidence

Observations from 2026-10-27

​opencode

​Identity

​Position basis

​Destinations

​opencode: native facts without a standard field

​Links

​Usage

​Lane and unassigned facts

​Losses

​Evidence

​Observations from 2026-10-27

opencode

Identity

Position basis

Destinations

opencode: native facts without a standard field

Links

Usage

Lane and unassigned facts

Losses

Evidence

Observations from 2026-10-27