@airterm/protocol 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AirTerm contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @airterm/protocol
+
+Browser-safe AirTerm protocol primitives shared by the web client and CLI agent.
+The package implements capability URLs, HKDF key separation, Noise transport,
+binary framing, and terminal message codecs for protocol version 1.
+
+Its additive streaming-transfer extension uses feature negotiation, 64-bit
+offsets, bounded acknowledgement windows, and purpose-specific policies for
+encrypted terminal fonts and clipboard images. Receivers can stream directly
+to disk, allowing later file-transfer features to grow without replacing the
+wire format.
+
+```sh
+npm install @airterm/protocol
+```
+
+AirTerm uses `Noise_NNpsk0_25519_ChaChaPoly_BLAKE2b`. Applications should import
+the public APIs from the package root.
+
+```ts
+import { deriveCapabilityKeys, NoiseTransport } from '@airterm/protocol';
+```
+
+Requires Node.js 22.12 or newer for Node-based consumers. Browser consumers need
+Web Crypto and WebAssembly support.
+
+## Development and publishing
+
+Run `npm run check` and `npm run test:package` from the repository root. Packing
+this package builds fresh JavaScript and declarations and checks the browser
+bundle. The package test installs the protocol and CLI tarballs together outside
+the workspace so local workspace links cannot hide missing package files.
+
+Publish this package before the CLI that depends on its exact version. Verify
+that version is publicly available with `npm view @airterm/protocol@<version>`
+before publishing the CLI. Run the dependency audit and scan Git history for
+secrets before making a release public.

package/dist/capability.d.ts

@@ -0,0 +1,22 @@
+export declare const SESSION_ID_LENGTH = 22;
+export declare const ROOT_SECRET_LENGTH = 43;
+export interface CapabilityMaterial {
+    sessionId: string;
+    rootSecret: string;
+}
+export interface CapabilityKeys {
+    e2eePsk: Uint8Array;
+    gatewayAccessToken: Uint8Array;
+    gatewayAccessVerifier: Uint8Array;
+}
+export interface ParsedCapability extends CapabilityMaterial {
+    serverUrl: string;
+}
+export declare function generateCapabilityMaterial(): CapabilityMaterial;
+export declare function createCapabilityUrl(serverUrl: string, material: CapabilityMaterial): string;
+export declare function parseCapabilityUrl(capabilityUrl: string): ParsedCapability;
+export declare function deriveCapabilityKeys(material: CapabilityMaterial): Promise<CapabilityKeys>;
+export declare function normalizeServerUrl(serverUrl: string): string;
+export declare function encodeBase64Url(bytes: Uint8Array): string;
+export declare function decodeBase64Url(value: string): Uint8Array;
+//# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,MAAM,WAAW,kBAAkB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,UAAU,CAAC;IACpB,kBAAkB,EAAE,UAAU,CAAC;IAC/B,qBAAqB,EAAE,UAAU,CAAC;CACrC;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IACxD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,0BAA0B,IAAI,kBAAkB,CAK/D;AAED,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,kBAAkB,GAC7B,MAAM,CAOR;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,CAiB1E;AAED,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,kBAAkB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA6BzB;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAuB5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAsBzD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAgCzD"}

package/dist/capability.js

