@poping/yome 0.0.4 → 0.0.5

package/dist/mesh/capabilities.js

@@ -0,0 +1,66 @@
+// Linux device capability detection.
+//
+// A "capability" is a domain key the Cloud agent's RpcRouter uses to
+// pick which device to route a given command to (see
+// Server/agent/RpcRouter.findDeviceForCapability). On macOS the list is
+// app-bundle-driven (PowerPoint installed → "ppt" capability); on Linux
+// the list is tool-binary-driven (docker installed → "docker" capability).
+//
+// We only declare capabilities whose handler actually exists in
+// cli/src/mesh/rpc-handler.ts. Adding a probe here without a handler
+// would silently advertise a capability we can't fulfill, which causes
+// the Cloud agent to route a command to us and then time out.
+import { existsSync, accessSync, constants } from 'fs';
+import { execSync } from 'child_process';
+/** Always-on capabilities every Linux box can provide. */
+const ALWAYS_ON = ['bash', 'fs', 'net', 'log', 'chat'];
+/** Each entry: capability key → predicate. Predicate must be cheap + sync. */
+const PROBES = [
+    { cap: 'git', probe: () => onPath('git') },
+    { cap: 'docker', probe: () => onPath('docker') },
+    { cap: 'k8s', probe: () => onPath('kubectl') },
+    { cap: 'systemd', probe: () => existsSync('/run/systemd/system') || onPath('systemctl') },
+    { cap: 'pkg', probe: () => onPath('apt-get') || onPath('dnf') || onPath('yum') || onPath('apk') || onPath('pacman') },
+    { cap: 'svc', probe: () => onPath('systemctl') || onPath('service') },
+];
+/**
+ * Run all probes once and return the union of always-on caps + detected
+ * caps. Called at registrar startup and on demand if the user invokes
+ * `yome mesh refresh-caps` (todo).
+ */
+export function detectCapabilities() {
+    const detected = new Set(ALWAYS_ON);
+    for (const { cap, probe } of PROBES) {
+        try {
+            if (probe())
+                detected.add(cap);
+        }
+        catch {
+            // Probe failures must never throw; treat as "capability not present".
+        }
+    }
+    return Array.from(detected).sort();
+}
+/** Best-effort PATH lookup that does NOT spawn a child if avoidable. */
+function onPath(bin) {
+    // 1. Walk $PATH directly. Cheap, no fork/exec.
+    const pathEnv = process.env.PATH ?? '';
+    for (const dir of pathEnv.split(':').filter(Boolean)) {
+        const candidate = `${dir}/${bin}`;
+        try {
+            accessSync(candidate, constants.X_OK);
+            return true;
+        }
+        catch { /* try next */ }
+    }
+    // 2. Final fallback to `command -v` in case PATH was weird (e.g. nss).
+    // Wrapped in try because non-zero exit throws synchronously.
+    try {
+        execSync(`command -v ${bin}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/mesh/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/mesh/capabilities.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,qEAAqE;AACrE,qDAAqD;AACrD,wEAAwE;AACxE,wEAAwE;AACxE,2EAA2E;AAC3E,EAAE;AACF,gEAAgE;AAChE,qEAAqE;AACrE,uEAAuE;AACvE,8DAA8D;AAE9D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,0DAA0D;AAC1D,MAAM,SAAS,GAAa,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,MAAM,GAAiD;IAC3D,EAAE,GAAG,EAAE,KAAK,EAAM,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;IAC9C,EAAE,GAAG,EAAE,QAAQ,EAAG,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;IACjD,EAAE,GAAG,EAAE,KAAK,EAAM,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;IAClD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE;IACzF,EAAE,GAAG,EAAE,KAAK,EAAM,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE;IACzH,EAAE,GAAG,EAAE,KAAK,EAAM,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE;CAC1E,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,SAAS,CAAC,CAAC;IAC5C,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,IAAI,KAAK,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,wEAAwE;AACxE,SAAS,MAAM,CAAC,GAAW;IACzB,+CAA+C;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;IAC5B,CAAC;IACD,uEAAuE;IACvE,6DAA6D;IAC7D,IAAI,CAAC;QACH,QAAQ,CAAC,cAAc,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/mesh/device-id.d.ts

@@ -0,0 +1,28 @@
+export interface DeviceState {
+    /** UUID v4 generated by this cli on first run. */
+    deviceId: string;
+    /** ISO-8601 timestamp of first generation. */
+    createdAt: string;
+    /** Hostname captured at first run, for logs / debugging. */
+    initialHostname: string;
+    /** Optional human-friendly name. Set via `yome mesh rename <alias>`. */
+    alias?: string;
+    /** Optional long-form description. */
+    description?: string;
+}
+export declare function getDeviceFilePath(): string;
+export declare function loadDeviceState(): DeviceState | null;
+export declare function writeDeviceState(state: DeviceState): void;
+/**
+ * Return the persistent deviceId, creating ~/.yome/device.json on first
+ * call. Idempotent + safe to call from any subcommand.
+ */
+export declare function getOrCreateDeviceId(): string;
+/** Update alias + description; preserves deviceId / createdAt. */
+export declare function updateDeviceMeta(meta: {
+    alias?: string;
+    description?: string;
+}): DeviceState;
+export declare function getModelString(): string;
+export declare function safeHostname(): string;
+export declare function currentPlatform(): NodeJS.Platform;

package/dist/mesh/device-id.js

@@ -0,0 +1,105 @@
+// Persistent deviceId for this Linux box.
+//
+// Lives at ~/.yome/device.json (0600), same dir as the auth.json that
+// yome login writes. Generated once on first `yome mesh start`, never
+// rotated unless the user explicitly removes the file.
+//
+// Strategy choice (see cli/MIGRATION.md): self-generated UUID, NOT
+// /etc/machine-id hash. Reason: VM templates and Docker images are
+// frequently cloned, and machine-id collisions would silently merge two
+// servers in the mesh device list. Random UUID is collision-safe across
+// clones; if a user really wants to keep a stable id when re-imaging,
+// they can copy ~/.yome/device.json over.
+//
+// Matches macOS/iOS behaviour in Yome/Shared/Sync/DeviceRegistrar.swift
+// (UUID stored in Keychain SecureStore).
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync, } from 'fs';
+import { homedir, hostname as osHostname, platform, release } from 'os';
+import { join, dirname } from 'path';
+import { randomUUID } from 'crypto';
+export function getDeviceFilePath() {
+    return join(homedir(), '.yome', 'device.json');
+}
+export function loadDeviceState() {
+    const f = getDeviceFilePath();
+    if (!existsSync(f))
+        return null;
+    try {
+        const obj = JSON.parse(readFileSync(f, 'utf-8'));
+        if (typeof obj?.deviceId !== 'string')
+            return null;
+        return obj;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeDeviceState(state) {
+    const f = getDeviceFilePath();
+    mkdirSync(dirname(f), { recursive: true });
+    writeFileSync(f, JSON.stringify(state, null, 2) + '\n', { mode: 0o600 });
+    // mode in writeFileSync only applies on CREATE; chmod again to be sure.
+    try {
+        chmodSync(f, 0o600);
+    }
+    catch { /* best effort on Windows */ }
+}
+/**
+ * Return the persistent deviceId, creating ~/.yome/device.json on first
+ * call. Idempotent + safe to call from any subcommand.
+ */
+export function getOrCreateDeviceId() {
+    const existing = loadDeviceState();
+    if (existing)
+        return existing.deviceId;
+    const fresh = {
+        deviceId: randomUUID(),
+        createdAt: new Date().toISOString(),
+        initialHostname: safeHostname(),
+    };
+    writeDeviceState(fresh);
+    return fresh.deviceId;
+}
+/** Update alias + description; preserves deviceId / createdAt. */
+export function updateDeviceMeta(meta) {
+    const current = loadDeviceState();
+    if (!current) {
+        // First run + rename in one shot: still generate the deviceId.
+        const fresh = {
+            deviceId: getOrCreateDeviceId(),
+            createdAt: new Date().toISOString(),
+            initialHostname: safeHostname(),
+            alias: meta.alias,
+            description: meta.description,
+        };
+        writeDeviceState(fresh);
+        return fresh;
+    }
+    const next = { ...current };
+    if (meta.alias !== undefined)
+        next.alias = meta.alias;
+    if (meta.description !== undefined)
+        next.description = meta.description;
+    writeDeviceState(next);
+    return next;
+}
+export function getModelString() {
+    // Format chosen to mirror DeviceRegistrar.swift's "{hwModel}, macOS {ver}"
+    // shape so the device list in iOS/macOS reads consistently.
+    // Linux: "{kernel-release}, {hostname}" — no useful "hw.model" sysctl
+    // equivalent on a generic VM; we'd otherwise have to parse
+    // /sys/class/dmi/id/product_name which most cloud VMs forge or hide.
+    return `Linux ${release()}`;
+}
+export function safeHostname() {
+    try {
+        return osHostname();
+    }
+    catch {
+        return 'linux-host';
+    }
+}
+export function currentPlatform() {
+    return platform();
+}
+//# sourceMappingURL=device-id.js.map

package/dist/mesh/device-id.js.map

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

package/dist/mesh/device-registrar.d.ts

@@ -0,0 +1,33 @@
+import type { PartyKitClient } from './partykit-client.js';
+export interface RegistrarOpts {
+    /** Override hostname (useful for `yome mesh start --as <name>`). */
+    hostnameOverride?: string;
+    /** Optional log hook. */
+    log?: (level: 'info' | 'warn' | 'error', msg: string, meta?: Record<string, unknown>) => void;
+}
+export declare class DeviceRegistrar {
+    private client;
+    private opts;
+    private heartbeatTimer;
+    private detachConnect;
+    private detachDisconnect;
+    private readonly deviceId;
+    private readonly hostname;
+    private readonly model;
+    private capabilities;
+    constructor(client: PartyKitClient, opts?: RegistrarOpts);
+    getDeviceId(): string;
+    getHostname(): string;
+    getCapabilities(): string[];
+    start(): void;
+    stop(): void;
+    sendRegistration(): Promise<void>;
+    /** Apply local metadata update + push mesh:update-device. */
+    sendDeviceMetaUpdate(meta: {
+        alias?: string;
+        description?: string;
+    }): Promise<void>;
+    private scheduleHeartbeat;
+    private clearHeartbeat;
+    private log;
+}

package/dist/mesh/device-registrar.js

@@ -0,0 +1,131 @@
+// Send mesh:register + mesh:heartbeat to the PartyKit room.
+//
+// Port of Yome/Shared/Sync/DeviceRegistrar.swift. Behaviour:
+//   - On connect: send mesh:register {hostname, model, capabilities, ...}.
+//   - Every 30s: send mesh:heartbeat {deviceId}.
+//   - On reconnect: re-send register (room may have evicted the stale
+//                   entry while we were down).
+//   - On alias / description change: send mesh:update-device.
+import { detectCapabilities } from './capabilities.js';
+import { getOrCreateDeviceId, getModelString, loadDeviceState, safeHostname } from './device-id.js';
+const HEARTBEAT_INTERVAL_MS = 30_000;
+export class DeviceRegistrar {
+    client;
+    opts;
+    heartbeatTimer = null;
+    detachConnect = null;
+    detachDisconnect = null;
+    deviceId;
+    hostname;
+    model;
+    capabilities;
+    constructor(client, opts = {}) {
+        this.client = client;
+        this.opts = opts;
+        this.deviceId = getOrCreateDeviceId();
+        this.hostname = opts.hostnameOverride ?? safeHostname();
+        this.model = getModelString();
+        this.capabilities = detectCapabilities();
+    }
+    getDeviceId() { return this.deviceId; }
+    getHostname() { return this.hostname; }
+    getCapabilities() { return [...this.capabilities]; }
+    start() {
+        // Initial registration if we're already connected (caller's choice;
+        // usually they connect first, then call start()).
+        if (this.client.connected) {
+            void this.sendRegistration();
+            this.scheduleHeartbeat();
+        }
+        // On every (re)connect, push registration again. Stash the off-handles
+        // so stop() can detach.
+        const noopDetach = () => { };
+        this.detachConnect = noopDetach; // overridden below if we wire onConnect
+        this.client.onConnect(() => {
+            this.log('info', 'PartyKit connected — sending registration', {
+                deviceId: this.deviceId, capabilities: this.capabilities,
+            });
+            void this.sendRegistration();
+            this.scheduleHeartbeat();
+        });
+        this.client.onDisconnect(() => {
+            this.log('warn', 'PartyKit disconnected — pausing heartbeat');
+            this.clearHeartbeat();
+        });
+    }
+    stop() {
+        this.clearHeartbeat();
+        this.detachConnect?.();
+        this.detachDisconnect?.();
+        this.detachConnect = null;
+        this.detachDisconnect = null;
+    }
+    async sendRegistration() {
+        const state = loadDeviceState();
+        const frame = {
+            type: 'mesh:register',
+            hostname: this.hostname,
+            model: this.model,
+            capabilities: this.capabilities,
+            installedApps: [], // Linux has no app-bundle concept; capabilities cover it
+            ...(state?.alias ? { alias: state.alias } : {}),
+            ...(state?.description ? { deviceDescription: state.description } : {}),
+        };
+        try {
+            await this.client.send(frame);
+        }
+        catch (err) {
+            this.log('error', 'sendRegistration failed', { err: err.message });
+        }
+    }
+    /** Apply local metadata update + push mesh:update-device. */
+    async sendDeviceMetaUpdate(meta) {
+        const frame = {
+            type: 'mesh:update-device',
+            deviceId: this.deviceId,
+            ...(meta.alias !== undefined ? { alias: meta.alias } : {}),
+            ...(meta.description !== undefined ? { deviceDescription: meta.description } : {}),
+        };
+        try {
+            // Server expects register first, then update (see Swift comment in
+            // DeviceRegistrar.sendDeviceMetaUpdate). Honour the same ordering.
+            await this.sendRegistration();
+            await new Promise((r) => setTimeout(r, 200));
+            await this.client.send(frame);
+        }
+        catch (err) {
+            this.log('error', 'sendDeviceMetaUpdate failed', { err: err.message });
+        }
+    }
+    scheduleHeartbeat() {
+        this.clearHeartbeat();
+        this.heartbeatTimer = setInterval(() => {
+            const frame = { type: 'mesh:heartbeat', deviceId: this.deviceId };
+            // Fire-and-forget; PartyKitClient will surface fatal errors via
+            // its own 'close' handler.
+            void this.client.send(frame).catch(() => { });
+        }, HEARTBEAT_INTERVAL_MS);
+        if (typeof this.heartbeatTimer.unref === 'function')
+            this.heartbeatTimer.unref();
+    }
+    clearHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    log(level, msg, meta) {
+        if (this.opts.log) {
+            this.opts.log(level, msg, meta);
+            return;
+        }
+        const line = meta ? `${msg} ${JSON.stringify(meta)}` : msg;
+        if (level === 'error')
+            console.error(`[registrar] ${line}`);
+        else if (level === 'warn')
+            console.warn(`[registrar] ${line}`);
+        else
+            console.log(`[registrar] ${line}`);
+    }
+}
+//# sourceMappingURL=device-registrar.js.map

package/dist/mesh/device-registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-registrar.js","sourceRoot":"","sources":["../../src/mesh/device-registrar.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,6DAA6D;AAC7D,2EAA2E;AAC3E,iDAAiD;AACjD,sEAAsE;AACtE,+CAA+C;AAC/C,8DAA8D;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAWpG,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAErC,MAAM,OAAO,eAAe;IASN;IAAgC;IAR5C,cAAc,GAA0B,IAAI,CAAC;IAC7C,aAAa,GAAwB,IAAI,CAAC;IAC1C,gBAAgB,GAAwB,IAAI,CAAC;IACpC,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,KAAK,CAAS;IACvB,YAAY,CAAW;IAE/B,YAAoB,MAAsB,EAAU,OAAsB,EAAE;QAAxD,WAAM,GAAN,MAAM,CAAgB;QAAU,SAAI,GAAJ,IAAI,CAAoB;QAC1E,IAAI,CAAC,QAAQ,GAAG,mBAAmB,EAAE,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,gBAAgB,IAAI,YAAY,EAAE,CAAC;QACxD,IAAI,CAAC,KAAK,GAAG,cAAc,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,kBAAkB,EAAE,CAAC;IAC3C,CAAC;IAED,WAAW,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,WAAW,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,eAAe,KAAe,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAE9D,KAAK;QACH,oEAAoE;QACpE,kDAAkD;QAClD,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,CAAC;QACD,uEAAuE;QACvE,wBAAwB;QACxB,MAAM,UAAU,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,CAAC,wCAAwC;QACzE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE;YACzB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,2CAA2C,EAAE;gBAC5D,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY;aACzD,CAAC,CAAC;YACH,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,2CAA2C,CAAC,CAAC;YAC9D,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,KAAK,GAAqB;YAC9B,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,aAAa,EAAE,EAAE,EAAE,yDAAyD;YAC5E,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC;QACF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,yBAAyB,EAAE,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,oBAAoB,CAAC,IAA8C;QACvE,MAAM,KAAK,GAAmB;YAC5B,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnF,CAAC;QACF,IAAI,CAAC;YACH,mEAAmE;YACnE,mEAAmE;YACnE,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,6BAA6B,EAAE,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAEO,iBAAiB;QACvB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/E,gEAAgE;YAChE,2BAA2B;YAC3B,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAsC,CAAC,CAAC,CAAC;QACnF,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAC1B,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,KAAK,UAAU;YAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IACnF,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAEO,GAAG,CAAC,KAAgC,EAAE,GAAW,EAAE,IAA8B;QACvF,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3D,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;aACvD,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;;YAC1D,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/mesh/index.d.ts

@@ -0,0 +1,28 @@
+import { PartyKitClient } from './partykit-client.js';
+import { DeviceRegistrar } from './device-registrar.js';
+import { RpcHandler } from './rpc-handler.js';
+export interface MeshDaemonOpts {
+    /** Override hub URL (env YOME_HUB_BASE wins inside ticket.ts otherwise). */
+    hubBase?: string;
+    /** Optional PartyKit host override (staging / local dev). */
+    partykitHost?: string;
+    /** Hostname to advertise. Defaults to os.hostname(). */
+    asName?: string;
+    /** Log sink; if omitted we use the built-in console logger. */
+    log?: (level: 'info' | 'warn' | 'error', msg: string, meta?: Record<string, unknown>) => void;
+}
+export interface MeshDaemon {
+    client: PartyKitClient;
+    registrar: DeviceRegistrar;
+    rpc: RpcHandler;
+    shutdown: () => void;
+}
+/**
+ * Start the mesh daemon. Resolves once the WS connection has been
+ * INITIATED (not necessarily established); the registrar will (re)send
+ * the registration once the WS open handler fires.
+ *
+ * Returns a `shutdown()` so the cli command runner can install signal
+ * handlers (SIGINT / SIGTERM) that tear it down cleanly.
+ */
+export declare function startMeshDaemon(opts?: MeshDaemonOpts): Promise<MeshDaemon>;

package/dist/mesh/index.js

@@ -0,0 +1,71 @@
+// Mesh subsystem entry point.
+//
+// Owns the lifetime of the PartyKit connection + DeviceRegistrar + RPC
+// handler. Called by `yome mesh start --foreground` (and, indirectly,
+// by the systemd unit installed via `yome daemon install` on Linux).
+import { TicketCache, mintWsTicket } from './ticket.js';
+import { PartyKitClient } from './partykit-client.js';
+import { DeviceRegistrar } from './device-registrar.js';
+import { RpcHandler } from './rpc-handler.js';
+import { getOrCreateDeviceId, safeHostname } from './device-id.js';
+/**
+ * Start the mesh daemon. Resolves once the WS connection has been
+ * INITIATED (not necessarily established); the registrar will (re)send
+ * the registration once the WS open handler fires.
+ *
+ * Returns a `shutdown()` so the cli command runner can install signal
+ * handlers (SIGINT / SIGTERM) that tear it down cleanly.
+ */
+export async function startMeshDaemon(opts = {}) {
+    const log = opts.log ?? defaultLog;
+    log('info', 'Starting yome mesh', {
+        deviceId: getOrCreateDeviceId(),
+        hostname: opts.asName ?? safeHostname(),
+    });
+    const ticketCache = new TicketCache(() => mintWsTicket({ hubBase: opts.hubBase }));
+    // Warm the cache eagerly so a misconfigured hub fails fast with a
+    // human-readable error, instead of inside the WS reconnect loop.
+    const firstTicket = await ticketCache.get();
+    log('info', 'Hub minted WS ticket', {
+        userId: firstTicket.userId,
+        deviceId: firstTicket.deviceId,
+        expiresIn: firstTicket.expires_in,
+        partykitHost: firstTicket.partykit_host,
+    });
+    const client = new PartyKitClient({
+        ticketCache,
+        partykitHostOverride: opts.partykitHost,
+        clientType: 'desktop',
+        log,
+    });
+    const registrar = new DeviceRegistrar(client, {
+        hostnameOverride: opts.asName,
+        log,
+    });
+    registrar.start();
+    const rpc = new RpcHandler(client, { log });
+    rpc.start();
+    await client.connect();
+    return {
+        client,
+        registrar,
+        rpc,
+        shutdown: () => {
+            rpc.stop();
+            registrar.stop();
+            client.disconnect();
+        },
+    };
+}
+function defaultLog(level, msg, meta) {
+    const line = meta ? `${msg} ${JSON.stringify(meta)}` : msg;
+    const stamp = new Date().toISOString();
+    const out = `${stamp} [${level}] ${line}`;
+    if (level === 'error')
+        console.error(out);
+    else if (level === 'warn')
+        console.warn(out);
+    else
+        console.log(out);
+}
+//# sourceMappingURL=index.js.map

package/dist/mesh/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,qEAAqE;AAErE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoBnE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAuB,EAAE;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC;IACnC,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE;QAChC,QAAQ,EAAE,mBAAmB,EAAE;QAC/B,QAAQ,EAAE,IAAI,CAAC,MAAM,IAAI,YAAY,EAAE;KACxC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnF,kEAAkE;IAClE,iEAAiE;IACjE,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC;IAC5C,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE;QAClC,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,SAAS,EAAE,WAAW,CAAC,UAAU;QACjC,YAAY,EAAE,WAAW,CAAC,aAAa;KACxC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,WAAW;QACX,oBAAoB,EAAE,IAAI,CAAC,YAAY;QACvC,UAAU,EAAE,SAAS;QACrB,GAAG;KACJ,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE;QAC5C,gBAAgB,EAAE,IAAI,CAAC,MAAM;QAC7B,GAAG;KACJ,CAAC,CAAC;IACH,SAAS,CAAC,KAAK,EAAE,CAAC;IAElB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,KAAK,EAAE,CAAC;IAEZ,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IAEvB,OAAO;QACL,MAAM;QACN,SAAS;QACT,GAAG;QACH,QAAQ,EAAE,GAAG,EAAE;YACb,GAAG,CAAC,IAAI,EAAE,CAAC;YACX,SAAS,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAgC,EAAE,GAAW,EAAE,IAA8B;IAC/F,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,GAAG,KAAK,KAAK,KAAK,KAAK,IAAI,EAAE,CAAC;IAC1C,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACrC,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;QACxC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/mesh/partykit-client.d.ts

@@ -0,0 +1,43 @@
+import WebSocket from 'ws';
+import type { TicketCache } from './ticket.js';
+export interface PartyKitClientOpts {
+    ticketCache: TicketCache;
+    /** Override at boot for staging / local dev. */
+    partykitHostOverride?: string;
+    /** Override at boot for staging / local dev. */
+    roomIdOverride?: string;
+    clientType?: 'desktop' | 'mac' | 'ios' | 'web';
+    locale?: string;
+    /** Test seam: inject a custom WebSocket factory. */
+    wsFactory?: (url: string) => WebSocket;
+    /** Inject a logger; defaults to console. */
+    log?: (level: 'info' | 'warn' | 'error', msg: string, meta?: Record<string, unknown>) => void;
+}
+export type Listener = (frame: string) => void;
+export declare class PartyKitClient {
+    private opts;
+    private ws;
+    private isConnected;
+    private reconnectAttempts;
+    private readonly maxReconnectAttempts;
+    private reconnectTimer;
+    private pingTimer;
+    private intentionalClose;
+    private readonly listeners;
+    private onConnectCb;
+    private onDisconnectCb;
+    constructor(opts: PartyKitClientOpts);
+    onMessage(cb: Listener): () => void;
+    onConnect(cb: () => void): void;
+    onDisconnect(cb: () => void): void;
+    connect(): Promise<void>;
+    disconnect(): void;
+    /** Throws if not connected. Caller chooses to await or fire-and-forget. */
+    send(frame: string | object): Promise<void>;
+    get connected(): boolean;
+    private log;
+    private establish;
+    private startPing;
+    private cleanupSocket;
+    private scheduleReconnect;
+}