vana-cli 0.23.9 → 0.23.11

package/README.md

@@ -304,7 +304,7 @@ Make sure your HTML includes `<link rel="manifest" href="/manifest.json">`.
 ## Connectors
 
 Available data connectors and their scopes (schema definitions):
-[`vana-com/data-connectors/schemas`](https://github.com/vana-com/data-connectors/tree/main/schemas)
+[`PDP-Connect/data-connectors/schemas`](https://github.com/PDP-Connect/data-connectors/tree/main/schemas)
 
 ## API Reference
 

package/dist/cli/index.d.ts

@@ -1,3 +1,4 @@
+import type { ConnectRenderer } from "./render/connect-renderer.js";
 import { readCliState } from "../core/index.js";
 import type { CliChannel, CliInstallMethod, CliStatus, SourceStatus } from "../core/cli-types.js";
 import type { AvailableSource } from "../connectors/registry.js";
@@ -14,6 +15,7 @@ interface SourceMetadataMap {
 }
 type RenderTone = "accent" | "success" | "warning" | "error" | "muted" | "info";
 export declare function runCli(argv?: string[]): Promise<number>;
+export declare function withPhaseProgress<T>(renderer: ConnectRenderer | null, label: string, work: () => Promise<T>, delayMs?: number): Promise<T>;
 export declare function formatUptime(seconds: number): string;
 export declare function displaySource(source: string, labels?: SourceLabelMap): string;
 export declare function humanizeIssue(message: string): string;
@@ -88,5 +90,19 @@ export declare function compareDatasetOrder(left: {
     source: string;
 }): number;
 export declare function hasCollectedData(dataState: SourceStatus["dataState"] | null | undefined): boolean;
+export declare class ScheduleTargetUnstableError extends Error {
+}
+/**
+ * The argv a scheduler should run, every element an absolute path.
+ *
+ * launchd, cron and Task Scheduler inherit none of the shell's PATH, so the
+ * `vana` on `$PATH` is the wrong answer twice over: under npm it is a shim
+ * whose `#!/usr/bin/env node` shebang cannot find a version-managed node,
+ * and the scheduler only reports it as `env: node: No such file or
+ * directory`. Naming the interpreter and the script outright removes the
+ * lookup entirely.
+ */
+export declare function resolveScheduledCommand(installMethod?: CliInstallMethod, execPath?: string, entryScript?: string): string[];
+export declare function generateLaunchdPlist(vanaCommand: string[], intervalSeconds: number): string;
 export {};
 //# sourceMappingURL=index.d.ts.map

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":"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"}

package/dist/cli/index.js

@@ -753,6 +753,54 @@ async function runTelemetryDisable(options) {
     emit.success("Telemetry disabled.");
     return 0;
 }
+/**
+ * How long a phase may stay silent before it gets a spinner.
+ *
+ * Connect is deliberately quiet when everything is warm, so a line appears
+ * only once a phase outlives this. Past it the terminal would otherwise sit
+ * blank while the CLI waits on the network, on Chromium, or on a page load.
+ */
+const PHASE_PROGRESS_DELAY_MS = 400;
+function startPhaseProgress(renderer, label, delayMs = PHASE_PROGRESS_DELAY_MS) {
+    if (!renderer) {
+        return { settle() { }, abandon() { } };
+    }
+    let drawn = false;
+    let finished = false;
+    const timer = setTimeout(() => {
+        drawn = true;
+        renderer.scopeActive(label);
+    }, delayMs);
+    timer.unref?.();
+    return {
+        settle() {
+            if (finished)
+                return;
+            finished = true;
+            clearTimeout(timer);
+            if (drawn)
+                renderer.scopeDone(label);
+        },
+        abandon() {
+            if (finished)
+                return;
+            finished = true;
+            clearTimeout(timer);
+        },
+    };
+}
+export async function withPhaseProgress(renderer, label, work, delayMs = PHASE_PROGRESS_DELAY_MS) {
+    const progress = startPhaseProgress(renderer, label, delayMs);
+    try {
+        const result = await work();
+        progress.settle();
+        return result;
+    }
+    catch (error) {
+        progress.abandon();
+        throw error;
+    }
+}
 async function runConnect(rawSource, options) {
     const source = rawSource.toLowerCase();
     const runtime = new ManagedPlaywrightRuntime();
@@ -768,7 +816,7 @@ async function runConnect(rawSource, options) {
     try {
         // Title
         renderer?.title(displayName);
-        const target = await detectPersonalServerTarget();
+        const target = await withPhaseProgress(renderer, "Finding your Personal Server", () => detectPersonalServerTarget());
         // --- Phase 1: Runtime check (silent if installed) ---
         if (runtime.state !== "installed") {
             if (options.noInput) {
@@ -809,7 +857,7 @@ async function runConnect(rawSource, options) {
             trackActiveTelemetryEvent("runtime_install_started", { source });
             let installResult;
             try {
-                installResult = await runtime.ensureInstalled(Boolean(options.yes));
+                installResult = await withPhaseProgress(renderer, "Installing browser engine (one time, ~150MB)", () => runtime.ensureInstalled(Boolean(options.yes)));
             }
             catch (error) {
                 trackActiveTelemetryEvent("runtime_install_failed", {
@@ -824,7 +872,6 @@ async function runConnect(rawSource, options) {
                 runtime: installResult.runtime,
                 logPath: installResult.logPath,
             });
-            renderer?.scopeDone("Runtime ready");
         }
         else {
             emit.event({
@@ -837,7 +884,7 @@ async function runConnect(rawSource, options) {
         const currentVersion = preState.sources[source]?.connectorVersion;
         let fetched;
         try {
-            fetched = await runtime.fetchConnector(source, currentVersion);
+            fetched = await withPhaseProgress(renderer, `Getting the ${displayName} connector`, () => runtime.fetchConnector(source, currentVersion));
         }
         catch (firstError) {
             const firstMessage = firstError instanceof Error ? firstError.message : "";
@@ -850,7 +897,7 @@ async function runConnect(rawSource, options) {
                     const cacheDir = getConnectorCacheDir();
                     const sourceCacheDir = path.join(cacheDir, source);
                     await fsp.rm(sourceCacheDir, { recursive: true, force: true });
-                    const resolution = await fetchConnectorToCache(source, cacheDir, undefined);
+                    const resolution = await withPhaseProgress(renderer, "Cached connector looks stale, downloading a fresh one", () => fetchConnectorToCache(source, cacheDir, undefined));
                     fetched = {
                         connectorPath: resolution.connectorPath,
                         logPath: "",
@@ -870,7 +917,8 @@ async function runConnect(rawSource, options) {
                         lastLogPath: getErrorLogPath(retryError),
                     });
                     renderer?.fail(`${displayName} connector could not be verified.`);
-                    renderer?.detail(`Try again later, or report: https://github.com/vana-com/data-connectors/issues`);
+                    renderer?.detail(message);
+                    renderer?.detail(`Try again later, or report: https://github.com/PDP-Connect/data-connectors/issues`);
                     emit.event({
                         type: "outcome",
                         status: CliOutcomeStatus.CONNECTOR_UNAVAILABLE,
@@ -967,12 +1015,17 @@ async function runConnect(rawSource, options) {
         let collectedResult = false;
         let blockedByRequiredInput = false;
         let ingestScopeResults;
+        // Chromium start-up and the first page load happen before a connector
+        // reports anything, which is the longest silent stretch of a warm run.
+        const launchProgress = startPhaseProgress(renderer, `Opening ${displayName} in a browser`);
         // In IPC mode (--ipc), don’t provide an interactive callback.
         // The runtime will write a pending-input file and poll for the
         // response, letting an external agent handle credential collection.
         const interactiveCallback = options.ipc
             ? undefined
             : async (needInput) => {
+                // Settle first: a spinner repaint would overwrite the prompt.
+                launchProgress.settle();
                 renderer?.pauseForPrompt();
                 // Show connector’s prompt message
                 if (renderer) {
@@ -1019,6 +1072,10 @@ async function runConnect(rawSource, options) {
             if (event.logPath) {
                 runLogPath = event.logPath;
             }
+            // status-update draws nothing, so it is not proof the browser is up.
+            if (event.type !== "status-update") {
+                launchProgress.settle();
+            }
             if (pendingExitCode !== null && event.type !== "collection-complete") {
                 continue;
             }
@@ -1157,7 +1214,7 @@ async function runConnect(rawSource, options) {
                 }
                 collectedResult = true;
                 resultPath = event.resultPath;
-                const ingestEvents = await ingestResult(resolution.source, resultPath, target);
+                const ingestEvents = await withPhaseProgress(renderer, "Saving to your Personal Server", () => ingestResult(resolution.source, resultPath, target));
                 for (const ingestEvent of ingestEvents) {
                     emit.event(ingestEvent);
                 }
@@ -1200,6 +1257,7 @@ async function runConnect(rawSource, options) {
                 }));
             }
         }
+        launchProgress.settle();
         if (pendingExitCode !== null && !collectedResult) {
             return pendingExitCode;
         }
@@ -1266,8 +1324,7 @@ 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(() => { });
+        const hasSchedule = (await getExistingScheduleInterval().catch(() => null)) !== null;
         // --- Phase 7: Success summary ---
         renderer?.success(`Connected ${displayName}.`);
         renderer?.detail(successSummary);
@@ -1297,6 +1354,9 @@ async function runConnect(rawSource, options) {
         else {
             renderer?.next(`vana data show ${source}`);
         }
+        if (!hasSchedule) {
+            renderer?.detail("Keep this fresh automatically — run `vana schedule add` to collect on a schedule.");
+        }
         // Suggest skills if not yet installed
         const installedSkills = await readInstalledSkills();
         if (installedSkills.length === 0) {
@@ -4087,6 +4147,15 @@ const LAUNCHD_LABEL = "com.vana.collect";
 const LAUNCHD_PLIST_PATH = path.join(os.homedir(), "Library", "LaunchAgents", `${LAUNCHD_LABEL}.plist`);
 const CRONTAB_MARKER = "# vana-scheduled-collection";
 const WINDOWS_TASK_NAME = "VanaScheduledCollection";
+function escapeXml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+function quoteForShell(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
 function parseIntervalSeconds(interval) {
     const lower = interval.toLowerCase().trim();
     const match = /^(\d+)\s*(h|d|m|w)$/i.exec(lower);
@@ -4116,23 +4185,32 @@ function formatIntervalHuman(seconds) {
         return `${Math.round(seconds / 3600)}h`;
     return `${Math.round(seconds / 86400)}d`;
 }
-function resolveVanaBinaryPath() {
-    // For SEA binaries, process.execPath is the binary itself
-    const installMethod = getCliInstallMethod();
+export class ScheduleTargetUnstableError extends Error {
+}
+/**
+ * The argv a scheduler should run, every element an absolute path.
+ *
+ * launchd, cron and Task Scheduler inherit none of the shell's PATH, so the
+ * `vana` on `$PATH` is the wrong answer twice over: under npm it is a shim
+ * whose `#!/usr/bin/env node` shebang cannot find a version-managed node,
+ * and the scheduler only reports it as `env: node: No such file or
+ * directory`. Naming the interpreter and the script outright removes the
+ * lookup entirely.
+ */
+export function resolveScheduledCommand(installMethod = getCliInstallMethod(), execPath = process.execPath, entryScript = process.argv[1]) {
+    // A SEA binary is its own interpreter; there is no script to pass.
     if (installMethod === "homebrew" || installMethod === "installer") {
-        return process.execPath;
+        return [execPath];
     }
-    // For development, try to find the vana binary via which/where
-    try {
-        const cmd = process.platform === "win32" ? "where vana" : "which vana";
-        const result = execSync(cmd, { encoding: "utf8" }).trim();
-        // `where` on Windows may return multiple lines; take the first
-        return result.split("\n")[0].trim();
+    if (!entryScript || !path.isAbsolute(entryScript)) {
+        throw new ScheduleTargetUnstableError("Could not work out which file to schedule.");
     }
-    catch {
-        // Fall back to process.execPath + argv[1]
-        return `${process.execPath} ${process.argv[1]}`;
+    // npx unpacks into a cache npm is free to evict, so a schedule pointing
+    // there works until it silently does not.
+    if (normalizePathForMatch(entryScript).includes("/_npx/")) {
+        throw new ScheduleTargetUnstableError("This CLI is running from an npx cache, which npm may delete at any time.");
     }
+    return [execPath, entryScript];
 }
 async function getExistingScheduleInterval() {
     if (process.platform === "darwin") {
@@ -4179,28 +4257,11 @@ async function getExistingScheduleInterval() {
     }
     return null;
 }
-async function maybeAutoSchedule(emit, options) {
-    // Skip if --no-input (detached/agent context shouldn't create schedules)
-    if (options.noInput)
-        return;
-    // Skip unsupported platforms
-    if (!["darwin", "linux", "win32"].includes(process.platform))
-        return;
-    const existing = await getExistingScheduleInterval();
-    if (existing !== null)
-        return; // Schedule already exists
-    await runScheduleAdd("daily", { json: false, quiet: true });
-    emit.detail("Auto-scheduled daily collection.");
-}
-function generateLaunchdPlist(vanaBinary, intervalSeconds) {
+export function generateLaunchdPlist(vanaCommand, intervalSeconds) {
     const logsPath = path.join(getLogsDir(), "schedule.log");
-    // Handle the case where vanaBinary might contain a space (node + script)
-    const programArgs = vanaBinary.includes(" ")
-        ? vanaBinary
-            .split(" ")
-            .map((arg) => `    <string>${arg}</string>`)
-            .join("\n")
-        : `    <string>${vanaBinary}</string>`;
+    const programArgs = vanaCommand
+        .map((arg) => `    <string>${escapeXml(arg)}</string>`)
+        .join("\n");
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -4218,31 +4279,43 @@ ${programArgs}
   <key>StartInterval</key>
   <integer>${intervalSeconds}</integer>
   <key>StandardOutPath</key>
-  <string>${logsPath}</string>
+  <string>${escapeXml(logsPath)}</string>
   <key>StandardErrorPath</key>
-  <string>${logsPath}</string>
+  <string>${escapeXml(logsPath)}</string>
   <key>RunAtLoad</key>
   <true/>
 </dict>
 </plist>
 `;
 }
-function generateCrontabEntry(vanaBinary, intervalHours) {
+function generateCrontabEntry(vanaCommand, intervalHours) {
     const logsPath = path.join(getLogsDir(), "schedule.log");
     const hourExpr = intervalHours >= 24 ? "0" : `0`;
     const dayExpr = "*";
     const hourInterval = intervalHours >= 24 ? "0" : intervalHours >= 1 ? `*/${intervalHours}` : "*";
-    return `${hourExpr} ${hourInterval} ${dayExpr} * * ${vanaBinary} collect --all --quiet --no-input >> ${logsPath} 2>&1 ${CRONTAB_MARKER}`;
+    const program = vanaCommand.map((arg) => quoteForShell(arg)).join(" ");
+    return `${hourExpr} ${hourInterval} ${dayExpr} * * ${program} collect --all --quiet --no-input >> ${quoteForShell(logsPath)} 2>&1 ${CRONTAB_MARKER}`;
 }
 async function runScheduleAdd(interval, options) {
     const emit = createEmitter(options);
     const intervalSeconds = parseIntervalSeconds(interval);
     const intervalLabel = formatIntervalHuman(intervalSeconds);
-    const vanaBinary = resolveVanaBinaryPath();
+    let vanaCommand;
+    try {
+        vanaCommand = resolveScheduledCommand();
+    }
+    catch (error) {
+        if (!(error instanceof ScheduleTargetUnstableError)) {
+            throw error;
+        }
+        emit.info(`Cannot schedule collection. ${error.message}`);
+        emit.detail("Install the CLI first (`npm install -g vana-cli`), then run `vana schedule add` from that install.");
+        return 1;
+    }
     await fsp.mkdir(getLogsDir(), { recursive: true });
     if (process.platform === "darwin") {
         // macOS: launchd
-        const plist = generateLaunchdPlist(vanaBinary, intervalSeconds);
+        const plist = generateLaunchdPlist(vanaCommand, intervalSeconds);
         const plistDir = path.dirname(LAUNCHD_PLIST_PATH);
         await fsp.mkdir(plistDir, { recursive: true });
         // Unload existing if present
@@ -4279,7 +4352,7 @@ async function runScheduleAdd(interval, options) {
         // Linux: cron doesn't defer missed jobs (unlike launchd), so we run
         // hourly and let isCollectionDue() filter per-source. This way a
         // missed 2am tick self-heals at 3am instead of waiting 24h.
-        const entry = generateCrontabEntry(vanaBinary, 1);
+        const entry = generateCrontabEntry(vanaCommand, 1);
         try {
             // Read existing crontab, filter out old vana entries, add new one
             let existing = "";
@@ -4321,7 +4394,7 @@ async function runScheduleAdd(interval, options) {
     if (process.platform === "win32") {
         // Windows: Task Scheduler
         const intervalMinutes = Math.max(1, Math.round(intervalSeconds / 60));
-        const trCmd = `\\"${vanaBinary}\\" collect --all --quiet --no-input`;
+        const trCmd = `${vanaCommand.map((arg) => `\\"${arg}\\"`).join(" ")} collect --all --quiet --no-input`;
         try {
             try {
                 execSync(`schtasks /Delete /TN "${WINDOWS_TASK_NAME}" /F 2>nul`, {