Skip to content

SessionBridge v0.1.1

Latest

Choose a tag to compare

@larsonzh larsonzh released this 05 Sep 14:51

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.sessbridge published 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 API chatParticipantAdditions; 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"] in argv.json → restart.
    • Core delivery modes (visible/silent/auto) work without this.
  • extension/README.md (bilingual) now documents install/uninstall of release
    artifacts (VSIX + wheel) and the proposed-API enable steps.

简体中文

  • 首次上架 Marketplacelarsonzh.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-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.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.sessbridge

Also 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.