@masons/agent-network 0.5.322 → 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 (112) hide show
  1. package/dist/runtime-endpoint-client.d.ts.map +1 -1
  2. package/dist/version.d.ts +1 -1
  3. package/dist/version.js +1 -1
  4. package/package.json +14 -22
  5. package/dist/broker/broker-daemon.d.ts +0 -71
  6. package/dist/broker/broker-daemon.d.ts.map +0 -1
  7. package/dist/broker/broker-daemon.js +0 -837
  8. package/dist/broker/claude-code-spawn-driver.d.ts +0 -14
  9. package/dist/broker/claude-code-spawn-driver.d.ts.map +0 -1
  10. package/dist/broker/claude-code-spawn-driver.js +0 -39
  11. package/dist/broker/closed-endpoint-lookup.d.ts +0 -25
  12. package/dist/broker/closed-endpoint-lookup.d.ts.map +0 -1
  13. package/dist/broker/closed-endpoint-lookup.js +0 -59
  14. package/dist/broker/codex-spawn-driver-stub.d.ts +0 -7
  15. package/dist/broker/codex-spawn-driver-stub.d.ts.map +0 -1
  16. package/dist/broker/codex-spawn-driver-stub.js +0 -13
  17. package/dist/broker/connector-ws.d.ts +0 -47
  18. package/dist/broker/connector-ws.d.ts.map +0 -1
  19. package/dist/broker/connector-ws.js +0 -60
  20. package/dist/broker/control-event-dispatcher.d.ts +0 -21
  21. package/dist/broker/control-event-dispatcher.d.ts.map +0 -1
  22. package/dist/broker/control-event-dispatcher.js +0 -45
  23. package/dist/broker/control-event-types.d.ts +0 -28
  24. package/dist/broker/control-event-types.d.ts.map +0 -1
  25. package/dist/broker/control-event-types.js +0 -1
  26. package/dist/broker/correlation-ring.d.ts +0 -10
  27. package/dist/broker/correlation-ring.d.ts.map +0 -1
  28. package/dist/broker/correlation-ring.js +0 -32
  29. package/dist/broker/discovery-file.d.ts +0 -12
  30. package/dist/broker/discovery-file.d.ts.map +0 -1
  31. package/dist/broker/discovery-file.js +0 -77
  32. package/dist/broker/endpoint-registry.d.ts +0 -53
  33. package/dist/broker/endpoint-registry.d.ts.map +0 -1
  34. package/dist/broker/endpoint-registry.js +0 -83
  35. package/dist/broker/endpoint-state-machine.d.ts +0 -40
  36. package/dist/broker/endpoint-state-machine.d.ts.map +0 -1
  37. package/dist/broker/endpoint-state-machine.js +0 -92
  38. package/dist/broker/entry.d.ts +0 -13
  39. package/dist/broker/entry.d.ts.map +0 -1
  40. package/dist/broker/entry.js +0 -235
  41. package/dist/broker/grace-timer.d.ts +0 -9
  42. package/dist/broker/grace-timer.d.ts.map +0 -1
  43. package/dist/broker/grace-timer.js +0 -34
  44. package/dist/broker/ipc-server.d.ts +0 -79
  45. package/dist/broker/ipc-server.d.ts.map +0 -1
  46. package/dist/broker/ipc-server.js +0 -263
  47. package/dist/broker/logger.d.ts +0 -10
  48. package/dist/broker/logger.d.ts.map +0 -1
  49. package/dist/broker/logger.js +0 -34
  50. package/dist/broker/network-presence-changed-event-types.d.ts +0 -8
  51. package/dist/broker/network-presence-changed-event-types.d.ts.map +0 -1
  52. package/dist/broker/network-presence-changed-event-types.js +0 -1
  53. package/dist/broker/network-presence-emitter.d.ts +0 -22
  54. package/dist/broker/network-presence-emitter.d.ts.map +0 -1
  55. package/dist/broker/network-presence-emitter.js +0 -150
  56. package/dist/broker/network-presence.d.ts +0 -31
  57. package/dist/broker/network-presence.d.ts.map +0 -1
  58. package/dist/broker/network-presence.js +0 -109
  59. package/dist/broker/paths.d.ts +0 -11
  60. package/dist/broker/paths.d.ts.map +0 -1
  61. package/dist/broker/paths.js +0 -30
  62. package/dist/broker/plugin-liveness.d.ts +0 -2
  63. package/dist/broker/plugin-liveness.d.ts.map +0 -1
  64. package/dist/broker/plugin-liveness.js +0 -15
  65. package/dist/broker/received-message-correlation-cache.d.ts +0 -23
  66. package/dist/broker/received-message-correlation-cache.d.ts.map +0 -1
  67. package/dist/broker/received-message-correlation-cache.js +0 -114
  68. package/dist/broker/reconnecting-buffer.d.ts +0 -23
  69. package/dist/broker/reconnecting-buffer.d.ts.map +0 -1
  70. package/dist/broker/reconnecting-buffer.js +0 -107
  71. package/dist/broker/routing-table.d.ts +0 -22
  72. package/dist/broker/routing-table.d.ts.map +0 -1
  73. package/dist/broker/routing-table.js +0 -35
  74. package/dist/broker/runtime-endpoint-port.d.ts +0 -20
  75. package/dist/broker/runtime-endpoint-port.d.ts.map +0 -1
  76. package/dist/broker/runtime-endpoint-port.js +0 -1
  77. package/dist/broker/services-event-client.d.ts +0 -21
  78. package/dist/broker/services-event-client.d.ts.map +0 -1
  79. package/dist/broker/services-event-client.js +0 -221
  80. package/dist/broker/spawn-correlation.d.ts +0 -28
  81. package/dist/broker/spawn-correlation.d.ts.map +0 -1
  82. package/dist/broker/spawn-correlation.js +0 -77
  83. package/dist/broker/spawn-driver.d.ts +0 -27
  84. package/dist/broker/spawn-driver.d.ts.map +0 -1
  85. package/dist/broker/spawn-driver.js +0 -15
  86. package/dist/broker/task-hint-handler.d.ts +0 -21
  87. package/dist/broker/task-hint-handler.d.ts.map +0 -1
  88. package/dist/broker/task-hint-handler.js +0 -33
  89. package/dist/broker/transition-state-retry-queue.d.ts +0 -20
  90. package/dist/broker/transition-state-retry-queue.d.ts.map +0 -1
  91. package/dist/broker/transition-state-retry-queue.js +0 -48
  92. package/dist/broker/undispatched-changed-event-types.d.ts +0 -29
  93. package/dist/broker/undispatched-changed-event-types.d.ts.map +0 -1
  94. package/dist/broker/undispatched-changed-event-types.js +0 -14
  95. package/dist/broker/undispatched-emitter.d.ts +0 -22
  96. package/dist/broker/undispatched-emitter.d.ts.map +0 -1
  97. package/dist/broker/undispatched-emitter.js +0 -149
  98. package/dist/broker/undispatched-inbox.d.ts +0 -26
  99. package/dist/broker/undispatched-inbox.d.ts.map +0 -1
  100. package/dist/broker/undispatched-inbox.js +0 -53
  101. package/dist/broker/version-handshake.d.ts +0 -30
  102. package/dist/broker/version-handshake.d.ts.map +0 -1
  103. package/dist/broker/version-handshake.js +0 -47
  104. package/dist/broker-client/broker-client.d.ts +0 -65
  105. package/dist/broker-client/broker-client.d.ts.map +0 -1
  106. package/dist/broker-client/broker-client.js +0 -165
  107. package/dist/broker-client/lazy-spawn.d.ts +0 -18
  108. package/dist/broker-client/lazy-spawn.d.ts.map +0 -1
  109. package/dist/broker-client/lazy-spawn.js +0 -61
  110. package/dist/session-lifecycle.d.ts +0 -89
  111. package/dist/session-lifecycle.d.ts.map +0 -1
  112. package/dist/session-lifecycle.js +0 -348
