uxnan-bridge 0.0.1-alpha.20260621

package/dist/src/cli.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+/**
+ * uxnan-bridge CLI.
+ *
+ * Commands (architecture/02a-system-architecture.md §5.8.5):
+ *   start            start the daemon
+ *   stop             stop the daemon
+ *   status           print current status
+ *   qr               print the pairing QR in the terminal
+ *   install-service  configure autostart on this platform
+ *
+ * In this skeleton increment `start` boots the daemon core without the live
+ * relay/LAN transport; `stop`/`install-service` are deferred (FOR-DEV).
+ */
+import { fileURLToPath } from 'node:url';
+import { encodePairingQr } from '@uxnan/shared';
+import { startBridge } from './bridge.js';
+import { renderPairingQr } from './qr.js';
+import { BRIDGE_VERSION } from './version.js';
+import { DaemonState, DAEMON_FILES } from './daemon-state.js';
+import { LockFile, isProcessAlive } from './lock-file.js';
+import { currentServiceEnv, installService, isServicePlatformSupported, uninstallService, } from './service-installer.js';
+const USAGE = `uxnan-bridge v${BRIDGE_VERSION}
+
+Usage: uxnan-bridge <command>
+
+Commands:
+  start            Start the bridge daemon (skeleton: no live transport yet)
+  status           Print the current bridge status
+  qr               Print the pairing QR code in the terminal
+  code             Print the current manual-pairing code (matches the daemon)
+  stop             Stop the running daemon
+  install-service    Start the bridge automatically at logon (as the current user)
+  uninstall-service  Remove the autostart entry
+  help             Show this help
+`;
+async function cmdQr() {
+    const bridge = await startBridge();
+    const payload = bridge.generatePairingQr();
+    const qr = await renderPairingQr(payload);
+    process.stdout.write(`${qr}\n`);
+    process.stdout.write('Scan with the Uxnan mobile app.\n');
+    process.stdout.write(`Or enter this pairing code on the phone: ${bridge.currentPairingCode()}\n`);
+    process.stdout.write(`Expires at: ${new Date(payload.expiresAt).toISOString()}\n`);
+    process.stdout.write(`Payload: ${encodePairingQr(payload)}\n`);
+    await bridge.stop();
+}
+async function cmdCode() {
+    // Prints the current manual-pairing code. Shares the code with a running
+    // daemon via `~/.uxnan/pairing-code.json`, so this matches what the daemon
+    // serving `/pair/resolve` accepts — handy when the daemon runs hidden (autostart).
+    const bridge = await startBridge();
+    process.stdout.write(`${bridge.currentPairingCode()}\n`);
+    await bridge.stop();
+}
+async function cmdStatus() {
+    const bridge = await startBridge();
+    process.stdout.write(`${JSON.stringify(bridge.status(), null, 2)}\n`);
+    await bridge.stop();
+}
+async function cmdStart() {
+    const state = new DaemonState();
+    await state.ensureDir();
+    const lock = new LockFile(state.pathFor(DAEMON_FILES.lock));
+    if (!(await lock.acquire())) {
+        const held = await lock.read();
+        process.stderr.write(`uxnan-bridge is already running${held ? ` (pid ${held.pid})` : ''}. Run 'uxnan-bridge stop' first.\n`);
+        process.exitCode = 1;
+        return;
+    }
+    const bridge = await startBridge();
+    if (bridge.context.config.lanEnabled) {
+        try {
+            const { port } = await bridge.startLan();
+            process.stdout.write(`LAN server listening on port ${port}.\n`);
+        }
+        catch (err) {
+            process.stderr.write(`Failed to start LAN server: ${errText(err)}\n`);
+        }
+    }
+    const payload = bridge.generatePairingQr();
+    const qr = await renderPairingQr(payload);
+    process.stdout.write(`${qr}\nScan with the Uxnan mobile app.\n`);
+    // Manual-code pairing: this RUNNING daemon serves `GET /pair/resolve`, so its
+    // own in-memory code is the one the phone must enter (the `qr` command runs a
+    // separate, short-lived process with a different code).
+    process.stdout.write(`Or enter this pairing code on the phone: ${bridge.currentPairingCode()}\n`);
+    if (payload.hosts && payload.hosts.length > 0) {
+        process.stdout.write(`Direct addresses (LAN/Tailscale): ${payload.hosts.join(', ')}\n`);
+    }
+    if (bridge.context.config.relayEnabled && payload.relay) {
+        try {
+            await bridge.connectRelay(payload.sessionId);
+            process.stdout.write(`Connected to relay ${payload.relay}; waiting for a phone.\n`);
+        }
+        catch (err) {
+            process.stderr.write(`Relay connection failed (${errText(err)}); the direct LAN/Tailscale path remains available.\n`);
+        }
+    }
+    else {
+        process.stdout.write('Relay disabled; using the direct LAN/Tailscale path only.\n');
+    }
+    process.stdout.write('Press Ctrl+C to stop.\n');
+    await new Promise((resolve) => {
+        const shutdown = () => {
+            void Promise.allSettled([bridge.stop(), lock.release()]).then(() => resolve());
+        };
+        process.once('SIGINT', shutdown);
+        process.once('SIGTERM', shutdown);
+    });
+}
+async function cmdStop() {
+    const state = new DaemonState();
+    const lock = new LockFile(state.pathFor(DAEMON_FILES.lock));
+    const held = await lock.read();
+    if (!held || !isProcessAlive(held.pid)) {
+        process.stdout.write('uxnan-bridge is not running.\n');
+        await lock.release(held?.pid);
+        return;
+    }
+    try {
+        process.kill(held.pid, 'SIGTERM');
+        process.stdout.write(`Sent stop signal to uxnan-bridge (pid ${held.pid}).\n`);
+    }
+    catch (err) {
+        process.stderr.write(`Failed to stop pid ${held.pid}: ${errText(err)}\n`);
+        process.exitCode = 1;
+    }
+}
+function errText(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function bridgeCliPath() {
+    return fileURLToPath(import.meta.url);
+}
+async function cmdInstallService() {
+    if (!isServicePlatformSupported(process.platform)) {
+        process.stderr.write(`Autostart is not supported on '${process.platform}'.\n`);
+        process.exitCode = 1;
+        return;
+    }
+    const plan = await installService(currentServiceEnv(bridgeCliPath()));
+    process.stdout.write(`${plan.note}\n`);
+}
+async function cmdUninstallService() {
+    if (!isServicePlatformSupported(process.platform)) {
+        process.stderr.write(`Autostart is not supported on '${process.platform}'.\n`);
+        process.exitCode = 1;
+        return;
+    }
+    const plan = await uninstallService(currentServiceEnv(bridgeCliPath()));
+    process.stdout.write(`${plan.uninstallNote}\n`);
+}
+async function main() {
+    const command = process.argv[2] ?? 'help';
+    switch (command) {
+        case 'qr':
+            await cmdQr();
+            return 0;
+        case 'code':
+            await cmdCode();
+            return 0;
+        case 'status':
+            await cmdStatus();
+            return 0;
+        case 'start':
+            await cmdStart();
+            return 0;
+        case 'stop':
+            await cmdStop();
+            return 0;
+        case 'install-service':
+            await cmdInstallService();
+            return 0;
+        case 'uninstall-service':
+            await cmdUninstallService();
+            return 0;
+        case 'help':
+        case '--help':
+        case '-h':
+            process.stdout.write(USAGE);
+            return 0;
+        default:
+            process.stderr.write(`Unknown command: ${command}\n\n${USAGE}`);
+            return 1;
+    }
+}
+main().then((code) => {
+    process.exitCode = code;
+}, (err) => {
+    process.stderr.write(`uxnan-bridge error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/conversation/session-history.d.ts

@@ -0,0 +1,27 @@
+import type { Turn } from '@uxnan/shared';
+/** Where a thread's on-disk history lives, as known by the bridge. */
+export interface HistorySource {
+    agentId?: string;
+    /** The agent's native session id (file locator). */
+    agentSessionId?: string;
+    /** The thread's working directory (helps disambiguate for some agents). */
+    cwd?: string;
+}
+export interface SessionHistoryOptions {
+    /** Home directory root; overridable in tests to point at a fixtures tree. */
+    homeDir?: string;
+    /** Injected clock for the path cache TTL (epoch ms). */
+    now?: () => number;
+    /** Path-cache TTL in ms (default 60s, per §5.8.8). */
+    cacheTtlMs?: number;
+}
+export declare class SessionHistoryReader {
+    #private;
+    constructor(options?: SessionHistoryOptions);
+    /**
+     * Read a thread's turns from the agent's on-disk session log. Returns the full
+     * ordered turn list (the caller paginates), or `null` when nothing usable was
+     * found (unknown/unsupported agent, missing session id, no file, empty log).
+     */
+    readTurns(source: HistorySource, threadId: string): Promise<Turn[] | null>;
+}