@@ -0,0 +1,137 @@
+const BASE64URL_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+const SESSION_ID_BYTES = 16;
+const ROOT_SECRET_BYTES = 32;
+export const SESSION_ID_LENGTH = 22;
+export const ROOT_SECRET_LENGTH = 43;
+export function generateCapabilityMaterial() {
+    return {
+        sessionId: encodeBase64Url(randomBytes(SESSION_ID_BYTES)),
+        rootSecret: encodeBase64Url(randomBytes(ROOT_SECRET_BYTES)),
+    };
+}
+export function createCapabilityUrl(serverUrl, material) {
+    assertSessionId(material.sessionId);
+    assertRootSecret(material.rootSecret);
+    const baseUrl = normalizeServerUrl(serverUrl);
+    return `${baseUrl}/t/${material.sessionId}#v1.${material.rootSecret}`;
+}
+export function parseCapabilityUrl(capabilityUrl) {
+    const url = new URL(capabilityUrl);
+    const pathMatch = url.pathname.match(/^\/t\/([A-Za-z0-9_-]{22})$/);
+    const fragmentMatch = url.hash.match(/^#v1\.([A-Za-z0-9_-]{43})$/);
+    if (pathMatch?.[1] === undefined || fragmentMatch?.[1] === undefined) {
+        throw new Error('Invalid AirTerm capability URL.');
+    }
+    assertSessionId(pathMatch[1]);
+    assertRootSecret(fragmentMatch[1]);
+    return {
+        serverUrl: normalizeServerUrl(url.origin),
+        sessionId: pathMatch[1],
+        rootSecret: fragmentMatch[1],
+    };
+}
+export async function deriveCapabilityKeys(material) {
+    assertSessionId(material.sessionId);
+    assertRootSecret(material.rootSecret);
+    const sessionId = decodeBase64Url(material.sessionId);
+    const rootSecret = decodeBase64Url(material.rootSecret);
+    const keyMaterial = await crypto.subtle.importKey('raw', toArrayBuffer(rootSecret), 'HKDF', false, ['deriveBits']);
+    const e2eePsk = await deriveHkdf(keyMaterial, sessionId, 'airterm/v1/e2ee');
+    const gatewayAccessToken = await deriveHkdf(keyMaterial, sessionId, 'airterm/v1/gateway-access');
+    const verifier = await crypto.subtle.digest('SHA-256', toArrayBuffer(gatewayAccessToken));
+    return {
+        e2eePsk,
+        gatewayAccessToken,
+        gatewayAccessVerifier: new Uint8Array(verifier),
+    };
+}
+export function normalizeServerUrl(serverUrl) {
+    const url = new URL(serverUrl);
+    const isLocalHttp = url.protocol === 'http:' &&
+        ['localhost', '127.0.0.1', '::1'].includes(url.hostname);
+    if (url.protocol !== 'https:' && !isLocalHttp) {
+        throw new Error('AirTerm servers must use HTTPS outside local development.');
+    }
+    if (url.username !== '' ||
+        url.password !== '' ||
+        url.search !== '' ||
+        url.hash !== '' ||
+        url.pathname !== '/') {
+        throw new Error('AirTerm server URL must be an origin without credentials, a path, a query, or a fragment.');
+    }
+    return url.origin;
+}
+export function encodeBase64Url(bytes) {
+    let output = '';
+    for (let index = 0; index < bytes.length; index += 3) {
+        const first = bytes[index] ?? 0;
+        const second = bytes[index + 1];
+        const third = bytes[index + 2];
+        const value = (first << 16) | ((second ?? 0) << 8) | (third ?? 0);
+        output += BASE64URL_ALPHABET[(value >> 18) & 63];
+        output += BASE64URL_ALPHABET[(value >> 12) & 63];
+        if (second !== undefined) {
+            output += BASE64URL_ALPHABET[(value >> 6) & 63];
+        }
+        if (third !== undefined) {
+            output += BASE64URL_ALPHABET[value & 63];
+        }
+    }
+    return output;
+}
+export function decodeBase64Url(value) {
+    if (!/^[A-Za-z0-9_-]+$/.test(value) || value.length % 4 === 1) {
+        throw new Error('Invalid Base64URL value.');
+    }
+    const output = new Uint8Array(Math.floor((value.length * 6) / 8));
+    let accumulator = 0;
+    let bits = 0;
+    let offset = 0;
+    for (const character of value) {
+        const decoded = BASE64URL_ALPHABET.indexOf(character);
+        if (decoded < 0) {
+            throw new Error('Invalid Base64URL value.');
+        }
+        accumulator = (accumulator << 6) | decoded;
+        bits += 6;
+        if (bits >= 8) {
+            bits -= 8;
+            output[offset] = (accumulator >> bits) & 0xff;
+            offset += 1;
+        }
+    }
+    if (bits > 0 && (accumulator & ((1 << bits) - 1)) !== 0) {
+        throw new Error('Non-canonical Base64URL value.');
+    }
+    return output;
+}
+function randomBytes(length) {
+    return crypto.getRandomValues(new Uint8Array(length));
+}
+async function deriveHkdf(keyMaterial, salt, info) {
+    const bits = await crypto.subtle.deriveBits({
+        name: 'HKDF',
+        hash: 'SHA-256',
+        salt: toArrayBuffer(salt),
+        info: new TextEncoder().encode(info),
+    }, keyMaterial, 256);
+    return new Uint8Array(bits);
+}
+function assertSessionId(sessionId) {
+    const decoded = decodeBase64Url(sessionId);
+    if (sessionId.length !== SESSION_ID_LENGTH || decoded.length !== SESSION_ID_BYTES) {
+        throw new Error('Invalid AirTerm session ID.');
+    }
+}
+function assertRootSecret(rootSecret) {
+    const decoded = decodeBase64Url(rootSecret);
+    if (rootSecret.length !== ROOT_SECRET_LENGTH || decoded.length !== ROOT_SECRET_BYTES) {
+        throw new Error('Invalid AirTerm root secret.');
+    }
+}
+function toArrayBuffer(bytes) {
+    const copy = new Uint8Array(bytes.byteLength);
+    copy.set(bytes);
+    return copy.buffer;
+}
+//# sourceMappingURL=capability.js.map

package/dist/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"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"}

