ai-remote 0.4.2 → 0.4.4

package/dist/protocols/ssh/wire.js

@@ -1,188 +0,0 @@
-const textEncoder = new TextEncoder();
-const textDecoder = new TextDecoder();
-function encodeUtf8(text) {
-  return textEncoder.encode(text);
-}
-function decodeUtf8(bytes) {
-  return textDecoder.decode(bytes);
-}
-function concatBytes(...parts) {
-  const total = parts.reduce((sum, part) => sum + part.length, 0);
-  const out = new Uint8Array(total);
-  let offset = 0;
-  for (const part of parts) {
-    out.set(part, offset);
-    offset += part.length;
-  }
-  return out;
-}
-function bytesEqual(a, b) {
-  if (a.length !== b.length) return false;
-  let difference = 0;
-  for (let index = 0; index < a.length; index++) difference |= (a[index] ?? 0) ^ (b[index] ?? 0);
-  return difference === 0;
-}
-function toBase64(bytes) {
-  let binary = "";
-  for (const byte of bytes) binary += String.fromCharCode(byte);
-  return btoa(binary);
-}
-function fromBase64(text) {
-  const binary = atob(text);
-  const bytes = new Uint8Array(binary.length);
-  for (let index = 0; index < binary.length; index++) bytes[index] = binary.charCodeAt(index);
-  return bytes;
-}
-function toBase64Url(bytes) {
-  return toBase64(bytes).replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
-}
-class SshWriter {
-  bytes;
-  view;
-  offset = 0;
-  constructor(capacity = 256) {
-    this.bytes = new Uint8Array(new ArrayBuffer(capacity));
-    this.view = new DataView(this.bytes.buffer);
-  }
-  #ensure(extra) {
-    if (this.offset + extra <= this.bytes.length) return;
-    let capacity = Math.max(this.bytes.length * 2, 64);
-    while (capacity < this.offset + extra) capacity *= 2;
-    const grown = new Uint8Array(new ArrayBuffer(capacity));
-    grown.set(this.bytes.subarray(0, this.offset));
-    this.bytes = grown;
-    this.view = new DataView(grown.buffer);
-  }
-  u8(value) {
-    this.#ensure(1);
-    this.view.setUint8(this.offset, value);
-    this.offset += 1;
-    return this;
-  }
-  boolean(value) {
-    return this.u8(value ? 1 : 0);
-  }
-  u32(value) {
-    this.#ensure(4);
-    this.view.setUint32(this.offset, value >>> 0, false);
-    this.offset += 4;
-    return this;
-  }
-  raw(bytes) {
-    this.#ensure(bytes.length);
-    this.bytes.set(bytes, this.offset);
-    this.offset += bytes.length;
-    return this;
-  }
-  /** A length-prefixed string. Text is encoded as UTF-8. */
-  string(value) {
-    const bytes = typeof value === "string" ? encodeUtf8(value) : value;
-    return this.u32(bytes.length).raw(bytes);
-  }
-  nameList(names) {
-    return this.string(names.join(","));
-  }
-  /**
-   * An mpint: two's complement, big endian, with no leading zero bytes except
-   * the one that keeps a positive number from looking negative.
-   */
-  mpint(bytes) {
-    let start = 0;
-    while (start < bytes.length && bytes[start] === 0) start++;
-    const magnitude = bytes.subarray(start);
-    if (magnitude.length === 0) return this.u32(0);
-    if ((magnitude[0] ?? 0) & 128) {
-      this.u32(magnitude.length + 1).u8(0);
-      return this.raw(magnitude);
-    }
-    return this.u32(magnitude.length).raw(magnitude);
-  }
-  get length() {
-    return this.offset;
-  }
-  take() {
-    return this.bytes.slice(0, this.offset);
-  }
-}
-class SshReader {
-  bytes;
-  view;
-  offset;
-  constructor(bytes, offset = 0) {
-    this.bytes = bytes;
-    this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-    this.offset = offset;
-  }
-  get remaining() {
-    return this.bytes.length - this.offset;
-  }
-  #need(count) {
-    if (count < 0 || this.remaining < count) {
-      throw new Error(`SSH: truncated packet (needed ${count} bytes, ${this.remaining} left)`);
-    }
-  }
-  u8() {
-    this.#need(1);
-    return this.view.getUint8(this.offset++);
-  }
-  boolean() {
-    return this.u8() !== 0;
-  }
-  u32() {
-    this.#need(4);
-    const value = this.view.getUint32(this.offset, false);
-    this.offset += 4;
-    return value;
-  }
-  raw(count) {
-    this.#need(count);
-    const slice = this.bytes.subarray(this.offset, this.offset + count);
-    this.offset += count;
-    return slice;
-  }
-  /** The bytes of a length-prefixed string. */
-  stringBytes() {
-    return this.raw(this.u32());
-  }
-  string() {
-    return decodeUtf8(this.stringBytes());
-  }
-  nameList() {
-    const value = this.string();
-    return value ? value.split(",") : [];
-  }
-  /** An mpint's magnitude, with the sign byte removed. */
-  mpint() {
-    const bytes = this.stringBytes();
-    let start = 0;
-    while (start < bytes.length && bytes[start] === 0) start++;
-    return bytes.subarray(start);
-  }
-  skip(count) {
-    this.#need(count);
-    this.offset += count;
-    return this;
-  }
-  rest() {
-    return this.bytes.subarray(this.offset);
-  }
-}
-function padStart(bytes, width) {
-  if (bytes.length === width) return bytes;
-  if (bytes.length > width) return bytes.subarray(bytes.length - width);
-  const out = new Uint8Array(width);
-  out.set(bytes, width - bytes.length);
-  return out;
-}
-export {
-  SshReader,
-  SshWriter,
-  bytesEqual,
-  concatBytes,
-  decodeUtf8,
-  encodeUtf8,
-  fromBase64,
-  padStart,
-  toBase64,
-  toBase64Url
-};

