fix(code-runtime-python): complete the experimental move across configs and docs

The review's move-follow-ups: the Windows test exclude now points at
packages/experimental/code-runtime-python (the constructor throws by design on
Windows, so the suite must stay excluded); the invariant companion and
@module annotations use the new npm name; the truncation marker text and
tmpdir prefix stay as-is (tests anchor them); the package JSDoc and READMEs no
longer call the private experimental backend 'published'/'shipped'; the
code-runtime README row describes the package as protocol AND runtime; the
fd-3 note records the package's experimental location.
This commit is contained in:
Chinesezjc
2026-08-31 15:15:08 +08:00
committed by Tianyi Cui
parent d7eb7f4418
commit 2504d0a501
11 changed files with 16 additions and 12 deletions
@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/experimental/code-runtime-python/README.md
README.md: 2fc78c0a8066886114600e4f3bab6a56521563e5
README.md: 26f45b34325c003b6693dfb4107fa7b8b179bc66
README.zh.md: c2ec5ca81e5b8a7ee50658663484981699aa9687
@@ -89,7 +89,7 @@ Read these when the runtime contract is not enough. They move from the seam defi
- [Code runtime seam](../../code-runtime/code-runtime/README.md) — the abstract contract this backend implements.
- [fd-3 protocol Agent Note](../../../.agents/notes/implemented/architecture/2026-07-31-code-runtime-python-fd3-protocol.md) — design rationale and wire contract.
- [Settlement-fixes Agent Note](../../../.agents/notes/implemented/bug-fix/2026-07-31-code-runtime-python-settlement-fixes.md) — settlement, metering, and containment fixes and their regression cases.
- [Worker-thread backend](../../code-runtime/code-runtime-worker-thread/README.md) — the shipped TypeScript sibling.
- [Worker-thread backend](../../code-runtime/code-runtime-worker-thread/README.md) — the released TypeScript sibling.
- [Code runtime subsystem reference](../../../docs/subsystems/code-runtime.md) — request/result vocabulary, bindings, and failure taxonomy.
-----
@@ -9,7 +9,7 @@
* the CPython subprocess. The protocol's host-side codec and hostile-frame
* validators are re-exported so every consumer of the wire shares one
* vocabulary.
* @module @deepseek-ai/dsh-code-runtime-python
* @module @deepseek-ai/dsh-experimental-code-runtime-python
*/
import { spawn, type ChildProcessWithoutNullStreams } from 'node:child_process'
@@ -680,7 +680,7 @@ interface LiveRun {
}
/**
* The shipped {@link CodeRuntime} backend registering as `codeRuntime`. Every
* The experimental {@link CodeRuntime} backend (private, not released) registering as `codeRuntime`. Every
* cap is validated config; every long-running operation honors the request's
* `AbortSignal`; every disposer awaits child-process exit.
*/
@@ -3,7 +3,7 @@
* travel on the child's fd 3 (one JSON object per line), leaving stdout/stderr free for the
* program's own output. Host treats every inbound frame as hostile because model code can post
* anything through the same fd; the Python bootstrap trusts host replies.
* @module @deepseek-ai/dsh-code-runtime-python/src/protocol
* @module @deepseek-ai/dsh-experimental-code-runtime-python/src/protocol
*/
/**