package/dist/framing.d.ts

@@ -0,0 +1,45 @@
+export declare const MAX_CIPHERTEXT_BYTES = 65535;
+export declare const INNER_HEADER_BYTES = 13;
+export declare enum OuterFrameKind {
+    NoiseHandshake = 1,
+    EncryptedTransport = 2
+}
+export declare enum InnerFrameType {
+    SessionDescription = 1,
+    SessionClose = 2,
+    PtyCreate = 3,
+    PtyCreated = 4,
+    PtyInput = 5,
+    PtyOutput = 6,
+    PtyResize = 7,
+    PtyClose = 8,
+    PtyExit = 9,
+    ReplayRequest = 10,
+    ReplayStart = 11,
+    ProtocolError = 12,
+    TransferRequest = 13,
+    TransferOffer = 14,
+    TransferAccept = 15,
+    TransferChunk = 16,
+    TransferAck = 17,
+    TransferComplete = 18,
+    TransferResult = 19,
+    TransferCancel = 20
+}
+export interface OuterFrame {
+    version: number;
+    kind: OuterFrameKind;
+    payload: Uint8Array;
+}
+export interface InnerFrame {
+    type: InnerFrameType;
+    ptyId: number;
+    sequence: bigint;
+    payload: Uint8Array;
+}
+export declare function outerAssociatedData(kind: OuterFrameKind, version?: number): Uint8Array;
+export declare function encodeOuterFrame(kind: OuterFrameKind, payload: Uint8Array, version?: number): Uint8Array;
+export declare function decodeOuterFrame(frame: Uint8Array): OuterFrame;
+export declare function encodeInnerFrame(frame: InnerFrame): Uint8Array;
+export declare function decodeInnerFrame(frame: Uint8Array): InnerFrame;
+//# sourceMappingURL=framing.d.ts.map

package/dist/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../src/framing.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,oBAAY,cAAc;IACtB,cAAc,IAAI;IAClB,kBAAkB,IAAI;CACzB;AAED,oBAAY,cAAc;IACtB,kBAAkB,IAAI;IACtB,YAAY,IAAI;IAChB,SAAS,IAAI;IACb,UAAU,IAAI;IACd,QAAQ,IAAI;IACZ,SAAS,IAAI;IACb,SAAS,IAAI;IACb,QAAQ,IAAI;IACZ,OAAO,IAAI;IACX,aAAa,KAAK;IAClB,WAAW,KAAK;IAChB,aAAa,KAAK;IAClB,eAAe,KAAK;IACpB,aAAa,KAAK;IAClB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,WAAW,KAAK;IAChB,gBAAgB,KAAK;IACrB,cAAc,KAAK;IACnB,cAAc,KAAK;CACtB;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,MAAyB,GACnC,UAAU,CAKZ;AAED,wBAAgB,gBAAgB,CAC5B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,MAAyB,GACnC,UAAU,CAUZ;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAqB9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAgB9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAgB9D"}

package/dist/framing.js