package/dist/protocols/types.d.ts

@@ -1,127 +0,0 @@
-/**
- * The interface every remote-desktop protocol presents to the UI.
- *
- * The workspace -- toolbar, stats rail, on-screen keyboard, reconnects -- does
- * not care whether a session is VNC or RDP. Everything that does differ is
- * reached through this interface instead of branching at each call site.
- */
-import type { ConnectionSettings, RemoteAppLaunch } from '../shared/connection';
-import type { RdpSecurity, RemoteProtocol } from '../shared/protocol';
-/** Where the pointer may go, in framebuffer pixels. */
-export interface ScreenGeometry {
-    width: number;
-    height: number;
-    viewport: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-}
-/** Mouse buttons, as the UI names them. */
-export type PointerButton = 0 | 1 | 2;
-/** Wheel movement in discrete remote-protocol notches. Positive is right/down. */
-export interface ScrollDelta {
-    x: number;
-    y: number;
-}
-/**
- * A live session. Both drivers expose this, so the AI pane's screen tool and
- * the toolbar never have to ask which protocol they are driving.
- */
-export interface RemoteSession extends EventTarget {
-    readonly protocol: RemoteProtocol;
-    disconnect(): void;
-    /** True once the desktop has been reached. */
-    readonly connected: boolean;
-    /** Fit the remote desktop to the pane rather than scrolling it. */
-    scaleViewport: boolean;
-    /** Watch without sending keyboard or pointer input. */
-    viewOnly: boolean;
-    /** RFB quality level. RDP ignores it. */
-    qualityLevel?: number;
-    /** RFB compression level. RDP ignores it. */
-    compressionLevel?: number;
-    /** The transport the metrics rail instruments. Can appear a tick after construction. */
-    readonly socket?: WebSocket | null;
-    readonly screenGeometry: ScreenGeometry;
-    movePointer(x: number, y: number): boolean;
-    clickPointer(x: number, y: number, button?: PointerButton): boolean;
-    pointerButton(x: number, y: number, button?: PointerButton, pressed?: boolean): boolean;
-    scrollPointer(x: number, y: number, delta: ScrollDelta): boolean;
-    typeText(text: string): boolean;
-    /** Prefer the protocol clipboard for longer text when it can paste reliably. */
-    pasteText?(text: string): boolean | Promise<boolean>;
-    /** Press or release one key by keysym. */
-    sendKey(keysym: number, code: string | null, down?: boolean): void;
-    /** Send text to the host's clipboard, when the protocol carries one. */
-    sendClipboard?(text: string): void;
-    /**
-     * Stop taking keystrokes: the workspace has given the keyboard to something
-     * local, such as the terminal or the assistant's message box.
-     *
-     * Both protocols listen on the element they paint into, so a key only leaves
-     * for the host while that element holds focus. Handing focus back is the
-     * whole mechanism -- plus, for RDP, letting go of anything still held down,
-     * which would otherwise stay down on the far side.
-     */
-    releaseKeyboard?(): void;
-    /** Ask the host for a different desktop size, when the protocol allows it. */
-    requestDesktopSize?(width: number, height: number): void;
-    /** The canvas the session paints into, for screenshots and thumbnails. */
-    readonly canvas?: HTMLCanvasElement | null;
-}
-/** What the workspace hands a driver to open a session. */
-export interface SessionOptions {
-    credentials: {
-        username: string;
-        password: string;
-    };
-    domain: string;
-    security: RdpSecurity;
-    remoteApp: RemoteAppLaunch | null;
-    /** Desktop size to ask the host for. */
-    width: number;
-    height: number;
-    /** False on a phone, where resizing the host would make a portrait strip of it. */
-    allowRemoteResize: boolean;
-    scaleViewport: boolean;
-    viewOnly: boolean;
-    quality: number;
-    compression: number;
-    /** Shown in this driver's own log lines. */
-    hostLabel: string;
-}
-/** Wording for the one connect dialog, which is shared markup across protocols. */
-export interface DialogCopy {
-    usernameLabel: string;
-    usernamePlaceholder: string;
-    usernameHelp: string;
-    passwordLabel: string;
-    passwordPlaceholder: string;
-    passwordHelp: string;
-    /** A VNC session needs some secret; RDP can sign in on the host's own screen. */
-    requiresPassword: boolean;
-}
-/** Everything the UI knows about a close, before anyone tries to explain it. */
-export interface DisconnectContext {
-    code?: number;
-    reason: string;
-    /** Pre-rendered ` (WebSocket 1006: ...)` tail, so wording stays consistent. */
-    suffix: string;
-}
-/** One protocol implementation. */
-export interface ProtocolDriver {
-    readonly protocol: RemoteProtocol;
-    /** Used as the prefix of this driver's console lines. */
-    readonly label: string;
-    readonly defaultPort: number;
-    readonly dialog: DialogCopy;
-    /** The gateway endpoint for this connection, including any query it needs. */
-    buildUrl(origin: string, settings: ConnectionSettings): string;
-    createSession(container: HTMLElement, url: string, options: SessionOptions): RemoteSession;
-    /** Extra detail worth logging once the first server frame has been parsed. */
-    describeState(session: RemoteSession): Record<string, unknown>;
-    /** Protocol-specific wording for a close, or null to fall back to the shared text. */
-    describeDisconnect(context: DisconnectContext): string | null;
-}

