Skip to content

[PR] docs: message-identity hierarchy is now msgid > order > hash (#4491/#4834) - #4871

Merged
ranxianglei merged 1 commit into
masterfrom
2026-10-26_doc-msgid-first
Oct 26, 2026
Merged

ranxianglei merged 1 commit into
masterfrom
2026-10-26_doc-msgid-first

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

这是啥问题

教义文档落后于代码:MESSAGE-IDENTITY.md 仍写着「未来若有稳定客户端消息 id,只能当 join hint,永不替代 content-hash 的账本 join 基础」。而 #4491 之后四条插件车道已经把宿主 msgid 作为 bili 私有信封字段上行并钉进账本,#4834 之后解析 id 优先(跨模型改写不再否决 id)。读文档的 agent 因此得出「我们没有 msgid」——模型线上对,插件车道上错。

改动

验证

纯文档改动;typecheck/build 确认未触碰代码。

关联

#4491(msgIds 信封) #4834(id-first) #4863(claim-after-guard) #2821(顺序中心 owner rule 原文)

…4834)

The doctrine said stable client ids may only ever be join hints. That was
written before the plugin lanes started shipping host msgids in a bili-private
envelope (msgIds on the incremental turn / biliMsgIds stripped at ingress)
and before #4834 made resolution id-first. Agents reading the docs concluded
'we have no msgids' — true on the model wire, false on the plugin lanes.

- AGENTS.md KDD #11 retitled to the full hierarchy: msgid first where the
  envelope carries it (plugin lanes only, never forwarded upstream), order
  still primary on id-less resend reconciliation, hash stays the per-cell
  gate. Three-part PK (session_id, msg_id, content_hash) noted as safety belt.
- AGENTS.md KDD #13 evolution updated to four stages (hash -> order ->
  msgid pinning -> snapshot render).
- MESSAGE-IDENTITY.md: new section 'The msgid envelope' documenting the
  channel, all-or-nothing semantics, resync re-claim, #4834 id-first,
  #4863 claim-after-guard, and the boundary (model wire unchanged,
  tool-call ids are pairing keys, proxy-mode resends keep the ladder);
  Future-direction paragraph refreshed.
@ranxianglei ranxianglei added the ci:full Run the FULL CI matrix (all e2e lanes + 12-leg test matrix) on this PR label Oct 26, 2026
@ranxianglei ranxianglei changed the title docs: message-identity hierarchy is now msgid > order > hash (#4491/#4834) [PR] docs: message-identity hierarchy is now msgid > order > hash (#4491/#4834) Oct 26, 2026
@ranxianglei
ranxianglei merged commit 13e0dba into master Oct 26, 2026
23 of 60 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

📦 Merged Build Published

This merge to master was published as 0.0.861-master.13e0dba (rolling master tag).

npm install -g billion-context@0.0.861-master.13e0dba  # this exact build
npm install -g billion-context@master  # always the newest merged build

npm view billion-context@master prints the current version at any time.

@github-actions

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-10-26_doc-msgid-first (c8d7b14)

Latest build — install this exact version

npm install -g billion-context@0.0.6298-pr.4871.876a4ad

This exact version is immutable and reproducible. The rolling pr tag tracks the newest test build across all PRs.

Recent builds (commit → version)

commit version build
c8d7b14 billion-context@0.0.6298-pr.4871.876a4ad build

Download artifact

  1. Download the artifact from the Actions run
  2. Extract the tarball and install:
tar xzf billion-context-pr4871.tgz
npm install -g package

Install instructions are refreshed on each push.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci:full Run the FULL CI matrix (all e2e lanes + 12-leg test matrix) on this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant