docs: deprecate legacy session file helpers#97494
Merged
jalehman merged 2 commits intoJun 28, 2026
Merged
Conversation
openclaw-barnacle
Bot
added
docs
Contributor
|
ClawSweeper review: did not complete due to Codex infrastructure failure. Reviewed June 28, 2026, 10:19 AM ET / 14:19 UTC. Summary PR surface: Source +23, Docs -2, Other 0. Total +21 across 5 files. Reproducibility: unclear. The review failed before ClawSweeper could establish a reproduction path. Review metrics: none identified. Merge readiness This is a ClawSweeper/Codex infrastructure failure, not a PR readiness or patch-quality verdict. Risk before merge
Maintainer options:
Next step before merge
Review detailsBest possible solution: Retry the Codex review after fixing the execution failure. Do we have a high-confidence way to reproduce the issue? Unclear. The review failed before ClawSweeper could establish a reproduction path. Is this the best way to solve the issue? Unclear. Retry the review first so ClawSweeper can evaluate the actual issue and fix direction. AGENTS.md: unclear because the file could not be read completely. Codex review notes: model internal, reasoning high; reviewed against 08d15ec32db3. Label changesLabel changes:
Evidence reviewedPR surface: Source +23, Docs -2, Other 0. Total +21 across 5 files. View PR surface stats
What I checked:
Likely related people:
How this review workflow works
|
clawsweeper
Bot
added
rating: 🐚 platinum hermit
clawsweeper
Bot
removed
rating: 🐚 platinum hermit
github-actions Bot
pushed a commit
to Desicool/openclaw
that referenced
this pull request
Jun 29, 2026
* docs: deprecate legacy session file helpers * docs: update sdk deprecation budgets
QiuYuang
pushed a commit
to QiuYuang/openclaw
that referenced
this pull request
Jul 1, 2026
* docs: deprecate legacy session file helpers * docs: update sdk deprecation budgets
chenyangjun-xy
pushed a commit
to chenyangjun-xy/openclaw
that referenced
this pull request
Jul 1, 2026
* docs: deprecate legacy session file helpers * docs: update sdk deprecation budgets
chenyangjun-xy
pushed a commit
to chenyangjun-xy/openclaw
that referenced
this pull request
Jul 3, 2026
* docs: deprecate legacy session file helpers * docs: update sdk deprecation budgets
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What Problem This Solves
Related: #88838
Resolves a documentation and SDK-signaling gap where plugin authors could still see legacy session-store and transcript-file helpers as normal compatibility APIs even though the SQLite storage flip is preparing to remove those file-shaped surfaces.
Why This Change Was Made
This marks the legacy whole-store, transcript-file, legacy transcript target, and low-level transcript append/update helper paths as deprecated on current main before the SQLite migration removes them. The replacement path is the scoped session entry helpers plus transcript identity helpers; this PR does not remove behavior or add a compatibility bridge.
User Impact
Plugin developers get clearer migration guidance before the storage flip lands. Existing plugins continue to work on this branch, but new code is directed away from
sessions.json, active JSONL transcript paths, and low-level transcript file emitters.Evidence
node scripts/run-vitest.mjs src/plugin-sdk/session-store-runtime.test.ts src/plugin-sdk/session-transcript-runtime.test.ts src/plugins/runtime/index.test.ts-> passed, 45 tests.node scripts/run-tsgo.mjs -p tsconfig.core.json --incremental --tsBuildInfoFile .artifacts/tsgo-cache/core.tsbuildinfo-> passed with a temporary localnode_modulessymlink to the main checkout dependencies.git diff --check-> passed.