gnosys 5.11.4 → 5.12.0

package/dist/lib/setup/summary.js

@@ -45,7 +45,9 @@ const PKG_VERSION = (() => {
 //
 // Detect the "gnosys.json says anthropic but no Anthropic key exists AND
 // another provider has a key" pattern. Offer one-keystroke repair.
-const PROVIDERS_WITH_KEYS = ["anthropic", "openai", "xai", "groq", "mistral"];
+const PROVIDERS_WITH_KEYS = [
+    "anthropic", "openai", "xai", "groq", "mistral", "openrouter",
+];
 async function maybeOfferProviderRepair(cfg, projectDir, rl) {
     if (cfg.llm.defaultProvider !== "anthropic")
         return;
@@ -92,50 +94,38 @@ async function maybeOfferProviderRepair(cfg, projectDir, rl) {
     }
     catch (err) {
         process.stdout.write(`${Status("warn", `failed to repair: ${err instanceof Error ? err.message : String(err)}`)}\n`);
-        process.stdout.write(`${Status("warn", "run 'gnosys setup models' to change manually", "fallback")}\n`);
+        process.stdout.write(`${Status("warn", "run 'gnosys setup providers' to change manually", "fallback")}\n`);
     }
 }
 export function buildSections() {
     return [
         {
             key: "1",
-            label: "provider",
-            describe: (cfg) => cfg.llm.defaultProvider,
-            // v5.9.4 Bug 4 — row 1 now changes ONLY the provider; row 2 stays
-            // as the full model picker. Before, both routed to `runModelsSetup`.
-            edit: async (rl, _cfg, projectDir) => {
-                const { runProviderOnlySetup } = await import("../setup.js");
-                await runProviderOnlySetup({ directory: projectDir, rl });
-                return true;
-            },
-        },
-        {
-            key: "2",
-            label: "models",
+            label: "providers",
             describe: async (cfg) => {
-                const synth = resolveTaskModel(cfg, "synthesis");
-                return `${synth.provider} / ${synth.model}`;
+                const { describeProvidersSummary } = await import("./sections/providers.js");
+                return describeProvidersSummary(cfg);
             },
             edit: async (rl, _cfg, projectDir) => {
-                const { runModelsSetup } = await import("../setup.js");
-                await runModelsSetup({ directory: projectDir, rl });
-                return true;
+                const { runProvidersSetup } = await import("./sections/providers.js");
+                return runProvidersSetup({ rl, directory: projectDir });
             },
         },
         {
-            key: "3",
+            key: "2",
             label: "task routing",
             describe: async (cfg) => {
                 const provs = new Set([
                     resolveTaskModel(cfg, "structuring").provider,
                     resolveTaskModel(cfg, "synthesis").provider,
+                    resolveTaskModel(cfg, "chat").provider,
                 ]);
                 return provs.size === 1 ? `all ${[...provs][0]}` : `mixed (${[...provs].join(", ")})`;
             },
             edit: async (rl, _cfg, projectDir) => editRouting(rl, projectDir),
         },
         {
-            key: "4",
+            key: "3",
             label: "ide integrations",
             describe: async () => {
                 const { detectIDEs } = await import("../setup.js");
@@ -145,19 +135,9 @@ export function buildSections() {
             edit: async (rl, _cfg, projectDir) => editIDEs(rl, projectDir),
         },
         {
-            key: "5",
+            key: "4",
             label: "multi-machine sync",
-            describe: () => {
-                try {
-                    const db = GnosysDB.openLocal();
-                    const remotePath = db.getMeta("remote_path");
-                    db.close();
-                    return remotePath ?? "not configured";
-                }
-                catch {
-                    return "not configured";
-                }
-            },
+            describe: async () => describeMultiMachineSyncPanel(),
             edit: async (rl) => {
                 const { runConfigureWizard } = await import("../remoteWizard.js");
                 const centralDb = GnosysDB.openLocal();
@@ -170,7 +150,7 @@ export function buildSections() {
             },
         },
         {
-            key: "6",
+            key: "5",
             label: "dream mode",
             // v5.9.4 Bug 7 — reconcile config + local-DB so the panel reflects
             // state set elsewhere (e.g. a dream wizard run on this machine).
@@ -202,7 +182,7 @@ export function buildSections() {
             },
         },
         {
-            key: "7",
+            key: "6",
             label: "user preferences",
             describe: async () => {
                 const { listUserPreferences } = await import("./sections/preferences.js");
@@ -313,5 +293,39 @@ export async function runSummaryWizard(opts = {}) {
             rl.close();
     }
 }
+/**
+ * Settings-panel value for multi-machine sync (v13 design).
+ * Shows the configured master folder path, or "NA (single-machine only)" when unset.
+ */
+export function formatMultiMachineSyncSummary(remotePath) {
+    return remotePath ?? "NA (single-machine only)";
+}
+/** Resolve multi-machine sync status for the summary panel row. */
+export async function describeMultiMachineSyncPanel() {
+    let db = null;
+    try {
+        db = GnosysDB.openLocal();
+        const { getConfiguredRemotePath } = await import("../remote.js");
+        const remotePath = getConfiguredRemotePath(db);
+        return formatMultiMachineSyncSummary(remotePath);
+    }
+    catch {
+        return formatMultiMachineSyncSummary(null);
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch {
+            // ignore
+        }
+    }
+}
 // Internal helpers exported for tests.
-export const __test = { resolveActiveStorePath, renderPanelRows, buildTrailingMap };
+export const __test = {
+    resolveActiveStorePath,
+    renderPanelRows,
+    buildTrailingMap,
+    formatMultiMachineSyncSummary,
+    describeMultiMachineSyncPanel,
+};

package/dist/lib/setup/ui/status.d.ts

@@ -18,3 +18,4 @@ export type StatusKind = "ok" | "warn" | "fail" | "progress";
 export declare function Status(kind: StatusKind, text: string, meta?: string): string;
 /** Convenience: print a single status line. */
 export declare function printStatus(kind: StatusKind, text: string, meta?: string): void;
+export { MASTER_UNREACHABLE_MESSAGE, formatMemoriesWaitingToSync, formatFailedToSyncCount, formatOfflinePushStarting, renderClientSyncStatusLines, type ClientSyncStatusInput, } from "../remoteRender.js";

package/dist/lib/setup/ui/status.js

@@ -46,3 +46,5 @@ export function Status(kind, text, meta) {
 export function printStatus(kind, text, meta) {
     process.stdout.write(`${Status(kind, text, meta)}\n`);
 }
+// ─── v13 multi-machine sync (re-export render helpers for CLI/MCP callers) ─
+export { MASTER_UNREACHABLE_MESSAGE, formatMemoriesWaitingToSync, formatFailedToSyncCount, formatOfflinePushStarting, renderClientSyncStatusLines, } from "../remoteRender.js";

package/dist/lib/setup.d.ts

@@ -8,6 +8,9 @@
  * Uses Node.js built-in readline/promises — no external dependencies.
  */
 import { type Interface as ReadlineInterface } from "readline/promises";
+import { type GnosysConfig, type LLMProviderName } from "./config.js";
+import { type ApiKeyRequirement, type ApiKeyScope, type LlmTaskName } from "./apiKeyVault.js";
+export { printStatus } from "./setup/ui/status.js";
 export interface ModelTier {
     name: string;
     model: string;
@@ -39,6 +42,23 @@ export interface SetupResult {
     dreamEnabled?: boolean;
 }
 export declare const PROVIDER_TIERS: Record<string, ModelTier[]>;
+/**
+ * Fetch models from OpenRouter, cache for 24 hours, fall back to hardcoded.
+ * Returns updated PROVIDER_TIERS for cloud providers only.
+ */
+export declare function fetchDynamicModels(): Promise<Record<string, ModelTier[]>>;
+export declare const TASK_DESCRIPTIONS: Record<string, string>;
+/** Tasks routed via taskModels in gnosys.json */
+declare const ROUTABLE_TASK_LIST: readonly ["structuring", "synthesis", "vision", "transcription", "chat"];
+type RoutableTaskName = (typeof ROUTABLE_TASK_LIST)[number];
+/** Routable tasks plus dream (stored under config.dream) */
+type AssignableTaskName = RoutableTaskName | "dream";
+export declare const ASSIGNABLE_TASK_LIST: AssignableTaskName[];
+export type { AssignableTaskName, RoutableTaskName };
+export declare function getAssignableRouting(cfg: GnosysConfig, task: AssignableTaskName): {
+    provider: LLMProviderName;
+    model: string;
+};
 /**
  * Returns the cheapest capable model for structuring tasks.
  * Structuring (keyword extraction, tagging) doesn't need a flagship model.
@@ -49,7 +69,9 @@ export declare function getStructuringModel(provider: string, chosenModel: strin
  * Creates the directory and file if they don't exist.
  * Replaces an existing key line if found, otherwise appends.
  */
-export declare function writeApiKey(provider: string, key: string): Promise<void>;
+export declare function writeApiKey(provider: string, key: string, opts?: {
+    scope?: ApiKeyScope;
+}): Promise<void>;
 /**
  * Detect which IDEs are available in the given project directory.
  * Returns an array like ["claude", "cursor", "codex"].
@@ -76,7 +98,43 @@ export declare function setupIDE(ide: string, projectDir: string): Promise<{
     success: boolean;
     message: string;
 }>;
+/**
+ * Read a single line of input with an optional default value.
+ */
+export declare function askInput(rl: ReadlineInterface, prompt: string, opts?: {
+    default?: string;
+}): Promise<string>;
+export declare function printInfo(text: string, meta?: string): void;
+/**
+ * Y/n prompt. Returns true for yes.
+ */
+export declare function askYesNo(rl: ReadlineInterface, question: string, defaultYes?: boolean): Promise<boolean>;
+/**
+ * Read a password/API key without echoing it back to the terminal.
+ */
+export declare function askPassword(rl: ReadlineInterface, prompt: string): Promise<string>;
+/** Parse `1,3,5`, `all`, or `none` into 0-based task indices. */
+export declare function parseCommaSeparatedTaskSelection(input: string, count: number): number[] | "all" | "none" | null;
+export declare function modelForTaskAssignment(task: string, provider: string, model: string): string;
+/**
+ * Let the user pick a provider from the list.
+ * Returns the provider name or "skip".
+ * If currentProvider is given, shows it as the current value.
+ */
+export declare function pickProvider(rl: ReadlineInterface, dynamicModels: Record<string, ModelTier[]>, stepLabel: string, currentProvider?: string): Promise<string>;
+/**
+ * Let the user pick a model from a provider's tiers.
+ * Returns the model string. Includes a "Custom (enter model name)"
+ * option so users can type any model ID not in the curated list.
+ */
+export declare function pickModel(rl: ReadlineInterface, provider: string, dynamicModels: Record<string, ModelTier[]>, stepLabel: string, currentModel?: string): Promise<string>;
 export declare function runSetup(opts: {
+    section: "keys";
+    directory?: string;
+    nonInteractive?: boolean;
+}): Promise<void>;
+export declare function runSetup(opts: {
+    section?: undefined;
     directory?: string;
     nonInteractive?: boolean;
 }): Promise<SetupResult>;
@@ -94,6 +152,50 @@ export interface ProviderOnlySetupOpts {
  * a new model. Now row 1 picks a provider, row 2 picks a model.
  */
 export declare function runProviderOnlySetup(opts?: ProviderOnlySetupOpts): Promise<void>;
+/** Where validated keys are persisted (§3.10). */
+export type KeyPersistDestination = "secure" | "dotenv" | "none";
+/**
+ * Build API key requirements from the selected task set only (§3.7).
+ * One global key per distinct cloud provider in the selection.
+ */
+export declare function buildInlineKeyRequirements(selectedTasks: AssignableTaskName[], providerForTask: (task: AssignableTaskName) => string): ApiKeyRequirement[];
+/** Write or replace a single `NAME=value` line in ~/.config/gnosys/.env. */
+export declare function writeServiceKeyToEnv(service: string, key: string): Promise<void>;
+/**
+ * Validate a provider/model/key triple without persisting the key (§3.8).
+ * On auth failure, re-prompt for a replacement key in memory only.
+ */
+export declare function validateTaskCombo(opts: {
+    rl: ReadlineInterface;
+    provider: string;
+    model: string;
+    apiKey: string;
+    customBaseUrl?: string;
+    isLocalProvider: boolean;
+    saveAnywayPrompt?: string;
+    saveAnywayDefault?: boolean;
+    repromptKey?: (rl: ReadlineInterface, provider: string) => Promise<string | null>;
+}): Promise<{
+    proceed: boolean;
+    apiKey: string;
+}>;
+/** Ask where to store a validated key; persist or print env-var hints (§3.10). */
+export declare function promptKeyDestinationAndPersist(opts: {
+    rl: ReadlineInterface;
+    service: string;
+    provider: string;
+    key: string;
+    scope: ApiKeyScope;
+    destinationChoice?: number;
+}): Promise<KeyPersistDestination>;
+/** Build taskModels patch — only selected routable tasks that changed. */
+export declare function buildTaskModelsPatchFromAccepted(accepted: Partial<Record<AssignableTaskName, {
+    provider: LLMProviderName;
+    model: string;
+}>>, currentByTask: Record<AssignableTaskName, {
+    provider: LLMProviderName;
+    model: string;
+}>, selectedSet: Set<AssignableTaskName>): NonNullable<GnosysConfig["taskModels"]> | undefined;
 export interface ModelsSetupOpts {
     provider?: string;
     model?: string;
@@ -146,5 +248,8 @@ export declare function runChatSetup(opts?: ChatSetupOpts): Promise<void>;
  * Best-effort lookup of the API key for a provider. Used by the dream setup
  * wizard to power the validation step. Mirrors the resolveApiKey precedence.
  */
-export declare function getApiKeyForProvider(provider: string): Promise<string>;
-export {};
+export declare function getApiKeyForProvider(provider: string, opts?: {
+    task?: LlmTaskName;
+    directory?: string;
+}): Promise<string>;
+export { getApiKeyForProviderFromConfig } from "./apiKeyVault.js";