@@ -0,0 +1,110 @@
+import { PROTOCOL_VERSION } from './index.js';
+export const MAX_CIPHERTEXT_BYTES = 65_535;
+export const INNER_HEADER_BYTES = 13;
+export var OuterFrameKind;
+(function (OuterFrameKind) {
+    OuterFrameKind[OuterFrameKind["NoiseHandshake"] = 1] = "NoiseHandshake";
+    OuterFrameKind[OuterFrameKind["EncryptedTransport"] = 2] = "EncryptedTransport";
+})(OuterFrameKind || (OuterFrameKind = {}));
+export var InnerFrameType;
+(function (InnerFrameType) {
+    InnerFrameType[InnerFrameType["SessionDescription"] = 1] = "SessionDescription";
+    InnerFrameType[InnerFrameType["SessionClose"] = 2] = "SessionClose";
+    InnerFrameType[InnerFrameType["PtyCreate"] = 3] = "PtyCreate";
+    InnerFrameType[InnerFrameType["PtyCreated"] = 4] = "PtyCreated";
+    InnerFrameType[InnerFrameType["PtyInput"] = 5] = "PtyInput";
+    InnerFrameType[InnerFrameType["PtyOutput"] = 6] = "PtyOutput";
+    InnerFrameType[InnerFrameType["PtyResize"] = 7] = "PtyResize";
+    InnerFrameType[InnerFrameType["PtyClose"] = 8] = "PtyClose";
+    InnerFrameType[InnerFrameType["PtyExit"] = 9] = "PtyExit";
+    InnerFrameType[InnerFrameType["ReplayRequest"] = 10] = "ReplayRequest";
+    InnerFrameType[InnerFrameType["ReplayStart"] = 11] = "ReplayStart";
+    InnerFrameType[InnerFrameType["ProtocolError"] = 12] = "ProtocolError";
+    InnerFrameType[InnerFrameType["TransferRequest"] = 13] = "TransferRequest";
+    InnerFrameType[InnerFrameType["TransferOffer"] = 14] = "TransferOffer";
+    InnerFrameType[InnerFrameType["TransferAccept"] = 15] = "TransferAccept";
+    InnerFrameType[InnerFrameType["TransferChunk"] = 16] = "TransferChunk";
+    InnerFrameType[InnerFrameType["TransferAck"] = 17] = "TransferAck";
+    InnerFrameType[InnerFrameType["TransferComplete"] = 18] = "TransferComplete";
+    InnerFrameType[InnerFrameType["TransferResult"] = 19] = "TransferResult";
+    InnerFrameType[InnerFrameType["TransferCancel"] = 20] = "TransferCancel";
+})(InnerFrameType || (InnerFrameType = {}));
+export function outerAssociatedData(kind, version = PROTOCOL_VERSION) {
+    assertUint8(version, 'Protocol version');
+    assertOuterKind(kind);
+    return Uint8Array.of(version, kind);
+}
+export function encodeOuterFrame(kind, payload, version = PROTOCOL_VERSION) {
+    if (payload.byteLength > MAX_CIPHERTEXT_BYTES) {
+        throw new RangeError(`Outer payload exceeds ${MAX_CIPHERTEXT_BYTES} bytes.`);
+    }
+    const frame = new Uint8Array(2 + payload.byteLength);
+    frame.set(outerAssociatedData(kind, version));
+    frame.set(payload, 2);
+    return frame;
+}
+export function decodeOuterFrame(frame) {
+    if (frame.byteLength < 2) {
+        throw new Error('Outer frame is missing its header.');
+    }
+    const version = frame[0];
+    const kind = frame[1];
+    if (version !== PROTOCOL_VERSION) {
+        throw new Error(`Unsupported AirTerm protocol version: ${version}.`);
+    }
+    assertOuterKind(kind);
+    const payload = frame.subarray(2);
+    if (payload.byteLength > MAX_CIPHERTEXT_BYTES) {
+        throw new RangeError(`Outer payload exceeds ${MAX_CIPHERTEXT_BYTES} bytes.`);
+    }
+    return { version, kind, payload };
+}
+export function encodeInnerFrame(frame) {
+    assertInnerType(frame.type);
+    assertUint32(frame.ptyId, 'PTY ID');
+    if (frame.sequence < 0n || frame.sequence > 0xffffffffffffffffn) {
+        throw new RangeError('Sequence must fit in an unsigned 64-bit integer.');
+    }
+    const encoded = new Uint8Array(INNER_HEADER_BYTES + frame.payload.byteLength);
+    const view = new DataView(encoded.buffer);
+    encoded[0] = frame.type;
+    view.setUint32(1, frame.ptyId, false);
+    view.setBigUint64(5, frame.sequence, false);
+    encoded.set(frame.payload, INNER_HEADER_BYTES);
+    return encoded;
+}
+export function decodeInnerFrame(frame) {
+    if (frame.byteLength < INNER_HEADER_BYTES) {
+        throw new Error('Inner frame is missing its header.');
+    }
+    const type = frame[0];
+    assertInnerType(type);
+    const view = new DataView(frame.buffer, frame.byteOffset, frame.byteLength);
+    return {
+        type,
+        ptyId: view.getUint32(1, false),
+        sequence: view.getBigUint64(5, false),
+        payload: frame.subarray(INNER_HEADER_BYTES),
+    };
+}
+function assertOuterKind(kind) {
+    if (!Object.values(OuterFrameKind).includes(kind)) {
+        throw new Error(`Unknown outer frame kind: ${kind}.`);
+    }
+}
+function assertInnerType(type) {
+    if (!Object.values(InnerFrameType).includes(type)) {
+        throw new Error(`Unknown inner frame type: ${type}.`);
+    }
+}
+function assertUint8(value, label) {
+    if (!Number.isInteger(value) || value < 0 || value > 0xff) {
+        throw new RangeError(`${label} must fit in an unsigned byte.`);
+    }
+}
+function assertUint32(value, label) {
+    if (!Number.isInteger(value) || value < 0 || value > 0xffff_ffff) {
+        throw new RangeError(`${label} must fit in an unsigned 32-bit integer.`);
+    }
+}
+//# sourceMappingURL=framing.js.map

