@opendatalabs/connect 0.9.2 → 0.9.4-canary.888d13a

package/dist/cli/index.d.ts

@@ -40,6 +40,8 @@ export declare function buildDataListNextSteps(datasetRecords: Array<{
     authMode?: "automated" | "interactive" | "legacy";
 }>): string[];
 export declare function buildDataShowNextSteps(source: string, datasetCount: number, sourceLabels?: SourceLabelMap): string[];
+/** Derive a human-readable message from a stored `connectionHealthReason`. */
+export declare function formatHealthMessage(reason: string | undefined): string | null;
 export declare function getCliVersion(): string;
 export declare function getCliChannel(version?: string): "stable" | "canary";
 export declare function getCliInstallMethod(execPath?: string): CliInstallMethod;

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAuCA,OAAO,EAQL,YAAY,EAIb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,UAAU,EAEV,gBAAgB,EAEhB,SAAS,EACT,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAyCjE,UAAU,cAAc;IACtB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,UAAU,iBAAiB;IACzB,CAAC,MAAM,EAAE,MAAM,GAAG;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;KACnD,CAAC;CACH;AA2BD,KAAK,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAehF,wBAAsB,MAAM,CAAC,IAAI,WAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA8ejE;AA2wCD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWpD;AAkgCD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,cAAmB,GAC1B,MAAM,CAER;AAkBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKrD;AAkCD,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,CACnB,MAAM,EACN,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAC5D,EACD,QAAQ,GAAE,iBAAsB,GAC/B,OAAO,CAAC,YAAY,EAAE,CAAC,CAkEzB;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAC1D,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CACxC,CAyBA;AAsLD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EAAE,EACvB,YAAY,GAAE,cAAmB,EACjC,OAAO,GAAE,SAAS,CAAC,SAAS,CAAe,EAC3C,gBAAgB,GAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAM,GAC5E,MAAM,EAAE,CAsGV;AAED,wBAAgB,qBAAqB,CACnC,iBAAiB,EACb;IACE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;CACnD,GACD,IAAI,GACJ,SAAS,EACb,cAAc,EAAE,MAAM,GACrB,MAAM,EAAE,CAgBV;AAED,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,KAAK,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC,EACF,eAAe,EAAE,KAAK,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;CACnD,CAAC,GACD,MAAM,EAAE,CAmBV;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,YAAY,GAAE,cAAmB,GAChC,MAAM,EAAE,CAQV;AAmCD,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAqB7E;AA2CD,wBAAgB,aAAa,IAAI,MAAM,CA2BtC;AAED,wBAAgB,aAAa,CAAC,OAAO,SAAkB,GAAG,QAAQ,GAAG,QAAQ,CAc5E;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,SAAmB,GAC1B,gBAAgB,CA+BlB;AAMD,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,gBAAgB,EAC/B,QAAQ,SAAmB,GAC1B,MAAM,GAAG,IAAI,CAQf;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAWzE;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,gBAAgB,EAC/B,OAAO,EAAE,UAAU,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAoCxC;AAaD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC3C,cAAc,CAEhB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,KAAK,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;CACnD,CAAC,GACD,iBAAiB,CAYnB;AAID,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;CAClB,CAqDA;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,UAAU,CAQxE;AAqED,wBAAsB,mBAAmB,+BAQxC;AAYD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,YAAY,GAClB,MAAM,CAgBR;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA0B7D;AAeD,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CAOrC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAoD5B;AA6BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE;IACJ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB,EACD,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB,GACA,MAAM,CAaR;AAsBD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,GACtD,OAAO,CAMT"}

package/dist/cli/index.js

@@ -33,7 +33,7 @@ import { detectPersonalServerTarget, ingestResult, } from "../personal-server/in
 import { findDataConnectorsDir, ManagedPlaywrightRuntime, } from "../runtime/index.js";
 import { listAvailableSkills, installSkill, readInstalledSkills, } from "../skills/index.js";
 import { queryStatus, querySources, queryDataList, queryDataShow, queryDoctor, } from "./queries.js";
