@masons/agent-network 0.5.321 → 0.5.323

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.
Files changed (102) hide show
  1. package/dist/runtime-endpoint-client.d.ts +10 -0
  2. package/dist/runtime-endpoint-client.d.ts.map +1 -1
  3. package/dist/runtime-endpoint-client.js +79 -0
  4. package/dist/version.d.ts +1 -1
  5. package/dist/version.js +1 -1
  6. package/package.json +14 -22
  7. package/dist/broker/broker-daemon.d.ts +0 -57
  8. package/dist/broker/broker-daemon.d.ts.map +0 -1
  9. package/dist/broker/broker-daemon.js +0 -759
  10. package/dist/broker/claude-code-spawn-driver.d.ts +0 -14
  11. package/dist/broker/claude-code-spawn-driver.d.ts.map +0 -1
  12. package/dist/broker/claude-code-spawn-driver.js +0 -39
  13. package/dist/broker/closed-endpoint-lookup.d.ts +0 -25
  14. package/dist/broker/closed-endpoint-lookup.d.ts.map +0 -1
  15. package/dist/broker/closed-endpoint-lookup.js +0 -59
  16. package/dist/broker/codex-spawn-driver-stub.d.ts +0 -7
  17. package/dist/broker/codex-spawn-driver-stub.d.ts.map +0 -1
  18. package/dist/broker/codex-spawn-driver-stub.js +0 -13
  19. package/dist/broker/connector-ws.d.ts +0 -47
  20. package/dist/broker/connector-ws.d.ts.map +0 -1
  21. package/dist/broker/connector-ws.js +0 -60
  22. package/dist/broker/control-event-dispatcher.d.ts +0 -21
  23. package/dist/broker/control-event-dispatcher.d.ts.map +0 -1
  24. package/dist/broker/control-event-dispatcher.js +0 -45
  25. package/dist/broker/control-event-types.d.ts +0 -28
  26. package/dist/broker/control-event-types.d.ts.map +0 -1
  27. package/dist/broker/control-event-types.js +0 -1
  28. package/dist/broker/correlation-ring.d.ts +0 -10
  29. package/dist/broker/correlation-ring.d.ts.map +0 -1
  30. package/dist/broker/correlation-ring.js +0 -32
  31. package/dist/broker/discovery-file.d.ts +0 -12
  32. package/dist/broker/discovery-file.d.ts.map +0 -1
  33. package/dist/broker/discovery-file.js +0 -77
  34. package/dist/broker/endpoint-registry.d.ts +0 -53
  35. package/dist/broker/endpoint-registry.d.ts.map +0 -1
  36. package/dist/broker/endpoint-registry.js +0 -83
  37. package/dist/broker/endpoint-state-machine.d.ts +0 -40
  38. package/dist/broker/endpoint-state-machine.d.ts.map +0 -1
  39. package/dist/broker/endpoint-state-machine.js +0 -92
  40. package/dist/broker/entry.d.ts +0 -13
  41. package/dist/broker/entry.d.ts.map +0 -1
  42. package/dist/broker/entry.js +0 -229
  43. package/dist/broker/grace-timer.d.ts +0 -9
  44. package/dist/broker/grace-timer.d.ts.map +0 -1
  45. package/dist/broker/grace-timer.js +0 -34
  46. package/dist/broker/ipc-server.d.ts +0 -79
  47. package/dist/broker/ipc-server.d.ts.map +0 -1
  48. package/dist/broker/ipc-server.js +0 -263
  49. package/dist/broker/logger.d.ts +0 -10
  50. package/dist/broker/logger.d.ts.map +0 -1
  51. package/dist/broker/logger.js +0 -34
  52. package/dist/broker/network-presence.d.ts +0 -31
  53. package/dist/broker/network-presence.d.ts.map +0 -1
  54. package/dist/broker/network-presence.js +0 -109
  55. package/dist/broker/paths.d.ts +0 -11
  56. package/dist/broker/paths.d.ts.map +0 -1
  57. package/dist/broker/paths.js +0 -30
  58. package/dist/broker/plugin-liveness.d.ts +0 -2
  59. package/dist/broker/plugin-liveness.d.ts.map +0 -1
  60. package/dist/broker/plugin-liveness.js +0 -15
  61. package/dist/broker/received-message-correlation-cache.d.ts +0 -23
  62. package/dist/broker/received-message-correlation-cache.d.ts.map +0 -1
  63. package/dist/broker/received-message-correlation-cache.js +0 -114
  64. package/dist/broker/reconnecting-buffer.d.ts +0 -23
  65. package/dist/broker/reconnecting-buffer.d.ts.map +0 -1
  66. package/dist/broker/reconnecting-buffer.js +0 -107
  67. package/dist/broker/routing-table.d.ts +0 -22
  68. package/dist/broker/routing-table.d.ts.map +0 -1
  69. package/dist/broker/routing-table.js +0 -35
  70. package/dist/broker/runtime-endpoint-port.d.ts +0 -8
  71. package/dist/broker/runtime-endpoint-port.d.ts.map +0 -1
  72. package/dist/broker/runtime-endpoint-port.js +0 -1
  73. package/dist/broker/services-event-client.d.ts +0 -21
  74. package/dist/broker/services-event-client.d.ts.map +0 -1
  75. package/dist/broker/services-event-client.js +0 -221
  76. package/dist/broker/spawn-correlation.d.ts +0 -28
  77. package/dist/broker/spawn-correlation.d.ts.map +0 -1
  78. package/dist/broker/spawn-correlation.js +0 -77
  79. package/dist/broker/spawn-driver.d.ts +0 -27
  80. package/dist/broker/spawn-driver.d.ts.map +0 -1
  81. package/dist/broker/spawn-driver.js +0 -15
  82. package/dist/broker/task-hint-handler.d.ts +0 -21
  83. package/dist/broker/task-hint-handler.d.ts.map +0 -1
  84. package/dist/broker/task-hint-handler.js +0 -33
  85. package/dist/broker/transition-state-retry-queue.d.ts +0 -20
  86. package/dist/broker/transition-state-retry-queue.d.ts.map +0 -1
  87. package/dist/broker/transition-state-retry-queue.js +0 -48
  88. package/dist/broker/undispatched-inbox.d.ts +0 -26
  89. package/dist/broker/undispatched-inbox.d.ts.map +0 -1
  90. package/dist/broker/undispatched-inbox.js +0 -53
  91. package/dist/broker/version-handshake.d.ts +0 -30
  92. package/dist/broker/version-handshake.d.ts.map +0 -1
  93. package/dist/broker/version-handshake.js +0 -47
  94. package/dist/broker-client/broker-client.d.ts +0 -65
  95. package/dist/broker-client/broker-client.d.ts.map +0 -1
  96. package/dist/broker-client/broker-client.js +0 -165
  97. package/dist/broker-client/lazy-spawn.d.ts +0 -18
  98. package/dist/broker-client/lazy-spawn.d.ts.map +0 -1
  99. package/dist/broker-client/lazy-spawn.js +0 -61
  100. package/dist/session-lifecycle.d.ts +0 -89
  101. package/dist/session-lifecycle.d.ts.map +0 -1
  102. package/dist/session-lifecycle.js +0 -348