@@ -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
- }
@@ -1,89 +0,0 @@
1
- /**
2
- * Session Lifecycle — manages MSTP session state per contact.
3
- *
4
- * State machine: idle -> creating -> active -> recreating -> failed.
5
- * Internal key: MSTP address (not handle) — supports same handle on different Connectors.
6
- *
7
- * Responsibilities:
8
- * - Maps MSTP address to session state (sessionId, status, pending promise)
9
- * - Auto-creates sessions on demand via ensureSession()
10
- * - Deduplicates concurrent creates (second caller awaits first's promise)
11
- * - Registers inbound sessions from remote agents
12
- * - Invalidates all sessions on transport disconnect
13
- * - Subscribes to ConnectorClient events: session_created, session_error, session_ended, disconnected
14
- *
15
- * @see docs/openclaw/session-abstraction-system-design.md §6.1
16
- */
17
- import type { ConnectorClient } from "./connector-client.js";
18
- export type SessionStatus = "idle" | "creating" | "active" | "recreating" | "failed";
19
- export interface SessionState {
20
- status: SessionStatus;
21
- sessionId: string | null;
22
- pendingRequestId: string | null;
23
- retryCount: number;
24
- /** Promise that resolves when session creation completes. Used for dedup. */
25
- createPromise: Promise<string> | null;
26
- /** Resolve function for the create promise. */
27
- createResolve: ((sessionId: string) => void) | null;
28
- /** Reject function for the create promise. */
29
- createReject: ((err: Error) => void) | null;
30
- }
31
- export declare class SessionLifecycle {
32
- private readonly client;
33
- /** Primary map: MSTP address -> session state */
34
- private readonly sessions;
35
- /** Reverse index: sessionId -> MSTP address */
36
- private readonly sessionToAddress;
37
- /** Configurable timeout for tests */
38
- private timeoutMs;
39
- constructor(client: ConnectorClient);
40
- /**
41
- * Ensure an active session exists for the given address.
42
- * Returns the sessionId. Creates a new session if none exists.
43
- * Concurrent callers get the same promise (dedup).
44
- */
45
- ensureSession(address: string): Promise<string>;
46
- /**
47
- * Get the active sessionId for an address, or null.
48
- */
49
- getSession(address: string): string | null;
50
- /**
51
- * Close the session for an address.
52
- */
53
- closeSession(address: string, reason?: string): void;
54
- /**
55
- * Register an inbound session (remote initiated).
56
- */
57
- registerInbound(sessionId: string, address: string): void;
58
- /**
59
- * Invalidate all sessions. Called on transport disconnect.
60
- * Conversations are preserved but sessions are cleared.
61
- */
62
- invalidateAll(): void;
63
- /**
64
- * Reverse lookup: sessionId -> MSTP address.
65
- */
66
- getAddressBySessionId(sessionId: string): string | undefined;
67
- /**
68
- * Get all session entries (for listing conversations).
69
- */
70
- listSessions(): Array<{
71
- address: string;
72
- status: SessionStatus;
73
- sessionId: string | null;
74
- }>;
75
- /**
76
- * Remove a session entry entirely (for endConversation).
77
- */
78
- removeSession(address: string): void;
79
- /** @internal Override timeout for tests. */
80
- _setTimeoutForTesting(ms: number): void;
81
- /** @internal Reset for test isolation. */
82
- _resetForTesting(): void;
83
- private subscribe;
84
- private createNewSession;
85
- private handleSessionCreated;
86
- private handleSessionEnded;
87
- private handleSessionError;
88
- }
89
- //# sourceMappingURL=session-lifecycle.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../src/session-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQ7D,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACtC,+CAA+C;IAC/C,aAAa,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,8CAA8C;IAC9C,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7C;AAaD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D,qCAAqC;IACrC,OAAO,CAAC,SAAS,CAA6B;gBAElC,MAAM,EAAE,eAAe;IASnC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB/C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQ1C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAqBpD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAqBzD;;;OAGG;IACH,aAAa,IAAI,IAAI;IAqBrB;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5D;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,aAAa,CAAC;QACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;IAgBF;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAcpC,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIvC,0CAA0C;IAC1C,gBAAgB,IAAI,IAAI;IAmBxB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,gBAAgB;IA+GxB,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,kBAAkB;CA0B3B"}