-import { readUpdateCheck, isNewerVersion, spawnUpdateCheck, } from "./update-check.js";
+import { checkForUpdate, readUpdateCheck, isNewerVersion, } from "./update-check.js";
 function cleanDescription(desc) {
     return desc
         .replace(/ using Playwright browser automation\.?/i, ".")
@@ -51,6 +51,7 @@ export async function runCli(argv = process.argv) {
     }
     const parsedOptions = extractGlobalOptions(normalizedArgv);
     const cliVersion = getCliVersion();
+    const installMethod = getCliInstallMethod();
     // Non-blocking update check — compute suppression flags early
     const shouldNotify = !parsedOptions.json &&
         process.stdout.isTTY &&
@@ -58,23 +59,12 @@ export async function runCli(argv = process.argv) {
         !process.env.CI &&
         !process.env.AGENT &&
         !process.env.VANA_DETACHED;
-    let updateNotice;
-    if (shouldNotify) {
-        try {
-            const cached = await readUpdateCheck();
-            if (cached && isNewerVersion(cliVersion, cached.latestVersion)) {
-                const lifecycle = getLifecycleCommands(getCliInstallMethod(), getCliChannel());
-                updateNotice = `\nUpdate available: ${cliVersion} → ${cached.latestVersion}\nRun: ${lifecycle.upgrade}\n`;
-            }
-            else if (!cached) {
-                // Cache missing or expired — spawn background check
-                spawnUpdateCheck(cliVersion, getCliInstallMethod());
-            }
-        }
-        catch {
-            // Suppress all errors — update check is purely informational
-        }
-    }
+    // Fire update check concurrently — no await, runs in the background.
+    // If it finishes before the command completes, the cache is written and
+    // the SAME run can read it for the notification below.
+    const updateCheckPromise = shouldNotify
+        ? checkForUpdate(cliVersion, installMethod).catch(() => { })
+        : undefined;
     const program = new Command();
     program
         .name("vana")
@@ -415,29 +405,41 @@ Examples:
         process.exitCode = await runScheduleRemove(parsedOptions);
     });
     try {
-        try {
-            await program.parseAsync(normalizedArgv);
-        }
-        catch (error) {
-            if (error instanceof CommanderError) {
-                if (error.code === "commander.help" ||
-                    error.code === "commander.helpDisplayed" ||
-                    error.code === "commander.version") {
-                    process.exitCode = error.exitCode;
-                    return Number(process.exitCode ?? 0);
-                }
-                // Commander already printed to stderr; just set exit code.
+        await program.parseAsync(normalizedArgv);
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            if (error.code === "commander.help" ||
+                error.code === "commander.helpDisplayed" ||
+                error.code === "commander.version") {
                 process.exitCode = error.exitCode;
-                return Number(process.exitCode ?? 1);
+                return Number(process.exitCode ?? 0);
             }
-            throw error;
+            // Commander already printed to stderr; just set exit code.
+            process.exitCode = error.exitCode;
+            return Number(process.exitCode ?? 1);
         }
-        return Number(process.exitCode ?? 0);
+        throw error;
     }
-    finally {
-        if (updateNotice)
-            process.stderr.write(updateNotice);
+    // Show update notification if a newer version is available.
+    // The concurrent check may have populated the cache during this run.
+    if (shouldNotify) {
+        try {
+            await Promise.race([
+                updateCheckPromise,
+                new Promise((resolve) => setTimeout(resolve, 2000)),
+            ]);
+            const cache = await readUpdateCheck();
+            if (cache && isNewerVersion(cliVersion, cache.latestVersion)) {
+                const { upgrade } = getLifecycleCommands(installMethod, getCliChannel(cliVersion));
+                process.stderr.write(`\nUpdate available: ${cliVersion} → ${cache.latestVersion}\nRun: ${upgrade}\n`);
+            }
+        }
+        catch {
+            // Never block exit for update notification failures
+        }
     }
+    return Number(process.exitCode ?? 0);
 }
 async function runConnect(rawSource, options) {
     const source = rawSource.toLowerCase();
@@ -450,7 +452,7 @@ async function runConnect(rawSource, options) {
     let setupLogPath;
     let fetchLogPath;
     let runLogPath;
-    let terminalExitCode = null;
+    let pendingExitCode = null;
     try {
         // Title
         renderer?.title(displayName);
@@ -688,7 +690,7 @@ async function runConnect(rawSource, options) {
             if (event.logPath) {
                 runLogPath = event.logPath;
             }
-            if (terminalExitCode !== null) {
+            if (pendingExitCode !== null && event.type !== "collection-complete") {
                 continue;
             }
             if (event.type === "needs-input") {
@@ -698,6 +700,9 @@ async function runConnect(rawSource, options) {
                     lastError: event.message ?? "Input required.",
                     lastLogPath: event.logPath,
                     connectionHealth: "needs_reauth",
+                    connectionHealthChangedAt: new Date().toISOString(),
+                    connectionHealthReason: `needs-input: ${event.message ?? "Input required."}`,
+                    connectionHealthRetryable: false,
                 });
                 emit.event({
                     type: "outcome",
@@ -705,8 +710,7 @@ async function runConnect(rawSource, options) {
                     source: resolution.source,
                 });
                 renderer?.fail(`${displayName} needs credentials. Run without --no-input to authenticate.`);
-                terminalExitCode = 1;
-                continue;
+                pendingExitCode = 1;
             }
             if (event.type === "progress-update") {
                 // Drive the renderer with scope information from the event
@@ -735,6 +739,9 @@ async function runConnect(rawSource, options) {
                     lastError: event.message ?? "Connector run failed.",
                     lastLogPath: event.logPath,
                     connectionHealth: "error",
+                    connectionHealthChangedAt: new Date().toISOString(),
+                    connectionHealthReason: `runtime-error: ${event.message ?? "Connector run failed."}`,
+                    connectionHealthRetryable: /timeout|ECONNREFUSED|ENOTFOUND|rate.?limit|50[234]|socket hang up/i.test(event.message ?? ""),
                 });
                 renderer?.fail(`Problem connecting ${displayName}.`);
                 renderer?.detail(event.message ?? "Connector run failed.");
@@ -744,7 +751,7 @@ async function runConnect(rawSource, options) {
                     status: CliOutcomeStatus.RUNTIME_ERROR,
                     source: resolution.source,
                 });
-                terminalExitCode = 1;
+                pendingExitCode = 1;
                 continue;
             }
             if (event.type === "headed-required") {
@@ -760,6 +767,9 @@ async function runConnect(rawSource, options) {
                     lastResultPath: null,
                     lastLogPath: event.logPath,
                     connectionHealth: "needs_reauth",
+                    connectionHealthChangedAt: new Date().toISOString(),
+                    connectionHealthReason: `legacy-auth: ${event.message ?? "Legacy authentication is required."}`,
+                    connectionHealthRetryable: false,
                 });
                 renderer?.fail(`Manual step required for ${displayName}.`);
                 renderer?.detail(`Complete the browser step locally, then rerun vana connect ${source}.`);
@@ -768,8 +778,7 @@ async function runConnect(rawSource, options) {
                     status: CliOutcomeStatus.LEGACY_AUTH,
                     source: resolution.source,
                 });
-                terminalExitCode = 1;
-                continue;
+                pendingExitCode = 1;
             }
             if (event.type === "collection-complete" && event.resultPath) {
                 // Check if the result is actually an error object
@@ -781,13 +790,17 @@ async function runConnect(rawSource, options) {
                         "error" in parsed &&
                         Object.keys(parsed).length <= 2) {
                         // Connector returned an error, not real data
+                        const errorMsg = typeof parsed.error === "string"
+                            ? parsed.error
+                            : "Collection returned an error";
                         await updateSourceState(source, {
                             lastRunAt: new Date().toISOString(),
                             lastRunOutcome: CliOutcomeStatus.RUNTIME_ERROR,
                             connectionHealth: "error",
-                            lastError: typeof parsed.error === "string"
-                                ? parsed.error
-                                : "Collection returned an error",
+                            connectionHealthChangedAt: new Date().toISOString(),
+                            connectionHealthReason: `error-result: ${errorMsg}`,
+                            connectionHealthRetryable: false,
+                            lastError: errorMsg,
                             lastLogPath: runLogPath ?? fetchLogPath,
                         });
                         renderer?.fail(`Problem connecting ${displayName}.`);
@@ -799,12 +812,15 @@ async function runConnect(rawSource, options) {
                             status: CliOutcomeStatus.RUNTIME_ERROR,
                             source,
                         });
-                        terminalExitCode = 1;
+                        pendingExitCode = 1;
                         continue;
                     }
                 }
-                catch {
-                    // Can't read/parse result — proceed normally, let downstream handle it
+                catch (parseError) {
+                    const msg = parseError instanceof Error ? parseError.message : "Unknown error";
+                    await updateSourceState(source, {
+                        lastError: `Failed to parse result file (${event.resultPath}): ${msg}`,
+                    });
                 }
                 collectedResult = true;
                 resultPath = event.resultPath;
@@ -845,8 +861,8 @@ async function runConnect(rawSource, options) {
                 }));
             }
         }
