passcontrol 1.3.0 → 1.5.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.
- package/LICENSE +3 -1
- package/README.md +10 -1
- package/bin/passcontrol.mjs +455 -10
- package/cli/budget-format.mjs +113 -0
- package/cli/claude-code.mjs +80 -16
- package/cli/config.mjs +36 -2
- package/cli/declared-session.mjs +61 -0
- package/cli/delegation.d.mts +60 -0
- package/cli/delegation.mjs +192 -0
- package/cli/journal.mjs +84 -0
- package/cli/mcp/README.md +4 -1
- package/cli/mcp/gateway.mjs +13 -0
- package/cli/mcp/server.mjs +27 -0
- package/cli/menu.mjs +7 -0
- package/cli/profiles.mjs +92 -0
- package/cli/protocols.d.mts +2 -0
- package/cli/protocols.mjs +17 -1
- package/cli/sidecar.mjs +194 -20
- package/cli/statusline.mjs +213 -0
- package/cli/verify.mjs +215 -5
- package/cli/visa-client.mjs +5 -1
- package/cli/watch-feed.mjs +275 -0
- package/cli/watch.mjs +601 -0
- package/package.json +1 -1
- package/sdk/index.d.ts +2 -1
- package/sdk/index.js +3 -0
- package/sdk/passcontrol.d.ts +46 -0
- package/sdk/passcontrol.js +47 -2
- package/sdk/verify.d.ts +115 -0
- package/sdk/verify.js +219 -1
package/LICENSE
CHANGED
|
@@ -8,7 +8,9 @@ License text copyright © 2017 MariaDB Corporation Ab, All Rights Reserved.
|
|
|
8
8
|
Parameters
|
|
9
9
|
|
|
10
10
|
Licensor: Kristiyan Ivanov, operating under the Vertias name
|
|
11
|
-
Licensed Work: PassControl
|
|
11
|
+
Licensed Work: PassControl, excluding the plugins/passcontrol/ directory,
|
|
12
|
+
which is licensed under the MIT License (see the
|
|
13
|
+
LICENSE file in that directory).
|
|
12
14
|
The Licensed Work is © 2026 Kristiyan Ivanov.
|
|
13
15
|
Additional Use Grant: You may make production use of the Licensed Work, provided
|
|
14
16
|
that you do not offer the Licensed Work to third parties as
|
package/README.md
CHANGED
|
@@ -19,7 +19,8 @@ not passport-signed. Both go through gateway controls.
|
|
|
19
19
|
|
|
20
20
|
Built by one developer under [Vertias](https://vertias.eu). Early software, **not
|
|
21
21
|
independently audited**. Start with a non-critical provider key. Source-available under
|
|
22
|
-
[BSL 1.1](./LICENSE)
|
|
22
|
+
[BSL 1.1](./LICENSE), except the Claude Code plugin in
|
|
23
|
+
[`plugins/passcontrol/`](https://github.com/Vertias3u/PassControl/tree/main/plugins/passcontrol), which is MIT.
|
|
23
24
|
|
|
24
25
|
## Cloud
|
|
25
26
|
|
|
@@ -129,6 +130,7 @@ its scope and suitable budgets. Choose by what your client supports:
|
|
|
129
130
|
| Your JS/TS code | `PassControl` from `passcontrol/sdk`; [SDK guide](https://github.com/Vertias3u/PassControl/blob/main/docs/integrations/passport-sdk.md) |
|
|
130
131
|
| Static-key client needing Passport | `passcontrol sidecar`, then `passcontrol env <integration>` |
|
|
131
132
|
| MCP client | `passcontrol mcp`; configure as below |
|
|
133
|
+
| Coding agent | [Claude Code](https://github.com/Vertias3u/PassControl/blob/main/docs/integrations/claude-code.md), [Codex](https://github.com/Vertias3u/PassControl/blob/main/docs/integrations/codex.md), [OpenRouter](https://github.com/Vertias3u/PassControl/blob/main/docs/integrations/openrouter.md), [Ollama](https://github.com/Vertias3u/PassControl/blob/main/docs/integrations/ollama.md) |
|
|
132
134
|
|
|
133
135
|
Direct Agent Keys point the client at the PassControl gateway origin. Passport Sidecar clients
|
|
134
136
|
point at loopback with a provider path (for example `http://127.0.0.1:8788/api/v1/anthropic`) and the sidecar forwards to the gateway.
|
|
@@ -161,6 +163,13 @@ API key. Treat access to that local listener as access to the configured agent.
|
|
|
161
163
|
not a sandbox against other processes running as you. Its provider CONNECT requests are
|
|
162
164
|
refused; use base URLs rather than TLS interception.
|
|
163
165
|
|
|
166
|
+
To see each call as it happens, run `passcontrol watch` beside the agent (`--port` for a
|
|
167
|
+
sidecar that is not on 8788). It is a read-only, full-screen board: one row per call the
|
|
168
|
+
sidecar relays, with its time, declared session and sub-agent, model, BOARDED or DENIED
|
|
169
|
+
(with the gateway's refusal code), and latency, under the agent's budget. It reads a feed
|
|
170
|
+
on the sidecar's own loopback port, held in memory and never written to disk. A call that
|
|
171
|
+
does not go through that sidecar is not on it, and the board cannot stop anything.
|
|
172
|
+
|
|
164
173
|
Presets (from `cli/presets.mjs`): `generic`, `openhands`, `litellm`, `aider`, `hermes`, `cline`, `continue`, `chatbox`, `jan`, `msty`, `cherry-studio`, `open-webui`, `librechat`; service presets: `github`, `telegram`, `brave`, `notion`, `discord`; coding agent: `codex`; MCP presets: `claude-desktop`, `cursor`, `claude-code`. Compatibility still depends on the client using
|
|
165
174
|
supported paths. [Hermes configuration](https://github.com/Vertias3u/PassControl/blob/main/docs/integrations/hermes.md).
|
|
166
175
|
|