SessionBridge v0.1.0

SessionBridge v0.1.0

Two-way session bridge between VS Code Copilot Chat and external automation
/ 外部自动化与 VS Code Copilot Chat 之间的双向会话桥

Release notes（发布说明）

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.

This is the first official release (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-review chat participant writes
  humanReply into the channel; wait --conversation-id consumes it
• Cross-platform clients: Python 3 (primary, stdlib only), PowerShell
  compat layer, POSIX sh (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.0.vsix	VS Code extension package (install via code --install-extension)
sessbridge-0.1.0-py3-none-any.whl	Python client (sessbridge module; console script)
SHA256SUMS	sha256 checksums for the above

Install / uninstall (示例)

1) VS Code extension (sessbridge-0.1.0.vsix)

# Install (downloaded .vsix or local dist/)
code --install-extension sessbridge-0.1.0.vsix
# Uninstall (extension id = <publisher>.<name>)
code --uninstall-extension larsonzh.sessbridge

Also via VS Code UI: Extensions → ... → Install from VSIX....

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.