session-peer 0.9.0__tar.gz → 0.9.2__tar.gz

{session_peer-0.9.0 → session_peer-0.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: session-peer
-Version: 0.9.0
+Version: 0.9.2
 Summary: Message coding agent sessions locally and over SSH
 Project-URL: Homepage, https://github.com/abruption/session-peer
 Project-URL: Repository, https://github.com/abruption/session-peer
@@ -82,8 +82,23 @@ threads may be inactive. Ask for an explicit reply when completion matters.
 
 ## Installation options
 
-Use `pipx` or `uv`, or run `python -m pip install session-peer` in an activated
-virtual environment. For the standalone CLI plus the agent skill:
+Install the Python CLI with `pipx` or `uv`, or run
+`python -m pip install session-peer` in an activated virtual environment.
+Install the agent skill separately for Claude Code, Codex, and Antigravity:
+
+```bash
+npx -y skills@latest add abruption/session-peer \
+  --skill session-peer --global \
+  --agent claude-code --agent codex --agent antigravity --copy --yes
+```
+
+This writes `SKILL.md` to `~/.claude/skills/session-peer/` and the shared
+`~/.agents/skills/session-peer/` path used for Codex and Antigravity. Update it
+independently with
+`npx -y skills@latest update session-peer --global --yes`. The currently
+verified `skills@1.7.0` requires Node.js 22.20 or newer.
+
+For a standalone POSIX installation without the skills CLI:
 
 ```bash
 git clone https://github.com/abruption/session-peer

{session_peer-0.9.0 → session_peer-0.9.2}/README.ja.md

@@ -47,8 +47,22 @@ session-peer自体をインストールする必要はありません。
 
 ## インストール方法
 
-`pipx`や`uv`、または有効化した仮想環境で`python -m pip install session-peer`を使えます。
-単独実行CLIとエージェントスキルをまとめてインストールするには:
+Python CLIは`pipx`や`uv`、または有効化した仮想環境で
+`python -m pip install session-peer`を実行してインストールします。Claude Code、
+Codex、Antigravity用のエージェントスキルは別にインストールします。
+
+```bash
+npx -y skills@latest add abruption/session-peer \
+  --skill session-peer --global \
+  --agent claude-code --agent codex --agent antigravity --copy --yes
+```
+
+このコマンドは`SKILL.md`を`~/.claude/skills/session-peer/`と、CodexとAntigravityが共有する
+`~/.agents/skills/session-peer/`にインストールします。更新は
+`npx -y skills@latest update session-peer --global --yes`で別途行ってください。
+検証済みの`skills@1.7.0`にはNode.js 22.20以降が必要です。
+
+skills CLIを使わずPOSIX向けの単独実行方式でインストールするには:
 
 ```bash
 git clone https://github.com/abruption/session-peer

{session_peer-0.9.0 → session_peer-0.9.2}/README.ko.md

@@ -47,8 +47,22 @@ session-peer를 별도로 설치할 필요는 없어요.
 
 ## 설치 방법
 
-`pipx`·`uv`를 사용하거나 활성화된 가상 환경에서 `python -m pip install session-peer`를 실행하세요.
-독립 실행 CLI와 에이전트 스킬을 함께 설치하려면:
+Python CLI는 `pipx`·`uv`를 사용하거나 활성화된 가상 환경에서
+`python -m pip install session-peer`를 실행해 설치하세요. Claude Code·Codex·Antigravity용
+에이전트 스킬은 별도로 설치합니다.
+
+```bash
+npx -y skills@latest add abruption/session-peer \
+  --skill session-peer --global \
+  --agent claude-code --agent codex --agent antigravity --copy --yes
+```
+
+이 명령은 `SKILL.md`를 `~/.claude/skills/session-peer/`와 Codex·Antigravity가 함께
+사용하는 `~/.agents/skills/session-peer/`에 설치해요. 업데이트는
+`npx -y skills@latest update session-peer --global --yes`로 별도 수행하세요.
+현재 검증한 `skills@1.7.0`은 Node.js 22.20 이상이 필요해요.
+
+skills CLI 없이 POSIX 독립 실행 방식으로 설치하려면:
 
 ```bash
 git clone https://github.com/abruption/session-peer

{session_peer-0.9.0 → session_peer-0.9.2}/README.md

@@ -48,8 +48,23 @@ threads may be inactive. Ask for an explicit reply when completion matters.
 
 ## Installation options
 
-Use `pipx` or `uv`, or run `python -m pip install session-peer` in an activated
-virtual environment. For the standalone CLI plus the agent skill:
+Install the Python CLI with `pipx` or `uv`, or run
+`python -m pip install session-peer` in an activated virtual environment.
+Install the agent skill separately for Claude Code, Codex, and Antigravity:
+
+```bash
+npx -y skills@latest add abruption/session-peer \
+  --skill session-peer --global \
+  --agent claude-code --agent codex --agent antigravity --copy --yes
+```
+
+This writes `SKILL.md` to `~/.claude/skills/session-peer/` and the shared
+`~/.agents/skills/session-peer/` path used for Codex and Antigravity. Update it
+independently with
+`npx -y skills@latest update session-peer --global --yes`. The currently
+verified `skills@1.7.0` requires Node.js 22.20 or newer.
+
+For a standalone POSIX installation without the skills CLI:
 
 ```bash
 git clone https://github.com/abruption/session-peer

{session_peer-0.9.0 → session_peer-0.9.2}/README.zh-CN.md

@@ -47,8 +47,22 @@ session-peer send --host worker --to 'codex:<full-thread-uuid>' --message "请
 
 ## 安装方式
 
-可以使用`pipx`或`uv`，也可以在已激活的虚拟环境中运行`python -m pip install session-peer`。
-如需同时安装独立CLI和代理技能：
+使用`pipx`、`uv`，或在已激活的虚拟环境中运行
+`python -m pip install session-peer`来安装Python CLI。Claude Code、Codex和Antigravity的
+代理技能需单独安装：
+
+```bash
+npx -y skills@latest add abruption/session-peer \
+  --skill session-peer --global \
+  --agent claude-code --agent codex --agent antigravity --copy --yes
+```
+
+此命令会将`SKILL.md`安装到`~/.claude/skills/session-peer/`，以及Codex和Antigravity共用的
+`~/.agents/skills/session-peer/`。请使用
+`npx -y skills@latest update session-peer --global --yes`单独更新技能。
+目前已验证的`skills@1.7.0`需要Node.js 22.20或更高版本。
+
+如需在不使用skills CLI的情况下进行POSIX独立安装：
 
 ```bash
 git clone https://github.com/abruption/session-peer

{session_peer-0.9.0 → session_peer-0.9.2}/docs/cli-reference.md

@@ -34,8 +34,8 @@ English and Korean reports are welcome.
 
 ## Quick start
 
-Install the CLI with `pipx install session-peer` or `uv tool install session-peer`.
-For the standalone CLI plus Claude skill, see [Install](#install).
+Install the CLI with `pipx install session-peer` or `uv tool install session-peer`,
+then install the skill with the open agent skills CLI. See [Install](#install).
 
 ```bash
 session-peer list                              # Claude, Codex + registered Antigravity
@@ -120,16 +120,23 @@ Or with [pipx](https://pipx.pypa.io/) for an isolated install:
 pipx install session-peer
 ```
 
-Alternatively, use `uv tool install session-peer`.
-Package managers install the `session-peer` command but not the [Claude Code skill](#the-skill).
-To add the skill so Claude can use session-peer on its own:
+Alternatively, use `uv tool install session-peer`. Python package managers own
+the command; install the [agent skill](#the-skill) separately for Claude Code,
+Codex, and Antigravity:
 
 ```bash
-mkdir -p ~/.claude/skills/session-peer
-curl -fsSL -o ~/.claude/skills/session-peer/SKILL.md \
-  https://raw.githubusercontent.com/abruption/session-peer/main/skills/session-peer/SKILL.md
+npx -y skills@latest add abruption/session-peer \
+  --skill session-peer --global \
+  --agent claude-code --agent codex --agent antigravity --copy --yes
 ```
 
+The verified command copies the official repository skill to
+`~/.claude/skills/session-peer/SKILL.md` and the shared
+`~/.agents/skills/session-peer/SKILL.md` path used for Codex and Antigravity.
+At the time of this release,
+`skills@1.7.0` declares Node.js 22.20 or newer. Review skills before installing
+them because agents follow their instructions with the agent's permissions.
+
 ### install.sh
 
 Installs both the command and the skill in one step. Use this for air-gapped
@@ -168,6 +175,9 @@ chmod +x session_peer.py
 
 ### The skill
 
+The recommended `skills` CLI command above installs the same repository-owned
+skill for Claude Code, Codex, and Antigravity and records its source for
+explicit updates.
 The standalone installer puts the program in `~/.local/share/session-peer/`
 and the skill separately in `~/.claude/skills/session-peer/SKILL.md`. Skill placement
 respects `CLAUDE_CONFIG_DIR`, then `ANTHROPIC_CONFIG_DIR`, before the default.
@@ -352,6 +362,17 @@ without replacing package-owned files. `session-peer update --check` checks the
 latest stable GitHub release, refreshes the shared cache, and reports the exact
 upgrade command, but still does not replace those files.
 
+The agent skill has a separate update lifecycle. Refresh global copies installed
+with the skills CLI by running:
+
+```bash
+npx -y skills@latest update session-peer --global --yes
+```
+
+Upgrading session-peer with pip, pipx, or uv intentionally does not modify agent
+configuration directories. Run both upgrades when both the Python command and
+the agent instructions need updating.
+
 For standalone programs:
 
 ```bash
@@ -369,8 +390,10 @@ from GitHub. Remote version probes inspect only
 remote update installs that standalone path and its CLI link. For a
 package-managed remote CLI, upgrade it with its own manager on that host instead.
 
-Neither local nor remote `update` refreshes the Claude skill. Re-run `install.sh`
-from the desired release checkout to refresh both standalone program and skill.
+Neither local nor remote standalone `session-peer update` refreshes its Claude
+skill copy. Re-run `install.sh` from the desired release checkout to refresh
+both standalone program and skill; installations managed by the skills CLI use
+the separate `skills update` command above.
 Local `session-peer update --check` and `session-peer update` also populate the
 same cache used by automatic notices.
 

session_peer-0.9.2/docs/releases/v0.9.1.md

@@ -0,0 +1,26 @@
+# session-peer v0.9.1
+
+This documentation hotfix separates Python package management from agent skill
+management. Install or upgrade the CLI with pip, pipx, or uv, and install the
+official skill for Claude Code, Codex, and Antigravity with the open agent
+skills CLI:
+
+```bash
+npx -y skills@latest add abruption/session-peer \
+  --skill session-peer --global \
+  --agent claude-code --agent codex --agent antigravity --copy --yes
+```
+
+The verified command writes the skill to
+`~/.claude/skills/session-peer/SKILL.md` and the shared
+`~/.agents/skills/session-peer/SKILL.md` path used for Codex and Antigravity.
+Skill updates remain explicit and
+independent from Python package upgrades:
+
+```bash
+npx -y skills@latest update session-peer --global --yes
+```
+
+The validation used `skills@1.7.0`, which declares Node.js 22.20 or newer. This
+release does not add a package-install hook and does not make pip write into
+agent configuration directories.

session_peer-0.9.2/docs/releases/v0.9.2.md

@@ -0,0 +1,42 @@
+# session-peer v0.9.2 — Windows Claude authentication hotfix
+
+Prepared candidate; not yet published.
+
+This patch is based on v0.9.1 and does not include the 1.0 beta/RC features.
+It fixes the authentication envelope sent to native Windows Claude Code named
+pipes. The registry's `peerToken` is now mapped to the wire protocol's `token`
+field, rather than forwarding the registry JSON and process metadata verbatim.
+Malformed key records and missing, empty or non-string tokens are not used.
+
+The bug is present in v0.9.1 and in the initial Windows implementation; it is
+not established to be a Claude Code update regression. On Claude Code 2.1.278,
+the old envelope closes the pipe without delivering the message. An isolated
+test changing only the auth envelope delivered a real message and produced a
+receiver response. Exact ACK and final candidate validation are separate gates.
+
+No permission settings or inbound policies are changed. A successful send
+still reports a transport write, not proof that the agent consumed or accepted
+the message. Existing unknown sends must not be replayed automatically.
+
+The same correction must be carried forward to the 1.0 RC line. This release
+does not add the RC's native Windows Codex writer checks or WSL/native Codex
+bridge. It also improves SSH diagnostics for missing `python3` and Windows Store
+aliases (#151): remote source streaming still requires working Python and a
+POSIX-compatible SSH shell. It does not install Python, change SSH shells or
+automatically resend messages.
+
+## Before publication
+
+- Review the minimal v0.9.1-based diff and run Windows/macOS/Linux CI.
+- Confirm the built wheel and sdist report 0.9.2, exclude the frozen legacy
+  `cc_peer.py`, and preserve the stable package contents.
+- Validate a fresh candidate on native Windows: select the actual interactive
+  receiver, send one unique authorized marker, and observe its exact ACK.
+- Use the maintenance publication path in `RELEASING.md`. It requires protected
+  release/0.9.x tip, a merged PR and successful push CI for that exact commit,
+  canonical 0.9.x tag/version, pinned v0.9.1 ancestry, clean source, reproducible
+  artifacts, independent installs, dependency audit and pre-upload revalidation.
+  Do not publish from unmerged PR commits, reuse the old v0.9.1 workflow, bypass
+  the release gate, weaken protections or relabel the RC code as 0.9.2.
+- Obtain final approval before creating/publishing the release tag. Verify
+  GitHub and PyPI artifacts after publication; do not overwrite an existing tag.

{session_peer-0.9.0 → session_peer-0.9.2}/pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling==1.32.4"]
 build-backend = "hatchling.build"
 
 [project]
@@ -50,7 +50,7 @@ pattern = '__version__ = "(?P<version>[^"]+)"'
 
 [tool.hatch.build.targets.sdist]
 exclude = ["/experiments"]
-include = ["session_peer_relay", "session_peer.py", "session_peer_mcp.py", "LICENSE", "SECURITY.md", "README.md", "README.ko.md", "README.ja.md", "README.zh-CN.md", "docs/cli-reference.md", "docs/releases/v0.9.0.md", "docs/mcp.md", "docs/wake.md", "docs/multi-home-list.md", "docs/agent-adapters.md", "docs/paired-devices.md", "docs/relay-development-plan.md", "docs/relay-public-pilot-2026-09-17.md", "deploy/session-peer-relay.service", "docs/antigravity.md", "docs/validation/85-antigravity.md", "docs/architecture/agent-transports.md", "plugins", ".agents/plugins/marketplace.json"]
+include = ["session_peer_relay", "session_peer.py", "session_peer_mcp.py", "LICENSE", "SECURITY.md", "README.md", "README.ko.md", "README.ja.md", "README.zh-CN.md", "docs/cli-reference.md", "docs/releases/v0.9.0.md", "docs/releases/v0.9.1.md", "docs/releases/v0.9.2.md", "docs/mcp.md", "docs/wake.md", "docs/multi-home-list.md", "docs/agent-adapters.md", "docs/paired-devices.md", "docs/relay-development-plan.md", "docs/relay-public-pilot-2026-09-17.md", "deploy/session-peer-relay.service", "docs/antigravity.md", "docs/validation/85-antigravity.md", "docs/architecture/agent-transports.md", "plugins", ".agents/plugins/marketplace.json"]
 
 [tool.hatch.build.targets.wheel]
 only-include = ["session_peer_relay", "session_peer.py", "session_peer_mcp.py"]

{session_peer-0.9.0 → session_peer-0.9.2}/session_peer.py

@@ -42,7 +42,7 @@ try:
 except ImportError:  # Windows has no POSIX flock; activity stays unknown there.
     fcntl = None
 
-__version__ = "0.9.0"
+__version__ = "0.9.2"
 GITHUB_REPO = "abruption/session-peer"
 
 # Claude Code refuses a same-machine message once its serialized form passes
@@ -1013,9 +1013,15 @@ def _read_win_auth(pid: int) -> str | None:
             data = json.loads(key_file.read_text(encoding="utf-8"))
         except (OSError, ValueError):
             continue
-        auth = {"type": "auth"}
-        auth.update(data)
-        return json.dumps(auth, ensure_ascii=False)
+        if not isinstance(data, dict):
+            continue
+        token = data.get("peerToken")
+        if not isinstance(token, str) or not token.strip():
+            continue
+        # The registry schema is not the wire protocol. Windows requires a
+        # first-line {"type": "auth", "token": ...}; forwarding peerToken and
+        # process metadata verbatim causes the receiver to drop the connection.
+        return json.dumps({"type": "auth", "token": token}, ensure_ascii=False)
     return None
 
 
@@ -1687,6 +1693,20 @@ def run_remote(host: str, argv: list[str], ssh_opts: list[str]) -> dict:
     )
     if failure:
         raise ssh_failure_error(host, ssh_info, failure, detail)
+    runtime_output = (completed.stdout + "\n" + completed.stderr).strip().lower()
+    if (runtime_output == "python"
+            or "python was not found" in runtime_output
+            or ("python3" in runtime_output and any(marker in runtime_output for marker in (
+                "command not found", "not recognized as", "no such file", "python3: not found",
+            )))):
+        raise CcPeerError(
+            f"{host}: remote python3 did not start a usable interpreter. "
+            "Source-streamed SSH requires a working python3 and a POSIX-compatible "
+            "remote shell. A Windows Store execution alias is not sufficient. "
+            "For native Windows, run the installed CLI locally, or use a WSL SSH "
+            "endpoint with Python installed. No fallback or resend was attempted.",
+            {**ssh_info, "remoteRuntimeFailure": "python3_unavailable_or_unsupported_shell"},
+        )
     if not stdout:
         raise CcPeerError(f"{host}: {detail}", ssh_info)
     try: