description: "完整的 Session V2 持久化类型、来源证据与物理编码参考。"
English | 中文
查阅 dsh-v0.1.3-alpha.2 对应的 V2 持久化类型。Assistant 流内嵌在 message 或 attempt 事件中,物理 header 要求 isSeeded,不再存储 seedLength。本快照保留 V3 系统消息与信封变更之前的 V2 声明。
来源为已发布 tag dsh-v0.1.3-alpha.2,其写入器常量为 2。tag 记录说明相邻发布之间的变化。本完整目录同时包含未变化的根类型和该 tag 变化的根类型。
提取的声明来自 packages/core/session/src/types.ts、packages/session/session-persistence-jsonl/src/format.ts,以及所有第一方 SessionEventMap 声明合并及其可达类型。下方源码位置指向该历史源码树,而非当前文件。
以下事实描述所选检查点。下方生成的表格保留精确的字段类型与可选性。
SessionHeader.version 解析为字面量 2。逻辑与物理 header 均要求 isSeeded;物理 header 没有 seedLength。assistant/chunk。assistant/message.data 与仅日志用途的 assistant/attempt.data 都要求内嵌的 stream。start / end;系统提示词文本仍位于 request/header.data.header.system。不存在 V3 的 system/message 事件。V2 codec负责每行一个事件的编码、范围编码的来源引用,以及从 session/end-seed 标记推导的继承切点。V2 到 V3 规范负责系统消息插入、PTC 事件名称与规范信封转换。
对于已继承的 V2 Session,最后一个携带 data.inherited: true 的 session/end-seed 事件以其序号位置标识继承切点。物理 sourceEventSeqs 可以使用范围编码;逻辑 schema 保留展开后的数值数组。
schemaVersion: 1
sessionFormatVersion: 2
source:
tag: dsh-v0.1.3-alpha.2
roots:
"SessionHeader": 15918d785bdccedf0dba204622c75591bfb833bbf107ae0894bbc44cfbd73c1d
"JsonlHeaderLine": 18ee62b8900a4c3d046700f05d7a4d49d6cab2a660a020c87481d1603dd8bd4f
"SessionEventEnvelope": 04184edc061905410cc7e3db8d5c7cf393d739c89eb523ba8bad3831fb23ba95
"event:agent-preset/selected": a10c17474eaf2ddab7095a099e0fe3d046fc18e56c3e344fc8894c05ff9ef97b
"event:agent/inbox/spliced": f757322e25914d63799c6235af4ed4b4f36d7d083fef40d6873a45e94fe6ad65
"event:approval/asked": 3bfeb47b58606f4661904bc723da612782214c463d01e6d61cd6d6193d7374e1
"event:approval/decided": bb1ab3d08f49a9f3b265f844cd78d5c49813062a7b34b54904b426f85d0ff6e3
"event:approval/policy": 26718e15e7e395bce9642dba5bbe09b3b1a4ce2213d20d566cd9207d7fc5fb78
"event:assistant/attempt": 3516f54b427775f483febe8e938e4e10f9afd3583610861547bbe2999ed4d8d9
"event:assistant/message": 83f26c7a856f772e6ffd9a5a144e5aaccf771ac54cef41948f99eed99e1a25a7
"event:command/done": 15196447222782e773eb943c92b18316ce96b9af0f0cfddb6e57ba8274ecc5ff
"event:command/run": 37184378c6439257d105c4e2022d80fc9c3a3f7c7f6ac661b00bc9f18d871006
"event:compaction/end": b0127044ab31a702bddfd785d345f5abd7a70876746e895ce443afa3e60ddf2d
"event:compaction/prune": 7f7fd5a6b0064f597534b29ff62ef26e786dffccf5e14f654a7d4fcea2c35f04
"event:compaction/start": db874d463b0fdec77e9da1c4568f37cb70bd6596781eb93800db44fb8a116965
"event:compaction/summary": eb1d32dcd3d76833392f351e039dcbd40686a1ab24b252a7a5003426f9cf4c89
"event:feedback/message-delete": 3ee93b06f3a125850337602bcdf155d2538c43a5c944ec55b1b3c365152d6796
"event:feedback/message-put": 3b04fde0dc763cf84fbde7b6611b3194dd56d95d0c0bf0204311640468d586e1
"event:feedback/record": fb9df8180a202f3c845d5aa6a81697b2f7213f6735abc17535a55656be60a575
"event:goal/change": 763c8a20af487263a0080548274f7437ef4a86e0ba8769127d1ced10a72c664d
"event:hook/invoked": 8a6e1ec9e8db346b0e02f027db73c07a94f067a26d40c1aef1abd09c47ce7ba0
"event:hook/result": e75916628f3f10c2d50658bd143052a46285fbf1a9a700ba54947614603d26b4
"event:llm/retry": 91c397f8f870e812e1dc5ac69c2745f9f105be9dc97dadc980d19ef415a65145
"event:llm/retry-started": 48e5c9861f16ac07e78cb7b5ae9dabdf7bb85c58baed5a51b4ad275050ea58e3
"event:model/selection": 35203ba7ad5ef6f97d556b85df20ae98f04f09c65748cecdf8eefdb8b6405ffc
"event:permission/preset": 5c45bf4c544a7211dcd8ba6ba7e5f1bc39b49e7a9df9d5cbdc8e87c22771b37b
"event:plan/mode": a7cf43ce7c2a4c038feed1885cd7a00d5c6ee2d90a7e0d56b46f78a3e1ca327f
"event:request/context": f6b733e38d46dde3f8ab1ade2be3362abb6642eb97982a98ee64a57ff60d0c28
"event:request/header": 1de6c9c8764045ea9a1357bae6ccbbd57c19f6f337f8f25697c919c7cc9abf16
"event:sandbox/mode": 516da4cdd6d2f1e5ce488e648578ca51f40e458f707b803e5b24de870e799415
"event:schedule/change": 2a7f86849ae54b3398ee49661a757c4fcb59a6192b7036ee2ff514617e13fb42
"event:session-log-deepseek/delivery-accepted": d63b8b8ffad9c02fd80c43a17df4f240c1fe8118ecca9de34f9d5871838ab5b9
"event:session/end-seed": 5e6db6e24948d4a853c71cb9fabd252ad051ce93d4672c1266cf837c1c17b84e
"event:session/title": 1b912703e2d64f91c99c675b8f805b01076c8325b905c1218ad81ef0b24909d5
"event:session/title-llm-request": 6091f64d426ada2adc646094a6fe662a1b81d9ee5770929fe76800524e2c89a8
"event:step/end": e0a787e6ec76c7c94fecbc501b489164ab0293db05bc947914077ad01e674f05
"event:step/start": 4513e088d43e6c68425be30451b9f961cc264fe7318ca62681c41d4d78615986
"event:subagent/descriptor": b79ada42962cad0190a9d465805260567621fa3a4abd757eb31e6016b52d5ab5
"event:subagent/model-selection-policy": a6567ccb2e530606b775371eb4fa31468d72084339968e8b0440a516a23b39dc
"event:team/member": 4fb59762612c3e3ac3a3bd4f84c9c148d3c3893bd422ba2b201cc039fabd49bc
"event:team/message/delivered": 48f9c19417a1abbedfa59f4667bba36b93ac2db407adf5e84cb3ba0de30942cb
"event:team/message/queued": 2ffcad547cb840f462eb1849fa5f6cb0e17eb93f5d07cc88b61d749b1b78d632
"event:team/task": d595ec73b32b016a6055333c67a5d646032b22e672da1d4a09c5b1ae398a093a
"event:todo/write": b978cff734e62143eb56c9125423ec275405eda969802d42aaf73ecb987d3b26
"event:tool-workflow/agent-end": babf9ee4d1af62bf6c3a8103737f7a5e4e78ce179be835ce05a38803e15884b7
"event:tool-workflow/agent-start": 5f26a6c20b37632f8f57729d171c671def4683d994ac6257a8dffcd855101627
"event:tool-workflow/run-end": 42e0916e0dda5f6d1e7bb05d8514717147c036a79c9f36085683469516c1fd3f
"event:tool-workflow/run-start": c1f9e0405de6d18cabb9ee70782a027f9bbdc57e5abec9dcccdd56119e2e9058
"event:tool/call": 3b1be838223869fe0a08210db85bf773796ed3f2373ac16555dff227cade0c48
"event:tool/code-dispatch": f8dc5624cd0c942a069063ae0d90a61d821b4fddd1d967dcded91cf17933e708
"event:tool/code-dispatch-start": 9eb21c10fc675e1fa4184e5eecc9697aa87054ffd836d49428174897f0e64b62
"event:tool/result": eacefd48000720582725ccfc6ff7a0ac02755a1a3c57a8f9754125f99aab6c1b
"event:turn/end": 84c24f1209fc3e0153de6ac85d58fd6968b851f955e0e761b92321053956609e
"event:turn/start": aa0957eca50aeb28bcd2e6930b95809926edacb550c8c340ba526ba6b861b3d8
"event:user/message": a57a77f18de7b37b724293830a57064696895d69f2afcd2c0264f41cd13ba980
"event:web/deepseek-search-llm-request": cf6e3aaf1e2de6480aa0157730a41b9a492108a55304100b0f7e112711dd4331
完整机器目录包含 56 个根类型和 435 种可达类型。摘要包含所有引用字段;源码名称和路径描述所选的历史源码树。
| 根类型 | 类别 | SHA-256 | 已解析类型 |
|---|---|---|---|
SessionHeader |
header | 15918d785bdccedf0dba204622c75591bfb833bbf107ae0894bbc44cfbd73c1d |
packages/core/session/src/types.ts#SessionHeader |
JsonlHeaderLine |
header | 18ee62b8900a4c3d046700f05d7a4d49d6cab2a660a020c87481d1603dd8bd4f |
packages/session/session-persistence-jsonl/src/format.ts#HeaderLine |
SessionEventEnvelope |
envelope | 04184edc061905410cc7e3db8d5c7cf393d739c89eb523ba8bad3831fb23ba95 |
SessionEventEnvelope |
event:agent-preset/selected |
event | a10c17474eaf2ddab7095a099e0fe3d046fc18e56c3e344fc8894c05ff9ef97b |
event:agent-preset/selected |
event:agent/inbox/spliced |
event | f757322e25914d63799c6235af4ed4b4f36d7d083fef40d6873a45e94fe6ad65 |
event:agent/inbox/spliced |
event:approval/asked |
event | 3bfeb47b58606f4661904bc723da612782214c463d01e6d61cd6d6193d7374e1 |
event:approval/asked |
event:approval/decided |
event | bb1ab3d08f49a9f3b265f844cd78d5c49813062a7b34b54904b426f85d0ff6e3 |
event:approval/decided |
event:approval/policy |
event | 26718e15e7e395bce9642dba5bbe09b3b1a4ce2213d20d566cd9207d7fc5fb78 |
event:approval/policy |
event:assistant/attempt |
event | 3516f54b427775f483febe8e938e4e10f9afd3583610861547bbe2999ed4d8d9 |
event:assistant/attempt |
event:assistant/message |
event | 83f26c7a856f772e6ffd9a5a144e5aaccf771ac54cef41948f99eed99e1a25a7 |
event:assistant/message |
event:command/done |
event | 15196447222782e773eb943c92b18316ce96b9af0f0cfddb6e57ba8274ecc5ff |
event:command/done |
event:command/run |
event | 37184378c6439257d105c4e2022d80fc9c3a3f7c7f6ac661b00bc9f18d871006 |
event:command/run |
event:compaction/end |
event | b0127044ab31a702bddfd785d345f5abd7a70876746e895ce443afa3e60ddf2d |
event:compaction/end |
event:compaction/prune |
event | 7f7fd5a6b0064f597534b29ff62ef26e786dffccf5e14f654a7d4fcea2c35f04 |
event:compaction/prune |
event:compaction/start |
event | db874d463b0fdec77e9da1c4568f37cb70bd6596781eb93800db44fb8a116965 |
event:compaction/start |
event:compaction/summary |
event | eb1d32dcd3d76833392f351e039dcbd40686a1ab24b252a7a5003426f9cf4c89 |
event:compaction/summary |
event:feedback/message-delete |
event | 3ee93b06f3a125850337602bcdf155d2538c43a5c944ec55b1b3c365152d6796 |
event:feedback/message-delete |
event:feedback/message-put |
event | 3b04fde0dc763cf84fbde7b6611b3194dd56d95d0c0bf0204311640468d586e1 |
event:feedback/message-put |
event:feedback/record |
event | fb9df8180a202f3c845d5aa6a81697b2f7213f6735abc17535a55656be60a575 |
event:feedback/record |
event:goal/change |
event | 763c8a20af487263a0080548274f7437ef4a86e0ba8769127d1ced10a72c664d |
event:goal/change |
event:hook/invoked |
event | 8a6e1ec9e8db346b0e02f027db73c07a94f067a26d40c1aef1abd09c47ce7ba0 |
event:hook/invoked |
event:hook/result |
event | e75916628f3f10c2d50658bd143052a46285fbf1a9a700ba54947614603d26b4 |
event:hook/result |
event:llm/retry |
event | 91c397f8f870e812e1dc5ac69c2745f9f105be9dc97dadc980d19ef415a65145 |
event:llm/retry |
event:llm/retry-started |
event | 48e5c9861f16ac07e78cb7b5ae9dabdf7bb85c58baed5a51b4ad275050ea58e3 |
event:llm/retry-started |
event:model/selection |
event | 35203ba7ad5ef6f97d556b85df20ae98f04f09c65748cecdf8eefdb8b6405ffc |
event:model/selection |
event:permission/preset |
event | 5c45bf4c544a7211dcd8ba6ba7e5f1bc39b49e7a9df9d5cbdc8e87c22771b37b |
event:permission/preset |
event:plan/mode |
event | a7cf43ce7c2a4c038feed1885cd7a00d5c6ee2d90a7e0d56b46f78a3e1ca327f |
event:plan/mode |
event:request/context |
event | f6b733e38d46dde3f8ab1ade2be3362abb6642eb97982a98ee64a57ff60d0c28 |
event:request/context |
event:request/header |
event | 1de6c9c8764045ea9a1357bae6ccbbd57c19f6f337f8f25697c919c7cc9abf16 |
event:request/header |
event:sandbox/mode |
event | 516da4cdd6d2f1e5ce488e648578ca51f40e458f707b803e5b24de870e799415 |
event:sandbox/mode |
event:schedule/change |
event | 2a7f86849ae54b3398ee49661a757c4fcb59a6192b7036ee2ff514617e13fb42 |
event:schedule/change |
event:session-log-deepseek/delivery-accepted |
event | d63b8b8ffad9c02fd80c43a17df4f240c1fe8118ecca9de34f9d5871838ab5b9 |
event:session-log-deepseek/delivery-accepted |
event:session/end-seed |
event | 5e6db6e24948d4a853c71cb9fabd252ad051ce93d4672c1266cf837c1c17b84e |
event:session/end-seed |
event:session/title |
event | 1b912703e2d64f91c99c675b8f805b01076c8325b905c1218ad81ef0b24909d5 |
event:session/title |
event:session/title-llm-request |
event | 6091f64d426ada2adc646094a6fe662a1b81d9ee5770929fe76800524e2c89a8 |
event:session/title-llm-request |
event:step/end |
event | e0a787e6ec76c7c94fecbc501b489164ab0293db05bc947914077ad01e674f05 |
event:step/end |
event:step/start |
event | 4513e088d43e6c68425be30451b9f961cc264fe7318ca62681c41d4d78615986 |
event:step/start |
event:subagent/descriptor |
event | b79ada42962cad0190a9d465805260567621fa3a4abd757eb31e6016b52d5ab5 |
event:subagent/descriptor |
event:subagent/model-selection-policy |
event | a6567ccb2e530606b775371eb4fa31468d72084339968e8b0440a516a23b39dc |
event:subagent/model-selection-policy |
event:team/member |
event | 4fb59762612c3e3ac3a3bd4f84c9c148d3c3893bd422ba2b201cc039fabd49bc |
event:team/member |
event:team/message/delivered |
event | 48f9c19417a1abbedfa59f4667bba36b93ac2db407adf5e84cb3ba0de30942cb |
event:team/message/delivered |
event:team/message/queued |
event | 2ffcad547cb840f462eb1849fa5f6cb0e17eb93f5d07cc88b61d749b1b78d632 |
event:team/message/queued |
event:team/task |
event | d595ec73b32b016a6055333c67a5d646032b22e672da1d4a09c5b1ae398a093a |
event:team/task |
event:todo/write |
event | b978cff734e62143eb56c9125423ec275405eda969802d42aaf73ecb987d3b26 |
event:todo/write |
event:tool-workflow/agent-end |
event | babf9ee4d1af62bf6c3a8103737f7a5e4e78ce179be835ce05a38803e15884b7 |
event:tool-workflow/agent-end |
event:tool-workflow/agent-start |
event | 5f26a6c20b37632f8f57729d171c671def4683d994ac6257a8dffcd855101627 |
event:tool-workflow/agent-start |
event:tool-workflow/run-end |
event | 42e0916e0dda5f6d1e7bb05d8514717147c036a79c9f36085683469516c1fd3f |
event:tool-workflow/run-end |
event:tool-workflow/run-start |
event | c1f9e0405de6d18cabb9ee70782a027f9bbdc57e5abec9dcccdd56119e2e9058 |
event:tool-workflow/run-start |
event:tool/call |
event | 3b1be838223869fe0a08210db85bf773796ed3f2373ac16555dff227cade0c48 |
event:tool/call |
event:tool/code-dispatch |
event | f8dc5624cd0c942a069063ae0d90a61d821b4fddd1d967dcded91cf17933e708 |
event:tool/code-dispatch |
event:tool/code-dispatch-start |
event | 9eb21c10fc675e1fa4184e5eecc9697aa87054ffd836d49428174897f0e64b62 |
event:tool/code-dispatch-start |
event:tool/result |
event | eacefd48000720582725ccfc6ff7a0ac02755a1a3c57a8f9754125f99aab6c1b |
event:tool/result |
event:turn/end |
event | 84c24f1209fc3e0153de6ac85d58fd6968b851f955e0e761b92321053956609e |
event:turn/end |
event:turn/start |
event | aa0957eca50aeb28bcd2e6930b95809926edacb550c8c340ba526ba6b861b3d8 |
event:turn/start |
event:user/message |
event | a57a77f18de7b37b724293830a57064696895d69f2afcd2c0264f41cd13ba980 |
event:user/message |
event:web/deepseek-search-llm-request |
event | cf6e3aaf1e2de6480aa0157730a41b9a492108a55304100b0f7e112711dd4331 |
event:web/deepseek-search-llm-request |
仅使用源码的提取器以 TypeScript 6.0.3 运行。重建时省略冗余的 object 交叉类型成员,并丢弃规范化后不可达的类型定义;保留已有的 any / unknown,不以不透明类型替代未解析的导入。V0 与 V2 根类型摘要与从预发布归档重建的对应完整状态一致。
历史 surface 事件声明允许可选的 surfaceOp。这保留了类型声明证据,并不允许省略 codec 或迁移验证器要求的字段。不透明值、外部插件事件、打包的 body 编码与运行时关系均不在类型目录覆盖范围内。
pnpm run verify-persistence-formats
该检查仅使用本工作树验证直到当前写入器的每个格式、schema 完整性、双语声明与生成表格。它不会回放历史应用,也不确立迁移安全性。维护规则参见格式索引,当前声明参见当前目录。
无。