package/dist/protocols/vnc/input.d.ts

@@ -1,5 +0,0 @@
-/** RFB wheel buttons for a bounded two-axis scroll, in wire order. */
-export declare function vncWheelMasks(delta: {
-    x: number;
-    y: number;
-}): number[];

package/dist/protocols/vnc/input.js

@@ -1,15 +0,0 @@
-function vncWheelMasks(delta) {
-  const masks = [];
-  const wheels = [
-    { amount: delta.y, negativeMask: 1 << 3, positiveMask: 1 << 4 },
-    { amount: delta.x, negativeMask: 1 << 5, positiveMask: 1 << 6 }
-  ];
-  for (const { amount, negativeMask, positiveMask } of wheels) {
-    const mask = amount < 0 ? negativeMask : positiveMask;
-    for (let step = 0; step < Math.min(20, Math.abs(amount)); step++) masks.push(mask);
-  }
-  return masks;
-}
-export {
-  vncWheelMasks
-};

package/dist/protocols/vnc/session.d.ts

@@ -1,12 +0,0 @@
-/**
- * Everything VNC-specific, behind the driver interface the RDP side also
- * implements. noVNC's RFB object does the protocol work; this module decides
- * how it is addressed, constructed, controlled and explained.
- *
- * VNC splits the handshake differently from RDP: noVNC hands authentication to
- * the Worker, because macOS Screen Sharing needs the Apple Diffie-Hellman
- * (type 30) exchange that noVNC does not implement. That is why credentials
- * travel in the URL here and never do for RDP.
- */
-import type { ProtocolDriver } from '../types';
-export declare const vncDriver: ProtocolDriver;

package/dist/protocols/vnc/session.js

