@withbuddi/buddi 0.1.0-pre.16 → 0.1.0-pre.18

package/node_modules/@buddi/cli/dist/paths.js

@@ -7,12 +7,12 @@
  * working through the symlink `pnpm link --global` leaves behind (Node resolves
  * the entry point's real path before this module is evaluated).
  */
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { hydrateDatabaseUrl } from '@buddi/core';
-import { loadPluginsOnce } from '@buddi/gateway';
-import { config as loadDotenv } from 'dotenv';
+import { hydrateSecrets, loadPluginsOnce } from '@buddi/gateway';
+import { config as loadDotenv, parse as parseDotenv } from 'dotenv';
 /** `packages/cli/dist` at runtime, `packages/cli/src` under vitest. */
 export const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
 /** A directory is the repo root when it holds the workspace manifest. */
@@ -36,10 +36,25 @@ export function findRepoRoot(start, exists = isRepoRoot) {
     }
 }
 export const REPO_ROOT = process.env.BUDDI_INSTALL_ROOT ?? findRepoRoot(MODULE_DIR);
+export const ENV_FILE = process.env.BUDDI_ENV_FILE ?? path.join(REPO_ROOT, '.env');
+/**
+ * One value out of `.env` before `.env` is loaded: the data directory decides
+ * where the logs, the backups and the service units point, and those paths
+ * are computed here at import, before any command calls `loadEnv()`. Read
+ * from the file directly so `BUDDI_DATA_DIR=` in `.env` is honoured the same
+ * as the variable in the environment, which wins when both are set.
+ */
+function envFileValue(name) {
+    try {
+        return parseDotenv(readFileSync(ENV_FILE, 'utf8'))[name];
+    }
+    catch {
+        return undefined;
+    }
+}
 /** Everything the installation writes: artifacts, logs. Overridable for tests. */
-export const DATA_DIR = process.env.BUDDI_DATA_DIR ?? path.join(REPO_ROOT, 'data');
+export const DATA_DIR = process.env.BUDDI_DATA_DIR ?? envFileValue('BUDDI_DATA_DIR') ?? path.join(REPO_ROOT, 'data');
 export const LOG_DIR = path.join(DATA_DIR, 'logs');
-export const ENV_FILE = process.env.BUDDI_ENV_FILE ?? path.join(REPO_ROOT, '.env');
 export const ENV_EXAMPLE_FILE = path.join(REPO_ROOT, '.env.example');
 /** What the service supervises: the built long-running process. */
 export const SERVE_ENTRY = path.join(REPO_ROOT, 'packages', 'gateway', 'dist', 'serve.js');
