@gestaltrun/dsh-desktop-cua 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+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.

package/README.i18n.yaml

@@ -0,0 +1,28 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write product/desktop-cua/README.md
+/:
+  en: fc405a4db833dd84
+  zh: 9fc6aa202f8ddfe6
+/gestaltrun-dsh-desktop-cua:
+  en: 1b2be1e057d7c3ab
+  zh: 35a28e45fc074317
+/gestaltrun-dsh-desktop-cua/summary:
+  en: 72a82489a74867bb
+  zh: 6220807ed6db9262
+/gestaltrun-dsh-desktop-cua/table-of-contents:
+  en: c146bc3e3b0e6763
+  zh: a0a42a1d13586706
+/gestaltrun-dsh-desktop-cua/use-this-package:
+  en: 778e3c445290057c
+  zh: 62ce0da69b3d9b65
+/gestaltrun-dsh-desktop-cua/understand-the-implementation:
+  en: d411a20f8f118244
+  zh: a8d0cce4b3e794e6
+/gestaltrun-dsh-desktop-cua/model-experience:
+  en: 8a0367b9ce097896
+  zh: d77056c8a1c59221
+/gestaltrun-dsh-desktop-cua/known-limitations:
+  en: b22c5643fe7c2001
+  zh: 724b3e224772d011

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+---
+description: "Use Computer Use in Gestalt Desktop on macOS with the bundled native helper and official application consent."
+kind: "package-bundle"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @gestaltrun/dsh-desktop-cua
+
+English | [中文](README.zh.md)
+
+## Summary
+
+Gestalt Desktop selects this bundle by default. On macOS, its Desktop layer enables the `cua` tool for authorized application observation and input. Windows and Linux keep both Computer Use entries disabled. Application consent belongs to the official macOS provider.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Model Experience](#model-experience)
+- [Known limitations](#known-limitations)
+
+<a id="use-this-package"></a>
+## Use this package
+
+Use the bundle shipped with Gestalt Desktop. Its ordinary profile patch is empty; only the Desktop launcher applies [desktop.patch.yml](desktop.patch.yml). macOS requires Accessibility and Screen Recording authorization for the responsible Host/helper. The provider asks separately for application access, with task-level and persistent choices; denial prevents application operations.
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Implementation internals</summary>
+
+The pack step compiles the official [Swift source](../../packages/experimental/cua-macos/native/README.md) for the selected macOS architecture. `DSH_DESKTOP_CUA_BUILD_DIR` selects an absolute compiler scratch directory; the default is `.artifacts/desktop-cua` under the repository. Windows and Linux packs contain no helper. A failed build removes the previous generated payload and stops before packing.
+
+The bundle carries `native/bin/darwin-<arch>/dsh-cua-native`. The Desktop patch resolves this installed package from the Host entry point and passes the absolute helper path to the official provider. Desktop copies the complete physical DSH tree; its existing Mach-O signing pass signs the helper before sealing the App. App and DMG notarization submissions contain that sealed tree. End users need no Swift compiler.
+
+</details>
+
+<a id="model-experience"></a>
+## Model Experience
+
+The [official provider](../../packages/experimental/cua-macos/README.md#model-experience) owns the `cua` schema, guidance, observations, images and permission errors. This bundle adds no model prompt or authorization policy.
+
+<a id="known-limitations"></a>
+## Known limitations
+
+The native provider requires macOS 14 or later. Ad-hoc packages do not establish Developer ID distribution or notarization acceptance; release packaging must verify those separately.
+
+`pnpm test` runs the owning Desktop product-composition tests, including the macOS-only activation rule.

package/README.zh.md

@@ -0,0 +1,48 @@
+---
+description: "在 macOS Gestalt Desktop 中使用随包分发的原生 helper 和官方应用授权进行 Computer Use。"
+kind: "package-bundle"
+---
+
+# @gestaltrun/dsh-desktop-cua
+
+[English](README.md) | 中文
+
+## 概述
+
+Gestalt Desktop 默认选择此组合包。macOS 的 Desktop 层启用 `cua` 工具，用于观察和输入已授权的应用。Windows 和 Linux 保持两个 Computer Use 条目禁用。应用授权由官方 macOS provider 负责。
+
+## 目录
+
+- [使用此包](#use-this-package)
+- [理解实现](#understand-the-implementation)
+- [模型体验](#model-experience)
+- [已知限制](#known-limitations)
+
+<a id="use-this-package"></a>
+## 使用此包
+
+使用 Gestalt Desktop 随附的组合包。普通 profile patch 为空；只有 Desktop 启动器应用 [desktop.patch.yml](desktop.patch.yml)。macOS 要求为负责操作的 Host/helper 授予辅助功能和屏幕录制权限。provider 另行询问应用访问授权，支持任务级与长期授权；拒绝后不操作应用。
+
+<a id="understand-the-implementation"></a>
+## 理解实现
+
+<details>
+<summary>实现细节</summary>
+
+打包步骤为所选 macOS 架构编译官方 [Swift 源码](../../packages/experimental/cua-macos/native/README.zh.md)。`DSH_DESKTOP_CUA_BUILD_DIR` 指定编译器工作目录的绝对路径；默认是仓库下的 `.artifacts/desktop-cua`。Windows 和 Linux 包不含 helper。构建失败时移除此前生成的产物，并在打包前停止。
+
+组合包携带 `native/bin/darwin-<arch>/dsh-cua-native`。Desktop patch 从 Host 入口解析已安装的此包，将 helper 的绝对路径传给官方 provider。Desktop 复制完整物理 DSH 目录；现有 Mach-O 签名步骤在封装 App 前签名 helper。App 与 DMG 公证提交包含已封装的目录。最终用户无需 Swift 编译器。
+
+</details>
+
+<a id="model-experience"></a>
+## 模型体验
+
+[官方 provider](../../packages/experimental/cua-macos/README.zh.md#model-experience)负责 `cua` schema、指引、观察、图片和权限错误。本组合包不添加模型提示词或授权策略。
+
+<a id="known-limitations"></a>
+## 已知限制
+
+原生 provider 要求 macOS 14 或更高版本。ad-hoc 包不能证明 Developer ID 分发或公证已获接受；发布打包必须单独验证。
+
+`pnpm test` 运行所属 Desktop 产品组合测试，覆盖仅在 macOS 激活的规则。

package/cordis.patch.yml

@@ -0,0 +1 @@
+[]

package/desktop.patch.yml

@@ -0,0 +1,15 @@
+- insert:
+    - id: gestaltrun-desktop-computer-use
+      name: '@deepseek-ai/dsh-computer-use'
+      disabled: !!js process.platform !== 'darwin'
+    - id: gestaltrun-desktop-cua-macos
+      name: '@deepseek-ai/dsh-experimental-cua-macos'
+      disabled: !!js process.platform !== 'darwin'
+      config:
+        helperPath: !!js |
+          (() => {
+            const path = process.getBuiltinModule('node:path')
+            const require = process.getBuiltinModule('node:module').createRequire(process.argv[1])
+            return path.join(path.dirname(require.resolve('@gestaltrun/dsh-desktop-cua/package.json')),
+              'native', 'bin', 'darwin-' + process.arch, 'dsh-cua-native')
+          })()

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "macOS Computer Use",
+    "description": "Use Computer Use in Gestalt Desktop on macOS with the bundled native helper and official application consent"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "macOS 计算机使用",
+    "description": "在 macOS 桌面中通过随包原生组件和官方应用授权使用 Computer Use"
+  }
+}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@gestaltrun/dsh-desktop-cua",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Gestalt Desktop macOS Computer Use profile and native helper",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./desktop.patch.yml": "./desktop.patch.yml",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "files": [
+    "cordis.patch.yml",
+    "desktop.patch.yml",
+    "locale/*.json",
+    "native/bin",
+    "README.md",
+    "README.zh.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gestaltrun/deepseek-harness.git",
+    "directory": "product/desktop-cua"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "candidate"
+  },
+  "dsh": {
+    "engines": {
+      "dsh": ">=0.2.1-alpha.3"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml",
+      "desktopPatch": "./desktop.patch.yml"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "4.0.6-alpha.1",
+    "@deepseek-ai/dsh-computer-use": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-experimental-cua-macos": "0.2.2-alpha.2"
+  },
+  "scripts": {
+    "release:pack": "node scripts/prepare-native.mjs && pnpm pack --pack-destination ../dist",
+    "test": "pnpm --dir ../.. exec vitest run apps/desktop/tests/product-profile.spec.ts"
+  }
 }