PyPI - macos-computer-use-kit - Versions diffs - 0.2.1__tar.gz → 0.2.2__tar.gz - Mend

macos-computer-use-kit 0.2.1tar.gz → 0.2.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (46) hide show

{macos_computer_use_kit-0.2.1 → macos_computer_use_kit-0.2.2}/CHANGELOG.md RENAMED Viewed

@@ -3,6 +3,22 @@
 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

{macos_computer_use_kit-0.2.1 → macos_computer_use_kit-0.2.2}/PKG-INFO RENAMED Viewed

@@ -1,13 +1,13 @@
 Metadata-Version: 2.5
 Name: macos-computer-use-kit
-Version: 0.2.1
+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-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
@@ -18,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
@@ -30,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
@@ -40,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).
@@ -59,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
 ```
@@ -132,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
@@ -158,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:
@@ -175,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
@@ -275,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.1 → macos_computer_use_kit-0.2.2}/PUBLISHING.md RENAMED Viewed

@@ -1,5 +1,9 @@
 # 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 (bump `pyproject.toml`, `packages/pi/package.json`, and
 `packages/dsh/package.json` together):
@@ -89,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
@@ -106,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.1 → macos_computer_use_kit-0.2.2}/README.md RENAMED Viewed

@@ -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.1 → macos_computer_use_kit-0.2.2}/packages/dsh/README.md RENAMED Viewed

@@ -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.1 → macos_computer_use_kit-0.2.2}/packages/dsh/package.json RENAMED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "dsh-macos-computer-use",
-  "version": "0.2.1",
-  "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.1 → macos_computer_use_kit-0.2.2}/packages/dsh/src/index.ts RENAMED Viewed

@@ -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.1 → macos_computer_use_kit-0.2.2}/packages/dsh/src/macosCu.ts RENAMED Viewed

@@ -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.1 → macos_computer_use_kit-0.2.2}/packages/pi/package.json RENAMED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "pi-macos-computer-use",
-  "version": "0.2.1",
+  "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.1 → macos_computer_use_kit-0.2.2}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 [project]
 name = "macos-computer-use-kit"
-version = "0.2.1"
+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"]
@@ -20,6 +20,10 @@ keywords = [
   "opencode",
   "pi-package",
   "dsh-plugin",
+  "jev",
+  "typesafe-ai",
+  "system-one",
+  "llm-guardrails",
 ]
 classifiers = [
   "Development Status :: 4 - Beta",
@@ -32,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.1 → macos_computer_use_kit-0.2.2}/src/macos_computer_use/__init__.py RENAMED Viewed

@@ -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.1"
+__version__ = "0.2.2"
 __all__ = ["__version__"]