@@ -52,11 +67,14 @@ export function loadEnv() {
     loadDotenv({ path: ENV_FILE });
 }
 /**
- * `.env`, and then the one variable that is deliberately no longer in it.
+ * `.env`, and then what is deliberately no longer in it.
  *
- * `DATABASE_URL` is assembled from the vault at runtime rather than written
- * into `.env` with the password in clear, and reading the vault is a keychain
- * call. Every subcommand waits on this before it touches `process.env.DATABASE_URL`.
+ * Provider keys and `DATABASE_URL` live in the vault, not in `.env` in clear,
+ * and reading the vault is a keychain call. The CLI hydrates the same names
+ * the gateway does at boot (`hydrateSecrets`), so `buddi status` and
+ * `buddi agents` judge an agent by the key the vault holds rather than by an
+ * environment variable nobody sets any more. Every subcommand waits on this
+ * before it touches `process.env.DATABASE_URL`.
  */
 export async function loadEnvironment(env = process.env) {
     loadEnv();
@@ -64,6 +82,14 @@ export async function loadEnvironment(env = process.env) {
     // registry built before the record is read has none of their tools, and an
     // agent granted one of those tools then fails to load.
     await loadPluginsOnce(env);
-    return hydrateDatabaseUrl(env);
+    try {
+        const hydrated = await hydrateSecrets(env);
+        return { url: env.DATABASE_URL, source: hydrated.database.source, legacyPassword: hydrated.database.legacyPassword };
+    }
+    catch {
+        // A vault that cannot be read (locked keychain, no keychain at all) must
+        // not stop a command that only needs the connection string.
+        return hydrateDatabaseUrl(env);
+    }
 }
 //# sourceMappingURL=paths.js.map

package/node_modules/@buddi/cli/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAA8B,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9C,uEAAuE;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEvE,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,SAAmC,UAAU;IACvF,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,SAAS,CAAC;QACR,IAAI,MAAM,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACjE,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;AAEpF,kFAAkF;AAClF,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACrE,mEAAmE;AACnE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAC3F,+DAA+D;AAC/D,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AACpF,wEAAwE;AACxE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEzD,kFAAkF;AAClF,MAAM,UAAU,OAAO;IACrB,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,EAAE,CAAC;IACV,uEAAuE;IACvE,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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"}

package/node_modules/@buddi/cli/dist/status.d.ts

@@ -0,0 +1,70 @@
+import type { InstallKind } from './commands.js';
+export type ServiceState = 'running' | 'stopped' | 'not-installed' | 'unknown';
+export interface StatusReport {
+    version: string;
+    install: InstallKind;
+    service: {
+        state: ServiceState;
+        detail: string;
+    };
+    database: {
+        reachable: boolean;
+        error?: string;
+    };
+    agents: {
+        ready: Array<{
+            handle: string;
+            id: string;
+        }>;
+        unavailable: Array<{
+            handle: string;
+            id: string;
+            reason: string;
+        }>;
+        error?: string;
+    };
+    /** Null when the database could not be read. */
+    needsYou: {
+        approvals: number;
+        questions: number;
+    } | null;
+    lastRecapAt: string | null;
+    update: {
+        available: boolean;
+        latest?: string;
+    };
+}
+/** Everything `collectStatus` reads, injectable so the report is testable. */
+export interface StatusSources {
+    install: InstallKind;
+    version(): Promise<string>;
+    service(): Promise<{
+        state: ServiceState;
+        detail: string;
+    }>;
+    probeDatabase(): Promise<void>;
+    describeDatabaseError(err: unknown): string;
+    agents(): Promise<Array<{
+        handle: string;
+        id: string;
+        available: boolean;
+        reason?: string;
+    }>>;
+    attention(): Promise<{
+        approvals: number;
+        questions: number;
+    }>;
+    lastRecapAt(): Promise<Date | null>;
+    update(): Promise<{
+        available: boolean;
+        latest?: string;
+    }>;
+}
+export declare function collectStatus(sources: StatusSources): Promise<StatusReport>;
+/** The report as a few short sentences. Pure. */
+export declare function renderStatus(report: StatusReport, timezone?: string): string;
+/** When a process started, as `ps` says it; undefined when it cannot. */
+export declare function startedAt(pid: number): Promise<string | undefined>;
+/** The supervisor's control socket, beside the data it looks after. */
+export declare function supervisorSocketPath(dataDir: string): string;
+//# sourceMappingURL=status.d.ts.map

package/node_modules/@buddi/cli/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,QAAQ,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,MAAM,EAAE;QACN,KAAK,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC7C,WAAW,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACnE,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,gDAAgD;IAChD,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC9F,SAAS,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,WAAW,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAID,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAsCjF;AAID,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAqD3E;AAED,yEAAyE;AACzE,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQxE;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/node_modules/@buddi/cli/dist/status.js

@@ -0,0 +1,122 @@
+/**
+ * `buddi status` — one screen of how this installation is.
+ *
+ * Each part is read on its own and a part that cannot be read says so in one
+ * line; nothing here throws past `collectStatus`. `buddi doctor` stays the
+ * deep check: this is the glance.
+ */
+import { execFile } from 'node:child_process';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { localDateTimeString } from '@buddi/core';
+const exec = promisify(execFile);
+const message = (err) => (err instanceof Error ? err.message : String(err));
+export async function collectStatus(sources) {
+    const version = await sources.version().catch(() => 'unknown');
+    const service = await sources
+        .service()
+        .catch((err) => ({ state: 'unknown', detail: message(err) }));
+    let database;
+    try {
+        await sources.probeDatabase();
+        database = { reachable: true };
+    }
+    catch (err) {
+        database = { reachable: false, error: sources.describeDatabaseError(err) };
+    }
+    const agents = { ready: [], unavailable: [] };
+    try {
+        for (const agent of await sources.agents()) {
+            if (agent.available)
+                agents.ready.push({ handle: agent.handle, id: agent.id });
+            else
+                agents.unavailable.push({ handle: agent.handle, id: agent.id, reason: agent.reason ?? 'not available' });
+        }
+    }
+    catch (err) {
+        agents.error = message(err);
+    }
+    const needsYou = database.reachable ? await sources.attention().catch(() => null) : null;
+    const lastRecap = database.reachable ? await sources.lastRecapAt().catch(() => null) : null;
+    const update = await sources.update().catch(() => ({ available: false }));
+    return {
+        version,
+        install: sources.install,
+        service,
+        database,
+        agents,
+        needsYou,
+        lastRecapAt: lastRecap ? lastRecap.toISOString() : null,
+        update,
+    };
+}
+const count = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+/** The report as a few short sentences. Pure. */
+export function renderStatus(report, timezone = 'UTC') {
+    const lines = [];
+    lines.push(`buddi ${report.version}, ${report.install === 'packaged' ? 'a packaged install' : 'a source checkout'}.`);
+    const service = report.service;
+    if (service.state === 'running')
+        lines.push(`The service is ${service.detail}.`);
+    else if (service.state === 'not-installed') {
+        lines.push(report.install === 'packaged'
+            ? 'The service is not running. Run buddi to start it.'
+            : 'The service is not installed. Run buddi service install.');
+    }
+    else if (service.state === 'stopped')
+        lines.push(`The service is not running: ${service.detail}. Run buddi service start.`);
+    else
+        lines.push(`The service could not be read: ${service.detail}`);
+    lines.push(report.database.reachable
+        ? 'The database is reachable.'
+        : `The database is not reachable: ${report.database.error ?? 'no reason given'}`);
+    const { ready, unavailable, error } = report.agents;
+    if (error !== undefined)
+        lines.push(`The agents could not be read: ${error}`);
+    else {
+        if (ready.length === 0)
+            lines.push('No agent can run yet.');
+        else
+            lines.push(`${count(ready.length, 'agent can', 'agents can')} run: ${ready.map((a) => `@${a.handle}`).join(', ')}.`);
+        for (const agent of unavailable)
+            lines.push(`@${agent.handle} cannot run: ${agent.reason.replace(/\.$/, '')}.`);
+    }
+    if (report.needsYou === null) {
+        lines.push(report.database.reachable ? 'What needs you could not be read.' : 'What needs you is unknown without the database.');
+    }
+    else {
+        const { approvals, questions } = report.needsYou;
+        if (approvals + questions === 0)
+            lines.push('Nothing needs you.');
+        else {
+            const parts = [
+                ...(approvals > 0 ? [count(approvals, 'approval', 'approvals')] : []),
+                ...(questions > 0 ? [count(questions, 'question', 'questions')] : []),
+            ];
+            lines.push(`${parts.join(' and ')} ${approvals + questions === 1 ? 'needs' : 'need'} you. Open the dashboard with buddi.`);
+        }
+    }
+    if (report.lastRecapAt !== null) {
+        lines.push(`The last recap went out ${localDateTimeString(new Date(report.lastRecapAt), timezone)}.`);
+    }
+    if (report.update.available && report.update.latest) {
+        lines.push(`A newer buddi is available: ${report.update.latest}. Run buddi upgrade.`);
+    }
+    return lines.join('\n');
+}
+/** When a process started, as `ps` says it; undefined when it cannot. */
+export async function startedAt(pid) {
+    try {
+        const { stdout } = await exec('ps', ['-o', 'lstart=', '-p', String(pid)], { timeout: 3_000 });
+        const text = stdout.trim().replace(/\s+/g, ' ');
+        return text === '' ? undefined : text;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The supervisor's control socket, beside the data it looks after. */
+export function supervisorSocketPath(dataDir) {
+    return path.join(dataDir, 'supervisor.sock');
+}
+//# sourceMappingURL=status.js.map

package/node_modules/@buddi/cli/dist/status.js.map

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

package/node_modules/@buddi/cli/dist/style.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Colour for the binary's own output: only on a terminal, never with
+ * `NO_COLOR` set (at all, even empty, as the convention says).
+ */
+import type { HelpStyle } from './commands.js';
+export interface OutputStream {
+    isTTY?: boolean;
+}
+export declare function colorOn(env?: NodeJS.ProcessEnv, stream?: OutputStream): boolean;
+export declare const bold: (text: string, on: boolean) => string;
+export declare const dim: (text: string, on: boolean) => string;
+export declare function helpStyle(on: boolean): HelpStyle;
+//# sourceMappingURL=style.d.ts.map

package/node_modules/@buddi/cli/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,OAAO,CACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,MAAM,GAAE,YAA6B,GACpC,OAAO,CAET;AAKD,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,IAAI,OAAO,KAAG,MAAmC,CAAC;AACrF,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,EAAE,IAAI,OAAO,KAAG,MAAmC,CAAC;AAEpF,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,SAAS,CAEhD"}

package/node_modules/@buddi/cli/dist/style.js

@@ -0,0 +1,10 @@
+export function colorOn(env = process.env, stream = process.stdout) {
+    return stream.isTTY === true && env.NO_COLOR === undefined;
+}
+const wrap = (open, close, text, on) => on ? `\u001b[${open}m${text}\u001b[${close}m` : text;
+export const bold = (text, on) => wrap('1', '22', text, on);
+export const dim = (text, on) => wrap('2', '22', text, on);
+export function helpStyle(on) {
+    return { bold: (t) => bold(t, on), dim: (t) => dim(t, on) };
+}
+//# sourceMappingURL=style.js.map

package/node_modules/@buddi/cli/dist/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,OAAO,CACrB,MAAyB,OAAO,CAAC,GAAG,EACpC,SAAuB,OAAO,CAAC,MAAM;IAErC,OAAO,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC;AAC7D,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,IAAY,EAAE,EAAW,EAAU,EAAE,CAC9E,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,IAAI,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAEvD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAW,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAW,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AAEpF,MAAM,UAAU,SAAS,CAAC,EAAW;IACnC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC9D,CAAC"}

package/node_modules/@buddi/cli/dist/telegram-cmd.d.ts

@@ -12,5 +12,5 @@ export declare const PAIRING_TTL_MINUTES = 10;
  */
 export declare function relativeTime(at: Date | null | undefined, now?: Date): string;
 export declare function renderQr(text: string): Promise<string>;
-export declare function runTelegram(action: TelegramAction, deviceId: string | undefined, env?: NodeJS.ProcessEnv): Promise<number>;
+export declare function runTelegram(action: TelegramAction, deviceId: string | undefined, env?: NodeJS.ProcessEnv, json?: boolean): Promise<number>;
 //# sourceMappingURL=telegram-cmd.d.ts.map

package/node_modules/@buddi/cli/dist/telegram-cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telegram-cmd.d.ts","sourceRoot":"","sources":["../src/telegram-cmd.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAMhD,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAUtC;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAQxF;AAMD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAItD;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,MAAM,CAAC,CA6DjB"}
+{"version":3,"file":"telegram-cmd.d.ts","sourceRoot":"","sources":["../src/telegram-cmd.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAOhD,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAUtC;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAQxF;AAMD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAItD;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,UAAQ,GACX,OAAO,CAAC,MAAM,CAAC,CAmFjB"}

package/node_modules/@buddi/cli/dist/telegram-cmd.js

@@ -13,9 +13,10 @@
 import { createPool, localDateTimeString, timezoneFromEnv } from '@buddi/core';
 import { createPairingCode, listDevices, unpairDevice } from '@buddi/gateway';
 import qrcode from 'qrcode-terminal';
-const ESC = '\u001b[';
-const dim = (s) => `${ESC}2m${s}${ESC}0m`;
-const bold = (s) => `${ESC}1m${s}${ESC}0m`;
+import { bold as boldOn, colorOn, dim as dimOn } from './style.js';
+const color = colorOn();
+const dim = (s) => dimOn(s, color);
+const bold = (s) => boldOn(s, color);
 /** How long a pairing code is worth anything. Short: it is shown, then used. */
 export const PAIRING_TTL_MINUTES = 10;
 /* ------------------------------------------------------------------ *
@@ -55,15 +56,19 @@ export function renderQr(text) {
         qrcode.generate(text, { small: true }, (rendered) => resolve(rendered));
     });
 }
-export async function runTelegram(action, deviceId, env = process.env) {
+export async function runTelegram(action, deviceId, env = process.env, json = false) {
     const databaseUrl = env.DATABASE_URL;
     if (!databaseUrl) {
-        console.error('DATABASE_URL is not set — run `buddi init`');
-        return 1;
+        console.error('DATABASE_URL is not set, so there is no database to read.');
+        return 3;
     }
     const pool = createPool(databaseUrl);
     try {
         if (action === 'pair') {
+            if ((env.TELEGRAM_BOT_TOKEN ?? '').trim() === '') {
+                console.error('No Telegram bot is configured. Set its token with buddi vault set TELEGRAM_BOT_TOKEN, then pair again.');
+                return 3;
+            }
             const { code, deepLink, expiresAt } = await createPairingCode(pool, {
                 ttlMinutes: PAIRING_TTL_MINUTES,
                 env,
@@ -79,6 +84,18 @@ export async function runTelegram(action, deviceId, env = process.env) {
         }
         if (action === 'devices') {
             const devices = await listDevices(pool);
+            if (json) {
+                console.log(JSON.stringify(devices.map((d) => ({
+                    id: d.id,
+                    surface: d.surface,
+                    label: d.label,
+                    externalUserId: d.externalUserId,
+                    externalChatId: d.externalChatId,
+                    pairedAt: d.pairedAt?.toISOString() ?? null,
+                    lastSeenAt: d.lastSeenAt?.toISOString() ?? null,
+                })), null, 2));
+                return 0;
+            }
             if (devices.length === 0) {
                 console.log('no paired devices — run `buddi telegram pair`');
                 return 0;

package/node_modules/@buddi/cli/dist/telegram-cmd.js.map

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

package/node_modules/@buddi/cli/dist/vault-cmd.js

@@ -2,9 +2,9 @@
  * `buddi vault set | get | delete | list | import-env`.
  *
  * The vault is the OS keychain (or, off macOS, a file encrypted with a key held
- * outside the database). ARCHITECTURE.md is blunt about why there is no table:
- * *«A secrets table would hand mail and model credentials to anyone with the
- * database file.»*
+ * outside the database). docs/architecture.md ("Secrets and operations") is
+ * blunt about why there is no table: *«A secrets table would hand mail and
+ * model credentials to anyone with the database file.»*
  *
  * Two rules shape every command here:
  *