@walldock/agent 0.1.0

package/dist/api.d.ts

@@ -0,0 +1,54 @@
+export interface DeviceScreen {
+    stableId: string;
+    label: string;
+    width: number;
+    height: number;
+    scaleFactor: number;
+    positionX: number;
+    positionY: number;
+    isPrimary: boolean;
+}
+export interface StartDevicePairingPayload {
+    pairingCode: string;
+    pairingSessionId: string;
+    expiresAt: string;
+}
+export interface DevicePairingStatusPayload {
+    status: 'pending' | 'approved' | 'rejected' | 'expired';
+    deviceToken: string | null;
+    deviceId: string | null;
+    deviceName: string | null;
+}
+export interface ValidateDeviceTokenPayload {
+    valid: boolean;
+    deviceId: string | null;
+    deviceName: string | null;
+}
+export interface DeviceScreenAssignmentPayload {
+    stableId: string;
+    wallpaperId: string | null;
+    imageUrl: string | null;
+    mimeType: string | null;
+    assignedAt: string | null;
+    appliedAt: string | null;
+}
+export interface DeviceCommandPayload {
+    id: string;
+    type: string;
+    payload: unknown;
+    createdAt: string;
+}
+export declare class AgentApi {
+    readonly endpoint: string;
+    constructor(endpoint?: string);
+    startPairing(): Promise<StartDevicePairingPayload>;
+    getPairingStatus(pairingSessionId: string): Promise<DevicePairingStatusPayload>;
+    validateToken(token: string): Promise<ValidateDeviceTokenPayload>;
+    unlinkDevice(token: string): Promise<void>;
+    getDeviceCommands(token: string, deviceId: string, signal?: AbortSignal): Promise<DeviceCommandPayload[]>;
+    reportDeviceScreens(token: string, deviceId: string, screens: DeviceScreen[], signal?: AbortSignal): Promise<void>;
+    getDeviceScreenAssignments(token: string, deviceId: string, signal?: AbortSignal): Promise<DeviceScreenAssignmentPayload[]>;
+    acknowledgeApplied(token: string, deviceId: string, stableId: string, wallpaperId: string): Promise<void>;
+    absoluteImageUrl(relativeOrAbsolute: string): string;
+    private request;
+}

