macos-computer-use-kit 0.2.0__tar.gz → 0.2.2__tar.gz

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/CHANGELOG.md

@@ -3,6 +3,28 @@
 All notable changes to this project. The CLI, the pi package, and the dsh bundle
 share a version number.
 
+## 0.2.2
+
+Discoverability and parity for the optional Jev (TypeSafe System One) guards.
+
+- **The dsh bundle now exposes `macos_jev_guard`** — the same optional semantic
+  guard the pi package already had — so both integrations carry the capability
+  they advertise (6 tools instead of 5). The bridge gained stdin support, which
+  is how `macos-cu jev` receives its JSON request.
+- npm keywords gain `jev`, `typesafe-ai`, `system-one-models`; PyPI keywords gain
+  `jev`, `typesafe-ai`, `system-one`, `llm-guardrails`. Keywords are immutable
+  per version, which is why this needed a release rather than an edit.
+- Declare the `Programming Language :: Python :: 3.14` classifier. The wheel has
+  installed and run on 3.14 since 0.2.0; only the metadata was behind.
+
+No behaviour changes outside the new tool.
+
+## 0.2.1
+
+- Publish the Python package metadata with an SPDX license expression
+  (`license = "MIT"` + `license-files`, PEP 639) instead of embedding the full
+  MIT text in the metadata `License` field. No code or behaviour changes.
+
 ## 0.2.0
 
 First release meant for use outside the machine it was built on.

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/PKG-INFO

@@ -1,33 +1,13 @@
 Metadata-Version: 2.5
 Name: macos-computer-use-kit
-Version: 0.2.0
+Version: 0.2.2
 Summary: AX-first computer-use toolkit for AI agents on macOS: accessibility-tree targeting, process-scoped input, clipboard-safe paste, action read-back verification, visual feedback, and optional Jev semantic guards.
 Project-URL: Homepage, https://github.com/Sur-Cai/macos-computer-use-kit
 Project-URL: Repository, https://github.com/Sur-Cai/macos-computer-use-kit
 Project-URL: Issues, https://github.com/Sur-Cai/macos-computer-use-kit/issues
-License: MIT License
-        
-        Copyright (c) 2026 Sur-Cai
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
+License-Expression: MIT
 License-File: LICENSE
-Keywords: accessibility,agent-tools,ai-agent,automation,computer-use,dsh-plugin,macos,opencode,pi-package
+Keywords: accessibility,agent-tools,ai-agent,automation,computer-use,dsh-plugin,jev,llm-guardrails,macos,opencode,pi-package,system-one,typesafe-ai
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: MacOS X :: Cocoa
 Classifier: Intended Audience :: Developers
@@ -38,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: User Interfaces
 Requires-Python: >=3.10
 Requires-Dist: pillow>=10.0
@@ -50,6 +31,13 @@ Description-Content-Type: text/markdown
 
 # macos-computer-use-kit
 
