agent-embassy 1.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 +61 -0
- package/CONTRIBUTING.md +122 -0
- package/LICENSE +21 -0
- package/README.md +185 -0
- package/README.zh-CN.md +185 -0
- package/SECURITY.md +224 -0
- package/assets/live-dashboard/app.css +1610 -0
- package/assets/mark-seal.svg +7 -0
- package/assets/mark.svg +7 -0
- package/assets/social-preview.png +0 -0
- package/assets/vendor/react/LICENSE +21 -0
- package/assets/vendor/react/react-dom.production.min.js +267 -0
- package/assets/vendor/react/react.production.min.js +31 -0
- package/dist/src/errors.d.ts +5 -0
- package/dist/src/errors.js +11 -0
- package/dist/src/errors.js.map +1 -0
- package/dist/src/gateway/claude-compatibility-scratch.d.ts +18 -0
- package/dist/src/gateway/claude-compatibility-scratch.js +158 -0
- package/dist/src/gateway/claude-compatibility-scratch.js.map +1 -0
- package/dist/src/gateway/claude-helper-client.d.ts +43 -0
- package/dist/src/gateway/claude-helper-client.js +212 -0
- package/dist/src/gateway/claude-helper-client.js.map +1 -0
- package/dist/src/gateway/claude-helper-protocol.d.ts +172 -0
- package/dist/src/gateway/claude-helper-protocol.js +373 -0
- package/dist/src/gateway/claude-helper-protocol.js.map +1 -0
- package/dist/src/gateway/claude-helper-supervisor.d.ts +74 -0
- package/dist/src/gateway/claude-helper-supervisor.js +497 -0
- package/dist/src/gateway/claude-helper-supervisor.js.map +1 -0
- package/dist/src/gateway/claude-helper.d.ts +1 -0
- package/dist/src/gateway/claude-helper.js +269 -0
- package/dist/src/gateway/claude-helper.js.map +1 -0
- package/dist/src/gateway/claude-peer.d.ts +273 -0
- package/dist/src/gateway/claude-peer.js +2359 -0
- package/dist/src/gateway/claude-peer.js.map +1 -0
- package/dist/src/gateway/claude-runtime.d.ts +40 -0
- package/dist/src/gateway/claude-runtime.js +302 -0
- package/dist/src/gateway/claude-runtime.js.map +1 -0
- package/dist/src/gateway/cli-copy.d.ts +8 -0
- package/dist/src/gateway/cli-copy.en.d.ts +13 -0
- package/dist/src/gateway/cli-copy.en.js +43 -0
- package/dist/src/gateway/cli-copy.en.js.map +1 -0
- package/dist/src/gateway/cli-copy.js +19 -0
- package/dist/src/gateway/cli-copy.js.map +1 -0
- package/dist/src/gateway/cli-copy.zh-CN.d.ts +13 -0
- package/dist/src/gateway/cli-copy.zh-CN.js +43 -0
- package/dist/src/gateway/cli-copy.zh-CN.js.map +1 -0
- package/dist/src/gateway/cli.d.ts +44 -0
- package/dist/src/gateway/cli.js +969 -0
- package/dist/src/gateway/cli.js.map +1 -0
- package/dist/src/gateway/codex-app-server.d.ts +310 -0
- package/dist/src/gateway/codex-app-server.js +1746 -0
- package/dist/src/gateway/codex-app-server.js.map +1 -0
- package/dist/src/gateway/codex-local-transport.d.ts +81 -0
- package/dist/src/gateway/codex-local-transport.js +617 -0
- package/dist/src/gateway/codex-local-transport.js.map +1 -0
- package/dist/src/gateway/codex-registration-generation.d.ts +5 -0
- package/dist/src/gateway/codex-registration-generation.js +19 -0
- package/dist/src/gateway/codex-registration-generation.js.map +1 -0
- package/dist/src/gateway/codex-registration-succession.d.ts +209 -0
- package/dist/src/gateway/codex-registration-succession.js +588 -0
- package/dist/src/gateway/codex-registration-succession.js.map +1 -0
- package/dist/src/gateway/compatibility.d.ts +70 -0
- package/dist/src/gateway/compatibility.js +252 -0
- package/dist/src/gateway/compatibility.js.map +1 -0
- package/dist/src/gateway/config.d.ts +24 -0
- package/dist/src/gateway/config.js +130 -0
- package/dist/src/gateway/config.js.map +1 -0
- package/dist/src/gateway/control.d.ts +308 -0
- package/dist/src/gateway/control.js +1573 -0
- package/dist/src/gateway/control.js.map +1 -0
- package/dist/src/gateway/dashboard-copy.d.ts +7 -0
- package/dist/src/gateway/dashboard-copy.en.d.ts +506 -0
- package/dist/src/gateway/dashboard-copy.en.js +507 -0
- package/dist/src/gateway/dashboard-copy.en.js.map +1 -0
- package/dist/src/gateway/dashboard-copy.js +516 -0
- package/dist/src/gateway/dashboard-copy.js.map +1 -0
- package/dist/src/gateway/dashboard-copy.zh-CN.d.ts +506 -0
- package/dist/src/gateway/dashboard-copy.zh-CN.js +507 -0
- package/dist/src/gateway/dashboard-copy.zh-CN.js.map +1 -0
- package/dist/src/gateway/dashboard-model.d.ts +207 -0
- package/dist/src/gateway/dashboard-model.js +720 -0
- package/dist/src/gateway/dashboard-model.js.map +1 -0
- package/dist/src/gateway/dashboard.d.ts +26 -0
- package/dist/src/gateway/dashboard.js +941 -0
- package/dist/src/gateway/dashboard.js.map +1 -0
- package/dist/src/gateway/delivery-machine.d.ts +235 -0
- package/dist/src/gateway/delivery-machine.js +540 -0
- package/dist/src/gateway/delivery-machine.js.map +1 -0
- package/dist/src/gateway/instance-lease.d.ts +21 -0
- package/dist/src/gateway/instance-lease.js +549 -0
- package/dist/src/gateway/instance-lease.js.map +1 -0
- package/dist/src/gateway/live-dashboard-app/app.js +2914 -0
- package/dist/src/gateway/live-dashboard-assets.d.ts +10 -0
- package/dist/src/gateway/live-dashboard-assets.js +73 -0
- package/dist/src/gateway/live-dashboard-assets.js.map +1 -0
- package/dist/src/gateway/live-dashboard-bootstrap.d.ts +36 -0
- package/dist/src/gateway/live-dashboard-bootstrap.js +176 -0
- package/dist/src/gateway/live-dashboard-bootstrap.js.map +1 -0
- package/dist/src/gateway/live-dashboard-command.d.ts +54 -0
- package/dist/src/gateway/live-dashboard-command.js +324 -0
- package/dist/src/gateway/live-dashboard-command.js.map +1 -0
- package/dist/src/gateway/live-dashboard-http.d.ts +41 -0
- package/dist/src/gateway/live-dashboard-http.js +445 -0
- package/dist/src/gateway/live-dashboard-http.js.map +1 -0
- package/dist/src/gateway/live-dashboard-protocol.d.ts +38 -0
- package/dist/src/gateway/live-dashboard-protocol.js +156 -0
- package/dist/src/gateway/live-dashboard-protocol.js.map +1 -0
- package/dist/src/gateway/live-dashboard-server.d.ts +33 -0
- package/dist/src/gateway/live-dashboard-server.js +130 -0
- package/dist/src/gateway/live-dashboard-server.js.map +1 -0
- package/dist/src/gateway/live-dashboard-stream.d.ts +46 -0
- package/dist/src/gateway/live-dashboard-stream.js +233 -0
- package/dist/src/gateway/live-dashboard-stream.js.map +1 -0
- package/dist/src/gateway/live-dashboard.d.ts +31 -0
- package/dist/src/gateway/live-dashboard.js +190 -0
- package/dist/src/gateway/live-dashboard.js.map +1 -0
- package/dist/src/gateway/locale.d.ts +4 -0
- package/dist/src/gateway/locale.js +10 -0
- package/dist/src/gateway/locale.js.map +1 -0
- package/dist/src/gateway/progress-watch-machine.d.ts +97 -0
- package/dist/src/gateway/progress-watch-machine.js +172 -0
- package/dist/src/gateway/progress-watch-machine.js.map +1 -0
- package/dist/src/gateway/providers.d.ts +287 -0
- package/dist/src/gateway/providers.js +2451 -0
- package/dist/src/gateway/providers.js.map +1 -0
- package/dist/src/gateway/server.d.ts +57 -0
- package/dist/src/gateway/server.js +264 -0
- package/dist/src/gateway/server.js.map +1 -0
- package/dist/src/gateway/service.d.ts +449 -0
- package/dist/src/gateway/service.js +4831 -0
- package/dist/src/gateway/service.js.map +1 -0
- package/dist/src/gateway/store.d.ts +340 -0
- package/dist/src/gateway/store.js +4047 -0
- package/dist/src/gateway/store.js.map +1 -0
- package/dist/src/gateway/types.d.ts +514 -0
- package/dist/src/gateway/types.js +414 -0
- package/dist/src/gateway/types.js.map +1 -0
- package/dist/src/mutex.d.ts +4 -0
- package/dist/src/mutex.js +23 -0
- package/dist/src/mutex.js.map +1 -0
- package/docs/DESIGN.md +134 -0
- package/docs/GATEWAY-ARCHITECTURE.md +858 -0
- package/package.json +80 -0
- package/skills/embassy-peer/SKILL.md +198 -0
- package/skills/embassy-peer/agents/openai.yaml +4 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-dashboard-protocol.js","sourceRoot":"","sources":["../../../src/gateway/live-dashboard-protocol.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { type IncomingMessage, type ServerResponse } from "node:http";
|
|
2
|
+
import type { AddressInfo } from "node:net";
|
|
3
|
+
export type LiveDashboardServerAddress = Readonly<{
|
|
4
|
+
host: "127.0.0.1";
|
|
5
|
+
port: number;
|
|
6
|
+
}>;
|
|
7
|
+
export type LiveDashboardHttpServer = {
|
|
8
|
+
maxConnections: number;
|
|
9
|
+
headersTimeout: number;
|
|
10
|
+
requestTimeout: number;
|
|
11
|
+
keepAliveTimeout: number;
|
|
12
|
+
listen(options: Readonly<{
|
|
13
|
+
host: "127.0.0.1";
|
|
14
|
+
port: 0;
|
|
15
|
+
exclusive: true;
|
|
16
|
+
}>): void;
|
|
17
|
+
address(): AddressInfo | string | null;
|
|
18
|
+
once(event: "error", callback: (error: Error) => void): void;
|
|
19
|
+
once(event: "listening", callback: () => void): void;
|
|
20
|
+
off(event: "error", callback: (error: Error) => void): void;
|
|
21
|
+
off(event: "listening", callback: () => void): void;
|
|
22
|
+
close(callback: (error?: Error) => void): void;
|
|
23
|
+
closeAllConnections?(): void;
|
|
24
|
+
};
|
|
25
|
+
export type LiveDashboardHttpFactory = Readonly<{
|
|
26
|
+
createServer(listener: (request: IncomingMessage, response: ServerResponse) => void): LiveDashboardHttpServer;
|
|
27
|
+
}>;
|
|
28
|
+
export declare const defaultLiveDashboardHttpFactory: LiveDashboardHttpFactory;
|
|
29
|
+
export type BoundLiveDashboardServer = Readonly<{
|
|
30
|
+
address: LiveDashboardServerAddress;
|
|
31
|
+
close(): Promise<void>;
|
|
32
|
+
}>;
|
|
33
|
+
export declare function bindLiveDashboardServer(server: LiveDashboardHttpServer, signal?: AbortSignal): Promise<BoundLiveDashboardServer>;
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import { createServer, } from "node:http";
|
|
2
|
+
import { LIVE_DASHBOARD_LIMITS } from "./live-dashboard-protocol.js";
|
|
3
|
+
export const defaultLiveDashboardHttpFactory = {
|
|
4
|
+
createServer: (listener) => {
|
|
5
|
+
const server = createServer({
|
|
6
|
+
insecureHTTPParser: false,
|
|
7
|
+
maxHeaderSize: LIVE_DASHBOARD_LIMITS.maximumHeaderBytes,
|
|
8
|
+
}, listener);
|
|
9
|
+
return server;
|
|
10
|
+
},
|
|
11
|
+
};
|
|
12
|
+
function isIpv4LoopbackAddress(address) {
|
|
13
|
+
if (address === null || typeof address === "string")
|
|
14
|
+
return false;
|
|
15
|
+
return (address.address === "127.0.0.1" &&
|
|
16
|
+
address.family === "IPv4" &&
|
|
17
|
+
Number.isSafeInteger(address.port) &&
|
|
18
|
+
address.port > 0 &&
|
|
19
|
+
address.port <= 65_535);
|
|
20
|
+
}
|
|
21
|
+
async function closeServer(server) {
|
|
22
|
+
await new Promise((resolve, reject) => {
|
|
23
|
+
let closeFinished = false;
|
|
24
|
+
let forceFinished = false;
|
|
25
|
+
let closeError;
|
|
26
|
+
let forceError;
|
|
27
|
+
const settle = () => {
|
|
28
|
+
if (!closeFinished || !forceFinished)
|
|
29
|
+
return;
|
|
30
|
+
const error = closeError ?? forceError;
|
|
31
|
+
if (error === undefined)
|
|
32
|
+
resolve();
|
|
33
|
+
else
|
|
34
|
+
reject(error);
|
|
35
|
+
};
|
|
36
|
+
try {
|
|
37
|
+
server.close((error) => {
|
|
38
|
+
closeError = error;
|
|
39
|
+
closeFinished = true;
|
|
40
|
+
settle();
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
catch (error) {
|
|
44
|
+
reject(error);
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
try {
|
|
48
|
+
server.closeAllConnections?.();
|
|
49
|
+
}
|
|
50
|
+
catch (error) {
|
|
51
|
+
forceError = error;
|
|
52
|
+
}
|
|
53
|
+
forceFinished = true;
|
|
54
|
+
settle();
|
|
55
|
+
});
|
|
56
|
+
}
|
|
57
|
+
export async function bindLiveDashboardServer(server, signal) {
|
|
58
|
+
server.maxConnections = LIVE_DASHBOARD_LIMITS.maximumConnections;
|
|
59
|
+
server.headersTimeout = LIVE_DASHBOARD_LIMITS.headersTimeoutMs;
|
|
60
|
+
server.requestTimeout = LIVE_DASHBOARD_LIMITS.requestTimeoutMs;
|
|
61
|
+
server.keepAliveTimeout = LIVE_DASHBOARD_LIMITS.keepAliveTimeoutMs;
|
|
62
|
+
if (signal?.aborted === true) {
|
|
63
|
+
throw new Error("LIVE_DASHBOARD_BIND_ABORTED");
|
|
64
|
+
}
|
|
65
|
+
await new Promise((resolve, reject) => {
|
|
66
|
+
let settled = false;
|
|
67
|
+
const cleanup = () => {
|
|
68
|
+
server.off("error", onError);
|
|
69
|
+
server.off("listening", onListening);
|
|
70
|
+
signal?.removeEventListener("abort", onAbort);
|
|
71
|
+
};
|
|
72
|
+
const onListening = () => {
|
|
73
|
+
if (settled)
|
|
74
|
+
return;
|
|
75
|
+
settled = true;
|
|
76
|
+
cleanup();
|
|
77
|
+
resolve();
|
|
78
|
+
};
|
|
79
|
+
const onError = (error) => {
|
|
80
|
+
if (settled)
|
|
81
|
+
return;
|
|
82
|
+
settled = true;
|
|
83
|
+
cleanup();
|
|
84
|
+
reject(error);
|
|
85
|
+
};
|
|
86
|
+
const onAbort = () => {
|
|
87
|
+
if (settled)
|
|
88
|
+
return;
|
|
89
|
+
settled = true;
|
|
90
|
+
cleanup();
|
|
91
|
+
try {
|
|
92
|
+
server.close(() => undefined);
|
|
93
|
+
}
|
|
94
|
+
catch {
|
|
95
|
+
// The listener may not yet have entered Node's listening state.
|
|
96
|
+
}
|
|
97
|
+
server.closeAllConnections?.();
|
|
98
|
+
reject(new Error("LIVE_DASHBOARD_BIND_ABORTED"));
|
|
99
|
+
};
|
|
100
|
+
server.once("error", onError);
|
|
101
|
+
server.once("listening", onListening);
|
|
102
|
+
signal?.addEventListener("abort", onAbort, { once: true });
|
|
103
|
+
try {
|
|
104
|
+
server.listen({
|
|
105
|
+
host: "127.0.0.1",
|
|
106
|
+
port: 0,
|
|
107
|
+
exclusive: true,
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
catch (error) {
|
|
111
|
+
onError(error instanceof Error
|
|
112
|
+
? error
|
|
113
|
+
: new Error("LIVE_DASHBOARD_BIND_FAILED"));
|
|
114
|
+
}
|
|
115
|
+
});
|
|
116
|
+
const address = server.address();
|
|
117
|
+
if (!isIpv4LoopbackAddress(address)) {
|
|
118
|
+
await closeServer(server).catch(() => undefined);
|
|
119
|
+
throw new Error("LIVE_DASHBOARD_BIND_NOT_IPV4_LOOPBACK");
|
|
120
|
+
}
|
|
121
|
+
let closeInFlight;
|
|
122
|
+
return {
|
|
123
|
+
address: { host: "127.0.0.1", port: address.port },
|
|
124
|
+
close: () => {
|
|
125
|
+
closeInFlight ??= closeServer(server);
|
|
126
|
+
return closeInFlight;
|
|
127
|
+
},
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
//# sourceMappingURL=live-dashboard-server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-dashboard-server.js","sourceRoot":"","sources":["../../../src/gateway/live-dashboard-server.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { type DashboardViewModel } from "./dashboard-model.js";
|
|
2
|
+
import type { GatewayPublicSnapshot } from "./types.js";
|
|
3
|
+
export type LiveDashboardSnapshotRevision = string | number;
|
|
4
|
+
export type LiveDashboardObservation = Readonly<{
|
|
5
|
+
snapshotRevision: LiveDashboardSnapshotRevision;
|
|
6
|
+
snapshot: GatewayPublicSnapshot;
|
|
7
|
+
}>;
|
|
8
|
+
export type LiveDashboardObserver = Readonly<{
|
|
9
|
+
observe(): Promise<LiveDashboardObservation>;
|
|
10
|
+
}>;
|
|
11
|
+
export type LiveDashboardClock = Readonly<{
|
|
12
|
+
now(): number;
|
|
13
|
+
setInterval(callback: () => void, milliseconds: number): unknown;
|
|
14
|
+
clearInterval(handle: unknown): void;
|
|
15
|
+
}>;
|
|
16
|
+
export declare const defaultLiveDashboardClock: LiveDashboardClock;
|
|
17
|
+
export type LiveDashboardStreamWriter = Readonly<{
|
|
18
|
+
write(chunk: string): boolean;
|
|
19
|
+
onDrain(callback: () => void): void;
|
|
20
|
+
onClose(callback: () => void): void;
|
|
21
|
+
end(): void;
|
|
22
|
+
}>;
|
|
23
|
+
export type LiveDashboardStreamEvent = Readonly<{
|
|
24
|
+
streamRevision: number;
|
|
25
|
+
snapshotRevision: LiveDashboardSnapshotRevision;
|
|
26
|
+
reset: boolean;
|
|
27
|
+
model: DashboardViewModel;
|
|
28
|
+
}>;
|
|
29
|
+
export type LiveDashboardStreamHub = Readonly<{
|
|
30
|
+
add(writer: LiveDashboardStreamWriter): Readonly<{
|
|
31
|
+
ok: true;
|
|
32
|
+
close(): void;
|
|
33
|
+
}> | Readonly<{
|
|
34
|
+
ok: false;
|
|
35
|
+
safeCode: "LIVE_STREAM_LIMIT";
|
|
36
|
+
}>;
|
|
37
|
+
latest(): LiveDashboardStreamEvent | undefined;
|
|
38
|
+
pollNow(): Promise<void>;
|
|
39
|
+
refresh(): Promise<LiveDashboardStreamEvent | undefined>;
|
|
40
|
+
shutdown(): void;
|
|
41
|
+
streamCount(): number;
|
|
42
|
+
}>;
|
|
43
|
+
export declare function createLiveDashboardStreamHub(options: Readonly<{
|
|
44
|
+
observer: LiveDashboardObserver;
|
|
45
|
+
clock?: LiveDashboardClock;
|
|
46
|
+
}>): LiveDashboardStreamHub;
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { buildDashboardViewModel, } from "./dashboard-model.js";
|
|
3
|
+
import { LIVE_DASHBOARD_LIMITS } from "./live-dashboard-protocol.js";
|
|
4
|
+
export const defaultLiveDashboardClock = {
|
|
5
|
+
now: Date.now,
|
|
6
|
+
setInterval: (callback, milliseconds) => setInterval(callback, milliseconds),
|
|
7
|
+
clearInterval: (handle) => clearInterval(handle),
|
|
8
|
+
};
|
|
9
|
+
function normalizeRevision(revision) {
|
|
10
|
+
if (typeof revision === "number" &&
|
|
11
|
+
Number.isSafeInteger(revision) &&
|
|
12
|
+
revision >= 0) {
|
|
13
|
+
return revision;
|
|
14
|
+
}
|
|
15
|
+
if (typeof revision === "string" &&
|
|
16
|
+
/^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$/u.test(revision)) {
|
|
17
|
+
return revision;
|
|
18
|
+
}
|
|
19
|
+
throw new Error("LIVE_DASHBOARD_REVISION_INVALID");
|
|
20
|
+
}
|
|
21
|
+
function fingerprint(model) {
|
|
22
|
+
// Queue ages and generatedAt advance even when the broker's public semantics
|
|
23
|
+
// have not changed. Excluding only those derived clock fields mirrors the
|
|
24
|
+
// gateway's process-local snapshot revision contract while retaining a
|
|
25
|
+
// second, independently normalized restart/reset signal.
|
|
26
|
+
const semanticModel = {
|
|
27
|
+
...model,
|
|
28
|
+
generatedAt: undefined,
|
|
29
|
+
exchange: {
|
|
30
|
+
...model.exchange,
|
|
31
|
+
oldestQueueAgeMs: undefined,
|
|
32
|
+
},
|
|
33
|
+
transit: {
|
|
34
|
+
...model.transit,
|
|
35
|
+
oldestQueueAgeMs: undefined,
|
|
36
|
+
},
|
|
37
|
+
routes: model.routes.map((route) => ({
|
|
38
|
+
...route,
|
|
39
|
+
queueAgeMs: undefined,
|
|
40
|
+
})),
|
|
41
|
+
};
|
|
42
|
+
return createHash("sha256")
|
|
43
|
+
.update(JSON.stringify(semanticModel))
|
|
44
|
+
.digest("hex");
|
|
45
|
+
}
|
|
46
|
+
function isRevisionReset(previous, next, fingerprintChanged) {
|
|
47
|
+
if (previous === next)
|
|
48
|
+
return fingerprintChanged;
|
|
49
|
+
return (typeof previous === "number" &&
|
|
50
|
+
typeof next === "number" &&
|
|
51
|
+
next < previous);
|
|
52
|
+
}
|
|
53
|
+
function snapshotFrame(event) {
|
|
54
|
+
return `id: ${event.streamRevision}\nevent: snapshot\ndata: ${JSON.stringify(event)}\n\n`;
|
|
55
|
+
}
|
|
56
|
+
function unavailableFrame() {
|
|
57
|
+
return "event: observer_unavailable\ndata: {\"safeCode\":\"LIVE_OBSERVER_UNAVAILABLE\"}\n\n";
|
|
58
|
+
}
|
|
59
|
+
export function createLiveDashboardStreamHub(options) {
|
|
60
|
+
const clock = options.clock ?? defaultLiveDashboardClock;
|
|
61
|
+
const streams = new Set();
|
|
62
|
+
let interval;
|
|
63
|
+
let pollInFlight;
|
|
64
|
+
let latest;
|
|
65
|
+
let previousSourceRevision;
|
|
66
|
+
let streamRevision = 0;
|
|
67
|
+
let observerUnavailable = false;
|
|
68
|
+
let stopped = false;
|
|
69
|
+
const closeStream = (stream) => {
|
|
70
|
+
if (stream.closed)
|
|
71
|
+
return;
|
|
72
|
+
stream.closed = true;
|
|
73
|
+
streams.delete(stream);
|
|
74
|
+
delete stream.queued;
|
|
75
|
+
try {
|
|
76
|
+
stream.writer.end();
|
|
77
|
+
}
|
|
78
|
+
catch {
|
|
79
|
+
// Closing a disconnected browser is best effort.
|
|
80
|
+
}
|
|
81
|
+
if (streams.size === 0 && interval !== undefined) {
|
|
82
|
+
clock.clearInterval(interval);
|
|
83
|
+
interval = undefined;
|
|
84
|
+
}
|
|
85
|
+
};
|
|
86
|
+
const flush = (stream, frame) => {
|
|
87
|
+
if (stream.closed)
|
|
88
|
+
return;
|
|
89
|
+
const now = clock.now();
|
|
90
|
+
if (stream.blockedAt !== undefined) {
|
|
91
|
+
if (now - stream.blockedAt >=
|
|
92
|
+
LIVE_DASHBOARD_LIMITS.backpressureTimeoutMs) {
|
|
93
|
+
closeStream(stream);
|
|
94
|
+
return;
|
|
95
|
+
}
|
|
96
|
+
stream.queued = frame;
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
try {
|
|
100
|
+
const accepted = stream.writer.write(frame);
|
|
101
|
+
stream.lastEmissionAt = now;
|
|
102
|
+
if (!accepted)
|
|
103
|
+
stream.blockedAt = now;
|
|
104
|
+
}
|
|
105
|
+
catch {
|
|
106
|
+
closeStream(stream);
|
|
107
|
+
}
|
|
108
|
+
};
|
|
109
|
+
const broadcast = (frame) => {
|
|
110
|
+
for (const stream of [...streams])
|
|
111
|
+
flush(stream, frame);
|
|
112
|
+
};
|
|
113
|
+
const tickMaintenance = () => {
|
|
114
|
+
const now = clock.now();
|
|
115
|
+
for (const stream of [...streams]) {
|
|
116
|
+
if (stream.blockedAt !== undefined &&
|
|
117
|
+
now - stream.blockedAt >=
|
|
118
|
+
LIVE_DASHBOARD_LIMITS.backpressureTimeoutMs) {
|
|
119
|
+
closeStream(stream);
|
|
120
|
+
continue;
|
|
121
|
+
}
|
|
122
|
+
if (stream.blockedAt === undefined &&
|
|
123
|
+
now - stream.lastEmissionAt >=
|
|
124
|
+
LIVE_DASHBOARD_LIMITS.heartbeatIntervalMs) {
|
|
125
|
+
flush(stream, `: heartbeat ${now}\n\n`);
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
};
|
|
129
|
+
const performPoll = async (allowWithoutStreams) => {
|
|
130
|
+
if (stopped || (!allowWithoutStreams && streams.size === 0))
|
|
131
|
+
return undefined;
|
|
132
|
+
try {
|
|
133
|
+
const observed = await options.observer.observe();
|
|
134
|
+
if (stopped)
|
|
135
|
+
return undefined;
|
|
136
|
+
const nextRevision = normalizeRevision(observed.snapshotRevision);
|
|
137
|
+
const model = buildDashboardViewModel(observed.snapshot);
|
|
138
|
+
const nextFingerprint = fingerprint(model);
|
|
139
|
+
const changed = latest?.fingerprint !== nextFingerprint;
|
|
140
|
+
const reset = observerUnavailable ||
|
|
141
|
+
(previousSourceRevision !== undefined &&
|
|
142
|
+
isRevisionReset(previousSourceRevision, nextRevision, changed));
|
|
143
|
+
const shouldPublish = latest === undefined || changed || reset;
|
|
144
|
+
previousSourceRevision = nextRevision;
|
|
145
|
+
observerUnavailable = false;
|
|
146
|
+
if (shouldPublish) {
|
|
147
|
+
streamRevision += 1;
|
|
148
|
+
const event = {
|
|
149
|
+
streamRevision,
|
|
150
|
+
snapshotRevision: nextRevision,
|
|
151
|
+
reset,
|
|
152
|
+
model,
|
|
153
|
+
};
|
|
154
|
+
latest = { event, fingerprint: nextFingerprint };
|
|
155
|
+
broadcast(snapshotFrame(event));
|
|
156
|
+
}
|
|
157
|
+
return latest?.event;
|
|
158
|
+
}
|
|
159
|
+
catch {
|
|
160
|
+
if (!observerUnavailable) {
|
|
161
|
+
observerUnavailable = true;
|
|
162
|
+
broadcast(unavailableFrame());
|
|
163
|
+
}
|
|
164
|
+
return undefined;
|
|
165
|
+
}
|
|
166
|
+
};
|
|
167
|
+
const requestPoll = (allowWithoutStreams) => {
|
|
168
|
+
if (pollInFlight !== undefined)
|
|
169
|
+
return pollInFlight;
|
|
170
|
+
pollInFlight = performPoll(allowWithoutStreams).finally(() => {
|
|
171
|
+
pollInFlight = undefined;
|
|
172
|
+
});
|
|
173
|
+
return pollInFlight;
|
|
174
|
+
};
|
|
175
|
+
const pollNow = async () => {
|
|
176
|
+
if (stopped || streams.size === 0)
|
|
177
|
+
return;
|
|
178
|
+
await requestPoll(false);
|
|
179
|
+
};
|
|
180
|
+
const startPolling = () => {
|
|
181
|
+
if (interval !== undefined || stopped || streams.size === 0)
|
|
182
|
+
return;
|
|
183
|
+
interval = clock.setInterval(() => {
|
|
184
|
+
tickMaintenance();
|
|
185
|
+
void pollNow();
|
|
186
|
+
}, LIVE_DASHBOARD_LIMITS.pollIntervalMs);
|
|
187
|
+
void pollNow();
|
|
188
|
+
};
|
|
189
|
+
return {
|
|
190
|
+
add: (writer) => {
|
|
191
|
+
if (stopped || streams.size >= LIVE_DASHBOARD_LIMITS.maximumStreams) {
|
|
192
|
+
return { ok: false, safeCode: "LIVE_STREAM_LIMIT" };
|
|
193
|
+
}
|
|
194
|
+
const stream = {
|
|
195
|
+
writer,
|
|
196
|
+
lastEmissionAt: clock.now(),
|
|
197
|
+
closed: false,
|
|
198
|
+
};
|
|
199
|
+
streams.add(stream);
|
|
200
|
+
writer.onDrain(() => {
|
|
201
|
+
if (stream.closed || stream.blockedAt === undefined)
|
|
202
|
+
return;
|
|
203
|
+
delete stream.blockedAt;
|
|
204
|
+
const queued = stream.queued;
|
|
205
|
+
delete stream.queued;
|
|
206
|
+
if (queued !== undefined)
|
|
207
|
+
flush(stream, queued);
|
|
208
|
+
});
|
|
209
|
+
writer.onClose(() => closeStream(stream));
|
|
210
|
+
if (latest !== undefined)
|
|
211
|
+
flush(stream, snapshotFrame(latest.event));
|
|
212
|
+
startPolling();
|
|
213
|
+
return { ok: true, close: () => closeStream(stream) };
|
|
214
|
+
},
|
|
215
|
+
latest: () => latest?.event,
|
|
216
|
+
pollNow,
|
|
217
|
+
refresh: async () => await requestPoll(true),
|
|
218
|
+
shutdown: () => {
|
|
219
|
+
if (stopped)
|
|
220
|
+
return;
|
|
221
|
+
stopped = true;
|
|
222
|
+
if (interval !== undefined) {
|
|
223
|
+
clock.clearInterval(interval);
|
|
224
|
+
interval = undefined;
|
|
225
|
+
}
|
|
226
|
+
broadcast("event: shutdown\ndata: {\"safeCode\":\"LIVE_DASHBOARD_SHUTDOWN\"}\n\n");
|
|
227
|
+
for (const stream of [...streams])
|
|
228
|
+
closeStream(stream);
|
|
229
|
+
},
|
|
230
|
+
streamCount: () => streams.size,
|
|
231
|
+
};
|
|
232
|
+
}
|
|
233
|
+
//# sourceMappingURL=live-dashboard-stream.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-dashboard-stream.js","sourceRoot":"","sources":["../../../src/gateway/live-dashboard-stream.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { type DashboardLocale } from "./dashboard-copy.js";
|
|
2
|
+
import { type LiveDashboardFileSystem, type LiveDashboardRandomBytes } from "./live-dashboard-bootstrap.js";
|
|
3
|
+
import { type LiveDashboardActionExecutor } from "./live-dashboard-http.js";
|
|
4
|
+
import { type LiveDashboardHttpFactory, type LiveDashboardServerAddress } from "./live-dashboard-server.js";
|
|
5
|
+
import { type LiveDashboardClock, type LiveDashboardObserver } from "./live-dashboard-stream.js";
|
|
6
|
+
export type LiveDashboardDependencies = Readonly<{
|
|
7
|
+
random?: LiveDashboardRandomBytes;
|
|
8
|
+
fileSystem?: LiveDashboardFileSystem;
|
|
9
|
+
http?: LiveDashboardHttpFactory;
|
|
10
|
+
clock?: LiveDashboardClock;
|
|
11
|
+
openBootstrap?: (bootstrapPath: string) => Promise<void> | void;
|
|
12
|
+
}>;
|
|
13
|
+
export type StartLiveDashboardOptions = Readonly<{
|
|
14
|
+
privateStateRoot: string;
|
|
15
|
+
observer: LiveDashboardObserver;
|
|
16
|
+
actions: LiveDashboardActionExecutor;
|
|
17
|
+
locale?: DashboardLocale;
|
|
18
|
+
signal?: AbortSignal;
|
|
19
|
+
dependencies?: LiveDashboardDependencies;
|
|
20
|
+
}>;
|
|
21
|
+
export type RunningLiveDashboard = Readonly<{
|
|
22
|
+
address: LiveDashboardServerAddress;
|
|
23
|
+
bootstrapPath: string;
|
|
24
|
+
close(): Promise<void>;
|
|
25
|
+
}>;
|
|
26
|
+
export declare class LiveDashboardStartupCancelledError extends Error {
|
|
27
|
+
readonly code: "LIVE_DASHBOARD_START_CANCELLED";
|
|
28
|
+
constructor();
|
|
29
|
+
}
|
|
30
|
+
export declare function isLiveDashboardStartupCancelled(error: unknown): error is LiveDashboardStartupCancelledError;
|
|
31
|
+
export declare function startLiveDashboard(options: StartLiveDashboardOptions): Promise<RunningLiveDashboard>;
|