@abitat_reece/host-daemon 0.1.5 → 0.1.7

package/dist/local-control/state.js

@@ -0,0 +1,264 @@
+import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir, hostname } from "node:os";
+import { dirname, join } from "node:path";
+const DEFAULT_PAIRING_TTL_MS = 5 * 60 * 1000;
+const LOCAL_WORKSPACE_ID = "local";
+const PAIRING_CAPABILITIES = [
+    "codex_chat",
+    "codex_projects",
+    "attachments",
+    "screen_control"
+];
+export function defaultLocalControlStatePath() {
+    return join(homedir(), "Library", "Application Support", "Abitat", "local-control-state.json");
+}
+export function defaultLocalAttachmentDirectory() {
+    return join(homedir(), "Library", "Application Support", "Abitat", "attachments");
+}
+export function hashLocalControlToken(token) {
+    return createHash("sha256").update(token).digest("hex");
+}
+export function createLocalControlStore(options = {}) {
+    const statePath = options.statePath ??
+        process.env.ABITAT_LOCAL_CONTROL_STATE_PATH ??
+        defaultLocalControlStatePath();
+    const now = options.now ?? (() => new Date());
+    const randomSecret = options.randomSecret ?? (() => randomBytes(32).toString("base64url"));
+    const idGenerator = options.idGenerator ?? ((prefix) => `${prefix}_${randomBytes(8).toString("hex")}`);
+    let hostToken = null;
+    async function loadState() {
+        const existing = await readStateFile(statePath);
+        if (existing) {
+            return existing;
+        }
+        hostToken = randomSecret();
+        const created = {
+            version: 1,
+            macId: idGenerator("mac"),
+            macName: hostname() || "Abitat Mac",
+            hostTokenHash: hashLocalControlToken(hostToken),
+            pairedDevices: [],
+            activePairings: []
+        };
+        await saveState(created);
+        return created;
+    }
+    async function saveState(state) {
+        await mkdir(dirname(statePath), { recursive: true });
+        await writeFile(statePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+    }
+    return {
+        statePath,
+        async getMacIdentity() {
+            const state = await loadState();
+            return {
+                macId: state.macId,
+                macName: state.macName
+            };
+        },
+        async getHostToken() {
+            const state = await loadState();
+            if (hostToken && tokenMatchesHash(hostToken, state.hostTokenHash)) {
+                return hostToken;
+            }
+            hostToken = randomSecret();
+            await saveState({
+                ...state,
+                hostTokenHash: hashLocalControlToken(hostToken)
+            });
+            return hostToken;
+        },
+        async getRelayId() {
+            const state = await loadState();
+            const existingRelayId = state.relayId ?? latestStoredRelayId(state);
+            if (existingRelayId) {
+                if (!state.relayId) {
+                    await saveState({
+                        ...state,
+                        relayId: existingRelayId
+                    });
+                }
+                return existingRelayId;
+            }
+            const relayId = idGenerator("relay");
+            await saveState({
+                ...state,
+                relayId
+            });
+            return relayId;
+        },
+        async createPairing(input) {
+            const state = await loadState();
+            const createdAt = now();
+            const pairingSecret = randomSecret();
+            const manualCode = manualCodeFromSeed(randomSecret());
+            const pairing = {
+                id: idGenerator("pairing"),
+                endpoint: input.endpoint,
+                secretHash: hashLocalControlToken(pairingSecret),
+                manualCodeHash: hashLocalControlToken(normalizeManualCode(manualCode)),
+                manualCode,
+                expiresAt: new Date(createdAt.getTime() + (input.ttlMs ?? DEFAULT_PAIRING_TTL_MS)).toISOString(),
+                consumedAt: null,
+                createdAt: createdAt.toISOString(),
+                relayId: input.relayId ?? null,
+                transport: input.transport
+            };
+            await saveState({
+                ...state,
+                activePairings: [
+                    ...state.activePairings.filter((candidate) => !isExpired(candidate, createdAt)),
+                    pairing
+                ]
+            });
+            return {
+                version: 1,
+                product: "abitat",
+                endpoint: input.endpoint,
+                macId: state.macId,
+                pairingSecret,
+                manualCode,
+                expiresAt: pairing.expiresAt,
+                transport: input.transport,
+                relayId: input.relayId,
+                capabilities: [...PAIRING_CAPABILITIES]
+            };
+        },
+        async consumePairing(input) {
+            const state = await loadState();
+            const pairedAt = now();
+            const manualCode = input.manualCode ?? input.code;
+            const pairing = state.activePairings.find((candidate) => {
+                if (input.pairingSecret && tokenMatchesHash(input.pairingSecret, candidate.secretHash)) {
+                    return true;
+                }
+                return Boolean(manualCode && tokenMatchesHash(normalizeManualCode(manualCode), candidate.manualCodeHash));
+            });
+            if (!pairing) {
+                throw new Error("Invalid pairing code");
+            }
+            if (pairing.consumedAt) {
+                throw new Error("Pairing code has already been used");
+            }
+            if (isExpired(pairing, pairedAt)) {
+                throw new Error("Pairing code has expired");
+            }
+            const clientToken = randomSecret();
+            const device = {
+                id: idGenerator("phone"),
+                name: input.deviceName,
+                platform: input.platform,
+                tokenHash: hashLocalControlToken(clientToken),
+                pairedAt: pairedAt.toISOString(),
+                lastSeenAt: pairedAt.toISOString(),
+                relayId: pairing.relayId ?? null,
+                revokedAt: null
+            };
+            const nextPairings = state.activePairings.map((candidate) => candidate.id === pairing.id
+                ? { ...candidate, consumedAt: pairedAt.toISOString() }
+                : candidate);
+            await saveState({
+                ...state,
+                activePairings: nextPairings,
+                pairedDevices: [...state.pairedDevices, device]
+            });
+            return {
+                machineId: device.id,
+                workspaceId: LOCAL_WORKSPACE_ID,
+                hostMachineId: state.macId,
+                clientToken,
+                endpoint: pairing.endpoint,
+                macId: state.macId
+            };
+        },
+        async getRelayKeyMaterials(relayId) {
+            const state = await loadState();
+            const checkedAt = now();
+            const pairingMaterials = state.activePairings
+                .filter((pairing) => pairing.relayId === relayId && !pairing.consumedAt && !isExpired(pairing, checkedAt))
+                .map((pairing) => ({
+                id: pairing.id,
+                kind: "pairing",
+                keyMaterial: pairing.secretHash
+            }));
+            const deviceMaterials = state.pairedDevices
+                .filter((device) => device.relayId === relayId && !device.revokedAt)
+                .map((device) => ({
+                id: device.id,
+                kind: "device",
+                keyMaterial: device.tokenHash
+            }));
+            return [...pairingMaterials, ...deviceMaterials];
+        },
+        async requireDeviceByToken(token) {
+            const state = await loadState();
+            const device = state.pairedDevices.find((candidate) => !candidate.revokedAt && tokenMatchesHash(token, candidate.tokenHash));
+            if (!device) {
+                throw new Error("Invalid mobile token");
+            }
+            const seenAt = now().toISOString();
+            await saveState({
+                ...state,
+                pairedDevices: state.pairedDevices.map((candidate) => candidate.id === device.id ? { ...candidate, lastSeenAt: seenAt } : candidate)
+            });
+            return { ...device, lastSeenAt: seenAt };
+        }
+    };
+}
+async function readStateFile(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        if (parsed.version !== 1 || typeof parsed.macId !== "string") {
+            return null;
+        }
+        return {
+            version: 1,
+            macId: parsed.macId,
+            macName: typeof parsed.macName === "string" ? parsed.macName : hostname() || "Abitat Mac",
+            hostTokenHash: typeof parsed.hostTokenHash === "string" ? parsed.hostTokenHash : "",
+            relayId: typeof parsed.relayId === "string" ? parsed.relayId : undefined,
+            pairedDevices: Array.isArray(parsed.pairedDevices) ? parsed.pairedDevices : [],
+            activePairings: Array.isArray(parsed.activePairings) ? parsed.activePairings : []
+        };
+    }
+    catch (error) {
+        if (isNotFoundError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+function manualCodeFromSeed(seed) {
+    const digest = hashLocalControlToken(seed).slice(0, 8).toUpperCase();
+    return `ABITAT-${digest.slice(0, 4)}-${digest.slice(4, 8)}`;
+}
+function normalizeManualCode(code) {
+    return code
+        .trim()
+        .replace(/[\u2010-\u2015\u2212]/gu, "-")
+        .replace(/\s+/gu, "")
+        .toUpperCase();
+}
+function isExpired(pairing, now) {
+    return Date.parse(pairing.expiresAt) <= now.getTime();
+}
+function latestStoredRelayId(state) {
+    return [
+        ...state.pairedDevices.flatMap((device) => device.relayId ? [{ relayId: device.relayId, timestamp: Date.parse(device.pairedAt) }] : []),
+        ...state.activePairings.flatMap((pairing) => pairing.relayId
+            ? [{ relayId: pairing.relayId, timestamp: Date.parse(pairing.createdAt) }]
+            : [])
+    ]
+        .sort((left, right) => right.timestamp - left.timestamp)
+        .at(0)?.relayId;
+}
+function tokenMatchesHash(token, expectedHash) {
+    const actual = Buffer.from(hashLocalControlToken(token), "hex");
+    const expected = Buffer.from(expectedHash, "hex");
+    return actual.length === expected.length && timingSafeEqual(actual, expected);
+}
+function isNotFoundError(error) {
+    return Boolean(error && typeof error === "object" && error.code === "ENOENT");
+}
+//# sourceMappingURL=state.js.map

package/dist/local-control/state.js.map

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

package/dist/local-control/transport.d.ts

@@ -0,0 +1,78 @@
+import type { Readable } from "node:stream";
+import type { LocalControlTransport } from "./state.js";
+type ExecFile = (file: string, args: string[]) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+interface QuickTunnelProcess {
+    kill(signal?: NodeJS.Signals | number): boolean;
+    killed: boolean;
+    off(event: string, listener: (...args: any[]) => void): QuickTunnelProcess;
+    once(event: string, listener: (...args: any[]) => void): QuickTunnelProcess;
+    stderr: Readable;
+    stdout: Readable;
+}
+type SpawnProcess = (file: string, args: string[]) => QuickTunnelProcess;
+export interface LocalControlTransportResolution {
+    bindHost: string;
+    endpoint: string;
+    relayEndpoint?: string;
+    transport: LocalControlTransport;
+    warning?: string;
+}
+export interface QuickTunnel {
+    close(): Promise<void>;
+    endpoint: string;
+}
+export interface SshTunnel {
+    close(): Promise<void>;
+    endpoint: string;
+}
+interface WaitForQuickTunnelReadyInput {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+    timeoutMs?: number;
+}
+export interface EndpointHealthMonitor {
+    stop(): void;
+}
+interface StartEndpointHealthMonitorInput {
+    fetch?: typeof fetch;
+    healthPath?: string;
+    intervalMs?: number;
+    maxFailures?: number;
+    onUnhealthy(error: Error): void;
+}
+interface ResolveLocalControlTransportInput {
+    endpoint?: string;
+    execFile?: ExecFile;
+    port: number;
+    relayEndpoint?: string;
+    requestedTransport: "auto" | LocalControlTransport | "temporary-tunnel";
+}
+export declare function resolveLocalControlTransport(input: ResolveLocalControlTransportInput): Promise<LocalControlTransportResolution>;
+export declare function startQuickTunnel(input: {
+    localUrl: string;
+    spawnProcess?: SpawnProcess;
+    timeoutMs?: number;
+}): Promise<QuickTunnel>;
+export declare function startLocalhostRunTunnel(input: {
+    localUrl: string;
+    spawnProcess?: SpawnProcess;
+    timeoutMs?: number;
+}): Promise<SshTunnel>;
+export declare function startPinggyTunnel(input: {
+    localUrl: string;
+    spawnProcess?: SpawnProcess;
+    timeoutMs?: number;
+}): Promise<SshTunnel>;
+export declare function startTemporarySshTunnel(input: {
+    localUrl: string;
+    onFallback?(error: unknown): void;
+    spawnProcess?: SpawnProcess;
+    timeoutMs?: number;
+}): Promise<SshTunnel>;
+export declare function waitForQuickTunnelReady(endpoint: string, input?: WaitForQuickTunnelReadyInput): Promise<void>;
+export declare function startEndpointHealthMonitor(endpoint: string, input: StartEndpointHealthMonitorInput): EndpointHealthMonitor;
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/local-control/transport.d.ts.map

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