-        if (terminalExitCode !== null) {
-            return terminalExitCode;
+        if (pendingExitCode !== null && !collectedResult) {
+            return pendingExitCode;
         }
         if (!collectedResult) {
             await updateSourceState(resolution.source, {
@@ -881,7 +897,10 @@ async function runConnect(rawSource, options) {
             lastError: ingestFailureMessage,
             lastResultPath: resultPath,
             lastLogPath: runLogPath ?? fetchLogPath ?? setupLogPath ?? null,
-            connectionHealth: "healthy",
+            connectionHealth: pendingExitCode !== null ? undefined : "healthy",
+            connectionHealthChangedAt: pendingExitCode !== null ? undefined : new Date().toISOString(),
+            connectionHealthReason: pendingExitCode !== null ? undefined : "collection-complete",
+            connectionHealthRetryable: undefined,
             ingestScopes: ingestScopeResults,
         });
         // Build scope-aware success summary
@@ -904,6 +923,8 @@ async function runConnect(rawSource, options) {
         else {
             successSummary = `Collected your ${displayName} data and saved it locally.`;
         }
+        // Auto-schedule collection if no schedule exists (non-blocking)
+        await maybeAutoSchedule(emit, options).catch(() => { });
         // --- Phase 7: Success summary ---
         renderer?.success(`Connected ${displayName}.`);
         renderer?.detail(successSummary);
@@ -941,9 +962,9 @@ async function runConnect(rawSource, options) {
             source: resolution.source,
             resultPath,
         });
-        // Auto-schedule collection if no schedule exists (non-blocking).
-        // Runs after renderer is done to avoid cursor collision.
-        await maybeAutoSchedule(options).catch(() => { });
+        if (pendingExitCode !== null) {
+            return pendingExitCode;
+        }
         return 0;
     }
     catch (error) {
@@ -1120,7 +1141,12 @@ async function runStatus(options) {
         if (stored) {
             sourceHealthMap[sourceId] = {
                 connectionHealth: stored.connectionHealth,
+                connectionHealthChangedAt: stored.connectionHealthChangedAt,
+                connectionHealthReason: stored.connectionHealthReason,
+                connectionHealthRetryable: stored.connectionHealthRetryable,
                 lastCollectedAt: stored.lastCollectedAt,
+                lastLogPath: stored.lastLogPath,
+                lastError: stored.lastError,
             };
         }
     }
@@ -1187,6 +1213,16 @@ async function runStatus(options) {
                 ? `collected ${formatRelativeTime(stored.lastCollectedAt)}`
                 : "";
             emit.keyValue(`  ${displayName}`, `${healthLabel}${staleTag}     ${collectedAgo}`, healthTone);
+            if ((health === "needs_reauth" || health === "error") &&
+                stored?.connectionHealthReason) {
+                const msg = formatHealthMessage(stored.connectionHealthReason);
+                const ago = stored.connectionHealthChangedAt
+                    ? ` (${formatRelativeTime(stored.connectionHealthChangedAt)})`
+                    : "";
+                if (msg) {
+                    emit.detail(`  \u21b3 ${msg}${ago} Run \`vana connect ${sourceId}\``);
+                }
+            }
             if (health === "needs_reauth" && !needsReauthSource) {
                 needsReauthSource = sourceId;
             }
@@ -2038,14 +2074,16 @@ async function runServerData(scope, options) {
     }
     // If PS is available, try to list remote scopes via client
     let remoteScopes = [];
+    let remoteScopeFallbackReason;
     if (target.state === "available" && target.url) {
         try {
             const { createPersonalServerClient: createClient } = await import("../personal-server/client.js");
             const client = createClient({ url: target.url });
             remoteScopes = await client.listScopes(scope);
         }
-        catch {
-            // Auth required or PS unavailable — fall back to local
+        catch (err) {
+            remoteScopeFallbackReason =
+                err instanceof Error ? err.message : "unknown error";
         }
     }
     // Use remote scopes if available, otherwise fall back to local
@@ -2063,6 +2101,7 @@ async function runServerData(scope, options) {
             count: scopeList.length,
             scopes: scopeList,
             source: remoteScopes.length > 0 ? "remote" : "local",
+            ...(remoteScopeFallbackReason ? { remoteScopeFallbackReason } : {}),
         })}\n`);
         return 0;
     }
@@ -2321,6 +2360,10 @@ export async function gatherSourceStatuses(storedSources, metadata = {}) {
             connectorVersion: stored.connectorVersion,
             exportFrequency: stored.exportFrequency,
             lastCollectedAt: stored.lastCollectedAt,
+            connectionHealth: stored.connectionHealth,
+            connectionHealthChangedAt: stored.connectionHealthChangedAt,
+            connectionHealthReason: stored.connectionHealthReason,
+            connectionHealthRetryable: stored.connectionHealthRetryable,
             installed,
             sessionPresent: stored.sessionPresent ?? false,
             lastRunAt: stored.lastRunAt ?? null,
@@ -2472,6 +2515,14 @@ function formatSourceStatusDetails(source) {
             tone: "muted",
         });
     }
+    if (source.connectionHealthReason && source.connectionHealth !== "healthy") {
+        details.push({
+            kind: "row",
+            label: "Cause",
+            value: source.connectionHealthReason,
+            tone: "muted",
+        });
+    }
     if (source.lastRunAt) {
         details.push({
             kind: "row",
@@ -2632,6 +2683,28 @@ function buildLogsNextSteps(records) {
         "Check overall status with `vana status`.",
     ];
 }
+/** Derive a human-readable message from a stored `connectionHealthReason`. */
+export function formatHealthMessage(reason) {
+    if (!reason)
+        return null;
+    const colonIndex = reason.indexOf(": ");
+    const prefix = colonIndex > 0 ? reason.slice(0, colonIndex) : reason;
+    const detail = colonIndex > 0 ? reason.slice(colonIndex + 2).replace(/\.$/, "") : "";
+    switch (prefix) {
+        case "needs-input":
+            return `Requires interactive login${detail ? `: ${detail}` : ""}.`;
+        case "legacy-auth":
+            return `Needed a browser window${detail ? `: ${detail}` : ""}. Reconnect interactively.`;
+        case "runtime-error":
+            return `Collection failed${detail ? ` — ${detail}` : ""}.`;
+        case "error-result":
+            return `Connector returned an error${detail ? `: ${detail}` : ""}.`;
+        case "collection-complete":
+            return null; // No message needed for healthy state
+        default:
+            return reason; // Graceful fallback for unknown prefixes
+    }
+}
 /** Extract a `vana ...` command from a next-step sentence wrapped in backticks. */
 function extractCommand(sentence) {
     const match = sentence.match(/`(vana\s[^`]+)`/);
@@ -3280,7 +3353,7 @@ async function getExistingScheduleInterval() {
     }
     return null;
 }
-async function maybeAutoSchedule(options) {
+async function maybeAutoSchedule(emit, options) {
     // Skip if --no-input (detached/agent context shouldn't create schedules)
     if (options.noInput)
         return;
@@ -3291,6 +3364,7 @@ async function maybeAutoSchedule(options) {
     if (existing !== null)
         return; // Schedule already exists
     await runScheduleAdd("daily", { json: false, quiet: true });
+    emit.detail("Auto-scheduled daily collection.");
 }
 function generateLaunchdPlist(vanaBinary, intervalSeconds) {
     const logsPath = path.join(getLogsDir(), "schedule.log");