package/dist/api.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentApi = void 0;
+const PROD_GRAPHQL_ENDPOINT = 'https://walldock.com/api/graphql';
+const START_DEVICE_PAIRING = `
+mutation StartDevicePairing {
+  startDevicePairing { pairingCode pairingSessionId expiresAt }
+}`;
+const DEVICE_PAIRING_STATUS = `
+query DevicePairingStatus($pairingSessionId: String!) {
+  devicePairingStatus(pairingSessionId: $pairingSessionId) {
+    status deviceToken deviceId deviceName
+  }
+}`;
+const VALIDATE_DEVICE_TOKEN = `
+query ValidateDeviceToken {
+  validateDeviceToken { valid deviceId deviceName }
+}`;
+const UNLINK_DEVICE = `
+mutation UnlinkDevice {
+  unlinkDevice { success }
+}`;
+const DEVICE_COMMANDS = `
+query DeviceCommands($deviceId: String!) {
+  deviceCommands(deviceId: $deviceId) { id type payload createdAt }
+}`;
+const REPORT_DEVICE_SCREENS = `
+mutation ReportDeviceScreens($deviceId: String!, $screens: [DeviceScreenInput!]!) {
+  reportDeviceScreens(deviceId: $deviceId, screens: $screens) { success screenCount }
+}`;
+const DEVICE_SCREEN_ASSIGNMENTS = `
+query DeviceScreenAssignments($deviceId: String!) {
+  deviceScreenAssignments(deviceId: $deviceId) {
+    stableId wallpaperId imageUrl mimeType assignedAt appliedAt
+  }
+}`;
+const ACKNOWLEDGE_APPLIED = `
+mutation AcknowledgeScreenWallpaperApplied($deviceId: String!, $stableId: String!, $wallpaperId: String!) {
+  acknowledgeScreenWallpaperApplied(deviceId: $deviceId, stableId: $stableId, wallpaperId: $wallpaperId)
+}`;
+class AgentApi {
+    endpoint;
+    constructor(endpoint = PROD_GRAPHQL_ENDPOINT) {
+        this.endpoint = endpoint;
+    }
+    async startPairing() {
+        const r = await this.request(START_DEVICE_PAIRING);
+        return r.startDevicePairing;
+    }
+    async getPairingStatus(pairingSessionId) {
+        const r = await this.request(DEVICE_PAIRING_STATUS, { pairingSessionId });
+        return r.devicePairingStatus;
+    }
+    async validateToken(token) {
+        const r = await this.request(VALIDATE_DEVICE_TOKEN, undefined, token);
+        return r.validateDeviceToken;
+    }
+    async unlinkDevice(token) {
+        await this.request(UNLINK_DEVICE, undefined, token);
+    }
+    async getDeviceCommands(token, deviceId, signal) {
+        const r = await this.request(DEVICE_COMMANDS, { deviceId }, token, signal);
+        return r.deviceCommands;
+    }
+    async reportDeviceScreens(token, deviceId, screens, signal) {
+        await this.request(REPORT_DEVICE_SCREENS, { deviceId, screens }, token, signal);
+    }
+    async getDeviceScreenAssignments(token, deviceId, signal) {
+        const r = await this.request(DEVICE_SCREEN_ASSIGNMENTS, { deviceId }, token, signal);
+        return r.deviceScreenAssignments;
+    }
+    async acknowledgeApplied(token, deviceId, stableId, wallpaperId) {
+        await this.request(ACKNOWLEDGE_APPLIED, { deviceId, stableId, wallpaperId }, token);
+    }
+    absoluteImageUrl(relativeOrAbsolute) {
+        if (/^https?:\/\//i.test(relativeOrAbsolute))
+            return relativeOrAbsolute;
+        const origin = new URL(this.endpoint).origin;
+        return `${origin}${relativeOrAbsolute}`;
+    }
+    async request(query, variables, token, signal) {
+        const headers = { 'content-type': 'application/json' };
+        if (token)
+            headers['authorization'] = `Bearer ${token}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 10_000);
+        if (signal)
+            signal.addEventListener('abort', () => controller.abort(), { once: true });
+        try {
+            const res = await fetch(this.endpoint, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ query, variables }),
+                signal: controller.signal,
+            });
+            if (!res.ok)
+                throw new Error(`GraphQL request failed: HTTP ${res.status}`);
+            const payload = (await res.json());
+            if (payload.errors?.length)
+                throw new Error(payload.errors.map(e => e.message).join('; '));
+            if (!payload.data)
+                throw new Error('GraphQL response missing data');
+            return payload.data;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+exports.AgentApi = AgentApi;

package/dist/auth.d.ts

@@ -0,0 +1,12 @@
+import { AgentApi } from './api';
+export interface PairingResult {
+    token: string;
+    deviceId: string;
+    deviceName: string;
+}
+export declare function runPairingFlow(api: AgentApi): Promise<PairingResult>;
+export declare function validateStoredToken(api: AgentApi): Promise<{
+    token: string;
+    deviceId: string;
+    deviceName: string;
+} | null>;

package/dist/auth.js

@@ -0,0 +1,144 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPairingFlow = runPairingFlow;
+exports.validateStoredToken = validateStoredToken;
+const promises_1 = require("node:readline/promises");
+const node_child_process_1 = require("node:child_process");
+const storage = __importStar(require("./token-storage"));
+function openBrowser(url) {
+    const cmd = process.platform === 'darwin' ? 'open'
+        : process.platform === 'win32' ? 'start'
+            : 'xdg-open';
+    (0, node_child_process_1.execFile)(cmd, [url], () => undefined);
+}
+async function ask(question) {
+    const rl = (0, promises_1.createInterface)({ input: process.stdin, output: process.stdout });
+    try {
+        return (await rl.question(question)).trim();
+    }
+    finally {
+        rl.close();
+    }
+}
+function spinner(text) {
+    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    let i = 0;
+    const timer = setInterval(() => {
+        process.stdout.write(`\r${frames[i++ % frames.length]}  ${text}  `);
+    }, 80);
+    return () => { clearInterval(timer); process.stdout.write('\r\x1b[K'); };
+}
+async function runPairingFlow(api) {
+    process.stdout.write('Requesting pairing session…\n');
+    let session;
+    try {
+        session = await api.startPairing();
+    }
+    catch (err) {
+        throw new Error(`Could not reach Walldock backend at ${api.endpoint}: ${err}`);
+    }
+    const pairingUrl = `https://walldock.com/app/pair?pairingId=${encodeURIComponent(session.pairingSessionId)}`;
+    const expiresAt = new Date(session.expiresAt);
+    console.log('');
+    console.log('╔════════════════════════════════════════════════════════╗');
+    console.log(`║  Pairing code: ${session.pairingCode.padEnd(40)} ║`);
+    console.log('╠════════════════════════════════════════════════════════╣');
+    console.log(`║  ${pairingUrl.padEnd(54)} ║`);
+    console.log(`║  Expires: ${expiresAt.toLocaleTimeString().padEnd(45)} ║`);
+    console.log('╚════════════════════════════════════════════════════════╝');
+    console.log('');
+    const openAnswer = await ask('Open pairing page in browser? [y/N] ');
+    if (openAnswer.toLowerCase() === 'y') {
+        openBrowser(pairingUrl);
+        console.log('Browser opened. Approve the device in the Walldock web app.');
+    }
+    else {
+        console.log('Visit the URL above in your browser and approve this device.');
+    }
+    console.log('');
+    const stopSpinner = spinner('Waiting for approval…');
+    try {
+        return await pollForApproval(api, session.pairingSessionId, session.expiresAt);
+    }
+    finally {
+        stopSpinner();
+    }
+}
+async function pollForApproval(api, sessionId, expiresAt) {
+    const expiry = new Date(expiresAt).getTime();
+    for (;;) {
+        if (Date.now() > expiry)
+            throw new Error('Pairing session expired. Run the agent again to start a new session.');
+        await new Promise(r => setTimeout(r, 2_000));
+        let status;
+        try {
+            status = await api.getPairingStatus(sessionId);
+        }
+        catch {
+            continue; // transient network error — keep polling
+        }
+        if (status.status === 'pending')
+            continue;
+        if (status.status === 'approved') {
+            if (!status.deviceToken || !status.deviceId || !status.deviceName) {
+                throw new Error('Approved pairing missing credentials.');
+            }
+            return { token: status.deviceToken, deviceId: status.deviceId, deviceName: status.deviceName };
+        }
+        throw new Error(`Pairing ${status.status}. Run the agent again to try again.`);
+    }
+}
+async function validateStoredToken(api) {
+    const token = await storage.getDeviceToken();
+    if (!token)
+        return null;
+    try {
+        const v = await api.validateToken(token);
+        if (!v.valid || !v.deviceId || !v.deviceName) {
+            await storage.deleteDeviceToken();
+            await storage.clearDeviceIdentity();
+            return null;
+        }
+        return { token, deviceId: v.deviceId, deviceName: v.deviceName };
+    }
+    catch {
+        // Network error — try cached identity for offline start
+        const cached = await storage.getDeviceIdentity();
+        if (cached)
+            return { token, ...cached };
+        return null;
+    }
+}

package/dist/cache.d.ts

@@ -0,0 +1,3 @@
+export declare function cachedPath(wallpaperId: string, mimeType: string | null, imageUrl: string | null): string;
+export declare function ensureWallpaper(wallpaperId: string, imageUrl: string, mimeType: string | null): Promise<string>;
+export declare function pruneCache(keepWallpaperIds: string[]): Promise<void>;

package/dist/cache.js

@@ -0,0 +1,119 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cachedPath = cachedPath;
+exports.ensureWallpaper = ensureWallpaper;
+exports.pruneCache = pruneCache;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+function cacheDir() {
+    if (process.platform === 'win32') {
+        return path.join(process.env['LOCALAPPDATA'] ?? os.homedir(), 'walldock', 'wallpapers');
+    }
+    if (process.platform === 'darwin') {
+        return path.join(os.homedir(), 'Library', 'Caches', 'walldock', 'wallpapers');
+    }
+    return path.join(process.env['XDG_CACHE_HOME'] ?? path.join(os.homedir(), '.cache'), 'walldock', 'wallpapers');
+}
+const CACHE_DIR = cacheDir();
+const EXTENSION_BY_MIME = {
+    'image/jpeg': 'jpg',
+    'image/jpg': 'jpg',
+    'image/png': 'png',
+    'image/webp': 'webp',
+    'image/gif': 'gif',
+    'image/heic': 'heic',
+    'image/heif': 'heif',
+};
+function guessExtension(mimeType, imageUrl) {
+    if (mimeType) {
+        const ext = EXTENSION_BY_MIME[mimeType.toLowerCase()];
+        if (ext)
+            return ext;
+    }
+    if (imageUrl) {
+        const m = /\.([a-zA-Z0-9]{2,5})(?:\?|$)/.exec(imageUrl);
+        if (m?.[1])
+            return m[1].toLowerCase();
+    }
+    return 'jpg';
+}
+function safeId(wallpaperId) {
+    return wallpaperId.replace(/[^a-zA-Z0-9\-_]/g, '_');
+}
+function cachedPath(wallpaperId, mimeType, imageUrl) {
+    const ext = guessExtension(mimeType, imageUrl);
+    return path.join(CACHE_DIR, `${safeId(wallpaperId)}.${ext}`);
+}
+async function download(url, destPath) {
+    const res = await fetch(url, { redirect: 'follow' });
+    if (!res.ok)
+        throw new Error(`HTTP ${res.status} downloading ${url}`);
+    const partPath = `${destPath}.part`;
+    await fs.writeFile(partPath, Buffer.from(await res.arrayBuffer()));
+    await fs.rename(partPath, destPath);
+}
+async function ensureWallpaper(wallpaperId, imageUrl, mimeType) {
+    await fs.mkdir(CACHE_DIR, { recursive: true });
+    const dest = cachedPath(wallpaperId, mimeType, imageUrl);
+    try {
+        await fs.access(dest);
+        return dest; // already cached
+    }
+    catch {
+        // not cached yet — download
+    }
+    await download(imageUrl, dest);
+    return dest;
+}
+async function pruneCache(keepWallpaperIds) {
+    let entries;
+    try {
+        entries = await fs.readdir(CACHE_DIR);
+    }
+    catch {
+        return;
+    }
+    const keepSet = new Set(keepWallpaperIds.map(safeId));
+    for (const entry of entries) {
+        if (entry.endsWith('.part'))
+            continue;
+        const base = path.basename(entry, path.extname(entry));
+        if (!keepSet.has(base)) {
+            await fs.unlink(path.join(CACHE_DIR, entry)).catch(() => undefined);
+        }
+    }
+}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const promises_1 = require("node:readline/promises");
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const api_1 = require("./api");
+const auth_1 = require("./auth");
+const sync_1 = require("./sync");
+const storage = __importStar(require("./token-storage"));
+const startup_1 = require("./startup");
+const pid_1 = require("./pid");
+// ─── Logging ─────────────────────────────────────────────────────────────────
+const isDaemon = process.argv.includes('--daemon');
+function logDir() {
+    if (process.platform === 'darwin')
+        return path.join(os.homedir(), 'Library', 'Logs');
+    if (process.platform === 'win32')
+        return path.join(process.env['APPDATA'] ?? os.homedir(), 'walldock');
+    return path.join(process.env['XDG_STATE_HOME'] ?? path.join(os.homedir(), '.local', 'state'), 'walldock');
+}
+let logStream = null;
+async function openLog() {
+    const dir = logDir();
+    await fs.mkdir(dir, { recursive: true });
+    logStream = await fs.open(path.join(dir, 'walldock-agent.log'), 'a');
+}
+function log(msg) {
+    const line = `[${new Date().toISOString()}] ${msg}\n`;
+    if (isDaemon && logStream) {
+        logStream.write(line).catch(() => undefined);
+    }
+    else {
+        process.stdout.write(line);
+    }
+}
+// ─── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+    const args = process.argv.slice(2);
+    // --unlink: remove stored credentials and startup entry
+    if (args.includes('--unlink')) {
+        const token = await storage.getDeviceToken();
+        if (token) {
+            const api = new api_1.AgentApi();
+            await api.unlinkDevice(token).catch(() => undefined);
+        }
+        await storage.deleteDeviceToken();
+        await storage.clearDeviceIdentity();
+        await (0, startup_1.unregisterStartup)().catch(() => undefined);
+        console.log('Device unlinked and startup entry removed.');
+        return;
+    }
+    // --status: print current link status
+    if (args.includes('--status')) {
+        const identity = await storage.getDeviceIdentity();
+        if (!identity) {
+            console.log('Status: not linked');
+        }
+        else {
+            console.log(`Status: linked as "${identity.deviceName}" (${identity.deviceId})`);
+        }
+        return;
+    }
+    if (isDaemon)
+        await openLog();
+    // Single-instance guard
+    try {
+        await (0, pid_1.acquireLock)();
+    }
+    catch (err) {
+        console.error(`\n${err}`);
+        process.exit(1);
+    }
+    const api = new api_1.AgentApi(process.env['WALLDOCK_API_URL'] ?? undefined);
+    const sync = new sync_1.SyncService(api, {
+        onTick(status, lastSyncAt) {
+            if (status === 'error')
+                log('[sync] connection error');
+            else if (lastSyncAt)
+                log(`[sync] ok at ${lastSyncAt}`);
+        },
+        onLog: log,
+    });
+    // Graceful shutdown
+    let stopping = false;
+    async function shutdown() {
+        if (stopping)
+            return;
+        stopping = true;
+        sync.stop();
+        await (0, pid_1.releaseLock)();
+        log('Walldock Agent stopped.');
+        await logStream?.close().catch(() => undefined);
+        process.exit(0);
+    }
+    process.on('SIGINT', () => { void shutdown(); });
+    process.on('SIGTERM', () => { void shutdown(); });
+    // Try to resume from stored token
+    log('Walldock Agent starting…');
+    const existing = await (0, auth_1.validateStoredToken)(api);
+    if (existing) {
+        await storage.setDeviceIdentity({ deviceId: existing.deviceId, deviceName: existing.deviceName });
+        log(`Linked as "${existing.deviceName}". Starting sync…`);
+        sync.start({ token: existing.token, deviceId: existing.deviceId });
+        return; // sync loop keeps process alive
+    }
+    // No valid token — need to pair
+    if (isDaemon) {
+        log('No valid device token found. Run without --daemon to pair this device.');
+        process.exit(1);
+    }
+    // Interactive pairing
+    let result;
+    try {
+        result = await (0, auth_1.runPairingFlow)(api);
+    }
+    catch (err) {
+        console.error(`\nPairing failed: ${err}`);
+        process.exit(1);
+    }
+    await storage.setDeviceToken(result.token);
+    await storage.setDeviceIdentity({ deviceId: result.deviceId, deviceName: result.deviceName });
+    console.log(`\n✓ Linked as "${result.deviceName}"`);
+    console.log('');
+    // Offer startup registration (only if globally installed)
+    const globalBin = await (0, startup_1.getGlobalBin)();
+    if (!globalBin) {
+        console.warn('  Note: walldock-agent is not globally installed — skipping startup registration.');
+        console.warn('  Run "npm install -g @walldock/agent" to enable automatic startup.');
+    }
+    else {
+        const rl = (0, promises_1.createInterface)({ input: process.stdin, output: process.stdout });
+        const answer = (await rl.question('Register Walldock Agent to start automatically at login? [Y/n] ')).trim();
+        rl.close();
+        if (answer.toLowerCase() !== 'n') {
+            try {
+                await (0, startup_1.registerStartup)();
+                console.log(`✓ Registered for startup (${(0, startup_1.startupDescription)()})`);
+            }
+            catch (err) {
+                console.warn(`  Could not register for startup: ${err}`);
+                console.warn('  You can run "walldock-agent --daemon" manually to start syncing.');
+            }
+        }
+    }
+    console.log('\nStarting sync. Press Ctrl+C to stop.\n');
+    sync.start({ token: result.token, deviceId: result.deviceId });
+}
+main().catch(err => {
+    console.error('Fatal:', err);
+    process.exit(1);
+});

package/dist/pid.d.ts

@@ -0,0 +1,6 @@
+export declare function runningPid(): Promise<number | null>;
+/**
+ * Write our PID to the lock file. Throws if another instance is already running.
+ */
+export declare function acquireLock(): Promise<void>;
+export declare function releaseLock(): Promise<void>;