@arcane-fly/desktop-monkey 0.0.0-stage → 0.1.0

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 (3) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +62 -2
  3. package/package.json +17 -4
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Braden Pty Ltd / Arcane-Fly
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,63 @@
1
- # Temporary Holding Version
1
+ # Desktop Monkey
2
2
 
3
- 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.
3
+ > Your machines, one troop. A Desktop Commander–parity **remote MCP** plus a **device mesh** that
4
+ > pools compute, GPU, RAM and disk across the PCs and laptops you own.
5
+
6
+ **Status:** under construction — see [`docs/DONE-CONTRACT.json`](docs/DONE-CONTRACT.json) for the
7
+ machine-checkable list of what "finished" means and [`docs/STATUS.md`](docs/STATUS.md) for the live
8
+ done/asked count.
9
+
10
+ ## What it is
11
+
12
+ 1. **Commander layer** — 100% tool-surface and service parity with
13
+ [Desktop Commander Remote MCP](https://mcp.desktopcommander.app/): every MCP tool, plus the
14
+ hosted pieces (device enrolment, tunnel, per-client OAuth, usage metering, tool-call log,
15
+ revoke/share, settings). Parity is tracked in [`docs/parity/`](docs/parity/).
16
+ 2. **Troop mesh** — concurrent coordination of several machines: *primary + support*, *several
17
+ supports*, rings and chains. Work is split so that no single machine has to carry the compute,
18
+ GPU memory, RAM or disk. See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md).
19
+ 3. **Hooks** — an improved, typed, auditable hook engine (lessons from Claude Code, Codex and
20
+ Cursor hooks) that also fires on mesh events.
21
+ 4. **Monkey Monitor entry point** — the local GTK app
22
+ ([`monkey-projects/monkey-monitor`](../monkey-projects/monkey-monitor)) is the local front door;
23
+ Desktop Monkey shares its colour tokens and logo.
24
+
25
+ ## Layout
26
+
27
+ | Path | Purpose |
28
+ |---|---|
29
+ | `packages/protocol` | Single source of truth: MCP tool schemas + mesh wire messages |
30
+ | `packages/commander` | Desktop Commander–parity MCP server (stdio + remote) |
31
+ | `packages/agent` | Per-device daemon: capability probe, tunnel, executor, pools |
32
+ | `packages/mesh` | Scheduler, placement, pooling planes (compute / memory / disk) |
33
+ | `packages/hooks` | Hook engine and adapters |
34
+ | `packages/theme` | Colour + logo tokens shared with Monkey Monitor |
35
+ | `services/relay` | Control plane + tunnel (Railway) |
36
+ | `apps/dashboard` | Web dashboard (Vercel) |
37
+ | `integrations/monkey-monitor` | Glue for the local entry point |
38
+ | `deploy/` | Pinned deploy targets + isolation / impact-audit tooling |
39
+ | `docs/` | Vision, architecture, ADRs, parity matrix, research |
40
+
41
+ ## Live hub
42
+
43
+ The mesh relay is deployed on Railway as the central hub:
44
+
45
+ | | |
46
+ |---|---|
47
+ | **Public URL** | `https://relay-production-ef48.up.railway.app` |
48
+ | **Health** | `GET /health` → `{"status":"ok"}` |
49
+ | **MCP endpoint** | `POST /mcp` (OAuth 2.1 bearer token, PKCE S256; 401 without token) |
50
+ | **Device mesh tunnel** | `wss://relay-production-ef48.up.railway.app/tunnel` |
51
+ | **OAuth discovery** | `/.well-known/oauth-authorization-server` (issuer = public URL) |
52
+ | **JWKS** | `/.well-known/jwks.json` (ES256) |
53
+ | **Device enrolment** | `/device/start` → `/device/poll` → `/device/verify` (device-code flow) |
54
+ | **Device API** | `/api/devices` (pause / resume / revoke) |
55
+
56
+ Devices and MCP clients connect to the public URL above; `RELAY_PUBLIC_URL` is set
57
+ on the Railway `relay` service so the OAuth issuer matches. The image is built from
58
+ the repo `Dockerfile` (`pip install '.[relay]'`), which pins the relay extras the
59
+ platform builder would otherwise skip.
60
+
61
+ ## Rules of the road
62
+
63
+ Read [`AGENTS.md`](AGENTS.md) before touching anything — especially the deploy-isolation rules.
package/package.json CHANGED
@@ -1,6 +1,19 @@
1
1
  {
2
2
  "name": "@arcane-fly/desktop-monkey",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "Desktop Commander-parity remote MCP plus a device mesh that pools compute, GPU, RAM and disk across your own machines.",
5
+ "repository": {
6
+ "type": "git",
7
+ "url": "https://github.com/Arcane-Fly/desktop-monkey.git"
8
+ },
9
+ "license": "MIT",
10
+ "main": "dist/index.js",
11
+ "types": "dist/index.d.ts",
12
+ "files": [
13
+ "dist/"
14
+ ],
15
+ "scripts": {
16
+ "build": "echo 'No TypeScript to build - Python package only'",
17
+ "test": "echo 'No npm tests - Python tests only'"
18
+ }
19
+ }