opencandle 0.6.0 → 0.8.0

package/dist/monitor.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
-import "./infra/node-version.js";
 import { parseArgs } from "node:util";
 import { loadEnv } from "./config.js";
+import { assertSupportedNodeVersion } from "./infra/node-version.js";
 import { runLocalAutomationHeartbeat } from "./market-state/local-automation-service.js";
 import { MarketStateService } from "./market-state/service.js";
 import { initDefaultDatabase } from "./memory/sqlite.js";
+assertSupportedNodeVersion();
 const DEFAULT_MONITOR_INTERVAL_MS = 60_000;
 const MIN_MONITOR_INTERVAL_MS = 5_000;
 const MONITOR_OWNER_ID = `monitor:${process.pid}`;

package/dist/monitor.js.map

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

package/dist/onboarding/connect.d.ts

@@ -1,5 +1,5 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { type ProviderId } from "./providers.js";
+import { type ApiKeyProviderId, type ProviderId } from "./providers.js";
 export type ConnectResult = {
     status: "connected";
 } | {
@@ -22,7 +22,7 @@ export type ConnectResult = {
  * provider-setup form. Validation is the caller's responsibility — both
  * call sites run `validateCredential` before invoking this helper.
  */
-export declare function persistProviderCredential(providerId: ProviderId, key: string): void;
+export declare function persistProviderCredential(providerId: ApiKeyProviderId, key: string): void;
 /**
  * Run the connect flow for a single provider.
  *

package/dist/onboarding/connect.js

@@ -18,7 +18,7 @@
 // call will surface any lingering issue via the credential-required tag.
 import { loadConfig, loadFileConfig, saveFileConfig, } from "../config.js";
 import { openInBrowser } from "../infra/open-url.js";
-import { getCredentialSource, getProvider } from "./providers.js";
+import { getCredentialSource, getProvider, isApiKeyProvider, } from "./providers.js";
 import { loadOnboardingState, markProviderCompleted, saveOnboardingState } from "./state.js";
 import { validateCredential } from "./validation.js";
 function writeNested(obj, path, value) {
@@ -48,6 +48,9 @@ function writeNested(obj, path, value) {
  */
 export function persistProviderCredential(providerId, key) {
     const descriptor = getProvider(providerId);
+    if (!isApiKeyProvider(descriptor)) {
+        throw new Error(`Provider ${providerId} does not accept API keys`);
+    }
     const existing = loadFileConfig();
     const updated = writeNested(existing, descriptor.configPath, key);
     saveFileConfig(updated);
@@ -66,6 +69,10 @@ export function persistProviderCredential(providerId, key) {
  */
 export async function runProviderConnect(ctx, providerId) {
     const descriptor = getProvider(providerId);
+    if (!isApiKeyProvider(descriptor)) {
+        ctx.ui.notify(`${descriptor.displayName} is not configured with an API key. Run opencandle doctor for setup status.`, "warning");
+        return { status: "cancelled" };
+    }
     // Env-precedence check.
     if (getCredentialSource(providerId) === "env") {
         ctx.ui.notify(`${descriptor.displayName} is currently set via the ${descriptor.envVar} environment variable. ` +
@@ -92,7 +99,7 @@ export async function runProviderConnect(ctx, providerId) {
     // short-circuit here without writing anything; transient failures warn
     // but proceed to persist so users don't get stuck on a provider outage.
     ctx.ui.notify(`Verifying your ${descriptor.displayName} key...`, "info");
-    const validation = await validateCredential(providerId, trimmed);
+    const validation = await validateCredential(descriptor.id, trimmed);
     if (validation.status === "invalid") {
         const statusHint = validation.httpStatus !== undefined ? ` (HTTP ${validation.httpStatus})` : "";
         const messageHint = validation.message ? ` — ${validation.message}` : "";
@@ -109,7 +116,7 @@ export async function runProviderConnect(ctx, providerId) {
             `Saving it anyway — the next request will surface any issue.`, "warning");
         // Fall through to persist.
     }
-    persistProviderCredential(providerId, trimmed);
+    persistProviderCredential(descriptor.id, trimmed);
     ctx.ui.notify(`${descriptor.displayName} connected. Your key has been saved.`, "info");
     return { status: "connected" };
 }

package/dist/onboarding/connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/onboarding/connect.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,uEAAuE;AACvE,4EAA4E;AAC5E,mEAAmE;AACnE,EAAE;AACF,0BAA0B;AAC1B,gFAAgF;AAChF,mDAAmD;AACnD,kDAAkD;AAClD,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,mEAAmE;AACnE,qEAAqE;AACrE,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,yEAAyE;AAGzE,OAAO,EACL,UAAU,EACV,cAAc,EAEd,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAmB,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAQrD,SAAS,WAAW,CAClB,GAA4B,EAC5B,IAAuB,EACvB,KAAa;IAEb,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAClC,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAsB,EAAE,GAAW;IAC3E,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,cAAc,EAAwC,CAAC;IACxE,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,EAAE,GAAG,CAAyB,CAAC;IAC1F,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,UAAU,EAAE,CAAC;IACb,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;IACpC,mBAAmB,CAAC,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAqB,EACrB,UAAsB;IAEtB,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAE3C,wBAAwB;IACxB,IAAI,mBAAmB,CAAC,UAAU,CAAC,KAAK,KAAK,EAAE,CAAC;QAC9C,GAAG,CAAC,EAAE,CAAC,MAAM,CACX,GAAG,UAAU,CAAC,WAAW,6BAA6B,UAAU,CAAC,MAAM,yBAAyB;YAC9F,yEAAyE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,EAAE,IAAI;YACnH,qBAAqB,UAAU,CAAC,MAAM,kCAAkC,EAC1E,SAAS,CACV,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACtC,CAAC;IAED,wEAAwE;IACxE,mEAAmE;IACnE,oDAAoD;IACpD,MAAM,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC1D,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,UAAU,CAAC,WAAW,4BAA4B,EAAE,MAAM,CAAC,CAAC;IAErF,kEAAkE;IAClE,4DAA4D;IAC5D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAC/B,cAAc,UAAU,CAAC,WAAW,UAAU,EAC9C,UAAU,CAAC,gBAAgB,CAC5B,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,2EAA2E;IAC3E,uEAAuE;IACvE,wEAAwE;IACxE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,UAAU,CAAC,WAAW,SAAS,EAAE,MAAM,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEjE,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,UAAU,GACd,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,UAAU,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,EAAE,CAAC,MAAM,CACX,GAAG,UAAU,CAAC,WAAW,oBAAoB,UAAU,GAAG,WAAW,IAAI;YACvE,gEACE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,EACtC,0BAA0B,EAC5B,OAAO,CACR,CAAC;QACF,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,OAAO,EAAE,UAAU,CAAC,OAAO;SAC5B,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACtC,GAAG,CAAC,EAAE,CAAC,MAAM,CACX,kBAAkB,UAAU,CAAC,WAAW,uBAAuB,UAAU,CAAC,MAAM,KAAK;YACnF,6DAA6D,EAC/D,SAAS,CACV,CAAC;QACF,2BAA2B;IAC7B,CAAC;IAED,yBAAyB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAE/C,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,WAAW,sCAAsC,EAAE,MAAM,CAAC,CAAC;IAEvF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC"}
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/onboarding/connect.ts"],"names":[],"mappings":"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"}

package/dist/onboarding/provider-status.d.ts

@@ -0,0 +1,46 @@
+import { type ExternalToolCommandResult } from "../providers/external-tool-command.js";
+import type { ProviderId } from "./providers.js";
+export type CommandResult = ExternalToolCommandResult;
+export type CommandRunner = (command: string, args: readonly string[], options?: {
+    timeoutMs: number;
+}) => Promise<CommandResult>;
+interface ProviderStatusBase {
+    readonly providerId: ProviderId;
+    readonly kind: "api-key" | "external-tool" | "public-http";
+    readonly state: string;
+    readonly checkedAt: string;
+    readonly cacheHit: boolean;
+    readonly message?: string;
+}
+export interface ApiKeyProviderStatus extends ProviderStatusBase {
+    readonly kind: "api-key";
+    readonly state: "configured" | "missing";
+    readonly credentialSource: "env" | "file" | "absent";
+}
+export interface ExternalToolProviderStatus extends ProviderStatusBase {
+    readonly kind: "external-tool";
+    readonly mode: "install" | "session";
+    readonly state: "installed" | "missing" | "session_ok" | "session_missing" | "session_stale" | "skipped" | "error";
+    readonly installCmd?: string;
+}
+export interface PublicHttpProviderStatus extends ProviderStatusBase {
+    readonly kind: "public-http";
+    readonly state: "reachable" | "unreachable" | "error";
+    readonly statusCode?: number;
+}
+export type ProviderStatus = ApiKeyProviderStatus | ExternalToolProviderStatus | PublicHttpProviderStatus;
+export interface ProbeProviderStatusOptions {
+    readonly mode?: "install" | "session";
+    readonly force?: boolean;
+    readonly respectSkipped?: boolean;
+    readonly commandRunner?: CommandRunner;
+    readonly fetchImpl?: typeof fetch;
+    readonly now?: Date;
+}
+export declare function clearProviderStatusCache(): void;
+export declare function probeProviderStatus(providerId: ProviderId, options?: ProbeProviderStatusOptions): Promise<ProviderStatus>;
+export declare function probeAllProviderStatuses(options?: Omit<ProbeProviderStatusOptions, "mode">): Promise<ProviderStatus[]>;
+export declare function formatProviderStatus(status: ProviderStatus): string;
+export declare function redactSensitiveOutput(input: string): string;
+export declare const runCommand: CommandRunner;
+export {};

package/dist/onboarding/provider-status.js

@@ -0,0 +1,256 @@
+import { runExternalToolCommand, } from "../providers/external-tool-command.js";
+import { getCredentialSource, getProvider, isApiKeyProvider, isExternalToolProvider, isPublicHttpProvider, } from "./providers.js";
+import { loadOnboardingState } from "./state.js";
+const STATUS_TTL_MS = 60_000;
+const COMMAND_TIMEOUT_MS = 5_000;
+const PUBLIC_HTTP_TIMEOUT_MS = 3_000;
+const MAX_OUTPUT_CHARS = 32_000;
+const statusCache = new Map();
+export function clearProviderStatusCache() {
+    statusCache.clear();
+}
+export async function probeProviderStatus(providerId, options = {}) {
+    const provider = getProvider(providerId);
+    const mode = isExternalToolProvider(provider) ? (options.mode ?? "install") : "default";
+    const cacheKey = `${providerId}:${mode}`;
+    const now = options.now ?? new Date();
+    const skippedByPreference = isExternalToolProvider(provider) &&
+        loadOnboardingState().providers[providerId]?.status === "never_ask";
+    if (skippedByPreference && (!options.force || options.respectSkipped)) {
+        return {
+            providerId,
+            kind: "external-tool",
+            mode: mode,
+            state: "skipped",
+            installCmd: provider.installCmd,
+            message: `Skipped by user preference; run opencandle doctor --enable ${providerId} to re-enable.`,
+            checkedAt: now.toISOString(),
+            cacheHit: false,
+        };
+    }
+    if (!options.force) {
+        const cached = statusCache.get(cacheKey);
+        if (cached && cached.expiresAt > now.getTime()) {
+            return { ...cached.status, cacheHit: true };
+        }
+    }
+    let status;
+    if (isApiKeyProvider(provider)) {
+        const source = getCredentialSource(provider.id);
+        status = {
+            providerId,
+            kind: "api-key",
+            state: source === "absent" ? "missing" : "configured",
+            credentialSource: source,
+            checkedAt: now.toISOString(),
+            cacheHit: false,
+        };
+    }
+    else if (isExternalToolProvider(provider)) {
+        status = await probeExternalTool(providerId, mode, {
+            now,
+            commandRunner: options.commandRunner ?? runCommand,
+        });
+    }
+    else if (isPublicHttpProvider(provider)) {
+        status = await probePublicHttp(providerId, {
+            now,
+            fetchImpl: options.fetchImpl ?? fetch,
+        });
+    }
+    else {
+        const exhaustive = provider;
+        throw new Error(`Unsupported provider kind: ${JSON.stringify(exhaustive)}`);
+    }
+    statusCache.set(cacheKey, { status, expiresAt: now.getTime() + STATUS_TTL_MS });
+    return status;
+}
+export async function probeAllProviderStatuses(options = {}) {
+    const { listAllProviders } = await import("./providers.js");
+    const statuses = [];
+    for (const provider of listAllProviders()) {
+        statuses.push(await probeProviderStatus(provider.id, options));
+    }
+    return statuses;
+}
+export function formatProviderStatus(status) {
+    const provider = getProvider(status.providerId);
+    if (status.kind === "api-key") {
+        return `${provider.displayName}: ${status.state} (${status.credentialSource})`;
+    }
+    if (status.kind === "external-tool") {
+        const suffix = status.message ? ` - ${status.message}` : "";
+        return `${provider.displayName}: ${status.state} (${status.mode})${suffix}`;
+    }
+    const http = status.statusCode === undefined ? "" : ` HTTP ${status.statusCode}`;
+    const suffix = status.message ? ` - ${status.message}` : "";
+    return `${provider.displayName}: ${status.state}${http}${suffix}`;
+}
+async function probeExternalTool(providerId, mode, options) {
+    const provider = getProvider(providerId);
+    if (!isExternalToolProvider(provider)) {
+        throw new Error(`Provider ${providerId} is not an external tool`);
+    }
+    const args = mode === "install"
+        ? ["--version"]
+        : (provider.sessionProbeArgs ?? ["feed", "--max", "1", "--json"]);
+    try {
+        const result = await options.commandRunner(provider.binary, args, {
+            timeoutMs: COMMAND_TIMEOUT_MS,
+        });
+        const output = redactSensitiveOutput(`${result.stderr}\n${result.stdout}`.trim());
+        if (mode === "install") {
+            return {
+                providerId,
+                kind: "external-tool",
+                mode,
+                state: result.code === 0 ? "installed" : "error",
+                installCmd: provider.installCmd,
+                message: result.code === 0 ? undefined : output,
+                checkedAt: options.now.toISOString(),
+                cacheHit: false,
+            };
+        }
+        if (result.code === 0) {
+            const parsed = parseCliEnvelope(result.stdout, provider.binary);
+            const session = classifySessionEnvelope(providerId, parsed);
+            return {
+                providerId,
+                kind: "external-tool",
+                mode,
+                state: session.state,
+                installCmd: provider.installCmd,
+                message: session.message,
+                checkedAt: options.now.toISOString(),
+                cacheHit: false,
+            };
+        }
+        return {
+            providerId,
+            kind: "external-tool",
+            mode,
+            state: classifySessionFailure(output),
+            installCmd: provider.installCmd,
+            message: output,
+            checkedAt: options.now.toISOString(),
+            cacheHit: false,
+        };
+    }
+    catch (err) {
+        const nodeError = err;
+        if (nodeError.code === "ENOENT") {
+            return {
+                providerId,
+                kind: "external-tool",
+                mode,
+                state: "missing",
+                installCmd: provider.installCmd,
+                checkedAt: options.now.toISOString(),
+                cacheHit: false,
+            };
+        }
+        return {
+            providerId,
+            kind: "external-tool",
+            mode,
+            state: "error",
+            installCmd: provider.installCmd,
+            message: redactSensitiveOutput(err instanceof Error ? err.message : String(err)),
+            checkedAt: options.now.toISOString(),
+            cacheHit: false,
+        };
+    }
+}
+async function probePublicHttp(providerId, options) {
+    const provider = getProvider(providerId);
+    if (!isPublicHttpProvider(provider)) {
+        throw new Error(`Provider ${providerId} is not a public HTTP provider`);
+    }
+    try {
+        const response = await options.fetchImpl(provider.probeUrl, {
+            method: "GET",
+            signal: AbortSignal.timeout(PUBLIC_HTTP_TIMEOUT_MS),
+        });
+        return {
+            providerId,
+            kind: "public-http",
+            state: response.ok ? "reachable" : "unreachable",
+            statusCode: response.status,
+            checkedAt: options.now.toISOString(),
+            cacheHit: false,
+        };
+    }
+    catch (err) {
+        return {
+            providerId,
+            kind: "public-http",
+            state: "error",
+            message: err instanceof Error ? err.message : String(err),
+            checkedAt: options.now.toISOString(),
+            cacheHit: false,
+        };
+    }
+}
+function parseCliEnvelope(stdout, binary) {
+    try {
+        const parsed = JSON.parse(stdout);
+        return {
+            ok: parsed.ok === true,
+            data: parsed.data,
+            message: typeof parsed.error?.message === "string"
+                ? redactSensitiveOutput(parsed.error.message)
+                : undefined,
+        };
+    }
+    catch {
+        return { ok: false, message: `${binary} returned non-JSON output` };
+    }
+}
+function classifySessionEnvelope(providerId, parsed) {
+    if (!parsed.ok) {
+        return {
+            state: classifySessionFailure(parsed.message),
+            message: parsed.message,
+        };
+    }
+    if (providerId === "reddit" && isRecord(parsed.data) && parsed.data.authenticated === false) {
+        return {
+            state: "session_missing",
+            message: "Reddit is not authenticated. Run rdt login.",
+        };
+    }
+    return { state: "session_ok" };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function classifySessionFailure(message) {
+    const lower = (message ?? "").toLowerCase();
+    if (lower.includes("no twitter cookies") ||
+        lower.includes("no reddit cookies") ||
+        lower.includes("not authenticated") ||
+        lower.includes("no cookies")) {
+        return "session_missing";
+    }
+    if (lower.includes("401") || lower.includes("unauthorized") || lower.includes("expired")) {
+        return "session_stale";
+    }
+    return "error";
+}
+export function redactSensitiveOutput(input) {
+    const xCookieNames = "auth_token|ct0|twid|kdt|guest_id|guest_id_ads|guest_id_marketing|personalization_id";
+    const genericSecretName = "[a-z0-9_]*(?:session|token)[a-z0-9_]*|[a-z0-9_]+cookie[a-z0-9_]*|[a-z0-9_]*cookie[a-z0-9_]+";
+    return input
+        .slice(0, MAX_OUTPUT_CHARS)
+        .replace(/\b(cookie|set-cookie)\s*:\s*[^\r\n]+/gi, "$1: [redacted]")
+        .replace(new RegExp(`\\b(${xCookieNames})\\b\\s*[:=]\\s*[^;\\s,)]+`, "gi"), "$1=[redacted]")
+        .replace(new RegExp(`\\b(${xCookieNames})=([^;\\s,)]+)`, "gi"), "$1=[redacted]")
+        .replace(new RegExp(`\\b(${genericSecretName})\\b\\s*[:=]\\s*[^;\\s,)]+`, "gi"), "$1=[redacted]")
+        .replace(new RegExp(`\\b(${genericSecretName})=([^;\\s,)]+)`, "gi"), "$1=[redacted]")
+        .replace(/(?:~|\/Users\/[^/\s]+|\/home\/[^/\s]+)?\/\.config\/rdt-cli\/credential\.json/g, "[redacted-credential-path]");
+}
+export const runCommand = (command, args, options) => runExternalToolCommand(command, args, {
+    timeoutMs: options?.timeoutMs ?? COMMAND_TIMEOUT_MS,
+    maxOutputChars: MAX_OUTPUT_CHARS,
+});
+//# sourceMappingURL=provider-status.js.map

package/dist/onboarding/provider-status.js.map

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

package/dist/onboarding/providers.d.ts

@@ -1,8 +1,12 @@
-export type ProviderId = "alpha_vantage" | "fred" | "finnhub" | "brave" | "exa";
-export type ProviderCategory = "fundamentals" | "macro" | "news" | "web_search";
+export type ApiKeyProviderId = "alpha_vantage" | "fred" | "finnhub" | "brave" | "exa";
+export type ExternalToolProviderId = "twitter" | "reddit";
+export type PublicHttpProviderId = "yahoo";
+export type ProviderId = ApiKeyProviderId | ExternalToolProviderId | PublicHttpProviderId;
+export type ProviderCategory = "fundamentals" | "macro" | "news" | "web_search" | "sentiment" | "market";
 export type ProviderTier = "hard" | "soft";
-export interface ProviderDescriptor {
+interface BaseProviderDescriptor {
     readonly id: ProviderId;
+    readonly kind: "api-key" | "external-tool" | "public-http";
     readonly displayName: string;
     readonly category: ProviderCategory;
     /**
@@ -15,11 +19,6 @@ export interface ProviderDescriptor {
     readonly tier: ProviderTier;
     /** Lowercase friendly aliases accepted by `/connect` in addition to the id. */
     readonly aliases: readonly string[];
-    readonly signupUrl: string;
-    readonly freeTier: boolean;
-    readonly envVar: string;
-    /** Nested key path into `OpenCandleFileConfig` where the key is persisted. */
-    readonly configPath: readonly string[];
     readonly unlocks: readonly string[];
     /**
      * Human copy describing the degraded experience when missing, or `null`
@@ -29,8 +28,33 @@ export interface ProviderDescriptor {
     readonly snoozeDurationDays: number;
     readonly instructionsHint: string;
 }
+export interface ApiKeyProviderDescriptor extends BaseProviderDescriptor {
+    readonly id: ApiKeyProviderId;
+    readonly kind: "api-key";
+    readonly signupUrl: string;
+    readonly freeTier: boolean;
+    readonly envVar: string;
+    /** Nested key path into `OpenCandleFileConfig` where the key is persisted. */
+    readonly configPath: readonly string[];
+}
+export interface ExternalToolProviderDescriptor extends BaseProviderDescriptor {
+    readonly id: ExternalToolProviderId;
+    readonly kind: "external-tool";
+    readonly binary: string;
+    readonly installCmd: string;
+    readonly sessionSource: "browser-cookies";
+    readonly supportedBrowsers?: readonly string[];
+    readonly sessionProbeArgs?: readonly string[];
+}
+export interface PublicHttpProviderDescriptor extends BaseProviderDescriptor {
+    readonly id: PublicHttpProviderId;
+    readonly kind: "public-http";
+    readonly probeUrl: string;
+}
+export type ProviderDescriptor = ApiKeyProviderDescriptor | ExternalToolProviderDescriptor | PublicHttpProviderDescriptor;
 export declare const PROVIDERS: readonly [{
     readonly id: "alpha_vantage";
+    readonly kind: "api-key";
     readonly displayName: "Alpha Vantage";
     readonly category: "fundamentals";
     readonly tier: "hard";
@@ -45,6 +69,7 @@ export declare const PROVIDERS: readonly [{
     readonly instructionsHint: "Free, about 30 seconds, signup opens in your browser";
 }, {
     readonly id: "fred";
+    readonly kind: "api-key";
     readonly displayName: "FRED";
     readonly category: "macro";
     readonly tier: "hard";
@@ -59,6 +84,7 @@ export declare const PROVIDERS: readonly [{
     readonly instructionsHint: "Free, about 30 seconds, requires a St. Louis Fed account";
 }, {
     readonly id: "finnhub";
+    readonly kind: "api-key";
     readonly displayName: "Finnhub";
     readonly category: "news";
     readonly tier: "soft";
@@ -73,6 +99,7 @@ export declare const PROVIDERS: readonly [{
     readonly instructionsHint: "Free, about 30 seconds, signup opens in your browser";
 }, {
     readonly id: "brave";
+    readonly kind: "api-key";
     readonly displayName: "Brave Search";
     readonly category: "web_search";
     readonly tier: "soft";
@@ -87,6 +114,7 @@ export declare const PROVIDERS: readonly [{
     readonly instructionsHint: "Free tier available, signup opens in your browser";
 }, {
     readonly id: "exa";
+    readonly kind: "api-key";
     readonly displayName: "Exa";
     readonly category: "web_search";
     readonly tier: "soft";
@@ -99,8 +127,56 @@ export declare const PROVIDERS: readonly [{
     readonly fallbackDescription: "Exa search continues to work via the keyless Exa MCP endpoint, which has lower rate limits but similar quality";
     readonly snoozeDurationDays: 7;
     readonly instructionsHint: "Paid with free tier, signup opens in your browser";
+}, {
+    readonly id: "yahoo";
+    readonly kind: "public-http";
+    readonly displayName: "Yahoo Finance";
+    readonly category: "market";
+    readonly tier: "hard";
+    readonly aliases: readonly ["yahoo", "yahoo-finance", "market-data", "options"];
+    readonly probeUrl: "https://query1.finance.yahoo.com/v8/finance/chart/SPY?interval=1d&range=1d";
+    readonly unlocks: readonly ["quotes", "historical prices", "option chains", "market data"];
+    readonly fallbackDescription: null;
+    readonly snoozeDurationDays: 7;
+    readonly instructionsHint: "No account needed; OpenCandle checks public Yahoo Finance reachability";
+}, {
+    readonly id: "twitter";
+    readonly kind: "external-tool";
+    readonly displayName: "X / Twitter";
+    readonly category: "sentiment";
+    readonly tier: "soft";
+    readonly aliases: readonly ["twitter", "x", "x-sentiment", "twitter-sentiment"];
+    readonly binary: "twitter";
+    readonly installCmd: "uv tool install twitter-cli";
+    readonly sessionSource: "browser-cookies";
+    readonly sessionProbeArgs: readonly ["feed", "--max", "1", "--json"];
+    readonly supportedBrowsers: readonly ["Chrome", "Arc", "Edge", "Firefox", "Brave"];
+    readonly unlocks: readonly ["X/Twitter sentiment", "recent ticker mentions", "social engagement context"];
+    readonly fallbackDescription: "Sentiment summaries continue with Reddit, web search, and news when X is unavailable";
+    readonly snoozeDurationDays: 7;
+    readonly instructionsHint: "Install twitter-cli and stay logged into x.com in a supported browser";
+}, {
+    readonly id: "reddit";
+    readonly kind: "external-tool";
+    readonly displayName: "Reddit";
+    readonly category: "sentiment";
+    readonly tier: "soft";
+    readonly aliases: readonly ["reddit", "reddit-sentiment", "subreddit"];
+    readonly binary: "rdt";
+    readonly installCmd: "uv tool install rdt-cli";
+    readonly sessionSource: "browser-cookies";
+    readonly supportedBrowsers: readonly ["Chrome", "Arc", "Edge", "Firefox", "Brave"];
+    readonly sessionProbeArgs: readonly ["status", "--json"];
+    readonly unlocks: readonly ["Reddit sentiment", "ticker discussion context", "retail investor discussion"];
+    readonly fallbackDescription: "Sentiment summaries continue with X/Twitter, web search, and news when Reddit is unavailable";
+    readonly snoozeDurationDays: 7;
+    readonly instructionsHint: "Install rdt-cli and stay logged into reddit.com in a supported browser";
 }];
 export declare function listAllProviders(): readonly ProviderDescriptor[];
+export declare function isApiKeyProvider(provider: ProviderDescriptor): provider is ApiKeyProviderDescriptor;
+export declare function isExternalToolProvider(provider: ProviderDescriptor): provider is ExternalToolProviderDescriptor;
+export declare function isPublicHttpProvider(provider: ProviderDescriptor): provider is PublicHttpProviderDescriptor;
+export declare function listApiKeyProviders(): readonly ApiKeyProviderDescriptor[];
 export declare function getProvider(id: ProviderId): ProviderDescriptor;
 export declare function getProvidersByCategory(category: ProviderCategory): readonly ProviderDescriptor[];
 export declare function getProvidersByTier(tier: ProviderTier): readonly ProviderDescriptor[];
@@ -114,3 +190,4 @@ export declare function getCredential(id: ProviderId): {
     value?: undefined;
 };
 export declare function resolveProviderFromArgument(arg: string): ProviderDescriptor | readonly ProviderDescriptor[] | undefined;
+export {};