@@ -1,33 +0,0 @@
1
- export const TASK_HINT_MAX_LENGTH = 200;
2
- export function updateTaskHint(opts, update) {
3
- if (typeof update.task_hint !== "string") {
4
- return {
5
- ok: false,
6
- code: "task_hint_invalid",
7
- message: "task_hint must be a string",
8
- };
9
- }
10
- const entry = opts.registry.get(update.endpoint_id);
11
- if (!entry) {
12
- return {
13
- ok: false,
14
- code: "endpoint_unknown",
15
- message: `unknown endpoint_id: ${update.endpoint_id}`,
16
- };
17
- }
18
- if (entry.plugin_pid !== update.plugin_pid) {
19
- return {
20
- ok: false,
21
- code: "ownership_mismatch",
22
- message: "task_hint is Plugin-write-only; plugin_pid does not match",
23
- };
24
- }
25
- const raw = update.task_hint;
26
- const codePoints = [...raw];
27
- const truncated = codePoints.length > TASK_HINT_MAX_LENGTH;
28
- const effective = truncated
29
- ? codePoints.slice(0, TASK_HINT_MAX_LENGTH).join("")
30
- : raw;
31
- entry.display_metadata.task_hint = effective;
32
- return { ok: true, truncated, effective };
33
- }
@@ -1,20 +0,0 @@
1
- import type { TransitionRuntimeEndpointStateParams } from "../runtime-endpoint-client.js";
2
- export declare const DEFAULT_QUEUE_CAPACITY = 256;
3
- export interface QueuedTransition {
4
- endpoint_id: string;
5
- params: TransitionRuntimeEndpointStateParams;
6
- enqueued_at: number;
7
- }
8
- export interface TransitionStateRetryQueue {
9
- enqueue(endpoint_id: string, params: TransitionRuntimeEndpointStateParams): boolean;
10
- flush(emit: (entry: QueuedTransition) => Promise<void>): Promise<void>;
11
- size(): number;
12
- capacity(): number;
13
- peek(): readonly QueuedTransition[];
14
- }
15
- export interface TransitionStateRetryQueueOptions {
16
- capacity?: number;
17
- onDrop?: (dropped: QueuedTransition) => void;
18
- }
19
- export declare function createTransitionStateRetryQueue(opts?: TransitionStateRetryQueueOptions): TransitionStateRetryQueue;
20
- //# sourceMappingURL=transition-state-retry-queue.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"transition-state-retry-queue.d.ts","sourceRoot":"","sources":["../../src/broker/transition-state-retry-queue.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,+BAA+B,CAAC;AAE1F,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oCAAoC,CAAC;IAE7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IAExC,OAAO,CACL,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oCAAoC,GAC3C,OAAO,CAAC;IAOX,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,IAAI,MAAM,CAAC;IACf,QAAQ,IAAI,MAAM,CAAC;IAEnB,IAAI,IAAI,SAAS,gBAAgB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC9C;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,GAAE,gCAAqC,GAC1C,yBAAyB,CA4C3B"}
@@ -1,48 +0,0 @@
1
- export const DEFAULT_QUEUE_CAPACITY = 256;
2
- export function createTransitionStateRetryQueue(opts = {}) {
3
- const cap = opts.capacity ?? DEFAULT_QUEUE_CAPACITY;
4
- if (cap <= 0)
5
- throw new Error(`capacity must be positive: ${cap}`);
6
- const queue = [];
7
- return {
8
- enqueue(endpoint_id, params) {
9
- const entry = {
10
- endpoint_id,
11
- params,
12
- enqueued_at: Date.now(),
13
- };
14
- if (queue.length >= cap) {
15
- const dropped = queue.shift();
16
- if (dropped && opts.onDrop)
17
- opts.onDrop(dropped);
18
- queue.push(entry);
19
- return false;
20
- }
21
- queue.push(entry);
22
- return true;
23
- },
24
- async flush(emit) {
25
- while (queue.length > 0) {
26
- const entry = queue[0];
27
- if (!entry)
28
- break;
29
- try {
30
- await emit(entry);
31
- }
32
- catch {
33
- return;
34
- }
35
- queue.shift();
36
- }
37
- },
38
- size() {
39
- return queue.length;
40
- },
41
- capacity() {
42
- return cap;
43
- },
44
- peek() {
45
- return queue.slice();
46
- },
47
- };
48
- }
@@ -1,26 +0,0 @@
1
- export declare const DEFAULT_INBOX_CAPACITY = 256;
2
- export interface UndispatchedMessage {
3
- id: string;
4
- arrived_at: string;
5
- sender_address: string;
6
- content: string;
7
- content_type: string;
8
- metadata: Record<string, unknown>;
9
- reason: "unaddressed" | "closed_session_continuation";
10
- original_target_endpoint_id?: string;
11
- original_correlation_id?: string;
12
- }
13
- export interface UndispatchedInbox {
14
- tryAdd(msg: UndispatchedMessage): boolean;
15
- list(): UndispatchedMessage[];
16
- get(id: string): UndispatchedMessage | undefined;
17
- take(id: string): UndispatchedMessage | undefined;
18
- size(): number;
19
- capacity(): number;
20
- isUnderPressure(): boolean;
21
- }
22
- export interface UndispatchedInboxOptions {
23
- capacity?: number;
24
- }
25
- export declare function createUndispatchedInbox(opts?: UndispatchedInboxOptions): UndispatchedInbox;
26
- //# sourceMappingURL=undispatched-inbox.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"undispatched-inbox.d.ts","sourceRoot":"","sources":["../../src/broker/undispatched-inbox.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMlC,MAAM,EAAE,aAAa,GAAG,6BAA6B,CAAC;IAEtD,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAMhC,MAAM,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAE1C,IAAI,IAAI,mBAAmB,EAAE,CAAC;IAE9B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAKjD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAElD,IAAI,IAAI,MAAM,CAAC;IAEf,QAAQ,IAAI,MAAM,CAAC;IAEnB,eAAe,IAAI,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,GAAE,wBAA6B,GAClC,iBAAiB,CAkDnB"}
@@ -1,53 +0,0 @@
1
- export const DEFAULT_INBOX_CAPACITY = 256;
2
- export function createUndispatchedInbox(opts = {}) {
3
- const cap = opts.capacity ?? DEFAULT_INBOX_CAPACITY;
4
- if (cap <= 0)
5
- throw new Error(`capacity must be positive: ${cap}`);
6
- const byId = new Map();
7
- const order = [];
8
- return {
9
- tryAdd(msg) {
10
- if (byId.has(msg.id)) {
11
- byId.set(msg.id, msg);
12
- return true;
13
- }
14
- if (byId.size >= cap) {
15
- return false;
16
- }
17
- byId.set(msg.id, msg);
18
- order.push(msg.id);
19
- return true;
20
- },
21
- list() {
22
- const out = [];
23
- for (const id of order) {
24
- const m = byId.get(id);
25
- if (m)
26
- out.push(m);
27
- }
28
- return out;
29
- },
30
- get(id) {
31
- return byId.get(id);
32
- },
33
- take(id) {
34
- const m = byId.get(id);
35
- if (!m)
36
- return undefined;
37
- byId.delete(id);
38
- const idx = order.indexOf(id);
39
- if (idx >= 0)
40
- order.splice(idx, 1);
41
- return m;
42
- },
43
- size() {
44
- return byId.size;
45
- },
46
- capacity() {
47
- return cap;
48
- },
49
- isUnderPressure() {
50
- return byId.size >= Math.floor(cap * 0.9);
51
- },
52
- };
53
- }
@@ -1,30 +0,0 @@
1
- export declare const IPC_PROTOCOL_VERSION = "1.0";
2
- export interface IpcCapabilities {
3
- endpoint_metadata_v1?: boolean;
4
- remote_spawn_v1?: boolean;
5
- undispatched_inbox_v1?: boolean;
6
- }
7
- export declare const SERVER_CAPABILITIES: Readonly<IpcCapabilities>;
8
- export interface InitializeRequestBody {
9
- client_protocol_version: string;
10
- client_kind: string;
11
- client_version: string;
12
- capabilities?: IpcCapabilities;
13
- }
14
- export interface InitializeResponseBody {
15
- server_protocol_version: string;
16
- server_capabilities: IpcCapabilities;
17
- session_id: string;
18
- }
19
- export interface InitializeErrorBody {
20
- error: "protocol_version_mismatch" | "bad_request";
21
- message: string;
22
- }
23
- export declare function handleInitialize(req: InitializeRequestBody): {
24
- status: 200;
25
- body: InitializeResponseBody;
26
- } | {
27
- status: 400;
28
- body: InitializeErrorBody;
29
- };
30
- //# sourceMappingURL=version-handshake.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"version-handshake.d.ts","sourceRoot":"","sources":["../../src/broker/version-handshake.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAM1C,MAAM,WAAW,eAAe;IAE9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAGD,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,eAAe,CAIxD,CAAC;AAEH,MAAM,WAAW,qBAAqB;IAEpC,uBAAuB,EAAE,MAAM,CAAC;IAEhC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,eAAe,CAAC;IAErC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,2BAA2B,GAAG,aAAa,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,qBAAqB,GAExB;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,CA0C7C"}
@@ -1,47 +0,0 @@
1
- import { randomUUID } from "node:crypto";
2
- export const IPC_PROTOCOL_VERSION = "1.0";
3
- export const SERVER_CAPABILITIES = Object.freeze({
4
- endpoint_metadata_v1: true,
5
- remote_spawn_v1: false,
6
- undispatched_inbox_v1: false,
7
- });
8
- export function handleInitialize(req) {
9
- if (typeof req.client_protocol_version !== "string") {
10
- return {
11
- status: 400,
12
- body: {
13
- error: "bad_request",
14
- message: "client_protocol_version is required and must be a string",
15
- },
16
- };
17
- }
18
- if (typeof req.client_kind !== "string" || !req.client_kind) {
19
- return {
20
- status: 400,
21
- body: {
22
- error: "bad_request",
23
- message: "client_kind is required and must be a non-empty string",
24
- },
25
- };
26
- }
27
- const clientMajor = req.client_protocol_version.split(".")[0];
28
- const serverMajor = IPC_PROTOCOL_VERSION.split(".")[0];
29
- if (clientMajor !== serverMajor) {
30
- return {
31
- status: 400,
32
- body: {
33
- error: "protocol_version_mismatch",
34
- message: `broker IPC protocol major ${serverMajor} does not match client ` +
35
- `protocol major ${clientMajor}`,
36
- },
37
- };
38
- }
39
- return {
40
- status: 200,
41
- body: {
42
- server_protocol_version: IPC_PROTOCOL_VERSION,
43
- server_capabilities: { ...SERVER_CAPABILITIES },
44
- session_id: randomUUID(),
45
- },
46
- };
47
- }
@@ -1,65 +0,0 @@
1
- import { EventEmitter } from "node:events";
2
- import { type InitializeResponseBody } from "../broker/version-handshake.js";
3
- export interface BrokerClientDiscoverOptions {
4
- accountId: string;
5
- runtimeToken: string;
6
- userDataDir?: string;
7
- env?: Record<string, string>;
8
- timeoutMs?: number;
9
- brokerEntry?: string;
10
- nodeBinary?: string;
11
- }
12
- export interface BrokerClientConnectOptions {
13
- pluginPid: number;
14
- clientKind: string;
15
- clientVersion: string;
16
- }
17
- export interface RegisterEndpointArgs {
18
- agentId: string;
19
- kind: string;
20
- sessionName?: string;
21
- workspace?: string;
22
- trackingRef?: string;
23
- taskHint?: string;
24
- spawnToken?: string;
25
- }
26
- export interface RegisterEndpointOutcome {
27
- endpoint_id: string;
28
- }
29
- export interface BrokerInboundMessage {
30
- from: string;
31
- content: string;
32
- contentType: string;
33
- metadata?: Record<string, unknown>;
34
- }
35
- type Events = {
36
- message_received: (msg: BrokerInboundMessage) => void;
37
- disconnected: () => void;
38
- error: (err: Error) => void;
39
- };
40
- export declare class BrokerClient extends EventEmitter {
41
- private readonly handle;
42
- private ws;
43
- private pluginPid;
44
- private _sessionId;
45
- private constructor();
46
- static discover(opts: BrokerClientDiscoverOptions): Promise<BrokerClient>;
47
- get spawnedNew(): boolean;
48
- get ipcUrl(): string;
49
- get sessionId(): string | null;
50
- connect(opts: BrokerClientConnectOptions): Promise<InitializeResponseBody>;
51
- registerEndpoint(args: RegisterEndpointArgs): Promise<RegisterEndpointOutcome>;
52
- send(endpointId: string, to: string, content: string, contentType?: string, metadata?: Record<string, unknown>): Promise<{
53
- messageId: string;
54
- status: string;
55
- }>;
56
- close(endpointId?: string): Promise<void>;
57
- on<K extends keyof Events>(event: K, listener: Events[K]): this;
58
- on(event: string | symbol, listener: (...args: unknown[]) => void): this;
59
- emit<K extends keyof Events>(event: K, ...args: Parameters<Events[K]>): boolean;
60
- emit(event: string | symbol, ...args: unknown[]): boolean;
61
- private httpJson;
62
- private handleFrame;
63
- }
64
- export {};
65
- //# sourceMappingURL=broker-client.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"broker-client.d.ts","sourceRoot":"","sources":["../../src/broker-client/broker-client.ts"],"names":[],"mappings":"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"}
@@ -1,165 +0,0 @@
1
- import { EventEmitter } from "node:events";
2
- import WebSocket from "ws";
3
- import { resolveBrokerPaths } from "../broker/paths.js";
4
- import { IPC_PROTOCOL_VERSION, } from "../broker/version-handshake.js";
5
- import { discoverBroker } from "./lazy-spawn.js";
6
- export class BrokerClient extends EventEmitter {
7
- handle;
8
- ws = null;
9
- pluginPid = null;
10
- _sessionId = null;
11
- constructor(handle) {
12
- super();
13
- this.handle = handle;
14
- }
15
- static async discover(opts) {
16
- const paths = resolveBrokerPaths(opts.accountId, opts.runtimeToken, {
17
- userDataDir: opts.userDataDir,
18
- });
19
- const handle = await discoverBroker({
20
- discoveryFile: paths.discoveryFile,
21
- timeoutMs: opts.timeoutMs,
22
- brokerEntry: opts.brokerEntry,
23
- nodeBinary: opts.nodeBinary,
24
- env: {
25
- MASONS_BROKER_ACCOUNT_ID: opts.accountId,
26
- ...(opts.userDataDir
27
- ? { MASONS_BROKER_USER_DATA: opts.userDataDir }
28
- : {}),
29
- ...(opts.env ?? {}),
30
- },
31
- });
32
- return new BrokerClient(handle);
33
- }
34
- get spawnedNew() {
35
- return this.handle.spawned;
36
- }
37
- get ipcUrl() {
38
- return this.handle.record.ipcUrl;
39
- }
40
- get sessionId() {
41
- return this._sessionId;
42
- }
43
- async connect(opts) {
44
- if (this.ws) {
45
- throw new Error("BrokerClient already connected");
46
- }
47
- this.pluginPid = opts.pluginPid;
48
- const initRes = await this.httpJson("POST", "/v1/initialize", {
49
- client_protocol_version: IPC_PROTOCOL_VERSION,
50
- client_kind: opts.clientKind,
51
- client_version: opts.clientVersion,
52
- capabilities: { endpoint_metadata_v1: true },
53
- });
54
- this._sessionId = initRes.session_id;
55
- const wsUrl = `${this.handle.record.ipcUrl.replace(/^http/, "ws")}/v1/stream`;
56
- const ws = new WebSocket(wsUrl, {
57
- headers: {
58
- Authorization: `Bearer ${this.handle.record.bearerToken}`,
59
- "x-plugin-pid": String(opts.pluginPid),
60
- },
61
- });
62
- this.ws = ws;
63
- await new Promise((resolve, reject) => {
64
- const onOpen = () => {
65
- ws.off("error", onError);
66
- resolve();
67
- };
68
- const onError = (err) => {
69
- ws.off("open", onOpen);
70
- reject(err);
71
- };
72
- ws.once("open", onOpen);
73
- ws.once("error", onError);
74
- });
75
- ws.on("message", (data) => this.handleFrame(data.toString()));
76
- ws.on("close", () => {
77
- this.ws = null;
78
- this.emit("disconnected");
79
- });
80
- ws.on("error", (err) => this.emit("error", err));
81
- return initRes;
82
- }
83
- async registerEndpoint(args) {
84
- if (this.pluginPid === null) {
85
- throw new Error("BrokerClient.connect must be called before registerEndpoint");
86
- }
87
- return this.httpJson("POST", "/v1/endpoint/register", {
88
- agent_id: args.agentId,
89
- plugin_pid: this.pluginPid,
90
- kind: args.kind,
91
- session_name: args.sessionName,
92
- workspace: args.workspace,
93
- tracking_ref: args.trackingRef,
94
- task_hint: args.taskHint,
95
- spawn_token: args.spawnToken,
96
- });
97
- }
98
- async send(endpointId, to, content, contentType = "text", metadata) {
99
- return this.httpJson("POST", "/v1/send", {
100
- endpoint_id: endpointId,
101
- to,
102
- content,
103
- contentType,
104
- metadata,
105
- });
106
- }
107
- async close(endpointId) {
108
- if (endpointId) {
109
- try {
110
- await this.httpJson("DELETE", `/v1/endpoint/${encodeURIComponent(endpointId)}`);
111
- }
112
- catch {
113
- }
114
- }
115
- if (this.ws &&
116
- (this.ws.readyState === WebSocket.OPEN ||
117
- this.ws.readyState === WebSocket.CONNECTING)) {
118
- this.ws.close(1000, "client_close");
119
- }
120
- this.ws = null;
121
- }
122
- on(event, listener) {
123
- return super.on(event, listener);
124
- }
125
- emit(event, ...args) {
126
- return super.emit(event, ...args);
127
- }
128
- async httpJson(method, path, body) {
129
- const res = await fetch(`${this.handle.record.ipcUrl}${path}`, {
130
- method,
131
- headers: {
132
- Authorization: `Bearer ${this.handle.record.bearerToken}`,
133
- ...(body ? { "Content-Type": "application/json" } : {}),
134
- },
135
- body: body ? JSON.stringify(body) : undefined,
136
- });
137
- if (!res.ok) {
138
- const errText = await res.text().catch(() => "");
139
- throw new Error(`broker ${method} ${path} failed: ${res.status} ${errText}`);
140
- }
141
- return (await res.json());
142
- }
143
- handleFrame(raw) {
144
- let parsed;
145
- try {
146
- parsed = JSON.parse(raw);
147
- }
148
- catch {
149
- this.emit("error", new Error("BrokerClient received non-JSON frame"));
150
- return;
151
- }
152
- if (!parsed || typeof parsed !== "object" || !("event" in parsed))
153
- return;
154
- const event = parsed.event;
155
- if (event === "message_received") {
156
- const msg = parsed;
157
- this.emit("message_received", {
158
- from: msg.from,
159
- content: msg.content,
160
- contentType: msg.contentType,
161
- metadata: msg.metadata,
162
- });
163
- }
164
- }
165
- }
@@ -1,18 +0,0 @@
1
- import { type DiscoveryRecord } from "../broker/discovery-file.js";
2
- export interface LazySpawnOptions {
3
- brokerEntry?: string;
4
- env?: Record<string, string>;
5
- nodeBinary?: string;
6
- }
7
- export interface DiscoverOptions extends LazySpawnOptions {
8
- discoveryFile: string;
9
- timeoutMs?: number;
10
- pollIntervalMs?: number;
11
- forceSpawn?: boolean;
12
- }
13
- export interface DiscoveryHandle {
14
- record: DiscoveryRecord;
15
- spawned: boolean;
16
- }
17
- export declare function discoverBroker(opts: DiscoverOptions): Promise<DiscoveryHandle>;
18
- //# sourceMappingURL=lazy-spawn.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"lazy-spawn.d.ts","sourceRoot":"","sources":["../../src/broker-client/lazy-spawn.ts"],"names":[],"mappings":"AA0CA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAE/B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IAEvD,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IAExB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAsB,cAAc,CAClC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,eAAe,CAAC,CA8B1B"}
@@ -1,61 +0,0 @@
1
- import { spawn } from "node:child_process";
2
- import { fileURLToPath } from "node:url";
3
- import { readDiscoveryFile, } from "../broker/discovery-file.js";
4
- const DEFAULT_POLL_INTERVAL_MS = 100;
5
- const DEFAULT_DISCOVER_TIMEOUT_MS = 5_000;
6
- const DEFAULT_HEALTH_TIMEOUT_MS = 2_000;
7
- export async function discoverBroker(opts) {
8
- const deadline = Date.now() + (opts.timeoutMs ?? DEFAULT_DISCOVER_TIMEOUT_MS);
9
- const poll = opts.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
10
- if (!opts.forceSpawn) {
11
- const existing = readDiscoveryFile(opts.discoveryFile);
12
- if (existing &&
13
- (await probeHealth(existing.ipcUrl, existing.bearerToken))) {
14
- return { record: existing, spawned: false };
15
- }
16
- }
17
- spawnDaemon(opts);
18
- while (Date.now() < deadline) {
19
- const rec = readDiscoveryFile(opts.discoveryFile);
20
- if (rec && (await probeHealth(rec.ipcUrl, rec.bearerToken))) {
21
- return { record: rec, spawned: true };
22
- }
23
- await sleep(poll);
24
- }
25
- throw new Error(`broker did not become healthy within ${opts.timeoutMs ?? DEFAULT_DISCOVER_TIMEOUT_MS}ms; ` +
26
- `check ${opts.discoveryFile} and the daemon log`);
27
- }
28
- function spawnDaemon(opts) {
29
- const entry = opts.brokerEntry ?? resolveDefaultBrokerEntry();
30
- const child = spawn(opts.nodeBinary ?? process.execPath, [entry], {
31
- detached: true,
32
- stdio: "ignore",
33
- windowsHide: true,
34
- env: { ...process.env, ...(opts.env ?? {}) },
35
- });
36
- child.unref();
37
- }
38
- function resolveDefaultBrokerEntry() {
39
- const self = fileURLToPath(import.meta.url);
40
- return self.replace(/broker-client\/lazy-spawn\.(c?js|ts)$/, "broker/entry.$1");
41
- }
42
- async function probeHealth(ipcUrl, bearerToken) {
43
- const ctrl = new AbortController();
44
- const timer = setTimeout(() => ctrl.abort(), DEFAULT_HEALTH_TIMEOUT_MS);
45
- try {
46
- const res = await fetch(`${ipcUrl}/health`, {
47
- headers: { Authorization: `Bearer ${bearerToken}` },
48
- signal: ctrl.signal,
49
- });
50
- return res.ok;
51
- }
52
- catch {
53
- return false;
54
- }
55
- finally {
56
- clearTimeout(timer);
57
- }
58
- }
59
- function sleep(ms) {
60
- return new Promise((resolve) => setTimeout(resolve, ms));
61
- }