agent-embassy 3.1.0 → 4.0.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/CHANGELOG.md +21 -0
- package/CONTRIBUTING.md +92 -202
- package/README.md +157 -155
- package/SECURITY.md +191 -348
- package/dist/src/gateway/broker-check.d.ts +26 -0
- package/dist/src/gateway/broker-check.js +89 -0
- package/dist/src/gateway/broker-check.js.map +1 -0
- package/dist/src/gateway/broker-control.d.ts +72 -0
- package/dist/src/gateway/broker-control.js +164 -0
- package/dist/src/gateway/broker-control.js.map +1 -0
- package/dist/src/gateway/broker.d.ts +117 -0
- package/dist/src/gateway/broker.js +186 -0
- package/dist/src/gateway/broker.js.map +1 -0
- package/dist/src/gateway/claude-peer.d.ts +1 -124
- package/dist/src/gateway/claude-peer.js +61 -1052
- package/dist/src/gateway/claude-peer.js.map +1 -1
- package/dist/src/gateway/codex-stateless-transport.d.ts +0 -12
- package/dist/src/gateway/codex-stateless-transport.js +8 -142
- package/dist/src/gateway/codex-stateless-transport.js.map +1 -1
- package/dist/src/gateway/config.d.ts +2 -6
- package/dist/src/gateway/config.js +17 -27
- package/dist/src/gateway/config.js.map +1 -1
- package/dist/src/gateway/coordinator.d.ts +57 -0
- package/dist/src/gateway/coordinator.js +217 -0
- package/dist/src/gateway/coordinator.js.map +1 -0
- package/dist/src/gateway/core-cli.d.ts +15 -0
- package/dist/src/gateway/core-cli.js +282 -0
- package/dist/src/gateway/core-cli.js.map +1 -0
- package/dist/src/gateway/core-service-command.d.ts +16 -0
- package/dist/src/gateway/core-service-command.js +71 -0
- package/dist/src/gateway/core-service-command.js.map +1 -0
- package/dist/src/gateway/endpoint-directory.d.ts +33 -0
- package/dist/src/gateway/endpoint-directory.js +223 -0
- package/dist/src/gateway/endpoint-directory.js.map +1 -0
- package/dist/src/gateway/federation.d.ts +89 -0
- package/dist/src/gateway/federation.js +632 -0
- package/dist/src/gateway/federation.js.map +1 -0
- package/dist/src/gateway/ledger-codec.d.ts +3 -0
- package/dist/src/gateway/ledger-codec.js +159 -0
- package/dist/src/gateway/ledger-codec.js.map +1 -0
- package/dist/src/gateway/ledger.d.ts +138 -0
- package/dist/src/gateway/ledger.js +319 -0
- package/dist/src/gateway/ledger.js.map +1 -0
- package/dist/src/gateway/local-control.d.ts +23 -0
- package/dist/src/gateway/local-control.js +489 -0
- package/dist/src/gateway/local-control.js.map +1 -0
- package/dist/src/gateway/native-destinations.d.ts +34 -0
- package/dist/src/gateway/native-destinations.js +272 -0
- package/dist/src/gateway/native-destinations.js.map +1 -0
- package/dist/src/gateway/owned-state.d.ts +57 -0
- package/dist/src/gateway/owned-state.js +398 -0
- package/dist/src/gateway/owned-state.js.map +1 -0
- package/dist/src/gateway/provenance-envelope.d.ts +3 -3
- package/dist/src/gateway/provenance-envelope.js +3 -23
- package/dist/src/gateway/provenance-envelope.js.map +1 -1
- package/dist/src/gateway/runtime.d.ts +41 -0
- package/dist/src/gateway/runtime.js +175 -0
- package/dist/src/gateway/runtime.js.map +1 -0
- package/docs/CONFIGURATION.md +178 -266
- package/docs/DELIVERY.md +133 -82
- package/docs/GATEWAY-ARCHITECTURE.md +276 -949
- package/package.json +5 -5
- package/skills/embassy-peer/SKILL.md +38 -196
- package/skills/embassy-peer/agents/openai.yaml +2 -2
- package/dist/src/gateway/claude-helper-protocol.d.ts +0 -117
- package/dist/src/gateway/claude-helper-protocol.js +0 -122
- package/dist/src/gateway/claude-helper-protocol.js.map +0 -1
- package/dist/src/gateway/claude-helper-supervisor.d.ts +0 -87
- package/dist/src/gateway/claude-helper-supervisor.js +0 -374
- package/dist/src/gateway/claude-helper-supervisor.js.map +0 -1
- package/dist/src/gateway/claude-helper.d.ts +0 -1
- package/dist/src/gateway/claude-helper.js +0 -252
- package/dist/src/gateway/claude-helper.js.map +0 -1
- package/dist/src/gateway/cli.d.ts +0 -56
- package/dist/src/gateway/cli.js +0 -1532
- package/dist/src/gateway/cli.js.map +0 -1
- package/dist/src/gateway/codex-socket-holder.d.ts +0 -26
- package/dist/src/gateway/codex-socket-holder.js +0 -76
- package/dist/src/gateway/codex-socket-holder.js.map +0 -1
- package/dist/src/gateway/control.d.ts +0 -279
- package/dist/src/gateway/control.js +0 -933
- package/dist/src/gateway/control.js.map +0 -1
- package/dist/src/gateway/peer-client.d.ts +0 -58
- package/dist/src/gateway/peer-client.js +0 -217
- package/dist/src/gateway/peer-client.js.map +0 -1
- package/dist/src/gateway/peer-mailbox.d.ts +0 -78
- package/dist/src/gateway/peer-mailbox.js +0 -168
- package/dist/src/gateway/peer-mailbox.js.map +0 -1
- package/dist/src/gateway/peer-protocol.d.ts +0 -110
- package/dist/src/gateway/peer-protocol.js +0 -79
- package/dist/src/gateway/peer-protocol.js.map +0 -1
- package/dist/src/gateway/peer-stdio.d.ts +0 -23
- package/dist/src/gateway/peer-stdio.js +0 -100
- package/dist/src/gateway/peer-stdio.js.map +0 -1
- package/dist/src/gateway/providers.d.ts +0 -164
- package/dist/src/gateway/providers.js +0 -975
- package/dist/src/gateway/providers.js.map +0 -1
- package/dist/src/gateway/server.d.ts +0 -46
- package/dist/src/gateway/server.js +0 -216
- package/dist/src/gateway/server.js.map +0 -1
- package/dist/src/gateway/service.d.ts +0 -371
- package/dist/src/gateway/service.js +0 -2335
- package/dist/src/gateway/service.js.map +0 -1
- package/dist/src/gateway/status-view.d.ts +0 -119
- package/dist/src/gateway/status-view.js +0 -484
- package/dist/src/gateway/status-view.js.map +0 -1
- package/dist/src/gateway/store.d.ts +0 -188
- package/dist/src/gateway/store.js +0 -2360
- package/dist/src/gateway/store.js.map +0 -1
- package/dist/src/gateway/types.d.ts +0 -541
- package/dist/src/gateway/types.js +0 -332
- package/dist/src/gateway/types.js.map +0 -1
|
@@ -1,168 +0,0 @@
|
|
|
1
|
-
import { Buffer } from "node:buffer";
|
|
2
|
-
import { createHash, randomBytes } from "node:crypto";
|
|
3
|
-
import { BridgeError } from "../errors.js";
|
|
4
|
-
import { composeProvenanceEnvelope, PROVENANCE_ENVELOPE_MAX_BYTES } from "./provenance-envelope.js";
|
|
5
|
-
const TIMEOUT = Object.freeze({ state: "timeout" });
|
|
6
|
-
const MAX_WAITERS = 16;
|
|
7
|
-
const RECEIPT = /^prc_[A-Za-z0-9_-]{24}$/;
|
|
8
|
-
const ALIAS = /^[a-z][a-z0-9_-]{0,31}@[a-z0-9](?:[a-z0-9.-]{0,61}[a-z0-9])?$/;
|
|
9
|
-
const CONVERSATION = /^conv_[A-Za-z0-9_-]{16,64}$/;
|
|
10
|
-
export function isPeerMailboxAwaitResult(value) {
|
|
11
|
-
if (!record(value))
|
|
12
|
-
return false;
|
|
13
|
-
if (value.state === "timeout")
|
|
14
|
-
return Object.keys(value).length === 1;
|
|
15
|
-
if (value.state !== "message" || Object.keys(value).length !== 3 || typeof value.receipt !== "string" || !RECEIPT.test(value.receipt) || typeof value.frame !== "string")
|
|
16
|
-
return false;
|
|
17
|
-
try {
|
|
18
|
-
const parsed = JSON.parse(value.frame);
|
|
19
|
-
if (!record(parsed) || Object.keys(parsed).length !== 3 || parsed.ok !== true || parsed.command !== "await" || !record(parsed.result) || Object.keys(parsed.result).length !== 5)
|
|
20
|
-
return false;
|
|
21
|
-
const result = parsed.result;
|
|
22
|
-
return typeof result.fromAlias === "string" && ALIAS.test(result.fromAlias) && typeof result.toAlias === "string" && result.toAlias.startsWith("peer-") && ALIAS.test(result.toAlias) &&
|
|
23
|
-
typeof result.conversationId === "string" && CONVERSATION.test(result.conversationId) && typeof result.text === "string" && Buffer.byteLength(result.text) <= PROVENANCE_ENVELOPE_MAX_BYTES &&
|
|
24
|
-
typeof result.expectsReply === "boolean" && Buffer.byteLength(value.frame) <= PROVENANCE_ENVELOPE_MAX_BYTES && value.frame === `${JSON.stringify(parsed)}\n`;
|
|
25
|
-
}
|
|
26
|
-
catch {
|
|
27
|
-
return false;
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
export class LocalPeerMailboxProvider {
|
|
31
|
-
options;
|
|
32
|
-
identity;
|
|
33
|
-
protocol = "peer-mailbox";
|
|
34
|
-
protocolVersion = "1";
|
|
35
|
-
routes = new Map();
|
|
36
|
-
waiters = new Map();
|
|
37
|
-
receipts = new Map();
|
|
38
|
-
tombstones = new Map();
|
|
39
|
-
closed = false;
|
|
40
|
-
constructor(options) {
|
|
41
|
-
this.options = options;
|
|
42
|
-
this.identity = Object.freeze({ provider: "peer", hostId: options.hostId });
|
|
43
|
-
}
|
|
44
|
-
async initialize() { return { health: "healthy" }; }
|
|
45
|
-
observeLogicalRoute(input) {
|
|
46
|
-
const current = this.routes.get(input.registrationId);
|
|
47
|
-
if (!this.closed && (!current || same(current, input)))
|
|
48
|
-
this.routes.set(input.registrationId, Object.freeze({ ...input }));
|
|
49
|
-
}
|
|
50
|
-
forgetLogicalRoute(registrationId) {
|
|
51
|
-
this.routes.delete(registrationId);
|
|
52
|
-
this.cancelRegistration(registrationId);
|
|
53
|
-
this.tombstones.delete(registrationId);
|
|
54
|
-
}
|
|
55
|
-
async awaitMessage(input) {
|
|
56
|
-
const route = this.routes.get(input.registrationId);
|
|
57
|
-
if (this.closed || !same(route, input))
|
|
58
|
-
throw new BridgeError("ROUTE_UNREGISTERED", "The peer mailbox binding is not current.");
|
|
59
|
-
if (this.waiters.has(input.registrationId))
|
|
60
|
-
throw new BridgeError("ROUTE_BUSY", "The peer registration already has a waiter.", true);
|
|
61
|
-
if (this.waiters.size >= MAX_WAITERS)
|
|
62
|
-
throw new BridgeError("ROUTE_CAPACITY_REACHED", "The peer waiter limit is full.", true);
|
|
63
|
-
return await new Promise((resolve) => {
|
|
64
|
-
const timer = setTimeout(() => { this.waiters.delete(input.registrationId); resolve(TIMEOUT); }, input.timeoutMs ?? this.options.awaitTimeoutMs ?? 30_000);
|
|
65
|
-
this.waiters.set(input.registrationId, { alias: input.alias, routeHandle: input.routeHandle, registrationId: input.registrationId, resolve, timer });
|
|
66
|
-
});
|
|
67
|
-
}
|
|
68
|
-
acknowledgeReceipt(input) {
|
|
69
|
-
const key = receiptKey(input);
|
|
70
|
-
const tombstone = this.tombstones.get(input.registrationId);
|
|
71
|
-
if (tombstone?.receipt === input.receipt && tombstone.key === key)
|
|
72
|
-
return "duplicate";
|
|
73
|
-
const pending = this.receipts.get(input.receipt);
|
|
74
|
-
if (!same(pending, input))
|
|
75
|
-
return "rejected";
|
|
76
|
-
if (pending.acked)
|
|
77
|
-
return "duplicate";
|
|
78
|
-
pending.acked = true;
|
|
79
|
-
if (pending.accepted)
|
|
80
|
-
this.finishReceipt(input.receipt, pending, key);
|
|
81
|
-
return "acknowledged";
|
|
82
|
-
}
|
|
83
|
-
async dispatch(input) {
|
|
84
|
-
const route = this.routes.get(input.binding.registrationId);
|
|
85
|
-
if (this.closed || input.binding.provider !== "peer" || input.binding.hostId !== this.identity.hostId || input.targetAlias !== route?.alias || input.binding.routeHandle !== route.routeHandle)
|
|
86
|
-
return { state: "failed", safeErrorCode: "ROUTE_UNREGISTERED" };
|
|
87
|
-
const waiter = this.waiters.get(route.registrationId);
|
|
88
|
-
if (waiter === undefined)
|
|
89
|
-
return { state: "deferred", safeErrorCode: "PEER_NOT_AWAITING" };
|
|
90
|
-
let text;
|
|
91
|
-
try {
|
|
92
|
-
text = composeProvenanceEnvelope({ sourceProvider: input.sourceProvider, recipientProvider: "peer", sourceAlias: input.sourceAlias, targetAlias: input.targetAlias, conversationId: input.conversationId, body: input.text });
|
|
93
|
-
}
|
|
94
|
-
catch {
|
|
95
|
-
return { state: "failed", safeErrorCode: "PROVENANCE_ENVELOPE_INVALID" };
|
|
96
|
-
}
|
|
97
|
-
const result = { fromAlias: input.sourceAlias, toAlias: input.targetAlias, conversationId: input.conversationId, text, expectsReply: input.expectsReply };
|
|
98
|
-
const frame = `${JSON.stringify({ ok: true, command: "await", result })}\n`;
|
|
99
|
-
if (Buffer.byteLength(frame) > PROVENANCE_ENVELOPE_MAX_BYTES)
|
|
100
|
-
return { state: "failed", safeErrorCode: "PROVENANCE_ENVELOPE_INVALID" };
|
|
101
|
-
const receipt = this.newReceipt();
|
|
102
|
-
const evidence = { attemptId: input.attemptId, kind: "peer_mailbox", bodyBytes: Buffer.byteLength(input.text), bodySha256: hash(input.text), frameBytes: Buffer.byteLength(frame), sha256: hash(frame) };
|
|
103
|
-
let authorized;
|
|
104
|
-
try {
|
|
105
|
-
authorized = await input.authorizeWrite(evidence);
|
|
106
|
-
}
|
|
107
|
-
catch {
|
|
108
|
-
return { state: "ambiguous", safeErrorCode: "DISPATCH_OUTCOME_AMBIGUOUS" };
|
|
109
|
-
}
|
|
110
|
-
if (!authorized)
|
|
111
|
-
return { state: "failed", safeErrorCode: "WRITE_AUTHORIZATION_DENIED" };
|
|
112
|
-
if (this.closed || this.waiters.get(route.registrationId) !== waiter)
|
|
113
|
-
return { state: "ambiguous", safeErrorCode: "DISPATCH_OUTCOME_AMBIGUOUS" };
|
|
114
|
-
clearTimeout(waiter.timer);
|
|
115
|
-
this.waiters.delete(route.registrationId);
|
|
116
|
-
const acked = new Promise((resolve) => {
|
|
117
|
-
const waitMs = Math.max(0, Math.min(this.options.receiptTimeoutMs ?? 2_147_483_647, Date.parse(input.deadlineAt) - (this.options.now?.() ?? Date.now())));
|
|
118
|
-
const timer = setTimeout(() => { this.receipts.delete(receipt); resolve(false); }, waitMs);
|
|
119
|
-
this.receipts.set(receipt, { ...route, resolve, timer, acked: false, accepted: false });
|
|
120
|
-
});
|
|
121
|
-
waiter.resolve({ state: "message", frame, receipt });
|
|
122
|
-
try {
|
|
123
|
-
await input.onAccepted({ attemptId: input.attemptId });
|
|
124
|
-
}
|
|
125
|
-
catch {
|
|
126
|
-
this.cancelReceipt(receipt);
|
|
127
|
-
return { state: "ambiguous", safeErrorCode: "DISPATCH_OUTCOME_AMBIGUOUS" };
|
|
128
|
-
}
|
|
129
|
-
const pending = this.receipts.get(receipt);
|
|
130
|
-
if (pending) {
|
|
131
|
-
pending.accepted = true;
|
|
132
|
-
if (pending.acked)
|
|
133
|
-
this.finishReceipt(receipt, pending, receiptKey({ ...route, receipt }));
|
|
134
|
-
}
|
|
135
|
-
return await acked ? { state: "delivered" } : { state: "unconfirmed", safeErrorCode: "DELIVERY_UNCONFIRMED" };
|
|
136
|
-
}
|
|
137
|
-
async close() {
|
|
138
|
-
this.closed = true;
|
|
139
|
-
for (const id of [...this.routes.keys()])
|
|
140
|
-
this.cancelRegistration(id);
|
|
141
|
-
this.routes.clear();
|
|
142
|
-
this.tombstones.clear();
|
|
143
|
-
}
|
|
144
|
-
cancelRegistration(id) {
|
|
145
|
-
const waiter = this.waiters.get(id);
|
|
146
|
-
if (waiter) {
|
|
147
|
-
clearTimeout(waiter.timer);
|
|
148
|
-
this.waiters.delete(id);
|
|
149
|
-
waiter.resolve(TIMEOUT);
|
|
150
|
-
}
|
|
151
|
-
for (const [receipt, pending] of this.receipts)
|
|
152
|
-
if (pending.registrationId === id)
|
|
153
|
-
this.cancelReceipt(receipt);
|
|
154
|
-
}
|
|
155
|
-
cancelReceipt(receipt) { const pending = this.receipts.get(receipt); if (pending) {
|
|
156
|
-
clearTimeout(pending.timer);
|
|
157
|
-
this.receipts.delete(receipt);
|
|
158
|
-
pending.resolve(false);
|
|
159
|
-
} }
|
|
160
|
-
finishReceipt(receipt, pending, key) { clearTimeout(pending.timer); this.receipts.delete(receipt); this.tombstones.set(pending.registrationId, { receipt, key }); pending.resolve(true); }
|
|
161
|
-
newReceipt() { const value = this.options.createReceipt?.() ?? `prc_${randomBytes(18).toString("base64url")}`; if (!RECEIPT.test(value) || this.receipts.has(value) || [...this.tombstones.values()].some((item) => item.receipt === value))
|
|
162
|
-
throw new Error("invalid receipt"); return value; }
|
|
163
|
-
}
|
|
164
|
-
const hash = (value) => createHash("sha256").update(value).digest("hex");
|
|
165
|
-
const same = (left, right) => left?.alias === right.alias && left.routeHandle === right.routeHandle && left.registrationId === right.registrationId;
|
|
166
|
-
const receiptKey = (input) => `${input.registrationId}\0${input.routeHandle}\0${input.alias}\0${input.receipt}`;
|
|
167
|
-
const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
|
|
168
|
-
//# sourceMappingURL=peer-mailbox.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"peer-mailbox.js","sourceRoot":"","sources":["../../../src/gateway/peer-mailbox.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,110 +0,0 @@
|
|
|
1
|
-
import { type ConnectorHealth, type GatewayProvider, type RouteState } from "./types.js";
|
|
2
|
-
export declare const PEER_PROTOCOL_VERSION = 2, PEER_MAX_REQUEST_BYTES: number, PEER_MAX_CATALOG_BYTES: number, PEER_MAX_BODY_BYTES: number, PEER_REQUEST_TIMEOUT_MS = 30000, PEER_METHOD_NOT_FOUND = -32601;
|
|
3
|
-
export declare const peerCapabilities: readonly ["catalog", "handoff"];
|
|
4
|
-
export type PeerRpcId = string | number;
|
|
5
|
-
export type PeerRpcError = Readonly<{
|
|
6
|
-
code: number;
|
|
7
|
-
message: string;
|
|
8
|
-
data?: unknown;
|
|
9
|
-
}>;
|
|
10
|
-
export type PeerMethod = "initialize" | "catalog/get" | "handoff";
|
|
11
|
-
export type PeerEndpoint = Readonly<{
|
|
12
|
-
alias: string;
|
|
13
|
-
provider: GatewayProvider;
|
|
14
|
-
host: string;
|
|
15
|
-
routeRef: string;
|
|
16
|
-
}>;
|
|
17
|
-
export type PeerInitializeParams = Readonly<{
|
|
18
|
-
protocolVersion: typeof PEER_PROTOCOL_VERSION;
|
|
19
|
-
host: string;
|
|
20
|
-
}>;
|
|
21
|
-
export type PeerInitializeResult = Readonly<{
|
|
22
|
-
protocolVersion: typeof PEER_PROTOCOL_VERSION;
|
|
23
|
-
host: string;
|
|
24
|
-
capabilities: typeof peerCapabilities;
|
|
25
|
-
limits: Readonly<{
|
|
26
|
-
requestBytes: number;
|
|
27
|
-
catalogBytes: number;
|
|
28
|
-
bodyBytes: number;
|
|
29
|
-
}>;
|
|
30
|
-
}>;
|
|
31
|
-
/**
|
|
32
|
-
* A federated handoff is authorized by the sending host's membership in the
|
|
33
|
-
* destination's nodes.json plus exact alias addressing; the wire carries no
|
|
34
|
-
* permission record beyond the two endpoints.
|
|
35
|
-
*/
|
|
36
|
-
export type PeerHandoffParams = Readonly<{
|
|
37
|
-
originAttemptId: string;
|
|
38
|
-
originMessageId: string;
|
|
39
|
-
source: PeerEndpoint;
|
|
40
|
-
target: PeerEndpoint;
|
|
41
|
-
deadlineAt: string;
|
|
42
|
-
expectsReply: boolean;
|
|
43
|
-
body: string;
|
|
44
|
-
steer?: true;
|
|
45
|
-
conversationCorrelation?: string;
|
|
46
|
-
}>;
|
|
47
|
-
export type PeerHandoffResult = Readonly<{
|
|
48
|
-
accepted: true;
|
|
49
|
-
}>;
|
|
50
|
-
export type PeerHandoffRefusal = Readonly<{
|
|
51
|
-
accepted: false;
|
|
52
|
-
reason: string;
|
|
53
|
-
}>;
|
|
54
|
-
export declare function isPeerHandoffRefusal(value: unknown): value is PeerHandoffRefusal;
|
|
55
|
-
export type PeerCatalogResult = Readonly<{
|
|
56
|
-
revision: number;
|
|
57
|
-
complete: boolean;
|
|
58
|
-
truncated: boolean;
|
|
59
|
-
generatedAt: string;
|
|
60
|
-
health: ConnectorHealth;
|
|
61
|
-
connectors: readonly Readonly<{
|
|
62
|
-
provider: GatewayProvider;
|
|
63
|
-
host: string;
|
|
64
|
-
health: ConnectorHealth;
|
|
65
|
-
protocol: string;
|
|
66
|
-
protocolVersion: string;
|
|
67
|
-
lastSeenAt?: string;
|
|
68
|
-
observationAgeMs?: number;
|
|
69
|
-
safeErrorCode?: string;
|
|
70
|
-
}>[];
|
|
71
|
-
routes: readonly Readonly<{
|
|
72
|
-
ref: string;
|
|
73
|
-
alias: string;
|
|
74
|
-
provider: GatewayProvider;
|
|
75
|
-
host: string;
|
|
76
|
-
enabled: boolean;
|
|
77
|
-
state: RouteState;
|
|
78
|
-
queueDepth: number;
|
|
79
|
-
lastSeenAt?: string;
|
|
80
|
-
safeErrorCode?: string;
|
|
81
|
-
}>[];
|
|
82
|
-
alerts: readonly Readonly<{
|
|
83
|
-
code: string;
|
|
84
|
-
severity: "info" | "warning" | "error";
|
|
85
|
-
timestamp: string;
|
|
86
|
-
provider?: GatewayProvider;
|
|
87
|
-
host?: string;
|
|
88
|
-
alias?: string;
|
|
89
|
-
}>[];
|
|
90
|
-
}>;
|
|
91
|
-
export type PeerMethodParams = {
|
|
92
|
-
initialize: PeerInitializeParams;
|
|
93
|
-
"catalog/get": Readonly<Record<string, never>>;
|
|
94
|
-
handoff: PeerHandoffParams;
|
|
95
|
-
};
|
|
96
|
-
export type PeerMethodResult = {
|
|
97
|
-
initialize: PeerInitializeResult;
|
|
98
|
-
"catalog/get": PeerCatalogResult;
|
|
99
|
-
handoff: PeerHandoffResult;
|
|
100
|
-
};
|
|
101
|
-
export declare class PeerProtocolError extends Error {
|
|
102
|
-
readonly code: string;
|
|
103
|
-
constructor(code: string);
|
|
104
|
-
}
|
|
105
|
-
export declare const isPeerMethod: (value: unknown) => value is PeerMethod;
|
|
106
|
-
export declare function peerRouteRef(hostId: string, registrationId: string): string;
|
|
107
|
-
export declare function peerInitializeResult(localHost: string): PeerInitializeResult;
|
|
108
|
-
export declare function decodePeerParams<M extends PeerMethod>(method: M, value: unknown): PeerMethodParams[M];
|
|
109
|
-
export declare function decodePeerResult<M extends PeerMethod>(method: M, value: unknown): PeerMethodResult[M];
|
|
110
|
-
export declare function encodePeerFrame(value: unknown, maximum: number): string;
|
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
import { Buffer } from "node:buffer";
|
|
2
|
-
import { createHash } from "node:crypto";
|
|
3
|
-
import { connectorHealthStates, gatewayProviders, routeStates } from "./types.js";
|
|
4
|
-
export const PEER_PROTOCOL_VERSION = 2, PEER_MAX_REQUEST_BYTES = 32 * 1024, PEER_MAX_CATALOG_BYTES = 256 * 1024, PEER_MAX_BODY_BYTES = 16 * 1024, PEER_REQUEST_TIMEOUT_MS = 30_000, PEER_METHOD_NOT_FOUND = -32601;
|
|
5
|
-
export const peerCapabilities = ["catalog", "handoff"];
|
|
6
|
-
// These store refusals precede message admission. Other failures prove nothing
|
|
7
|
-
// about whether the destination committed the handoff.
|
|
8
|
-
const handoffRefusalCodes = new Set([
|
|
9
|
-
"INVALID_PEER_HANDOFF", "ROUTE_UNREGISTERED", "MESSAGE_TOO_LARGE",
|
|
10
|
-
"INVALID_DEADLINE", "GATEWAY_RATE_LIMITED", "GATEWAY_QUEUE_FULL",
|
|
11
|
-
]);
|
|
12
|
-
export function isPeerHandoffRefusal(value) {
|
|
13
|
-
return exact(value, { accepted: (item) => item === false, reason: member(handoffRefusalCodes) });
|
|
14
|
-
}
|
|
15
|
-
const providers = new Set(gatewayProviders), health = new Set(connectorHealthStates), states = new Set(routeStates);
|
|
16
|
-
const host = (v) => typeof v === "string" && /^[a-z0-9](?:[a-z0-9.-]{0,61}[a-z0-9])?$/.test(v);
|
|
17
|
-
const code = (v) => typeof v === "string" && /^[A-Z][A-Z0-9_]{0,63}$/.test(v);
|
|
18
|
-
const alias = (v) => typeof v === "string" && /^[a-z][a-z0-9_-]{0,31}@[a-z0-9](?:[a-z0-9.-]{0,61}[a-z0-9])?$/.test(v);
|
|
19
|
-
const atom = (v) => typeof v === "string" && /^[A-Za-z0-9][A-Za-z0-9_.+-]{0,63}$/.test(v);
|
|
20
|
-
const date = (v) => typeof v === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(v) && new Date(v).toISOString() === v;
|
|
21
|
-
const natural = (v) => Number.isSafeInteger(v) && v >= 0;
|
|
22
|
-
const bool = (v) => typeof v === "boolean";
|
|
23
|
-
const member = (set) => (v) => typeof v === "string" && set.has(v);
|
|
24
|
-
const optional = (check) => (v) => v === undefined || check(v);
|
|
25
|
-
const token = (prefix) => (v) => typeof v === "string" && v.startsWith(prefix) && v.length > prefix.length && v.length <= 160 && /^[A-Za-z0-9_-]+$/.test(v);
|
|
26
|
-
const list = (check, max) => (v) => Array.isArray(v) && v.length <= max && v.every(check);
|
|
27
|
-
const exact = (v, fields) => object(v) &&
|
|
28
|
-
Object.keys(v).every((key) => Object.hasOwn(fields, key)) && Object.entries(fields).every(([key, check]) => check(v[key]));
|
|
29
|
-
const object = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
|
|
30
|
-
const coordinate = (v) => v.alias.endsWith(`@${String(v.host)}`);
|
|
31
|
-
const endpoint = (v) => exact(v, { alias, provider: member(providers), host, routeRef: token("reg_") }) &&
|
|
32
|
-
v.alias.endsWith(`@${String(v.host)}`);
|
|
33
|
-
export class PeerProtocolError extends Error {
|
|
34
|
-
code;
|
|
35
|
-
constructor(code) {
|
|
36
|
-
super(code);
|
|
37
|
-
this.code = code;
|
|
38
|
-
this.name = "PeerProtocolError";
|
|
39
|
-
}
|
|
40
|
-
}
|
|
41
|
-
export const isPeerMethod = (value) => value === "initialize" || value === "catalog/get" || value === "handoff";
|
|
42
|
-
export function peerRouteRef(hostId, registrationId) {
|
|
43
|
-
if (!host(hostId) || typeof registrationId !== "string" || registrationId.length === 0)
|
|
44
|
-
throw new PeerProtocolError("INVALID_ROUTE_AUTHORITY");
|
|
45
|
-
return `reg_${createHash("sha256").update(`${hostId}\0${registrationId}`).digest("base64url")}`;
|
|
46
|
-
}
|
|
47
|
-
export function peerInitializeResult(localHost) {
|
|
48
|
-
return { protocolVersion: PEER_PROTOCOL_VERSION, host: localHost,
|
|
49
|
-
capabilities: peerCapabilities, limits: { requestBytes: PEER_MAX_REQUEST_BYTES, catalogBytes: PEER_MAX_CATALOG_BYTES, bodyBytes: PEER_MAX_BODY_BYTES } };
|
|
50
|
-
}
|
|
51
|
-
export function decodePeerParams(method, value) {
|
|
52
|
-
const valid = method === "initialize" ? exact(value, { protocolVersion: (v) => v === PEER_PROTOCOL_VERSION, host }) : method === "catalog/get" ? exact(value, {}) :
|
|
53
|
-
exact(value, { originAttemptId: token("attempt_"), originMessageId: token("msg_"), source: endpoint, target: endpoint,
|
|
54
|
-
deadlineAt: date, expectsReply: bool,
|
|
55
|
-
body: (v) => typeof v === "string" && Buffer.byteLength(v, "utf8") > 0 && Buffer.byteLength(v, "utf8") <= PEER_MAX_BODY_BYTES,
|
|
56
|
-
steer: optional((v) => v === true), conversationCorrelation: optional((v) => typeof v === "string" && /^[A-Za-z0-9_-]{8}$/.test(v)) });
|
|
57
|
-
if (!valid)
|
|
58
|
-
throw new PeerProtocolError("INVALID_PARAMS");
|
|
59
|
-
return value;
|
|
60
|
-
}
|
|
61
|
-
export function decodePeerResult(method, value) {
|
|
62
|
-
const valid = method === "initialize" ? exact(value, { protocolVersion: (v) => v === PEER_PROTOCOL_VERSION, host,
|
|
63
|
-
capabilities: (v) => Array.isArray(v) && v.length === 2 && v[0] === "catalog" && v[1] === "handoff",
|
|
64
|
-
limits: (v) => exact(v, { requestBytes: (x) => x === PEER_MAX_REQUEST_BYTES, catalogBytes: (x) => x === PEER_MAX_CATALOG_BYTES, bodyBytes: (x) => x === PEER_MAX_BODY_BYTES }) }) :
|
|
65
|
-
method === "handoff" ? exact(value, { accepted: (v) => v === true }) : exact(value, { revision: natural, complete: bool, truncated: bool, generatedAt: date, health: member(health),
|
|
66
|
-
connectors: list((v) => exact(v, { provider: member(providers), host, health: member(health), protocol: atom, protocolVersion: atom, lastSeenAt: optional(date), observationAgeMs: optional(natural), safeErrorCode: optional(code) }), 64),
|
|
67
|
-
routes: list((v) => exact(v, { ref: token("reg_"), alias, provider: member(providers), host, enabled: bool, state: member(states), queueDepth: natural, lastSeenAt: optional(date), safeErrorCode: optional(code) }) && coordinate(v), 256),
|
|
68
|
-
alerts: list((v) => exact(v, { code, severity: member(new Set(["info", "warning", "error"])), timestamp: date, provider: optional(member(providers)), host: optional(host), alias: optional(alias) }), 256) });
|
|
69
|
-
if (!valid)
|
|
70
|
-
throw new PeerProtocolError("INVALID_RESULT");
|
|
71
|
-
return value;
|
|
72
|
-
}
|
|
73
|
-
export function encodePeerFrame(value, maximum) {
|
|
74
|
-
const frame = `${JSON.stringify(value)}\n`;
|
|
75
|
-
if (Buffer.byteLength(frame, "utf8") > maximum)
|
|
76
|
-
throw new PeerProtocolError("FRAME_TOO_LARGE");
|
|
77
|
-
return frame;
|
|
78
|
-
}
|
|
79
|
-
//# sourceMappingURL=peer-protocol.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"peer-protocol.js","sourceRoot":"","sources":["../../../src/gateway/peer-protocol.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
import type { Readable, Writable } from "node:stream";
|
|
2
|
-
import { type PeerCatalogResult, type PeerHandoffParams, type PeerHandoffResult, type PeerInitializeParams, type PeerRpcError } from "./peer-protocol.js";
|
|
3
|
-
type Maybe<T> = T | Promise<T>;
|
|
4
|
-
export type PeerStdioHandlers = Readonly<{
|
|
5
|
-
initialize: (params: PeerInitializeParams) => Maybe<void>;
|
|
6
|
-
catalog: () => Maybe<PeerCatalogResult>;
|
|
7
|
-
handoff: (params: PeerHandoffParams) => Maybe<PeerHandoffResult>;
|
|
8
|
-
}>;
|
|
9
|
-
export declare class PeerHandlerError extends Error {
|
|
10
|
-
readonly detail: PeerRpcError;
|
|
11
|
-
constructor(detail: PeerRpcError);
|
|
12
|
-
}
|
|
13
|
-
export type PeerStdioSession = Readonly<{
|
|
14
|
-
done: Promise<void>;
|
|
15
|
-
close: () => void;
|
|
16
|
-
}>;
|
|
17
|
-
export declare function runPeerStdio(options: Readonly<{
|
|
18
|
-
localHost: string;
|
|
19
|
-
handlers: PeerStdioHandlers;
|
|
20
|
-
input?: Readable;
|
|
21
|
-
output?: Writable;
|
|
22
|
-
}>): PeerStdioSession;
|
|
23
|
-
export {};
|
|
@@ -1,100 +0,0 @@
|
|
|
1
|
-
import { Buffer } from "node:buffer";
|
|
2
|
-
import { decodePeerParams, decodePeerResult, encodePeerFrame, isPeerMethod, PEER_MAX_CATALOG_BYTES, PEER_MAX_REQUEST_BYTES, PEER_METHOD_NOT_FOUND, peerInitializeResult } from "./peer-protocol.js";
|
|
3
|
-
export class PeerHandlerError extends Error {
|
|
4
|
-
detail;
|
|
5
|
-
constructor(detail) {
|
|
6
|
-
super(detail.message);
|
|
7
|
-
this.detail = detail;
|
|
8
|
-
this.name = "PeerHandlerError";
|
|
9
|
-
}
|
|
10
|
-
}
|
|
11
|
-
export function runPeerStdio(options) {
|
|
12
|
-
const input = options.input ?? process.stdin, output = options.output ?? process.stdout;
|
|
13
|
-
let buffer = Buffer.alloc(0), initialized = false, remoteHost = "", closed = false, operations = Promise.resolve();
|
|
14
|
-
let finish;
|
|
15
|
-
const done = new Promise((resolve) => { finish = resolve; });
|
|
16
|
-
const close = () => { if (closed)
|
|
17
|
-
return; closed = true; input.off("data", read); input.off("end", close); finish(); };
|
|
18
|
-
const write = (id, result, fault, large = false) => {
|
|
19
|
-
if (closed)
|
|
20
|
-
return Promise.resolve();
|
|
21
|
-
let frame;
|
|
22
|
-
try {
|
|
23
|
-
frame = encodePeerFrame({ jsonrpc: "2.0", id, ...(fault === undefined ? { result } : { error: fault }) }, large ? PEER_MAX_CATALOG_BYTES : PEER_MAX_REQUEST_BYTES);
|
|
24
|
-
}
|
|
25
|
-
catch {
|
|
26
|
-
frame = encodePeerFrame({ jsonrpc: "2.0", id, error: { code: -32603, message: "Internal error" } }, PEER_MAX_REQUEST_BYTES);
|
|
27
|
-
}
|
|
28
|
-
return new Promise((resolve, reject) => { output.write(frame, (error) => error ? reject(error) : resolve()); });
|
|
29
|
-
};
|
|
30
|
-
const dispatch = async (message) => {
|
|
31
|
-
if (closed)
|
|
32
|
-
return;
|
|
33
|
-
const id = message.id, method = message.method;
|
|
34
|
-
if (typeof method !== "string" || !isPeerMethod(method))
|
|
35
|
-
return write(id, undefined, { code: PEER_METHOD_NOT_FOUND, message: "Method not found" });
|
|
36
|
-
try {
|
|
37
|
-
if (method === "initialize") {
|
|
38
|
-
const params = decodePeerParams(method, message.params);
|
|
39
|
-
if (initialized)
|
|
40
|
-
throw new PeerHandlerError({ code: -32600, message: "Peer already initialized" });
|
|
41
|
-
await options.handlers.initialize(params);
|
|
42
|
-
remoteHost = params.host;
|
|
43
|
-
initialized = true;
|
|
44
|
-
return write(id, peerInitializeResult(options.localHost));
|
|
45
|
-
}
|
|
46
|
-
if (!initialized)
|
|
47
|
-
throw new PeerHandlerError({ code: -32000, message: "Peer is not initialized" });
|
|
48
|
-
if (method === "catalog/get") {
|
|
49
|
-
decodePeerParams(method, message.params);
|
|
50
|
-
return write(id, decodePeerResult(method, await options.handlers.catalog()), undefined, true);
|
|
51
|
-
}
|
|
52
|
-
const params = decodePeerParams(method, message.params);
|
|
53
|
-
if (params.source.host !== remoteHost || params.target.host !== options.localHost)
|
|
54
|
-
throw new PeerHandlerError({ code: -32602, message: "Peer handoff must be direct" });
|
|
55
|
-
return write(id, decodePeerResult(method, await options.handlers.handoff(params)));
|
|
56
|
-
}
|
|
57
|
-
catch (error) {
|
|
58
|
-
const detail = error instanceof PeerHandlerError ? error.detail :
|
|
59
|
-
{ code: error instanceof Error && error.message === "INVALID_PARAMS" ? -32602 : -32603, message: error instanceof Error && error.message === "INVALID_PARAMS" ? "Invalid params" : "Internal error" };
|
|
60
|
-
await write(id, undefined, detail);
|
|
61
|
-
}
|
|
62
|
-
};
|
|
63
|
-
const read = (chunk) => {
|
|
64
|
-
if (closed)
|
|
65
|
-
return;
|
|
66
|
-
buffer = Buffer.concat([buffer, chunk]);
|
|
67
|
-
for (;;) {
|
|
68
|
-
const newline = buffer.indexOf(0x0a);
|
|
69
|
-
if (newline < 0) {
|
|
70
|
-
if (buffer.length > PEER_MAX_REQUEST_BYTES)
|
|
71
|
-
close();
|
|
72
|
-
return;
|
|
73
|
-
}
|
|
74
|
-
const line = buffer.subarray(0, newline);
|
|
75
|
-
buffer = buffer.subarray(newline + 1);
|
|
76
|
-
if (line.length > PEER_MAX_REQUEST_BYTES)
|
|
77
|
-
return close();
|
|
78
|
-
let value;
|
|
79
|
-
try {
|
|
80
|
-
value = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(line));
|
|
81
|
-
}
|
|
82
|
-
catch {
|
|
83
|
-
operations = operations.then(() => write(null, undefined, { code: -32700, message: "Parse error" })).catch(close);
|
|
84
|
-
continue;
|
|
85
|
-
}
|
|
86
|
-
if (!object(value) || value.jsonrpc !== "2.0" || !id(value.id) || typeof value.method !== "string" || !Object.hasOwn(value, "params") || Object.keys(value).length !== 4) {
|
|
87
|
-
operations = operations.then(() => write(null, undefined, { code: -32600, message: "Invalid Request" })).catch(close);
|
|
88
|
-
continue;
|
|
89
|
-
}
|
|
90
|
-
operations = operations.then(() => dispatch(value)).catch(close);
|
|
91
|
-
}
|
|
92
|
-
};
|
|
93
|
-
input.on("data", read);
|
|
94
|
-
input.once("end", () => { void operations.then(close); });
|
|
95
|
-
input.once("error", close);
|
|
96
|
-
return { done, close };
|
|
97
|
-
}
|
|
98
|
-
const object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
|
|
99
|
-
const id = (value) => typeof value === "string" || typeof value === "number";
|
|
100
|
-
//# sourceMappingURL=peer-stdio.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"peer-stdio.js","sourceRoot":"","sources":["../../../src/gateway/peer-stdio.ts"],"names":[],"mappings":"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"}
|