@openlatch/client 0.3.3 → 0.5.1

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 (2) hide show
  1. package/README.md +31 -10
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -30,13 +30,21 @@ It plugs into the agent's native lifecycle hooks, decides locally and in-process
30
30
 
31
31
  ```bash
32
32
  npx @openlatch/client init # installs the client, detects your agents, wires their hooks
33
- openlatch auth login # links this machine to your OpenLatch account (opens the browser)
33
+ openlatch system auth login # links this machine to your OpenLatch account (opens the browser)
34
34
  claude # use your agent as usual — every tool call is now covered
35
+ codex # … and the other one, under the same policy on the same host
35
36
  ```
36
37
 
37
38
  `openlatch status` shows what is captured and enforced on this host. The [dashboard](https://app.openlatch.ai) shows the events and the verdicts. Full walkthrough: [Getting started](https://openlatch.ai/docs/getting-started/).
38
39
 
39
- The installer runs on Node.js. macOS, Windows and Linux are supported.
40
+ `npx` needs Node.js. On a machine without it, use the script for your platform — no runtime required. macOS, Windows and Linux are supported.
41
+
42
+ ```bash
43
+ # macOS, Linux
44
+ curl -LsSf https://openlatch.ai/install.sh | sh
45
+ # Windows
46
+ powershell -ExecutionPolicy Bypass -c "irm https://openlatch.ai/install.ps1 | iex"
47
+ ```
40
48
 
41
49
  ## How it works
42
50
 
@@ -71,18 +79,31 @@ The verdict vocabulary is **Allow, Ask, Block or Optimize**. What this client ca
71
79
  | Verdict | On the wire / in the bundle | What this client does today |
72
80
  | ------- | --------------------------- | ------------------------- |
73
81
  | **Allow** | `allow`, `approve` | The action proceeds. `approve` is a user-confirmed allow |
74
- | **Ask** | No wire variant — an `allow` / `approve` carrying `context` | Rendered to Claude Code as `permissionDecision: "ask"`, the alert as its reason. It **allows and flags**; it does not hold the agent waiting on a human. It prevents recurrence, not the first occurrence |
82
+ | **Ask** | No wire variant — an `allow` / `approve` carrying `context` | It **allows and flags**; it does not hold the agent waiting on a human. Claude Code renders it as `permissionDecision: "ask"` with the alert as its reason; Codex CLI has no `ask` tier, so it degrades to a `systemMessage` carrying that same reason. It prevents recurrence, not the first occurrence |
75
83
  | **Block** | `deny` — the only action a `kind=command` rule may take | Reaches the agent as a native deny at `pre_tool_use`, naming the rule that produced it |
76
- | **Optimize** | `kind=request` rules: `prefix_reorder`, `history_trim`, `prompt_edit` | **Measurement only.** Out of the box the boundary observes, reports what a transform *would* have saved, and forwards the original bytes |
84
+ | **Optimize** | `kind=request` rules: `prefix_reorder`, `history_trim`, `prompt_edit` | **Measurement only.** Out of the box the model relay observes, reports what a transform *would* have saved, and forwards the original bytes |
77
85
 
78
86
  Each rule runs in Monitor (record the match, allow the action) or Enforce (apply the verdict). Most restrictive wins across matching rules.
79
87
 
80
88
  ## Supported agents
81
89
 
82
- | Agent | Control level | Notes |
83
- | ----- | ------------- | ----- |
84
- | **Claude Code** | **Enforced** | macOS, Windows and Linux, across its 12 lifecycle hook events. Verdicts are delivered in the agent's own hook-output shape |
85
- | Cursor · Windsurf · GitHub Copilot · Codex CLI · Gemini CLI · Cline · OpenClaw | Recognised | Their events store and attribute correctly; `init` cannot install their hooks yet |
90
+ **Three agents are wired end-to-end: [Claude Code](https://claude.ai/code), [OpenAI Codex CLI](https://developers.openai.com/codex/cli) and [Cline](https://cline.bot).** `init` detects every agent on the host and wires **all** of them — coverage is the default, and `--agent <type>` is how you opt one out. `doctor`, `status` and `uninstall` each report and tear down every agent they find.
91
+
92
+ Coverage is stated per agent **and per plane**. An unqualified "Enforced" would round an enforced command plane and an observe-only request plane back up to green, and that is the one arithmetic this table refuses.
93
+
94
+ | Agent | Delivery | Command plane | Request plane | Control level |
95
+ | ----- | -------- | ------------- | ------------- | ------------- |
96
+ | **Claude Code** | any | **Enforced** | Observed *(runtime-checked)* | **Enforced** *(command plane)* |
97
+ | **Codex CLI** | managed (MDM / system / cloud) | **Enforced**, and **not disableable by the developer** | Observed *(runtime-checked)* | **Enforced** *(command plane)* |
98
+ | **Codex CLI** | self-serve (`npx init`) | **Monitored** until `/hooks` trust; **Enforced** after | Observed *(runtime-checked)* | Monitored → Enforced |
99
+ | **Cline** | any | **Monitored**; **Enforced** where Cline loads the OpenLatch plugin | Observed per provider, from the editor's next start *(runtime-checked)* | Monitored → Enforced |
100
+ | Cursor · Windsurf · GitHub Copilot · Gemini CLI · OpenClaw | — | Not wired | Not wired | Known |
101
+
102
+ **The vocabulary is closed.** *Enforced* — the verdict reaches the agent and is obeyed. *Monitored* — the integration is installed and events flow, but a verdict cannot yet be delivered, so nothing is prevented. *Observed* — capture and would-have measurement only, by design for this phase. *Known* — identified and classified, with the limits stated.
103
+
104
+ **Why Codex has two rows.** A user-level Codex hook is *marked for review and skipped until trusted*, so a fresh self-serve install is Monitored — not Enforced — until you run `/hooks` in Codex and trust the OpenLatch hook. Any re-install that changes the hook command re-arms that review. On the managed path the hook is trusted by policy and cannot be switched off by the developer, which is a stronger claim than we can make on Claude Code. `openlatch doctor` proves the hook by **invoking** it rather than by observing that a file exists, and reports the trust state per agent — an untrusted hook is never spawned, and that is the one failure that looks identical to working from the outside.
105
+
106
+ **Why Cline's request plane starts later.** Cline keeps a base URL per provider and the running editor holds the one it read at start, so OpenLatch gives each configured provider its own loopback endpoint and VS Code uses it from its next start. Providers Cline reaches through no setting, and Amazon Bedrock, are reported as not covered — see [docs/configuration.md](docs/configuration.md#cline--one-relay-endpoint-per-provider).
86
107
 
87
108
  Making an agent **Enforced** is a hook binding plus a verdict translator. Both are contributions we welcome — see [Contributing](#contributing).
88
109
 
@@ -92,7 +113,7 @@ Making an agent **Enforced** is a hook binding plus a verdict translator. Both a
92
113
 
93
114
  ```bash
94
115
  openlatch init --proxy http://proxy.corp:8080 --ca-bundle /etc/ssl/corp-root.pem
95
- openlatch proxy test # walks the chain hop by hop and names the failing one
116
+ openlatch system proxy test # walks the chain hop by hop and names the failing one
96
117
  ```
97
118
 
98
119
  The hosts to open, every `[proxy]` key and every `OL-122x` code: [docs/egress.md](docs/egress.md).
@@ -127,7 +148,7 @@ Pick a [good first issue](https://github.com/OpenLatch/openlatch-client/labels/g
127
148
  ## Security
128
149
 
129
150
  - Report vulnerabilities to **security@openlatch.ai**; private vulnerability reporting is enabled on this repository
130
- - Releases are built with SLSA provenance via GitHub Actions
151
+ - Every release binary carries a minisign signature, which the client verifies before it updates itself; macOS and Linux binaries also carry Sigstore signatures. What is and is not signed: [SECURITY.md](SECURITY.md)
131
152
  - Full policy: [SECURITY.md](SECURITY.md)
132
153
 
133
154
  ## License
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openlatch/client",
3
- "version": "0.3.3",
3
+ "version": "0.5.1",
4
4
  "description": "OpenLatch runtime enforcement node — the capture-and-enforce adapter that evaluates every covered action against a coding agent's Autonomy Zone before it runs",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -20,10 +20,10 @@
20
20
  "postinstall": "node lib/postinstall.js"
21
21
  },
22
22
  "optionalDependencies": {
23
- "@openlatch/client-darwin-arm64": "0.3.3",
24
- "@openlatch/client-darwin-x64": "0.3.3",
25
- "@openlatch/client-linux-x64": "0.3.3",
26
- "@openlatch/client-linux-arm64": "0.3.3",
27
- "@openlatch/client-win32-x64": "0.3.3"
23
+ "@openlatch/client-darwin-arm64": "0.5.1",
24
+ "@openlatch/client-darwin-x64": "0.5.1",
25
+ "@openlatch/client-linux-x64": "0.5.1",
26
+ "@openlatch/client-linux-arm64": "0.5.1",
27
+ "@openlatch/client-win32-x64": "0.5.1"
28
28
  }
29
29
  }