@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.
@@ -2,9 +2,9 @@
2
2
  import {
3
3
  createClientRuntime,
4
4
  createStore
5
- } from "./chunk-FDDLNAOY.js";
5
+ } from "./chunk-CQZHYEXW.js";
6
6
  import "./chunk-6ZOLE3E3.js";
7
- import "./chunk-J6GHXVHC.js";
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-JEOOF3E4.js";
4
+ } from "./chunk-W2TBIICO.js";
5
5
  import "./chunk-23UDQZMT.js";
6
6
  import "./chunk-UKFRCP6X.js";
7
- import "./chunk-FDDLNAOY.js";
7
+ import "./chunk-CQZHYEXW.js";
8
8
  import "./chunk-6ZOLE3E3.js";
9
- import "./chunk-J6GHXVHC.js";
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-JEOOF3E4.js";
7
+ } from "./chunk-W2TBIICO.js";
8
8
  import "./chunk-23UDQZMT.js";
9
9
  import "./chunk-UKFRCP6X.js";
10
- import "./chunk-FDDLNAOY.js";
10
+ import "./chunk-CQZHYEXW.js";
11
11
  import "./chunk-6ZOLE3E3.js";
12
- import "./chunk-J6GHXVHC.js";
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
@@ -11,7 +11,7 @@ import {
11
11
  inspectEdgeScopeReadOnly,
12
12
  isRetryableSyncError,
13
13
  stableIdempotency
14
- } from "./chunk-J6GHXVHC.js";
14
+ } from "./chunk-7EQXQVPD.js";
15
15
  import {
16
16
  SQLiteBridgeStore
17
17
  } from "./chunk-SBVZVXGK.js";
@@ -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 and stores only the identity, normalized command,
359
- arguments, scope, and fixed Agent Bridge environment key names.
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. Claude
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
@@ -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
- The manual `gateway production proof` GitHub Actions workflow runs this acceptance
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
- `PROOF_SENDER_TOKEN`, `PROOF_RECEIVER_TOKEN`, `PROOF_HOST_SALT`, and `FLY_API_TOKEN` as
278
- environment secrets. Use a release-specific proof workspace for every run. Owner
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
@@ -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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@creatornader/agent-bridge",
3
- "version": "0.6.5",
3
+ "version": "0.7.2",
4
4
  "description": "Let AI agents message each other and hand off work across tools, sessions, and machines.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",