@integrity-labs/agt-cli 0.28.855 → 0.28.856

package/dist/{chunk-IHBWFKOW.js → chunk-M6E42Z4Z.js}

@@ -2631,6 +2631,71 @@ var INTEGRATION_REGISTRY = [
       }
     }
   },
+  {
+    // ENG-10133 (epic ENG-10127). Drives a HUMAN'S macOS desktop — clicks,
+    // keystrokes, window state — through `open-computer-use` running on that
+    // Mac, reached over an SSH reverse tunnel the Mac itself opens.
+    //
+    // READ THIS BEFORE CHANGING ANY FIELD BELOW. Three properties are what make
+    // this safe to ship at all, and each is easy to undo by accident:
+    //
+    //  1. Every forwarded call is gated per-action against a human-granted
+    //     approval (ENG-10132, packages/mcp/src/computer-use-gate.ts). The gate
+    //     lives INSIDE the proxy binary rather than beside it, so there is no
+    //     build in which the tools exist and the gate does not.
+    //  2. The `open-computer-use` FLAG_REGISTRY flag decides whether the row is
+    //     forwarded to the host at all, and it is `sensitive` — arming it costs
+    //     a confirmation. The flag governs whether the PATH EXISTS; the gate
+    //     governs whether a call may travel it. Neither substitutes for the other.
+    //  3. `beta` keeps it off every customer's picker until the operator runbook
+    //     (ENG-10135) exists. Setting up the Mac side — launchd tunnel, the
+    //     `from="127.0.0.1,::1"` pin on authorized_keys, Accessibility
+    //     permissions — is not something a connect dialog can do, and offering
+    //     it without those steps produces an integration that installs cleanly
+    //     and does nothing.
+    //
+    // NOT a `nativeMcp` spec: the entry needs a host-absolute proxy path and
+    // per-install ssh config (user, port, remote command), neither of which the
+    // ENG-5815 templating vocabulary can express. Rendered by
+    // provisioning/computer-use-mcp.ts instead — see its header.
+    id: "open-computer-use",
+    name: "Computer Use (macOS)",
+    category: "infrastructure",
+    description: "Drive a macOS desktop by accessibility tree \u2014 read window state, click, type and press keys in any app. Every action requires a human approval granted per session and bound to one application.",
+    // The credential is an OpenSSH private key, supplied by the operator who
+    // set up the Mac. `api_key` is this codebase's "customer pastes a secret"
+    // flow; there is no ssh-specific auth type and inventing one would buy
+    // nothing the credential pipeline does not already do.
+    supported_auth_types: ["api_key"],
+    beta: true,
+    // DELIBERATELY NOT `installable`, i.e. never in the Add Integration picker.
+    // It joins augmented-admin / augmented-support / augmented-help-kb as a
+    // GRANTED integration, and for a stronger version of their reason. A picker
+    // entry promises self-service, and there is none to offer: the Mac side
+    // needs a launchd tunnel, an authorized_keys entry pinned to loopback, an
+    // SSH keypair and macOS Accessibility permission, none of which a connect
+    // dialog can do. A customer who "installed" it from a picker would get a
+    // dialog, paste something, and own a broken integration.
+    //
+    // It would also contradict the flag. `open-computer-use` is `sensitive`, so
+    // arming it costs a deliberate confirmation — offering one-click install of
+    // the thing behind it is incoherent.
+    capabilities: [
+      {
+        id: "open-computer-use:read-screen",
+        name: "Read Screen State",
+        description: "List running applications and read a window's accessibility tree (element indices, labels, values). Screenshots are stripped by default and returned only on explicit request.",
+        access: "read"
+      },
+      {
+        id: "open-computer-use:control",
+        name: "Control the Desktop",
+        description: "Open apps, click, scroll, type text, press keys and set field values. Every call is refused unless a human has granted an approval for the target application.",
+        access: "write"
+      }
+    ],
+    docs_url: "https://github.com/anthropics/open-computer-use"
+  },
   {
     // ENG-6195: admin-only debugging surface for Integrity Labs STAFF agents.
     // Provisions the @integrity-labs/augmented-admin-mcp stdio broker, which
@@ -6911,6 +6976,22 @@ var FLAG_REGISTRY = [
     // No `since` for the same reason: there is no host-side reader and no fleet
     // to converge, so `classifyHostReach` returning `honors` for every host is
     // the literal truth here rather than the trap it is one flag above.
+  },
+  {
+    key: "open-computer-use",
+    description: "ENG-10133 (epic ENG-10127) - gates whether an agent gets the `open-computer-use` stdio MCP server, i.e. whether it can drive a human's macOS desktop at all. OFF (default) = the `.mcp.json` entry is not written, so the tools do not exist for the agent and `--allowedTools` never carries the wildcard (the allowlist is DERIVED from the server keys - see apps/cli/src/lib/claude-tools.ts, which is why there is no second lever to flip). ON = the entry is materialized for any agent that also holds the integration row; the flag is necessary, never sufficient. THE FLAG IS NOT THE SAFETY CONTROL AND MUST NOT BE READ AS ONE. Every forwarded call is gated per-action against a human-granted approval by packages/mcp/src/computer-use-gate.ts (ENG-10132); this flag decides whether the PATH EXISTS, the gate decides whether a call may travel it. Turning this on for an agent whose host runs a proxy build predating that gate hands it an ungated route to someone's desktop - which is why the gate ships in the same proxy binary rather than beside it, so there is no build in which the path exists and the gate does not. Org/agent-scoped rather than global: a desktop belongs to one person, and the blast radius of a wrong answer is that person's open windows, mail client and password manager. Deliberately NO envVar - a host-level env override would let a compromised or misconfigured host arm itself, and this is precisely the gate that must be armed centrally (ENG-8303 pin, ENG-7972 4KB cap).",
+    flagType: "boolean",
+    // Dark. There is no "today's behaviour" to preserve - nothing on the fleet
+    // has this integration - so the safe direction is unambiguous.
+    defaultValue: false,
+    // Enforcement gate (ADR-0022 section 4). Arming it is "relaxing a security
+    // control" in the most literal sense available in this codebase: it is the
+    // difference between an agent that can and cannot move a human's mouse.
+    // One confirmation is a cheap price for that.
+    sensitive: true
+    // Deliberately NOT public. The browser has no decision to make here; the
+    // consumers are the host payload that builds `input.integrations` and the
+    // grant route that refuses to install the row while the flag is off.
   }
 ];
 var REGISTRY_BY_KEY = new Map(FLAG_REGISTRY.map((definition) => [definition.key, definition]));
@@ -14141,4 +14222,4 @@ export {
   peekCurrentSession,
   readDailySessionPin
 };
-//# sourceMappingURL=chunk-IHBWFKOW.js.map
+//# sourceMappingURL=chunk-M6E42Z4Z.js.map