tinybeeai 0.0.0-stage → 0.16.1

package/dist/cli/tinybee.js

@@ -0,0 +1,247 @@
+// TinyBee command line: `npx tinybeeai install [CODE]` pairs this laptop with the account the phone
+// signed up for, `npx tinybeeai start` brings a paired Bee back. Both run the full localdost server
+// (src/index.ts) with TinyBee settings that need no env file: data under ~/.tinybee, the hosted Hive
+// reached through its public origin, and the Bee on port 4319. The install code is the 6 characters
+// the sign-up page shows (docs/tinybee/02-architecture-pairing.md section 4); the phone confirms the
+// laptop afterwards, and the Bee's own heartbeat and tunnel take over from there.
+import { existsSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { fileURLToPath } from 'node:url';
+export const DEFAULT_HIVE_URL = 'https://dots.testllms.com';
+export const DEFAULT_PORT = '4319';
+export const DEFAULT_HOME = path.join(homedir(), '.tinybee');
+const HELP = `Usage: tinybeeai <command> [options]
+
+Commands:
+  install [CODE]  Pair this laptop with your TinyBee account. CODE is the 6-character install code the
+                  app shows; without it the command asks. Keeps running as your Bee once paired.
+  start           Start the paired Bee again (after a reboot, or when the window was closed)
+
+Options:
+  --dir <path>    Where the Bee keeps its data (default ~/.tinybee)
+  --hive <url>    The TinyBee service (default ${DEFAULT_HIVE_URL})
+  --port <n>      The local port the Bee answers on (default ${DEFAULT_PORT})
+  --replace       install: pair again when this laptop is already paired
+  --version, -v   Print the version
+
+The Bee's public address runs on cloudflared; install downloads it into <dir>/bin when PATH has none.
+`;
+export function parseArgs(argv) {
+    const out = { positional: [], replace: false, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const valued = () => {
+            const v = argv[++i];
+            if (v === undefined)
+                throw new Error(`${a} needs a value`);
+            return v;
+        };
+        if (a === '--dir')
+            out.dir = valued();
+        else if (a === '--hive')
+            out.hive = valued();
+        else if (a === '--port')
+            out.port = valued();
+        else if (a === '--replace')
+            out.replace = true;
+        else if (a === '-h' || a === '--help')
+            out.help = true;
+        else if (a.startsWith('--'))
+            throw new Error(`unknown option ${a}`);
+        else if (!out.command)
+            out.command = a;
+        else
+            out.positional.push(a);
+    }
+    return out;
+}
+/**
+ * The environment the server reads at import: set before anything under src/ is loaded.
+ * The shell wins for every variable but the Hive URL and the port given on the command line.
+ */
+export function applyTinybeeEnv(a, env = process.env) {
+    const home = path.resolve(a.dir ?? env.TINYBEE_HOME?.trim() ?? DEFAULT_HOME);
+    mkdirSync(home, { recursive: true });
+    env.TINYBEE_HOME = home;
+    if (!env.LOCALDOST_DATA_DIR?.trim())
+        env.LOCALDOST_DATA_DIR = path.join(home, 'data');
+    if (a.hive)
+        env.TINYBEE_HIVE_URL = a.hive;
+    if (!env.TINYBEE_HIVE_URL?.trim())
+        env.TINYBEE_HIVE_URL = DEFAULT_HIVE_URL;
+    env.TINYBEE_HIVE_URL = env.TINYBEE_HIVE_URL.trim().replace(/\/+$/, '');
+    if (!env.TINYBEE_ENV?.trim())
+        env.TINYBEE_ENV = 'staging';
+    if (a.port)
+        env.PORT = a.port;
+    if (!env.PORT?.trim())
+        env.PORT = DEFAULT_PORT;
+    // The server's own log stays quiet under the install dialogue; LOG_LEVEL in the shell still wins.
+    if (!env.LOG_LEVEL?.trim())
+        env.LOG_LEVEL = 'warn';
+    return home;
+}
+/** The 6 characters, upper-cased, spaces and hyphens dropped; undefined when it is not a code. */
+export function normalizeCode(raw) {
+    const c = raw.replace(/[\s-]/g, '').toUpperCase();
+    return /^[A-Z0-9]{6}$/.test(c) ? c : undefined;
+}
+const say = (s) => console.log(`[tinybee] ${s}`);
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function askCode() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        return (await rl.question('Install code from the app: ')).trim();
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Starts the server and waits until the Bee has loaded its state (initBee runs after listen). */
+async function bootBee() {
+    const web = path.join(fileURLToPath(new URL('../..', import.meta.url)), 'dist', 'web', 'index.html');
+    if (!existsSync(web) && !process.env.LOCALDOST_WEB_DIR)
+        console.warn('[tinybee] WARN the web app is not built; the phone still works, the local page does not.');
+    const pairing = await import('../bee/pairing.js');
+    await import('../index.js');
+    const t0 = Date.now();
+    while (pairing.beeSnapshot().stage === 'off') {
+        if (Date.now() - t0 > 60_000)
+            throw new Error('the Bee did not start within 60 s');
+        await sleep(200);
+    }
+    return pairing;
+}
+/** Prints each change of stage once, and the tunnel's complaint when it has one. */
+function follow(pairing) {
+    let last = '';
+    const report = () => {
+        const s = pairing.beeSnapshot();
+        const key = `${s.stage}|${s.problem ?? ''}|${s.tunnel?.state ?? ''}`;
+        if (key === last)
+            return;
+        last = key;
+        switch (s.stage) {
+            case 'claimed':
+                say(`Code accepted${s.slug ? ` for ${s.slug}` : ''}. Confirm this laptop in the app on your phone.`);
+                break;
+            case 'paired':
+                say(`Paired. Your Bee answers at https://${s.paired?.hostname ?? '?'} once the tunnel is up.`);
+                say('Keep this window open. Ctrl+C stops the Bee; `npx tinybeeai start` brings it back.');
+                break;
+            case 'replaced':
+                say('Another laptop replaced this one. Run `npx tinybeeai install --replace` to pair again.');
+                break;
+            default:
+                break;
+        }
+        if (s.problem)
+            say(s.problem);
+        if (s.tunnel?.state === 'no_cloudflared')
+            say(s.tunnel.lastError ?? 'cloudflared is not installed on this laptop.');
+    };
+    report();
+    pairing.onBeeChange(report);
+}
+/** Downloads cloudflared when the laptop has none; a failed download is a warning, pairing goes on. */
+async function prepareCloudflared(home) {
+    const { ensureCloudflared } = await import('../bee/cloudflared.js');
+    try {
+        await ensureCloudflared({ home, say });
+    }
+    catch (err) {
+        say(`WARN ${err instanceof Error ? err.message : String(err)}`);
+        say('Pairing works without it, but your address only comes up once cloudflared is installed.');
+    }
+}
+async function install(a) {
+    const home = applyTinybeeEnv(a);
+    const raw = a.positional[0] ?? (await askCode());
+    const code = normalizeCode(raw);
+    if (!code) {
+        console.error('[tinybee] Type the 6-character code the app shows, for example `npx tinybeeai install AB12CD`.');
+        return 1;
+    }
+    await prepareCloudflared(home);
+    say(`Starting your Bee (data in ${home}, Hive ${process.env.TINYBEE_HIVE_URL})…`);
+    const pairing = await bootBee();
+    const before = pairing.beeSnapshot();
+    if (before.stage === 'paired') {
+        if (!a.replace) {
+            say(`This laptop is already paired as https://${before.paired?.hostname ?? '?'}. Add --replace to pair it again.`);
+            follow(pairing);
+            return -1;
+        }
+        pairing.unpair();
+    }
+    try {
+        await pairing.submitInstallCode(code);
+    }
+    catch (err) {
+        console.error(`[tinybee] ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    follow(pairing);
+    return -1; // the Bee keeps running
+}
+async function start(a) {
+    const home = applyTinybeeEnv(a);
+    await prepareCloudflared(home);
+    say(`Starting your Bee (data in ${home})…`);
+    const pairing = await bootBee();
+    if (pairing.beeSnapshot().stage !== 'paired') {
+        console.error('[tinybee] This laptop is not paired yet. Run `npx tinybeeai install` with the code the app shows.');
+        return 1;
+    }
+    follow(pairing);
+    return -1;
+}
+export async function runTinybee(argv) {
+    let a;
+    try {
+        a = parseArgs(argv);
+    }
+    catch (err) {
+        console.error(`tinybeeai: ${err instanceof Error ? err.message : String(err)}\n\n${HELP}`);
+        return 1;
+    }
+    switch (a.command) {
+        case 'install':
+            if (a.help)
+                break;
+            return install(a);
+        case 'start':
+            if (a.help)
+                break;
+            return start(a);
+        case '--version':
+        case '-v': {
+            const { VERSION_LABEL } = await import('../version.js');
+            console.log(VERSION_LABEL);
+            return 0;
+        }
+        case undefined:
+        case 'help':
+            break;
+        default:
+            console.error(`tinybeeai: unknown command "${a.command}"\n\n${HELP}`);
+            return 1;
+    }
+    console.log(HELP);
+    return 0;
+}
+// Run when this file is the entry (bin/tinybeeai.js imports it); tests import the helpers only.
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+    runTinybee(process.argv.slice(2))
+        .then((code) => {
+        if (code >= 0)
+            process.exit(code);
+    })
+        .catch((err) => {
+        console.error(`tinybeeai: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=tinybee.js.map

package/dist/cli/tinybee.js.map

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

package/dist/config.js

@@ -0,0 +1,138 @@
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { dbFileIn } from './legacy-names.js'; // side effect: QADOTS_* fills LOCALDOST_*
+const env = process.env;
+let stored = { get: () => undefined, keys: () => [] };
+const settingsListeners = new Set();
+/** Called once by src/connect/store.ts. */
+export function setStoredResolver(r) {
+    stored = r;
+}
+/** A setting: the env value when non-empty, else the stored one. */
+export function setting(key) {
+    const v = process.env[key];
+    if (v !== undefined && v !== '')
+        return v;
+    return stored.get(key);
+}
+/** Where a setting comes from. The UI shows env values read-only. */
+export function settingSource(key) {
+    const v = process.env[key];
+    if (v !== undefined && v !== '')
+        return 'env';
+    return stored.get(key) !== undefined ? 'stored' : 'none';
+}
+/** Subscribe to saved-setting changes. Returns the unsubscribe function. */
+export function onSettingsChange(fn) {
+    settingsListeners.add(fn);
+    return () => {
+        settingsListeners.delete(fn);
+    };
+}
+export function emitSettingsChange(keys) {
+    for (const fn of [...settingsListeners]) {
+        try {
+            fn(keys);
+        }
+        catch (err) {
+            console.error('[localdost] settings listener failed', err);
+        }
+    }
+}
+/** process.env with stored settings layered under it. Reads are live; writes go to process.env. */
+export const liveEnv = new Proxy({}, {
+    get: (_t, key) => (typeof key === 'string' ? setting(key) : undefined),
+    has: (_t, key) => typeof key === 'string' && setting(key) !== undefined,
+    ownKeys: () => [...new Set([...Object.keys(process.env), ...stored.keys()])].filter((k) => setting(k) !== undefined),
+    getOwnPropertyDescriptor: (_t, key) => {
+        const v = typeof key === 'string' ? setting(key) : undefined;
+        return v === undefined ? undefined : { value: v, enumerable: true, configurable: true, writable: true };
+    },
+    set: (_t, key, value) => {
+        if (typeof key === 'string')
+            process.env[key] = String(value);
+        return true;
+    },
+    deleteProperty: (_t, key) => {
+        if (typeof key === 'string')
+            delete process.env[key];
+        return true;
+    },
+});
+/** Project root. Resolves the same from src/ (tsx) and dist/ (built). */
+export const ROOT = fileURLToPath(new URL('..', import.meta.url));
+const dataDir = env.LOCALDOST_DATA_DIR || join(ROOT, 'data');
+function flag(v) {
+    return v === '1' || v === 'true' || v === 'yes';
+}
+export const config = {
+    port: Number(env.PORT || 4319),
+    host: env.HOST || '0.0.0.0',
+    token: env.LOCALDOST_TOKEN || undefined,
+    /** Live: env, then a running quick tunnel, then the URL saved in the app. */
+    get publicUrl() {
+        return setting('LOCALDOST_PUBLIC_URL') || undefined;
+    },
+    demo: flag(env.LOCALDOST_DEMO),
+    /**
+     * LOCALDOST_ALLOW_UNSIGNED_WEBHOOKS=1: /hooks/* accepts events from a source whose webhook secret is unset.
+     * Off by default, and LOCALDOST_DEMO does not turn it on. Read live, so tests can flip it.
+     */
+    get allowUnsignedWebhooks() {
+        return flag(process.env.LOCALDOST_ALLOW_UNSIGNED_WEBHOOKS);
+    },
+    /** LOCALDOST_SANDBOX=1: serve the UI and API over existing data and let nothing leave (src/sandbox.ts). Read live, so tests can flip it. */
+    get sandbox() {
+        return flag(process.env.LOCALDOST_SANDBOX);
+    },
+    /** Look for AI-Vision on this machine at start and every few minutes. LOCALDOST_AIVISION_DETECT=0 turns it off. */
+    aivisionDetect: (env.LOCALDOST_AIVISION_DETECT ?? '1') !== '0',
+    logLevel: env.LOG_LEVEL || 'info',
+    dataDir,
+    dbPath: env.LOCALDOST_DB || dbFileIn(dataDir),
+    /** Built React client (vite build). `npm run build` or `npm run demo` writes it. */
+    webDir: env.LOCALDOST_WEB_DIR || join(ROOT, 'dist', 'web'),
+    demoDir: join(ROOT, 'demo'),
+    sampleAppPort: Number(env.LOCALDOST_SAMPLE_PORT || 4320),
+    secrets: {
+        get github() {
+            return setting('GITHUB_WEBHOOK_SECRET') || undefined;
+        },
+        get jira() {
+            return setting('JIRA_WEBHOOK_SECRET') || undefined;
+        },
+        get linear() {
+            return setting('LINEAR_WEBHOOK_SECRET') || undefined;
+        },
+    },
+    vapid: {
+        publicKey: env.VAPID_PUBLIC_KEY || undefined,
+        privateKey: env.VAPID_PRIVATE_KEY || undefined,
+        /** Contact the push services see. Unset: see vapidSubject() in src/notify/push.ts. */
+        subject: env.VAPID_SUBJECT || undefined,
+    },
+    /** Model backend: claude-cli, codex-cli, anthropic, or mock. Unset: anthropic when ANTHROPIC_API_KEY is set, else mock. */
+    get llm() {
+        return (setting('LOCALDOST_LLM') || '').trim().toLowerCase() || undefined;
+    },
+    /** Poll mode for every watch. A single watch opts in with pollGithub or pollLinear. */
+    poll: flag(env.LOCALDOST_POLL),
+    pollGithubSec: Math.max(10, Number(env.POLL_GITHUB_SEC) || 60),
+    pollLinearSec: Math.max(10, Number(env.POLL_LINEAR_SEC) || 60),
+    /** Linear replay window for webhookTimestamp. */
+    linearMaxSkewMs: 60_000,
+};
+const warned = new Set();
+export const log = {
+    info: (msg, ...rest) => console.log(`[localdost] ${msg}`, ...rest),
+    warn: (msg, ...rest) => console.warn(`[localdost] WARN ${msg}`, ...rest),
+    error: (msg, ...rest) => console.error(`[localdost] ERROR ${msg}`, ...rest),
+    /** Logs a warning once per key, e.g. for an unset webhook secret. */
+    warnOnce: (key, msg) => {
+        if (warned.has(key))
+            return;
+        warned.add(key);
+        console.warn(`[localdost] WARN ${msg}`);
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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