@xenosystem/agent-interface-core 0.1.181 → 0.1.183

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.
@@ -0,0 +1,104 @@
1
+ /**
2
+ * The sealed conversation between a PC and a linked device, on top of Noise (decision 0006). This file knows nothing
3
+ * of sockets: it turns messages into sealed frames and back, so the host, the desktop app and a browser share it.
4
+ *
5
+ * A frame on the relay is one kind byte and one Noise message. The kind byte is outside the seal because a side must
6
+ * know which state machine reads the bytes. The prologue and the Noise tag still bind everything that matters: a kind
7
+ * changed in flight only reaches a state machine that refuses the bytes.
8
+ */
9
+ import { type NoiseKeyPair, type NoiseTransport } from './noise.js';
10
+ export declare const REMOTE_FRAME_LINK = 1;
11
+ export declare const REMOTE_FRAME_CONNECT = 2;
12
+ export declare const REMOTE_FRAME_DATA = 3;
13
+ /**
14
+ * "I have no connection with you." Without it a PC that restarted, or dropped a forged frame, goes quiet and the device
15
+ * waits out a timeout on a screen that shows nothing. It is not sealed, because the side sending it has no keys left
16
+ * for this connection. So a relay can forge one, which costs a reconnect and nothing else: it can drop frames anyway.
17
+ */
18
+ export declare const REMOTE_FRAME_CLOSED = 4;
19
+ export declare const remoteClosedFrame: () => Uint8Array;
20
+ export declare function bytesToBase64(bytes: Uint8Array): string;
21
+ export declare function bytesFromBase64(text: string): Uint8Array;
22
+ export interface RemoteLinkCode {
23
+ /** The relay address of the PC: the installation id. */
24
+ hostId: string;
25
+ /** The one-time secret. It travels only in this code, so the relay never sees it. */
26
+ psk: Uint8Array;
27
+ expiresAt: number;
28
+ }
29
+ export declare function createRemoteLinkSecret(): Uint8Array;
30
+ export declare function encodeRemoteLinkCode(code: RemoteLinkCode): string;
31
+ /** Null for anything that is not a whole, unexpired code: what a person pastes is not to be trusted to be one. */
32
+ export declare function decodeRemoteLinkCode(text: string, now?: number): RemoteLinkCode | null;
33
+ /** Sealed messages in order, split to fit Noise and joined on the far side. */
34
+ export declare class RemoteChannel {
35
+ private readonly transport;
36
+ private partial;
37
+ private partialBytes;
38
+ constructor(transport: NoiseTransport);
39
+ get remoteStaticKey(): Uint8Array;
40
+ seal(message: unknown): Uint8Array[];
41
+ /** The message this frame completes, or undefined while more fragments are due. Throws on anything forged. */
42
+ open(frame: Uint8Array): {
43
+ message: unknown;
44
+ } | undefined;
45
+ }
46
+ export interface RemoteLinkResult {
47
+ /** The other side's lasting key. */
48
+ peerKey: Uint8Array;
49
+ /** What the other side said about itself: its name, for the PC's list of devices. */
50
+ peer: unknown;
51
+ }
52
+ /** A device's half of linking. The first frame goes out at once; `read` returns the last one and the result. */
53
+ export declare class RemoteLinkAsDevice {
54
+ private readonly handshake;
55
+ constructor(input: {
56
+ hostId: string;
57
+ deviceId: string;
58
+ staticKey: NoiseKeyPair;
59
+ psk: Uint8Array;
60
+ });
61
+ start(): Uint8Array;
62
+ read(frame: Uint8Array, about: unknown): {
63
+ reply: Uint8Array;
64
+ result: RemoteLinkResult;
65
+ };
66
+ }
67
+ /** The PC's half of linking. A wrong secret fails at the last message, before anything is kept. */
68
+ export declare class RemoteLinkAsHost {
69
+ private readonly handshake;
70
+ constructor(input: {
71
+ hostId: string;
72
+ deviceId: string;
73
+ staticKey: NoiseKeyPair;
74
+ psk: Uint8Array;
75
+ });
76
+ answer(frame: Uint8Array, about: unknown): Uint8Array;
77
+ finish(frame: Uint8Array): RemoteLinkResult;
78
+ }
79
+ /** A device opening a connection to a PC it is linked to. */
80
+ export declare class RemoteConnectAsDevice {
81
+ private readonly handshake;
82
+ constructor(input: {
83
+ hostId: string;
84
+ deviceId: string;
85
+ staticKey: NoiseKeyPair;
86
+ hostKey: Uint8Array;
87
+ });
88
+ start(): Uint8Array;
89
+ read(frame: Uint8Array): RemoteChannel;
90
+ }
91
+ /** The PC accepting a device. Its key must be one the PC linked: `deviceKey` comes from the PC's own list. */
92
+ export declare function acceptRemoteConnection(input: {
93
+ hostId: string;
94
+ deviceId: string;
95
+ staticKey: NoiseKeyPair;
96
+ deviceKey: Uint8Array;
97
+ frame: Uint8Array;
98
+ }): {
99
+ reply: Uint8Array;
100
+ channel: RemoteChannel;
101
+ };
102
+ export { generateNoiseKeyPair, noiseKeyPairFrom } from './noise.js';
103
+ export type { NoiseKeyPair } from './noise.js';
104
+ //# sourceMappingURL=channel.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/remote/channel.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,186 @@
1
+ /**
2
+ * The sealed conversation between a PC and a linked device, on top of Noise (decision 0006). This file knows nothing
3
+ * of sockets: it turns messages into sealed frames and back, so the host, the desktop app and a browser share it.
4
+ *
5
+ * A frame on the relay is one kind byte and one Noise message. The kind byte is outside the seal because a side must
6
+ * know which state machine reads the bytes. The prologue and the Noise tag still bind everything that matters: a kind
7
+ * changed in flight only reaches a state machine that refuses the bytes.
8
+ */
9
+ import { generateNoiseKeyPair, NOISE_NO_ASSOCIATED_DATA, NoiseHandshake, } from './noise.js';
10
+ export const REMOTE_FRAME_LINK = 1;
11
+ export const REMOTE_FRAME_CONNECT = 2;
12
+ export const REMOTE_FRAME_DATA = 3;
13
+ /**
14
+ * "I have no connection with you." Without it a PC that restarted, or dropped a forged frame, goes quiet and the device
15
+ * waits out a timeout on a screen that shows nothing. It is not sealed, because the side sending it has no keys left
16
+ * for this connection. So a relay can forge one, which costs a reconnect and nothing else: it can drop frames anyway.
17
+ */
18
+ export const REMOTE_FRAME_CLOSED = 4;
19
+ export const remoteClosedFrame = () => Uint8Array.of(REMOTE_FRAME_CLOSED);
20
+ /** Room for the Noise tag and the fragment byte inside a 65,535-byte Noise message. */
21
+ const MAX_FRAGMENT = 60_000;
22
+ /** The host protocol's own frame limit. A message past this is an attack or a bug. */
23
+ const MAX_MESSAGE_BYTES = 32 * 1024 * 1024;
24
+ const LINK_CODE_PREFIX = 'xrl1.';
25
+ const LINK_CODE_PSK_BYTES = 32;
26
+ const encoder = new TextEncoder();
27
+ const decoder = new TextDecoder();
28
+ const frameOf = (kind, body) => {
29
+ const frame = new Uint8Array(body.length + 1);
30
+ frame[0] = kind;
31
+ frame.set(body, 1);
32
+ return frame;
33
+ };
34
+ const toBase64Url = (bytes) => {
35
+ let text = '';
36
+ for (const byte of bytes)
37
+ text += String.fromCharCode(byte);
38
+ return btoa(text).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
39
+ };
40
+ const fromBase64Url = (text) => {
41
+ const binary = atob(text.replace(/-/g, '+').replace(/_/g, '/'));
42
+ return Uint8Array.from(binary, (character) => character.charCodeAt(0));
43
+ };
44
+ export function bytesToBase64(bytes) {
45
+ let text = '';
46
+ for (let at = 0; at < bytes.length; at += 8_192)
47
+ text += String.fromCharCode(...bytes.subarray(at, at + 8_192));
48
+ return btoa(text);
49
+ }
50
+ export function bytesFromBase64(text) {
51
+ return Uint8Array.from(atob(text), (character) => character.charCodeAt(0));
52
+ }
53
+ export function createRemoteLinkSecret() {
54
+ return crypto.getRandomValues(new Uint8Array(LINK_CODE_PSK_BYTES));
55
+ }
56
+ export function encodeRemoteLinkCode(code) {
57
+ return `${LINK_CODE_PREFIX}${toBase64Url(encoder.encode(JSON.stringify({ h: code.hostId, x: code.expiresAt })))}.${toBase64Url(code.psk)}`;
58
+ }
59
+ /** Null for anything that is not a whole, unexpired code: what a person pastes is not to be trusted to be one. */
60
+ export function decodeRemoteLinkCode(text, now = Date.now()) {
61
+ const parts = text.trim().split('.');
62
+ if (parts.length !== 3 || `${parts[0]}.` !== LINK_CODE_PREFIX)
63
+ return null;
64
+ try {
65
+ const { h, x } = JSON.parse(decoder.decode(fromBase64Url(parts[1])));
66
+ const psk = fromBase64Url(parts[2]);
67
+ if (typeof h !== 'string' || !h || typeof x !== 'number' || psk.length !== LINK_CODE_PSK_BYTES || x <= now)
68
+ return null;
69
+ return { hostId: h, psk, expiresAt: x };
70
+ }
71
+ catch {
72
+ return null;
73
+ }
74
+ }
75
+ /** A connection is bound to who it is between, so a handshake cannot be replayed from one pair to another. */
76
+ const prologue = (purpose, hostId, deviceId) => encoder.encode(`xeno-remote/1|${purpose}|${hostId}|${deviceId}`);
77
+ /** Sealed messages in order, split to fit Noise and joined on the far side. */
78
+ export class RemoteChannel {
79
+ transport;
80
+ partial = [];
81
+ partialBytes = 0;
82
+ constructor(transport) {
83
+ this.transport = transport;
84
+ }
85
+ get remoteStaticKey() {
86
+ return this.transport.remoteStaticKey;
87
+ }
88
+ seal(message) {
89
+ const body = encoder.encode(JSON.stringify(message));
90
+ if (body.length > MAX_MESSAGE_BYTES)
91
+ throw new Error('This message is too long to send to another device.');
92
+ const frames = [];
93
+ for (let at = 0; at === 0 || at < body.length; at += MAX_FRAGMENT) {
94
+ const chunk = body.subarray(at, at + MAX_FRAGMENT);
95
+ const plain = new Uint8Array(chunk.length + 1);
96
+ plain[0] = at + MAX_FRAGMENT >= body.length ? 1 : 0;
97
+ plain.set(chunk, 1);
98
+ frames.push(frameOf(REMOTE_FRAME_DATA, this.transport.send.encrypt(NOISE_NO_ASSOCIATED_DATA, plain)));
99
+ }
100
+ return frames;
101
+ }
102
+ /** The message this frame completes, or undefined while more fragments are due. Throws on anything forged. */
103
+ open(frame) {
104
+ if (frame[0] !== REMOTE_FRAME_DATA)
105
+ throw new Error('This is not a message frame.');
106
+ const plain = this.transport.receive.decrypt(NOISE_NO_ASSOCIATED_DATA, frame.subarray(1));
107
+ this.partialBytes += plain.length - 1;
108
+ if (this.partialBytes > MAX_MESSAGE_BYTES)
109
+ throw new Error('This message is too long.');
110
+ this.partial.push(plain.subarray(1));
111
+ if (plain[0] !== 1)
112
+ return undefined;
113
+ const whole = new Uint8Array(this.partialBytes);
114
+ let at = 0;
115
+ for (const part of this.partial) {
116
+ whole.set(part, at);
117
+ at += part.length;
118
+ }
119
+ this.partial = [];
120
+ this.partialBytes = 0;
121
+ return { message: JSON.parse(decoder.decode(whole)) };
122
+ }
123
+ }
124
+ /** A device's half of linking. The first frame goes out at once; `read` returns the last one and the result. */
125
+ export class RemoteLinkAsDevice {
126
+ handshake;
127
+ constructor(input) {
128
+ this.handshake = new NoiseHandshake({ pattern: 'XXpsk3', initiator: true, prologue: prologue('link', input.hostId, input.deviceId), staticKey: input.staticKey, psk: input.psk });
129
+ }
130
+ start() {
131
+ return frameOf(REMOTE_FRAME_LINK, this.handshake.writeMessage());
132
+ }
133
+ read(frame, about) {
134
+ if (frame[0] !== REMOTE_FRAME_LINK)
135
+ throw new Error('This is not a linking frame.');
136
+ const peer = JSON.parse(decoder.decode(this.handshake.readMessage(frame.subarray(1))));
137
+ const reply = frameOf(REMOTE_FRAME_LINK, this.handshake.writeMessage(encoder.encode(JSON.stringify(about))));
138
+ return { reply, result: { peerKey: this.handshake.transport().remoteStaticKey, peer } };
139
+ }
140
+ }
141
+ /** The PC's half of linking. A wrong secret fails at the last message, before anything is kept. */
142
+ export class RemoteLinkAsHost {
143
+ handshake;
144
+ constructor(input) {
145
+ this.handshake = new NoiseHandshake({ pattern: 'XXpsk3', initiator: false, prologue: prologue('link', input.hostId, input.deviceId), staticKey: input.staticKey, psk: input.psk });
146
+ }
147
+ answer(frame, about) {
148
+ if (frame[0] !== REMOTE_FRAME_LINK)
149
+ throw new Error('This is not a linking frame.');
150
+ this.handshake.readMessage(frame.subarray(1));
151
+ return frameOf(REMOTE_FRAME_LINK, this.handshake.writeMessage(encoder.encode(JSON.stringify(about))));
152
+ }
153
+ finish(frame) {
154
+ if (frame[0] !== REMOTE_FRAME_LINK)
155
+ throw new Error('This is not a linking frame.');
156
+ const peer = JSON.parse(decoder.decode(this.handshake.readMessage(frame.subarray(1))));
157
+ return { peerKey: this.handshake.transport().remoteStaticKey, peer };
158
+ }
159
+ }
160
+ /** A device opening a connection to a PC it is linked to. */
161
+ export class RemoteConnectAsDevice {
162
+ handshake;
163
+ constructor(input) {
164
+ this.handshake = new NoiseHandshake({ pattern: 'KK', initiator: true, prologue: prologue('connect', input.hostId, input.deviceId), staticKey: input.staticKey, remoteStaticKey: input.hostKey });
165
+ }
166
+ start() {
167
+ return frameOf(REMOTE_FRAME_CONNECT, this.handshake.writeMessage());
168
+ }
169
+ read(frame) {
170
+ if (frame[0] !== REMOTE_FRAME_CONNECT)
171
+ throw new Error('This is not a connection frame.');
172
+ this.handshake.readMessage(frame.subarray(1));
173
+ return new RemoteChannel(this.handshake.transport());
174
+ }
175
+ }
176
+ /** The PC accepting a device. Its key must be one the PC linked: `deviceKey` comes from the PC's own list. */
177
+ export function acceptRemoteConnection(input) {
178
+ if (input.frame[0] !== REMOTE_FRAME_CONNECT)
179
+ throw new Error('This is not a connection frame.');
180
+ const handshake = new NoiseHandshake({ pattern: 'KK', initiator: false, prologue: prologue('connect', input.hostId, input.deviceId), staticKey: input.staticKey, remoteStaticKey: input.deviceKey });
181
+ handshake.readMessage(input.frame.subarray(1));
182
+ const reply = frameOf(REMOTE_FRAME_CONNECT, handshake.writeMessage());
183
+ return { reply, channel: new RemoteChannel(handshake.transport()) };
184
+ }
185
+ export { generateNoiseKeyPair, noiseKeyPairFrom } from './noise.js';
186
+ //# sourceMappingURL=channel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/remote/channel.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,76 @@
1
+ /**
2
+ * A device reaching a PC (decision 0006): this device's key and the PCs it trusts. A laptop runs it in its host, beside
3
+ * the account worker that proves who is connecting; a browser runs the same class in the page.
4
+ *
5
+ * The other PC is known by the key learned at linking. Everything the relay says about it, including its name in a
6
+ * list, is only an address: if the key does not match, the handshake fails and nothing is sent.
7
+ */
8
+ import type { AgentHostEvent, AgentRemoteHost } from '@xenosystem/agent-interface-contract';
9
+ import type { RemoteRelayLink } from './relayLink.js';
10
+ /** What a PC sends a device inside the seal. */
11
+ export type RemoteHostMessage = {
12
+ kind: 'response';
13
+ id: string;
14
+ ok: true;
15
+ result: unknown;
16
+ } | {
17
+ kind: 'response';
18
+ id: string;
19
+ ok: false;
20
+ error: string;
21
+ } | {
22
+ kind: 'event';
23
+ event: AgentHostEvent;
24
+ };
25
+ export interface RemoteLinkedHost {
26
+ id: string;
27
+ name: string;
28
+ /** base64 */
29
+ key: string;
30
+ linkedAt: string;
31
+ }
32
+ export interface RemoteDeviceState {
33
+ /** base64 */
34
+ secretKey?: string;
35
+ installationId?: string;
36
+ hosts: RemoteLinkedHost[];
37
+ }
38
+ export interface RemoteDeviceStore {
39
+ load(): Promise<RemoteDeviceState | null>;
40
+ save(state: RemoteDeviceState): Promise<void>;
41
+ }
42
+ export declare class RemoteDeviceService {
43
+ private readonly options;
44
+ private state;
45
+ private loaded;
46
+ private keyPair;
47
+ private deviceId;
48
+ private online;
49
+ private linking;
50
+ private readonly connections;
51
+ private sequence;
52
+ constructor(options: {
53
+ store: RemoteDeviceStore;
54
+ relay: RemoteRelayLink;
55
+ /** The name the other PC lists this one under. */
56
+ name: () => string;
57
+ onEvent: (hostId: string, event: AgentHostEvent) => void;
58
+ onClosed?: (hostId: string) => void;
59
+ });
60
+ private load;
61
+ private connectRelay;
62
+ hosts(): Promise<AgentRemoteHost[]>;
63
+ /** Link to the PC that showed this code. */
64
+ link(text: string): Promise<AgentRemoteHost>;
65
+ unlink(hostId: string): Promise<void>;
66
+ private connection;
67
+ /** One host request, on the other PC, under whatever that PC allows a device. */
68
+ request(hostId: string, method: string, input: unknown): Promise<unknown>;
69
+ private lost;
70
+ private receive;
71
+ private receiveLink;
72
+ private receiveConnect;
73
+ private receiveData;
74
+ stop(): Promise<void>;
75
+ }
76
+ //# sourceMappingURL=device.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/remote/device.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAA;AAgB3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAErD,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAA;AAK5C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa;IACb,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACzC,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C;AAgBD,qBAAa,mBAAmB;IAUlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IATpC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAwF;IACvG,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,QAAQ,CAAI;gBAES,OAAO,EAAE;QACpC,KAAK,EAAE,iBAAiB,CAAA;QACxB,KAAK,EAAE,eAAe,CAAA;QACtB,kDAAkD;QAClD,IAAI,EAAE,MAAM,MAAM,CAAA;QAClB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;QACxD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;KACpC;IAED,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,YAAY;IAqBd,KAAK,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAKzC,4CAA4C;IACtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAc5C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAO7B,UAAU;IAkBxB,iFAAiF;IAC3E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAc/E,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,OAAO;YAWD,WAAW;IAiBzB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,WAAW;IAkBb,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAK5B"}
@@ -0,0 +1,191 @@
1
+ import { bytesFromBase64, bytesToBase64, decodeRemoteLinkCode, generateNoiseKeyPair, noiseKeyPairFrom, REMOTE_FRAME_CLOSED, REMOTE_FRAME_CONNECT, REMOTE_FRAME_DATA, REMOTE_FRAME_LINK, RemoteConnectAsDevice, RemoteLinkAsDevice, } from './channel.js';
2
+ const REQUEST_TIMEOUT_MS = 120_000;
3
+ const STEP_TIMEOUT_MS = 20_000;
4
+ export class RemoteDeviceService {
5
+ options;
6
+ state = { hosts: [] };
7
+ loaded;
8
+ keyPair;
9
+ deviceId;
10
+ online;
11
+ linking;
12
+ connections = new Map();
13
+ sequence = 0;
14
+ constructor(options) {
15
+ this.options = options;
16
+ }
17
+ load() {
18
+ this.loaded ??= (async () => { this.state = (await this.options.store.load()) ?? this.state; })();
19
+ return this.loaded;
20
+ }
21
+ connectRelay() {
22
+ this.online ??= (async () => {
23
+ await this.load();
24
+ if (!this.state.secretKey || !this.state.installationId) {
25
+ this.state.secretKey ??= bytesToBase64(generateNoiseKeyPair().secretKey);
26
+ this.state.installationId ??= crypto.randomUUID();
27
+ await this.options.store.save(this.state);
28
+ }
29
+ this.keyPair = noiseKeyPairFrom(bytesFromBase64(this.state.secretKey));
30
+ let ready = () => { };
31
+ const onLine = new Promise((resolve) => { ready = resolve; });
32
+ this.deviceId = await this.options.relay.start({
33
+ frame: (from, bytes) => this.receive(from, bytes),
34
+ away: (hostId) => this.lost(hostId, 'That PC is not reachable right now.'),
35
+ state: (online) => { if (online)
36
+ ready();
37
+ else
38
+ for (const hostId of [...this.connections.keys()])
39
+ this.lost(hostId, 'The connection to that PC was lost.'); },
40
+ }, this.state.installationId);
41
+ await onLine;
42
+ })().catch((error) => { this.online = undefined; throw error; });
43
+ return this.online;
44
+ }
45
+ async hosts() {
46
+ await this.load();
47
+ return this.state.hosts.map(({ id, name, linkedAt }) => ({ id, name, linkedAt, connected: Boolean(this.connections.get(id)?.channel) }));
48
+ }
49
+ /** Link to the PC that showed this code. */
50
+ async link(text) {
51
+ const code = decodeRemoteLinkCode(text);
52
+ if (!code)
53
+ throw new Error('That code is not valid, or it has expired.');
54
+ await this.connectRelay();
55
+ const handshake = new RemoteLinkAsDevice({ hostId: code.hostId, deviceId: this.deviceId, staticKey: this.keyPair, psk: code.psk });
56
+ await new Promise((resolve, reject) => {
57
+ const timer = setTimeout(() => { this.linking = undefined; reject(new Error('That PC did not answer. Is remote control still on there?')); }, STEP_TIMEOUT_MS);
58
+ timer.unref?.();
59
+ this.linking = { hostId: code.hostId, handshake, done: { resolve, reject, timer } };
60
+ this.options.relay.send(code.hostId, handshake.start());
61
+ });
62
+ return (await this.hosts()).find((host) => host.id === code.hostId);
63
+ }
64
+ async unlink(hostId) {
65
+ await this.load();
66
+ this.lost(hostId, 'This PC was unlinked.');
67
+ this.state.hosts = this.state.hosts.filter((host) => host.id !== hostId);
68
+ await this.options.store.save(this.state);
69
+ }
70
+ async connection(hostId) {
71
+ const existing = this.connections.get(hostId);
72
+ if (existing?.channel)
73
+ return existing;
74
+ await this.connectRelay();
75
+ const host = this.state.hosts.find((entry) => entry.id === hostId);
76
+ if (!host)
77
+ throw new Error('That PC is not linked to this device.');
78
+ const handshake = new RemoteConnectAsDevice({ hostId, deviceId: this.deviceId, staticKey: this.keyPair, hostKey: bytesFromBase64(host.key) });
79
+ const connection = { hostId, handshake, requests: new Map() };
80
+ this.connections.set(hostId, connection);
81
+ await new Promise((resolve, reject) => {
82
+ const timer = setTimeout(() => this.lost(hostId, 'That PC did not answer.'), STEP_TIMEOUT_MS);
83
+ timer.unref?.();
84
+ connection.opened = { resolve, reject, timer };
85
+ this.options.relay.send(hostId, handshake.start());
86
+ });
87
+ return connection;
88
+ }
89
+ /** One host request, on the other PC, under whatever that PC allows a device. */
90
+ async request(hostId, method, input) {
91
+ const connection = await this.connection(hostId);
92
+ const id = `r${(this.sequence += 1)}`;
93
+ return new Promise((resolve, reject) => {
94
+ const timer = setTimeout(() => {
95
+ connection.requests.delete(id);
96
+ reject(new Error('That PC took too long to answer.'));
97
+ }, REQUEST_TIMEOUT_MS);
98
+ timer.unref?.();
99
+ connection.requests.set(id, { resolve, reject, timer });
100
+ for (const frame of connection.channel.seal({ kind: 'request', id, method, input }))
101
+ this.options.relay.send(hostId, frame);
102
+ });
103
+ }
104
+ lost(hostId, reason) {
105
+ const connection = this.connections.get(hostId);
106
+ if (!connection)
107
+ return;
108
+ this.connections.delete(hostId);
109
+ if (connection.opened) {
110
+ clearTimeout(connection.opened.timer);
111
+ connection.opened.reject(new Error(reason));
112
+ }
113
+ for (const waiter of connection.requests.values()) {
114
+ clearTimeout(waiter.timer);
115
+ waiter.reject(new Error(reason));
116
+ }
117
+ this.options.onClosed?.(hostId);
118
+ }
119
+ receive(from, bytes) {
120
+ try {
121
+ if (bytes[0] === REMOTE_FRAME_LINK)
122
+ void this.receiveLink(from, bytes);
123
+ else if (bytes[0] === REMOTE_FRAME_CONNECT)
124
+ this.receiveConnect(from, bytes);
125
+ else if (bytes[0] === REMOTE_FRAME_DATA)
126
+ this.receiveData(from, bytes);
127
+ else if (bytes[0] === REMOTE_FRAME_CLOSED)
128
+ this.lost(from, 'The connection to that PC closed. Try again.');
129
+ }
130
+ catch {
131
+ this.lost(from, 'The connection to that PC could not be trusted, so it was closed.');
132
+ }
133
+ }
134
+ async receiveLink(from, bytes) {
135
+ const linking = this.linking;
136
+ if (!linking || linking.hostId !== from)
137
+ return;
138
+ this.linking = undefined;
139
+ clearTimeout(linking.done.timer);
140
+ try {
141
+ const { reply, result } = linking.handshake.read(bytes, { name: this.options.name() });
142
+ this.options.relay.send(from, reply);
143
+ const name = typeof result.peer?.name === 'string' ? result.peer.name.slice(0, 80) : 'PC';
144
+ this.state.hosts = [...this.state.hosts.filter((host) => host.id !== from), { id: from, name, key: bytesToBase64(result.peerKey), linkedAt: new Date().toISOString() }];
145
+ await this.options.store.save(this.state);
146
+ linking.done.resolve();
147
+ }
148
+ catch {
149
+ linking.done.reject(new Error('That code did not match. Make a new one on the PC.'));
150
+ }
151
+ }
152
+ receiveConnect(from, bytes) {
153
+ const connection = this.connections.get(from);
154
+ if (!connection?.handshake || !connection.opened)
155
+ return;
156
+ connection.channel = connection.handshake.read(bytes);
157
+ delete connection.handshake;
158
+ clearTimeout(connection.opened.timer);
159
+ connection.opened.resolve();
160
+ delete connection.opened;
161
+ }
162
+ receiveData(from, bytes) {
163
+ const connection = this.connections.get(from);
164
+ if (!connection?.channel)
165
+ return;
166
+ const opened = connection.channel.open(bytes);
167
+ if (!opened)
168
+ return;
169
+ const message = opened.message;
170
+ if (message.kind === 'event') {
171
+ this.options.onEvent(from, message.event);
172
+ return;
173
+ }
174
+ const waiter = connection.requests.get(message.id);
175
+ if (!waiter)
176
+ return;
177
+ connection.requests.delete(message.id);
178
+ clearTimeout(waiter.timer);
179
+ if (message.ok)
180
+ waiter.resolve(message.result);
181
+ else
182
+ waiter.reject(new Error(message.error));
183
+ }
184
+ async stop() {
185
+ for (const hostId of [...this.connections.keys()])
186
+ this.lost(hostId, 'Remote control stopped.');
187
+ await this.options.relay.stop();
188
+ this.online = undefined;
189
+ }
190
+ }
191
+ //# sourceMappingURL=device.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"device.js","sourceRoot":"","sources":["../../src/remote/device.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export * from './channel.js';
2
+ export * from './device.js';
3
+ export * from './relayLink.js';
4
+ export * from './transport.js';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/remote/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA"}
@@ -0,0 +1,5 @@
1
+ export * from './channel.js';
2
+ export * from './device.js';
3
+ export * from './relayLink.js';
4
+ export * from './transport.js';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/remote/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA"}
@@ -0,0 +1,66 @@
1
+ declare const HASH_LENGTH = 32;
2
+ export declare const NOISE_MAX_MESSAGE_LENGTH = 65535;
3
+ export interface NoiseKeyPair {
4
+ publicKey: Uint8Array;
5
+ secretKey: Uint8Array;
6
+ }
7
+ export type NoisePatternName = 'KK' | 'XXpsk3';
8
+ export declare function generateNoiseKeyPair(): NoiseKeyPair;
9
+ export declare function noiseKeyPairFrom(secretKey: Uint8Array): NoiseKeyPair;
10
+ /** One direction of the channel. A nonce is never reused: it only counts up, and it stops at the reserved top. */
11
+ export declare class NoiseCipher {
12
+ private key;
13
+ private nonce;
14
+ constructor(key?: Uint8Array | null);
15
+ get ready(): boolean;
16
+ private iv;
17
+ encrypt(associated: Uint8Array, plaintext: Uint8Array): Uint8Array;
18
+ /** The nonce moves only on success, so a forged frame cannot push a real one out of step. */
19
+ decrypt(associated: Uint8Array, ciphertext: Uint8Array): Uint8Array;
20
+ }
21
+ export interface NoiseHandshakeOptions {
22
+ pattern: NoisePatternName;
23
+ initiator: boolean;
24
+ /** Binds the connection to its context, so a handshake cannot be replayed into another one. */
25
+ prologue: Uint8Array;
26
+ staticKey: NoiseKeyPair;
27
+ /** Required for KK: the peer this side already linked. */
28
+ remoteStaticKey?: Uint8Array;
29
+ /** Required for XXpsk3: the one-time secret from the linking code. */
30
+ psk?: Uint8Array;
31
+ /** Test vectors only. In real use the ephemeral key is fresh for every handshake. */
32
+ fixedEphemeral?: NoiseKeyPair;
33
+ }
34
+ export interface NoiseTransport {
35
+ send: NoiseCipher;
36
+ receive: NoiseCipher;
37
+ /** Same on both sides, and only if both really ran this handshake. */
38
+ handshakeHash: Uint8Array;
39
+ remoteStaticKey: Uint8Array;
40
+ }
41
+ export declare class NoiseHandshake {
42
+ private readonly symmetric;
43
+ private readonly messages;
44
+ private readonly psk;
45
+ private readonly usesPsk;
46
+ private readonly initiator;
47
+ private readonly staticKey;
48
+ private ephemeral;
49
+ private fixedEphemeral;
50
+ private remoteStatic;
51
+ private remoteEphemeral;
52
+ private index;
53
+ private splitResult;
54
+ constructor(options: NoiseHandshakeOptions);
55
+ get finished(): boolean;
56
+ /** Whose turn it is to write. */
57
+ get writes(): boolean;
58
+ private mixDh;
59
+ private advance;
60
+ writeMessage(payload?: Uint8Array): Uint8Array;
61
+ readMessage(message: Uint8Array): Uint8Array;
62
+ transport(): NoiseTransport;
63
+ }
64
+ export declare const NOISE_NO_ASSOCIATED_DATA: Uint8Array<ArrayBuffer>;
65
+ export { HASH_LENGTH as NOISE_HASH_LENGTH };
66
+ //# sourceMappingURL=noise.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"noise.d.ts","sourceRoot":"","sources":["../../src/remote/noise.ts"],"names":[],"mappings":"AAaA,QAAA,MAAM,WAAW,KAAK,CAAA;AAKtB,eAAO,MAAM,wBAAwB,QAAS,CAAA;AAE9C,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,UAAU,CAAA;IACrB,SAAS,EAAE,UAAU,CAAA;CACtB;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,QAAQ,CAAA;AAsB9C,wBAAgB,oBAAoB,IAAI,YAAY,CAGnD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,GAAG,YAAY,CAEpE;AAeD,kHAAkH;AAClH,qBAAa,WAAW;IAGV,OAAO,CAAC,GAAG;IAFvB,OAAO,CAAC,KAAK,CAAK;gBAEE,GAAG,GAAE,UAAU,GAAG,IAAW;IAEjD,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,OAAO,CAAC,EAAE;IAOV,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,UAAU;IAOlE,6FAA6F;IAC7F,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU;CAMpE;AA2DD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,gBAAgB,CAAA;IACzB,SAAS,EAAE,OAAO,CAAA;IAClB,+FAA+F;IAC/F,QAAQ,EAAE,UAAU,CAAA;IACpB,SAAS,EAAE,YAAY,CAAA;IACvB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,UAAU,CAAA;IAC5B,sEAAsE;IACtE,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB,qFAAqF;IACrF,cAAc,CAAC,EAAE,YAAY,CAAA;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,WAAW,CAAA;IACpB,sEAAsE;IACtE,aAAa,EAAE,UAAU,CAAA;IACzB,eAAe,EAAE,UAAU,CAAA;CAC5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,WAAW,CAAwC;gBAE/C,OAAO,EAAE,qBAAqB;IAoB1C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,iCAAiC;IACjC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,OAAO;IAKf,YAAY,CAAC,OAAO,GAAE,UAAkB,GAAG,UAAU;IAwBrD,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU;IA4B5C,SAAS,IAAI,cAAc;CAU5B;AAED,eAAO,MAAM,wBAAwB,yBAAQ,CAAA;AAC7C,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,CAAA"}
@@ -0,0 +1,269 @@
1
+ /**
2
+ * The Noise protocol framework (revision 34) for remote control, decision 0006: 25519, ChaChaPoly, SHA256.
3
+ * XXpsk3 links a device once. KK opens each connection between devices that already know each other.
4
+ *
5
+ * This is the published state machine and nothing of our own. The primitives come from the audited noble
6
+ * libraries, and `noise.test.ts` holds this file to the cacophony and snow test vectors, byte for byte.
7
+ */
8
+ import { chacha20poly1305 } from '@noble/ciphers/chacha.js';
9
+ import { x25519 } from '@noble/curves/ed25519.js';
10
+ import { hmac } from '@noble/hashes/hmac.js';
11
+ import { sha256 } from '@noble/hashes/sha2.js';
12
+ const DH_LENGTH = 32;
13
+ const HASH_LENGTH = 32;
14
+ const KEY_LENGTH = 32;
15
+ const TAG_LENGTH = 16;
16
+ /** Noise reserves the top nonce, and a message may not be longer than this. */
17
+ const MAX_NONCE = 2n ** 64n - 1n;
18
+ export const NOISE_MAX_MESSAGE_LENGTH = 65_535;
19
+ const PATTERNS = {
20
+ // <- s and -> s are known before the first message.
21
+ KK: { psk: false, messages: [['e', 'es', 'ss'], ['e', 'ee', 'se']] },
22
+ XXpsk3: { psk: true, messages: [['e'], ['e', 'ee', 's', 'es'], ['s', 'se', 'psk']] },
23
+ };
24
+ const EMPTY = new Uint8Array(0);
25
+ const encoder = new TextEncoder();
26
+ function concat(...parts) {
27
+ const out = new Uint8Array(parts.reduce((sum, part) => sum + part.length, 0));
28
+ let at = 0;
29
+ for (const part of parts) {
30
+ out.set(part, at);
31
+ at += part.length;
32
+ }
33
+ return out;
34
+ }
35
+ export function generateNoiseKeyPair() {
36
+ const secretKey = x25519.utils.randomSecretKey();
37
+ return { secretKey, publicKey: x25519.getPublicKey(secretKey) };
38
+ }
39
+ export function noiseKeyPairFrom(secretKey) {
40
+ return { secretKey, publicKey: x25519.getPublicKey(secretKey) };
41
+ }
42
+ function dh(pair, publicKey) {
43
+ return x25519.getSharedSecret(pair.secretKey, publicKey);
44
+ }
45
+ /** Noise's HKDF: outputs of HASHLEN, chained, with no info field. */
46
+ function hkdf(chainingKey, input, outputs) {
47
+ const tempKey = hmac(sha256, chainingKey, input);
48
+ const first = hmac(sha256, tempKey, Uint8Array.of(1));
49
+ const second = hmac(sha256, tempKey, concat(first, Uint8Array.of(2)));
50
+ if (outputs === 2)
51
+ return [first, second];
52
+ return [first, second, hmac(sha256, tempKey, concat(second, Uint8Array.of(3)))];
53
+ }
54
+ /** One direction of the channel. A nonce is never reused: it only counts up, and it stops at the reserved top. */
55
+ export class NoiseCipher {
56
+ key;
57
+ nonce = 0n;
58
+ constructor(key = null) {
59
+ this.key = key;
60
+ }
61
+ get ready() {
62
+ return this.key !== null;
63
+ }
64
+ iv() {
65
+ if (this.nonce >= MAX_NONCE)
66
+ throw new Error('This secure channel has run out of messages. Connect again.');
67
+ const iv = new Uint8Array(12);
68
+ new DataView(iv.buffer).setBigUint64(4, this.nonce, true);
69
+ return iv;
70
+ }
71
+ encrypt(associated, plaintext) {
72
+ if (!this.key)
73
+ return plaintext;
74
+ const sealed = chacha20poly1305(this.key, this.iv(), associated).encrypt(plaintext);
75
+ this.nonce += 1n;
76
+ return sealed;
77
+ }
78
+ /** The nonce moves only on success, so a forged frame cannot push a real one out of step. */
79
+ decrypt(associated, ciphertext) {
80
+ if (!this.key)
81
+ return ciphertext;
82
+ const opened = chacha20poly1305(this.key, this.iv(), associated).decrypt(ciphertext);
83
+ this.nonce += 1n;
84
+ return opened;
85
+ }
86
+ }
87
+ class SymmetricState {
88
+ chainingKey;
89
+ hash;
90
+ cipher = new NoiseCipher();
91
+ constructor(protocolName) {
92
+ // Noise section 5.2: a name of HASHLEN or shorter is used as it is, zero padded. KK's name is exactly 32 bytes.
93
+ const name = encoder.encode(protocolName);
94
+ const padded = new Uint8Array(HASH_LENGTH);
95
+ if (name.length <= HASH_LENGTH)
96
+ padded.set(name);
97
+ this.chainingKey = name.length <= HASH_LENGTH ? padded : sha256(name);
98
+ this.hash = this.chainingKey;
99
+ }
100
+ get handshakeHash() {
101
+ return this.hash;
102
+ }
103
+ get hasKey() {
104
+ return this.cipher.ready;
105
+ }
106
+ mixHash(data) {
107
+ this.hash = sha256(concat(this.hash, data));
108
+ }
109
+ mixKey(input) {
110
+ const [chainingKey, key] = hkdf(this.chainingKey, input, 2);
111
+ this.chainingKey = chainingKey;
112
+ this.cipher = new NoiseCipher(key.slice(0, KEY_LENGTH));
113
+ }
114
+ mixKeyAndHash(input) {
115
+ const [chainingKey, hash, key] = hkdf(this.chainingKey, input, 3);
116
+ this.chainingKey = chainingKey;
117
+ this.mixHash(hash);
118
+ this.cipher = new NoiseCipher(key.slice(0, KEY_LENGTH));
119
+ }
120
+ encryptAndHash(plaintext) {
121
+ const sealed = this.cipher.encrypt(this.hash, plaintext);
122
+ this.mixHash(sealed);
123
+ return sealed;
124
+ }
125
+ decryptAndHash(ciphertext) {
126
+ const opened = this.cipher.decrypt(this.hash, ciphertext);
127
+ this.mixHash(ciphertext);
128
+ return opened;
129
+ }
130
+ split() {
131
+ const [first, second] = hkdf(this.chainingKey, EMPTY, 2);
132
+ return [new NoiseCipher(first.slice(0, KEY_LENGTH)), new NoiseCipher(second.slice(0, KEY_LENGTH))];
133
+ }
134
+ }
135
+ export class NoiseHandshake {
136
+ symmetric;
137
+ messages;
138
+ psk;
139
+ usesPsk;
140
+ initiator;
141
+ staticKey;
142
+ ephemeral;
143
+ fixedEphemeral;
144
+ remoteStatic;
145
+ remoteEphemeral;
146
+ index = 0;
147
+ splitResult;
148
+ constructor(options) {
149
+ const pattern = PATTERNS[options.pattern];
150
+ if (pattern.psk && options.psk?.length !== KEY_LENGTH)
151
+ throw new Error('This handshake needs a 32-byte secret.');
152
+ if (options.pattern === 'KK' && options.remoteStaticKey?.length !== DH_LENGTH)
153
+ throw new Error('This handshake needs the linked device key.');
154
+ this.symmetric = new SymmetricState(`Noise_${options.pattern}_25519_ChaChaPoly_SHA256`);
155
+ this.messages = pattern.messages;
156
+ this.psk = options.psk;
157
+ this.usesPsk = pattern.psk;
158
+ this.initiator = options.initiator;
159
+ this.staticKey = options.staticKey;
160
+ this.fixedEphemeral = options.fixedEphemeral;
161
+ this.remoteStatic = options.remoteStaticKey;
162
+ this.symmetric.mixHash(options.prologue);
163
+ if (options.pattern === 'KK') {
164
+ const remote = options.remoteStaticKey;
165
+ this.symmetric.mixHash(options.initiator ? options.staticKey.publicKey : remote);
166
+ this.symmetric.mixHash(options.initiator ? remote : options.staticKey.publicKey);
167
+ }
168
+ }
169
+ get finished() {
170
+ return this.index >= this.messages.length;
171
+ }
172
+ /** Whose turn it is to write. */
173
+ get writes() {
174
+ return (this.index % 2 === 0) === this.initiator;
175
+ }
176
+ mixDh(token) {
177
+ const local = token === 'ee' ? this.ephemeral
178
+ : token === 'ss' ? this.staticKey
179
+ : (token === 'es') === this.initiator ? this.ephemeral : this.staticKey;
180
+ const remote = token === 'ee' ? this.remoteEphemeral
181
+ : token === 'ss' ? this.remoteStatic
182
+ : (token === 'es') === this.initiator ? this.remoteStatic : this.remoteEphemeral;
183
+ if (!local || !remote)
184
+ throw new Error('The handshake is out of order.');
185
+ this.symmetric.mixKey(dh(local, remote));
186
+ }
187
+ advance() {
188
+ this.index += 1;
189
+ if (this.finished)
190
+ this.splitResult = this.symmetric.split();
191
+ }
192
+ writeMessage(payload = EMPTY) {
193
+ if (this.finished || !this.writes)
194
+ throw new Error('It is not this side\'s turn in the handshake.');
195
+ const parts = [];
196
+ for (const token of this.messages[this.index]) {
197
+ if (token === 'e') {
198
+ this.ephemeral = this.fixedEphemeral ?? generateNoiseKeyPair();
199
+ parts.push(this.ephemeral.publicKey);
200
+ this.symmetric.mixHash(this.ephemeral.publicKey);
201
+ if (this.usesPsk)
202
+ this.symmetric.mixKey(this.ephemeral.publicKey);
203
+ }
204
+ else if (token === 's') {
205
+ parts.push(this.symmetric.encryptAndHash(this.staticKey.publicKey));
206
+ }
207
+ else if (token === 'psk') {
208
+ this.symmetric.mixKeyAndHash(this.psk);
209
+ }
210
+ else {
211
+ this.mixDh(token);
212
+ }
213
+ }
214
+ parts.push(this.symmetric.encryptAndHash(payload));
215
+ this.advance();
216
+ const message = concat(...parts);
217
+ if (message.length > NOISE_MAX_MESSAGE_LENGTH)
218
+ throw new Error('This message is too long for the secure channel.');
219
+ return message;
220
+ }
221
+ readMessage(message) {
222
+ if (this.finished || this.writes)
223
+ throw new Error('It is not this side\'s turn in the handshake.');
224
+ if (message.length > NOISE_MAX_MESSAGE_LENGTH)
225
+ throw new Error('This message is too long for the secure channel.');
226
+ let at = 0;
227
+ const take = (length) => {
228
+ if (at + length > message.length)
229
+ throw new Error('The handshake message is too short.');
230
+ const part = message.subarray(at, at + length);
231
+ at += length;
232
+ return part;
233
+ };
234
+ for (const token of this.messages[this.index]) {
235
+ if (token === 'e') {
236
+ this.remoteEphemeral = take(DH_LENGTH).slice();
237
+ this.symmetric.mixHash(this.remoteEphemeral);
238
+ if (this.usesPsk)
239
+ this.symmetric.mixKey(this.remoteEphemeral);
240
+ }
241
+ else if (token === 's') {
242
+ this.remoteStatic = this.symmetric.decryptAndHash(take(this.symmetric.hasKey ? DH_LENGTH + TAG_LENGTH : DH_LENGTH).slice()).slice();
243
+ }
244
+ else if (token === 'psk') {
245
+ this.symmetric.mixKeyAndHash(this.psk);
246
+ }
247
+ else {
248
+ this.mixDh(token);
249
+ }
250
+ }
251
+ const payload = this.symmetric.decryptAndHash(message.subarray(at).slice());
252
+ this.advance();
253
+ return payload;
254
+ }
255
+ transport() {
256
+ if (!this.splitResult || !this.remoteStatic)
257
+ throw new Error('The handshake has not finished.');
258
+ const [first, second] = this.splitResult;
259
+ return {
260
+ send: this.initiator ? first : second,
261
+ receive: this.initiator ? second : first,
262
+ handshakeHash: this.symmetric.handshakeHash,
263
+ remoteStaticKey: this.remoteStatic,
264
+ };
265
+ }
266
+ }
267
+ export const NOISE_NO_ASSOCIATED_DATA = EMPTY;
268
+ export { HASH_LENGTH as NOISE_HASH_LENGTH };
269
+ //# sourceMappingURL=noise.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"noise.js","sourceRoot":"","sources":["../../src/remote/noise.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ /** Carries bytes between device ids and can read none of them. */
2
+ export interface RemoteRelayLink {
3
+ /** The address of this device on the relay. Registers it first if it has none. */
4
+ start(handlers: {
5
+ frame: (from: string, bytes: Uint8Array) => void;
6
+ away: (deviceId: string) => void;
7
+ state: (online: boolean, detail?: string) => void;
8
+ }, installationId: string): Promise<string>;
9
+ stop(): Promise<void>;
10
+ send(to: string, bytes: Uint8Array): void;
11
+ /** Remove a device from the relay too, so its socket closes at once. */
12
+ forget(deviceId: string): Promise<void>;
13
+ }
14
+ export interface RelayLinkOptions {
15
+ origin: string;
16
+ /** How this PC reads in the person's list of devices. */
17
+ label: string;
18
+ /** A PC taking connections, or the same PC as a remote for another: two rows and two sockets. */
19
+ role: 'host' | 'device';
20
+ /** The account worker signs this: the token and a proof over the relay's own nonce. The key never leaves it. */
21
+ authorizeSocket: (nonce: string) => Promise<{
22
+ accessToken: string;
23
+ dpop: string;
24
+ } | null>;
25
+ authorizeRequest: (target: {
26
+ method: string;
27
+ url: string;
28
+ }) => Promise<{
29
+ authorization: string;
30
+ dpop?: string;
31
+ } | null>;
32
+ fetch?: typeof fetch;
33
+ WebSocket?: typeof WebSocket;
34
+ }
35
+ export declare function relayFailureDetail(reason: string): string;
36
+ export declare function createRelayLink(options: RelayLinkOptions): RemoteRelayLink;
37
+ //# sourceMappingURL=relayLink.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relayLink.d.ts","sourceRoot":"","sources":["../../src/remote/relayLink.ts"],"names":[],"mappings":"AAMA,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,KAAK,CAAC,QAAQ,EAAE;QAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACnM,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACzC,wEAAwE;IACxE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxC;AAQD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,iGAAiG;IACjG,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,gHAAgH;IAChH,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACzF,gBAAgB,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACvH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,SAAS,CAAA;CAC7B;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAiG1E"}
@@ -0,0 +1,138 @@
1
+ /**
2
+ * A device's connection to the relay: an outbound socket, so no port is ever opened on the person's computer. It carries
3
+ * sealed bytes and proves who is connecting. It holds no key that can open a frame, and no account token between calls.
4
+ */
5
+ import { bytesFromBase64, bytesToBase64 } from './channel.js';
6
+ const PATH = '/api/v2/remote';
7
+ const PING_MS = 20_000;
8
+ const FIRST_RETRY_MS = 1_000;
9
+ const LAST_RETRY_MS = 60_000;
10
+ const CLOSE_FORBIDDEN = 4403;
11
+ export function relayFailureDetail(reason) {
12
+ if (/scope remote:connect/.test(reason))
13
+ return 'Sign out and sign in again on this PC to turn this on.';
14
+ if (/turned off/.test(reason))
15
+ return 'Remote control is not available yet.';
16
+ if (/revoked/.test(reason))
17
+ return 'This PC was removed from your account.';
18
+ return 'Remote control could not connect.';
19
+ }
20
+ export function createRelayLink(options) {
21
+ const fetcher = options.fetch ?? fetch;
22
+ const Socket = options.WebSocket ?? WebSocket;
23
+ let handlers;
24
+ let socket;
25
+ let ping;
26
+ let retry;
27
+ let retryMs = FIRST_RETRY_MS;
28
+ let stopped = true;
29
+ let installationId = '';
30
+ const call = async (method, path, body) => {
31
+ const url = `${options.origin}${PATH}${path}`;
32
+ const auth = await options.authorizeRequest({ method, url });
33
+ if (!auth)
34
+ throw new Error('Sign in on this PC to use remote control.');
35
+ return fetcher(url, {
36
+ method,
37
+ headers: { 'content-type': 'application/json', authorization: auth.authorization, ...(auth.dpop ? { dpop: auth.dpop } : {}) },
38
+ ...(body === undefined ? {} : { body: JSON.stringify(body) }),
39
+ });
40
+ };
41
+ const register = async () => {
42
+ const response = await call('POST', '/installations', { installationId, label: options.label, role: options.role });
43
+ if (response.status === 404)
44
+ throw new Error('Remote control is not available yet.');
45
+ if (response.status === 403)
46
+ throw new Error('Sign out and sign in again on this PC to turn this on.');
47
+ if (!response.ok)
48
+ throw new Error('This PC could not be registered for remote control.');
49
+ return String((await response.json()).installation.id);
50
+ };
51
+ const scheduleRetry = () => {
52
+ if (stopped)
53
+ return;
54
+ retry = setTimeout(open, retryMs);
55
+ retry.unref?.();
56
+ retryMs = Math.min(retryMs * 2, LAST_RETRY_MS);
57
+ };
58
+ const open = () => {
59
+ if (stopped)
60
+ return;
61
+ const url = `${options.origin.replace(/^http/, 'ws')}${PATH}/connect?installation=${installationId}`;
62
+ const connection = new Socket(url);
63
+ socket = connection;
64
+ connection.addEventListener('message', (event) => { void receive(connection, String(event.data)); });
65
+ connection.addEventListener('error', () => { });
66
+ connection.addEventListener('close', (event) => {
67
+ if (socket === connection)
68
+ socket = undefined;
69
+ if (ping)
70
+ clearInterval(ping);
71
+ if (stopped)
72
+ return;
73
+ handlers?.state(false, event.code === CLOSE_FORBIDDEN ? relayFailureDetail(event.reason) : 'Reconnecting to remote control.');
74
+ if (event.code !== CLOSE_FORBIDDEN)
75
+ scheduleRetry();
76
+ });
77
+ };
78
+ const receive = async (connection, raw) => {
79
+ let frame;
80
+ try {
81
+ frame = JSON.parse(raw);
82
+ }
83
+ catch {
84
+ return;
85
+ }
86
+ if (frame.type === 'challenge' && typeof frame.nonce === 'string') {
87
+ const auth = await options.authorizeSocket(frame.nonce).catch(() => null);
88
+ if (!auth) {
89
+ handlers?.state(false, 'Sign in on this PC to use remote control.');
90
+ connection.close();
91
+ return;
92
+ }
93
+ connection.send(JSON.stringify({ type: 'auth', accessToken: auth.accessToken, dpop: auth.dpop }));
94
+ }
95
+ else if (frame.type === 'ready') {
96
+ retryMs = FIRST_RETRY_MS;
97
+ handlers?.state(true);
98
+ ping = setInterval(() => { if (connection.readyState === Socket.OPEN)
99
+ connection.send('{"type":"ping"}'); }, PING_MS);
100
+ ping.unref?.();
101
+ }
102
+ else if (frame.type === 'sealed' && typeof frame.from === 'string' && typeof frame.data === 'string') {
103
+ handlers?.frame(frame.from, bytesFromBase64(frame.data));
104
+ }
105
+ else if (frame.type === 'undelivered' && typeof frame.to === 'string') {
106
+ handlers?.away(frame.to);
107
+ }
108
+ };
109
+ return {
110
+ async start(value, id) {
111
+ installationId = id;
112
+ const hostId = await register();
113
+ handlers = value;
114
+ stopped = false;
115
+ retryMs = FIRST_RETRY_MS;
116
+ open();
117
+ return hostId;
118
+ },
119
+ async stop() {
120
+ stopped = true;
121
+ handlers = undefined;
122
+ if (retry)
123
+ clearTimeout(retry);
124
+ if (ping)
125
+ clearInterval(ping);
126
+ socket?.close();
127
+ socket = undefined;
128
+ },
129
+ send(to, bytes) {
130
+ if (socket?.readyState === Socket.OPEN)
131
+ socket.send(JSON.stringify({ type: 'sealed', to, data: bytesToBase64(bytes) }));
132
+ },
133
+ async forget(deviceId) {
134
+ await call('DELETE', `/installations/${encodeURIComponent(deviceId)}`).catch(() => undefined);
135
+ },
136
+ };
137
+ }
138
+ //# sourceMappingURL=relayLink.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relayLink.js","sourceRoot":"","sources":["../../src/remote/relayLink.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * The ordinary host transport, reaching a PC through a linked device (decision 0006). There is no remote-only API: a
3
+ * client on this transport is the client every other surface uses, under what that PC allows a device.
4
+ */
5
+ import type { AgentHostClientIdentity, AgentHostEvent, AgentHostEventListener, AgentHostInput, AgentHostMethod, AgentHostOutput, AgentHostTransport, AgentHostUnsubscribe } from '@xenosystem/agent-interface-contract';
6
+ export declare class RelayAgentHostTransport implements AgentHostTransport {
7
+ private readonly options;
8
+ private readonly listeners;
9
+ constructor(options: {
10
+ hostId: string;
11
+ /** Who this surface is here. The PC names the device on its side, and the client checks the handshake against this one. */
12
+ identity: AgentHostClientIdentity;
13
+ request: (hostId: string, method: string, input: unknown) => Promise<unknown>;
14
+ });
15
+ request<M extends AgentHostMethod>(method: M, input: AgentHostInput<M>): Promise<AgentHostOutput<M>>;
16
+ subscribe(listener: AgentHostEventListener): AgentHostUnsubscribe;
17
+ /** An event the PC sent. */
18
+ deliver(event: AgentHostEvent): void;
19
+ }
20
+ //# sourceMappingURL=transport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/remote/transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,sCAAsC,CAAA;AAE7C,qBAAa,uBAAwB,YAAW,kBAAkB;IAGpD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;gBAEjC,OAAO,EAAE;QACpC,MAAM,EAAE,MAAM,CAAA;QACd,2HAA2H;QAC3H,QAAQ,EAAE,uBAAuB,CAAA;QACjC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAC9E;IAEK,OAAO,CAAC,CAAC,SAAS,eAAe,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAK1G,SAAS,CAAC,QAAQ,EAAE,sBAAsB,GAAG,oBAAoB;IAKjE,4BAA4B;IAC5B,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;CAGrC"}
@@ -0,0 +1,21 @@
1
+ export class RelayAgentHostTransport {
2
+ options;
3
+ listeners = new Set();
4
+ constructor(options) {
5
+ this.options = options;
6
+ }
7
+ async request(method, input) {
8
+ const result = await this.options.request(this.options.hostId, method, input);
9
+ return (method === 'host.handshake' ? { ...result, surface: this.options.identity } : result);
10
+ }
11
+ subscribe(listener) {
12
+ this.listeners.add(listener);
13
+ return () => { this.listeners.delete(listener); };
14
+ }
15
+ /** An event the PC sent. */
16
+ deliver(event) {
17
+ for (const listener of this.listeners)
18
+ listener(event);
19
+ }
20
+ }
21
+ //# sourceMappingURL=transport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/remote/transport.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,uBAAuB;IAGL;IAFZ,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAA;IAE9D,YAA6B,OAK5B;QAL4B,YAAO,GAAP,OAAO,CAKnC;IAAG,CAAC;IAEL,KAAK,CAAC,OAAO,CAA4B,MAAS,EAAE,KAAwB;QAC1E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QAC7E,OAAO,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAI,MAAiB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAuB,CAAA;IACjI,CAAC;IAED,SAAS,CAAC,QAAgC;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,4BAA4B;IAC5B,OAAO,CAAC,KAAqB;QAC3B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IACxD,CAAC;CACF"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xenosystem/agent-interface-core",
3
- "version": "0.1.181",
3
+ "version": "0.1.183",
4
4
  "license": "UNLICENSED",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -9,6 +9,10 @@
9
9
  ".": {
10
10
  "types": "./dist/index.d.ts",
11
11
  "import": "./dist/index.js"
12
+ },
13
+ "./remote": {
14
+ "types": "./dist/remote/index.d.ts",
15
+ "import": "./dist/remote/index.js"
12
16
  }
13
17
  },
14
18
  "files": [
@@ -23,7 +27,11 @@
23
27
  "directory": "packages/core"
24
28
  },
25
29
  "dependencies": {
26
- "@xenosystem/agent-interface-contract": "0.1.181"
30
+ "@noble/ciphers": "2.4.0",
31
+ "@noble/curves": "2.4.0",
32
+ "@noble/hashes": "2.4.0",
33
+ "@xenosystem/agent-interface-contract": "0.1.183"
27
34
  },
28
- "scripts": {}
35
+ "scripts": {},
36
+ "gitHead": "c22108a77eb90fa73727b36ed8163cf47cdec615"
29
37
  }