@@ -1,258 +0,0 @@
-import RFB from "@novnc/novnc";
-import { DEFAULT_PORTS } from "../../shared/protocol.js";
-import {
-  GATEWAY_KEEPALIVE_SIGNAL,
-  GATEWAY_READY_SIGNAL,
-  KEEPALIVE_INTERVAL_MS
-} from "../../shared/signals.js";
-import { vncWheelMasks } from "./input.js";
-const DIALOG = {
-  usernameLabel: "Username",
-  usernamePlaceholder: "macOS username (optional)",
-  usernameHelp: "Use your macOS account name. Leave it empty when the VNC server only asks for a password.",
-  passwordLabel: "Password",
-  passwordPlaceholder: "Screen sharing password",
-  passwordHelp: "Use the macOS account password, or the password configured for VNC screen sharing.",
-  // A VNC session needs some secret; RDP can sign in on the host's own screen.
-  requiresPassword: true
-};
-function buildUrl(origin, settings) {
-  const query = new URLSearchParams({ host: settings.host, port: String(settings.port) });
-  if (settings.username) query.set("vnc_user", settings.username);
-  if (settings.password) query.set("vnc_pass", settings.password);
-  return `${origin}/ws?${query}`;
-}
-const BUTTON_MASK = { 0: 1, 1: 2, 2: 4 };
-function eventDetail(event) {
-  if (!("detail" in event)) return {};
-  const detail = event.detail;
-  if (!detail || typeof detail !== "object") return {};
-  const copy = {};
-  for (const [key, value] of Object.entries(detail)) copy[key] = value;
-  return copy;
-}
-class VncSession extends EventTarget {
-  protocol = "vnc";
-  #rfb;
-  #credentials;
-  #transport = null;
-  #keepalive = null;
-  #readySent = false;
-  #close = null;
-  constructor(container, url, options) {
-    super();
-    this.#credentials = options.credentials;
-    this.#rfb = new RFB(container, url, {
-      credentials: {
-        username: options.credentials.username,
-        password: options.credentials.password
-      },
-      shared: true,
-      wsProtocols: ["binary"]
-    });
-    this.#rfb._cursor?._canvas?.classList.add("remote-cursor-overlay");
-    this.#rfb.showDotCursor = true;
-    this.#rfb.resizeSession = options.allowRemoteResize;
-    this.#rfb.clipViewport = true;
-    this.#rfb.scaleViewport = options.scaleViewport;
-    this.#rfb.viewOnly = options.viewOnly;
-    this.#rfb.qualityLevel = options.quality;
-    this.#rfb.compressionLevel = options.compression;
-    this.#bindTransport();
-    for (const name of ["connect", "disconnect", "credentialsrequired", "desktopname", "clipboard", "bell"]) {
-      this.#rfb.addEventListener(name, (event) => {
-        if (name === "credentialsrequired") {
-          this.#rfb.sendCredentials({
-            username: this.#credentials.username,
-            password: this.#credentials.password
-          });
-        }
-        const detail = eventDetail(event);
-        if (name === "disconnect" && this.#close) {
-          detail.code = this.#close.code;
-          detail.reason = this.#close.reason;
-        }
-        this.dispatchEvent(new CustomEvent(name, { detail }));
-      });
-    }
-  }
-  /**
-   * Attach to noVNC's WebSocket once it exists. Construction usually has it
-   * already; a retry covers the tick where `_sock._websocket` is still null.
-   */
-  #bindTransport() {
-    const attach = () => {
-      const ws = this.#rfb._sock?._websocket ?? null;
-      if (!ws || this.#transport === ws) return Boolean(ws);
-      this.#transport = ws;
-      const signalReady = () => {
-        if (this.#readySent || ws.readyState !== WebSocket.OPEN) return;
-        this.#readySent = true;
-        ws.send(GATEWAY_READY_SIGNAL);
-      };
-      ws.addEventListener("open", signalReady);
-      ws.addEventListener("close", (event) => {
-        this.#close = { code: event.code, reason: event.reason ?? "" };
-        this.#stopKeepalive();
-      }, true);
-      this.#keepalive = setInterval(() => {
-        if (ws.readyState !== WebSocket.OPEN) return;
-        try {
-          ws.send(GATEWAY_KEEPALIVE_SIGNAL);
-          const sock = this.#rfb._sock;
-          if (sock && this.#rfb._rfbConnectionState === "connected") {
-            RFB.messages.fbUpdateRequest(sock, true, 0, 0, 1, 1);
-          }
-        } catch {
-        }
-      }, KEEPALIVE_INTERVAL_MS);
-      signalReady();
-      return true;
-    };
-    if (attach()) return;
-    let tries = 0;
-    const timer = setInterval(() => {
-      if (attach() || ++tries > 20) clearInterval(timer);
-    }, 25);
-  }
-  #stopKeepalive() {
-    if (this.#keepalive) clearInterval(this.#keepalive);
-    this.#keepalive = null;
-  }
-  get connected() {
-    return this.#rfb._rfbConnectionState === "connected";
-  }
-  get socket() {
-    return this.#rfb._sock?._websocket ?? null;
-  }
-  get canvas() {
-    return this.#rfb._canvas;
-  }
-  get scaleViewport() {
-    return this.#rfb.scaleViewport;
-  }
-  set scaleViewport(enabled) {
-    this.#rfb.scaleViewport = enabled;
-  }
-  get viewOnly() {
-    return this.#rfb.viewOnly;
-  }
-  set viewOnly(enabled) {
-    this.#rfb.viewOnly = enabled;
-  }
-  get qualityLevel() {
-    return this.#rfb.qualityLevel;
-  }
-  set qualityLevel(level) {
-    this.#rfb.qualityLevel = level;
-  }
-  get compressionLevel() {
-    return this.#rfb.compressionLevel;
-  }
-  set compressionLevel(level) {
-    this.#rfb.compressionLevel = level;
-  }
-  get screenGeometry() {
-    const width = this.#rfb._fbWidth || 0;
-    const height = this.#rfb._fbHeight || 0;
-    return { width, height, viewport: { x: 0, y: 0, width, height } };
-  }
-  /** Internal state worth logging once the first server frame has been parsed. */
-  describeState() {
-    const socket = this.#rfb._sock;
-    return {
-      connectionState: this.#rfb._rfbConnectionState,
-      initializationState: this.#rfb._rfbInitState,
-      queuedReceiveBytes: Math.max(0, (socket?._rQlen ?? 0) - (socket?._rQi ?? 0))
-    };
-  }
-  disconnect() {
-    this.#stopKeepalive();
-    this.#rfb.disconnect();
-  }
-  sendKey(keysym, code, down) {
-    this.#rfb.sendKey(keysym, code, down);
-  }
-  sendClipboard(text) {
-    this.#rfb.clipboardPasteFrom(text);
-  }
-  releaseKeyboard() {
-    this.#rfb.blur();
-  }
-  /**
-   * noVNC keeps pointer input private -- its own handlers translate browser
-   * events into framebuffer coordinates first -- so this reaches for the same
-   * wire helper `_sendMouse` ends at, with coordinates already in pixels.
-   */
-  #pointer(x, y, mask) {
-    const socket = this.#rfb._sock;
-    if (!socket || this.#rfb._rfbConnectionState !== "connected" || this.#rfb.viewOnly) return false;
-    const width = this.#rfb._fbWidth || 1;
-    const height = this.#rfb._fbHeight || 1;
-    RFB.messages.pointerEvent(
-      socket,
-      Math.max(0, Math.min(width - 1, Math.round(x))),
-      Math.max(0, Math.min(height - 1, Math.round(y))),
-      mask
-    );
-    return true;
-  }
-  movePointer(x, y) {
-    return this.#pointer(x, y, 0);
-  }
-  clickPointer(x, y, button = 0) {
-    if (!this.#pointer(x, y, 0)) return false;
-    this.#pointer(x, y, BUTTON_MASK[button]);
-    this.#pointer(x, y, 0);
-    return true;
-  }
-  pointerButton(x, y, button = 0, pressed = true) {
-    return this.#pointer(x, y, pressed ? BUTTON_MASK[button] : 0);
-  }
-  scrollPointer(x, y, delta) {
-    for (const mask of vncWheelMasks(delta)) {
-      if (!this.#pointer(x, y, mask)) return false;
-      if (!this.#pointer(x, y, 0)) return false;
-    }
-    return true;
-  }
-  /**
-   * VNC has no Unicode input message, so text is typed as keysyms. For every
-   * character in the Basic Multilingual Plane the keysym is the code point.
-   */
-  typeText(text) {
-    if (this.#rfb._rfbConnectionState !== "connected" || this.#rfb.viewOnly || !text) return false;
-    for (const character of text) {
-      const point = character.codePointAt(0) ?? 0;
-      const keysym = character === "\n" ? 65293 : character === "	" ? 65289 : point;
-      this.#rfb.sendKey(keysym, null, true);
-      this.#rfb.sendKey(keysym, null, false);
-    }
-    return true;
-  }
-}
-function describeDisconnect({ code, reason, suffix }) {
-  if (code === 4001 || /auth|password|credential/i.test(reason)) {
-    return `VNC authentication failed${suffix}. Verify the macOS account username and its password.`;
-  }
-  if (code === 4002 || /apple dh/i.test(reason)) {
-    return `macOS VNC authentication handshake failed${suffix}.`;
-  }
-  if (code === 1011 || /cannot connect|unreachable|tcp error|tcp write/i.test(reason)) {
-    return `The Worker could not keep a TCP connection to the VNC host${suffix}. Check that Screen Sharing is running and listening on this address.`;
-  }
-  return null;
-}
-const vncDriver = {
-  protocol: "vnc",
-  label: "VNC Client",
-  defaultPort: DEFAULT_PORTS.vnc,
-  dialog: DIALOG,
-  buildUrl,
-  createSession: (container, url, options) => new VncSession(container, url, options),
-  describeState: (session) => session instanceof VncSession ? session.describeState() : {},
-  describeDisconnect
-};
-export {
-  vncDriver
-};

package/dist/shared/connection.d.ts

@@ -1,81 +0,0 @@
-/**
- * One connection, described once.
- *
- * Every way of starting a session -- a saved card on the welcome screen, an
- * address typed by hand, a RemoteApp launcher, a reconnect after a drop --
- * produces exactly this shape and hands it to exactly one dialog. That is the
- * whole point of the type: before it existed, a saved card could only ask for a
- * username and a password, so its port, security layer, domain and picture
- * quality were unreachable once the card had been made.
- */
-import { type RdpSecurity, type RemoteProtocol } from './protocol';
-/** A published Windows application launched instead of the full desktop. */
-export interface RemoteAppLaunch {
-    /** Alias (`||notepad`) or an executable path. */
-    program: string;
-    workingDir?: string;
-    arguments?: string;
-}
-/** The companion terminal offered beside a desktop. */
-export interface SshCompanion {
-    enabled: boolean;
-    port: number;
-    username: string;
-}
-/** Picture and input options. VNC negotiates them; RDP and SSH ignore what does not apply. */
-export interface DisplaySettings {
-    /** RFB quality level, 1 (smallest) to 9 (sharpest). */
-    quality: number;
-    /** RFB compression level, 0 (fastest) to 9 (smallest). */
-    compression: number;
-    /** Fit the remote desktop to the pane rather than scrolling it. */
-    scaling: boolean;
-    /** Watch without sending keyboard or pointer input. */
-    viewOnly: boolean;
-}
-/**
- * Everything a session needs. `password` is the only field never persisted
- * anywhere -- not in the device library on the gateway, not in localStorage.
- */
-export interface ConnectionSettings {
-    /** Stable identity: protocol, address, port and program. See {@link connectionId}. */
-    id: string;
-    label: string;
-    protocol: RemoteProtocol;
-    host: string;
-    port: number;
-    username: string;
-    password: string;
-    /** Windows domain or computer name. RDP only. */
-    domain: string;
-    security: RdpSecurity;
-    remoteApp: RemoteAppLaunch | null;
-    display: DisplaySettings;
-    ssh: SshCompanion;
-    /** Open the terminal panel as soon as the desktop appears. */
-    openSshOnConnect: boolean;
-}
-export declare const DEFAULT_DISPLAY_SETTINGS: DisplaySettings;
-/**
- * A connection's identity is what it points at, not when it was made. Editing
- * the address therefore makes a different connection rather than silently
- * repointing an existing card, which is the behaviour people expect from a
- * list of machines.
- */
-export declare function connectionId(input: Pick<ConnectionSettings, 'protocol' | 'host' | 'port'> & {
-    remoteApp?: RemoteAppLaunch | null;
-}): string;
-/** A blank connection, ready for the dialog to fill in. */
-export declare function emptyConnection(protocol?: RemoteProtocol): ConnectionSettings;
-export declare function normalizeDisplaySettings(value: unknown): DisplaySettings;
-/**
- * Build a complete, valid connection out of whatever a caller happens to have.
- * Partial input from a saved card, a host list entry, a URL or localStorage all
- * arrive here, so the dialog never has to reason about missing fields.
- */
-export declare function normalizeConnection(input: Partial<ConnectionSettings> & Record<string, unknown>): ConnectionSettings;
-/** What a connection is worth remembering by -- never the password. */
-export type PersistedConnection = Omit<ConnectionSettings, 'password'>;
-export declare function withoutPassword(settings: ConnectionSettings): PersistedConnection;
-/** A one-line description for the dialog's summary row and the status bar. */
-export declare function describeConnection(settings: ConnectionSettings): string;