deepseek-harness/docs/persistence-changes/2026-09-30-job-session-lifecycle.md

description, kind

description	kind
Records a persistence type transition and its compatibility acknowledgement.	persistence-change

2026-09-30-job-session-lifecycle

English | 中文

Summary

Records owned job registration and settlement with one unique JobId, original timestamps, creating tool calls, and producer completion reports.

Table of Contents

• Declaration
• Compatibility
• Verification
• Dev Note

Declaration

schemaVersion: 1
id: 2026-09-30-job-session-lifecycle
baseline: false
changes:
  - root: "event:job/registered"
    previous: null
    after: "f5520c1d261ca86ea03735799c311a0a9ede8babb588cf0a65422576d2ee0ad1"
    decision: same-version
  - root: "event:job/settled"
    previous: null
    after: "edd37b1e4974af648633014435572089b1e8fb71910468a0767a7e28fdd22abf"
    decision: same-version

Compatibility

Adds required job event kinds without changing the Session envelope. New JobIds use a kind-prefixed UUID for both live controls and durable pairing; historical sessions receive no fabricated job history. Older builds reject unknown required events. producerReported describes completion-promise fulfillment, not verified resource release.

Verification

Registry, snapshot-normalizer, shutdown, and headless tests cover causal order, unique JobIds, and ordered cleanup for normal and signal exit. CLI and SDK snapshots verify durable registration/settlement and notices.

Dev Note

None.