@creatornader/agent-bridge 0.6.5 → 0.7.2
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/CHANGELOG.md +28 -0
- package/README.md +24 -3
- package/ROADMAP.md +8 -0
- package/SKILL.md +7 -1
- package/dist/bridge.js +1 -1
- package/dist/{chunk-J6GHXVHC.js → chunk-7EQXQVPD.js} +5 -7
- package/dist/{chunk-J6GHXVHC.js.map → chunk-7EQXQVPD.js.map} +1 -1
- package/dist/{chunk-FDDLNAOY.js → chunk-CQZHYEXW.js} +2 -2
- package/dist/{chunk-JEOOF3E4.js → chunk-W2TBIICO.js} +2 -2
- package/dist/cli.js +335 -54
- package/dist/cli.js.map +1 -1
- package/dist/client-runtime.js +2 -2
- package/dist/index.js +3 -3
- package/dist/server.js +3 -3
- package/dist/sqlite.js +1 -1
- package/docs/architecture-v2.md +15 -3
- package/docs/deployment.md +12 -4
- package/docs/troubleshooting.md +28 -0
- package/llms.txt +1 -1
- package/package.json +1 -1
- /package/dist/{chunk-FDDLNAOY.js.map → chunk-CQZHYEXW.js.map} +0 -0
- /package/dist/{chunk-JEOOF3E4.js.map → chunk-W2TBIICO.js.map} +0 -0
package/dist/client-runtime.js
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
import {
|
|
3
3
|
createClientRuntime,
|
|
4
4
|
createStore
|
|
5
|
-
} from "./chunk-
|
|
5
|
+
} from "./chunk-CQZHYEXW.js";
|
|
6
6
|
import "./chunk-6ZOLE3E3.js";
|
|
7
|
-
import "./chunk-
|
|
7
|
+
import "./chunk-7EQXQVPD.js";
|
|
8
8
|
import "./chunk-SBVZVXGK.js";
|
|
9
9
|
import "./chunk-GTK4KOED.js";
|
|
10
10
|
import "./chunk-VOQIDTCJ.js";
|
package/dist/index.js
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import {
|
|
3
3
|
startServer
|
|
4
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-W2TBIICO.js";
|
|
5
5
|
import "./chunk-23UDQZMT.js";
|
|
6
6
|
import "./chunk-UKFRCP6X.js";
|
|
7
|
-
import "./chunk-
|
|
7
|
+
import "./chunk-CQZHYEXW.js";
|
|
8
8
|
import "./chunk-6ZOLE3E3.js";
|
|
9
|
-
import "./chunk-
|
|
9
|
+
import "./chunk-7EQXQVPD.js";
|
|
10
10
|
import "./chunk-SBVZVXGK.js";
|
|
11
11
|
import "./chunk-GTK4KOED.js";
|
|
12
12
|
import "./chunk-VOQIDTCJ.js";
|
package/dist/server.js
CHANGED
|
@@ -4,12 +4,12 @@ import {
|
|
|
4
4
|
configFromEnv,
|
|
5
5
|
createAgentBridgeServer,
|
|
6
6
|
startServer
|
|
7
|
-
} from "./chunk-
|
|
7
|
+
} from "./chunk-W2TBIICO.js";
|
|
8
8
|
import "./chunk-23UDQZMT.js";
|
|
9
9
|
import "./chunk-UKFRCP6X.js";
|
|
10
|
-
import "./chunk-
|
|
10
|
+
import "./chunk-CQZHYEXW.js";
|
|
11
11
|
import "./chunk-6ZOLE3E3.js";
|
|
12
|
-
import "./chunk-
|
|
12
|
+
import "./chunk-7EQXQVPD.js";
|
|
13
13
|
import "./chunk-SBVZVXGK.js";
|
|
14
14
|
import "./chunk-GTK4KOED.js";
|
|
15
15
|
import "./chunk-VOQIDTCJ.js";
|
package/dist/sqlite.js
CHANGED
package/docs/architecture-v2.md
CHANGED
|
@@ -355,8 +355,12 @@ Managed-client repair, update, and uninstall use a local crash-safe substrate. S
|
|
|
355
355
|
owner-private metadata is the mutation authority. Runtime plus stable instance locate
|
|
356
356
|
the metadata, and identity must match both the record and the immutable repair or
|
|
357
357
|
update request. Uninstall also binds the identity. Repair restores its launch contract. Update validates a new launch
|
|
358
|
-
before it creates the journal
|
|
359
|
-
|
|
358
|
+
before it creates the journal. Managed metadata version 2 adds a versioned target
|
|
359
|
+
union. A target is either stdio with a normalized command, arguments, and scope, or
|
|
360
|
+
Streamable HTTP with a normalized URL and scope. Version 1 stdio metadata stays
|
|
361
|
+
readable and becomes version 2 on the next update. The launch projection remains in
|
|
362
|
+
version 2 so bounded registration proofs and v4 rollback records keep their released
|
|
363
|
+
shape.
|
|
360
364
|
Caller backend, scope, and host-config flags are rejected. Owner-private revisioned
|
|
361
365
|
manifests live under
|
|
362
366
|
`~/.agent-bridge/operations/<uuid>` with private snapshots and an exclusive lock keyed
|
|
@@ -395,7 +399,15 @@ and change metadata last when the launch changes. A native update command is one
|
|
|
395
399
|
executable contract. Bare commands cannot contain argument separators, while absolute
|
|
396
400
|
paths must resolve to executable files before an update is journaled. Codex runs get,
|
|
397
401
|
remove, and add with the recorded profile home over the supplied environment. Claude
|
|
398
|
-
Code uses its recorded scope, working directory, and supplied environment.
|
|
402
|
+
Code uses its recorded scope, working directory, and supplied environment. Codex and
|
|
403
|
+
Claude Code may instead use a managed Streamable HTTP target. That target must be an
|
|
404
|
+
explicit loopback HTTP URL with a port and `/mcp` path, without user information,
|
|
405
|
+
query, fragment, bearer-token setting, or custom header. Backend credentials remain in
|
|
406
|
+
their existing private file and do not enter the native HTTP registration.
|
|
407
|
+
|
|
408
|
+
Claude Desktop represents an endpoint-backed target as an exact stdio proxy launch.
|
|
409
|
+
The proxy command must be an existing absolute executable. Its bounded arguments must
|
|
410
|
+
contain the exact loopback endpoint and no credential-like flags or values. Claude
|
|
399
411
|
Desktop reads its recorded config without following links or link ancestors, replaces
|
|
400
412
|
only `mcpServers.agent-bridge`, writes through an operation-scoped private temporary
|
|
401
413
|
file, and verifies the published entry. Node cannot make that update atomic with an
|
package/docs/deployment.md
CHANGED
|
@@ -271,11 +271,19 @@ messages before choosing one authority. If schema or data recovery is required,
|
|
|
271
271
|
restore the verified native DR bundle into a fresh target and switch authority once.
|
|
272
272
|
Do not run the source and restored database as active authorities at the same time.
|
|
273
273
|
|
|
274
|
-
|
|
275
|
-
proof against an existing HTTPS gateway. GitHub restricts it to `main`, and every job
|
|
274
|
+
Release tags deploy the exact tagged revision before npm publication. The release job
|
|
276
275
|
uses the approval-protected `agent-bridge-production-proof` environment. Configure
|
|
277
|
-
`
|
|
278
|
-
|
|
276
|
+
`AGENT_BRIDGE_FLY_APP` and `AGENT_BRIDGE_GATEWAY_ORIGIN` as environment variables, and
|
|
277
|
+
configure `PROOF_SENDER_TOKEN`, `PROOF_RECEIVER_TOKEN`, `PROOF_HOST_SALT`, and
|
|
278
|
+
`FLY_API_TOKEN` as environment secrets. Configure `RELEASE_VERIFY_TOKEN` separately
|
|
279
|
+
for the release job. It runs the read-only Fly preflight, deploys the image with the
|
|
280
|
+
checked-out revision, requires `/readyz`, and verifies the running package version and
|
|
281
|
+
revision. A failed deployment or identity check stops npm publication.
|
|
282
|
+
|
|
283
|
+
The manual `gateway production proof` GitHub Actions workflow runs its acceptance
|
|
284
|
+
proof against that deployed HTTPS gateway. GitHub restricts it to `main`, and every job
|
|
285
|
+
uses the same approval-protected environment. Use a release-specific proof workspace
|
|
286
|
+
for every run. Owner
|
|
279
287
|
provisioning refuses a second agent with the same principal in one workspace, and a
|
|
280
288
|
revoked credential cannot serve as a rotation predecessor. The sender and receiver
|
|
281
289
|
credentials must bind the requested workspace to the dedicated `proof-sender` and
|
package/docs/troubleshooting.md
CHANGED
|
@@ -46,6 +46,34 @@ The registered environment must contain distinct `AGENT_BRIDGE_AGENT`,
|
|
|
46
46
|
`AGENT_BRIDGE_INSTANCE`, and `AGENT_BRIDGE_CONFIG` values for that client. Do not copy
|
|
47
47
|
another client's identity or backend file into the entry.
|
|
48
48
|
|
|
49
|
+
## Move a managed client to a local MCP HTTP host
|
|
50
|
+
|
|
51
|
+
Preview the update first. Add `--apply` only after the plan names the expected
|
|
52
|
+
registration and metadata steps:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
agent-bridge clients update codex --identity codex --instance <stable-key> \
|
|
56
|
+
--mcp-url http://127.0.0.1:8794/mcp
|
|
57
|
+
agent-bridge clients update claude-code --identity claude-code --instance <stable-key> \
|
|
58
|
+
--mcp-url http://127.0.0.1:8793/mcp
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Claude Desktop needs a stdio proxy because its managed entry remains a process launch:
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
agent-bridge clients update claude-desktop \
|
|
65
|
+
--identity claude-desktop --instance <stable-key> \
|
|
66
|
+
--mcp-url http://127.0.0.1:8791/mcp \
|
|
67
|
+
--proxy-command /absolute/path/to/node \
|
|
68
|
+
--proxy-args-json '["/absolute/path/to/stdio-http-proxy.js","--transport","stdio-http-proxy","--endpoint","http://127.0.0.1:8791/mcp"]'
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
The endpoint must use plain HTTP on `127.0.0.1`, `localhost`, or `::1`, include an
|
|
72
|
+
explicit port, and end at `/mcp`. User information, query strings, and fragments are
|
|
73
|
+
rejected. The update does not delete or rewrite the private backend file. A failed
|
|
74
|
+
update can resume from its operation UUID, and a committed update can be reversed with
|
|
75
|
+
`clients rollback`.
|
|
76
|
+
|
|
49
77
|
## The executable is missing
|
|
50
78
|
|
|
51
79
|
Install the published package globally, then repeat the normal client installation:
|
package/llms.txt
CHANGED
|
@@ -48,7 +48,7 @@ services can call the CLI or HTTPS API or embed the Node library without a host
|
|
|
48
48
|
- agent-bridge clients inspect <runtime> --identity <principal> --instance <stable-key> --backend-config <absolute path>
|
|
49
49
|
- agent-bridge clients adopt <runtime> --identity <principal> --instance <stable-key> --backend-config <absolute path> [--apply]
|
|
50
50
|
- agent-bridge clients repair <runtime> --identity <principal> --instance <stable-key> [--apply] [--resume <uuid>] [--recover-lock]
|
|
51
|
-
- agent-bridge clients update <runtime> --identity <principal> --instance <stable-key> [--command <command>] [--apply] [--resume <uuid>] [--recover-lock]
|
|
51
|
+
- agent-bridge clients update <runtime> --identity <principal> --instance <stable-key> [--command <command> | --mcp-url <loopback-url>] [--proxy-command <command> --proxy-args-json <json-array>] [--apply] [--resume <uuid>] [--recover-lock]
|
|
52
52
|
- agent-bridge clients uninstall <runtime> --identity <principal> --instance <stable-key> [--apply] [--resume <uuid>] [--recover-lock]
|
|
53
53
|
- agent-bridge clients rollback <update-operation-id> --identity <principal> [--apply] [--recover-lock]
|
|
54
54
|
- agent-bridge clients migrate stage <runtime> --identity <principal> --instance <stable-key> --enrollment-file <private-path> [--apply] [--recover-lock]
|
package/package.json
CHANGED
|
File without changes
|
|
File without changes
|