SessionBridge v0.1.1
Two-way session bridge between VS Code Copilot Chat and external automation
/ 外部自动化与 VS Code Copilot Chat 之间的双向会话桥
What's new(更新内容)
English
- First Marketplace release:
larsonzh.sessbridgepublished to the VS Code
Extension Marketplace (v0.1.0 initial + v0.1.1 docs update). - Experimental API note: the controlled human-reply participant
(@sbr-review, RFC §5.2) uses proposed APIchatParticipantAdditions; to use
it enable the proposed API for the extension:- Command line:
code --enable-proposed-api=larsonzh.sessbridge - Or Command Palette → Preferences: Configure Runtime Arguments → add
"enable-proposed-api": ["larsonzh.sessbridge"]inargv.json→ restart. - Core delivery modes (
visible/silent/auto) work without this.
- Command line:
extension/README.md(bilingual) now documents install/uninstall of release
artifacts (VSIX + wheel) and the proposed-API enable steps.
简体中文
- 首次上架 Marketplace:
larsonzh.sessbridge已发布到 VS Code 扩展市场
(v0.1.0 首发 + v0.1.1 文档更新)。 - 实验性 API 说明:受控人工回复参与者(
@sbr-review,RFC §5.2)使用 proposed API
chatParticipantAdditions;如需使用请为该扩展启用实验性 API:- 命令行:
code --enable-proposed-api=larsonzh.sessbridge - 或命令面板 → 首选项: 配置运行时参数 → 在
argv.json添加
"enable-proposed-api": ["larsonzh.sessbridge"]→ 重启 VS Code。 - 核心投递模式(
visible/silent/auto)无需启用即可使用。
- 命令行:
extension/README.md(中英)已补充发布物(VSIX + wheel)安装/卸载示例与
实验性 API 启用步骤。
All features (from v0.1.0 / 功能总览)
English
SessionBridge is an independent open-source product that bridges VS Code Copilot
Chat with external automation (unattended tasks such as ProofRail / whois A/B
flows) — delivering messages and capturing responses, with human review at
critical checkpoints. Milestones S0/M1/M2/M3/M4 complete:
- Modes:
visible(chat panel + human exchange),silent(LM API direct,
zero UI, captures AI response),auto(silent → visible fallback) - Session turns (RFC §5.1): silent conversation history — multi-turn context,
health metrics (totalTurns/inputTokensEst),--reset-history,
--no-compress, caps + archiving - Controlled human reply (RFC §5.2):
@sbr-reviewchat participant writes
humanReplyinto the channel;wait --conversation-idconsumes it - Cross-platform clients: Python 3 (primary, stdlib only), PowerShell
compat layer, POSIXsh(no Python/Node dependency) - Legacy compatibility: whois original clients
(ipc_chat_sender.py/Send-IpcChatMessage.ps1) work unchanged via the
compat mode (verified end-to-end on real VS Code) - CI: three-platform matrix (Linux/macOS/Windows) + real VS Code runtime
smoke + release artifacts (vsix + wheel + SHA256) - Protocol spec:
docs/RFC-sessbridge-channel-protocol-v1.md
简体中文
SessionBridge 是一个独立开源产品:让外部脚本、无人值守任务(如 ProofRail / whois A/B
流程)与 VS Code Copilot Chat 双向交互——既能投递消息,也能接收并捕获回复,支撑任务
关键节点的人工审核与确认。里程碑 S0/M1/M2/M3/M4 全部完成:
- 三种模式:
visible(聊天面板 + 人工交互)、silent(LM API 直达、零 UI、捕获 AI
响应)、auto(silent 失败自动回退 visible) - 会话回合(RFC §5.1):静默会话历史——多轮上下文、健康度回显(
totalTurns/
inputTokensEst)、--reset-history、--no-compress、上限与归档 - 受控人工回复(RFC §5.2):
@sbr-review聊天参与者把humanReply写入通道;
wait --conversation-id消费 - 跨平台客户端:Python 3(主实现,仅标准库)、PowerShell 兼容层、POSIX
sh
(无 Python/Node 依赖) - 旧协议兼容:whois 原始客户端(
ipc_chat_sender.py/Send-IpcChatMessage.ps1)
经兼容模式零改动即可继续使用(真实 VS Code 端到端验证通过) - CI:三平台矩阵(Linux/macOS/Windows)+ 真实 VS Code runtime smoke + 发布物
(vsix + wheel + SHA256) - 协议规范:
docs/RFC-sessbridge-channel-protocol-v1.md
Assets
| File | Notes |
|---|---|
sessbridge-0.1.1.vsix |
VS Code extension package (Marketplace larsonzh.sessbridge v0.1.1; install via code --install-extension) |
sessbridge-0.1.0-py3-none-any.whl |
Python client (sessbridge module; console script; unchanged from v0.1.0) |
SHA256SUMS |
sha256 checksums for the above |
Install / uninstall (示例)
1) VS Code extension (sessbridge-0.1.1.vsix)
# Install (downloaded .vsix or local dist/)
code --install-extension sessbridge-0.1.1.vsix
# Uninstall (extension id = <publisher>.<name>)
code --uninstall-extension larsonzh.sessbridgeAlso via VS Code UI: Extensions → ... → Install from VSIX....
Marketplace: search SessionBridge or install directly from
https://marketplace.visualstudio.com/items?itemName=larsonzh.sessbridge
For
@sbr-review, enable the proposed API first (see What's new above).
2) Python client (sessbridge-0.1.0-py3-none-any.whl)
# Install (stdlib only; no dependencies)
python -m pip install sessbridge-0.1.0-py3-none-any.whl
# Verify
sessbridge --help # console script (Scripts dir on PATH)
python -m sessbridge --help # always available
# Uninstall
python -m pip uninstall sessbridge支持 Python 3.8+;仅标准库,无第三方依赖。
Checksums
See SHA256SUMS in this release.