+[![PyPI](https://img.shields.io/pypi/v/macos-computer-use-kit)](https://pypi.org/project/macos-computer-use-kit/)
+[![Python versions](https://img.shields.io/pypi/pyversions/macos-computer-use-kit)](https://pypi.org/project/macos-computer-use-kit/)
+[![pi package](https://img.shields.io/npm/v/pi-macos-computer-use)](https://www.npmjs.com/package/pi-macos-computer-use)
+[![dsh plugin](https://img.shields.io/npm/v/dsh-macos-computer-use)](https://www.npmjs.com/package/dsh-macos-computer-use)
+[![CI](https://github.com/Sur-Cai/macos-computer-use-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/Sur-Cai/macos-computer-use-kit/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
 **AX-first computer use for AI agents on macOS.** Instead of screenshot → eyeball
 coordinates → click and hope, read the accessibility tree, get each element's
 semantics and exact geometry, act on it, then verify the action actually changed
@@ -60,6 +48,14 @@ window-scoped input, clipboard-safe pasting, action read-back verification,
 blank-frame detection, visual feedback, and optional Jev (TypeSafe System One)
 semantic guards.
 
+**Jev is the semantic guard layer.** A small model — no reasoning tokens, no
+prose — returns calibrated judgments right before an irreversible action: *is
+this still the intended recipient? does the field hold the intended text? what,
+if anything, blocks the action?* The code, not the model, decides whether to
+proceed, and the model may only ever suggest the two recoveries that cannot send
+or submit anything. Probabilities in, decisions out. See
+[Jev semantic guards](#jev-semantic-guards-optional).
+
 Works with any agent that can run a shell command, and ships first-class
 packages for [pi](#pi) and [DeepSeek Harness](#deepseek-harness-dsh).
 
@@ -79,10 +75,19 @@ invented from scratch:
 macOS 12+, Python 3.10+.
 
 ```bash
-pip install macos-computer-use-kit        # or: pipx install macos-computer-use-kit
-macos-cu doctor                           # check permissions, displays, dependencies
+# 1) the CLI — every integration below drives this, and it works on its own
+pip install macos-computer-use-kit       # or: pipx install macos-computer-use-kit
+macos-cu doctor                          # permissions, displays, dependencies
+
+# 2) your agent integration (optional — pick one)
+pi  install npm:pi-macos-computer-use                       # pi
+dsh plugin --profile <name> add dsh-macos-computer-use      # DeepSeek Harness
+```
 
-# from a checkout (editable install + agent skill)
+From a checkout — this is also the opencode integration (editable CLI, the
+`macos-computer-use` skill, a `macos-cu` launcher, and the optional Jev key):
+
+```bash
 git clone https://github.com/Sur-Cai/macos-computer-use-kit && cd macos-computer-use-kit
 ./install.sh
 ```
@@ -152,23 +157,30 @@ coordinates. That is normal. `macos-cu doctor` prints the layout.
 
 | Harness | What you get | Install |
 | --- | --- | --- |
-| any agent with a shell | the full CLI | `pip install macos-computer-use-kit` |
+| any agent with a shell | the full CLI ([PyPI](https://pypi.org/project/macos-computer-use-kit/)) | `pip install macos-computer-use-kit` |
 | [opencode](https://opencode.ai) | skill `macos-computer-use` (auto-discovered) | `./install.sh` |
-| [pi](https://pi.dev) | skill + 9 native tools | `pi install npm:pi-macos-computer-use` |
-| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | plugin bundle, 5 tools | `dsh plugin --profile <name> add dsh-macos-computer-use` |
+| [pi](https://pi.dev) | skill + 9 native tools ([npm](https://www.npmjs.com/package/pi-macos-computer-use), [catalog](https://pi.dev/packages/pi-macos-computer-use)) | `pi install npm:pi-macos-computer-use` |
+| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | plugin bundle, 6 tools ([npm](https://www.npmjs.com/package/dsh-macos-computer-use)) | `dsh plugin --profile <name> add dsh-macos-computer-use` |
+
+Every integration is a thin bridge over the same CLI, so install the CLI first
+(`pip install macos-computer-use-kit`). The three published artifacts — the PyPI
+CLI, the pi package, and the dsh bundle — are versioned and released together;
+the badges at the top of this file show the current release.
 
 <a name="pi"></a>
 ### pi package
 
-`packages/pi` — `pi-macos-computer-use` (npm, `pi-package` keyword). Registers
+[`pi-macos-computer-use`](https://www.npmjs.com/package/pi-macos-computer-use) on
+npm (`pi-package` keyword), sources in `packages/pi`. Registers
 `macos_cu_doctor`, `macos_ax_find`, `macos_ax_press`, `macos_input_windows`,
 `macos_input_click`, `macos_input_key`, `macos_paste`, `macos_shot`,
 `macos_jev_guard`. Every tool shells out with an argv array (`shell: false`), so
 model-supplied text can never reach a shell.
 
 ```bash
-pi install npm:pi-macos-computer-use
-pi -e ./packages/pi        # try it for one run without installing
+pip install macos-computer-use-kit      # the CLI the tools call
+pi install npm:pi-macos-computer-use    # the integration
+pi -e ./packages/pi                     # or try a checkout for one run, without installing
 ```
 
 App launchers do not inherit your interactive shell's `PATH`. If the CLI is
@@ -178,13 +190,16 @@ restart pi (the dsh plugin honours the same variable).
 <a name="deepseek-harness-dsh"></a>
 ### DeepSeek Harness plugin
 
-`packages/dsh` — `dsh-macos-computer-use`, a Cordis bundle
+[`dsh-macos-computer-use`](https://www.npmjs.com/package/dsh-macos-computer-use)
+on npm, sources in `packages/dsh` — a Cordis bundle
 (`dsh.bundle.patch` → `cordis.patch.yml`). Registers `macos_cu_doctor`,
-`macos_ax_find`, `macos_ax_press`, `macos_input_click`, `macos_shot`.
+`macos_ax_find`, `macos_ax_press`, `macos_input_click`, `macos_shot`,
+`macos_jev_guard` (the same optional Jev guard the pi package exposes).
 
 ```bash
-dsh plugin --profile demo add dsh-macos-computer-use
-dsh --profile demo --dump-config    # verify the layer before booting
+pip install macos-computer-use-kit                      # the CLI the tools call
+dsh plugin --profile demo add dsh-macos-computer-use    # the plugin
+dsh --profile demo --dump-config                        # verify the layer before booting
 ```
 
 It deliberately does **not** claim the exclusive `ctx.computerUse` provider slot:
@@ -195,7 +210,7 @@ in-box Cua Driver provider. See `packages/dsh/README.md`.
 
 `./install.sh` installs `skill/SKILL.md` to
 `~/.config/opencode/skills/macos-computer-use/`, where opencode discovers it
-automatically.
+automatically, and puts a `macos-cu` launcher on your `PATH`.
 
 ## The four capabilities that matter
 
@@ -295,13 +310,19 @@ Release steps and catalog-listing criteria live in
 可视反馈，以及可选的 Jev 语义护栏。
 
 ```bash
-pip install macos-computer-use-kit
-macos-cu doctor          # 检查辅助功能 / 屏幕录制权限、显示器、依赖、Jev
+# 1) 命令行本体（所有集成都调它，也可单独使用）
+pip install macos-computer-use-kit       # 或 pipx install macos-computer-use-kit
+macos-cu doctor                          # 检查辅助功能 / 屏幕录制权限、显示器、依赖、Jev
+
+# 2) 选一个 agent 集成
+pi  install npm:pi-macos-computer-use                       # pi
+dsh plugin --profile <名> add dsh-macos-computer-use        # DeepSeek Harness
 ```
 
-Agent 集成：`./install.sh`（opencode skill）、`pi install npm:pi-macos-computer-use`（pi）、
-`dsh plugin --profile <名> add dsh-macos-computer-use`（DeepSeek Harness）。
-完整流程与避坑见 [`skill/SKILL.md`](skill/SKILL.md)。
+opencode 的集成走 checkout：`git clone` 后执行 `./install.sh`，它会装 skill、放一个
+`macos-cu` 启动器，并可写入可选的 Jev key。完整流程与避坑见
+[`skill/SKILL.md`](skill/SKILL.md)，发布与收录流程见
+[`PUBLISHING.md`](PUBLISHING.md)。
 
 ## License
 

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/PUBLISHING.md

@@ -1,7 +1,12 @@
 # Publishing this toolkit
 
+> Maintainer document, public on purpose: a fork should be able to release under
+> its own npm/PyPI names without reverse-engineering this layout. Nothing here is
+> secret — no credentials, no private infrastructure, no deploy internals.
+
 Three artifacts can be published from this repository, all versioned in lockstep
-with the CLI (`0.2.0` today):
+with the CLI (bump `pyproject.toml`, `packages/pi/package.json`, and
+`packages/dsh/package.json` together):
 
 | Artifact | Registry | Command |
 | --- | --- | --- |
@@ -76,7 +81,7 @@ Users install with:
 
 ```bash
 dsh plugin --profile <name> add dsh-macos-computer-use        # from npm (recommended)
-dsh plugin --profile <name> add ./dsh-macos-computer-use-0.2.0.tgz   # from a packed tarball
+dsh plugin --profile <name> add ./dsh-macos-computer-use-<version>.tgz   # from a packed tarball
 ```
 
 The npm and tarball forms ship the prebuilt `lib/`, so no build permission is
@@ -88,12 +93,22 @@ that root-mounts the package. Prefer npm or the tarball for distribution.
 ## Catalog listings
 
 - **pi**: publishing to npm is enough — the gallery at <https://pi.dev/packages>
-  lists packages tagged `pi-package`. Optionally add a `pi.image` or
-  `pi.video` preview to `packages/pi/package.json` for a richer card.
+  lists packages tagged `pi-package`. This is confirmed working: the page for
+  `pi-macos-computer-use` appeared shortly after the npm publish. Optionally add
+  a `pi.image` or `pi.video` preview to `packages/pi/package.json` for a richer
+  card.
 - **dsh**: add the `dsh-plugin` GitHub topic, then open a PR against
-  [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
-  (their bar: installs with `dsh plugin add`, does what its one-line description
-  says, right category, maintained). There is also
+  [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin).
+  Submissions are **one YAML file per plugin** under `data/plugins/` — never edit
+  the generated READMEs. For this monorepo the file is
+  `data/plugins/Sur-Cai__macos-computer-use-kit--packages-dsh.yml`, with `url`
+  pointing at `.../tree/main/packages/dsh` and `name` written as
+  `Sur-Cai/macos-computer-use-kit#packages/dsh`.
+
+  Their CI enforces a **1-day minimum repository age** (ours was created
+  2026-09-22T10:22Z, so the earliest valid submission is the next day at the same
+  time) and at most 3 entries per PR. Descriptions are checked against the code,
+  so keep numbers and tool names exact. There is also
   [dsh-market](https://github.com/dsh-market/dsh-market) for in-app discovery.
 
 ## Release checklist
@@ -105,5 +120,18 @@ macos-cu doctor                   # permissions still granted after reinstalling
 (cd packages/dsh && npm run typecheck && npm run build)
 ```
 
-Then tag (`git tag v0.2.0 && git push --tags`) and publish the artifacts you
+Then tag (`git tag v<version> && git push --tags`) and publish the artifacts you
 intend to ship.
+
+## Current release state
+
+| Artifact | Published | Notes |
+| --- | --- | --- |
+| `macos-computer-use-kit` | PyPI `0.2.1` | `pip install macos-computer-use-kit` |
+| `pi-macos-computer-use` | npm `0.2.1` | listed on pi.dev/packages |
+| `dsh-macos-computer-use` | npm `0.2.1` | awesome-dsh-plugin PR pending |
+
+Known follow-ups: the PyPI `Programming Language :: Python :: 3.14` classifier is
+not set (the wheel installs and runs on 3.14 — verified — but the badge stops at
+3.13 until the next release adds it), and the dsh catalog PR is gated on the
+1-day repository-age rule.

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/README.md

@@ -1,5 +1,12 @@
 # macos-computer-use-kit
 
+[![PyPI](https://img.shields.io/pypi/v/macos-computer-use-kit)](https://pypi.org/project/macos-computer-use-kit/)
+[![Python versions](https://img.shields.io/pypi/pyversions/macos-computer-use-kit)](https://pypi.org/project/macos-computer-use-kit/)
+[![pi package](https://img.shields.io/npm/v/pi-macos-computer-use)](https://www.npmjs.com/package/pi-macos-computer-use)
+[![dsh plugin](https://img.shields.io/npm/v/dsh-macos-computer-use)](https://www.npmjs.com/package/dsh-macos-computer-use)
+[![CI](https://github.com/Sur-Cai/macos-computer-use-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/Sur-Cai/macos-computer-use-kit/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
 **AX-first computer use for AI agents on macOS.** Instead of screenshot → eyeball
 coordinates → click and hope, read the accessibility tree, get each element's
 semantics and exact geometry, act on it, then verify the action actually changed
@@ -10,6 +17,14 @@ window-scoped input, clipboard-safe pasting, action read-back verification,
 blank-frame detection, visual feedback, and optional Jev (TypeSafe System One)
 semantic guards.
 
+**Jev is the semantic guard layer.** A small model — no reasoning tokens, no
+prose — returns calibrated judgments right before an irreversible action: *is
+this still the intended recipient? does the field hold the intended text? what,
+if anything, blocks the action?* The code, not the model, decides whether to
+proceed, and the model may only ever suggest the two recoveries that cannot send
+or submit anything. Probabilities in, decisions out. See
+[Jev semantic guards](#jev-semantic-guards-optional).
+
 Works with any agent that can run a shell command, and ships first-class
 packages for [pi](#pi) and [DeepSeek Harness](#deepseek-harness-dsh).
 
@@ -29,10 +44,19 @@ invented from scratch:
 macOS 12+, Python 3.10+.
 
 ```bash
-pip install macos-computer-use-kit        # or: pipx install macos-computer-use-kit
-macos-cu doctor                           # check permissions, displays, dependencies
+# 1) the CLI — every integration below drives this, and it works on its own
+pip install macos-computer-use-kit       # or: pipx install macos-computer-use-kit
+macos-cu doctor                          # permissions, displays, dependencies
+
+# 2) your agent integration (optional — pick one)
+pi  install npm:pi-macos-computer-use                       # pi
+dsh plugin --profile <name> add dsh-macos-computer-use      # DeepSeek Harness
+```
 
-# from a checkout (editable install + agent skill)
+From a checkout — this is also the opencode integration (editable CLI, the
+`macos-computer-use` skill, a `macos-cu` launcher, and the optional Jev key):
+
+```bash
 git clone https://github.com/Sur-Cai/macos-computer-use-kit && cd macos-computer-use-kit
 ./install.sh
 ```
@@ -102,23 +126,30 @@ coordinates. That is normal. `macos-cu doctor` prints the layout.
 
 | Harness | What you get | Install |
 | --- | --- | --- |
-| any agent with a shell | the full CLI | `pip install macos-computer-use-kit` |
+| any agent with a shell | the full CLI ([PyPI](https://pypi.org/project/macos-computer-use-kit/)) | `pip install macos-computer-use-kit` |
 | [opencode](https://opencode.ai) | skill `macos-computer-use` (auto-discovered) | `./install.sh` |
-| [pi](https://pi.dev) | skill + 9 native tools | `pi install npm:pi-macos-computer-use` |
-| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | plugin bundle, 5 tools | `dsh plugin --profile <name> add dsh-macos-computer-use` |
+| [pi](https://pi.dev) | skill + 9 native tools ([npm](https://www.npmjs.com/package/pi-macos-computer-use), [catalog](https://pi.dev/packages/pi-macos-computer-use)) | `pi install npm:pi-macos-computer-use` |
+| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | plugin bundle, 6 tools ([npm](https://www.npmjs.com/package/dsh-macos-computer-use)) | `dsh plugin --profile <name> add dsh-macos-computer-use` |
+
+Every integration is a thin bridge over the same CLI, so install the CLI first
+(`pip install macos-computer-use-kit`). The three published artifacts — the PyPI
+CLI, the pi package, and the dsh bundle — are versioned and released together;
+the badges at the top of this file show the current release.
 
 <a name="pi"></a>
 ### pi package
 
-`packages/pi` — `pi-macos-computer-use` (npm, `pi-package` keyword). Registers
+[`pi-macos-computer-use`](https://www.npmjs.com/package/pi-macos-computer-use) on
+npm (`pi-package` keyword), sources in `packages/pi`. Registers
 `macos_cu_doctor`, `macos_ax_find`, `macos_ax_press`, `macos_input_windows`,
 `macos_input_click`, `macos_input_key`, `macos_paste`, `macos_shot`,
 `macos_jev_guard`. Every tool shells out with an argv array (`shell: false`), so
 model-supplied text can never reach a shell.
 
 ```bash
-pi install npm:pi-macos-computer-use
-pi -e ./packages/pi        # try it for one run without installing
+pip install macos-computer-use-kit      # the CLI the tools call
+pi install npm:pi-macos-computer-use    # the integration
+pi -e ./packages/pi                     # or try a checkout for one run, without installing
 ```
 
 App launchers do not inherit your interactive shell's `PATH`. If the CLI is
@@ -128,13 +159,16 @@ restart pi (the dsh plugin honours the same variable).
 <a name="deepseek-harness-dsh"></a>
 ### DeepSeek Harness plugin
 
-`packages/dsh` — `dsh-macos-computer-use`, a Cordis bundle
+[`dsh-macos-computer-use`](https://www.npmjs.com/package/dsh-macos-computer-use)
+on npm, sources in `packages/dsh` — a Cordis bundle
 (`dsh.bundle.patch` → `cordis.patch.yml`). Registers `macos_cu_doctor`,
-`macos_ax_find`, `macos_ax_press`, `macos_input_click`, `macos_shot`.
+`macos_ax_find`, `macos_ax_press`, `macos_input_click`, `macos_shot`,
+`macos_jev_guard` (the same optional Jev guard the pi package exposes).
 
 ```bash
-dsh plugin --profile demo add dsh-macos-computer-use
-dsh --profile demo --dump-config    # verify the layer before booting
+pip install macos-computer-use-kit                      # the CLI the tools call
+dsh plugin --profile demo add dsh-macos-computer-use    # the plugin
+dsh --profile demo --dump-config                        # verify the layer before booting
 ```
 
 It deliberately does **not** claim the exclusive `ctx.computerUse` provider slot:
@@ -145,7 +179,7 @@ in-box Cua Driver provider. See `packages/dsh/README.md`.
 
 `./install.sh` installs `skill/SKILL.md` to
 `~/.config/opencode/skills/macos-computer-use/`, where opencode discovers it
-automatically.
+automatically, and puts a `macos-cu` launcher on your `PATH`.
 
 ## The four capabilities that matter
 
@@ -245,13 +279,19 @@ Release steps and catalog-listing criteria live in
 可视反馈，以及可选的 Jev 语义护栏。
 
 ```bash
-pip install macos-computer-use-kit
-macos-cu doctor          # 检查辅助功能 / 屏幕录制权限、显示器、依赖、Jev
+# 1) 命令行本体（所有集成都调它，也可单独使用）
+pip install macos-computer-use-kit       # 或 pipx install macos-computer-use-kit
+macos-cu doctor                          # 检查辅助功能 / 屏幕录制权限、显示器、依赖、Jev
+
+# 2) 选一个 agent 集成
+pi  install npm:pi-macos-computer-use                       # pi
+dsh plugin --profile <名> add dsh-macos-computer-use        # DeepSeek Harness
 ```
 
-Agent 集成：`./install.sh`（opencode skill）、`pi install npm:pi-macos-computer-use`（pi）、
-`dsh plugin --profile <名> add dsh-macos-computer-use`（DeepSeek Harness）。
-完整流程与避坑见 [`skill/SKILL.md`](skill/SKILL.md)。
+opencode 的集成走 checkout：`git clone` 后执行 `./install.sh`，它会装 skill、放一个
+`macos-cu` 启动器，并可写入可选的 Jev key。完整流程与避坑见
+[`skill/SKILL.md`](skill/SKILL.md)，发布与收录流程见
+[`PUBLISHING.md`](PUBLISHING.md)。
 
 ## License
 

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/packages/dsh/README.md

@@ -4,7 +4,7 @@ DeepSeek Harness (dsh) bundle bridging dsh agents to the
 [macos-computer-use-kit](https://github.com/Sur-Cai/macos-computer-use-kit)
 `macos-cu` CLI: AX-first computer use on macOS.
 
-The plugin registers five focused tools that shell out to `macos-cu` with an
+The plugin registers six focused tools that shell out to `macos-cu` with an
 argument array (never shell-string concatenation) and return the CLI's JSON
 output:
 
@@ -15,6 +15,7 @@ output:
 | `macos_ax_press` | `macos-cu ax press\|setvalue` | Native AX action with read-back verification |
 | `macos_input_click` | `macos-cu input click` | Window-scoped click that never moves the user's cursor |
 | `macos_shot` | `macos-cu shot capture\|check\|windows` | Blank-frame-checked screenshots for verification only |
+| `macos_jev_guard` | `macos-cu jev guard\|select` | Optional Jev semantic guard before an irreversible action (needs `TYPESAFE_API_KEY`) |
 
 The AX-first intent is baked into every tool description: locate elements via
 `macos_ax_find` and use the returned geometry — use instead of guessing

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/packages/dsh/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-macos-computer-use",
-  "version": "0.2.0",
-  "description": "AX-first computer use on macOS for DeepSeek Harness: accessibility-tree targeting instead of screenshot coordinate guessing, window-scoped input, action read-back verification, and blank-frame-checked screenshots, bridged to the macos-cu CLI.",
+  "version": "0.2.2",
+  "description": "AX-first computer use on macOS for DeepSeek Harness: accessibility-tree targeting instead of screenshot coordinate guessing, window-scoped input, action read-back verification, blank-frame-checked screenshots, and optional Jev (TypeSafe System One) semantic guards before irreversible actions \u2014 bridged to the macos-cu CLI.",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -31,7 +31,10 @@
     "accessibility-tree",
     "automation",
     "gui-automation",
-    "agent-tools"
+    "agent-tools",
+    "jev",
+    "typesafe-ai",
+    "system-one-models"
   ],
   "homepage": "https://github.com/Sur-Cai/macos-computer-use-kit#readme",
   "repository": {

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/packages/dsh/src/index.ts

@@ -148,6 +148,44 @@ const shot = defineTool({
   },
 })
 
+const jevGuard = defineTool({
+  name: 'macos_jev_guard',
+  description: `Optional Jev (TypeSafe System One) semantic guard for the moment before an irreversible action. \`macos-cu jev guard\` fans one request out into calibrated judgments about expected versus observed state (right_target, input_ok, blocker, next_action) plus a decision, and \`macos-cu jev select\` picks one candidate element id with a confidence gate and a 'none' escape hatch. Use it only for semantic identity/state/effect questions that ordinary code cannot decide — never for blank-frame detection or signature comparison. Requires TYPESAFE_API_KEY or ~/.config/typesafe/api_key; the rest of this plugin works without it. The JSON request is sent on stdin.`,
+  parameters: {
+    command: {
+      type: 'string',
+      required: true,
+      enum: ['guard', 'select'],
+      description: 'guard = pre-action judgment; select = pick an element id from candidates.',
+    },
+    payload: {
+      type: 'string',
+      required: true,
+      description:
+        'JSON request for the CLI stdin. guard: {"task":...,"expected":{...},"observed":{...}}. select: {"goal":...,"candidates":[{"id":...,"text":...}]}.',
+    },
+  },
+  output: OUTPUT,
+  async execute(args, exec) {
+    let parsed: unknown
+    try {
+      parsed = JSON.parse(args.payload)
+    } catch (error) {
+      throw new Error(`macos_jev_guard 'payload' is not valid JSON: ${(error as Error).message}`)
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+      throw new Error("macos_jev_guard 'payload' must be a JSON object.")
+    }
+    if (args.command === 'guard' && !(parsed as { task?: unknown }).task) {
+      throw new Error("macos_jev_guard command='guard' needs a 'task' field in the payload.")
+    }
+    if (args.command === 'select' && !Array.isArray((parsed as { candidates?: unknown }).candidates)) {
+      throw new Error("macos_jev_guard command='select' needs a 'candidates' array in the payload.")
+    }
+    return runMacosCu(['jev', args.command], exec.signal, JSON.stringify(parsed))
+  },
+})
+
 /** Register the macos-cu bridge tools. Tool registrations auto-dispose on unload. */
 export function apply(ctx: Context): void {
   ctx.tools.register(doctor)
@@ -155,4 +193,5 @@ export function apply(ctx: Context): void {
   ctx.tools.register(axPress)
   ctx.tools.register(inputClick)
   ctx.tools.register(shot)
+  ctx.tools.register(jevGuard)
 }

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/packages/dsh/src/macosCu.ts

@@ -35,13 +35,16 @@ export function binary(): string {
  * Run the CLI with an argument array (never a shell string) and return the
  * outcome. Missing-binary (ENOENT) resolves to an actionable install message
  * instead of throwing, so the model sees what to do next.
+ *
+ * `stdin` is written and the stream closed immediately: the `jev` subcommand
+ * reads a JSON payload from stdin and would otherwise wait forever.
  */
-export async function runMacosCu(argv: string[], signal: AbortSignal): Promise<string> {
+export async function runMacosCu(argv: string[], signal: AbortSignal, stdin?: string): Promise<string> {
   if (signal.aborted) throw new Error('macos-cu call aborted before spawn')
   const bin = binary()
   const outcome = await new Promise<{ code: number; stdout: string; stderr: string; spawnError?: NodeJS.ErrnoException }>(
     (resolve) => {
-      execFile(
+      const child = execFile(
         bin,
         argv,
         { timeout: 55_000, signal, maxBuffer: 8 * 1024 * 1024, windowsHide: true },
@@ -57,6 +60,7 @@ export async function runMacosCu(argv: string[], signal: AbortSignal): Promise<s
           resolve({ code, stdout: String(stdout), stderr: String(stderr) })
         },
       )
+      child.stdin?.end(stdin ?? '')
     },
   )
   if (outcome.spawnError !== undefined) return MISSING_BINARY_MESSAGE

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/packages/pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-macos-computer-use",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "AX-first computer use on macOS for pi: accessibility-tree targeting instead of screenshot coordinate guessing, window-scoped input that never moves the user's cursor, clipboard-safe pasting, action read-back verification, blank-frame detection, and optional Jev semantic guards.",
   "type": "module",
   "license": "MIT",
@@ -14,7 +14,10 @@
     "accessibility-tree",
     "automation",
     "gui-automation",
-    "agent-tools"
+    "agent-tools",
+    "jev",
+    "typesafe-ai",
+    "system-one-models"
   ],
   "homepage": "https://github.com/Sur-Cai/macos-computer-use-kit#readme",
   "repository": {

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/pyproject.toml

@@ -4,10 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "macos-computer-use-kit"
-version = "0.2.0"
+version = "0.2.2"
 description = "AX-first computer-use toolkit for AI agents on macOS: accessibility-tree targeting, process-scoped input, clipboard-safe paste, action read-back verification, visual feedback, and optional Jev semantic guards."
+license = "MIT"
+license-files = ["LICENSE"]
 readme = "README.md"
-license = { file = "LICENSE" }
 requires-python = ">=3.10"
 keywords = [
   "computer-use",
@@ -19,6 +20,10 @@ keywords = [
   "opencode",
   "pi-package",
   "dsh-plugin",
+  "jev",
+  "typesafe-ai",
+  "system-one",
+  "llm-guardrails",
 ]
 classifiers = [
   "Development Status :: 4 - Beta",
@@ -31,6 +36,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Software Development :: User Interfaces",
 ]
 dependencies = [

{macos_computer_use_kit-0.2.0 → macos_computer_use_kit-0.2.2}/src/macos_computer_use/__init__.py

@@ -4,6 +4,6 @@ The public surface is the ``macos-cu`` command line; every subcommand prints a
 single JSON object (or JSON lines) so an agent can consume the result directly.
 """
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 
 __all__ = ["__version__"]