deepseek-harness

​

deepseek-harness

​

Identity

• Names: com.deepseek.harness; short alias deepseek-harness.
• Native format: deepseek-harness-session-jsonl; .jsonl and concatenated checksummed .jsonl.zstd frames hold the same logical events. Header fields include version, id, parentSession, seedLength, origin and delegationDepth.
• Session ID: Header id, verbatim. The pinned SessionStore can generate instance-local IDs. Require a persisted installation/instance namespace for that mode. Do not merge independent instances or infer the namespace from an encoding path.
• Entity keys: Native message and tool IDs remain verbatim. Body seq is a logical event position; packed rows use seq0. Derive an inference ID when a recorded call lacks a native response ID. Compression and physical row counts do not define identity.
• Notes: Preserve request defaults, replay state, failed-attempt usage, approvals, plans and hooks. Packed deltas remain native evidence when not projected. Unknown file add/modify operations use _com.deepseek.harness/diff. Attachment bytes are not fetched. A torn compressed frame may require retrying the capture.

​

Position basis

​

Destinations

​

deepseek-harness: native facts without a standard field

​

Links

• Lineage: parentSession records fork/seed ancestry. origin: subagent also establishes spawning and subagent scope. seedLength counts copied logical events, not messages or compressed rows. It can establish a local copied prefix under this writer contract; a value of zero records no inheritance. Use throughOrdinal: seedLength - 1 only with a qualified ancestor segment mapping. Otherwise retain the seed count and omit the unresolved ordinal. Parent identity and namespace must be known before emitting a SessionRef. No root rule is qualified.
• Links and provenance: Assistant tool-call blocks own requests; execution tool/call is an audit start, not a duplicate request. Results join by source.callId or toolCallId when unique. senderSessionId supplies a sender only after identity resolution. Source kind user/model/plugin/goal/subagent-settled/coordinator/subagent-report determines provenance. User role alone does not.

​

Usage

• Inference and compaction: request/header records non-history request settings and instruction references; it does not establish complete context. Stream finish and usage records need the pinned request ownership contract before revising the same inference. Adjacent compaction meters supply shadowedSeqs for a surface replacement only under the version-0 writer contract. Translate every targeted logical message to all its context projections. Missing extent remains unknown; do not infer links from adjacency in other versions.

​

Lane and unassigned facts

​

Losses

​

Evidence

​

Observations from 2026-10-27

{
  "name": "com.deepseek.harness",
  "aliases": [
    "deepseek-harness"
  ],
  "namespace": {
    "rule": "required"
  },
  "positions": [
    {
      "family": "logical-events",
      "basis": "logical-event-and-subitem",
      "boundary": "committed-frame"
    }
  ],
  "formats": [
    {
      "id": "deepseek-harness-session-jsonl",
      "evidence": [
        0
      ]
    },
    {
      "id": "deepseek-harness-session-v4-jsonl-zstd",
      "storage": "session.v4.jsonl.zstd under .dsh/sessions",
      "conversion": "unsupported",
      "evidence": [
        3
      ]
    }
  ],
  "evidence": [
    {
      "label": "source",
      "revision": "99f6f02fecdb7dff40c3fbc9470f5907c29f74ca",
      "scope": "format-and-explicit-mappings"
    },
    {
      "label": "authored",
      "scope": "converter-tests-only"
    },
    {
      "label": "probe",
      "version": "0.1.0-rc.7",
      "scope": "persistence-only"
    },
    {
      "label": "observed",
      "version": "0.2.1-rc.2",
      "date": "2026-10-27",
      "scope": "session.v4.jsonl.zstd under .dsh/sessions; Settings-migration attempt failed without credentials; retry and second review/subagent run succeeded. Zero discovered streams.",
      "limitations": "DeepSeek Harness 0.2.1-rc.2 wrote session.v4.jsonl.zstd. Two runs succeeded after a failed settings-migration attempt, but the earlier converter discovered no streams and reported four unidentified inputs. The version-0 writer contracts above do not qualify this storage dialect. No v4 decoder or ASR link mapping was established. The ctx CLI spelling is deepseek-harness, with deep-seek-harness retained as a CLI alias; that spelling does not add an ASR agent alias.",
      "validation": {
        "streams": 0,
        "records": 0,
        "errors": 0,
        "notices": 0,
        "gaps": 0,
        "unidentifiedSources": 4
      },
      "validator": "validator-v0.1.2",
      "converter": "ctx-asr-authentic-captures-4"
    }
  ],
  "destinations": {
    "attachment": {
      "schema": {
        "type": "object"
      },
      "evidence": [
        0
      ]
    },
    "diff": {
      "schema": {
        "type": "object"
      },
      "evidence": [
        0
      ]
    },
    "error": {
      "schema": {
        "type": "object"
      },
      "evidence": [
        0
      ]
    },
    "messageSource": {
      "schema": {},
      "evidence": [
        0
      ]
    },
    "replacementMeter": {
      "schema": {
        "type": "object"
      },
      "evidence": [
        0
      ]
    },
    "usage": {
      "schema": {},
      "evidence": [
        0
      ]
    }
  }
}