package/dist/framing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.js","sourceRoot":"","sources":["../src/framing.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export declare const PROTOCOL_VERSION: 1;
+export { decodeInnerFrame, decodeOuterFrame, encodeInnerFrame, encodeOuterFrame, INNER_HEADER_BYTES, InnerFrameType, MAX_CIPHERTEXT_BYTES, OuterFrameKind, outerAssociatedData, } from './framing.js';
+export type { InnerFrame, OuterFrame } from './framing.js';
+export { createNoisePrologue, MAX_TRANSPORT_FRAMES, NOISE_PROTOCOL_NAME, NoiseTransport, } from './noise.js';
+export type { NoiseTransportOptions } from './noise.js';
+export { decodeProtocolError, decodePtyExit, decodePtyResize, decodeReplayStart, decodeSessionDescription, encodeProtocolError, encodePtyExit, encodePtyResize, encodeReplayStart, encodeSessionDescription, } from './messages.js';
+export type { ProtocolErrorMessage, PtyExitMessage, ReplayStartMessage, SessionDescription, SessionMode, TerminalDescription, TerminalFontDescription, TerminalFontFormat, SessionFeature, } from './messages.js';
+export { decodeTransferCancel, decodeTransferChunk, decodeTransferControl, decodeTransferOffer, decodeTransferRequest, decodeTransferResult, encodeTransferCancel, encodeTransferChunk, encodeTransferControl, encodeTransferOffer, encodeTransferRequest, encodeTransferResult, generateTransferId, hasTransferTimedOut, TRANSFER_CHUNK_BYTES, TRANSFER_IDLE_TIMEOUT_MS, TRANSFER_ID_BYTES, TRANSFER_WINDOW_BYTES, TransferReceiverState, TransferSenderState, } from './transfers.js';
+export type { TransferCancelMessage, TransferChunkPayload, TransferControlMessage, TransferDirection, TransferOfferMessage, TransferPurpose, TransferRequestMessage, TransferResultMessage, } from './transfers.js';
+export { createCapabilityUrl, decodeBase64Url, deriveCapabilityKeys, encodeBase64Url, generateCapabilityMaterial, normalizeServerUrl, parseCapabilityUrl, ROOT_SECRET_LENGTH, SESSION_ID_LENGTH, } from './capability.js';
+export type { CapabilityKeys, CapabilityMaterial, ParsedCapability, } from './capability.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAC3C,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,mBAAmB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACH,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EACH,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,wBAAwB,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EACR,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACR,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACR,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export const PROTOCOL_VERSION = 1;
+export { decodeInnerFrame, decodeOuterFrame, encodeInnerFrame, encodeOuterFrame, INNER_HEADER_BYTES, InnerFrameType, MAX_CIPHERTEXT_BYTES, OuterFrameKind, outerAssociatedData, } from './framing.js';
+export { createNoisePrologue, MAX_TRANSPORT_FRAMES, NOISE_PROTOCOL_NAME, NoiseTransport, } from './noise.js';
+export { decodeProtocolError, decodePtyExit, decodePtyResize, decodeReplayStart, decodeSessionDescription, encodeProtocolError, encodePtyExit, encodePtyResize, encodeReplayStart, encodeSessionDescription, } from './messages.js';
+export { decodeTransferCancel, decodeTransferChunk, decodeTransferControl, decodeTransferOffer, decodeTransferRequest, decodeTransferResult, encodeTransferCancel, encodeTransferChunk, encodeTransferControl, encodeTransferOffer, encodeTransferRequest, encodeTransferResult, generateTransferId, hasTransferTimedOut, TRANSFER_CHUNK_BYTES, TRANSFER_IDLE_TIMEOUT_MS, TRANSFER_ID_BYTES, TRANSFER_WINDOW_BYTES, TransferReceiverState, TransferSenderState, } from './transfers.js';
+export { createCapabilityUrl, decodeBase64Url, deriveCapabilityKeys, encodeBase64Url, generateCapabilityMaterial, normalizeServerUrl, parseCapabilityUrl, ROOT_SECRET_LENGTH, SESSION_ID_LENGTH, } from './capability.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAC3C,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,mBAAmB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,wBAAwB,GAC3B,MAAM,eAAe,CAAC;AAYvB,OAAO,EACH,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EACH,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,50 @@
+export type SessionMode = 'shell' | 'command';
+export type SessionFeature = 'stream-transfer-v1' | 'terminal-font-v1' | 'image-paste-v1';
+export type TerminalFontFormat = 'ttf' | 'otf' | 'woff' | 'woff2';
+export interface TerminalFontDescription {
+    assetId: string;
+    format: TerminalFontFormat;
+    byteLength: string;
+    sha256: string;
+}
+export interface TerminalDescription {
+    ptyId: number;
+    title: string;
+    running: boolean;
+    baseOffset: bigint;
+    nextOffset: bigint;
+}
+export interface SessionDescription {
+    mode: SessionMode;
+    maxTabs: number;
+    terminals: TerminalDescription[];
+    features?: SessionFeature[];
+    font?: TerminalFontDescription;
+}
+export interface PtyExitMessage {
+    exitCode: number;
+    signal?: number;
+}
+export interface ReplayStartMessage {
+    baseOffset: bigint;
+    nextOffset: bigint;
+    truncated: boolean;
+}
+export interface ProtocolErrorMessage {
+    code: string;
+    message: string;
+}
+export declare function encodeSessionDescription(description: SessionDescription): Uint8Array;
+export declare function decodeSessionDescription(payload: Uint8Array): SessionDescription;
+export declare function encodePtyResize(columns: number, rows: number): Uint8Array;
+export declare function decodePtyResize(payload: Uint8Array): {
+    columns: number;
+    rows: number;
+};
+export declare function encodePtyExit(message: PtyExitMessage): Uint8Array;
+export declare function decodePtyExit(payload: Uint8Array): PtyExitMessage;
+export declare function encodeReplayStart(message: ReplayStartMessage): Uint8Array;
+export declare function decodeReplayStart(payload: Uint8Array): ReplayStartMessage;
+export declare function encodeProtocolError(error: ProtocolErrorMessage): Uint8Array;
+export declare function decodeProtocolError(payload: Uint8Array): ProtocolErrorMessage;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAC9C,MAAM,MAAM,cAAc,GACpB,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,CAAC;AAEvB,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,uBAAuB,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,kBAAkB,GAAG,UAAU,CAuBpF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,kBAAkB,CAuBhF;AAkDD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAWzE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CActF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAKjE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAejE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU,CAMzE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,kBAAkB,CAgBzE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU,CAE3E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,oBAAoB,CAQ7E"}